Tr.ace () 2.0 un excellent utilitaire de débogage AS3

L’année dernière, nous avons publié Tr.ace (), un outil de débogage open source pour Flash qui développait le logiciel intégré. trace() une fonction. Maintenant, Tr.ace () v2.0 introduit plusieurs nouvelles fonctionnalités, y compris la très demandée "console de champs de texte" pour vous aider à réduire ces bugs une fois pour toutes.!


Nouveau sur Tr.ace ()?

Tr.ace () a été publié il y a presque un an sous le nom de Freebie exclusif sur Activetuts +. Il s'agit d'un utilitaire de débogage open source pour Flash qui vous permettait de limiter les traces affichées dans votre application à des utilisateurs ou à des classes particuliers, voire aux deux. Vous pouvez également ajouter des sauts de ligne, des horodatages ainsi que des tableaux et des objets imbriqués parfaitement avec une seule ligne de code.!

Jetons un coup d'œil à ce qui a changé depuis la première publication de Tr.ace ()…


À la demande populaire: console Tr.ace ()

La bibliothèque Tr.ace () comporte maintenant une classe nommée TrConsole qui vous fournit une console de base au sein de votre fichier SWF grâce à laquelle vous pouvez afficher toutes vos traces Tr.ace ()! Découvrez la démo ci-dessous pour la voir en action:

Vous pouvez vider la console, copier le résultat dans le presse-papiers et l’enregistrer dans un fichier texte. Vous pouvez également réduire la console pour réduire l’espace occupé à l’écran et la déplacer sur l’écran en la faisant simplement glisser. C'est aussi entièrement redimensionnable!

Pour tirer parti de cette fonctionnalité, vous n'avez besoin que de deux lignes de code:

 // crée l'instance de TrConsole et l'ajoute à la console d'étape var: TRConsole = new TrConsole (); addChild (console);

Et c'est tout - facile!

Il existe également quelques options supplémentaires pour personnaliser les couleurs de la console et indiquer si le défilement automatique est activé ou non. Consultez la documentation et des exemples de fichiers pour plus d'informations..


Nom d'utilisateur et paramètres de classe facultatifs

Lorsque Tr.ace () a été initialement publié, les paramètres de nom d'utilisateur et de classe étaient obligatoires pour tous les appels de trace, que vous souhaitiez les utiliser ou non. Vous serez heureux de savoir qu'ils sont maintenant facultatifs!

Cela réduit certaines fonctionnalités de la bibliothèque, mais si vous souhaitez simplement afficher vos traces via la console, vous pouvez le faire, sans le fardeau du reste de la bibliothèque..

Avec paramètres:

 Tr.ace ("avec paramètres", TrUsers.MSFX, ClassName);

Sans paramètres:

 Tr.ace ("sans paramètres!");

Espérons que cela rendra la bibliothèque plus accessible et moins "verbeuse" pour les traceurs partout.


Effacer, copier et sauvegarder vos traces

Via la console présentée ci-dessus, vous pouvez effacer, copier dans le presse-papier et enregistrer le journal de trace actuel..

Pour ceux qui n'utilisent pas la console, vous pouvez également les réaliser via des appels au Tr classe comme indiqué ci-dessous:

 // pour effacer le journal de trace Tr.clearLog (); // copier dans le presse-papiers Tr.copyLogToClipboard (); // pour enregistrer le journal en tant que fichier texte avec horodatage Tr.saveLog ();

La fonctionnalité du presse-papiers doit être déclenchée via une interaction utilisateur, comme détaillé ici..


Téléchargement de Tr.ace ()

Tr.ace () est une bibliothèque open source qui peut être téléchargée ici à Activetuts + au format ZIP. Elle est également disponible en tant que référentiel public sur mon GitHub, pour ceux qui sont un peu plus ringards ou qui souhaitent bifurquer et / ou contribuer au Bibliothèque Tr.ace ().

La bibliothèque est uniquement AS3 et possède deux référentiels distincts développés pour Flash Player 9 et Flash Player 10.+

Pour utiliser la bibliothèque Tr.ace (), vous devez télécharger l'un des packages source ci-dessus, puis copier et coller le répertoire "uk", situé dans le répertoire "src", dans votre répertoire de chemin de classe global. Vous êtes alors prêt à partir!


Documentation pour Tr.ace ()

Dans le package de téléchargement, vous trouverez un répertoire 'docs'; ouvrir le index.html fichier pour afficher la documentation générée par ASDocs pour Tr.ace (). Vous pouvez également trouver la documentation en ligne: http://docs.msfx.co.uk/as3/trace/.


Traçage heureux!

Donc, c'est vraiment ça. Si vous avez des questions ou des suggestions pour la bibliothèque, n'hésitez pas à les contacter..

Traçage heureux!