Debuggen von AIR-Anwendungen für den Desktop

Wenn Sie Ihre Anwendung mit einer IDE wie Flash Builder, Flash Professional oder Dreamweaver entwickeln, sind die Debugging-Werkzeuge normalerweise integriert. Zum Debuggen der Anwendung genügt es dann, sie im Debug-Modus zu starten. Wenn Sie nicht mit einer IDE arbeiten, die das Debuggen direkt unterstützt, können Sie AIR Debug Launcher (ADL) und Flash Debugger (FDB) zur Unterstützung beim Debuggen der Anwendung verwenden.

Ausführen von Anwendungen mit ADL

Mithilfe von ADL können Sie eine AIR-Anwendung ausführen, ohne sie zu komprimieren und zu installieren. Übergeben Sie die Anwendungsdeskriptordatei als Parameter an ADL, wie im folgenden Beispiel gezeigt (ggf. in der Anwendung vorhandener ActionScript-Code muss zunächst kompiliert werden):

adl myApplication-app.xml

ADL gibt Trace-Anweisungen, Laufzeitausnahmen und HTML-Analysefehler an das Terminalfenster aus. Wenn ein FDB-Prozess auf eine ankommende Verbindung wartet, stellt ADL eine Verbindung zum Debugger her.

Sie können eine AIR-Anwendung, die native Erweiterungen verwendet, auch mit ADL debuggen. Zum Beispiel:

adl -extdir extensionDirs myApplication-app.xml

Ausgeben von trace-Anweisungen

Um trace-Anweisungen an die Konsole auszugeben, auf der ADL ausgeführt wird, fügen Sie Ihrem Code mit der Funktion trace() trace-Anweisungen hinzu.

Hinweis: Falls Ihre trace() -Anweisungen nicht in der Konsole angezeigt werden, stellen Sie sicher, dass Sie in der Datei „mm.cfg“ nicht ErrorReportingEnable oder TraceOutputFileEnable angegeben haben. Weitere Informationen zum plattformspezifischen Speicherort dieser Datei finden Sie unter Bearbeiten der Datei „mm.cfg“ .

ActionScript-Beispiel:

//ActionScript 
trace("debug message"); 

JavaScript-Beispiel:

//JavaScript 
air.trace("debug message");
In JavaScript-Code können Sie die Funktionen alert() und confirm() verwenden, um Debugging-Meldungen der Anwendung anzuzeigen. Außerdem werden die Zeilennummern von Syntaxfehlern und nicht erfasste JavaScript-Ausnahmen in der Konsole ausgegeben.
Hinweis: Um das im JavaScript-Beispiel gezeigte AIR-Präfix zu verwenden, müssen Sie die Datei „AIRAliases.js“ in die Seite importieren. Diese Datei befindet sich im frameworks-Verzeichnis des AIR-SDK.

Herstellen der Verbindung zum Flash Debugger (FDB)

Für das Debuggen von AIR-Anwendungen mit dem Flash Debugger starten Sie eine FDB-Sitzung und rufen dann die Anwendung mit ADL auf.

Hinweis: Bei SWF-basierten AIR-Anwendungen müssen die ActionScript-Quelldateien mit dem -debug -Flag kompiliert werden. (In Flash Professional aktivieren Sie die Option „Debugging erlauben“ im Dialogfeld „Einstellungen für Veröffentlichungen“.)
  1. Starten Sie FDB. Das FDB-Programm befindet sich im Verzeichnis bin des Flex SDK.

    Auf der Konsole wird die FDB-Eingabeaufforderung eingeblendet: <fdb>

  2. Führen Sie den Befehl run aus: <fdb>run [Eingabetaste]

  3. Starten Sie die Debug-Version Ihrer Anwendung in einer anderen Befehls- oder Shell-Konsole.

    adl myApp.xml
  4. Setzen Sie die gewünschten Haltepunkte mit dem FDB-Befehl.

  5. Geben Sie ein: continue [Eingabe]

Wenn die AIR-Anwendung SWF-basiert ist, steuert der Debugger nur die Ausführung von ActionScript-Code. Wenn die AIR-Anwendung HTML-basiert ist, steuert der Debugger nur die Ausführung von JavaScript-Code.

Um ADL ohne Verbindung zum Debugger auszuführen, schließen Sie die Option -nodebug mit ein:

adl myApp.xml -nodebug

Grundlegende Informationen zu den FDB-Befehlen erhalten Sie, wenn Sie den Befehl help ausführen:

<fdb>help [Enter]

Ausführliche Informationen zu den FDB-Befehlen finden Sie unter Using the command-line debugger commands (Verwenden der Befehlszeilen-Debugger-Befehle) in der Flex-Dokumentation.