delay プロパティと updateURL プロパティの値を設定する設定ファイルの場所。更新処理の間にアプリケーションがさまざまな確認ダイアログボックスを表示するかどうかを決定するための設定もあります。このプロパティで指定したファイルが存在しない場合は、initialize() メソッドを呼び出すと Error がスローされます。

設定ファイルの例を次に示します。

 <?xml version="1.0" encoding="utf-8"?> 
   <configuration xmlns="http://ns.adobe.com/air/framework/update/configuration/1.0" >
     <url>app:/server/update.xml</url>
     <delay>1</delay>
     <defaultUI>
        <dialog name="checkForUpdate" visible="true" />
         <dialog name="downloadUpdate" visible="false" />
         <dialog name="downloadProgress" visible="true" />
         <dialog name="installUpdate" visible="true" />    
     </defaultUI>
  </configuration>

設定ファイルをロードする代わりに、ActionScript のコードを使用して、ApplicationUpdaterUI オブジェクトのプロパティ delay、isCheckForUpdateVisible、isDownloadProgressVisible、isDownloadUpdateVisible、isFileUpdateVisible、isInstallUpdateVisible および updateURL を設定することもできます。

関連項目

アプリケーションの現在のバージョン。このプロパティは、initialize() メソッドの呼び出し中に設定されます。アプリケーション記述ファイルのバージョンに設定されます。

新しい更新を周期的にチェックする間隔を示す日数。

値が 0 （デフォルト値）の場合、タイマーがアクティブでないことを示し、周期的なチェックは実行されません。遅延は、このプロパティまたは設定ファイルを使用して設定できます。両方の方法を使用して値を設定すると、このプロパティを使用して設定した値が使用されます。

デフォルト値 : 0.

関連項目

[アップデートの有無をチェック]、[アップデートがありません]、および [アップデートエラー] ダイアログボックスの表示を有効にします。true に設定すると、Updater は更新処理の一部としてこれらのダイアログボックスを表示します。更新設定ファイルで設定することもできます。 このプロパティを使用して設定した値は、更新設定ファイルでの設定をオーバーライドします。

[アップデートのダウンロード] ダイアログボックスの表示を有効にします。true に設定すると、Updater は更新処理の一部としてこのダイアログボックスを表示します。更新設定ファイルで設定することもできます。 このプロパティを使用して設定した値は、更新設定ファイルでの設定をオーバーライドします。

[アップデートのダウンロード] ダイアログボックスの表示を有効にします。true に設定すると、Updater は更新処理の一部としてこれらのダイアログボックスを表示します。更新設定ファイルで設定することもできます。 このプロパティを使用して設定した値は、更新設定ファイルでの設定をオーバーライドします。

[ファイル - 利用可能なアップデート]、[ファイル - 利用可能なアップデートがありません]、および [ファイル - エラー] ダイアログボックスの表示を有効にします。true に設定すると、Updater は更新処理の一部としてこれらのダイアログボックスを表示します。更新設定ファイルで設定することもできます。 このプロパティを使用して設定した値は、更新設定ファイルでの設定をオーバーライドします。

正常な更新後の最初の実行の場合は true を返し、それ以外の場合は false を返します。Updater は、initialize() メソッドの呼び出し中にこの値を設定します。あるバージョンから別のバージョンにデータを移行する必要がある場合、開発者は isFirstRun が true に設定されているかどうかを検査する必要があります。

関連項目

[アップデートのインストール] ダイアログボックスの表示を有効にします。true に設定すると、Updater は更新処理の一部としてこのダイアログボックスを表示します。更新設定ファイルで設定することもできます。 このプロパティを使用して設定した値は、更新設定ファイルでの設定をオーバーライドします。

Updater がバージョン比較を実行するために使用する必要がある関数。デフォルトでは、更新フレームワークがバージョンの比較を行って、リモートサイトからのバージョンがインストールされているアプリケーションのバージョンより新しいかどうかを判定します。ただし、デフォルトの比較が開発者のバージョン管理方式と一致しない場合があります。このプロパティを設定して、比較を行う新しい関数を提供します。

デフォルトの比較関数は、x.y.z のようなバージョンを受け付けます。x、y、z は文字または数字です。デフォルトの比較関数によって認識されるいくつかの特殊な条件があります。テスト関数がバージョン文字列で "alpha"、"beta" または "rc" を検出した場合、順序は alpha < beta < rc になります。

appUpdate.isNewerVersionFunction = customFn; 

function customFn (currentVersion:String, updateVersion:String):Boolean 
{
    return updateVersion > currentVersion;
}

[予期しないエラー] ダイアログボックスの表示を有効にします。true に設定すると、Application Updater は更新処理の一部としてこのダイアログボックスを表示します。更新設定ファイルで設定することもできます。 このプロパティを使用して設定した値は、更新設定ファイルでの設定をオーバーライドします。

