SourceLinkSource Link

SourceLink ist eine Technologie, mit der Entwickler Quellcode aus .NET-Assemblys über NuGet debuggen können.Source Link is a technology that enables source code debugging of .NET assemblies from NuGet by developers. SourceLink wird beim Erstellen des NuGet-Pakets ausgeführt und bettet Metadaten der Quellcodeverwaltung in Assemblys und das Paket ein.Source Link executes when creating the NuGet package and embeds source control metadata inside assemblies and the package. Entwickler, die das Paket herunterladen und SourceLink in Visual Studio aktiviert haben, können den Quellcode schrittweise ausführen.Developers who download the package and have Source Link enabled in Visual Studio can step into its source code. SourceLink bietet Metadaten zur Quellcodeverwaltung, um das Debuggen zu optimieren.Source Link provides source control metadata to create a great debugging experience.

Anweisungen zum Verwenden von SourceLink finden Sie im GitHub-Repository dotnet/sourcelink.Instructions for using Source Link can be found on the dotnet/sourcelink GitHub repository.

Sie können mit dem NuGet-Paket-Explorer bestätigen, dass die SourceLink-Metadaten erfolgreich in das Paket eingebettet wurden.You can use NuGet Package Explorer to confirm that the Source Link metadata has been successfully embedded in the package. Überprüfen Sie, ob die Repository-Metadaten über eine Commit-ID verfügen, und ob sich PDB-Dateien in der jeweiligen DLL-Zieldatei befinden.Check the Repository metadata is present with a commit identifier and that .pdb files are located with each target's .dll.

Quellenlink im NuGet-Paket-ExplorerSource Link in NuGet Package Explorer

✔️ Erwägen Sie, Ihren Assemblys und NuGet-Paketen gegebenenfalls mithilfe von Source Link Metadaten der Quellcodeverwaltung hinzuzufügen.✔️ CONSIDER using Source Link to add source control metadata to your assemblies and NuGet packages.

Tipp

Sie können für Entwickler den Debugvorgang weiter verbessern, indem Sie Ihren Typen Debuggerattribute hinzufügen.You can further enhance a developer's debugging experience by adding debugger attributes to your types.

✔️ Erwägen Sie, Symboldateien zu veröffentlichen (*.pdb).✔️ CONSIDER publishing symbol files (*.pdb).

Für das beste Debugergebnis sollte Ihre Bibliothek sowohl Symboldateien veröffentlichen als auch SourceLink verwenden.For the best debugging experience your library should publish symbol files as well as use Source Link. Weitere Informationen zu Symboldateien und Symbolpaketen finden Sie unter Symbolpakete.For more information about symbol files and symbol packages, see Symbol packages.

✔️ ERWÄGEN SIE, deterministische Builds zu aktivieren.✔️ CONSIDER enabling deterministic builds.

Deterministische Builds ermöglichen die Überprüfung, ob die resultierende Binärdatei aus der angegebenen Quelle erstellt wurde, und die Nachverfolgbarkeit.Deterministic builds enable verification that the resulting binary was built from the specified source and provide traceability. Weitere Informationen zu deterministischen Builds und Anweisungen zu deren Aktivierung finden Sie unter Deterministic Builds (Deterministische Builds).For more information about deterministic builds and instructions for enabling them, see Deterministic Builds.