Démarrer une session de débogage dans Visual Studio (JavaScript) pour des applications du Windows Store

Cette rubrique explique comment démarrer une session de débogage pour les applications du Windows Store écrites en JavaScript et HTML5. Vous pouvez démarrer le débogage avec une seule séquence de touches ou configurer la session de débogage pour des scénarios spécifiques, puis choisir de quelle façon démarrer l'application.

Dans cette rubrique

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 l'application dans la session de débogage (facultatif)

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

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. Si la solution contient des projets pour les applications du Windows Store et du Windows Phone Store, assurez-vous que le projet à déboguer est le projet de démarrage. Dans l'Explorateur de solutions, sélectionnez le projet et choisissez Définir comme projet de démarrage dans le menu contextuel.

3. Appuyez sur 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 Démarrage rapide : déboguer du code HTML et CSS.

Configurer la session de débogage

Comme le script n'est pas compilé, les paramètres de plateforme et de configuration de build ne s'appliquent pas. Si vous déboguez un composant C++ ou un composant managé, définissez Configuration avec la valeur Déboguer et sélectionnez votre plateforme cible dans la boîte de dialogue Configuration.

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. Développez le nœud Propriétés de configuration, puis sélectionnez 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, le meilleur choix est Any CPU.

Sélectionner la cible de déploiement

Vous pouvez déployer et déboguer une application sur l'ordinateur Visual Studio, dans le simulateur Visual Studio sur l'ordinateur local ou sur un périphérique distant. Vous choisissez la cible dans la liste Débogueur à lancer de la page de propriétés Débogage du projet.

Pour une application du Windows Store, choisissez l'une des options suivantes dans la liste Périphérique cible :

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 dans la zone Nom de l'ordinateur.

• Choisissez la flèche Bas dans la zone Nom de l'ordinateur, puis sélectionnez <Rechercher...>. Choisissez ensuite l'ordinateur distant dans la boîte de dialogue Sélectionner une connexion du débogueur distant.

  

  Notes

  La boîte de dialogue Sélectionner une connexion du débogueur distant affiche les ordinateurs situés sur le sous-réseau local 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.

Pour une application du Windows Phone Store, sélectionnez Périphérique ou l'un des émulateurs de la liste Périphérique cible.

Choisir le débogueur à utiliser

Par défaut, le débogueur s'attache au code JavaScript de votre application. Vous pouvez choisir de déboguer le code natif C++ et le code managé des composants de votre application à la place du code JavaScript. 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 Type de débogueur :

(Facultatif) Retarder le démarrage de l'application dans la session de débogage

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. L'application est lancée dans le débogueur quand elle est elle-même lancée depuis le menu Démarrer ou par un contrat d'activation, ou qu'elle est démarrée au moyen d'une autre procédure ou méthode. Vous pouvez aussi utiliser le démarrage différé pour déboguer les événements en arrière-plan de votre application dont vous voulez qu'ils se produisent alors que l'application n'est pas en cours d'exécution.

Vous spécifiez si le lancement de votre application doit être différé dans la liste Lancer l'application de la page de propriétés Débogage du projet de l'application. Choisissez l'une des options suivantes :

• Choisissez Non pour différer le lancement de votre application.

• Choisissez Oui pour lancer l'application immédiatement.

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 de bouclage de réseau, choisissez Non dans la liste Autoriser le bouclage de réseau de la page de propriétés Débogage.

Démarrer la session de débogage

Démarrer le débogage (F5)

Lorsque vous choisissez Démarrer le débogage dans le menu Déboguer (clavier : F5), 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 non gérée 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 qu'elle s'exécute en mode débogage, mais puisse être démarrée 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 :

1. Dans la page Déboguer des propriétés de projet de l'application, choisissez Non dans la liste Lancer l'application.

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

3. 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 :

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 du 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.

Pour attacher à une application :

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 du menu Démarrer, d'un contrat d'exécution ou de toute 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 distants.

2. Sur le menu 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 de 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, choisissez le processus wwahost.exe approprié. Utilisez la colonne Titre pour identifier votre 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

Contrôler l'exécution d'une application du Windows Store dans une session de débogage Visual Studio pour des applications du Windows Store (JavaScript)

Démarrage rapide : déboguer du code HTML et CSS

Comment déclencher des événements de suspension, de reprise et d'arrière-plan pour les applications Windows Store dans Visual Studio

Déboguer des applications du Windows Store dans Visual Studio