| Пакет | air.update |
| Класс | public class ApplicationUpdaterUI |
| Наследование | ApplicationUpdaterUI  EventDispatcher Object |
| Язык версии: | ActionScript 3.0 |
| Версии среды выполнения: | AIR 1.5 |
Этот класс включен в файл applicationupdater_ui.swc, который входит в Adobe® Flex™ SDK. applicationupdater_ui.swc файл находится в каталоге оболочек/освобо/воздуха SDK AIR. Версия в каталоге оболочек/освобо/воздуха в AIR 2 SDK является для Flex 4 разработками. Если Вы используете Flex 3, используйте версию в подкаталоге frameworks/libs/air/flex3.
Adobe® Flex™ Builder™ загружает этот класс автоматически при создании проекта для Adobe AIR. Вы должны включить файл SWC, компилируя программу, использующую Adobe ® Flex ™ SDK.
Управление обновлениями приложений может оказаться непростой задачей. Инфраструктура обновления AIR предоставляет API-интерфейсы, позволяющие разработчикам внедрить хорошие возможности обновления в приложения AIR. Функциональная инфраструктура обновления AIR предоставляет разработчикам следующие возможности.
-
Периодическая проверка наличия обновлений по расписанию или по запросу пользователя.
-
Загрузка файлов AIR (обновлений) из веб-источника.
-
Оповещение пользователя о первом запуске вновь установленной версии.
-
Запрос на подтверждение проверки наличия обновлений пользователем.
-
Отображение информации о версии обновления для пользователя.
-
Отображение хода загрузки и информации об ошибках для пользователя.
Инфраструктура обновления AIR позволяет сохранять информацию о версии обновления приложения AIR в простых XML-файлах конфигурации. Благодаря настройке файлов конфигурации и вставке основного кода большинство приложений способны предложить своим конечным пользователям хорошие функциональные возможности обновления.
Класс AIRUpdateUI реализует пользовательский интерфейс по умолчанию, который может использоваться вашим приложением. Он предоставляет пользователю основную информацию и параметры, связанные с обновлением приложения.
Процесс обновления включает в себя ряд состояний.
| Состояние | Описание |
|---|---|
| Uninitialized | Программа обновления не инициализирована. |
| Initializing | Выполняется инициализация программы обновления. |
| Готово | Программа обновления инициализирована. |
| Before checking | Программа обновления еще не выполнила проверку наличия файла дескриптора обновления. |
| Checking | Программа обновления выполняет проверку наличия файла дескриптора обновления. |
| Доступен | Обнаружен доступный файл дескриптора обновления. |
| Downloading | Программа обновления выполняет загрузку файла AIR. |
| Downloaded | Программа обновления завершила загрузку файла AIR. |
| Installing | Программа обновления выполняет установку файла AIR. |
| Pending install | Программа обновления инициализирована. Имеются обновления, ожидающие установки. |
Однако при тестировании приложения в программе AIR Debug Launcher (ADL) попытка обновить приложение приводит к исключению IllegalOperationError.
Структура обновления AIR поддерживается только в профиле рабочего стола. Ее не поддерживают приложения расширенного рабочего стола (которые устанавливаются с помощью собственной программы установки), а также профили мобильных устройств (например, приложения iPhone, написанные с использованием ActionScript 3.0). Во время выполнения проверьте свойство Updater.isSupported, чтобы узнать, поддерживается ли структура обновления.
Для получения подробных сведений об использовании структуры обновления AIR см. главу «Обновление приложений AIR» в публикации Разработка приложений Adobe AIR.
Связанные элементы API
Скрыть унаследованные общедоступные свойства
Показать унаследованные общедоступные свойства| Свойство | Определено | ||
|---|---|---|---|
| configurationFile : File
Местоположение файла конфигурации, в котором заданы значения свойств delay и updateURL. | ApplicationUpdaterUI | ||
 | constructor : Object