Boolean プロパティ。更新が実行中の場合は true、それ以外の場合は false です。

ユーザーインターフェイスが使用するロケールチェーンを定義する配列。通常、このプロパティを使用するのは JavaScript (HTML) を開発する場合だけです。

Flex を開発する場合は、ResourceManager を使用してロケールチェーンを処理できます。

HTML ベースのアプリケーションの場合、デフォルトでは、言語は Capabilities.languages 配列内のこれらの言語とユーザーインターフェイスでサポートされる 10 の言語の間でソートされます。一致するものが見つからない場合、ユーザーインターフェイスでは英語が使用されます。

この JavaScript の例では、AIR SDK に含まれる AIR HTML ローカライズフレームワークを使用しています。言語のリストと対照して言語をソートし、デフォルトのフォールバック言語として英語を設定しています。

 appUpdater.addResources("ro_RO", {titleCheck: "Titlu", msgCheck: "Mesaj", btnCheck: "Buton"});
  appUpdater.addResources("hu", {titleCheck: "C?m", msgCheck: "?zenet"}); 
  var languages = ["ro", "hu"];
  languages = languages.concat(air.Capabilities.languages);
  var sortedLanguages = air.Localizer.sortLanguagesByPreference(languages, air.Capabilities.language, "en-US");  
  sortedLanguages.push("en-US");
  appUpdater.localeChain = sortedLanguages;

関連項目

アプリケーション記憶領域ディレクトリの前の場所（更新後に変更されている場合）。アプリケーション記憶領域ディレクトリの場所は、証明書の移行を伴うアップグレード後に変更されます。証明書の移行が行われない場合、アプリケーション記憶領域ディレクトリはユーザーがアプリケーションを更新しても変更されません。そして、このプロパティは null に設定されます。このプロパティは、initialize() メソッドの呼び出し中に設定されます。

開発者は、-migrate オプションを使用して AIR ファイルを ADT でパッケージ化した場合、新しい証明書を使用して新しいバージョンの AIR アプリケーションを署名できます。新しいバージョンの AIR アプリケーションが新しい署名による証明書を使用している場合、ユーザーが新しいバージョンをインストールすると、アプリケーションのローカル記憶領域ディレクトリが変更されます。古いアプリケーション記憶領域ディレクトリから新しいアプリケーション記憶領域ディレクトリにデータを転送する場合は、このプロパティを使用します（File.applicationStorageDirectory）。詳しくは、『Adobe AIR 開発者ガイド』の「コマンドラインツールを使用した AIR アプリケーションの作成」の章の「アプリケーション証明書を変更するための AIR ファイルへの署名」を参照してください。

アプリケーションの前のバージョン。このプロパティは、initialize() メソッドの呼び出し中に設定されます。アプリケーションの、アップグレードする前のバージョンを返します。isfirstRun が true の場合にのみ設定され、それ以外の場合は null に設定されます。

更新 URL からダウンロードされた更新記述ファイルのコンテンツ。Updater オブジェクトが updateStatus イベントを送出した後でのみ、このプロパティは null 以外の値になります。

更新記述ファイルの場所。URLRequest のパスとして有効な任意の場所が受け付けられます。Updater に必要な必須の設定はこれだけです。更新 URL は、このプロパティまたは設定ファイルを使用して設定できます。両方の方法を使用して値を設定すると、Updater はこのプロパティを使用して設定した値を使用します。

関連項目

インストールが失敗したかどうかに関係なく、延期された更新があった場合は true を返します。それ以外の場合は false を返します。Updater は、initialize() メソッドの呼び出し中にこのプロパティを設定します。更新のインストールに失敗したかどうかを確認するには、wasPendingUpdate プロパティおよび isFirstRun プロパティを使用します（失敗した場合は、wasPendingUpdate が true に、isFirstRun が false に設定されます）。

関連項目

コンストラクタ関数です。

指定した言語の新しいリソースバンドルを動的に追加します。JavaScript 開発者は、このメソッドを使用して、Application Updater の UI が表示するダイアログボックスに、新しい言語を動的に追加します。Flex を開発する場合は、新しい言語を「ApplicationUpdaterDialogs」リソースバンドルに直接追加できます。

パラメータ

関連項目

更新処理をキャンセルします。このメソッドを呼び出すと、保留状態のダウンロードがキャンセルされ、完全にダウンロードされていないファイルが削除され、周期的なチェックタイマーが再起動されます。

更新処理は、状態マシンが「Unitialized」または「Initializing」状態のときを除き、いつでもキャンセルできます。「Unitialized」または「Initializing」状態のときに更新処理をキャンセルしても、何も行われません。

更新処理を開始します。このメソッドを呼び出しても、周期的なタイマーはキャンセルされません。ただし、実行中の更新処理を検出し、現在の反復をスキップします。

