基本範例:使用 ApplicationUpdaterUI 版本

更新架構的 ApplicationUpdaterUI 版本提供了基本介面,可讓您輕鬆應用於應用程式中。以下提供一個基本範例。

首先,建立一個呼叫更新架構的 AIR 應用程式:

  1. 如果您的應用程式是 HTML 類型的 AIR 應用程式,請載入 applicationupdaterui.swf 檔案:

    <script src="ApplicationUpdater_UI.swf" type="application/x-shockwave-flash"/>
  2. 在 AIR 應用程式的程式邏輯中,實體化 ApplicationUpdaterUI 物件。

    在 ActionScript 中,請使用下列程式碼:

    var appUpdater:ApplicationUpdaterUI = new ApplicationUpdaterUI(); 

    在 JavaScript 中,請使用下列程式碼:

    var appUpdater = new runtime.air.update.ApplicationUpdaterUI(); 

    您可以將此程式碼加入至會在應用程式載入時執行的初始化函數。

  3. 建立一個名為 updateConfig.xml 的文字檔,然後在檔案中加入下列內容:

    <?xml version="1.0" encoding="utf-8"?> 
    <configuration xmlns="http://ns.adobe.com/air/framework/update/configuration/1.0"> 
         <url>http://example.com/updates/update.xml</url> 
        <delay>1</delay> 
    </configuration>

    編輯 updateConfig.xml 檔案的 URL 元素,使其符合更新描述器檔案在您網站伺服器上的最終位置 (請參閱下一個程序)。

    delay 為應用程式檢查更新的間隔天數。

  4. 將 updateConfig.xml 檔案加入 AIR 應用程式的專案目錄。

  5. 讓 Updater 物件參照 updateConfig.xml 檔案,並呼叫物件的 initialize() 方法。

    在 ActionScript 中,請使用下列程式碼:
    appUpdater.configurationFile = new File("app:/updateConfig.xml"); 
    appUpdater.initialize();
    在 JavaScript 中,請使用下列程式碼:
    appUpdater.configurationFile = new air.File("app:/updateConfig.xml"); 
    appUpdater.initialize();
  6. 建立第二個 AIR 應用程式版本,其版本應與第一個應用程式不同 (版本會在應用程式描述器檔案的 version 元素中指定)。

接著,將 AIR 應用程式更新版本放到您的網站伺服器:

  1. 將 AIR 檔案的更新版本放到網站伺服器。

  2. 建立一個名為 updateDescriptor.2.5.xml 的文字檔,然後在檔案中加入下列內容:

    <?xml version="1.0" encoding="utf-8"?> 
         <update xmlns="http://ns.adobe.com/air/framework/update/description/2.5"> 
           <versionNumber>1.1</versionNumber> 
           <url>http://example.com/updates/sample_1.1.air</url> 
           <description>This is the latest version of the Sample application.</description> 
        </update>

    編輯 updateDescriptor.xml 檔案的 versionNumber URL description ,使其符合更新 AIR 檔案。使用 AIR 2.5 SDK (及更新的版本) 隨附更新架構的應用程式會使用這個更新描述器格式。

  3. 建立一個名為 updateDescriptor.1.0.xml 的文字檔,然後在檔案中加入下列內容:

    <?xml version="1.0" encoding="utf-8"?> 
         <update xmlns="http://ns.adobe.com/air/framework/update/description/1.0"> 
           <version>1.1</version> 
           <url>http://example.com/updates/sample_1.1.air</url> 
           <description>This is the latest version of the Sample application.</description> 
        </update>

    編輯 updateDescriptor.xml 檔案的 version URL description ,使其符合更新 AIR 檔案。使用 AIR 2 SDK (及更早的版本) 隨附更新架構的應用程式會使用這個更新描述器格式。

    備註: 只有當您要支援在 AIR 2.5 之前建立的應用程式更新時,才需要建立第二個更新描述器檔案。
  4. 請將 updateDescriptor.2.5.xml 與 updateDescriptor.1.0.xml 檔案加入包含更新 AIR 檔案的相同網站伺服器目錄。

雖然這是一個基本範例,但所提供的更新功能已足以應付許多應用程式的需求。本文件稍後的部分將說明如何讓更新架構最滿足您的需求。

如需其他有關使用更新架構的範例,請參閱位於 Adobe AIR 開發人員中心的下列樣本應用程式: