Débogage du code ActionScript 3.0



    Présentation du débogueur d'ActionScript 3.0

    Flash 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 lancez une session de débogage ActionScript 3.0, Flash lit le fichier SWF dans sa version de débogage autonome. Le débogueur de Flash Player lit le fichier SWF dans une autre fenêtre que celle de l'application de programmation Flash.

    Le débogueur d'ActionScript 3.0 convertit l'espace de travail de Flash en un espace de débogage qui affiche les panneaux utilisés pour le débogage, y compris 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.

    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, Flash interrompt l'exécution d'ActionScript dès qu'il rencontre un point d'arrêt ou une erreur d'exécution.

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

    Démarrage du débogage depuis un fichier FLA

     Sélectionnez Déboguer > Déboguer l'animation.

    Démarrage du débogage depuis un fichier ActionScript 3.0 AS

    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 dans Flash pour apparaître dans ce menu.
    2. Sélectionnez Déboguer > Déboguer l'animation.

    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 Flash.
    3. Sélectionnez Autoriser le débogage.

    Sortie du mode débogage

     Cliquez sur le bouton Fin de la session de débogage dans la Console 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

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

    Examen du code ligne par ligne

    Lorsque l'exécution du code ActionScript s'interrompt au niveau d'un point d'arrêt ou d'une erreur d'exécution, vous pouvez examiner chaque ligne, en choisissant d'exécuter les appels de fonction ou de les ignorer. Vous pouvez également choisir de poursuivre l'exécution du code sans cet examen pas à pas.

    Parcours du code ligne par ligne

     Cliquez sur le bouton Démarrer le pas à pas détaillé dans la Console de débogage.

    Ignorance d'un appel de fonction

     Cliquez sur le bouton Passer outre dans la Console de débogage.

    Sortie d'un appel de fonction

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

    Reprise de l'exécution normale du code

     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.

     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.

      • Afficher les constantes affiche les valeurs constantes (variables à valeur fixe).

      • Afficher Statics présente les variables qui appartiennent à la classe plutôt qu'aux occurrences de la classe.

      • Afficher Variables membres inaccessibles affiche les variables qui ne sont pas accessibles aux autres classes ou namespaces. Ceci inclut les variables protégées, privées ou qui se trouvent au sein du namespace.

      • Afficher l'affichage de valeurs hexadécimales correspondantes 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.

      • Afficher 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 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 Flash.
    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.

    Localisation des erreurs dans le code

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

     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 Flash Player que vous trouverez dans le répertoire répertoire d'installation de Flash/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 localhost que l'application de programmation Flash 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 peuvent être débogués avec le Débogueur d'ActionScript 3.0.

    1. Ouvrez le fichier FLA.
    2. Choisissez Fichier > Paramètres de publication.
    3. Dans l'onglet Flash de la boîte de dialogue Paramètres de publication, activez l'option Débogage autorisé.
    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 le localhost 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 le localhost pour exécuter cette tâche.

    6. Dans Flash, sélectionnez Débogage > Démarrer la session de débogage à distance > ActionScript 3.0.

      Flash ouvre le panneau Débogueur d'ActionScript 3.0 et attend qu'une version « debug » de Flash Player se connecte. Vous avez deux minutes pour démarrer la version « debug » de Flash Player. 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 Flash/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 Flash.

    Activation du débogueur à distance

    1. Ouvrez l'application de programmation Flash s'il ne l'est pas déjà.
    2. Dans Flash, sélectionnez Débogage > Démarrer 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 distant ne s'ouvre pas, cliquez du bouton droit 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 Localhost 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.