Présentation du débogueur d’ActionScript 3.0

Ressources supplémentaires

Les ressources suivantes fournissent d’autres informations détaillées sur le débogage d’ActionScript 3.0 :

Passage en mode débogage

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 à partir d’un fichier FLA

  1. 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 à partir d’un fichier AS ActionScript 3.0

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

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

  1. Le fichier FLA étant ouvert, sélectionnez Fichier > Paramètres de publication.

  2. Dans la boîte de dialogue Paramètres de publication, cliquez sur l'onglet (CS5) ou sur la catégorie (CS5.5).

  3. Sélectionnez Autoriser le débogage.

Annulation du mode débogage

  1. Cliquez sur le bouton Terminer la session de débogage dans la console de débogage.

Définition et suppression des points d’arrêt

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

Définition d’un point d’arrêt

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

  1. Dans le panneau Actions ou la fenêtre Script, cliquez sur le point d’arrêt à supprimer.

Examen du code ligne par ligne

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

  1. Cliquez sur le bouton Pas à pas détaillé dans la console de débogage.

Ignorer un appel de fonction

  1. Cliquez sur le bouton Pas à pas principal dans la console de débogage.

Sortir d’un appel de fonction

  1. Cliquez sur le bouton Sortir du pas à pas dans la console de débogage.

Reprendre l’exécution normale du code

  1. Cliquez sur le bouton Continuer dans la console de débogage.

Affichage et examen des scripts de la pile d’appels

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.

  1. Dans le panneau Console de débogage, double-cliquez sur le nom du script dans la pile d’appels.

Affichage et modification des valeurs des variables

Affichez et modifiez les valeurs des variables et des propriétés dans le panneau Variables.

Affichage de la valeur d’une variable

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

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

  1. Dans le panneau Variables, double-cliquez sur la valeur de la variable.

  2. 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ôle des avertissements du compilateur

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.

  1. Choisissez Fichier > Paramètres de publication.
  2. Cliquez sur Animate.

  3. Cliquez sur le bouton Paramètres d’ActionScript.
  4. Choisissez parmi les options Erreurs :
    • Le Mode strict signale les avertissements comme des erreurs, ce qui signifie que la compilation échouera tant que ces erreurs persisteront.
    • Le Mode avertissements signale des avertissements supplémentaires qui aident à détecter les incompatibilités lors du passage d’ActionScript 2.0 à ActionScript 3.0.

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.

  1. Double-cliquez sur l’erreur dans le panneau Erreurs de compilation.

Débogage d’un fichier SWF ActionScript 3.0 distant

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.

  1. Ouvrez le fichier FLA.

  2. Choisissez Fichier > Paramètres de publication.

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

  4. Fermez la boîte de dialogue Paramètres de publication, puis choisissez l’une des commandes suivantes :

    • Fichier > Exporter > Exporter l’animation

    • Fichier > Publier

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

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

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

Activation du débogueur à distance

  1. Le cas échéant, ouvrez l’application de création Animate.

  2. Dans Flash, sélectionnez Déboguer > Commencer la session de débogage à distance > ActionScript 3.0.

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

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

Ce produit est distribué sous licence Creative Commons Attribution - Pas d’utilisation commerciale - Partage à l’identique 3.0 non transposé  Les publications Twitter™ et Facebook ne sont pas couvertes par les dispositions Creative Commons.

Mentions légales   |   Politique de confidentialité en ligne