Source Link

Source Link — это технология, которая дает возможность разработчикам выполнять отладку исходного кода сборок .NET из NuGet. Source Link выполняется при создании пакета NuGet и внедряет метаданные системы управления версиями внутри сборки и пакета. Разработчики, загрузившие пакет и включившие Source Link в Visual Studio, могут выполнить исходный код по шагам. Source Link предоставляет метаданные системы управления версиями для создания эффективной среды отладки.

Демонстрация Source Link

Использование Source Link

Инструкции по использованию Source Link можно найти в репозитории GitHub dotnet/sourceLink.

Вы можете использовать классическое приложение пакета NuGet Обозреватель или веб-сайт nuget.info, чтобы убедиться, что метаданные исходного канала успешно внедрены в пакет. Убедитесь, что метаданные Repository присутствуют с идентификатором фиксации и что PDB-файлы находятся с .dll каждого целевого объекта.

✔ РЕКОМЕНДУЕТСЯ использовать Source Link для добавления метаданных системы управления версиями в сборки и пакеты NuGet.

Совет

Вы можете дополнительно повысить эффективность отладки путем добавления атрибутов отладчика в типы.

• DebuggerDisplayAttribute может определять, как класс или поле будет отображаться в окнах переменных отладчика.
• DebuggerStepThroughAttribute дает отладчику указание о сквозной обработке кода (вместо выполнения по шагам).
• DebuggerBrowsableAttribute определяет, будет ли член отображаться в окнах переменных отладчика.

✔ РЕКОМЕНДУЕТСЯ публиковать файлы символов (*.pdb).

Для повышения качества отладки библиотеки следует публиковать файлы символов, а также использовать ссылки на источник. См. дополнительные сведения о файлах и пакетах символов.

✔️ РЕКОМЕНДУЕТСЯ включить детерминированные сборки.

Детерминированные сборки позволяют убедиться в том, что полученный двоичный файл построен на основе указанного источника и обеспечивает трассировку. См. сведения о детерминированных сборках и инструкции по их включению.

НазадДалее