基本示例:使用 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 元素以与 Web 服务器上的更新描述符文件的最终位置相一致(请参阅下一过程)。

    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 应用程序添加到 Web 服务器:

  1. 将更新版本的 AIR 文件置于 Web 服务器上。

  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 文件的同一个 Web 服务器目录。

这是一个基本示例,但它提供的更新功能可以满足许多应用程序的需要。本文档的其余部分介绍了如何使用更新框架以最好地满足您的需要。

有关使用更新框架的其他示例,请参阅 Adobe AIR 开发人员中心中的以下示例应用程序: