Démarrer une session de débogage pour une application du Windows Store dans Visual Studio (VB, C#, C++ et XAML)

Cette rubrique décrit comment démarrer une session de débogage pour les applications Windows Store écrites en XAML et Visual C++, Visual C# ou Visual Basic. Le débogage d'une application implique la configuration de la session de débogage et le choix de la méthode de démarrage de l'application.

Notes

Pour les applications écrites en JavaScript et HTML, voir Démarrer une session de débogage dans Visual Studio (JavaScript) pour des applications du Windows Store.

Dans cette rubrique

La méthode simple pour démarrer le débogage

Configurer la session de débogage

• Ouvrir la page des propriétés de débogage du projet

• Choisir les options de configuration de build

• Sélectionner la cible de déploiement

• Choisir le débogueur à utiliser

• Différer le démarrage de la session de débogage (facultatif)

• Désactiver les bouclages de réseau (facultatif)

• Réinstaller l'application au démarrage du débogage (facultatif)

• (Facultatif) Désactivez la condition d'authentification pour démarrer le débogueur distant

Démarrer la session de débogage

• Démarrer le débogage (F5)

• Démarrer le débogage (F5), mais différer le démarrage de l'application

• Démarrer une application installée dans le débogueur

• Attacher le débogueur à une application en cours de exécution

  • Configurer l'application pour l'exécuter en mode débogage

  • Attacher le débogueur

La méthode simple pour démarrer le débogage

1. Ouvrez la solution d'application dans Visual Studio.

2. Choisissez F5.

Visual Studio génère et démarre l'application avec le débogueur attaché. L'exécution se poursuit jusqu'à ce qu'un point d'arrêt soit atteint, que vous suspendiez manuellement l'exécution, qu'une exception non gérée se produise ou que l'application se termine. Pour plus d'informations, consultez Parcourir une session de débogage dans Visual Studio (XAML et C#).

Configurer la session de débogage

Ouvrir la page des propriétés de débogage du projet

1. Dans l'Explorateur de solutions, sélectionnez le projet. Dans le menu contextuel, choisissez Propriétés.

2. Cela permet d'ouvrir la page des propriétés de débogage du projet :

   • Pour les applications Visual C# et Visual Basic, choisissez Déboguer.

     

   • Pour les applications Visual C++, développez le nœud Propriétés de configuration , puis choisissez Débogage.

     

Choisir les options de configuration de build

1. Dans la liste Configuration, choisissez Déboguer ou (Debug) active.

2. Dans la liste Plateforme, sélectionnez la plateforme cible à générer. Dans la plupart des cas, Any CPU (Toutes les plateformes dans Visual C++) est le meilleur choix.

Sélectionner la cible de déploiement

Vous pouvez déployer et déboguer une application Windows Store sur l'ordinateur Visual Studio, dans le simulateur Visual Studio sur l'ordinateur local ou sur un appareil distant.

• Pour les applications C# et Visual Basic, choisissez la cible dans la liste Périphérique cible sur la page des propriétés Déboguer du projet.

• Pour les applications C++, sélectionnez la cible dans la liste Débogueur à lancer sur la page des propriétés Débogage :

Choisissez l'une des options suivantes :

Ordinateur local	Déboguez l'application dans la session active sur votre ordinateur local. Consultez Exécuter des applications du Windows Store sur un ordinateur local.
Simulateur	Déboguez l'application dans le simulateur Visual Studio pour les applications Windows Store. Le simulateur est une fenêtre du Bureau qui permet de déboguer les fonctionnalités du périphérique, comme les mouvements tactiles et la rotation du périphérique, qui ne sont pas disponibles sur l'ordinateur local. Consultez Exécuter des applications du Windows Store dans le simulateur.
Ordinateur distant	Déboguez l'application sur un périphérique qui est connecté à l'ordinateur local sur un intranet ou directement connecté via un câble Ethernet. Pour déboguer à distance, les outils de contrôle à distance Visual Studio doivent être installés et exécutés sur le périphérique distant. Consultez Exécuter des applications du Windows Store sur un ordinateur distant à partir de Visual Studio.

Si vous choisissez Ordinateur distant, spécifiez le nom ou l'adresse IP de l'ordinateur distant de l'une des manières suivantes :

• Entrez le nom ou l'adresse IP de l'ordinateur distant.

  • Pour les applications C# et Visual Basic, entrez le nom ou l'adresse IP dans la zone Ordinateur distant.

  • Pour les applications C++, entrez le nom ou l'adresse IP dans la zone Nom de l'ordinateur.

• Choisissez l'ordinateur distant dans la boîte de dialogue Sélectionner une connexion du débogueur distant.

  Pour ouvrir la boîte de dialogue :

  • Pour les applications C# et Visual Basic, choisissez Rechercher.

  • Pour les applications C++, choisissez la flèche bas dans la zone Nom de l'ordinateur et choisissez <Rechercher...>.

  

  Notes

  La boîte de dialogue Sélectionner une connexion du débogueur distant affiche les ordinateurs situés sur le sous-réseau et les ordinateurs locaux qui sont directement connectés à l'ordinateur Visual Studio via un câble Ethernet.Pour spécifier un autre ordinateur, entrez le nom dans la zone Nom de l'ordinateur.

Vous pouvez déployer et déboguer une application Windows Phone Store sur un appareil ou sur l'un des émulateurs Windows Phone de Visual Studio. Sélectionnez l'appareil ou l'émulateur dans la liste Appareil cible.

Choisir le débogueur à utiliser

Par défaut, Visual Studio débogue le code managé dans des applications C# et Visual Basic.

Pour les applications C# et Visual Basic, vous pouvez choisir de déboguer le code managé et natif C/C++ dans votre application. Activez la case à cocher Activer le débogage de code non managé pour inclure le code natif dans votre session de débogage.

Par défaut, Visual Studio débogue le code natif dans votre application C++.

Pour les applications C++, vous pouvez choisir de déboguer des types de code spécifiques qui se trouvent dans les composants de votre application, à la place ou en plus du code natif. Spécifiez le code à déboguer dans la liste Type de débogueur de la page des propriétés de débogage du projet d'application.

Choisissez l'un de ces débogueurs dans la liste Processus d'application :

Script uniquement	Déboguez le code JavaScript dans votre application. Le code managé et le code natif sont ignorés.
Natif uniquement	Déboguez le code natif C/C++ dans votre application. Le code managé et le code JavaScript sont ignorés.
Managé uniquement	Déboguez le code managé dans votre application. Le code JavaScript et le code natif C/C++ sont ignorés.
Mixte (natif et managé)	Déboguez le code natif et managé C/C++ dans votre application. Le code JavaScript est ignoré.
GPU uniquement	Déboguez le code C++ natif qui s'exécute sur une unité de traitement graphique (GPU).

Pour les applications Windows Phone Store, vous pouvez aussi choisir d'utiliser le débogueur pour les processus en arrière-plan à partir de Processus de tâche en arrière-plan.

Différer le démarrage de la session de débogage (facultatif)

Par défaut, Visual Studio démarre immédiatement l'application lorsque vous démarrez le débogage. Vous pouvez également démarrer une session de débogage et retarder le démarrage de votre application. Lorsque vous choisissez cette option, l'application est lancée dans le débogueur lorsqu'elle est lancée depuis l'écran Démarrer ou par un contrat d'activation, ou lorsqu'elle est démarrée par un autre processus ou méthode. Vous pouvez également différer le démarrage de votre application lorsque vous souhaitez déboguer une tâche en arrière-plan alors que l'application proprement dite n'est pas en cours d'exécution.

Pour différer le lancement de votre application, vous pouvez :

• Pour les applications Visual C# et Visual Basic, sélectionnez Ne pas lancer, mais déboguer mon code au démarrage dans la page des propriétés Déboguer.

• Pour les applications Visual C++, choisissez Oui dans la liste Lancer l'application sur la page des propriétés Débogage.

Désactiver les bouclages de réseau (facultatif)

Pour des raisons de sécurité, une application Windows Store installée en mode standard n'est pas autorisée à effectuer des appels réseau vers le périphérique sur lequel elle est installée. Par défaut, le déploiement Visual Studio crée une exemption à cette règle pour l'application déployée. Cette exemption vous permet de tester les procédures de communication sur un seul ordinateur. Avant d'envoyer votre application au Windows Store, vous devez la tester sans l'exemption.

Pour supprimer l'exemption du bouclage de réseau :

• Pour les applications Visual C# et Visual Basic, désactivez la case à cocher Autoriser le bouclage de réseau local sur la page des propriétés Déboguer.

• Pour les applications Visual C++, choisissez Non dans la liste Autoriser le bouclage de réseau local sur la page des propriétés Débogage.

Réinstaller l'application au démarrage du débogage (facultatif)

Pour diagnostiquer les problèmes liés à l'installation et à la configuration initiale de votre application Visual C# ou Visual Basic, choisissez Désinstaller et réinstaller mon package sur la page des propriétés Déboguer pour recréer une installation d'origine lorsque vous démarrez le débogage. Cette option n'est pas disponible pour les projets Visual C++.

(Facultatif) Désactivez la condition d'authentification pour démarrer le débogueur distant

Par défaut, vous devez fournir des informations d'identification pour exécuter le débogueur distant.

Note de sécurité
Vous pouvez choisir de l'exécuter en mode Aucune authentification, mais ce mode est fortement déconseillé.Il n'existe aucune sécurité du réseau lorsque vous lancez l'exécution dans ce mode.Sélectionnez le mode Aucune authentification uniquement si vous êtes sûr que le réseau n'est pas exposé à un problème de sécurité lié à des programmes malicieux ou dangereux.

Pour annuler la condition d'authentification :

1. Pour les applications Visual C# et Visual Basic, désactivez la case à cocher Utiliser l'authentification sur la page de propriétés Déboguer.

2. Pour les applications Visual C++, choisissez Non dans la liste Exiger une authentification sur la page de propriétés Débogage.

Démarrer la session de débogage

Démarrer le débogage (F5)

Quand vous choisissez Démarrer le débogage (Clavier : F5) dans le menu Déboguer, Visual Studio lance l'application avec le débogueur attaché. L'exécution se poursuit jusqu'à ce qu'un point d'arrêt soit atteint, que vous suspendiez manuellement l'exécution, qu'une exception se produise ou que l'application se termine.

Démarrer le débogage (F5), mais différer le démarrage de l'application

Vous pouvez configurer l'application pour s'exécuter en mode débogage, mais la démarrer par une autre méthode que le débogueur. Vous pouvez par exemple déboguer le lancement de votre application depuis le menu Démarrer ou déboguer un processus en arrière-plan dans l'application sans la démarrer. Procédez comme suit pour retarder le démarrage de l'application :

• Dans la page des propriétés Débogage de l'application (Déboguer dans Visual C++)

  • Pour les applications Visual C# et Visual Basic, choisissez Ne pas lancer, mais déboguer mon code au démarrage.

  • Pour les applications Visual C++, choisissez Oui dans la liste Lancer l'application.

• Choisissez Démarrer le débogage dans le menu Déboguer (clavier : F5).

• Démarrez votre application dans le menu Démarrer, avec un contrat de exécution ou en suivant une autre procédure.

L'application démarre en mode débogage. L'exécution se poursuit jusqu'à ce qu'un point d'arrêt soit atteint, que vous suspendiez manuellement l'exécution, qu'une exception non gérée se produise ou que l'application se termine.

. Pour plus d'informations sur le débogage de tâches en arrière-plan, consultez Comment déclencher des événements de suspension, de reprise et d'arrière-plan pour les applications Windows Store dans Visual Studio.

Démarrer une application installée dans le débogueur

Lorsque vous lancez le débogage en appuyant sur la touche F5, Visual Studio génère et déploie l'application, la configure pour s'exécuter en mode débogage, puis la démarre. Pour démarrer une application déjà installée sur un périphérique, utilisez la boîte de dialogue Déboguer le package d'application déjà installé. Cette procédure est utile lorsque vous devez déboguer une application installée depuis Windows Store, ou lorsque vous disposez des fichiers source de l'application, mais pas de projet Visual Studio pour cette dernière. Par exemple, vous pouvez avoir un système de génération personnalisée qui n'utilise pas les projets ou les solutions Visual Studio.

Vous pouvez installer l'application sur le périphérique local ou sur un périphérique distant. Vous pouvez démarrer l'application immédiatement, ou bien la configurer pour s'exécuter dans le débogueur au démarrage de ce dernier par un autre processus ou une autre méthode, depuis le menu Démarrer ou par un contrat d'activation, par exemple. Vous pouvez également configurer l'application pour s'exécuter en mode débogage lorsque vous souhaitez déboguer un processus en arrière-plan sans démarrer l'application. Pour plus d'informations, consultez Comment déclencher des événements de suspension, de reprise et d'arrière-plan pour les applications Windows Store dans Visual Studio.

Procédez comme suit pour configurer une application installée pour s'exécuter en mode débogage :

Notes

L'application ne doit pas être en cours d'exécution lorsque vous lancez cette procédure.

1. Dans le menu Débogage, choisissez Déboguer le package d'application installé

2. Choisissez l'une des options suivantes dans la liste :

   Ordinateur local	Déboguez l'application dans la session active sur votre ordinateur local. Consultez Exécuter des applications du Windows Store sur un ordinateur local.
   Simulateur	Déboguez l'application dans le simulateur Visual Studio pour les applications Windows Store. Le simulateur est une fenêtre du Bureau qui permet de déboguer les fonctionnalités du périphérique, comme les mouvements tactiles et la rotation du périphérique, qui ne sont pas disponibles sur l'ordinateur local. Consultez Exécuter des applications du Windows Store dans le simulateur.
   Ordinateur distant	Déboguez l'application sur un périphérique qui est connecté à l'ordinateur local sur un intranet ou directement connecté via un câble Ethernet. Pour déboguer à distance, les outils de contrôle à distance Visual Studio doivent être installés et en cours d'exécution sur le périphérique distant. Consultez Exécuter des applications du Windows Store sur un ordinateur distant à partir de Visual Studio.

3. Choisissez l'application dans la liste Packages d'application installés.

4. Choisissez le moteur de débogage à utiliser dans la liste Déboguer ce type de code.

5. (Facultatif). Choisissez Ne pas lancer, mais déboguer mon code au démarrage pour déboguer l'application lorsqu'elle est lancée à l'aide d'une autre méthode ou pour déboguer un processus en arrière-plan.

Lorsque vous cliquez sur Démarrer, l'application démarre ou est configurée pour s'exécuter en mode débogage.

Attacher le débogueur à une application en cours de exécution

Pour attacher le débogueur à une application Windows Store, vous devez utiliser Debuggable Package Manager pour configurer l'application à exécuter en mode débogage. Debuggable Package Manager est installé avec les outils de contrôle à distance Visual Studio.

Attacher le débogueur à une application est utile lorsque vous devez déboguer une application déjà installée, telle qu'une application qui a été installée à partir de Windows Store. L'attachement est requis lorsque vous possédez les fichiers sources de l'application, mais que vous n'avez pas de projet Visual Studio pour l'application. Par exemple, vous pouvez avoir un système de génération personnalisée qui n'utilise pas les projets ou les solutions Visual Studio.

Attacher le débogueur à une application nécessite les étapes suivantes :

1. Configurez l'application pour l'exécuter en mode débogage. Cela doit s'effectuer lorsque l'application n'est pas en cours d'exécution.

2. Démarrez l'application. Vous pouvez démarrer l'application à partir de l'écran Démarre, avec un contrat d'exécution ou tout autre méthode.

3. Attacher le débogueur à l'application en cours d'exécution.

Configurer l'application pour l'exécuter en mode débogage

1. Installez les outils de contrôle à distance Visual Studio sur le périphérique où l'application est installée. Voir Installation des outils de contrôle à distance.

2. Sur l'écran Démarrer, recherchez Debuggable Package Manager, puis démarrez-le.

   Une fenêtre PowerShell correctement configurée pour l'applet de commande AppxDebug s'affiche.

3. Pour activer le débogage d'une application, vous devez spécifier l'identificateur PackageFullName de l'application. Pour afficher une liste de toutes les applications qui incluent PackageFullName, entrez Get-AppxPackage à l'invite de PowerShell.

4. À l'invite PowerShell, entrez Enable-AppxDebug PackageFullName, où PackageFullName est l'identificateur PackageFullName de l'application.

Attacher le débogueur

Pour attacher le débogueur :

1. Dans le menu Débogage, sélectionnez Attacher au processus.

   La boîte de dialogue Attacher au processus s'affiche.

2. Pour attacher une application sur un périphérique distant, spécifiez le périphérique distant dans la zone Qualificateur. Vous pouvez effectuer les tâches suivantes :

   • Entrez le nom dans la zone Qualificateur.

   • Cliquez sur la flèche Bas dans la zone Qualificateur, puis choisissez le périphérique dans une liste que vous avez associée précédemment.

   • Choisissez Rechercher pour sélectionner le périphérique dans une liste de périphériques sur votre sous-réseau local.

3. Spécifiez le type de code à déboguer dans la zone Attacher à.

   Choisissez Sélectionner, puis effectuez l'une des opérations suivantes :

   • Choisissez Déterminer automatiquement le type de code à déboguer

   • Choisissez Déboguer ces types de codes, puis sélectionnez un ou plusieurs types dans la liste.

4. Dans la liste Processus disponibles , sélectionnez le processus de l'application.

5. Choisissez Attacher.

Visual Studio attache le débogueur au processus. L'exécution se poursuit jusqu'à ce qu'un point d'arrêt soit atteint, que vous suspendiez manuellement l'exécution, qu'une exception non gérée se produise ou que l'application se termine.

Voir aussi

Concepts

Déboguer des applications du Windows Store dans Visual Studio

Parcourir une session de débogage dans Visual Studio (XAML et C#)