| Пакет | air.update |
| Класс | public class ApplicationUpdater |
| Наследование | ApplicationUpdater  EventDispatcher Object |
| Язык версии: | ActionScript 3.0 |
| Версии среды выполнения: | AIR 1.5 |
Этот класс включен в файл applicationupdater_ui.swc, который входит в Adobe® Flex™ SDK. applicationupdater_ui.swc файл находится в каталоге оболочек/освобо/воздуха SDK AIR.
Adobe® Flex™ Builder™ загружает этот класс автоматически при создании проекта для Adobe AIR. Вы должны включить файл SWC, компилируя программу, использующую Adobe ® Flex ™ SDK.
Управление обновлениями приложений может оказаться непростой задачей. Инфраструктура обновления AIR предоставляет API-интерфейсы, позволяющие разработчикам внедрить хорошие возможности обновления в приложения AIR. Функциональная инфраструктура обновления AIR предоставляет разработчикам следующие возможности.
-
Периодическая проверка наличия обновлений по расписанию или по запросу пользователя.
-
Загрузка файлов AIR (обновлений) из веб-источника.
-
Оповещение пользователя о первом запуске вновь установленной версии.
-
Запрос на подтверждение проверки наличия обновлений пользователем.
-
Отображение информации о версии обновления для пользователя.
-
Отображение хода загрузки и информации об ошибках для пользователя.
Инфраструктура обновления AIR позволяет сохранять информацию о версии обновления приложения AIR в простых XML-файлах конфигурации. Благодаря настройке файлов конфигурации и вставке основного кода большинство приложений способны предложить своим конечным пользователям хорошие функциональные возможности обновления.
С помощью класса AIRUpdater можно определить собственный пользовательский интерфейс для использования в инфраструктуре обновления AIR.
Процесс обновления включает в себя ряд состояний. Свойство currentState объекта программы обновления отражает текущее состояние программы обновления:
| Значение currentState | Описание |
|---|---|
| UNINITIALIZED | Программа обновления не инициализирована. |
| INITIALIZING | Выполняется инициализация программы обновления. |
| READY | Программа обновления инициализирована. |
| BEFORE_CHECKING | Программа обновления еще не выполнила проверку наличия файла дескриптора обновления. |
| CHECKING | Программа обновления выполняет проверку наличия файла дескриптора обновления. |
| AVAILABLE | Обнаружен доступный файл дескриптора обновления. |
| DOWNLOADING | Программа обновления выполняет загрузку файла AIR. |
| DOWNLOADED | Программа обновления завершила загрузку файла AIR. |
| INSTALLING | Программа обновления выполняет установку файла AIR. |
| PENDING_INSTALLING | Программа обновления инициализирована. Имеются обновления, ожидающие установки. |
Однако при тестировании приложения в программе AIR Debug Launcher (ADL) попытка обновить приложение приводит к исключению IllegalOperationError.
Структура обновления AIR поддерживается только в профиле рабочего стола. Ее не поддерживают приложения расширенного рабочего стола (которые устанавливаются с помощью собственной программы установки), а также профили мобильных устройств (например, приложения iPhone, написанные с использованием ActionScript 3.0). Во время выполнения проверьте свойство Updater.isSupported, чтобы узнать, поддерживается ли структура обновления.
Для получения подробных сведений об использовании структуры обновления AIR см. главу «Обновление приложений AIR» в публикации Разработка приложений Adobe AIR.
Связанные элементы API
Скрыть унаследованные общедоступные свойства
Показать унаследованные общедоступные свойства| Свойство | Определено | ||
|---|---|---|---|
| configurationFile : File
Местоположение файла конфигурации, в котором заданы значения свойств delay и updateURL. | ApplicationUpdater | ||
 | constructor : Object
