Sur cette page
- Présentation du débogueur d’ActionScript 3.0
- Passage en mode débogage
- Définition et suppression des points d’arrêt
- Examen du code ligne par ligne
- Affichage et examen des scripts de la pile d’appels
- Affichage et modification des valeurs des variables
- Contrôle des avertissements du compilateur
- Localisation des erreurs dans le code
- Débogage d’un fichier SWF ActionScript 3.0 distant
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.
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.
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.
Remarque :
les points d’arrêt ne peuvent pas être ajoutés à des fichiers ASC (ActionScript pour Communication) ou JSFL (JavaScript Flash).
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.
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.
-
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.
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.
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.
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.
-
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
Remarque :
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.
-
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.
Les publications Twitter™ et Facebook ne sont pas couvertes par les dispositions Creative Commons.