AIR Debug Launcher(ADL)の使用



開発時、SWF ベースのアプリケーションと HTML ベースのアプリケーションの両方を実行するには、AIR Debug Launcher(ADL)を使用します。ADL を使用すると、アプリケーションをパッケージ化してインストールしなくても実行できます。デフォルトでは、ADL では SDK に付属するランタイムが使用されるので、ADL を使用するためにランタイムを個別にインストールする必要はありません。

ADL では、トレースステートメントとランタイムエラーが標準出力に出力されますが、ブレークポイントやその他のデバッグ機能はサポートされていません。

ADL によるアプリケーションの起動

次のシンタックスを使用します。

adl [-runtime runtime-directory] [-pubid publisher-id] [-nodebug] application.xml [root-directory] [-- arguments]

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

-pubid publisher-id 指定された値を AIR アプリケーションの発行者 ID としてこの実行に割り当てます。一時的な発行者 ID を指定すると、ローカル接続による通信など、アプリケーションを一意に識別できるようにするために発行者 ID を使用する AIR アプリケーションの機能をテストできます。最終的な発行者 ID は、AIR インストールファイルへの署名に使用される電子証明書によって決まります。

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

application.xml アプリケーション記述ファイルです。AIR アプリケーションプロパティの設定を参照してください。

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

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

注意: 既に実行されている AIR アプリケーションを起動した場合、そのアプリケーションの新しいインスタンスは開始されません。代わりに、invoke イベントが実行中のインスタンスに送出されます。

トレースステートメントの出力

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

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

JavaScript では、alert() 関数と confirm() 関数を使用して、アプリケーションからデバッグメッセージを表示できます。また、キャッチされない JavaScript 例外に加えて、シンタックスエラーの行番号もコンソールに出力されます。

ADL の例

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

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 の終了コードとエラーコード

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

終了コード

説明

0

正常起動。ADL は、AIR アプリケーションの終了後に終了します。

1

既に実行されている AIR アプリケーションの正常な呼び出し。ADL は直ちに終了します。

2

使用法エラー。ADL に渡された引数が正しくありません。

3

ランタイムが見つかりません。

4

ランタイムを起動できません。多くの場合、アプリケーションで指定されたバージョンまたはパッチレベルが、ランタイムのバージョンまたはパッチレベルと一致しないために起こります。

5

原因不明のエラーが発生しました。

6

アプリケーション記述ファイルが見つかりません。

7

アプリケーション記述子の内容が無効です。このエラーは、通常、XML の形式が正しくないことを示しています。

8

アプリケーションのメインコンテンツファイル(アプリケーション記述ファイルの <content> エレメントで指定)が見つかりません。

9

アプリケーションのメインコンテンツファイルが、有効な SWF または HTML ファイルではありません。