Debugowanie aplikacji AIR na komputery stacjonarne

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).
  1. Uruchom program FDB. Program FDB znajduje się w katalogu bin pakietu Flex SDK.

    Konsola wyświetli monit programu FDB: <fdb>

  2. Wykonaj polecenie run : <fdb>run [Enter]

  3. W innej konsoli poleceń lub powłoce uruchom wersję aplikacji po debugowaniu:

    adl myApp.xml
  4. Za pomocą poleceń FDB ustaw punkty zatrzymania zgodnie z potrzebami.

  5. 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 :

adl myApp.xml -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.