Comment rédiger un rapport de bogue Android

Commencez avec un environnement reproductible

Enregistrez la version et la version de l'application, la version Android, le modèle d'appareil ou d'émulateur et les paramètres pertinents. Notez l’état du compte et testez les données sans inclure de mots de passe ou d’informations personnelles. Un rapport sur une ancienne construction devrait le dire.

• Identifiez la version exacte que vous avez testée.
• Enregistrez l'écran, l'état du compte et les conditions du réseau nécessaires pour démarrer.
• Décrivez tous les paramètres qui affectent le problème, tels qu'un texte volumineux ou une langue différente.

Écrivez une action par étape

Commencez à partir d’un état qu’un autre testeur peut atteindre. Utilisez une courte séquence numérotée avec des commandes visibles et une entrée concrète. Conservez les problèmes sans rapport dans des rapports séparés.

• Ouvrez l'application et accédez à l'écran concerné.
• Entrez la valeur de test ou effectuez l'action qui déclenche le problème.
• Décrivez le résultat visible et la fréquence à laquelle vous l’avez observé.

Séparez le résultat attendu et réel

Le résultat attendu explique ce qui devrait se produire et pourquoi cela est raisonnable. Le résultat réel enregistre ce que vous avez vu. Évitez de supposer une cause profonde à moins qu’elle n’ait été vérifiée. La gravité décrit l'impact ; l'équipe décide toujours de fixer la priorité.

Exemple concret : une action de formulaire masquée

Scénario illustratif, pas un résultat client mesuré : après avoir augmenté la taille du texte, une action de formulaire tombe en dessous d'un panneau fixe et n'est plus accessible. Un rapport utile identifie la construction, la taille de la fenêtre, les paramètres du texte, les étapes de navigation et le comportement de défilement attendu. Joignez une référence de capture d'écran expurgée si vous en avez une.

Rendre les preuves utiles et sûres à partager

Une capture d'écran ou un court enregistrement doit montrer l'état concerné. Référencez un fichier ou une pièce jointe à accès contrôlé dans votre outil de suivi des problèmes. Supprimez les informations d'identification et les données personnelles des captures et des journaux avant de les partager. Ce site Web ne télécharge pas de preuves.

Bouclez la boucle avec un nouveau test

Après un correctif, réexécutez les étapes d'origine sur la nouvelle version et l'enregistrement a réussi, a échoué ou n'a pas pu être vérifié. Incluez les flux adjacents dans les contrôles de régression. Ne marquez pas un problème comme résolu simplement parce qu’une modification a été apportée.

Est-ce la même chose qu'un rapport de bug du système Android ?

Non. Il s’agit d’une description structurée du problème pour une personne ou un outil de suivi du problème. Les rapports de bogues du système Android contiennent des journaux de diagnostic et sont collectés séparément avec les outils Android.

Le générateur teste-t-il mon application ?

Non. Vous saisissez les observations issues de vos propres tests. Le générateur les formate ; il n'inspecte pas un APK, ne collecte pas les journaux de l'appareil et ne vérifie pas un défaut.

Combien de détails sont suffisants ?

Incluez suffisamment de contexte pour qu'une autre personne atteigne le même état, suivez les étapes et comparez les résultats. Gardez le rapport concentré sur un seul problème.