Source Link

O Source Link é uma tecnologia que permite a depuração de código-fonte dos assemblies .NET do NuGet por desenvolvedores. O Source Link é executado durante a criação do pacote NuGet e insere os metadados de controle do código-fonte nos assemblies e no pacote. Os desenvolvedores que baixam o pacote e têm o Source Link habilitado no Visual Studio podem intervir no código-fonte. O Source Link fornece metadados de controle do código-fonte para criar uma ótima experiência de depuração.

Demonstração do Source Link

Usando o Source Link

Encontre instruções sobre como usar o Source Link no repositório GitHub dotnet/sourcelink.

Use o aplicativo da área de trabalho Explorador de Pacotes NuGet ou o site nuget.info para confirmar que os metadados do Source Link foram inseridos com êxito no pacote. Verifique se os metadados Repository estão presentes com um identificador de commit e se os arquivos .pdb estão localizados com o .dll de cada destino.

✔️ CONSIDERE o uso do Source Link para adicionar metadados de controle do código-fonte aos assemblies e pacotes NuGet.

Dica

Você ainda pode aprimorar a experiência de depuração do desenvolvedor com a adição de atributos do depurador aos seus tipos.

• DebuggerDisplayAttribute pode personalizar como uma classe ou campo é exibido nas janelas de variáveis do depurador.
• DebuggerStepThroughAttribute instrui o depurador a depurar o código em vez de intervir nele.
• DebuggerBrowsableAttribute controla se um membro é exibido nas janelas de variáveis do depurador.

✔️ CONSIDERE publicar arquivos de símbolo (*.pdb).

Para proporcionar a melhor experiência de depuração, a biblioteca deverá publicar arquivos de símbolo, além de usar o Source Link. Para obter mais informações sobre arquivos de símbolo e pacotes de símbolos, confira Pacotes de símbolos.

✔️ CONSIDERE habilitar builds determinísticos.

Os builds determinísticos permitem a verificação de que o binário resultante foi criado com base na origem especificada e fornecem rastreabilidade. Para obter mais informações sobre builds determinísticos e instruções para habilitá-los, confira Builds determinísticos.

AnteriorAvançar