Простой пример: использование версии ApplicationUpdaterUI (с интерфейсом пользователя)

Входящая в инфраструктуру обновления версия файла ApplicationUpdater с интерфейсом пользователя предлагает простой интерфейс, который можно использовать в приложении. Далее приведен простейший пример его использования.

Вначале создайте приложение AIR, которое вызывает инфраструктуру обновления.

  1. Если это HTML-приложение AIR, загрузите файл applicationupdaterui.swf:

    <script src="ApplicationUpdater_UI.swf" type="application/x-shockwave-flash"/>
  2. Инициируйте объект ApplicationUpdaterUI в программной логике приложения AIR.

    В 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>

    Отредактируйте элемент URL файла updateConfig.xml в соответствии с фактическим местоположением файла дескриптора на веб-сервере (см. следующую процедуру).

    Свойство delay указывает число дней, которое приложение ждет, прежде чем выполнить следующую проверку наличия обновлений.

  4. Добавьте файл updateConfig.xml к каталогу проекта своего приложения AIR.

  5. Проверьте ссылку на файл updateConfig.xml в объекте Updater и вызовите для него метод 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 на веб-сервер.

  1. Поместите на веб-сервер обновленную версию файла AIR.

  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>

    Отредактируйте значения versionNumber , URL и description в файле updateDescriptor.xml для соответствия с обновленным файлом 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>

    Отредактируйте значения version , URL и description в файле updateDescriptor.xml для соответствия с обновленным файлом AIR. Данный формат дескриптора обновления используется приложением, в которых применяется инфраструктура обновления, включенная в пакет AIR 2 SDK (и более ранние версии).

    Примечание. Второй файл дескриптора обновления требуется создавать только в случаях, когда реализуется поддержка обновлений для приложений, разработанных с помощью версий до AIR 2.5.
  4. Добавьте файлы updateDescriptor.2.5.xml и updateDescriptor.1.0.xml в тот же каталог на веб-сервере, в котором содержится файл обновления AIR.

Это простейший пример, но в нем показано, как работает функция обновления, очень важная для многих приложений. В оставшейся части этого документа описывается, как оптимально использовать инфраструктуру обновления.

Другой пример использования инфраструктуры обновления см. в следующем демонстрационном приложении в центре разработки Adobe AIR: