Ссылка на источник с помощью Xamarin. FormsSource Link with Xamarin.Forms

Пакеты NuGet Xamarin. Forms включают сопоставления исходных ссылок.Xamarin.Forms NuGet packages include Source Link mappings. Ссылка на источник сопоставляет скомпилированные библиотеки, содержащиеся в пакете NuGet, с репозиторием исходного кода.Source Link maps compiled libraries, contained in a NuGet package, to a source code repository. Visual Studio загрузит файлы исходного кода во время отладки и позволит разработчикам выполнять код по шагам, обеспечивая отладку пакетов без сборки из источника.Visual Studio will download source code files during debugging and allow developers to step through code, enabling debugging of packages without building from source.

Дополнительные сведения об использовании исходной ссылки см. в документации по исходной ссылке.For more information about using Source Link, see Source Link Documentation.

Предупреждение

Visual Studio 2019 поддерживает ссылку на исходный код для отладчика .NET , но в настоящее время не поддерживает ссылку на исходный код для отладчика Mono.Visual Studio 2019 supports Source Link for the .NET debugger but does not currently support Source Link for the Mono debugger. Таким образом, исходную ссылку можно использовать для отладки приложений UWP, но не для приложений Android или iOS.Therefore, you can use Source Link to debug UWP apps, but not Android or iOS app. При отладке приложений UWP необходимо убедиться, что PDB-файлы библиотек, которые вы хотите отладить, копируются в папку appx в каталоге bin , где выполняется компиляция приложения.When debugging UWP apps you must ensure that the PDB files for libraries you want to debug are copied to the AppX folder in the bin directory where your app is compiled.

Для использования исходной ссылки требуется включить отладку для внешнего кода. в противном случае отладчик будет выполнять предшествующие вызовы кода, не содержащегося в текущем решении.Using Source Link requires enabling debugging for external code, otherwise the debugger will step past calls to code not contained in the current solution. В Visual Studio 2019 это можно найти в меню Параметры в разделе Отладка :In Visual Studio 2019 this can be found under the Options menu in the Debugging section:

Ссылка на Enable источник в Visual Studio 2019Enable Source Link in Visual Studio 2019

Убедитесь, что параметр Включить только мой код отключен и включен параметр Включить поддержку ссылок на источники .Ensure that Enable just my code is disabled and that Enable Source Link support is enabled.

Для использования исходной ссылки требуется включить отладку для внешнего кода. в противном случае отладчик будет выполнять предшествующие вызовы кода, не содержащегося в текущем решении.Using Source Link requires enabling debugging for external code, otherwise the debugger will step past calls to code not contained in the current solution. Этот параметр можно найти в окне " настройки " в разделе " отладчик ":This option can be found in the Preferences window in the Debugger section:

Ссылка на источник Enable в Visual Studio для MacEnable Source Link in Visual Studio for Mac

Убедитесь, что Шаг с заходом в внешний код включен.Ensure that Step into external code is enabled.

Если отладка внешних пакетов включена, Visual Studio будет использовать сопоставления исходной ссылки, содержащиеся в пакете NuGet, для скачивания и пошагового использования внешнего исходного кода.If debugging external packages is enabled, Visual Studio will use the Source Link mappings contained in the NuGet package to download and step through external source code. Это можно проверить, установив точку останова в вызове метода, предоставляемого Xamarin. Forms:This can be tested by setting a breakpoint on a call to a method provided by Xamarin.Forms:

Breakpoint задано в методе Xamarin. FormsBreakpoint set on Xamarin.Forms method

В зависимости от параметров, указанных в параметрах отладчика , Visual Studio выдаст предупреждение о том, что выполняется скачивание исходных файлов:Depending on the settings you specified in the Debugger options, Visual Studio will warn you that it is downloading source files:

предупреждение внешнего кода Visual StudioVisual Studio external code warning

После того как вы разрешите Visual Studio загрузить файлы, отладчик выполнит шаг с заходом в внешний код.Once you allow Visual Studio to download the files, the debugger will step into the external code.

Ссылка на источник использует кэширование для повышения производительности.Source Link uses caching for performance. Каталог Caching для ссылки на источник определяется в меню Параметры в разделе Отладка в разделе символы :The caching directory for Source link is defined in the Options menu under Debugging in the Symbols section:

Кэширование исходной ссылки Visual StudioVisual Studio Source Link caching

Это меню позволяет указать каталог кэширования для всех отладочных символов, а также очистить кэш при возникновении проблем с кэшированными символами.This menu allows you to specify the caching directory for all debug symbols, as well as clear the cache if you encounter issues with cached symbols.

Ссылка на источник использует кэширование для повышения производительности.Source Link uses caching for performance. Каталог Caching для ссылки на источник в MacOS — /Users/<username>/Library/Caches/VisualStudio/8.0/Symbols.The caching directory for Source Link on MacOS is /Users/<username>/Library/Caches/VisualStudio/8.0/Symbols. Эта папка содержит вложенные папки, в которых хранится репозиторий, используемый для загрузки исходных файлов.This folder contains subfolders that store the repository used to download source files. Если резервный репозиторий для пакета NuGet изменился, может потребоваться вручную удалить эти папки для обновления кэша.If the backing repository for a NuGet package has changed, you may need to manually delete these folders to refresh the cache.