このメソッドは、現在の状態が "Ready" の場合にのみ動作します。

このメソッドを呼び出すと、Updater オブジェクトが次のイベントを送出する場合があります。

Updater を初期化します。このメソッドを呼び出すと、次のことが行われます。

1. 更新フレームワークが初期化され、保留されているすべての更新がサイレントで（かつ同期的に）インストールされます。このメソッドは、アプリケーションを再起動する場合があるので、アプリケーションの起動時に呼び出す必要があります。

2. 延期されている更新があるかどうかをチェックし、ある場合はインストールします。

3. 前の更新がうまくいかなかった場合は、更新ファイルとバージョン情報を記憶域からクリアします。

4. 周期的なタイマーの遅延時間が経過した場合は、更新処理を開始します。それ以外の場合は、周期的なタイマーを開始します。ただし、AIR Debug Launcher（ADL）アプリケーションを使用してアプリケーションをテストしている場合は、アプリケーションの更新を試みると IllegalOperationError 例外が発生します。

ローカル AIR ファイルを使用して Update プロセスを開始します。

更新処理が実行中の場合（状態が "Downloaded" でない場合）、このメソッドを呼び出しても何も行われません。

この機能は、アプリケーション記述ファイルで customUpdateUI 要素が true に設定されているアプリケーションに対して役に立ちます。

AIR Debug Launcher（ADL）アプリケーションを使用してアプリケーションをテストしているときに、このメソッドを呼び出すと、IllegalOperationError 例外が発生します。

パラメータ

更新をインストールする直前で、installUpdate() メソッドを呼び出した後に送出されます。更新のインストールのためにランタイムがアプリケーションを終了するとユーザーが現在行っている作業が失われる可能性があるため、この時点で更新のインストールを中止すると便利な場合があります。

このイベントの preventDefault() メソッドを呼び出すと、インストールは次の再起動まで延期されます。preventDefault() メソッドを呼び出した場合は、このアプリケーションのセッション中に、（installUpdate() メソッドの呼び出しを通じて、または周期的なチェックによって）これ以上更新処理が開始されることはありません。

このイベントには、次のプロパティがあります。

更新処理の開始時、Updater が更新記述ファイルのダウンロードを試みる直前に送出されます。Updater は、checkNow() メソッドの直接呼び出しの結果として、または周期的なチェックタイマーが時間切れになった場合に、このイベントを送出できます。

このイベントには、次のプロパティがあります。

更新ファイルのダウンロードが完了すると送出されます。

このイベントには、次のプロパティがあります。

更新ファイルの接続中またはダウンロード中にエラーが発生した場合に送出されます。無効な HTTP ステータス (404 - File not found など) に対しても送出されます。

このイベントが送出されると、周期的なタイマーは自動的に再起動されます（遅延が 0 より大きい場合）。

DownloadErrorEvent オブジェクトの errorID プロパティは、エラー情報を定義する整数です（次の表を参照）。追加の subErrorID プロパティに、さらにエラー情報が含まれる場合があります。

downloadUpdate() メソッドが呼び出され、サーバーへの接続が確立された後で送出されます。ApplicationUpdater ライブラリを使用しているときは、このイベントのイベントハンドラを使用して、ダウンロードの進捗をユーザーに示すプログレスバーを表示できます。

このイベントには、次のプロパティがあります。

初期化中または更新処理中にエラーが発生した場合 (何か予期しないことが発生した場合) に送出されます。

このイベントには、次のプロパティがあります。

airFile パラメータ（installFromAIRFile() メソッドの呼び出しで使用）として渡されたファイルの検証でエラーが発生した場合に送出されます。

installFromAIRFile() メソッドの呼び出しで Updater がファイルの検証に成功した後に送出されます。

このイベントには、次のプロパティがあります。

初期化が完了した後に送出されます。

このイベントには、次の読み取り専用プロパティがあります。

• isFirstRun (Boolean) 正常な更新の後で最初の実行の場合は true、それ以外の場合は false。

• previousVersion（String）アプリケーションのアップグレード前のバージョン（isfirstRun が true の場合にのみ設定されます）。

• currentVersion (String) 現在インストールされているアプリケーション記述ファイルのバージョン。

このイベントには、次のプロパティがあります。

初期化が完了した後に送出されます。

このイベントには、次のプロパティがあります。

更新記述ファイルをダウンロードまたは解析しようとしてエラーが発生した場合に送出されます。

Updater がこのイベントを送出すると、周期的なタイマーは自動的に再起動されます（遅延の設定が 0 より大きい場合）。Updater が新しい checkForUpdate イベントを送出した場合、アプリケーションではすべてのエラーダイアログボックスを非表示にすることを検討する必要があります。

Updater が更新記述ファイルを正常にダウンロードして解釈した後で送出されます。

このイベントには、次のプロパティがあります。