Определение файла дескриптора обновления и добавление файла 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, созданные в версии среды до AIR 2.5, могут считывать только дескриптор обновления версии 1.0. Приложения AIR, созданные с использованием инфраструктуры обновления, включенной в AIR 2.5 и более поздние версии, могут считывать только дескриптор обновления версии 2.5. По причине несовместимости версий часто требуется создавать два файла дескриптора обновления. В соответствии с логикой обновления в версиях AIR 2.5 необходимо загрузить дескриптор обновления, который использует новый формат. В более ранних версиях приложения AIR следует по-прежнему использовать исходный формат. Для каждого выпускаемого обновления требуется изменять оба файла (до тех пор, пока поддерживаются версии, созданные с помощью AIR версии до 2.5).

Файл дескриптора обновления содержит следующие данные:

  • versionNumber — новая версия приложения AIR. Используйте элемент versionNumber в дескрипторе обновления, который применяется для обновления приложений AIR 2.5. В качестве значения следует использовать строку из элемента versionNumber нового файла дескриптора приложения AIR. Если версия в файле дескриптора обновления не соответствует версии обновленного файла AIR, инфраструктура обновления вызывает исключение.

  • version — новая версия приложения AIR. Используйте элемент version в дескрипторе обновления для приложений, созданных в среде AIR до версии 2.5. В качестве значения следует использовать строку из элемента version нового файла дескриптора приложения AIR. Если версия в файле дескриптора обновления не соответствует версии обновленного файла 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 для нескольких языков, используйте несколько элементов text , определяющих атрибут lang . 

<?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 также располагаются демонстрационные файлы дескриптора обновления. Среди них есть дескрипторы для одного языка и для нескольких языков.