Zdalne debugowanie za pomocą programu FDB i połączenia USB

AIR 2.6 (Android), AIR 3.3 (iOS)

Aby debugować aplikację za pośrednictwem połączenia USB, należy spakować aplikację za pomocą opcji -listen , a nie opcji -connect . Gdy zostanie określona opcja -listen , po uruchomieniu aplikacji środowisko wykonawcze wykryje połączenie z narzędziem FDB na porcie TCP 7936. Następnie należy uruchomić narzędzie FDB z opcją -p . Narzędzie FDB zainicjuje połączenie.

Procedura debugowania przez połączenie USB dla systemu Android

Aby debuger Flash działający na komputerze stacjonarnym połączył się ze środowiskiem wykonawczym AIR działającym na urządzeniu lub w emulatorze, należy za pomocą narzędzia Android Debug Bridge (ADB) wchodzącego w skład zestawu SDK systemu Android lub iOS Debug Bridge (IDB) wchodzącego w skład zestawu SDK środowiska AIR przekazać sygnał z portu urządzenia do portu komputera.

  1. Otwórz terminal lub okno wiersza polecenia i przejdź do katalogu zawierającego kod źródłowy aplikacji.

  2. Skompiluj aplikację przy użyciu narzędzia amxmlc z włączonym debugowaniem. 

    amxmlc -debug DebugExample.as

  3. Aplikację należy spakować przy użyciu odpowiedniego docelowego formatu debugowania (takiego jak apk-debug ), określając też opcję -listen : 

    adt -package -target apk-debug -listen -storetype pkcs12 -keystore ../../AndroidCert.p12 DebugExample.apk DebugExample-app.xml DebugExample.swf

  4. Podłącz urządzenie za pomocą kabla USB do komputera używanego do debugowania. (Używając tej procedury, można również debugować aplikację działającą w emulatorze. Wówczas połączenie USB nie jest konieczne, ani nawet możliwe).

  5. Zainstaluj aplikację.

    W tym celu można użyć polecenia -installApp narzędzia ADT. 

    adt -installApp -platform android -package DebugExample.apk

  6. Przekaż sygnał z portu TCP 7936 z urządzenia lub z emulatora do komputera stacjonarnego za pomocą narzędzia ADB systemu Android. 

    adb forward tcp:7936 tcp:7936

  7. Uruchom aplikację na urządzeniu.

  8. W terminalu lub w oknie poleceń uruchom program FDB, korzystając z opcji -p. 

    fdb -p 7936

  9. W oknie narzędzia FDB wpisz polecenie run . 

    Adobe fdb (Flash Player Debugger) [build 14159] 
                                    Copyright (c) 2004-2007 Adobe, Inc. All rights reserved. 
                                    (fdb) run

  10. Program FDB spróbuje połączyć się z aplikacją.

  11. Po nawiązaniu zdalnego połączenia można ustawiać punkty przerwania za pomocą polecenia break programu FDB. W celu rozpoczęcia wykonywania należy użyć polecenia continue . 

    (fdb) run 
                                    Player connected; session starting. 
                                    Set breakpoints and then type 'continue' to resume the session. 
                                    [SWF] Users:juser:Documents:FlashProjects:DebugExample:DebugExample.swf - 32,235 bytes after decompression 
                                    (fdb) break clickHandler 
                                    Breakpoint 1 at 0x5993: file DebugExample.as, line 14 
                                    (fdb) continue
Uwaga: Port o numerze 7936 jest używany jako domyślny port podczas debugowania za pośrednictwem połączenia USB zarówno przez środowisko wykonawcze AIR, jak i przez program FDB. Można określić inne porty, korzystając z parametru portu -listen narzędzia ADT i parametru portu -p programu FDB. W takim przypadku należy użyć narzędzia Android Debug Bridge do przekazania numeru portu określonego w narzędziu ADT do portu określonego w programie FDB, stosując następujące polecenia: adb forward tcp:port_nasluchiwania_adt# tcp:port_fdb# .

Procedura debugowania przez połączenie USB dla systemu iOS

Aby debuger Flash działający na komputerze stacjonarnym połączył się ze środowiskiem wykonawczym AIR działającym na urządzeniu lub w emulatorze, należy za pomocą narzędzia iOS Debug Bridge (IDB) przekazać sygnał z portu urządzenia do portu komputera.

  1. Otwórz terminal lub okno wiersza polecenia i przejdź do katalogu zawierającego kod źródłowy aplikacji.

  2. Skompiluj aplikację przy użyciu narzędzia amxmlc z włączonym debugowaniem. 

    amxmlc -debug DebugExample.as

  3. Aplikację należy spakować przy użyciu odpowiedniego docelowego formatu debugowania (takiego jak ipa-debug lub ipa-debug-interpreter ), określając też opcję -listen : 

    adt -package -target ipa-debug-interpreter -listen 16000 
                                    xyz.mobileprovision -storetype pkcs12 -keystore Certificates.p12  
                                    -storepass pass123 OutputFile.ipa InputFile-app.xml InputFile.swf

  4. Podłącz urządzenie za pomocą kabla USB do komputera używanego do debugowania. (Używając tej procedury, można również debugować aplikację działającą w emulatorze. Wówczas połączenie USB nie jest konieczne, ani nawet możliwe).

  5. Zainstaluj i uruchom aplikację na urządzeniu z systemem iOS. W środowisku AIR 3.4 lub nowszym można zainstalować aplikację przez połączenie USB, używając opcji adt ‑installApp .

  6. Określ uchwyt urządzenia za pomocą polecenia idb -devices . (Narzędzie IDB znajduje się w katalogu air_sdk_root /lib/aot/bin/iOSBin/idb ). 

    ./idb -devices 

                                    List of attached devices 
                                    Handle    UUID 
                                        1     91770d8381d12644df91fbcee1c5bbdacb735500
    Uwaga: (Środowisko AIR 3.4 i nowsze wersje) Używając opcji adt ‑devices zamiast opcji idb ‑devices , można określić uchwyt urządzenia.

  7. Przekaż port na komputerze do portu określonego w parametrze adt -listen (w tym przypadku 16 000, domyślnie 7936) za pomocą narzędzia IDB i identyfikatora urządzenia uzyskanego w poprzednim kroku. 

    idb -forward 7936 16000 1

    W tym przykładzie port komputera ma numer 7936, port, na którym nasłuchuje podłączone urządzenie, ma numer 16 000, a identyfikator tego urządzenia ma wartość 1.

  8. W terminalu lub w oknie poleceń uruchom program FDB, korzystając z opcji -p. 

    fdb -p 7936

  9. W oknie narzędzia FDB wpisz polecenie run . 

    Adobe fdb (Flash Player Debugger) [build 23201] 
                                    Copyright (c) 2004-2007 Adobe, Inc. All rights reserved. 
                                    (fdb) run

  10. Program FDB spróbuje połączyć się z aplikacją.

  11. Po nawiązaniu zdalnego połączenia można ustawiać punkty przerwania za pomocą polecenia break programu FDB. W celu rozpoczęcia wykonywania należy użyć polecenia continue .

Uwaga: Port o numerze 7936 jest używany jako domyślny port podczas debugowania za pośrednictwem połączenia USB zarówno przez środowisko wykonawcze AIR, jak i przez program FDB. Można określić inne porty, korzystając z parametru portu -listen narzędzia IDB i parametru portu -p programu FDB.