소스 링크Source Link

소스 링크는 개발자가 NuGet에서 제공하는 .NET 어셈블리의 소스 코드 디버깅을 가능하게 해주는 기술입니다.Source Link is a technology that enables source code debugging of .NET assemblies from NuGet by developers. 소스 링크는 NuGet 패키지를 만들 때 실행되며 어셈블리 및 패키지 내부에 소스 제어 메타데이터를 포함합니다.Source Link executes when creating the NuGet package and embeds source control metadata inside assemblies and the package. 패키지를 다운로드하고 Visual Studio에서 소스 링크를 사용하도록 설정한 개발자는 소스 코드를 한 단계씩 실행할 수 있습니다.Developers who download the package and have Source Link enabled in Visual Studio can step into its source code. 소스 링크는 뛰어난 디버깅 환경을 만들기 위해 소스 제어 메타데이터를 제공합니다.Source Link provides source control metadata to create a great debugging experience.

소스 링크 사용에 대한 지침은 dotnet/sourcelink GitHub 리포지토리에서 확인할 수 있습니다.Instructions for using Source Link can be found on the dotnet/sourcelink GitHub repository.

NuGet 패키지 탐색기를 사용하여 소스 링크 메타데이터가 패키지에 성공적으로 포함되었는지 확인할 수 있습니다.You can use NuGet Package Explorer to confirm that the Source Link metadata has been successfully embedded in the package. 주석 식별자가 포함된 Repository 메타데이터가 있는지와 .pdb 파일이 각 대상의 .dll과 함께 있는지 확인합니다.Check the Repository metadata is present with a commit identifier and that .pdb files are located with each target's .dll.

NuGet 패키지 탐색기의 소스 링크Source Link in NuGet Package Explorer

✔️ 어셈블리 및 NuGet 패키지에 소스 제어 메타데이터를 추가하는 데 소스 링크를 사용하는 것을 고려하세요.✔️ CONSIDER using Source Link to add source control metadata to your assemblies and NuGet packages.

사용자 유형에 디버거 특성을 추가하여 개발자의 디버깅 환경을 향상시킬 수 있습니다.You can further enhance a developer's debugging experience by adding debugger attributes to your types.

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

최상의 디버깅 환경을 위해서는 라이브러리에서 기호 파일을 게시하고 소스 링크를 사용해야 합니다.For the best debugging experience your library should publish symbol files as well as use Source Link. 기호 파일 및 기호 패키지에 대한 자세한 내용은 기호 패키지를 참조하세요.For more information about symbol files and symbol packages, see Symbol packages.

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

결정적 빌드에서는 결과 이진 파일이 지정된 소스에서 빌드되었는지 확인할 수 있고 추적 가능성을 제공합니다.Deterministic builds enable verification that the resulting binary was built from the specified source and provide traceability. 결정적 빌드 및 이를 사용하도록 설정하는 방법에 대한 자세한 내용은 결정적 빌드를 참조하세요.For more information about deterministic builds and instructions for enabling them, see Deterministic Builds.