定义更新描述符文件并将 AIR 文件添加到 Web 服务器

在使用 AIR 更新框架时，您可以在存储于 Web 服务器的更新描述符文件中定义关于可用更新的基本信息。更新描述符文件是简单的 XML 文件。包括在应用程序中的更新框架可对此文件进行检查，以查看是否已上载新的版本。

AIR 2.5 中的更新描述符文件格式已更改。新的格式使用不同的命名空间。原来的命名空间是“http://ns.adobe.com/air/framework/update/description/1.0”。AIR 2.5 命名空间是“http://ns.adobe.com/air/framework/update/description/2.5”。

在 AIR 2.5 之前创建的 AIR 应用程序只能读取 1.0 版更新描述符。使用 AIR 2.5 或更新版本中包括的 updater 框架创建的 AIR 应用程序只能读取 2.5 版更新描述符。由于此版本不兼容性，您通常需要创建两个更新描述符文件。应用程序的 AIR 2.5 版本中的更新逻辑必须下载使用新格式的更新描述符。AIR 应用程序的先前版本必须继续使用原来的格式。每次发行更新时，必须同时修改这两个文件（直到不再支持在 AIR 2.5 之前创建的版本为止）。

更新描述符文件包含以下数据：

  • versionNumber — AIR 应用程序的新版本。在用于更新 AIR 2.5 应用程序的更新描述符中使用 versionNumber 元素。该值必须与新 AIR 应用程序描述符文件的 versionNumber 元素中使用的字符串相同。如果更新描述符文件中的版本号与更新 AIR 文件的版本号不一致，则更新框架将引发异常。

  • version — AIR 应用程序的新版本。使用用于更新在 AIR 2.5 之前创建的应用程序的更新描述符中的 version 元素。该值必须与新 AIR 应用程序描述符文件的 version 元素中使用的字符串相同。如果更新描述符文件中的版本与更新 AIR 文件的版本不一致，则更新框架将引发异常。

  • versionLabel — 要向用户显示的人工可读版本字符串。 versionLabel 是可选的，但是只能在 2.5 版更新描述符文件中指定。如果在应用程序描述符中使用 versionLabel 并将其设为相同的值，则使用该字符串。

  • url — 更新 AIR 文件的位置。此文件包含更新版本的 AIR 应用程序。

  • description — 有关新版本的详细信息。在更新过程中可以向用户显示此信息。

version 和 url 元素是必需的，而 description 元素为可选元素。

下面是一个 2.5 示例版更新描述符文件： 

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

并且，下面是一个示例 1.0 版更新描述符文件： 

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

如果您希望使用多种语言定义 description 标记，请使用定义 lang 属性的多个 text 元素： 

<?xml version="1.0" encoding="utf-8"?> 
     <update xmlns="http://ns.adobe.com/air/framework/update/description/2.5"> 
       <versionNumber>1.1.1</versionNumber> 
       <url>http://example.com/updates/sample_1.1.1.air</url> 
       <description> 
           <text xml:lang="en">English description</text> 
           <text xml:lang="fr">French description</text> 
           <text xml:lang="ro">Romanian description</text> 
       </description> 
    </update>

将更新描述符文件随更新 AIR 文件一起放置在 Web 服务器上。

更新描述符随附的模板目录包括示例更新描述符文件。这些文件包括单语言和多语言版本。