Los errores son una parte inevitable del proceso de desarrollo. Aunque puede ser frustrante enfrentarse a ellos, puede ayudar a solucionar este tipo de problemas rápidamente al identificar el problema con el que se encuentra, reproducirlo y presentar un informe de error a través del Asistente de comentarios de Apple.
Más información sobre el Asistente de comentarios
Siempre debe enviar comentarios sobre cualquier error que encuentre mientras desarrolla para las plataformas de Apple; después de todo, no podemos solucionar problemas que no conocemos. Pero, ¿cómo puede estar seguro de que la información que proporciona es útil para clasificar el problema, en lugar de un callejón sin salida para resolver errores? Estos son nuestros mejores consejos para asegurarse de que su informe de errores sea claro, procesable y, lo más importante, reparable.
Sea claro, directo y detallado
Cuando registre cualquier nuevo informe de error, sea lo más descriptivo posible, comenzando con un título que describa claramente tanto el problema como el factor que lo incita. Un título como «Faltan eventos del calendario» omite información importante como cómo o por qué, mientras que un título como «Faltan eventos del calendario en macOS 12.4 después de crear un evento rápido» brinda más detalles prácticos.
Sugerencia: a menudo es útil para los evaluadores de errores comprender cómo los problemas pueden afectar el desarrollo de la aplicación. Si identifica un problema mientras desarrolla su aplicación, incluya el nombre y la versión de su aplicación tanto en el título como en el campo de descripción, incluso si puede reproducir el problema en un proyecto de muestra independiente, y agregue un enlace a su registro de App Store o un Construcción TestFlight.
Cuando escriba su problema, describa cada paso detalladamente; a menudo es útil fingir que quien lea su informe nunca ha encontrado la aplicación o el sistema sobre el que está escribiendo. Por ejemplo, una afirmación como «Cuando creo un evento en Calendar, desaparece en un momento» omite muchos de los detalles necesarios para reproducir el problema. ¿Está creando un evento de Calendario a través del botón Evento rápido, a través de Siri, o está arrastrando para agregar un nuevo evento? ¿Cuánto dura un momento? ¿Desapareció el evento después de la multitarea o permaneciste en la aplicación?
Cada vez que un detector de errores tiene que hacer una pausa y considerar este tipo de pregunta, reduce la probabilidad de que su problema se solucione rápidamente. En cambio, considere cómo podría describir su error en detalle. Por ejemplo, podrías escribir:
1. Click Quick Event button in the Calendar app.
2. Fill out an event with any title.
3. Hit Return.
Actual Results: The event appears in the right place in my calendar but then disappears.
Expected Results: The Calendar event should appear and stay on my calendar.
Después de completar los pasos de reproducción y el resultado esperado, considere cualquier factor adicional que pueda influir en el problema. ¿Has iniciado sesión en iCloud? ¿Tienes alguna configuración de accesibilidad activada? ¿Puedes reproducir el problema en otra parte del sistema operativo? Cuanta más información incluya en el informe inicial, más rápido el evaluador podrá clasificarlo de manera efectiva y enviarlo al equipo adecuado para que lo solucione.
Agrega algunas imágenes
Una captura de pantalla o una grabación de pantalla del error reproducido puede proporcionar pistas valiosas, y puede incluir detalles que quizás no haya considerado escribir en el campo de descripción. Si tiene un problema con la interfaz de usuario, siempre debe incluir elementos visuales.
Registrar el accidente
Desafortunadamente, no todos los errores son reproducibles o tienen pasos fáciles de seguir. Para estos casos más complicados, considere proporcionar información de registro como un diagnóstico del sistema; si está archivando un error en iPhone o iPad, puede usar la aplicación Feedback Assistant para capturar uno automáticamente. Si realiza la presentación a través del portal web de Apple, puede instalar perfiles para ayudarlo a recopilar manualmente un diagnóstico del sistema.
También puede proporcionar cualquier registro adicional relevante para el problema. Por ejemplo, si experimenta un bloqueo, incluya los registros de bloqueo de su aplicación. Si está informando una regresión de rendimiento, incluya un seguimiento de instrumentos en iOS o iPadOS, o una muestra en macOS.
Crear un proyecto de muestra
¿Te encuentras con un problema al desarrollar una aplicación? Considere aislar el problema en un pequeño proyecto de muestra o en un proyecto de Swift Playgrounds que compile. No solo puede ayudarlo a reducir el error específico al que se enfrenta, sino que también es una de las formas más fáciles para que los evaluadores de errores y los ingenieros evalúen el problema. Si no puede producir un proyecto de muestra completo, el código de muestra también es útil: toda la información adicional que pueda ayudar a reducir el problema es valiosa.
Escalar su informe
Si es miembro de pago del Programa para desarrolladores de Apple, el Programa empresarial o el Programa MFi y tiene un problema técnico con una de las plataformas de Apple en una versión de producción, considere presentar un Incidente de soporte técnico. Esta es una solicitud de soporte a nivel de código para marcos, API y herramientas de Apple cuando no puede corregir un error, tiene problemas al implementar una tecnología específica o tiene preguntas generales sobre su código.
Solicitar soporte técnico