Łącze źródłowe z Xamarin.Forms

Xamarin.Forms Pakiety NuGet obejmują mapowania linków źródłowych. Mapy linków źródłowych skompilowane biblioteki zawarte w pakiecie NuGet do repozytorium kodu źródłowego. Program Visual Studio pobierze pliki kodu źródłowego podczas debugowania i umożliwi deweloperom przechodzenie przez kod, umożliwiając debugowanie pakietów bez kompilowania ze źródła.

Aby uzyskać więcej informacji na temat korzystania z linku źródłowego, zobacz Dokumentację linku źródłowego.

Ostrzeżenie

Program Visual Studio 2019 obsługuje link źródłowy dla debugera platformy .NET, ale obecnie nie obsługuje linku źródłowego dla debugera Mono. W związku z tym można użyć linku źródłowego do debugowania aplikacji platformy UWP, ale nie aplikacji dla systemu Android lub iOS. Podczas debugowania aplikacji platformy UWP należy upewnić się, że pliki PDB dla bibliotek, które chcesz debugować, są kopiowane do folderu AppX w katalogu bin , w którym jest kompilowana aplikacja.

Użycie linku źródłowego wymaga włączenia debugowania dla kodu zewnętrznego. W przeciwnym razie debuger wykona kroki przeszłych wywołań kodu, które nie są zawarte w bieżącym rozwiązaniu. W programie Visual Studio 2019 można to znaleźć w menu Opcje w sekcji Debugowanie :

Enable Source Link in Visual Studio 2019

Upewnij się, że opcja Włącz tylko mój kod jest wyłączona i że włączono obsługę linku źródłowego.

Użycie linku źródłowego wymaga włączenia debugowania dla kodu zewnętrznego. W przeciwnym razie debuger wykona kroki przeszłych wywołań kodu, które nie są zawarte w bieżącym rozwiązaniu. Tę opcję można znaleźć w oknie Preferencje w sekcji Debuger :

Enable Source Link in Visual Studio for Mac

Upewnij się, że opcja Krok do kodu zewnętrznego jest włączona.

Jeśli debugowanie pakietów zewnętrznych jest włączone, program Visual Studio będzie używać mapowań linków źródłowych zawartych w pakiecie NuGet do pobierania i przechodzenia przez zewnętrzny kod źródłowy. Można to przetestować, ustawiając punkt przerwania dla wywołania metody dostarczonej przez Xamarin.Formsusługę :

Breakpoint set on Xamarin.Forms method

W zależności od ustawień określonych w opcjach debugera program Visual Studio wyświetli ostrzeżenie o pobieraniu plików źródłowych:

Visual Studio external code warning

Gdy zezwolisz programowi Visual Studio na pobieranie plików, debuger przejdzie do kodu zewnętrznego.

Link źródłowy używa buforowania na potrzeby wydajności. Katalog buforowania dla linku źródłowego jest zdefiniowany w menu Opcje w obszarze Debugowanie w sekcji Symbole :

Visual Studio Source Link caching

To menu umożliwia określenie katalogu buforowania dla wszystkich symboli debugowania, a także wyczyszczenie pamięci podręcznej, jeśli wystąpią problemy z buforowanych symboli.

Link źródłowy używa buforowania na potrzeby wydajności. Katalog buforowania linku źródłowego w systemie MacOS to /Users/<username>/Library/Caches/VisualStudio/8.0/Symbols. Ten folder zawiera podfoldery, które przechowują repozytorium używane do pobierania plików źródłowych. Jeśli repozytorium zapasowe pakietu NuGet uległo zmianie, może być konieczne ręczne usunięcie tych folderów w celu odświeżenia pamięci podręcznej.