소스 링크를 사용하여 NuGet 패키지로 디버깅Debugging into NuGet packages with Source Link

소스 링크 기술을 사용하면 소스 파일에 대한 링크를 포함하여 .PDB를 제공하는 NuGet에서 .NET 어셈블리의 소스 코드를 디버깅할 수 있습니다.Source Link technology enables source code debugging of .NET assemblies from NuGet that ship .PDBs with links to source files. 소스 링크는 개발자가 NuGet 패키지를 만들 때 실행되며 어셈블리 및 패키지 내부에 소스 제어 메타데이터를 포함합니다.Source Link executes when developers create their NuGet package and embed source control metadata inside assemblies and the package. Mac용 Visual Studio에서 소스 링크를 사용하도록 설정하면 IDE는 설치된 패키지에 대해 소스 파일을 사용할 수 있는지 검색합니다.When Source Link is enabled in Visual Studio for Mac, the IDE will detect if source files are available for installed packages. 그러면 Mac용 Visual Studio가 소스 파일 다운로드를 제공합니다. 개발자는 이를 사용하여 패키지 코드를 단계별로 실행할 수 있습니다.Visual Studio for Mac will then offer to download them, which will allow you to step through the package code. 또한 소스 링크는 Xamarin 프로젝트의 Mono 기본 클래스 라이브러리 코드에서도 작동하므로 .NET Framework 코드를 한 단계씩 실행할 수 있습니다.Source Link also works with Mono Base Class Library code for Xamarin projects, allowing you to step into .NET Framework code as well. 소스 링크는 뛰어난 디버깅 환경을 만들기 위해 소스 제어 메타데이터를 제공합니다.Source Link provides source control metadata to create a great debugging experience.

참고

Mac용 Visual Studio는 현재 기호 서버를 지원하지 않습니다.Visual Studio for Mac does not currently support symbol servers. 따라서 메타데이터가 기호 서버에서 호스트되는 소스 링크는 지원되지 않습니다.Because of this, Source Link with metadata hosted on symbol servers is not supported.

Mac용 Visual Studio에서 소스 링크를 사용하도록 설정하려면 Visual Studio > 기본 설정... > 프로젝트 > 디버거로 이동하고 한 단계씩 외부 코드 실행 확인란이 선택되었는지 확인합니다.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.

한 단계씩 외부 코드 실행 확인란을 보여 주는 기본 설정 대화 상자의 스크린샷

외부 코드 다운로드에서 원하는 대로 설정을 변경할 수 있습니다.You can change the setting in Download External Code to suit your preferences:

  • 묻기: Mac용 Visual Studio에 외부 코드를 다운로드하라는 메시지가 표시됩니다.Ask: Visual Studio for Mac will prompt you to download the external code
  • 항상: Mac용 Visual Studio에서 외부 코드를 자동으로 다운로드합니다.Always: Visual Studio for Mac will download the external code automatically
  • 안 함: Mac용 Visual Studio에서 관련 외부 코드를 다운로드하지 않습니다.Never: Visual Studio for Mac won't download the related external code

기본적으로 묻기가 선택되어 있습니다.By default, Ask is selected. NuGet 패키지에 대한 외부 코드가 검색되면 다음 프롬프트가 표시됩니다.You'll receive the following prompt when external code is found for a NuGet package:

NuGet 패키지에 대한 외부 코드가 검색되었을 때 표시되는 프롬프트의 스크린샷

참조See also