Wählen Sie Debuggen > Debuggen
(Version CS6 und früher) Wählen Sie „Debug“ > „Film debuggen“ > Debuggen.
Animate bietet einen separaten Debugger für ActionScript 3.0, der etwas anders arbeitet als der ActionScript 2.0-Debugger. Der ActionScript 3.0-Debugger funktioniert nur mit ActionScript 3.0 FLA- und AS-Dateien. Die Veröffentlichungseinstellungen der FLA-Dateien müssen auf Flash Player 9 gesetzt sein. Wenn Sie eine ActionScript 3.0-Debugging-Sitzung einleiten, startet Animate die eigenständige Debug-Version von Flash Player, um die SWF-Datei abzuspielen. Die Wiedergabe der SWF-Datei durch den Debug Flash Player erfolgt in einem anderen Fenster als dem der Animate-Authoring-Anwendung.
Der ActionScript 3.0-Debugger konvertiert den Animate-Arbeitsbereich in einen Debug-Arbeitsbereich, in dem Bedienfelder angezeigt werden, die zum Debuggen verwendet werden. Er enthält auch das Bedienfeld „Aktionen“ und/oder das Skriptfenster, die Debug-Konsole und das Bedienfeld „Variablen“. In der Debug-Konsole werden der Call-Stack und die Werkzeuge zum Durchlaufen der Skripts angezeigt. Im Bedienfeld „Variablen“ werden die im aktuellen Bereich vorhandenen Variablen mit ihren Werten angezeigt, und Sie können diese Werte selbst aktualisieren.
Zusätzliche Ressourcen
Die folgenden Ressourcen enthalten ausführliche Informationen zum Debugging von ActionScript 3.0:
Wie Sie eine Debugging-Sitzung starten, hängt vom Typ der bearbeiteten Dateien ab. Stößt Animate während einer Debugging-Sitzung auf einen Haltepunkt oder einen Laufzeitfehler, wird die Ausführung von ActionScript unterbrochen.
Wenn eine Debugging-Sitzung von Animate eingeleitet wird, werden der für diese Sitzung exportierten SWF-Datei spezielle Informationen hinzugefügt. Diese Informationen ermöglichen es dem Debugger, die Nummern der Codezeilen anzugeben, in denen Fehler festgestellt wurden.
Diese speziellen Debugging-Informationen können Sie in alle SWF-Dateien einbinden, die anhand einer bestimmten FLA-Datei im Dialogfeld „Einstellungen für Veröffentlichungen“ erstellt wurde. Dadurch können Sie eine SWF-Datei debuggen, ohne ausdrücklich eine Debugging-Sitzung einzuleiten. Durch die Debugging-Informationen wird die SWF-Datei etwas größer.
Auswählen der Standard-Debugging-Umgebung
Wählen Sie „Debuggen“ > „Film debuggen“ und dann eine der folgenden Optionen:
Animate
in AIR Debug Launcher (Desktop)
in AIR Debug Launcher (mobil)
auf Gerät über USB (nur in CS5.5)
Alle Debug-Sitzungen finden in der hier gewählten Umgebung statt. Sie können die Standardumgebung aber jederzeit ändern.
Starten des Debugging von einer FLA-Datei aus
Wählen Sie Debuggen > Debuggen
(Version CS6 und früher) Wählen Sie „Debug“ > „Film debuggen“ > Debuggen.
Starten des Debugging von einer ActionScript 3.0 AS-Datei aus
Öffnen Sie die ActionScript-Datei im Skriptfenster, und wählen Sie oben im Skriptfenster aus dem Zielmenü die FLA-Datei aus, die mit der ActionScript-Datei kompiliert werden soll. Die FLA-Datei muss ebenfalls geöffnet sein, damit sie in diesem Menü angezeigt wird.
Wählen Sie Debuggen > Debuggen
(Version CS6 und früher) Wählen Sie „Debug“ > „Film debuggen“ > Debuggen.
Hinzufügen von Debugging-Informationen zu allen anhand einer FLA-Datei erstellten SWF-Dateien
Wählen Sie bei geöffneter FLA-Datei „Datei“ > „Einstellungen für Veröffentlichungen“ aus.
Öffnen Sie im Dialogfeld „Veröffentlichungseinstellungen“ die Registerkarte „“ (CS5) bzw. die Kategorie „“ (CS5.5).
Wählen Sie „Debugging erlauben“.
Beenden des Debugging-Modus
Klicken Sie in der Debug-Konsole auf „Debug-Sitzung beenden“.
Fügen Sie dem ActionScript-Code Haltepunkte hinzu, um die Ausführung des Codes zu unterbrechen. Sobald die Ausführung unterbrochen wird, können Sie den Code Zeile für Zeile durchlaufen und ausführen, verschiedene Abschnitte Ihres ActionScript-Codes anzeigen, die Werte von Variablen und Ausdrücken anzeigen und Variablenwerte bearbeiten.
Bei ASC- und JSFL-Dateien (ActionScript for Communication, Flash JavaScript) ist das Hinzufügen von Haltepunkten nicht möglich.
Setzen von Haltepunkten
Klicken Sie im Bedienfeld „Aktionen“ oder im Skriptfenster auf den linken Rand, und zwar neben der Codezeile, in der der Haltepunkt gesetzt werden soll.
Entfernen von Haltepunkten
Klicken Sie im Bedienfeld „Aktionen“ oder im Skriptfenster auf den Haltepunkte, den Sie entfernen möchten.
Nachdem die ActionScript-Ausführung an einem Haltepunkt oder bei einem Laufzeitfehler unterbrochen wurde, können Sie Zeile für Zeile durch den Code gehen. Sie können in Funktionsaufrufe gehen oder sie überspringen. Sie haben auch die Möglichkeit, den Code unmittelbar weiter auszuführen.
Durchlaufen von Code Zeile für Zeile
Klicken Sie in der Debug-Konsole auf „Hineinspringen“.
Überspringen von Funktionsaufrufen
Klicken Sie in der Debug-Konsole auf „Überspringen“.
Verlassen von Funktionsaufrufen
Klicken Sie in der Debug-Konsole auf „Verlassen“.
Wiederaufnehmen der normalen Codeausführung
Klicken Sie in der Debug-Konsole auf „Weiter“.
Wenn die Codeausführung im Debugger angehalten wird, können Sie in der Debug-Konsole den Call-Stack einsehen und im Call-Stack die Skripts anzeigen, die Funktionen enthalten. Im Call-Stack wird die aktuelle Liste der verschachtelten Funktionsaufrufe angezeigt, deren Ausführung noch nicht abgeschlossen ist.
Sie können die individuellen Skripts anzeigen, die die einzelnen Funktionen enthalten.
Im Bedienfeld „Variablen“ können Sie die Werte von Variablen und Eigenschaften anzeigen und bearbeiten.
Anzeigen vonVariablenwerten
Wählen Sie im Bedienfeld „Variablen“ aus dem Menü „Bedienfeld“ die anzuzeigenden Variablentypen aus.
„Konstanten anzeigen“ zeigt die konstanten Werte an (Variablen mit festen Werten).
„Statische anzeigen“ zeigt Variablen an, die zu der Klasse und nicht zu Instanzen dieser Klasse gehört.
„Unzugängliche Mitgliedervariablen anzeigen“ zeigt Variablen an, auf die andere Klassen oder Namespaces nicht zugreifen können. Dazu gehören geschützte, private oder interne Variablen des Namespace.
„Zusätzliche Hexadezimaldarstellung anzeigen“ fügt überall dort Hexadezimalwert hinzu, wo Dezimalwerte angezeigt werden. Dies ist vor allem bei Farbwerten nützlich. Für Dezimalwerte von 0 bis 9 werden keine Hexadezimalwerte angezeigt.
„Qualifizierte Namen anzeigen“ zeigt die Variablentypen sowohl mit dem Paketnamen als auch dem Klassennamen an.
Erweitern Sie die Baumstruktur der FLA-Objektstruktur, bis Sie die gewünschte Variable sehen können.
Bearbeiten des Wertes einer Variablen
Doppelklicken Sie im Bedienfeld „Variablen“ auf den Wert der Variablen.
Geben Sie den neuen Wert ein, und drücken Sie die Eingabetaste. Der neue Wert wird bei späteren Codeausführungen verwendet.
Sie können steuern, welche Typen von Fehlermeldungen vom ActionScript-Compiler im Bedienfeld „Compiler-Fehler“ generiert werden. Nachdem vom Compiler ein Fehler gemeldet wurde, können Sie durch Doppelklicken auf die Fehlermeldung an die Codezeile springen, die den Fehler verursacht hat.
Klicken Sie auf „Animate“.
Wenn Animate beim Kompilieren oder Ausführen einen Fehler im ActionScript-Code feststellt, wird dieser Fehler im Bedienfeld „Compiler-Fehler“ angezeigt. Vom Bedienfeld „Compiler-Fehler“ aus können Sie zu der Codezeile navigieren, die den Fehler verursacht hat.
In ActionScript 3.0 können Sie zum Debuggen einer Remote-SWF-Datei den eigenständigen Debug Flash Player sowie die ActiveX- und Plug-In-Version des Players einsetzen. Sie finden ihn im Verzeichnis „Animate-Installationsverzeichnis/Players/Debug/“. Beim ActionScript 3.0 Debugger ist das Remote-Debugging jedoch auf Dateien beschränkt, die sich auf demselben lokalen Host befinden wie die Animate-Authoring-Anwendung, die in dem eigenständigen Debug Flash Player, der ActiveX- oder Plug-In-Version des Players wiedergegeben wird.
Wenn Sie bei einer Datei das Remote-Debugging zulassen möchten, müssen Sie das Debugging in den „Einstellungen für Veröffentlichungen“ aktivieren. Sie können Ihre SWF-Datei mit einem Debugging-Kennwort veröffentlichen, um sicherzustellen, dass nur autorisierte Benutzer die Datei debuggen können.
Wie auch in JavaScript oder HTML können Benutzer clientseitige Variablen in ActionScript anzeigen. Zur sicheren Speicherung von Variablen müssen Sie diese an eine Serveranwendung übertragen, statt sie in der Datei zu speichern. Viele Entwickler legen außerdem Wert darauf, andere Informationen, wie beispielsweise die Struktur von Movieclips, geheim zu halten. Mithilfe eines Debugging-Kennworts können Sie Ihre Arbeit schützen.
Aktivieren des Remote-Debugging einer SWF-Datei und Festlegen eines Debugging-Kennworts
In ActionScript 3.0 FLA-Dateien kann kein Debugging an Code in Bildskripts durchgeführt werden. Mit dem ActionScript 3.0 Debugger können Sie nur Code in externen AS-Dateien debuggen.
Öffnen Sie die FLA-Datei.
Wählen Sie „Datei“ > „Einstellungen für Veröffentlichungen“.
Öffnen Sie im Dialogfeld „Veröffentlichungseinstellungen“ die Registerkarte „“ (CS5) bzw. die Kategorie „“ (CS5.5) und wählen Sie „Debugging zulassen“.
Schließen Sie das Dialogfeld „Einstellungen für Veröffentlichungen“ und wählen Sie einen der folgenden Befehle aus:
„Datei“ > „Exportieren“ > „Film exportieren“
„Datei“ > „Veröffentlichen“
Lassen Sie die SWF-Datei auf dem lokalen Computer, um auf dem lokalen Host ein Remote-Debugging auszuführen, oder laden Sie sie auf den Webserver hoch.
Da SWF-Datei nicht über Haltepunktinformationen verfügt, können Sie den Code während der Ausführung nicht Schritt für Schritt durchlaufen, wenn Sie die Datei auf einen Remote-Server hochladen. Führen Sie diese Aufgabe auf dem lokalen Host aus.
Wählen Sie in Animate „Debuggen“ > „Remote-Debug-Sitzung beginnen“ > „ActionScript 3.0“.
Animate öffnet das Bedienfeld „ActionScript 3.0 Debugger“ und wartet darauf, dass eine Verbindung zu einem Debug Flash Player hergestellt wird. Sie müssen den Debug Flash Player innerhalb von 2 Minuten starten. Wenn mehr als 2 Minuten vergehen, müssen Sie diesen Schritt wiederholen.
Öffnen Sie die SWF-Datei in der Debug-Version des eigenständigen Flash Players, der ActiveX- oder Plug-In-Version des Players. Der eigenständige Debug Player befindet sich im Verzeichnis „Animate-Installationsverzeichnis/Players/Debug/“. Stellen Sie keine Verbindung zu einer Datei auf einem anderen Computer her, da der Debugger dann keine Haltepunktinformationen empfangen kann.
Die Debug-Sitzung beginnt, sobald der Debug Player eine Verbindung mit dem Bedienfeld „ActionScript 3.0 Debugger“ in herstellt.
Das Debuggen aus der Ferne funktioniert nicht, wenn Sie die Standard-Netzwerkschnittstelle für AIR 3.4 wählen. Wählen Sie stattdessen die Optionen zum Angeben des Netzwerkschnittstellennamens und der IP-Adresse des Systems.
Aktivieren des Debugger von einem Remote-Standort aus
Öffnen Sie die Animate-Authoring-Anwendung, sofern sie noch nicht geöffnet ist.
Wählen Sie „Debuggen“ > „Remote-Debug-Sitzung beginnen“ >„ActionScript 3.0“.
Öffnen Sie die veröffentlichte SWF-Datei von einem Remote-Standort aus in einem Browser oder in der Debugger-Version des eigenständigen Players.
Falls das Dialogfeld „Remote-Debugging“ nicht geöffnet ist, klicken Sie mit der rechten Maustaste (Windows) bzw. bei gedrückter Befehlstaste (Macintosh) auf die SWF-Datei und wählen Sie im Kontextmenü den Befehl „Debugger“.
Wählen Sie im Dialogfeld „Remote-Debugging“ die Option „Lokaler Host“ und wählen Sie die zu öffnende Datei.
Die Anzeigeliste der SWF-Datei wird im Debugger angezeigt. Wenn die SWF-Datei nicht wiedergegeben wird, wurde der Debugger möglicherweise angehalten. Klicken Sie auf „Weiter“, um die Wiedergabe zu starten.