Collegamento all'origine
Il collegamento all'origine è una tecnologia che consente il debug del codice sorgente degli assembly .NET da NuGet da parte degli sviluppatori. Il collegamento all'origine viene eseguito durante la creazione del pacchetto NuGet e incorpora i metadati di controllo del codice sorgente all'interno degli assembly e del pacchetto. Gli sviluppatori che scaricano il pacchetto e che hanno abilitato il collegamento all'origine in Visual Studio possono eseguire istruzione per istruzione il relativo codice sorgente. Il collegamento all'origine fornisce i metadati di controllo del codice sorgente per creare una straordinaria esperienza di debug.
Demo del collegamento all'origine
Uso del collegamento all'origine
Le istruzioni per l'uso del collegamento all'origine sono reperibili nel repository GitHub dotnet/sourcelink.
È possibile usare l'app desktop NuGet Package Explorer o il sito web nuget.info per confermare che i metadati di Source Link siano stati incorporati correttamente nel pacchetto. Controllare che i metadati Repository siano presenti con un identificatore di commit e che i file con estensione .pdb si trovino insieme al .dll di ogni file di destinazione.
✔️ VALUTARE l'uso del collegamento all'origine per aggiungere metadati di controllo del codice sorgente agli assembly e ai pacchetti NuGet.
Suggerimento
È possibile migliorare ulteriormente l'esperienza di debug di uno sviluppatore tramite l'aggiunta di attributi del debugger ai tipi in uso.
- DebuggerDisplayAttribute può personalizzare la modalità di visualizzazione di una classe o di un campo nelle finestre delle variabili del debugger.
- DebuggerStepThroughAttribute indica al debugger di eseguire il codice un'istruzione alla volta anziché eseguire un'istruzione nel codice.
- DebuggerBrowsableAttribute controlla se viene visualizzato un membro nelle finestre delle variabili del debugger.
✔️ VALUTARE la pubblicazione dei file di simboli (*.pdb).
Per ottenere un'esperienza di debug ottimale, la libreria deve pubblicare i file di simboli oltre a usare il collegamento all'origine. Per altre informazioni sui file di simboli e i pacchetti di simboli, vedere Pacchetti di simboli.
✔️ VALUTARE l'abilitazione di compilazioni deterministiche.
Le compilazioni deterministiche consentono di verificare che il file binario risultante sia stato compilato dall'origine specificata e fornisca la tracciabilità. Per altre informazioni sulle compilazioni deterministiche e istruzioni per abilitarle, vedere Compilazioni deterministiche.
