Source Link avecXamarin.Forms

Xamarin.FormsLes packages NuGet incluent des mappages Source Link. Source Link mappe les bibliothèques compilées, contenues dans un package NuGet, à un référentiel de code source. Visual Studio télécharge les fichiers de code source pendant le débogage et permet aux développeurs de parcourir le code, ce qui permet le débogage des packages sans génération à partir de la source.

Pour plus d’informations sur l’utilisation de Source Link, consultez Source Link Documentation.

Avertissement

Visual Studio 2019 prend en charge Source Link pour le débogueur .NET, mais ne prend pas actuellement en charge Source Link pour le débogueur Mono. Par conséquent, vous pouvez utiliser Source Link pour déboguer des applications UWP, mais pas des applications Android ou iOS. Lors du débogage d’applications UWP, vous devez vous assurer que les fichiers PDB pour les bibliothèques à déboguer sont copiés dans le dossier AppX dans le répertoire bin où votre application est compilée.

L’utilisation de Source Link nécessite l’activation du débogage pour le code externe. Sinon, le débogueur passe au-delà des appels au code non contenu dans la solution actuelle. Dans Visual Studio 2019, vous pouvez le trouver sous le menu Options de la section Débogage :

Activer Source Link dans Visual Studio 2019

Assurez-vous que l’option Activer uniquement mon code est désactivée et que l’option Activer Source Link prise en charge est activée.

L’utilisation de Source Link nécessite l’activation du débogage pour le code externe. Sinon, le débogueur passe au-delà des appels au code non contenu dans la solution actuelle. Cette option se trouve dans la fenêtre Préférences de la section Débogueur :

Activer Source Link dans Visual Studio pour Mac

Vérifiez que l’étape dans le code externe est activée.

Si le débogage de packages externes est activé, Visual Studio utilise les mappages Source Link contenus dans le package NuGet pour télécharger et parcourir le code source externe. Cela peut être testé en définissant un point d’arrêt sur un appel à une méthode fournie par Xamarin.Forms:

Point d’arrêt défini sur la Xamarin.Forms méthode

En fonction des paramètres que vous avez spécifiés dans les options du débogueur , Visual Studio vous avertit qu’il télécharge des fichiers sources :

Avertissement de code externe Visual Studio

Une fois que vous avez autorisé Visual Studio à télécharger les fichiers, le débogueur entre dans le code externe.

Source Link utilise la mise en cache pour les performances. Le répertoire de mise en cache pour le lien source est défini dans le menu Options sous Débogage dans la section Symboles :

Mise en cache Source Link Visual Studio

Ce menu vous permet de spécifier le répertoire de mise en cache de tous les symboles de débogage, ainsi que d’effacer le cache si vous rencontrez des problèmes avec les symboles mis en cache.

Source Link utilise la mise en cache pour les performances. Le répertoire de mise en cache pour Source Link sur MacOS est /Users/<username>/Library/Caches/VisualStudio/8.0/Symbols. Ce dossier contient des sous-dossiers qui stockent le dépôt utilisé pour télécharger les fichiers sources. Si le dépôt de stockage d’un package NuGet a changé, vous devrez peut-être supprimer manuellement ces dossiers pour actualiser le cache.