Choisissez Déboguer > Déboguer
(Versions CS6 et antérieures) Sélectionnez Déboguer > Déboguer l’animation > Déboguer.
Animate comprend un débogueur dédié à ActionScript 3.0 dont le fonctionnement diffère légèrement de celui d’ActionScript 2.0. Le débogueur d’ActionScript 3.0 ne fonctionne qu’avec les fichiers ActionScript 3.0 FLA et AS. Les paramètres de publication des fichiers FLA doivent être définis sur Flash Player 9. Lorsque vous démarrez une session de débogage ActionScript 3.0, Animate lance la version de débogage autonome de Flash Player pour lire le fichier SWF. Le débogueur de Flash Player lit le fichier SWF dans une autre fenêtre que celle de l’application de création Animate.
Le débogueur ActionScript 3.0 convertit l’espace de travail Animate en un espace de travail de débogage qui affiche les panneaux utilisés pour le débogage. Il comprend également le panneau Actions et/ou la fenêtre Script, la console de débogage et le panneau Variables. La Console de débogage affiche la pile d’appel et contient des outils permettant de parcourir les scripts pas à pas. Le panneau Variables affiche les variables de la zone active et leurs valeurs, et vous permet d’actualiser ces dernières.
Ressources supplémentaires
Les ressources suivantes fournissent d’autres informations détaillées sur le débogage d’ActionScript 3.0 :
La façon dont vous commencez une session de débogage dépend du type de fichier sur lequel vous travaillez. Pendant une session de débogage, Animate interrompt l’exécution d’ActionScript dès qu’il rencontre un point d’arrêt ou une erreur d’exécution.
Lorsque Animate démarre une session de débogage, il ajoute des informations spéciales au fichier SWF exporté pour la session. Ces informations permettent au débogueur d’indiquer les numéros des lignes contenant les erreurs rencontrées.
Vous pouvez inclure ces informations de débogage spéciales dans tous les fichiers SWF créés depuis un certain fichier FLA dans les paramètres de publication. Cela vous permet de déboguer le fichier SWF sans déclencher explicitement une session de débogage. Ces informations de débogage accroissent légèrement la taille du fichier SWF.
Choix d'un environnement de débogage par défaut
Choisissez Déboguer > Déboguer l’animation, puis sélectionnez l’une des options suivantes :
Animate
dans l'application de débogage du lanceur AIR (bureau)
dans l'application de débogage du lanceur AIR (mobile)
sur le périphérique via USB (CS5.5 uniquement)
Toutes les sessions de débogage ont lieu dans l'environnement de votre choix. Vous pouvez à tout moment modifier l'environnement par défaut.
Démarrage du débogage depuis un fichier FLA
Choisissez Déboguer > Déboguer
(Versions CS6 et antérieures) Sélectionnez Déboguer > Déboguer l’animation > Déboguer.
Démarrage du débogage depuis un fichier ActionScript 3.0 AS
Le fichier ActionScript étant ouvert dans la fenêtre Script, vous pouvez sélectionner, depuis le menu Cible dans la partie supérieure de la fenêtre Script, le fichier FLA avec lequel le fichier ActionScript devrait être compilé. Le fichier FLA doit aussi être ouvert pour apparaître dans ce menu.
Choisissez Déboguer > Déboguer
(Versions CS6 et antérieures) Sélectionnez Déboguer > Déboguer l’animation > Déboguer.
Ajout d’informations de débogage à tous les fichiers SWF créés à partir d’un fichier FLA
Le fichier FLA étant ouvert, sélectionnez Fichier > Paramètres de publication.
Dans la boîte de dialogue Paramètres de publication, cliquez sur l'onglet (CS5) ou sur la catégorie (CS5.5).
Sélectionnez Autoriser le débogage.
Quitter le mode débogage
Cliquez sur le bouton Terminer la session de débogage dans la console de débogage.
Ajoutez des points d’arrêt dans votre code ActionScript pour interrompre son exécution à différents endroits stratégiques. Lorsque l’exécution s’interrompt, vous pouvez alors exécuter le code ligne par ligne, afficher ses différentes sections ActionScript, afficher les valeurs des variables et des expressions et modifier celles des variables.
Les points d’arrêt ne peuvent pas être ajoutés à des fichiers ASC (ActionScript for Communication) ou JSFL (JavaScript Flash).
Définition d’un point d’arrêt
Dans le panneau Actions ou la fenêtre Script, cliquez sur la marge gauche en regard de la ligne de code où vous voulez faire apparaître un point d’arrêt.
Suppression d’un point d’arrêt
Dans le panneau Actions ou la fenêtre Script, cliquez sur le point d’arrêt à supprimer.
Après l’interruption de l’exécution d’ActionScript à un point d’arrêt ou une erreur d’exécution, vous pouvez examiner le code ligne par ligne. Vous pouvez choisir de parcourir les appels de fonction ou de les ignorer. Vous pouvez également choisir de poursuivre l’exécution du code sans cet examen pas à pas.
Parcourir le code ligne par ligne
Cliquez sur le bouton Pas à pas détaillé dans la console de débogage.
Ignorer un appel de fonction
Cliquez sur le bouton Pas à pas principal dans la console de débogage.
Sortir d’un appel de fonction
Cliquez sur le bouton Sortir du pas à pas dans la console de débogage.
Reprendre l’exécution normale du code
Cliquez sur le bouton Continuer dans la console de débogage.
Lorsque l’exécution du code s’interrompt dans le débogueur, vous pouvez afficher la pile d’appels dans la Console de débogage et examiner les scripts contenant les fonctions présentes dans la pile. La pile d’appels présente la liste actuelle des appels de fonction imbriqués qui sont en attente de fin d’exécution.
Vous pouvez afficher individuellement les scripts contenant chaque fonction.
Affichez et modifiez les valeurs des variables et des propriétés dans le panneau Variables.
Affichage de la valeur d’une variable
Dans le panneau Variables, sélectionnez dans le menu Panneau les types de variables à afficher.
L’option Afficher les constantes affiche les valeurs constantes (variables à valeur fixe).
L’option Afficher les valeurs statiques affiche les variables qui appartiennent à la classe plutôt qu’aux occurrences de la classe.
L’option Afficher les variables de membre inaccessibles affiche les variables qui ne sont pas accessibles aux autres classes ou espaces de noms. Ceci inclut les variables protégées, privées ou internes à l’espace de noms.
L’option Activer l’affichage hexadécimal supplémentaire ajoute des valeurs hexadécimales là où des valeurs décimales sont affichées. Ceci est surtout utile pour des valeurs de couleur. Les valeurs hexadécimales ne sont pas affichées dans le cas de valeurs décimales de 0 à 9.
L’option Afficher les noms qualifiés affiche des types de variables avec à la fois leur nom de package et leur nom de classe.
Développez l’affichage de l’arborescence de la structure objet du fichier FLA jusqu’à ce que vous aperceviez la variable.
Modification de la valeur d’une variable
Dans le panneau Variables, double-cliquez sur la valeur de la variable.
Saisissez la nouvelle valeur pour la variable et appuyez sur la touche Entrée. La nouvelle valeur est utilisée durant l’exécution du code par la suite.
Contrôlez les types d’avertissements générés par le compilateur d’ActionScript dans le panneau Erreurs de compilation. Lorsque le compilateur signale une erreur, double-cliquez sur son entrée pour atteindre la ligne de code qui provoque l’erreur.
Cliquez sur Animate.
Lorsque Animate rencontre une erreur dans le code ActionScript, pendant la compilation ou l’exécution, il la signale dans le panneau Erreurs de compilation. Localisez la ligne de code qui provoque l’erreur dans le panneau Erreurs de compilation.
Avec ActionScript 3.0, vous pouvez déboguer un fichier SWF distant à l’aide de la version autonome, ActiveX ou module externe de Debug Flash Player que vous trouverez dans le répertoire d’installation d’Animate/Players/Debug/. Cependant, dans le débogueur d’ActionScript 3.0, le débogage à distance est limité aux fichiers qui se trouvent sur le même hôte local que l’application de création Animate et lus sur le lecteur de débogage autonome, le contrôle ActiveX ou le module externe.
Pour permettre le débogage à distance du fichier, activez le débogage dans les paramètres Publication. Vous pouvez également publier votre fichier avec un mot de passe de débogage pour vous assurer que seuls les utilisateurs autorisés pourront le déboguer.
Comme dans JavaScript ou HTML, vous pouvez afficher les variables côté client dans ActionScript. Pour stocker les variables de façon sécurisée, envoyez-les à une application côté serveur au lieu de les stocker dans votre fichier. Cependant, en tant que développeur, vous ne voudrez peut-être pas révéler vos secrets de fabrication, tels que vos structures de clips. Vous pouvez donc utiliser un mot de passe de débogage pour protéger votre travail.
Activation du débogage distant d’un fichier SWF et définition d’un mot de passe de débogage
Dans les fichiers FLA d’ActionScript 3.0, le code de scripts d’images ne peut pas être débogué. Seul le code des fichiers AS externes peut être débogué avec le Débogueur d’ActionScript 3.0.
Ouvrez le fichier FLA.
Choisissez Fichier > Paramètres de publication.
Dans la boîte de dialogue Paramètres de publication, cliquez sur l'onglet (CS5) ou sur la catégorie (CS5.5), puis sélectionnez Autoriser le débogage.
Fermez la boîte de dialogue Paramètres de publication, puis choisissez l’une des commandes suivantes :
Fichier > Exporter > Exporter l’animation
Fichier > Publier
Vous pouvez laisser le fichier SWF sur la machine locale pour exécuter une session de débogage à distance sur l’hôte local ou le télécharger vers votre serveur Web.
Le fichier SWF ne contient pas d’informations sur les points d’arrêt ; par conséquent, si vous téléchargez le fichier vers un serveur distant, vous ne pourrez pas faire défiler le code pas à pas. Utiliser l’hôte local pour exécuter cette tâche.
Dans Animate, sélectionnez Déboguer > Commencer la session de débogage à distance > ActionScript 3.0.
Animate ouvre le panneau Débogueur d’ActionScript 3.0 et attend que le lecteur de débogage de Flash Player se connecte. Vous avez deux minutes pour démarrer le lecteur de débogage. Si plus de deux minutes s’écoulent, répétez cette opération.
Ouvrez le fichier SWF dans la version de débogage du module externe, contrôle ActiveX ou lecteur autonome de Flash Player. Le lecteur autonome de débogage se trouve dans le répertoire répertoire d’installation d’Animate/Players/Debug/. Veillez à ne pas vous connecter à un fichier sur une autre machine car le débogueur ne sera pas en mesure de recevoir des informations sur les points d’arrêt.
La session de débogage démarre lorsque le lecteur de débogage se connecte au panneau Débogueur ActionScript 3.0 de
Le débogage à distance ne fonctionne pas si vous sélectionnez l’interface réseau par défaut pour AIR 3.4. Sélectionnez plutôt les options permettant de définir le nom de l’interface réseau et l’adresse IP du système.
Activation du débogueur à distance
Le cas échéant, ouvrez l’application de création Animate.
Dans Flash, sélectionnez Déboguer > Commencer la session de débogage à distance > ActionScript 3.0.
Dans un navigateur ou dans le débogueur du lecteur autonome, ouvrez le fichier SWF publié à partir de son emplacement distant.
Si la boîte de dialogue du débogage à distance ne s’ouvre pas, cliquez avec le bouton droit de la souris sur le fichier SWF (Windows) ou en appuyant sur la touche Ctrl (Macintosh) pour afficher un menu contextuel, et choisissez Débogueur.
Dans la boîte de dialogue Débogage à distance, sélectionnez Hôte local et choisissez le fichier à ouvrir.
La liste hiérarchique du fichier SWF apparaît dans le débogueur. Lorsque le fichier SWF n’est pas lu, le débogueur peut être en pause. Cliquez sur Continuer pour le redémarrer.