Cómo enviar excelentes informes de errores: descubrir

Los errores son una parte inevitable del proceso de desarrollo. Si bien encontrarlos puede ser frustrante, puede solucionar rápidamente este tipo de problemas identificando el problema que está encontrando, reproduciéndolo y enviando un informe de error. En Apple, ofrecemos una aplicación y un sitio web llamado “Feedback Assistant” para registrar problemas con productos o software de Apple.

Siempre debe enviar comentarios sobre los errores que encuentre al desarrollar en 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 resolver el problema y no un callejón sin salida para la solución de problemas? Estos son algunos de nuestros consejos principales para asegurarse de que su informe de errores sea claro, procesable y, lo más importante, reparable.

Paso a paso

Sea claro y descriptivo al registrar un nuevo informe de error. Describa su problema en detalle, ya sea que proporcione comentarios específicos sobre un error que encuentre o comentarios generales.

Comienza con un título claro que describe tanto el problema como el factor estimulante. “Faltan eventos del calendario” le dice al evaluador que hay un problema con los eventos del calendario, pero no cómo ni por qué. Por el contrario, “faltan eventos de calendario en macOS 10.15.4 después de crear un evento rápido” proporciona más detalles de un vistazo y puede ayudar a identificar errores duplicados antes.


Consejo: A menudo es útil para los detectores de errores comprender cómo los problemas afectan el desarrollo de la aplicación. Si encuentra un problema mientras desarrolla su aplicación, ingrese el nombre y la versión de su aplicación en el campo Título y descripción, incluso si puede reproducir el problema en un proyecto de muestra, y agregue un enlace a su registro de App Store o agregue un TestFlight.


Describa cada paso a fondo cuando escriba su problema. A menudo es útil pretender que cualquiera que lo lea nunca haya visto la aplicación o el sistema sobre el que está escribiendo. Por ejemplo, si escribe: “Cuando creo un evento en el calendario, desaparece en un momento”, el filtro carece de detalles suficientes para reproducir el problema. ¿Crear un evento de calendario con el botón Evento rápido o arrastrar para agregar un nuevo evento? Cuanto dura un momento ¿El evento desapareció después de la multitarea o te quedaste en la aplicación?

Cada vez que un inspector de errores tiene que hacer una pausa y considerar este tipo de pregunta, la probabilidad de que su problema pueda solucionarse disminuye rápidamente. En cambio, piense cómo puede describir su error en detalle:

1. Haga clic en el botón Evento rápido en la aplicación Calendario.
2. Completa un evento con cualquier título.
3. Presione la tecla Enter.

Resultados reales: el evento aparece en el lugar correcto en mi calendario, pero luego desaparece.

Resultados esperados: el evento del calendario debería aparecer y permanecer en mi calendario.

Después de completar sus pasos reproductivos y el resultado esperado, debe considerar factores adicionales que pueden afectar el problema. ¿Has iniciado sesión en iCloud? ¿Ha habilitado la configuración de accesibilidad? ¿Se reproduce el problema de manera similar en otras partes del sistema operativo? Cuantas más preguntas pueda responder en el primer informe, más rápido alguien que lo lea podrá analizarlo de manera efectiva y transmitirlo al equipo o persona adecuada para encontrar una solución.

Agrega algunos gráficos

Si puede reproducir el error mientras toma videos o capturas de pantalla, esta información puede ser invaluable para solucionar el problema. Una captura de pantalla también puede ayudar a capturar detalles que quizás no haya especificado en el campo de descripción. Si su problema se refiere a un problema con la interfaz de usuario, siempre debe insertar elementos visuales.

Grabar el accidente

Desafortunadamente, no todos los errores son reproducibles o tienen pasos fáciles de seguir. En casos más difíciles, debe proporcionar información de registro, como diagnósticos del sistema: si informa un error en su iPhone o iPad, puede usar la aplicación Feedback Assistant para recopilar uno automáticamente. Si informa un error a través del portal web de Apple, puede instalar perfiles que le permitan ejecutar manualmente un diagnóstico del sistema.

También puede proporcionar un registro adicional que sea relevante para el problema. Por ejemplo, si se produce un bloqueo, puede incluir los registros de bloqueo de su aplicación. Al informar una regresión de rendimiento, puede insertar una traza de instrumento en iOS o iPadOS o un ejemplo en macOS.

Mejore los informes de errores con perfiles de depuración y registro

Crea un proyecto de muestra

¿Tienes problemas para desarrollar una aplicación? Considere aislar el problema en un pequeño proyecto de muestra que se compilará. Esto no solo puede ayudar a reducir el error específico que estás enfrentando, sino que también es una de las formas más fáciles para que los detectores de errores e ingenieros de Apple resuelvan el problema. Si no puede crear un proyecto de muestra, el código de muestra también es útil. Cualquier información adicional que pueda ayudar a reducir el problema es útil.

Amplíe su informe

Si es miembro pago del Programa de Desarrolladores de Apple, el Programa Enterprise o el programa MFi y tiene un problema técnico con una de las plataformas de Apple en una versión de producción, debe considerar enviar un incidente de soporte técnico. Esta es una solicitud de soporte a nivel de código para marcos, API y herramientas de Apple si no puede solucionar un error, tiene problemas para implementar una tecnología en particular o tiene otras preguntas sobre su código.

Solicitar soporte técnico

recursos

Obtenga más información sobre el Asistente de comentarios

Obtenga más información sobre nuestra política de privacidad cuando informe errores con el Asistente de comentarios

Leave a Reply

Este sitio usa Akismet para reducir el spam. Aprende cómo se procesan los datos de tus comentarios.