Поделиться через


Source Link

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

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

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

Source Link in NuGet Package Explorer

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

Совет

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

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

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

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

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

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