Depuração em pacotes NuGet com o link de origemDebugging into NuGet packages with Source Link

A tecnologia de link de origem permite a depuração de código-fonte de assemblies .NET do NuGet que são fornecidos. PDBs com links para arquivos de origem.Source Link technology enables source code debugging of .NET assemblies from NuGet that ship .PDBs with links to source files. O link de origem é executado quando os desenvolvedores criam seu pacote NuGet e inserem metadados de controle do código-fonte dentro de assemblies e do pacote.Source Link executes when developers create their NuGet package and embed source control metadata inside assemblies and the package. Quando o link de origem estiver habilitado no Visual Studio para Mac, o IDE detectará se os arquivos de origem estão disponíveis para os pacotes instalados.When Source Link is enabled in Visual Studio for Mac, the IDE will detect if source files are available for installed packages. Visual Studio para Mac, em seguida, oferecerá baixá-los, o que permitirá que você percorra o código do pacote.Visual Studio for Mac will then offer to download them, which will allow you to step through the package code. O link de origem também funciona com código de biblioteca de classes base mono para projetos do Xamarin, permitindo que você entre .NET Framework código também.Source Link also works with Mono Base Class Library code for Xamarin projects, allowing you to step into .NET Framework code as well. O Source Link fornece metadados de controle do código-fonte para criar uma ótima experiência de depuração.Source Link provides source control metadata to create a great debugging experience.

Observação

Atualmente, o Visual Studio para Mac não dá suporte a servidores de símbolo.Visual Studio for Mac does not currently support symbol servers. Por isso, não há suporte para o link de origem com metadados hospedados em servidores de símbolos.Because of this, Source Link with metadata hosted on symbol servers is not supported.

Para habilitar o link de origem em Visual Studio para Mac, navegue até Visual Studio > preferências... > projetos > depurador e certifique-se de que a caixa de seleção etapa em código externo esteja marcada.To enable Source Link in Visual Studio for Mac, browse to Visual Studio > Preferences... > Projects > Debugger and ensure the Step into external code checkbox is checked.

Captura de tela da caixa de diálogo Preferências mostrando a etapa em código externo

Você pode alterar a configuração em baixar código externo para se adequar às suas preferências:You can change the setting in Download External Code to suit your preferences:

  • Ask: Visual Studio para Mac solicitará que você baixe o código externoAsk: Visual Studio for Mac will prompt you to download the external code
  • Sempre: Visual Studio para Mac baixará o código externo automaticamenteAlways: Visual Studio for Mac will download the external code automatically
  • Nunca: Visual Studio para Mac não baixará o código externo relacionadoNever: Visual Studio for Mac won't download the related external code

Por padrão, Ask está selecionado.By default, Ask is selected. Você receberá o seguinte prompt quando o código externo for encontrado para um pacote NuGet:You'll receive the following prompt when external code is found for a NuGet package:

Captura de tela do prompt que aparece quando o código externo é encontrado para um pacote NuGet

Confira tambémSee also