AIR Debug Launcher（ADL）の使用

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

adl application.xml

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

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

adl [-runtime runtime-directory] [-pubid publisher-id] [-nodebug] [-profile profileName] 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」には、desktop、extendedDesktop、mobileDevice および extendedMobileDevice を使用できます。詳しくは、ターゲットアプリケーションプロファイルの限定およびアプリケーションプロファイルを参照してください。

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

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

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

ADL の実行に使用するコンソールにトレースステートメントを出力するには、trace() 関数を使用して、トレースステートメントをコードに追加します。

ActionScript の例：

//ActionScript 
trace("debug message"); 

JavaScript の例：

//JavaScript 
air.trace("debug message");

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

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 myApp-app.xml -nodebug

Apache Ant を使用してアプリケーションを実行します。

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

Flash デバッガーを使用して AIR アプリケーションをデバッグするには、FDB セッションを開始してから ADL でアプリケーションを起動します。

1. FDB を開始します。FDB プログラムは、Flex SDK の bin ディレクトリにあります。

   コンソールに、FDB プロンプトの <fdb> が表示されます。

2. run コマンドを <fdb>run [Enter] のようにして実行します。

3. 別のコマンドまたはシェルコンソールで、アプリケーションのデバッグバージョンを開始します。

   adl myApp.xml

4. FDB コマンドを使用して、必要に応じてブレークポイントを設定します。

5. continue [Enter] のように入力します。

SWF ベースの AIR アプリケーションの場合は、ActionScript コードの実行だけがデバッガーによって制御されます。HTML ベースの AIR アプリケーションの場合は、JavaScript コードの実行だけがデバッガーによって制御されます。

デバッガーに接続せずに ADL を実行するには、-nodebug オプションを含めます。

adl myApp.xml -nodebug

FDB コマンドの基本情報を表示するには、help コマンドを実行します。

<fdb>help [Enter]

FDB コマンドについて詳しくは、Flex ドキュメントの「コマンドラインデバッガーコマンドの使用」を参照してください。

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