Lien source

Source Link est une technologie qui permet le débogage de code source d’assemblys .NET à partir de NuGet par les développeurs. Source Link s’exécute lors de la création du package NuGet et incorpore les métadonnées de contrôle de code source dans les assemblys et le package. Les développeurs qui téléchargent le package et qui ont activé source Link dans Visual Studio peuvent passer à pas dans son code source. Source Link fournit des métadonnées de contrôle de code source pour créer une expérience de débogage optimale.

Démonstration du lien source

Utilisation du lien source

Vous trouverez des instructions sur l’utilisation du lien source dans le dépôt GitHub dotnet/sourcelink .

Vous pouvez utiliser l’application de bureau De l’Explorateur de packages NuGet ou le site web nuget.info pour vérifier que les métadonnées du lien source ont été incorporées avec succès dans le package. Vérifiez que les métadonnées Repository sont présentes avec un identificateur de commit et que les fichiers .pdb se trouvent avec le fichier .dll de chaque cible.

✔️ ENVISAGEZ d’utiliser source Link pour ajouter des métadonnées de contrôle de code source à vos assemblys et packages NuGet.

Conseil / Astuce

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 l’affichage d’une classe ou d’un champ 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.

✔️ ENVISAGEZ de publier des fichiers de symboles (*.pdb).

Pour une expérience de débogage optimale, votre bibliothèque doit publier des fichiers de symboles et utiliser le lien source. Pour plus d’informations sur les fichiers de symboles et les packages de symboles, consultez Packages de symboles.

✔️ ENVISAGEZ d’activer les builds déterministes.

Les builds déterministes permettent de vérifier que le binaire obtenu a été généré à partir de la source spécifiée et fournir une traçabilité. Pour plus d’informations sur les builds déterministes et les instructions pour les activer, consultez Builds déterministes.

PrécédentSuivant