Comment démarrer une session de débogage (JavaScript)
Cette rubrique décrit comment démarrer une session de débogage pour les applications Windows Store écrites en code JavaScript et HTML5. Vous pouvez démarrer le débogage à l'aide d'une séquence de touches unique, ou vous pouvez configurer la session de débogage pour des scénarios spécifiques et choisir le mode de démarrage de l'application.
Dans cette rubrique
In this topic
The easy way to start debugging
Configure the debugging session
Open the debugging property page for the project
Choose the build configuration options
Choose the deployment target
Choose the debugger to use
(Optional) Delay starting the app in the debug session
(Optional) Disable network loopbacks
Start the debugging session
Start debugging (F5)
Start debugging (F5) but delay the app start
Start an installed app in the debugger
Attach the debugger to a running app
Set the app to run in debug mode
Attach the debugger
La méthode simple pour démarrer le débogage
Ouvrez la solution d'application dans Visual Studio.
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ébogage d'applications (JavaScript).
Configurer la session de débogage
Le script n'étant pas compilé, les paramètres de plateforme et de configuration de build ne s'appliquent pas. Si vous déboguez un composant C++ ou managé, affectez à Configuration la valeur Déboguer et choisissez votre plateforme cible dans la boîte de dialogue Configuration.
.gif "Hh771032.collapse_all(fr-fr,VS.110).gif")
Ouvrir la page des propriétés de débogage du projet
Dans l'Explorateur de solutions, sélectionnez le projet. Dans le menu contextuel, choisissez Propriétés.
Développez le nœud Propriétés de configuration, puis choisissez Débogage.
Choisir les options de configuration de build
Dans la liste Configuration, choisissez Déboguer ou (Debug) active.
Dans la liste Plateforme, sélectionnez la plateforme cible à générer. Dans la plupart des cas, Any CPU est le meilleur choix.
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 de l'ordinateur local ou sur un ordinateur distant. Choisissez la cible dans la liste Débogueur à lancer de la page des propriétés de débogage du projet.
Choisissez l'une des options suivantes dans la liste Débogueur à lancer :
Ordinateur local |
Déboguez l'application dans la session active sur votre ordinateur local. Consultez Exécuter les applications du Windows Store sur l'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écution 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écution d'applications du Windows Store sur un ordinateur distant. |
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.
Cliquez sur la flèche Bas dans la zone Nom de l'ordinateur et choisissez <Rechercher...>. Choisissez ensuite l'ordinateur distant dans la boîte de dialogue Connexions au débogueur distant.
.png "Sélectionner la connexion au Remote Debugger")
Notes
La boîte de dialogue Connexions au débogueur distant affiche les ordinateurs situés sur le sous-réseau local et les ordinateurs 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.
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 C++ et managé natif des composants de votre application au lieu 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 :
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é. |
(Facultatif) Différer 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 démarrée dans le débogueur lorsqu'elle est lancée à partir du menu Démarrer ou par un contrat d'activation, ou lorsqu'elle est démarrée par un autre processus ou une autre méthode. Vous pouvez également utiliser le démarrage différé pour déboguer des événements d'arrière-plan que vous souhaitez déclencher lorsque l'application n'est pas en cours d'exécution.
Spécifiez si vous souhaitez différer le lancement de votre application dans la liste Lancer l'application de la page des propriétés de débogage du projet d'application. Choisissez l'une des options suivantes :
Choisissez Non pour différer le lancement de votre application.
Choisissez Oui pour lancer immédiatement l'application.
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, choisissez Non dans la liste Autoriser le bouclage de réseau local sur la page des 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 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 Déboguer des propriétés du projet d'application, choisissez Non 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 d'interruption, de reprise et d'arrière-plan dans les applications du Windows Store..
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 d'interruption, de reprise et d'arrière-plan dans les applications du Windows Store..
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.
Dans le menu Débogage, choisissez Déboguer le package d'application installé
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 les applications du Windows Store sur l'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écution 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écution d'applications du Windows Store sur un ordinateur distant.
Choisissez l'application dans la liste Packages d'application installés.
Choisissez le moteur de débogage à utiliser dans la liste Déboguer ce type de code.
(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 le débogueur à une application :
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.
Démarrez l'application. Vous pouvez démarrer l'application à partir du menu Démarrer, avec un contrat d'exécution ou toute autre méthode.
Attacher le débogueur à l'application en cours d'exécution.
Configurer l'application pour l'exécuter en mode débogage
Installez les outils de contrôle à distance Visual Studio sur le périphérique où l'application est installée. Consultez Installing the Remote Debugger.
Dans le menu Démarrer, recherchez Debuggable Package Manager, puis démarrez-le.
Une fenêtre PowerShell correctement configurée pour le cmdlet AppxDebug s'affiche.
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.
À l'invite de PowerShell, entrez Enable-AppxDebug PackageFullName où PackageFullName est l'identificateur PackageFullName de l'application.
Attacher le débogueur
Conseil
Les applications JavaScript s'exécutent dans une instance du processus wwahost.exe. Si d'autres applications JavaScript sont en cours d'exécution lorsque vous attachez le débogueur à l'application, vous devrez connaître l'ID de processus numérique (PID) du wwahost.exe dans lequel l'application s'exécute.
La façon la plus facile de gérer cette situation est de fermer toutes les autres applications JavaScript. Sinon, vous pouvez ouvrir le Gestionnaire des tâches de Windows avant de démarrer l'application et noter les ID des processus wwahost.exe. Lorsque vous spécifiez le processus d'attachement dans la boîte de dialogue Processus disponibles, le wwahost.exe de l'application a un ID différent de ceux que vous avez notés.
Pour attacher le débogueur :
Dans le menu Débogage, sélectionnez Attacher au processus.
La boîte de dialogue Attacher au processus s'affiche.
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 attaché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.
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.
Dans la liste Processus disponibles , choisissez le processus wwahost.exe approprié. Utilisez la colonne Titre pour identifier votre application.
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émarrage rapide : navigation dans le débogueur (JavaScript)