Partager via

Quand et comment dois-je classer un rapport de bogues ?

  • Article

Conseil

Utilisez l’élément de menu Signaler un problème dans Visual Studio, ce qui envoie des informations de diagnostic ainsi que votre rapport de bogue pour vous aider à résoudre le problème.

Il existe des instructions détaillées pour Visual Studio 2019 ou Visual Studio 2017 et Visual Studio pour Mac.

Vous pouvez rechercher des rapports existants sur le site web Developer Community Visual Studio.

Signaler un bogue si...

Vous avez un ensemble d’étapes que vous pensez que les ingénieurs seront en mesure d’utiliser pour reproduire un problème.

OR

Vous pouvez décrire soigneusement les symptômes visibles du problème, surtout si vous pouvez également décrire certaines circonstances précises liées au problème. [1]

Meilleures pratiques pour résoudre les bogues rapidement et efficacement

  1. Recherchez dans Visual Studio Developer Community et sur le web des rapports de bogues existants ou des suggestions d’utilisation susceptibles de résoudre directement le problème.[2][3]

  2. Décrivez le problème de manière aussi claire et concise que possible, y compris une description de ce qui s’est passé et était censé se produire.

  3. Incluez les traces de pile, le texte des messages d’erreur ou les journaux d’activité d’incident pertinents (si vous utilisez la fonctionnalité Signaler un problème , ceux-ci peuvent être inclus automatiquement). [4]

  4. Notez également les messages d’erreur importants qui s’affichent dans les pièces jointes de capture d’écran sous forme de texte brut.

  5. Incluez un petit cas de test autonome qui reproduit le bogue avec le moins de code possible. Si vous ne pouvez pas reproduire le problème avec un tout nouveau projet (créé à l’aide de l’un des modèles intégrés), veuillez compresser un projet qui illustre le problème et l’attacher au rapport de bogues. Faites en sorte que l’exemple de projet soit aussi simple que possible avant de l’attacher. [5][6]

  6. Décrire l’environnement dans lequel le bogue a été rencontré, y compris le système d’exploitation et les versions de Xamarin et les dépendances éventuelles.

Informations supplémentaires

  1. ^ Dans l’idéal, la description des « symptômes visibles » doit inclure suffisamment de détails pour que d’autres clients puissent confirmer s’ils voient le même problème (mêmes messages d’erreur, même dégradation des performances, même trace de pile à partir d’un incident, etc.). Pour les « circonstances précises », un bon exemple serait si vous pouvez dire quelque chose comme : « J’ai normalement frappé le problème 75 % du temps, mais si je change cette chose, je peux éviter complètement le problème. » Un autre exemple similaire de « circonstance précise » est si la rétrogradation vers une version précédente de Xamarin arrête le problème.

  2. ^ Comme vous vous en doutez, les extraits de texte d’erreur (ou tout autre texte descriptif unique) sont généralement les meilleurs termes de recherche. Si le rapport de bogues existant est incomplet, vous pouvez ajouter des détails ou créer un nouveau rapport de bogues amélioré.

  3. ^ Une autre bonne question est de savoir si le même problème a été signalé pour les applications Java, Objective-Cou Swift. Si c’est le cas, le problème fait probablement partie d’Android ou d’iOS lui-même plutôt que d’une partie de Xamarin.

  4. ^ Voici quelques exemples d’informations à inclure :

    1. Pour les erreurs qui se produisent lors de la génération d’un projet, incluez la sortie complète de la build de diagnostic dans le rapport de bogues.

    2. Pour les erreurs qui se produisent lors de la génération ou du débogage d’un projet iOS à partir de Visual Studio, exécutez Help > Xamarin > Zip Logs après avoir atteint l’erreur et incluez le fichier .zip résultant dans le rapport de bogues.

    3. Pour les exceptions ou les incidents dans les applications Android ou iOS, incluez les journaux de débogage appropriés pour les applications Xamarin.Android et Xamarin.iOS.

  5. ^ Si possible pour votre problème particulier, une option consiste à recréer le problème en ajoutant un petit nombre de fichiers de votre solution d’origine dans une toute nouvelle solution. L’équipe Xamarin sera souvent en mesure d’examiner les problèmes même sur des cas de test plus importants (en supposant que les étapes à reproduire sont expliquées clairement), mais des cas de test plus simples donnent la meilleure chance que le bogue soit résolu rapidement.

  6. ^ S’il n’est pas possible de reproduire le problème en ajoutant un petit nombre de fichiers à une toute nouvelle solution, vous pouvez compresser et joindre l’intégralité du dossier de la solution pour votre application complète. Supprimez les bindossiers , obj, Componentset packages pour réduire la taille du fichier zip. (L’IDE et le processus de génération restaurent ou recréent généralement le contenu de ces dossiers en fonction des besoins.) Vous pouvez également supprimer autant de fichiers de code et de ressources du projet que vous le souhaitez, tant que la solution résultante illustre toujours le problème d’origine.