AIR Debug Launcher (ADL)

Aby uruchomić aplikację za pomocą programu ADL, należy użyć następującego schematu:

adl application.xml

Fragment application.xml oznacza plik deskryptora dla aplikacji.

Oto pełny opis składni wywołania programu ADL:

adl     [-runtime runtime-directory] 
    [-pubid publisher-id] 
    [-nodebug] 
    [-atlogin] 
    [-profile profileName] 
    [-screensize value] 
    [-extdir extension-directory] 
    application.xml 
    [root-directory] 
    [-- arguments]

Elementy w nawiasach kwadratowych ([]) są opcjonalne.

-runtime runtime-directory Określa katalog zawierający środowisko wykonawcze, jakie będzie używane. Jeśli nie zostanie określony, wówczas katalog środowiska wykonawczego będzie należał do tego samego folderu SDK, z którego używany jest program ADL. Jeśli program uruchamiający ADL zostanie przeniesiony ze swojego folderu SDK, należy określić katalog środowiska wykonawczego. W systemach Windows i Linux należy określić katalog zawierający katalog Adobe AIR . W systemie Mac OS X należy określić katalog zawierający Adobe AIR.framework .

-pubid publisher-id Przypisuje określoną wartość jako identyfikator wydawcy uruchamianej aplikacji AIR. Określenie tymczasowego identyfikatora wydawcy umożliwia testowanie funkcji w aplikacji AIR, np. komunikowanie przez połączenie lokalne, które korzysta z id. wydawcy w celu jednoznacznego zidentyfikowania aplikacji. Począwszy od wersji AIR 1.5.3 możliwe jest także określenie identyfikatora wydawcy w pliku deskryptora aplikacji (nie należy wówczas korzystać z tego parametru).

-nodebug Wyłącza obsługę debugowania. Jeśli ten parametr jest używany, wówczas proces aplikacji nie może się połączyć z debugerem Flash, co powoduje zatrzymanie wyświetlania okien dialogowych z informacjami o nieobsłużonych wyjątkach. (Jednak instrukcje trace nadal są wyświetlane w oknie konsoli). Wyłączenie debugowania umożliwia szybsze działanie aplikacji, a ponadto powoduje wierniejsze emulowanie trybu wykonywania zainstalowanej aplikacji.

- atlogin Symuluje uruchamianie aplikacji przy logowaniu. Ta flaga umożliwia testowanie logiki aplikacji wykonywanej dopiero po zalogowaniu się użytkownika. Gdy używana jest opcja -atlogin , właściwość reason obiektu InvokeEvent wywoływanego w aplikacji będzie miała wartość login , a nie standard (chyba że aplikacja jest już uruchomiona).

-profile profileName Powoduje debugowanie aplikacji przy użyciu określonego profilu. Opcja profileName może mieć jedną z następujących wartości:

• desktop

• extendedDesktop

• mobileDevice

Jeśli deskryptor aplikacji zawiera element supportedProfiles , profil określany za pomocą opcji -profile musi występować na liście obsługiwanych pozycji. Jeśli flaga -profile nie została użyta, pierwszy profil w deskryptorze aplikacji jest używany jako aktywny profil. Jeśli deskryptor aplikacji nie zawiera elementu supportedProfiles i nie została użyta flaga -profile , używany jest profil desktop .

Więcej informacji zawierają rozdziały supportedProfiles i Profile urządzeń .

-screensize wartość Symulowany rozmiar ekranu używany podczas uruchamiania aplikacji o profilu mobileDevice na komputerze stacjonarnym. Należy podać rozmiar ekranu jako predefiniowany typ ekranu lub jako wymiary w pikselach (określając normalną szerokość i wysokość układu pionowego i szerokość oraz wysokość pełnego ekranu). Aby określić wartość jako typ, należy użyć jednego z następujących predefiniowanych typów ekranu.

Aby bezpośrednio określić wymiary ekranu w pikselach, należy użyć następującego formatu:

widthXheight:fullscreenWidthXfullscreenHeight

Zawsze należy określać wymiary w pikselach układu pionowego — z wartością szerokości mniejszą niż wartość wysokości. Można na przykład zdefiniować ekran telefonu NexusOne w następujący sposób:

-screensize 480x762:480x800

-extdir extension-directory Katalog, w którym środowisko wykonawcze powinno szukać rozszerzeń natywnych. Ten katalog zawiera odpowiedni podkatalog dla każdego rozszerzenia natywnego używanego przez aplikację. Każdy z tych podkatalogów zawiera rozpakowany plik ANE rozszerzenia. Na przykład:

C:\extensionDirs\ 
    extension1.ane\ 
        META-INF\ 
            ANE\ 
                Android-ARM\ 
                    library.swf 
                    extension1.jar 
                extension.xml 
            signatures.xml 
        catalog.xml 
        library.swf 
        mimetype 
    extension2.ane\ 
        META-INF\ 
            ANE\ 
                Android-ARM\ 
                    library.swf 
                    extension2.jar 
                extension.xml 
            signatures.xml 
        catalog.xml 
        library.swf 
        mimetype 
    

W przypadku używania parametru -extdir należy wziąć pod uwagę następujące kwestie:

application.xml Plik deskryptora aplikacji. Zobacz Pliki deskryptora aplikacji AIR . Deskryptor aplikacji jest jedynym wymaganym parametrem programu ADL i w większości przypadków jedynym potrzebnym parametrem.

root-directory Określa katalog główny aplikacji, która ma być uruchamiana. Jeśli katalog nie jest uruchomiony, zostanie wykorzystany katalog zawierający plik deskryptora aplikacji.

-- arguments Wszystkie znaki, jakie pojawią się za znakami „--”, zostaną przekazane do aplikacji jako argumenty wiersza poleceń.

Uruchomienie aplikacji w katalogu bieżącym:

adl myApp-app.xml

Uruchomienie aplikacji w podkatalogu katalogu bieżącego:

adl source/myApp-app.xml release

Uruchomienie aplikacji i przekazanie dwóch argumentów wiersza poleceń: „tick” i „tock”.

adl myApp-app.xml -- tick tock

Uruchomienie aplikacji przy użyciu określonego środowiska wykonawczego:

adl -runtime /AIRSDK/runtime myApp-app.xml

Uruchomienie aplikacji bez obsługi debugowania:

adl -nodebug myApp-app.xml

Uruchomienie aplikacji o profilu dla urządzeń przenośnych i zasymulowanie rozmiaru ekranu urządzenia Nexus.

adl -profile mobileDevice -screensize NexusOne myMobileApp-app.xml

Uruchomienie aplikacji za pomocą programu Apache Ant. (Ścieżki podane w przykładzie dotyczą systemu Windows).

<property name="SDK_HOME" value="C:/AIRSDK"/> 
<property name="ADL" value="${SDK_HOME}/bin/adl.exe"/> 
<property name="APP_ROOT" value="c:/dev/MyApp/bin-debug"/> 
<property name="APP_DESCRIPTOR" value="${APP_ROOT}/myApp-app.xml"/> 
 
<target name="test"> 
    <exec executable="${ADL}"> 
        <arg value="${APP_DESCRIPTOR}"/> 
        <arg value="${APP_ROOT}"/> 
    </exec>  
</target>

Poniższa tabela przedstawia kody wyjścia wyświetlane przez program ADL: