定義更新描述器檔案並將 AIR 檔案加入您的網站伺服器

使用 AIR 更新架構時,您將在更新描述器檔案中定義可用更新的基本資訊,而該檔案會儲存在網站伺服器上。更新描述器檔案是一個簡單的 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 或更新版本的更新程式架構所建立的 AIR 應用程式只能讀取 2.5 版本的更新描述器。因為這個版本的不相容性,您通常需要建立兩個更新描述器檔案。應用程式 AIR 2.5 版本中的更新邏輯,必須下載使用新格式的更新描述器。舊版的 AIR 應用程式必須繼續使用原始格式。您發行的每個更新都必須修改這兩個檔案 (直到您停止支援在 AIR 2.5 之前建立的版本)。

更新描述器檔案包含下列資料:

  • versionNumber —AIR 應用程式的新版本。使用更新描述器中的 versionNumber 元素來更新 AIR 2.5 應用程式。此值必須與新 AIR 應用程式描述器檔案的 versionNumber 元素中所使用的字串相同。如果更新描述器檔案中的版本號碼不符合更新 AIR 檔案的版本號碼,更新架構就會擲出例外。

  • version —AIR 應用程式的新版本。使用更新描述器中的 version 元素來更新在 AIR 2.5 之前建立的更新應用程式。此值必須與新 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 檔案一起放到網站伺服器上。

更新描述器所附的 templates 目錄包含更新描述器檔案的樣本,這些樣本同時提供單一語言和多語言版本。