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（デフォルト値）は、タイマーがアクティブではないため、周期的なチェックが行われないことを示します。この delay は、このプロパティまたは設定ファイルを使用して設定できます。両方の方法を使用して値を設定すると、このプロパティを使用して設定した値が使用されます。

デフォルト値 : 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() メソッドの呼び出し中に設定されます。

開発者は AIR ファイルと ADT をパッケージ化するときに -migrate オプションを使用すると、新しい証明書を使用して 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 を開発する場合はこのメソッドを使用して、アプリケーションの Updater UI に表示されるダイアログボックスの新しい言語を動的に追加します（Flex を開発する場合は、新しい言語を「ApplicationUpdaterDialogs」リソースバンドルに直接追加できます）。

パラメータ

関連項目

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

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

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

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

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

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

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

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

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

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

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

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

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

パラメータ

更新をインストールする直前で、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 が更新記述ファイルを正常にダウンロードして解釈した後で送出されます。

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