Source Link
Source Link est une technologie qui permet aux développeurs de déboguer le code source des assemblys .NET dans NuGet. Source Link s’exécute lors de la création du package NuGet et incorpore des métadonnées de contrôle de code source à l’intérieur des assemblys et du package. Les développeurs qui téléchargent le package et activent Source Link dans Visual Studio peuvent effectuer un pas à pas détaillé dans son code source. Source Link fournit des métadonnées de contrôle de code source qui améliorent grandement le débogage.
Démonstration de Source Link
Utilisation de Source Link
Vous trouverez des instructions sur l’utilisation de Source Link dans le dépôt GitHub dotnet/sourcelink.
Vous pouvez utiliser l’application de bureau NuGet Package Explorer ou le site web nuget.info pour vous assurer que les métadonnées Source Link ont été correctement incorporées dans le package. Vérifiez que les métadonnées Repository sont présentes avec un identificateur de validation et que les fichiers .pdb se trouvent avec le fichier .dll de chaque cible.
✔️ À ENVISAGER : Utiliser Source Link pour ajouter des métadonnées de contrôle de code source à vos assemblys et packages NuGet.
Conseil
Vous pouvez améliorer davantage l’expérience de débogage d’un développeur en ajoutant des attributs de débogueur à vos types.
- DebuggerDisplayAttribute peut personnaliser la façon dont une classe ou un champ s’affiche dans les fenêtres de variables du débogueur.
- DebuggerStepThroughAttribute demande au débogueur de parcourir le code au lieu d’y effectuer un pas à pas détaillé.
- DebuggerBrowsableAttribute contrôle si un membre est affiché dans les fenêtres de variables du débogueur.
✔️ À ENVISAGER : publication des fichiers de symboles (*.pdb).
Pour une meilleure expérience de débogage, votre bibliothèque doit publier les fichiers de symboles et utiliser Source Link. Pour plus d’informations sur les fichiers de symboles et les packages de symboles, consultez Packages de symboles.
✔️ À ENVISAGER : activer les builds déterministes.
Les builds déterministes permettent de vérifier que le binaire généré a été créé à partir de la source spécifiée et fournissent la traçabilité. Pour plus d’informations sur les builds déterministes et pour savoir comment les activer, consultez Builds déterministes.
