Narzędzia do debugowania są zazwyczaj wbudowane w środowiska programistyczne, takie jak oprogramowanie Flash Builder, Flash Professional czy Dreamweaver. Aplikację można również debugować, uruchamiając ją w trybie debugowania. W przypadku korzystania ze środowiska programistycznego, które nie obsługuje debugowania bezpośrednio, pomoc w debugowaniu aplikacji można uzyskać, używając narzędzi AIR Debug Launcher (ADL) i Flash Debugger (FDB).
Uruchamianie aplikacji za pomocą narzędzia ADL
Korzystając z narzędzia ADL, można uruchamiać aplikacje AIR bez pakowania i instalowania. Plik deskryptora aplikacji należy przekazać do narzędzia ADL jako parametr, zgodnie z poniższym przykładem. (Najpierw należy skompilować kod ActionScript w aplikacji).
adl myApplication-app.xml
Narzędzie ADL wyświetla instrukcje trace, wyjątki środowiska wykonawczego i błędy analizowania kodu HTML w oknie terminala. Jeśli proces FDB czeka na połączenie przychodzące, narzędzie ADL łączy się z debugerem.
Aplikacje korzystające z rozszerzeń natywnych można również debugować za pomocą narzędzia ADL. Na przykład:
adl -extdir extensionDirs myApplication-app.xml
Wyświetlanie instrukcji trace
W celu wyświetlenia instrukcji trace w konsoli służącej do uruchamiania ADL należy dodać instrukcje trace do kodu za pomocą funkcji
trace()
.
Uwaga:
Jeśli instrukcje
trace()
nie są wyświetlane w konsoli, upewnij się, że w pliku mm.cfg nie jest ustawiony parametr
ErrorReportingEnable
ani
TraceOutputFileEnable
. Więcej informacji o lokalizacji tego pliku na poszczególnych platformach zawiera artykuł
Edytowanie pliku mm.cfg
.
Przykład w języku ActionScript:
//ActionScript
trace("debug message");
Przykład w języku JavaScript:
//JavaScript
air.trace("debug message");
W JavaScript można korzystać z funkcji
alert()
i
confirm()
w celu wyświetlania komunikatów debugowania z aplikacji. Ponadto w konsoli wyświetlane są numery linii z błędami składni, podobnie jak niewychwycone wyjątki JavaScript.
Uwaga:
W celu użycia przedrostka air przedstawionego w przykładzie w języku JavaScript należy zaimportować plik AIRAliases.js na stronę. Plik znajduje się w katalogu frameworks pakietu AIR SDK.
Połączenie z debugerem Flash Debugger (FDB)
Aby debugować aplikację AIR za pomocą debugera Flash Debugger, należy uruchomić sesję FDB, a następnie uruchomić aplikację za pomocą programu ADL.
Uwaga:
W aplikacjach AIR opartych na plikach SWF pliki źródłowe ActionScript muszą być kompilowane z flagą
-debug
. (W programie Flash Professional należy zaznaczyć opcję Pozwól debugować w oknie dialogowym Ustawienia publikowania).
-
Uruchom program FDB. Program FDB znajduje się w katalogu
bin
pakietu Flex SDK.
Konsola wyświetli monit programu FDB:
<fdb>
-
Wykonaj polecenie
run
:
<fdb>run [Enter]
-
W innej konsoli poleceń lub powłoce uruchom wersję aplikacji po debugowaniu:
adl myApp.xml
-
Za pomocą poleceń FDB ustaw punkty zatrzymania zgodnie z potrzebami.
-
Wpisz:
continue [Enter]
Jeśli aplikacja ma format SWF, debuger steruje jedynie wykonaniem kodu ActionScript. Jeśli aplikacja ma format HTML, wówczas debuger steruje jedynie wykonaniem kodu JavaScript.
Aby uruchomić program ADL bez połączenia z debugerem, należy dołączyć opcję
-nodebug
:
Aby uzyskać podstawowe informacje na temat poleceń programu FDB, należy wywołać polecenie
help
:
<fdb>help [Enter]
Szczegółowe informacje na temat poleceń programu FDB zawiera sekcja
Korzystanie z poleceń debugera wiersza poleceń
w dokumentacji środowiska Flex.
|
|
|