Condividi tramite

Collegamento alla fonte

Source Link è una tecnologia che consente agli sviluppatori di eseguire il debug del codice sorgente degli assembly .NET tramite NuGet. Il collegamento di origine viene eseguito durante la creazione del pacchetto NuGet e incorpora i metadati del controllo del codice sorgente all'interno degli assembly e del pacchetto. Gli sviluppatori che scaricano il pacchetto e hanno abilitato il collegamento di origine in Visual Studio possono esplorare il codice sorgente. Il collegamento all'origine fornisce metadati del controllo del codice sorgente per creare un'esperienza di debug ottimale.

Le istruzioni per l'uso del collegamento di origine sono disponibili nel repository GitHub dotnet/sourcelink .

È possibile usare l'app desktop Di Esplora pacchetti NuGet o il sito Web nuget.info per verificare che i metadati del collegamento di origine siano stati incorporati correttamente nel pacchetto. Verificare che i Repository metadati siano presenti con un identificatore di commit e che i file con estensione pdb si trovino con il .dlldi ogni destinazione.

Link di origine in Esplora pacchetti NuGet

✔️ Prendere in considerazione l'uso del collegamento all'origine per aggiungere metadati del controllo del codice sorgente agli assembly e ai pacchetti NuGet.

Suggerimento

È possibile migliorare ulteriormente l'esperienza di debug di uno sviluppatore aggiungendo attributi del debugger ai tipi.

  • DebuggerDisplayAttribute può personalizzare la modalità di visualizzazione di una classe o di un campo nelle finestre delle variabili del debugger.
  • DebuggerStepThroughAttribute istruisce il debugger di eseguire il codice passo per passo invece di entrare nelle funzioni del codice.
  • DebuggerBrowsableAttribute controlla se un membro viene visualizzato nelle finestre delle variabili del debugger.

✔️ PRENDERE IN CONSIDERAZIONE la pubblicazione di file di simboli (*.pdb).

Per un'esperienza di debug ottimale, la libreria deve pubblicare file di simboli e usare il collegamento all'origine. Per altre informazioni sui file di simboli e sui pacchetti di simboli, vedere Pacchetti di simboli.

✔️ VALUTARE l'abilitazione di compilazioni deterministiche.

Le compilazioni deterministiche abilitano la verifica che il file binario risultante sia stato compilato dall'origine specificata e fornisca la tracciabilità. Per altre informazioni sulle compilazioni deterministiche e le istruzioni per abilitarle, vedere Compilazioni deterministiche.

PrecedenteAvanti