Cómo escribir un informe de error del Android

Comience con un entorno reproducible

Registre la versión y compilación de la aplicación, la versión de Android, el modelo de dispositivo o emulador y las configuraciones relevantes. Anote el estado de la cuenta y los datos de prueba sin incluir contraseñas ni información personal. Un informe sobre una construcción antigua debería decirlo.

• Identifique la compilación exacta que probó.
• Registre la pantalla, el estado de la cuenta y las condiciones de la red necesarias para comenzar.
• Describe cualquier configuración que afecte el problema, como texto grande o un idioma diferente.

Escribe una acción por paso.

Comience desde un estado al que pueda llegar otro evaluador. Utilice una secuencia numerada corta con controles visibles y entradas concretas. Mantenga los problemas no relacionados en informes separados.

• Abra la aplicación y navegue hasta la pantalla afectada.
• Ingrese el valor de la prueba o realice la acción que desencadena el problema.
• Describe el resultado visible y con qué frecuencia lo observaste.

Separar el resultado esperado y real

El resultado esperado explica lo que debería suceder y por qué es razonable. El resultado real registra lo que viste. Evite asumir una causa raíz a menos que haya sido verificada. La gravedad describe el impacto; el equipo aún decide fijar la prioridad.

Ejemplo resuelto: una acción de formulario oculta

Escenario ilustrativo, no un resultado medido por el cliente: después de aumentar el tamaño del texto, una acción de formulario cae por debajo de un panel fijo y no se puede alcanzar. Un informe útil identifica la construcción, el tamaño de la ventana, la configuración del texto, los pasos de navegación y el comportamiento de desplazamiento esperado. Adjunte una referencia de captura de pantalla redactada si tiene una.

Haga que la evidencia sea útil y segura para compartir

Una captura de pantalla o una grabación breve deberían mostrar el estado relevante. Haga referencia a un archivo o un archivo adjunto con acceso controlado en su rastreador de problemas. Elimine las credenciales y los datos personales de las capturas y registros antes de compartirlos. Este sitio web no carga pruebas.

Cerrar el ciclo con una nueva prueba

Después de una solución, vuelva a ejecutar los pasos originales en la nueva compilación y el registro fue aprobado, falló o no se pudo verificar. Incluya flujos adyacentes en las comprobaciones de regresión. No marque un problema solucionado simplemente porque se realizó un cambio.

¿Es lo mismo que un informe de error del sistema Android?

No. Esta es una descripción de problema estructurada para una persona o rastreador de problemas. Los informes de errores del sistema Android contienen registros de diagnóstico y se recopilan por separado con las herramientas Android.

¿El generador prueba mi aplicación?

No. Usted ingresa observaciones de sus propias pruebas. El generador los formatea; no inspecciona un APK, no recopila registros del dispositivo ni verifica un defecto.

¿Cuánto detalle es suficiente?

Incluya suficiente contexto para que otra persona alcance el mismo estado, siga los pasos y compare los resultados. Mantenga el informe centrado en un tema.