更新框架的 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
元素以与 Web 服务器上的更新描述符文件的最终位置相一致(请参阅下一过程)。
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 应用程序添加到 Web 服务器:
-
将更新版本的 AIR 文件置于 Web 服务器上。
-
创建名为 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 文件的同一个 Web 服务器目录。
这是一个基本示例,但它提供的更新功能可以满足许多应用程序的需要。本文档的其余部分介绍了如何使用更新框架以最好地满足您的需要。
有关使用更新框架的其他示例,请参阅 Adobe AIR 开发人员中心中的以下示例应用程序:
|
|
|