更新架構的 ApplicationUpdaterUI 版本提供了基本介面,可讓您輕鬆應用於應用程式中。以下提供一個基本範例。
首先,建立一個呼叫更新架構的 AIR 應用程式:
-
如果您的應用程式是 HTML 類型的 AIR 應用程式,請載入 applicationupdaterui.swf 檔案:
<script src="ApplicationUpdater_UI.swf" type="application/x-shockwave-flash"/>
-
在 AIR 應用程式的程式邏輯中,實體化 ApplicationUpdaterUI 物件。
在 ActionScript 中,請使用下列程式碼:
var appUpdater:ApplicationUpdaterUI = new ApplicationUpdaterUI();
在 JavaScript 中,請使用下列程式碼:
var appUpdater = new runtime.air.update.ApplicationUpdaterUI();
您可以將此程式碼加入至會在應用程式載入時執行的初始化函數。
-
建立一個名為 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
為應用程式檢查更新的間隔天數。
-
將 updateConfig.xml 檔案加入 AIR 應用程式的專案目錄。
-
讓 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();
-
建立第二個 AIR 應用程式版本,其版本應與第一個應用程式不同 (版本會在應用程式描述器檔案的
version
元素中指定)。
接著,將 AIR 應用程式更新版本放到您的網站伺服器:
-
將 AIR 檔案的更新版本放到網站伺服器。
-
建立一個名為 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 (及更新的版本) 隨附更新架構的應用程式會使用這個更新描述器格式。
-
建立一個名為 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 之前建立的應用程式更新時,才需要建立第二個更新描述器檔案。
-
請將 updateDescriptor.2.5.xml 與 updateDescriptor.1.0.xml 檔案加入包含更新 AIR 檔案的相同網站伺服器目錄。
雖然這是一個基本範例,但所提供的更新功能已足以應付許多應用程式的需求。本文件稍後的部分將說明如何讓更新架構最滿足您的需求。
如需其他有關使用更新架構的範例,請參閱位於 Adobe AIR 開發人員中心的下列樣本應用程式:
|
|
|