Démarrer une session de débogage dans Visual Studio (JavaScript) pour des applications du Windows Store
.png "S'applique à Windows et Windows Phone")
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.
Notes
Pour les applications écrites en XAML et Visual C#, Visual C++ ou Visual Basic, voir Démarrer une session de débogage pour une application du Windows Store dans Visual Studio (VB, C#, C++ et XAML)
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
.png "S'applique uniquement à Windows")
Ouvrez la solution d'application dans Visual Studio.
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.
Appuyez sur F5.
.png "S'applique uniquement à Windows Phone")
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
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 sélectionnez 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, 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 :
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. |
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.
.png "Sélectionner la connexion au Remote Debugger")
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 :
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. |
Code natif avec script |
Déboguez le code natif C++ et le code JavaScript de votre application. |
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) 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 :
Dans la page Déboguer des propriétés de projet de l'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 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.
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 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.
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 à 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, d'un contrat d'exécution ou de 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. Voir Installation des outils distants.
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.
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 pendant l'attachement à l'application, vous devez connaître l'identifiant de processus (PID) numérique du processus wwahost.exe dans lequel l'application s'exécute.
La solution la plus simple pour gérer cette situation consiste à fermer toutes les autres applications JavaScript.Sinon, vous pouvez ouvrir le Gestionnaire de tâches Windows avant de démarrer l'application et de noter les identifiants des processus wwahost.exe.Lorsque vous spécifiez le processus à attacher à la boîte de dialogue Processus disponibles, le processus wwahost.exe de l'application aura un identifiant différent de ceux que vous avez déjà 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 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.
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 : déboguer du code HTML et CSS
Déboguer des applications du Windows Store dans Visual Studio