AIR Debug Launcher（ADL）

ADL でアプリケーションを実行するには、次の形式を使用します。

adl application.xml

この application.xml は、実行するアプリケーションのアプリケーション記述ファイルです。

ADL の完全なシンタックスを以下に示します。

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

（角括弧 [ ] で囲まれたアイテムはオプションです）

-runtime runtime-directory ：使用するランタイムが含まれているディレクトリを指定します。指定しない場合、ADL プログラムと同じ SDK のランタイムディレクトリが使用されます。SDK フォルダー外へ ADL を移動している場合は、ランタイムディレクトリを指定します。Windows および Linux では、 Adobe AIR ディレクトリが含まれているディレクトリを指定します。Mac OS X では、 Adobe AIR.framework が含まれているディレクトリを指定します。

-pubid publisher-id ：指定された値を AIR アプリケーションの発行者 ID としてこの実行に割り当てます。一時的な発行者 ID を指定すると、ローカル接続による通信など、アプリケーションを一意に識別できるようにするために発行者 ID を使用する AIR アプリケーションの機能をテストできます。AIR 1.5.3 では、アプリケーション記述ファイルに発行者 ID を指定することもできます。その場合は、このパラメーターを使用しないでください。

-nodebug ：デバッグサポートをオフにします。このオプションを使用すると、アプリケーションプロセスが Flash デバッガーに接続できなくなり、処理されていない例外のダイアログが非表示になります。ただし、トレースステートメントは、引き続きコンソールウィンドウに出力されます。デバッグをオフにすると、アプリケーションの実行がやや速くなり、インストールされているアプリケーションの実行モードに動作が近くなります。

-atlogin ：ログイン時にアプリケーションの起動をシミュレートします。このフラグを使用すると、アプリケーションがユーザーのログイン時に起動するように設定されている場合にのみ実行するアプリケーションロジックをテストできます。 -atlogin を使用する場合、アプリケーションに送出される InvokeEvent オブジェクトの reason プロパティは、アプリケーションがすでに実行されていない限り、 standard ではなく login です。

-profile profileName ：指定されたプロファイルを使用して、アプリケーションをデバッグします。 profileName には、次の値のいずれか 1 つを指定できます。

• desktop

• extendedDesktop

• mobileDevice

アプリケーション記述子に supportedProfiles エレメントがある場合、 -profile を使用して指定するプロファイルは、サポートされるリストのメンバーである必要があります。 -profile フラグを使用しないと、アプリケーション記述子の最初のプロファイルがアクティブプロファイルとして使用されます。アプリケーション記述子に supportedProfiles エレメントがない場合、 -profile フラグを使用しないと、 desktop プロファイルが使用されます。

詳しくは、 supportedProfiles および デバイスプロファイル を参照してください。

-screensize value ：デスクトップで mobileDevice プロファイル内のアプリケーションを実行するときに使用するシミュレートされた画面サイズ。縦長レイアウト用の通常の幅と高さおよびフルスクリーンの幅と高さについては、事前定義した画面の種類またはピクセルサイズで画面サイズを指定します。種類によって値を指定するには、次の事前定義された画面の種類のいずれかを指定します。

画面のピクセルサイズを直接指定するには、次のフォーマットを使用します。

widthXheight:fullscreenWidthXfullscreenHeight

縦長レイアウト用のピクセルサイズを必ず指定してください。つまり、幅の値を、高さよりも小さな値に指定してください。例えば、NexusOne は次のように指定できます。

-screensize 480x762:480x800

-extdir extension-directory ：ランタイムでネイティブ拡張を検索するディレクトリ。このディレクトリには、アプリケーションで使用するネイティブ拡張ごとにサブディレクトリが 1 つずつ含まれています。これらの各サブディレクトリには、拡張のパッケージ化されていない ANE ファイルが含まれます。次に、例を示します。

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 
    

-extdir パラメーターを使用する場合は、次のことを考慮してください。

application.xml ：アプリケーション記述ファイルです。 AIR アプリケーション記述ファイル を参照してください。アプリケーション記述子は ADL の唯一の必須パラメーターです。多くの場合、他のパラメーターは必要ありません。

root-directory ：実行するアプリケーションのルートディレクトリを指定します。指定しない場合、アプリケーション記述ファイルを含んでいるディレクトリが使用されます。

-- arguments ：「--」の後に続くすべての文字ストリングが、コマンドライン引数としてアプリケーションに渡されます。

現在のディレクトリのアプリケーションを実行します。

adl myApp-app.xml

現在のディレクトリのサブディレクトリのアプリケーションを実行します。

adl source/myApp-app.xml release

アプリケーションを実行し、「tick」と「tock」の 2 つのコマンドライン引数を渡します。

adl myApp-app.xml -- tick tock

特定のランタイムを使用してアプリケーションを実行します。

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

デバッグサポートを使用せずにアプリケーションを実行します。

adl -nodebug myApp-app.xml

モバイルデバイスプロファイルのアプリケーションを実行し、Nexus One 画面サイズでシミュレートします。

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

アプリケーションを実行するために Apache Ant を使用するアプリケーションを実行します（次のパスは 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>

次の表で、ADL によって出力される終了コードについて説明します。