Updater  - AS3

如果目前的平台提供 Updater 類別，則 isSupported 屬性會設為 true，否則會設為 false。

Updater 類別的建構函數。請注意，update() 方法並非該類別的靜態成員。您必須將 Updater 物件實體化，然後再對它呼叫 update() 方法。

使用指定之 AIR 檔案中內含的應用程式版本來更新目前執行的應用程式。AIR 檔案中的應用程式必須具有與目前正在執行之應用程式相同的應用程式識別名稱 (appID)。

呼叫此方法會導致應用程式結束 (如同呼叫 NativeApplication.exit() 方法一樣)。由於在應用程式執行期間，Adobe AIR 無法完整更新應用程式，因此這麼做是必要的。一旦成功安裝新版應用程式，此應用程式便會啟動。如果執行階段無法成功安裝新的版本 (例如，它的應用程式 ID 與現有的版本不符)，AIR 安裝程式會出現錯誤訊息告知使用者，然後舊版便會重新啟動。

不管更新是否成功，更新程序都會重新啟動應用程式。有很多因素都會導致更新失敗，其中有些是應用程式無法控制的因素 (例如，使用者沒有足夠的權限安裝應用程式)。應用程式應該注意偵測是否發生失敗，並且避免重複嘗試相同的失敗更新程序。如果造成無窮迴圈，則會完全停用應用程式的功能。檢查更新是否成功的其中一種方式，就是先將目前的版本號碼寫入檔案再開始更新，然後再比對該號碼與重新啟動後的應用程式版本號碼。

使用 AIR Debug Launcher (ADL) 應用程式測試應用程式時，呼叫 update() 方法會導致 IllegalOperationError 例外狀況。

若要在 Mac OS 中安裝更新版的應用程式，使用者必須具有適當的系統權限，才能在應用程式目錄內進行安裝。在 Windows 或 Linux 中，使用者則必須具有系統管理權限。

如果更新版的應用程式需要更新版的執行階段，則會安裝新的執行階段版本。若要更新執行階段，使用者必須具有電腦的系統管理權限。

注意：基於安全性理由，您必須指定 version 參數。藉由在 AIR 檔案中要求應用程式必須確認版本號碼的方式，應用程式將不會誤裝舊的版本，如此便可能包含已修正的安全性弱點。

參數

相關 API 元素

import flash.fileSystem.File;
import flash.desktop.Updater;
 
var updater:Updater = new Updater();
var airFile:File = File.applicationStorageDirectory.resolvePath("Example Application.air");
var version:String = "2.01";
updater.update(airFile, version);