Определение параметров обновления в файле конфигурации XML

Конфигурационный файл обновления — это XML-файл. В нем содержатся следующие элементы:

updateURL — Значение типа String. Задает местоположения дескриптора обновления на удаленном сервере. Разрешено любое допустимое местоположение URLRequest. Необходимо определить свойство updateURL либо с помощью файла конфигурации, либо с помощью сценария (см. раздел « Определение файла дескриптора обновления и добавление файла AIR на веб-сервер »). Необходимо определить это свойство до того, как будет использоваться объект updater (перед вызовом метода initialize() для объекта updater, описанного в разделе Инициализация инфраструктуры обновления ).
delay — Значение типа Number. Задает интервал времени в днях (разрешены такие значения, как 0.25 ) для проверки наличия обновлений. Значение 0 (задаваемое по умолчанию) означает, что объект updater не выполняет периодической автоматической проверки.

Файл конфигурации для класса ApplicationUpdaterUI может содержать следующий элемент в дополнение к элементам updateURL и delay .

defaultUI : Список элементов dialog . Каждый элемент dialog имеет атрибут name , соответствующий диалоговому окну в интерфейсе пользователя. Каждый элемент dialog имеет атрибут visible , определяющий, видимо ли это диалоговое окно. Значение по умолчанию — true . Для атрибута name возможны следующие значения:
- "checkForUpdate" — Соответствует диалоговым окнам «Проверка обновления», «Нет обновлений» и «Ошибка обновления»
- "downloadUpdate" — Соответствует диалоговому окну «Загрузка обновления»
- "downloadProgress" — Соответствует диалоговым окнам «Выполнение загрузки» и «Ошибка загрузки»
- "installUpdate" — Соответствует диалоговому окну «Установка обновления»
- "fileUpdate" — Соответствует диалоговым окнам «Обновление файла», «Без обновления файла» и «Ошибка файла»
"unexpectedError" — Соответствует диалоговому окну «Непредвиденная ошибка»

Если установлено значение false , соответствующее диалоговое окно не отображается в ходе процедуры обновления.

Здесь приведен пример файла конфигурации для инфраструктуры ApplicationUpdater.

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

Здесь приведен пример файла конфигурации для инфраструктуры ApplicationUpdaterUI, которая содержит определение элемента defaultUI .

<?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> 
      <defaultUI> 
         <dialog name="checkForUpdate" visible="false" /> 
         <dialog name="downloadUpdate" visible="false" /> 
         <dialog name="downloadProgress" visible="false" /> 
      </defaultUI> 
</configuration>

Укажите местоположение этого файла в свойстве configurationFile :

Пример ActionScript:

appUpdater.configurationFile = new File("app:/cfg/updateConfig.xml");

Пример JavaScript:

appUpdater.configurationFile = new air.File("app:/cfg/updateConfig.xml");

Каталог templates инфраструктуры обновления содержит демонстрационный файл конфигурации config-template.xml.