Входящая в инфраструктуру обновления версия файла ApplicationUpdater с интерфейсом пользователя предлагает простой интерфейс, который можно использовать в приложении. Далее приведен простейший пример его использования.
Вначале создайте приложение AIR, которое вызывает инфраструктуру обновления.
-
Если это HTML-приложение AIR, загрузите файл applicationupdaterui.swf:
<script src="ApplicationUpdater_UI.swf" type="application/x-shockwave-flash"/>
-
Инициируйте объект ApplicationUpdaterUI в программной логике приложения AIR.
В ActionScript используйте следующий программный код.
var appUpdater:ApplicationUpdaterUI = new ApplicationUpdaterUI();
В JavaScript используйте следующий программный код.
var appUpdater = new runtime.air.update.ApplicationUpdaterUI();
Возможно, потребуется добавить этот код в функцию инициализации, которая выполняется при загрузке приложения.
-
Создайте текстовый файл с именем 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
указывает число дней, которое приложение ждет, прежде чем выполнить следующую проверку наличия обновлений.
-
Добавьте файл updateConfig.xml к каталогу проекта своего приложения AIR.
-
Проверьте ссылку на файл 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();
-
Создайте вторую версию приложения AIR, отличающуюся номером версии от первого приложения. (Версия указывается в файле дескриптора приложения, в элементе
version
.)
Затем добавьте обновленную версию приложения AIR на веб-сервер.
-
Поместите на веб-сервер обновленную версию файла AIR.
-
Создайте текстовый файл с именем 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 (и более поздние версии).
-
Создайте текстовый файл с именем 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.
-
Добавьте файлы updateDescriptor.2.5.xml и updateDescriptor.1.0.xml в тот же каталог на веб-сервере, в котором содержится файл обновления AIR.
Это простейший пример, но в нем показано, как работает функция обновления, очень важная для многих приложений. В оставшейся части этого документа описывается, как оптимально использовать инфраструктуру обновления.
Другой пример использования инфраструктуры обновления см. в следующем демонстрационном приложении в центре разработки Adobe AIR:
|
|
|