Главная / Action Script 3
(Только AIR)
Пакетflash.desktop
Классpublic final class Updater
НаследованиеUpdater Inheritance Object

Язык версии : ActionScript 3.0
Версии среды выполнения:  1.0

Класс Updater используется для обновления версии текущего запущенного приложения. Чтобы воспользоваться данным классов, следует создать объект Updater, а затем вызвать его метод update().



Общедоступные свойства
 СвойствоОпределено
 Inheritedconstructor : Object
Ссылка на объект класса или функцию конструктора для данного экземпляра объекта.
Object
 Inheritedprototype : Object
[статические] Ссылка на модель объекта класса или функции.
Object
Общедоступные методы
 МетодОпределено
  
Функция конструктора для класса Updater.
Updater
 Inherited
Показывает, определено ли заданное свойство для объекта.
Object
 Inherited
Показывает, есть ли экземпляр класса Object в цепи прототипов объекта, заданного в качестве параметра.
Object
 Inherited
Показывает наличие заданного свойства и его перечисляемость.
Object
 Inherited
Задает доступность динамического свойства для операций цикла.
Object
 Inherited
Возвращает строковое представление заданного объекта.
Object
  
AIR-only update(airFile:File, version:String):void
Производит обновление версии текущего запущенного приложения на версию приложения, указанную в файле AIR.
Updater
 Inherited
Возвращает элементарное значение заданного объекта.
Object
Сведения о конструкторе
AIR-only Updater()Конструктор
public function Updater()

Версии среды выполнения:  1.0

Функция конструктора для класса Updater. Обратите внимание, что метод update() не является статическим методом класса. Для вызова метода update() необходимо сначала создать объект Updater.

Сведения о методе
AIR-only update()метод
public function update(airFile:File, version:String):void

Язык версии : ActionScript 3.0
Версии среды выполнения:  1.0

Производит обновление версии текущего запущенного приложения на версию приложения, указанную в файле AIR. Необходимо, что приложение в файле AIR имело тот же идентификатор (appID), что и текущее запущенное приложение.

Вызов этого метода приводит к завершению работы приложения (как это происходит при вызове метода NativeApplication.exit()). Такое поведение объясняется тем, что Adobe AIR не может провести полное обновление приложения без завершения его работы. После успешного проведения обновления версии приложения на более новую, оно запускается вновь. Если установка новой версии не может быть завершена (например, если ее идентификатор приложения не совпадает с идентификатором существующего приложения), то программа установки AIR выводит сообщение об ошибке, и старая версия приложения запускается снова.

Обновляемое приложение запускается снова независимо от результата проведения обновления. Ошибки в процессе обновления могут быть вызваны причинами, которые не зависят от приложения, например, отсутствие у пользователя прав для установки приложения. Приложения должны уметь определять характер ошибки, чтобы избежать повторных попыток обновления, приводящих к ошибке. В результате бесконечно повторяющегося цикла попыток обновления приложения просто откажется работать. Одним из способов проверки результата обновления приложения является сравнение версии текущего приложения до обновления и после него, когда приложение запустится вновь.

При проверке приложения с использованием приложения AIR Debug Launcher (ADL), вызов метода update() приводит к исключению.

При обновлении версии приложения в Mac OS пользователь должен обладать всеми необходимыми правами на запись в каталог приложения. В Windows пользователь должен обладать правами администратора.

Если обновленная версия приложения требует обновления среды выполнения, данное обновление устанавливается также. Для обновления среды выполнения пользователь данного компьютера должен обладать правами администратора.

Примечание. В целях безопасности указание параметра version является обязательным. Проверка версии приложения в файле AIR позволяет исключить возможность установки более старой версии приложения, в которой, возможно, содержится уязвимость системы безопасности, которую удалось исправить в новой версии.

Параметры

airFile:File — Объект File, указывающий на файл AIR, в котором хранится версия приложения для обновления.
 
version:String — Требуемая версия нового файла AIR. Для успешного проведения обновления необходимо, чтобы строка атрибута version основного элемента application файла дескриптора приложения для файла AIR совпадала с данным значением.


Выдает
IllegalOperationError — Данный метод был вызван при работе в ADL.