Ссылка на объект класса или функцию конструктора для данного экземпляра объекта. | Object | |
| currentState : String [только для чтения]
Внутреннее состояние программы обновления. | ApplicationUpdater | ||
| currentVersion : String [только для чтения]
Текущая версия приложения. | ApplicationUpdater | ||
| delay : Number
Интервал в днях между периодическими проверками наличия новых обновлений. | ApplicationUpdater | ||
| isFirstRun : Boolean [только для чтения]
Является ли этот запуск первым после успешного обновления (true) или нет (false). | ApplicationUpdater | ||
| isNewerVersionFunction : Function
Функция, используемая программой обновления для сравнения версий. | ApplicationUpdater | ||
| previousApplicationStorageDirectory : File [только для чтения]
Предыдущее местоположение каталога хранилища приложения, если оно изменилось после обновления. | ApplicationUpdater | ||
| previousVersion : String [только для чтения]
Предыдущая версия приложения. | ApplicationUpdater | ||
| updateDescriptor : XML [только для чтения]
Содержимое файла дескриптора обновления, загруженного с URL-адреса обновления. | ApplicationUpdater | ||
| updateURL : String
Местоположение файла дескриптора обновления. | ApplicationUpdater | ||
| wasPendingUpdate : Boolean [только для чтения]
Имеется ли отложенное обновление, даже если его не удалось установить (true); в противном случае – false. | ApplicationUpdater | ||
| Метод | Определено | ||
|---|---|---|---|
Функция конструктора. | ApplicationUpdater | ||
| addEventListener(type:String, listener:Function, useCapture:Boolean = false, priority:int = 0, useWeakReference:Boolean = false):void
Регистрирует объект прослушивателя события на объекте EventDispatcher для получения прослушивателем уведомления о событии. | EventDispatcher | |
Отменяет процесс обновления. | ApplicationUpdater | ||
Выполняет асинхронную загрузку и интерпретацию файла дескриптора обновления. | ApplicationUpdater | ||
Начинает процесс обновления. | ApplicationUpdater | ||
|
Посылает событие в поток событий. | EventDispatcher | |
Выполняет асинхронную загрузку файла обновления. | ApplicationUpdater | ||
|
Проверяет, имеет ли объект EventDispatcher прослушиватели, зарегистрированные для определенного типа события. | EventDispatcher | |
|
Показывает, определено ли заданное свойство для объекта. | Object | |
Выполняет инициализацию программы обновления. | ApplicationUpdater | ||
Начинает процесс обновления с помощью локального файла AIR. | ApplicationUpdater | ||
Выполняет установку файла обновления. | ApplicationUpdater | ||
|
Показывает, есть ли экземпляр класса Object в цепи прототипов объекта, заданного в качестве параметра. | Object | |
|
Показывает наличие заданного свойства и его перечисляемость. | Object | |
|
Удаляет прослушиватель из объекта EventDispatcher. | EventDispatcher | |
|
Задает доступность динамического свойства для операций цикла. | Object | |
|
Возвращает строковое представление этого объекта, отформатированного в соответствии со стандартами, принятыми для данной локали. | Object | |
|
Возвращает строковое представление заданного объекта. | Object | |
|
Возвращает элементарное значение заданного объекта. | Object | |
|
Проверяет, зарегистрирован ли прослушиватель события для указанного типа события с данным объектом EventDispatcher или любым его предшественником. | EventDispatcher | |
| Событие | Сводка | Определено | ||
|---|---|---|---|---|
| [многоадресное событие] Отправляется, когда проигрыватель Flash Player или приложение AIR перемещается в фокус операционной системы и становится активным. | EventDispatcher | ||
| Отправляется непосредственно перед установкой обновления, после вызова метода installUpdate(). | ApplicationUpdater | |||
| Отправляется до начала процесса обновления, непосредственно перед попыткой программы обновления загрузить файл дескриптора обновления. | ApplicationUpdater | |||
| [многоадресное событие] Отправляется, когда проигрыватель Flash Player или приложение AIR теряет фокус системы и становится неактивным. | EventDispatcher | ||
| Отправляется при завершении загрузки файла обновления. | ApplicationUpdater | |||
| Отправляется в случае ошибки подключения к файлу обновления или его загрузки. | ApplicationUpdater | |||
| Отправляется после вызова метода downloadUpdate() и установки подключения к серверу. | ApplicationUpdater | |||
| Отправляется при возникновении ошибки во время инициализации или процесса обновления (если произошло непредвиденное событие). | ApplicationUpdater | |||
| Отправляется в случае ошибки проверки файла, переданного в качестве параметра airFile в вызов метода installFromAIRFile(). | ApplicationUpdater | |||
| Отправляется после успешной проверки программой обновления файла в вызове метода installFromAIRFile(). | ApplicationUpdater | |||
| Отправляется после завершения инициализации. | ApplicationUpdater | |||
| Загружается файл, отправленный в качестве обновления. | ApplicationUpdater | |||
| Отправляется в случае ошибки загрузки или разбора файла дескриптора обновления. | ApplicationUpdater | |||
| Отправляется после успешной загрузки и интерпретации файла дескриптора обновления программой обновления. | ApplicationUpdater | |||
configurationFile | свойство |
configurationFile:File| Язык версии: | ActionScript 3.0 |
| Версии среды выполнения: | AIR 1.5 |
Местоположение файла конфигурации, в котором заданы значения свойств delay и updateURL. Если свойство указывает на несуществующий файл, вызов метода initialize() приведет к ошибке.
Образец файла конфигурации:
<?xml version="1.0" encoding="utf-8"?>
<configuration xmlns="http://ns.adobe.com/air/framework/update/configuration/1.0" >
<url>app:/server/update.xml</url>
<delay>1</delay>
</configuration>Вместо загрузки файла конфигурации для определения свойств delay и updateURL можно использовать код ActionScript.
Реализация
public function get configurationFile():File public function set configurationFile(value:File):voidСвязанные элементы API
currentState | свойство |
currentState:String [только для чтения] | Язык версии: | ActionScript 3.0 |
| Версии среды выполнения: | AIR 1.5 |
Внутреннее состояние программы обновления. Для этого свойства можно задать следующие значения:
-
UNINITIALIZED– программа обновления не инициализирована. -
INITIALIZING– выполняется инициализация программы обновления. -
READY– программа обновления инициализирована. -
BEFORE_CHECKING– программа обновления еще не выполнила проверку наличия файла дескриптора обновления. -
CHECKING– программа обновления выполняет проверку наличия файла дескриптора обновления. -
AVAILABLE– обнаружен доступный файл дескриптора обновления. -
DOWNLOADING– программа обновления выполняет загрузку файла AIR. -
DOWNLOADED– программа обновления завершила загрузку файла AIR. -
INSTALLING– программа обновления выполняет установку файла AIR. -
PENDING_INSTALLING– программа обновления инициализирована. Имеются обновления, ожидающие установки.
Реализация
public function get currentState():String currentVersion | свойство |
currentVersion:String [только для чтения] | Язык версии: | ActionScript 3.0 |
| Версии среды выполнения: | AIR 1.5 |
Текущая версия приложения. Значение для этого свойства задается во время вызова метода initialize(). Значением свойства является версия, указанная в файле дескриптора приложения.
Реализация
public function get currentVersion():String delay | свойство |
delay:Number| Язык версии: | ActionScript 3.0 |
| Версии среды выполнения: | AIR 1.5 |
Интервал в днях между периодическими проверками наличия новых обновлений.
Значение 0 (по умолчанию) указывает на неактивное состояние таймера, поэтому периодическая проверка не выполняется. Это значение можно задать в данном свойстве или в файле конфигурации. Если значение задано с помощью обоих методов, используется значение, заданное в свойстве.
Значением по умолчанию является 0.
Реализация
public function get delay():Number public function set delay(value:Number):void isFirstRun | свойство |
isFirstRun:Boolean [только для чтения] | Язык версии: | ActionScript 3.0 |
| Версии среды выполнения: | AIR 1.5 |
Является ли этот запуск первым после успешного обновления (true) или нет (false). Программа обновления задает это значение во время вызова метода initialize(). Если требуется выполнить перенос данных из одной версии в другую, разработчик должен убедиться, что для свойства isFirstRun задано значение true.
Реализация
public function get isFirstRun():BooleanСвязанные элементы API
isNewerVersionFunction | свойство |
isNewerVersionFunction:Function| Язык версии: | ActionScript 3.0 |
| Версии среды выполнения: | AIR 1.5 |
Функция, используемая программой обновления для сравнения версий. По умолчанию инфраструктура обновления выполняет сравнение версий с целью определить, является ли версия с удаленного сайта более новой, чем версия установленного приложения. Однако иногда сравнение по умолчанию не соответствует схеме версий разработчика. Задайте для данного свойства новую функцию для выполнения сравнения.
Функция сравнения по умолчанию может работать с версиями формата x.y.z, где элементы x, y и z могут состоять из цифр и букв. Существуют некоторые особые условия, которые учитывает функция сравнения по умолчанию. Если функция проверки обнаруживает alpha, beta или rc в строках версий, принимается порядок alpha < beta < rc.
Реализация
public function get isNewerVersionFunction():Function public function set isNewerVersionFunction(value:Function):voidПример ( Использование этого примера )
customFn для объекта appUpdate программы обновления. Пример функции нарочито простой. Ваша пользовательская функция должна возвращать логическое значение, исходя из правил схемы версий.
appUpdate.isNewerVersionFunction = customFn;
function customFn (currentVersion:String, updateVersion:String):Boolean
{
return updateVersion > currentVersion;
}
previousApplicationStorageDirectory | свойство |
previousApplicationStorageDirectory:File [только для чтения] | Язык версии: | ActionScript 3.0 |
| Версии среды выполнения: | AIR 1.5 |
Предыдущее местоположение каталога хранилища приложения, если оно изменилось после обновления. Каталог хранилища приложения меняет свое местоположение при обновлении с переносом сертификата. Если перенос сертификата не выполняется, то при обновлении приложения пользователем местоположение каталога хранилища приложения не изменяется. и это свойство имеет значение null. Значение для этого свойства задается во время вызова метода initialize().
Разработчик может подписать новую версию приложения AIR с помощью нового сертификата, если при упаковке файла AIR с помощью ADT используется команда -migrate. Если в новой версии приложения AIR используется новый сертификат подписи, локальный каталог хранилища приложения меняет свое местоположение при установке новой версии. С помощью этого свойства можно перенести данные из старого каталога хранилища приложения в новый (File.applicationStorageDirectory). Дополнительную информацию см. в разделе «Подписание файла AIR с изменением сертификата приложения» главы «Создание приложения AIR с использованием инструментов командной строки» в руководстве разработчика Adobe AIR.
Реализация
public function get previousApplicationStorageDirectory():File previousVersion | свойство |
previousVersion:String [только для чтения] | Язык версии: | ActionScript 3.0 |
| Версии среды выполнения: | AIR 1.5 |
Предыдущая версия приложения. Значение для этого свойства задается во время вызова метода initialize(). Возвращает предыдущую версию приложения перед обновлением (задано, только если свойство isfirstRun имеет значение true); в противном случае имеет значение null.
Реализация
public function get previousVersion():String updateDescriptor | свойство |
updateDescriptor:XML [только для чтения] | Язык версии: | ActionScript 3.0 |
| Версии среды выполнения: | AIR 1.5 |
Содержимое файла дескриптора обновления, загруженного с URL-адреса обновления. Это свойство не имеет значение null, только если объект программы обновления отправляет событие updateStatus.
Реализация
public function get updateDescriptor():XML updateURL | свойство |
updateURL:String| Язык версии: | ActionScript 3.0 |
| Версии среды выполнения: | AIR 1.5 |
Местоположение файла дескриптора обновления. Допустимо любое действительное для пути URLRequest местоположение. Это единственная обязательная для программы обновления настройка. URL-адрес обновления можно задать либо в этом свойстве либо в файле конфигурации. Если значение задано с помощью обоих методов, программа обновления использует значение, заданное в свойстве.
Реализация
public function get updateURL():String public function set updateURL(value:String):void wasPendingUpdate | свойство |
wasPendingUpdate:Boolean [только для чтения] | Язык версии: | ActionScript 3.0 |
| Версии среды выполнения: | AIR 1.5 |
Имеется ли отложенное обновление, даже если его не удалось установить (true); в противном случае – false. Программа обновления задает значение для этого свойства во время вызова метода initialize(). С помощью свойств wasPendingUpdate и isFirstRun можно проверить, была ли попытка установки обновления неудачной (в этом случае свойство wasPendingUpdate имеет значение true, а свойство isFirstRun имеет значение false).
Реализация
public function get wasPendingUpdate():BooleanСвязанные элементы API
ApplicationUpdater | () | Конструктор |
public function ApplicationUpdater()| Язык версии: | ActionScript 3.0 |
| Версии среды выполнения: | AIR 1.5 |
Функция конструктора.
cancelUpdate | () | метод |
public function cancelUpdate():void| Язык версии: | ActionScript 3.0 |
| Версии среды выполнения: | AIR 1.5 |
Отменяет процесс обновления. Вызов этого метода отменяет все ожидающие загрузки, удаляя не полностью загруженные файлы, и перезапускает таймер периодической проверки.
Процесс обновления можно отменить в любое время. Исключением являются состояния UNINITIALIZED и INITIALIZING. Вызов этого метода в состоянии UNINITIALIZED или INITIALIZING не работает.
checkForUpdate | () | метод |
public function checkForUpdate():void| Язык версии: | ActionScript 3.0 |
| Версии среды выполнения: | AIR 1.5 |
Выполняет асинхронную загрузку и интерпретацию файла дескриптора обновления. Вызов этого метода меняет состояние программы обновления на CHECKING. Этот метод следует вызывать только при отмене события checkForUpdate.
Этот метод выполняется, только если программа обновления находится в состоянии BEFORE_CHECKING.
События
updateStatus: — Программа обновления успешно загрузила и интерпретировала файл дескриптора обновления.
| |
updateError: — Во время загрузки или разбора файла дескриптора обновления произошла ошибка.
|
checkNow | () | метод |
public function checkNow():void| Язык версии: | ActionScript 3.0 |
| Версии среды выполнения: | AIR 1.5 |
Начинает процесс обновления. Вызов этого метода не останавливает периодический таймер. Однако этот метод определяет, что выполняется процесс обновления, и пропускает текущую итерацию.
Этот метод выполняется только в состоянии READY.
Этот метод может вызвать объект программы обновления, отправляющий следующее событие:
События
checkForUpdate: — Отправляется непосредственно перед началом процесса обновления.
|
downloadUpdate | () | метод |
public function downloadUpdate():void| Язык версии: | ActionScript 3.0 |
| Версии среды выполнения: | AIR 1.5 |
Выполняет асинхронную загрузку файла обновления. Вызов этого метода приводит к изменению состояния на DOWNLOADING. Этот метод следует вызывать только при отмене события StatusUpdateEvent.UPDATE_STATUS, если свойство available этого события имело значение true.
Этот метод выполняется только в состоянии AVAILABLE.
События
downloadStart: — Отправляется после установки подключения к серверу.
| |
progress: — Отправляется после завершения инициализации.
| |
downloadError: — Отправляется в случае ошибки подключения к файлу обновления или его загрузки. Отправляется также для неправильных состояний HTTP (например, 404 – файл не найден).
|
initialize | () | метод |
public function initialize():void| Язык версии: | ActionScript 3.0 |
| Версии среды выполнения: | AIR 1.5 |
Выполняет инициализацию программы обновления. При вызове данного метода происходит следующее:
-
Выполняется инициализация инфраструктуры обновления с автоматической (и синхронной) установкой ожидающих обновлений. Этот метод следует вызывать при запуске приложения, так как он может вызвать перезапуск приложения.
-
Выполняется проверка наличия отложенных обновлений и их установка.
-
Если во время установки предыдущего обновления произошла ошибка, выполняется очистка файла обновления и данных о версии в области хранилища.
-
Если срок задержки периодического таймера истек, начинается процесс обновления; в противном случае запускается периодический таймер. Однако при тестировании приложения в программе AIR Debug Launcher (ADL) попытка обновить приложение приводит к исключению IllegalOperationError.
События
initialized: — Инициализация завершена.
| |
error: — Во время инициализации произошла ошибка.
|
installFromAIRFile | () | метод |
public function installFromAIRFile(file:File):void| Язык версии: | ActionScript 3.0 |
| Версии среды выполнения: | AIR 1.5 |
Начинает процесс обновления с помощью локального файла AIR.
Вызов этого метода не работает, если выполняется процесс обновления (т. е. не в состоянии DOWNLOADED).
Эта функция полезна для приложения, в котором элемент customUpdateUI в файле дескриптора приложения имеет значение true.
При тестировании приложения с помощью AIR Debug Launcher (ADL) вызов этого метода приводит к исключению IllegalOperationError.
Параметры
file:File — Локальный файл AIR для установки.
|
События
fileUpdateStatus: — Отправляется после успешной проверки файла AIR программой обновления.
| |
updateError: — Отправляется в случае ошибки разбора файла дескриптора обновления.
|
installUpdate | () | метод |
public function installUpdate():void| Язык версии: | ActionScript 3.0 |
| Версии среды выполнения: | AIR 1.5 |
Выполняет установку файла обновления. Вызов этого метода изменяет состояние на INSTALLING. Его следует вызывать только при отмене события downLoadComplete.
Этот метод следует вызывать, когда программа обновления находится в состоянии DOWNLOADED. Вызов этого метода в другом состоянии не работает.
При тестировании приложения с помощью AIR Debug Launcher (ADL) вызов этого метода приводит к исключению IllegalOperationError.
События
beforeInstall: — Отправляется непосредственно перед установкой обновления. Иногда необходимо предотвратить установку обновления на этом этапе, так как все результаты текущей работы пользователя могут быть потеряны при выходе среды выполнения из приложения для установки обновления.
|
beforeInstall | Событие |
air.update.events.UpdateEventсвойство UpdateEvent.type =
air.update.events.UpdateEvent.BEFORE_INSTALL| Язык версии: | ActionScript 3.0 |
| Версии среды выполнения: | AIR 1.5 |
Отправляется непосредственно перед установкой обновления, после вызова метода installUpdate(). Иногда необходимо предотвратить установку обновления на этом этапе, так как все результаты текущей работы пользователя могут быть потеряны при выходе среды выполнения из приложения для установки обновления.
Вызов метода preventDefault() этого события позволяет отложить установку до следующего запуска. При вызове метода preventDefault() ни один дополнительный процесс обновления не будет запущен во время данного сеанса работы приложения (путем вызова метода installUpdate() или проверки по расписанию).
Поведением по умолчанию для библиотеки ApplicationUpdater является загрузка файла дескриптора обновления. С помощью вызова метода preventDefault() можно отменить это поведение.
UpdateEvent.BEFORE_INSTALL определяет значение свойства type объекта события beforeInstall.
Это событие имеет следующие свойства:
| Свойство | Значение |
|---|---|
bubbles | false |
cancelable | false; поведение по умолчанию, подлежащее отмене, не определено. |
currentTarget | Объект, активно обрабатывающий объект Event с помощью прослушивателя событий. |
target | Объект обновления. |
checkForUpdate | Событие |
air.update.events.UpdateEventсвойство UpdateEvent.type =
air.update.events.UpdateEvent.CHECK_FOR_UPDATE| Язык версии: | ActionScript 3.0 |
| Версии среды выполнения: | AIR 1.5 |
Отправляется до начала процесса обновления, непосредственно перед попыткой программы обновления загрузить файл дескриптора обновления. Программа обновления может отправить это событие в результате прямого вызова метода checkNow() или по истечении времени, заданного для таймера периодической проверки.
UpdateEvent.CHECK_FOR_UPDATE определяет значение свойства type объекта события checkForUpdate.
Это событие имеет следующие свойства:
| Свойство | Значение |
|---|---|
bubbles | false |
cancelable | false; поведение по умолчанию, подлежащее отмене, не определено. |
currentTarget | Объект, активно обрабатывающий объект Event с помощью прослушивателя событий. |
target | Объект обновления. |
downloadComplete | Событие |
air.update.events.UpdateEventсвойство UpdateEvent.type =
air.update.events.UpdateEvent.DOWNLOAD_COMPLETE| Язык версии: | ActionScript 3.0 |
| Версии среды выполнения: | AIR 1.5 |
Отправляется при завершении загрузки файла обновления.
Как правило, данное событие используется для отображения сообщения с запросом продолжения установки обновления.
Поведением по умолчанию для библиотеки ApplicationUpdater является автоматический вызов метода installUpdate().
UpdateEvent.DOWNLOAD_COMPLETE определяет значение свойства type объекта события downloadComplete.
Это событие имеет следующие свойства:
| Свойство | Значение |
|---|---|
bubbles | false |
cancelable | false; поведение по умолчанию, подлежащее отмене, не определено. |
currentTarget | Объект, активно обрабатывающий объект Event с помощью прослушивателя событий. |
target | Объект обновления. |
downloadError | Событие |
air.update.events.DownloadErrorEventсвойство DownloadErrorEvent.type =
air.update.events.DownloadErrorEvent.DOWNLOAD_ERROR| Язык версии: | ActionScript 3.0 |
| Версии среды выполнения: | AIR 1.5 |
Отправляется в случае ошибки подключения к файлу обновления или его загрузки. Отправляется также для неправильных состояний HTTP (например, 404 – файл не найден).
При отправке этого события периодический таймер автоматически перезапускается (если задержка больше 0).
КонстантаDownloadErrorEvent.DOWNLOAD_ERROR определяет значение свойства type объекта события downloadError.
Свойство errorID объекта DownloadErrorEvent является целым числом, определяющим сведения об ошибке (см. таблицу ниже). Дополнительное свойство subErrorID может содержать более подробные сведения об ошибке.
| Код ошибки errorID | Описание |
|---|---|
| 16800 | Возникает во время проверки загруженного файла обновления. Свойство subErrorID может содержать более подробные сведения. |
| 16801 | Неправильный файл Adobe AIR (отсутствует application.xml). |
| 16802 | Неправильный файл Adobe AIR (отсутствует тип MIME). |
| 16803 | Неправильный файл Adobe AIR (формат). |
| 16804 | Неправильный файл Adobe AIR (недопустимые флаги). |
| 16805 | Неправильный файл Adobe AIR (неизвестный формат сжатия). |
| 16806 | Неправильный файл Adobe AIR (неверное имя файла). |
| 16807 | Неправильный файл Adobe AIR (поврежден). |
| 16808 | Файл конфигурации не существует. |
| 16809 | Не задано свойство updateURL. |
| 16810 | Зарезервировано. |
| 16811 | Неправильный файл конфигурации (неизвестная версия конфигурации) |
| 16812 | Неправильный файл конфигурации (отсутствует URL-адрес). |
| 16813 | Неправильный файл конфигурации (формат задержки) |
| 16814 | Неправильный файл конфигурации (недопустимые значения defaultUI). |
| 16815 | Неправильный дескриптор обновления (неизвестная версия дескриптора). |
| 16816 | Неправильный дескриптор обновления (отсутствует версия обновления). |
| 16817 | Неправильный дескриптор обновления (недопустимое описание). |
| 16818 | Ошибка ввода-вывода при сохранении данных на диск. Свойство subErrorID может содержать более подробные сведения. |
| 16819 | Ошибка безопасности при загрузке. Свойство subErrorID может содержать более подробные сведения. |
| 16820 | Неправильный код состояния HTTP. В свойстве subErrorID может быть указан неверный код состояния. |
| 16821 | Зарезервировано. |
| 16822 | Ошибка ввода-вывода при загрузке. Свойство subErrorID может содержать более подробные сведения. |
| 16823 | Ошибка «конец файла» при сохранении данных на диск. Свойство subErrorID может содержать более подробные сведения. |
| 16824 | Неправильный дескриптор обновления. Свойство subErrorID может содержать более подробные сведения. |
| 16825 | Файл обновления содержит приложение с другим идентификатором приложения. |
| 16826 | Файл обновления не содержит более новую версию приложения. |
| 16827 | Версия, содержащаяся в файле обновления, не совпадает с версией в дескрипторе обновления. |
| 16828 | Не удается обновить приложение. Возможно, приложение выполняется в AIR Debug Launcher (ADL). |
| 16829 | В момент установки отсутствует файл обновления. |
downloadStart | Событие |
air.update.events.UpdateEventсвойство UpdateEvent.type =
air.update.events.UpdateEvent.DOWNLOAD_START| Язык версии: | ActionScript 3.0 |
| Версии среды выполнения: | AIR 1.5 |
Отправляется после вызова метода downloadUpdate() и установки подключения к серверу. При использовании библиотеки ApplicationUpdater обработчик событий для данного события может отображать индикатор выполнения, чтобы пользователь мог следить за ходом загрузки.
UpdateEvent.DOWNLOAD_START определяет значение свойства type объекта события downloadStart.
Это событие имеет следующие свойства:
| Свойство | Значение |
|---|---|
bubbles | false |
cancelable | false; поведение по умолчанию, подлежащее отмене, не определено. |
currentTarget | Объект, активно обрабатывающий объект Event с помощью прослушивателя событий. |
target | Объект обновления. |
error | Событие |
flash.events.ErrorEventсвойство ErrorEvent.type =
flash.events.ErrorEvent.ERROR| Язык версии: | ActionScript 3.0 |
| Версии среды выполнения: | AIR 1.5 |
Отправляется при возникновении ошибки во время инициализации или процесса обновления (если произошло непредвиденное событие).
Определяет значение свойстваtype объекта события error.
Это событие имеет следующие свойства:
| Свойство | Значение |
|---|---|
bubbles | false |
cancelable | false; поведение по умолчанию, подлежащее отмене, не определено. |
currentTarget | Объект, активно обрабатывающий объект Event с помощью прослушивателя событий. |
target | Объект, испытывающий сбой сетевой операции. |
text | Текст, отображаемый в качестве сообщения об ошибке. |
fileUpdateError | Событие |
air.update.events.StatusFileUpdateErrorEventсвойство StatusFileUpdateErrorEvent.type =
air.update.events.StatusFileUpdateErrorEvent.FILE_UPDATE_ERROR| Язык версии: | ActionScript 3.0 |
| Версии среды выполнения: | AIR 1.5 |
Отправляется в случае ошибки проверки файла, переданного в качестве параметра airFile в вызов метода installFromAIRFile().
StatusUpdateErrorEvent.UPDATE_ERROR определяет значение свойства type объекта события statusUpdateError.
fileUpdateStatus | Событие |
air.update.events.StatusFileUpdateEventсвойство StatusFileUpdateEvent.type =
air.update.events.StatusFileUpdateEvent.FILE_UPDATE_STATUS| Язык версии: | ActionScript 3.0 |
| Версии среды выполнения: | AIR 1.5 |
Отправляется после успешной проверки программой обновления файла в вызове метода installFromAIRFile().
StatusUpdateEvent.UPDATE_STATUS определяет значение свойства type объекта события updateStatus.
Это событие имеет следующие свойства:
| Свойство | Значение |
|---|---|
available | Указывает, доступна ли версия приложения, отличная от текущей (true); в противном случае — false (та же версия). |
path | Свойство nativePath объекта File обновления, заданное параметром airFile в вызове метода installFromAIRFile(). |
version | Указывает версию обновления. |
initialized | Событие |
air.update.events.UpdateEventсвойство UpdateEvent.type =
air.update.events.UpdateEvent.INITIALIZED| Язык версии: | ActionScript 3.0 |
| Версии среды выполнения: | AIR 1.5 |
Отправляется после завершения инициализации.
КонстантаUpdateEvent.INITIALIZED определяет значение свойства type объекта события initialized.
Это событие имеет следующие свойства:
| Свойство | Значение |
|---|---|
bubbles | false |
cancelable | false; поведение по умолчанию, подлежащее отмене, не определено. |
currentTarget | Объект, активно обрабатывающий объект Event с помощью прослушивателя событий. |
target | Объект обновления. |
progress | Событие |
flash.events.ProgressEventсвойство ProgressEvent.type =
flash.events.ProgressEvent.PROGRESS| Язык версии: | ActionScript 3.0 |
| Версии среды выполнения: | AIR 1.5 |
Загружается файл, отправленный в качестве обновления.
Задает значение свойстваtype для объекта события progress.
Это событие имеет следующие свойства:
| Свойство | Значение |
|---|---|
bubbles | false |
bytesLoaded | Число элементов или байтов, загруженных на момент обработки события прослушивателем. |
bytesTotal | Общее число элементов или байтов, которые в итоге будут получены в случае успешного завершения загрузки. |
cancelable | false; поведение по умолчанию, подлежащее отмене, не определено. |
currentTarget | Объект, активно обрабатывающий объект Event с помощью прослушивателя событий. |
target | Объект, сообщающий сведения о прогрессе. |
updateError | Событие |
air.update.events.StatusUpdateErrorEventсвойство StatusUpdateErrorEvent.type =
air.update.events.StatusUpdateErrorEvent.UPDATE_ERROR| Язык версии: | ActionScript 3.0 |
| Версии среды выполнения: | AIR 1.5 |
Отправляется в случае ошибки загрузки или разбора файла дескриптора обновления.
При отправке этого события программой обновления периодический таймер автоматически перезапускается (если значение настройки задержки больше 0). Приложение должно предусматривать скрытие всех сообщений об ошибках при отправке программой обновления нового события checkForUpdate.
StatusUpdateErrorEvent.UPDATE_ERROR определяет значение свойства type объекта события statusUpdateError.
updateStatus | Событие |
air.update.events.StatusUpdateEventсвойство StatusUpdateEvent.type =
air.update.events.StatusUpdateEvent.UPDATE_STATUS| Язык версии: | ActionScript 3.0 |
| Версии среды выполнения: | AIR 1.5 |
Отправляется после успешной загрузки и интерпретации файла дескриптора обновления программой обновления.
По умолчанию загрузка обновления начинается, если свойство available объекта StatusUpdateEvent имеет значение true. Поведения по умолчанию можно избежать только при использовании класса ApplicationUpdater, но не при использовании класса ApplicationUpdatorUI.
StatusUpdateEvent.UPDATE_STATUS определяет значение свойства type объекта события updateStatus.
Это событие имеет следующие свойства:
| Свойство | Значение |
|---|---|
available | Имеет значение true, если в файле дескриптора обновления указана версия приложения, отличная от имеющейся версии; в противном случае — false (версия та же). |
version | Строка, представляющая новую доступную версию. |
details | Массив, определяющий строку details для каждого поддерживаемого языка. Если локализованная версия описания отсутствует, то первый элемент массива является пустой строкой (""), а второй элемент — строкой details. Если имеются локализованные версии описаний, каждый элемент массива представляет собой отдельный массив из двух элементов. Первым элементом является код локали, а вторым — описание. Например, следующий массив содержит подмассивы для двух языков (американского английского и французского): ["en-US", "Hello World"], ["fr", "Bonjour monde"]. Языки перечислены в том же порядке, что и в дескрипторе обновления. Текст для свойства details указывается в файле дескриптора обновления. |
versionLabel | (AIR 2.5 и более поздних версий) Метка версии из дескриптора программы обновления. Метка версии должна отображаться для пользователей вместо версии. Если метка версии не указана, это свойство является пустой строкой. |
Tue Jun 12 2018, 11:34 AM Z