다음을 통해 공유


소스 링크

소스 링크는 개발자가 NuGet에서 제공하는 .NET 어셈블리의 소스 코드 디버깅을 가능하게 해주는 기술입니다. 소스 링크는 NuGet 패키지를 만들 때 실행되며 어셈블리 및 패키지 내부에 소스 제어 메타데이터를 포함합니다. 패키지를 다운로드하고 Visual Studio에서 소스 링크를 사용하도록 설정한 개발자는 소스 코드를 한 단계씩 실행할 수 있습니다. 소스 링크는 뛰어난 디버깅 환경을 만들기 위해 소스 제어 메타데이터를 제공합니다.

소스 링크 사용에 대한 지침은 dotnet/sourcelink GitHub 리포지토리에서 확인할 수 있습니다.

NuGet 패키지 탐색기 데스크톱 앱 또는 nuget.info 웹 사이트를 사용하여 원본 링크 메타데이터가 패키지에 성공적으로 포함되었는지 확인할 수 있습니다. Repository 메타데이터가 커밋 식별자와 함께 있는지와 .pdb 파일이 각 대상의 .dll과 함께 있는지를 확인하세요.

Source Link in NuGet Package Explorer

✔️ 어셈블리 및 NuGet 패키지에 소스 제어 메타데이터를 추가하는 데 소스 링크를 사용하는 것을 고려하세요.

사용자 유형에 디버거 특성을 추가하여 개발자의 디버깅 환경을 향상시킬 수 있습니다.

  • DebuggerDisplayAttribute는 클래스 또는 필드가 디버거 변수 창에 표시되는 방법을 사용자 지정할 수 있습니다.
  • DebuggerStepThroughAttribute는 디버거가 코드를 한 단계씩 실행하는 대신 코드를 단계별로 실행하도록 디버거에 지시합니다.
  • DebuggerBrowsableAttribute는 멤버가 디버거 변수 창에 표시되는지 여부를 제어합니다.

✔️ 기호 파일(*.pdb)을 사용하는 것을 고려하세요.

최상의 디버깅 환경을 위해서는 라이브러리에서 기호 파일을 게시하고 소스 링크를 사용해야 합니다. 기호 파일 및 기호 패키지에 대한 자세한 내용은 기호 패키지를 참조하세요.

✔️ 결정적 빌드를 사용하도록 설정하는 것이 좋습니다.

결정적 빌드에서는 결과 이진 파일이 지정된 소스에서 빌드되었는지 확인할 수 있고 추적 가능성을 제공합니다. 결정적 빌드 및 이를 사용하도록 설정하는 방법에 대한 자세한 내용은 결정적 빌드를 참조하세요.