Tr.ace () 2.0 Ein hervorragendes AS3-Debugging-Dienstprogramm

Letztes Jahr haben wir Tr.ace () veröffentlicht, ein Open-Source-Debugging-Tool für Flash, das das integrierte erweitert hat Spur() Funktion. Mit Tr.ace () v2.0 werden nun einige neue Funktionen eingeführt, darunter die häufig angeforderte "Textfeld-Konsole", mit der Sie diese Fehler ein für allemal beseitigen können!


Neu bei Tr.ace ()?

Tr.ace () wurde vor fast einem Jahr als Exclusive Freebie für Activetuts + veröffentlicht und ist ein Open Source-Debugging-Hilfsprogramm für Flash, mit dem Sie die in Ihrer Anwendung gezeigten Spuren auf bestimmte Benutzer oder Klassen oder sogar beide beschränken können. Sie können auch Zeilenumbrüche, Zeitmarken und verschachtelte Arrays und Objekte mit einer Codezeile ordentlich verfolgen!

Schauen wir uns an, was sich seit der Veröffentlichung von Tr.ace () geändert hat…


Nach beliebter Nachfrage: Tr.ace () - Konsole

Die Tr.ace () - Bibliothek enthält jetzt eine Klasse mit dem Namen TrConsole Damit erhalten Sie eine grundlegende Konsole in Ihrer SWF-Datei, über die Sie alle Ihre Tr.ace () - Spuren anzeigen können. Schauen Sie sich die Demo unten an, um sie in Aktion zu sehen:

Sie können die Konsole löschen, die Ausgabe in die Zwischenablage kopieren und die Ausgabe in einer Textdatei speichern. Sie können die Konsole auch minimieren, um den auf dem Bildschirm belegten Platz zu reduzieren und durch einfaches Ziehen auf dem Bildschirm zu verschieben. Es ist auch vollständig in der Größe veränderbar!

Um diese Funktion zu nutzen, benötigen Sie nur zwei Codezeilen:

 // Erzeuge die TrConsole-Instanz und füge sie der stage var console hinzu: TRConsole = new TrConsole (); addChild (Konsole);

Und das ist es - ganz einfach!

Es gibt auch einige zusätzliche Optionen, mit denen Sie die Farben der Konsole anpassen und festlegen können, ob der automatische Bildlauf aktiviert ist oder nicht. In der Dokumentation und den Beispieldateien finden Sie weitere Informationen.


Optionale Benutzername und Klassenparameter

Bei der ersten Veröffentlichung von Tr.ace () waren die Parameter für Benutzername und Klasse für alle Trace-Aufrufe erforderlich, unabhängig davon, ob Sie sie verwenden wollten oder nicht. Sie werden froh sein, dass sie jetzt optional sind!

Dies reduziert zwar einige Funktionen der Bibliothek, aber wenn Sie Ihre Spuren nur über die Konsole anzeigen möchten, können Sie dies ohne den aufgeblähten Rest der Bibliothek.

Mit Parametern:

 Tr.ace ("mit Parametern", TrUsers.MSFX, ClassName);

Ohne Parameter:

 Tr.ace ("ohne Parameter!");

Dies macht die Bibliothek hoffentlich für alle Tracer zugänglicher und weniger "wortreich".


Löschen, kopieren und speichern Sie Ihre Spuren

Über die oben abgebildete Konsole können Sie das aktuelle Ablaufprotokoll löschen, in die Zwischenablage kopieren und speichern.

Für diejenigen, die die Konsole nicht verwenden, können Sie dies auch über Anrufe an die Tr Klasse wie unten gezeigt:

 // um das Trace-Protokoll zu löschen Tr.clearLog (); // um es in die Zwischenablage zu kopieren Tr.copyLogToClipboard (); // um das Protokoll als Textdatei mit Zeitstempel zu speichern Tr.saveLog ();

Die Clipboard-Funktionalität muss über eine Benutzerinteraktion ausgelöst werden, wie hier beschrieben.


Tr.ace herunterladen ()

Tr.ace () ist eine Open-Source-Bibliothek, die hier bei Activetuts + im ZIP-Format zum Download zur Verfügung steht, und ist auch als öffentliches Repository auf meinem GitHub verfügbar, für diejenigen, die etwas nerdiger sind oder die sich dazu interessieren und dazu beitragen wollen Tr.ace () -Bibliothek.

Die Bibliothek ist nur AS3 und verfügt über zwei separate Repositorys, die für Flash Player 9 und Flash Player 10 entwickelt wurden+

Um die Bibliothek Tr.ace () verwenden zu können, müssen Sie eines der oben genannten Quellpakete herunterladen und das Verzeichnis 'uk' im Verzeichnis 'src' kopieren und in Ihr globales Klassenpfadverzeichnis einfügen. Dann bist du bereit zu gehen!


Dokumentation für Tr.ace ()

Im Download-Paket finden Sie ein "docs" -Verzeichnis. öffne das index.html Datei, um die von ASDocs generierte Dokumentation für Tr.ace () anzuzeigen. Sie finden die Dokumentation auch online: http://docs.msfx.co.uk/as3/trace/.


Happy Tracing!

So ist es wirklich. Wenn Sie Fragen oder Anregungen zur Bibliothek haben, können Sie sich gerne in den Kommentaren melden.

Glückliche Rückverfolgung!