Ссылка на объект класса или функцию конструктора для данного экземпляра объекта. | Object | |
| currentVersion : String [только для чтения]
Текущая версия приложения. | ApplicationUpdaterUI | ||
| delay : Number
Интервал в днях между периодическими проверками наличия новых обновлений. | ApplicationUpdaterUI | ||
| isCheckForUpdateVisible : Boolean
Включает видимость диалоговых окон «Проверка наличия обновлений», «Нет доступных обновлений» и «Ошибка обновления». | ApplicationUpdaterUI | ||
| isDownloadProgressVisible : Boolean
Включает видимость диалогового окна «Загрузка обновления». | ApplicationUpdaterUI | ||
| isDownloadUpdateVisible : Boolean
Включает видимость диалогового окна «Загрузка обновления». | ApplicationUpdaterUI | ||
| isFileUpdateVisible : Boolean
Включает видимость диалоговых окон «Файл – Доступно обновление», «Файл – Нет доступных обновлений» и «Файл – Ошибка». | ApplicationUpdaterUI | ||
| isFirstRun : Boolean [только для чтения]
Является ли этот запуск первым после успешного обновления (true) или нет (false). | ApplicationUpdaterUI | ||
| isInstallUpdateVisible : Boolean
Включает видимость диалогового окна «Установка обновления». | ApplicationUpdaterUI | ||
| isNewerVersionFunction : Function
Функция, используемая программой обновления для сравнения версий. | ApplicationUpdaterUI | ||
| isUnexpectedErrorVisible : Boolean
Включает видимость диалогового окна «Непредвиденная ошибка». | ApplicationUpdaterUI | ||
| isUpdateInProgress : Boolean [только для чтения]
Свойство, принимающее логическое значение true, если выполняется обновление, и значение false, если нет. | ApplicationUpdaterUI | ||
| localeChain : Array
Массив, определяющий цепочку языковых стандартов, используемых в пользовательском интерфейсе. | ApplicationUpdaterUI | ||
| previousApplicationStorageDirectory : File [только для чтения]
Предыдущее местоположение каталога хранилища приложения, если оно изменилось после обновления. | ApplicationUpdaterUI | ||
| previousVersion : String [только для чтения]
Предыдущая версия приложения. | ApplicationUpdaterUI | ||
| updateDescriptor : XML [только для чтения]
Содержимое файла дескриптора обновления, загруженного с URL-адреса обновления. | ApplicationUpdaterUI | ||
| updateURL : String
Местоположение файла дескриптора обновления. | ApplicationUpdaterUI | ||
| wasPendingUpdate : Boolean [только для чтения]
Имеется ли отложенное обновление, даже если его не удалось установить (true); в противном случае – false. | ApplicationUpdaterUI | ||
| Метод | Определено | ||
|---|---|---|---|
Функция конструктора. | ApplicationUpdaterUI | ||
| addEventListener(type:String, listener:Function, useCapture:Boolean = false, priority:int = 0, useWeakReference:Boolean = false):void
Регистрирует объект прослушивателя события на объекте EventDispatcher для получения прослушивателем уведомления о событии. | EventDispatcher | |
Динамически добавляет новый пакет ресурсов для указанного языка. | ApplicationUpdaterUI | ||
Отменяет процесс обновления. | ApplicationUpdaterUI | ||
Начинает процесс обновления. | ApplicationUpdaterUI | ||
|
Посылает событие в поток событий. | EventDispatcher | |
|
Проверяет, имеет ли объект EventDispatcher прослушиватели, зарегистрированные для определенного типа события. | EventDispatcher | |
|
Показывает, определено ли заданное свойство для объекта. | Object | |
Выполняет инициализацию программы обновления. | ApplicationUpdaterUI | ||
Начинает процесс обновления с помощью локального файла AIR. | ApplicationUpdaterUI | ||
|
Показывает, есть ли экземпляр класса Object в цепи прототипов объекта, заданного в качестве параметра. | Object | |
|
Показывает наличие заданного свойства и его перечисляемость. | Object | |
|
Удаляет прослушиватель из объекта EventDispatcher. | EventDispatcher | |
|
Задает доступность динамического свойства для операций цикла. | Object | |
|
Возвращает строковое представление этого объекта, отформатированного в соответствии со стандартами, принятыми для данной локали. | Object | |
|
Возвращает строковое представление заданного объекта. | Object | |
|
Возвращает элементарное значение заданного объекта. | Object | |
|
Проверяет, зарегистрирован ли прослушиватель события для указанного типа события с данным объектом EventDispatcher или любым его предшественником. | EventDispatcher | |
| Событие | Сводка | Определено | ||
|---|---|---|---|---|
| [многоадресное событие] Отправляется, когда проигрыватель Flash Player или приложение AIR перемещается в фокус операционной системы и становится активным. | EventDispatcher | ||
| Отправляется непосредственно перед установкой обновления, после вызова метода installUpdate(). | ApplicationUpdaterUI | |||
| Отправляется до начала процесса обновления, непосредственно перед попыткой программы обновления загрузить файл дескриптора обновления. | ApplicationUpdaterUI | |||
| [многоадресное событие] Отправляется, когда проигрыватель Flash Player или приложение AIR теряет фокус системы и становится неактивным. | EventDispatcher | ||
| Отправляется при завершении загрузки файла обновления. | ApplicationUpdaterUI | |||
| Отправляется в случае ошибки подключения к файлу обновления или его загрузки. | ApplicationUpdaterUI | |||
| Отправляется после вызова метода downloadUpdate() и установки подключения к серверу. | ApplicationUpdaterUI | |||
| Отправляется при возникновении ошибки во время инициализации или процесса обновления (если произошло непредвиденное событие). | ApplicationUpdaterUI | |||
| Отправляется в случае ошибки проверки файла, переданного в качестве параметра airFile в вызов метода installFromAIRFile(). | ApplicationUpdaterUI | |||
| Отправляется после успешной проверки программой обновления файла в вызове метода installFromAIRFile(). | ApplicationUpdaterUI | |||
| Отправляется после завершения инициализации. | ApplicationUpdaterUI | |||
| Загружается файл, отправленный в качестве обновления. | ApplicationUpdaterUI | |||
| Отправляется в случае ошибки загрузки или разбора файла дескриптора обновления. | ApplicationUpdaterUI | |||
| Отправляется после успешной загрузки и интерпретации файла дескриптора обновления программой обновления. | ApplicationUpdaterUI | |||
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>
<defaultUI>
<dialog name="checkForUpdate" visible="true" />
<dialog name="downloadUpdate" visible="false" />
<dialog name="downloadProgress" visible="true" />
<dialog name="installUpdate" visible="true" />
</defaultUI>
</configuration>Вместо загрузки файла конфигурации можно использовать код ActionScript для определения следующих свойств объекта ApplicationUpdaterUI: delay, isCheckForUpdateVisible, isDownloadProgressVisible, isDownloadUpdateVisible, isFileUpdateVisible, isInstallUpdateVisible и updateURL.
Реализация
public function get configurationFile():File public function set configurationFile(value:File):voidСвязанные элементы API
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Связанные элементы API
isCheckForUpdateVisible | свойство |
isCheckForUpdateVisible:Boolean| Язык версии: | ActionScript 3.0 |
| Версии среды выполнения: | AIR 1.5 |
Включает видимость диалоговых окон «Проверка наличия обновлений», «Нет доступных обновлений» и «Ошибка обновления». При значении true программа обновления отображает эти диалоговые окна в процессе обновления. Этот параметр можно задать также в файле конфигурации обновления. Значение, заданное с помощью этого свойства, переопределяет настройку в файле конфигурации обновления.
Реализация
public function get isCheckForUpdateVisible():Boolean public function set isCheckForUpdateVisible(value:Boolean):void isDownloadProgressVisible | свойство |
isDownloadProgressVisible:Boolean| Язык версии: | ActionScript 3.0 |
| Версии среды выполнения: | AIR 1.5 |
Включает видимость диалогового окна «Загрузка обновления». При значении true программа обновления отображает это диалоговое окно в процессе обновления. Этот параметр можно задать также в файле конфигурации обновления. Значение, заданное с помощью этого свойства, переопределяет настройку в файле конфигурации обновления.
Реализация
public function get isDownloadProgressVisible():Boolean public function set isDownloadProgressVisible(value:Boolean):void isDownloadUpdateVisible | свойство |
isDownloadUpdateVisible:Boolean| Версии среды выполнения: | AIR 1.5 |
Включает видимость диалогового окна «Загрузка обновления». При значении true программа обновления отображает эти диалоговые окна в процессе обновления. Этот параметр можно задать также в файле конфигурации обновления. Значение, заданное с помощью этого свойства, переопределяет настройку в файле конфигурации обновления.
Реализация
public function get isDownloadUpdateVisible():Boolean public function set isDownloadUpdateVisible(value:Boolean):void isFileUpdateVisible | свойство |
isFileUpdateVisible:Boolean| Язык версии: | ActionScript 3.0 |
| Версии среды выполнения: | AIR 1.5 |
Включает видимость диалоговых окон «Файл – Доступно обновление», «Файл – Нет доступных обновлений» и «Файл – Ошибка». При значении true программа обновления отображает эти диалоговые окна в процессе обновления. Этот параметр можно задать также в файле конфигурации обновления. Значение, заданное с помощью этого свойства, переопределяет настройку в файле конфигурации обновления.
Реализация
public function get isFileUpdateVisible():Boolean public function set isFileUpdateVisible(value:Boolean):void isFirstRun | свойство |
isFirstRun:Boolean [только для чтения] | Язык версии: | ActionScript 3.0 |
| Версии среды выполнения: | AIR 1.5 |
Является ли этот запуск первым после успешного обновления (true) или нет (false). Программа обновления задает это значение во время вызова метода initialize(). Если требуется выполнить перенос данных из одной версии в другую, разработчик должен убедиться, что для свойства isFirstRun задано значение true.
Реализация
public function get isFirstRun():BooleanСвязанные элементы API
isInstallUpdateVisible | свойство |
isInstallUpdateVisible:Boolean| Язык версии: | ActionScript 3.0 |
| Версии среды выполнения: | AIR 1.5 |
Включает видимость диалогового окна «Установка обновления». При значении true программа обновления отображает это диалоговое окно в процессе обновления. Этот параметр можно задать также в файле конфигурации обновления. Значение, заданное с помощью этого свойства, переопределяет настройку в файле конфигурации обновления.
Реализация
public function get isInstallUpdateVisible():Boolean public function set isInstallUpdateVisible(value:Boolean):void 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;
}
isUnexpectedErrorVisible | свойство |
isUnexpectedErrorVisible:Boolean| Язык версии: | ActionScript 3.0 |
| Версии среды выполнения: | AIR 1.5 |
Включает видимость диалогового окна «Непредвиденная ошибка». При значении true компонент Application Updater отображает это диалоговое окно в процессе обновления. Этот параметр можно задать также в файле конфигурации обновления. Значение, заданное с помощью этого свойства, переопределяет настройку в файле конфигурации обновления.
Реализация
public function get isUnexpectedErrorVisible():Boolean public function set isUnexpectedErrorVisible(value:Boolean):void isUpdateInProgress | свойство |
localeChain | свойство |
localeChain:Array| Язык версии: | ActionScript 3.0 |
| Версии среды выполнения: | AIR 1.5 |
Массив, определяющий цепочку языковых стандартов, используемых в пользовательском интерфейсе. Как правило, только разработчики JavaScript (HTML) используют это свойство.
Разработчики Flex могут использовать ResourceManager для обработки цепочки языковых стандартов.
По умолчанию в приложении HTML сортировка происходит среди языков массива Capabilities.languages и десяти языков, поддерживаемых пользовательским интерфейсом. Если соответствие не найдено, в пользовательском интерфейсе используется английский язык.
В этом примере на языке JavaScript используется инфраструктура локализации AIR HTML, входящая в комплект AIR SDK. Она сортирует языки в соответствии со списком языков, а затем устанавливает английский язык в качестве базового языка по умолчанию.
appUpdater.addResources("ro_RO", {titleCheck: "Titlu", msgCheck: "Mesaj", btnCheck: "Buton"});
appUpdater.addResources("hu", {titleCheck: "Cím", msgCheck: "Üzenet"});
var languages = ["ro", "hu"];
languages = languages.concat(air.Capabilities.languages);
var sortedLanguages = air.Localizer.sortLanguagesByPreference(languages, air.Capabilities.language, "en-US");
sortedLanguages.push("en-US");
appUpdater.localeChain = sortedLanguages;Реализация
public function get localeChain():Array public function set localeChain(value:Array):voidСвязанные элементы API
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Связанные элементы API
wasPendingUpdate | свойство |
wasPendingUpdate:Boolean [только для чтения] | Язык версии: | ActionScript 3.0 |
| Версии среды выполнения: | AIR 1.5 |
Имеется ли отложенное обновление, даже если его не удалось установить (true); в противном случае – false. Программа обновления задает значение для этого свойства во время вызова метода initialize(). С помощью свойств wasPendingUpdate и isFirstRun можно проверить, была ли попытка установки обновления неудачной (в этом случае свойство wasPendingUpdate имеет значение true, а свойство isFirstRun имеет значение false).
Реализация
public function get wasPendingUpdate():BooleanСвязанные элементы API
ApplicationUpdaterUI | () | Конструктор |
public function ApplicationUpdaterUI()| Язык версии: | ActionScript 3.0 |
| Версии среды выполнения: | AIR 1.5 |
Функция конструктора.
addResources | () | метод |
public function addResources(lang:String, res:Object):void| Язык версии: | ActionScript 3.0 |
| Версии среды выполнения: | AIR 1.5 |
Динамически добавляет новый пакет ресурсов для указанного языка. Разработчики JavaScript используют этот метод для динамического добавления нового языка для диалоговых окон, отображаемых в интерфейсе программы обновления приложения. (Разработчики Flex могут напрямую добавлять новый язык в пакет ресурсов ApplicationUpdaterDialogs.)
Параметры
lang:String — Код языка (например, ro для румынского).
| |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
res:Object — Этот объект содержит ключи и значения для перевода. Ключи берутся из файла свойств языка. В таблице ниже приведены возможные ключи (названия свойств).
|
Связанные элементы API
cancelUpdate | () | метод |
public function cancelUpdate():void| Язык версии: | ActionScript 3.0 |
| Версии среды выполнения: | AIR 1.5 |
Отменяет процесс обновления. Вызов этого метода отменяет все ожидающие загрузки, удаляя не полностью загруженные файлы, и перезапускает таймер периодической проверки.
Процесс обновления можно отменить в любое время. Исключением являются состояния uninitialized и initializing. Вызов этого метода в состоянии uninitialized или initializing не работает.
checkNow | () | метод |
public function checkNow():void| Язык версии: | ActionScript 3.0 |
| Версии среды выполнения: | AIR 1.5 |
Начинает процесс обновления. Вызов этого метода не останавливает периодический таймер. Однако этот метод определяет, что выполняется процесс обновления, и пропускает текущую итерацию.
Этот метод выполняется только в состоянии Ready.
Этот метод может вызвать объект программы обновления, отправляющий следующее событие:
События
checkForUpdate: — Отправляется непосредственно перед началом процесса обновления.
|
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: — Отправляется в случае ошибки разбора файла дескриптора обновления.
|
beforeInstall | Событие |
air.update.events.UpdateEventсвойство UpdateEvent.type =
air.update.events.UpdateEvent.BEFORE_INSTALL| Язык версии: | ActionScript 3.0 |
| Версии среды выполнения: | AIR 1.5 |
Отправляется непосредственно перед установкой обновления, после вызова метода installUpdate(). Иногда необходимо предотвратить установку обновления на этом этапе, так как все результаты текущей работы пользователя могут быть потеряны при выходе среды выполнения из приложения для установки обновления.
Вызов метода preventDefault() этого события позволяет отложить установку до следующего запуска. При вызове метода preventDefault() ни один дополнительный процесс обновления не будет запущен во время данного сеанса работы приложения (путем вызова метода installUpdate() или проверки по расписанию).
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 |
Отправляется при завершении загрузки файла обновления.
Константа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 |
Отправляется после завершения инициализации.
Данное событие имеет следующие свойства только для чтения:
-
isFirstRun(логическое)true, если это первый запуск после успешного обновления; в противном случае –false. -
previousVersion(строка) Предыдущая версия приложения до обновления (задано, только если свойствоisfirstRunимеет значениеtrue). -
currentVersion(строка) Версия, указанная в файле дескриптора текущей установленной версии приложения.
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 |
Отправляется после успешной загрузки и интерпретации файла дескриптора обновления программой обновления.
Константа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