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>
  </configuration>

設定ファイルを読み込む代わりに、ActionScript コードを使用して、delay プロパティと updateURL プロパティを設定できます。

関連項目

Updater の内部状態です。プロパティは、次の値に設定できます。

• 「UNINITIALIZED」：Updater は初期化されていません。

• 「INITIALIZING」：Updater は初期化中です。

• 「READY」：Updater は初期化が済んでいます。

• 「BEFORE_CHECKING」：Updater はまだ更新記述ファイルを検査していません。

• 「CHECKING」：Updater は更新記述ファイルを検査しています。

• 「AVAILABLE」：更新記述ファイルは使用できます。

• 「DOWNLOADING」：Updater は AIR ファイルをダウンロードしています。

• 「DOWNLOADED」：Updater は AIR ファイルをダウンロードしました。

• 「INSTALLING」：Updater は AIR ファイルをインストールしています。

• 「PENDING_INSTALLING」：Updater は初期化を終了し、保留状態の更新があります。

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

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

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

デフォルト値 : 0.

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

関連項目

バージョン比較を実行するために 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;
}

アプリケーションの記憶領域ディレクトリの以前の場所です（更新後に変更された場合）。アプリケーションの記憶領域ディレクトリの場所は、証明書が移行されるアップグレードの後に変更されます。証明書が移行されない場合、ユーザーがアプリケーションを更新してもアプリケーションの記憶領域ディレクトリは変更されません。このプロパティは 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 に設定されます）。

関連項目

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

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

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

更新記述ファイルを非同期にダウンロードして解釈します。このメソッドを呼び出すと、更新状態は「CHECKING」に移行します。このメソッドは、checkForUpdate イベントをキャンセルした場合にのみ呼び出してください。

このメソッドは、Updater が「BEFORE_CHECKING」状態の場合にのみ動作します。

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

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

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

更新ファイルを非同期にダウンロードします。このメソッドを呼び出すと、更新状態は「DOWNLOADING」に移行します。イベントの available プロパティが true のときに StatusUpdateEvent.UPDATE_STATUS イベントをキャンセルした場合にのみ、このメソッドを呼び出す必要があります。

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

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

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

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

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

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

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

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

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

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

パラメータ

更新ファイルをインストールします。このメソッドを呼び出すと状態マシンは「INSTALLING」に進み、downLoadComplete イベントをキャンセルした場合にのみ呼び出す必要があります。

このメソッドは、Updater が「DOWNLOADED」状態のときに呼び出します。他の状態で呼び出しても何も行いません。

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

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

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

ApplicationUpdater ライブラリのデフォルトの動作では、更新記述ファイルがダウンロードされます。preventDefault() メソッドを呼び出して、この動作をキャンセルできます。

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

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

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

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

通常は、更新のインストールを続行するかどうかをユーザーに確認するメッセージを表示する場合に、このイベントを使用します。

ApplicationUpdater ライブラリのデフォルトの動作では、installUpdate() メソッドが自動的に呼び出されます。

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

StatusUpdateEvent オブジェクトの使用可能なプロパティの available が true に設定されている場合、デフォルトの動作では更新のダウンロードが開始されます。デフォルトの動作を回避できるのは、ApplicationUpdatorUI クラスを使用している場合ではなく、ApplicationUpdater クラスを使用している場合のみです。

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