Справочник по ActionScript® 3.0 для платформы Adobe® Flash®
Домашняя страница  |  Скрыть список пакетов и классов |  Пакеты  |  Классы  |  Что нового  |  Указатель  |  Приложения  |  Почему по-английски?
Фильтры: AIR 30.0 или более ранней версии, Flash Player 30.0 или более ранней версии, Flash Lite 4
Flex 4.6 или более ранней версии, Flash Pro CS6 или более ранней версии
Скрыть фильтры
air.update 

ApplicationUpdaterUI  - AS3

Пакетыx

Верхний уровень
adobe.utils
air.desktop
air.net
air.update
air.update.events
coldfusion.air
coldfusion.air.errors
coldfusion.air.events
coldfusion.service
coldfusion.service.events
coldfusion.service.mxml
com.adobe.acm.solutions.authoring.domain.extensions
com.adobe.acm.solutions.ccr.domain.extensions
com.adobe.consulting.pst.vo
com.adobe.dct.component
com.adobe.dct.component.datadictionary
com.adobe.dct.component.datadictionaryElement
com.adobe.dct.component.dataElementsPanel
com.adobe.dct.component.toolbars
com.adobe.dct.event
com.adobe.dct.exp
com.adobe.dct.model
com.adobe.dct.service
com.adobe.dct.service.provider
com.adobe.dct.transfer
com.adobe.dct.util
com.adobe.dct.view
com.adobe.ep.taskmanagement.domain
com.adobe.ep.taskmanagement.event
com.adobe.ep.taskmanagement.filter
com.adobe.ep.taskmanagement.services
com.adobe.ep.taskmanagement.util
com.adobe.ep.ux.attachmentlist.component
com.adobe.ep.ux.attachmentlist.domain
com.adobe.ep.ux.attachmentlist.domain.events
com.adobe.ep.ux.attachmentlist.domain.renderers
com.adobe.ep.ux.attachmentlist.skin
com.adobe.ep.ux.attachmentlist.skin.renderers
com.adobe.ep.ux.content.event
com.adobe.ep.ux.content.factory
com.adobe.ep.ux.content.handlers
com.adobe.ep.ux.content.managers
com.adobe.ep.ux.content.model.asset
com.adobe.ep.ux.content.model.preview
com.adobe.ep.ux.content.model.relation
com.adobe.ep.ux.content.model.search
com.adobe.ep.ux.content.model.toolbar
com.adobe.ep.ux.content.search
com.adobe.ep.ux.content.services
com.adobe.ep.ux.content.services.load
com.adobe.ep.ux.content.services.permissions
com.adobe.ep.ux.content.services.preview
com.adobe.ep.ux.content.services.providers
com.adobe.ep.ux.content.services.query
com.adobe.ep.ux.content.services.relationships
com.adobe.ep.ux.content.services.search.lccontent
com.adobe.ep.ux.content.services.version
com.adobe.ep.ux.content.view
com.adobe.ep.ux.content.view.components.activate
com.adobe.ep.ux.content.view.components.grid
com.adobe.ep.ux.content.view.components.grid.hover
com.adobe.ep.ux.content.view.components.grid.hover.component
com.adobe.ep.ux.content.view.components.grid.renderers
com.adobe.ep.ux.content.view.components.relationships
com.adobe.ep.ux.content.view.components.review
com.adobe.ep.ux.content.view.components.search.renderers
com.adobe.ep.ux.content.view.components.searchpod
com.adobe.ep.ux.content.view.components.toolbar
com.adobe.ep.ux.content.view.components.toolbar.controlRenderers
com.adobe.ep.ux.content.view.components.version
com.adobe.ep.ux.documentsubmit.component
com.adobe.ep.ux.documentsubmit.domain
com.adobe.ep.ux.documentsubmit.skin
com.adobe.ep.ux.taskaction.component
com.adobe.ep.ux.taskaction.domain
com.adobe.ep.ux.taskaction.domain.events
com.adobe.ep.ux.taskaction.skin
com.adobe.ep.ux.taskdetails.component
com.adobe.ep.ux.taskdetails.domain
com.adobe.ep.ux.taskdetails.skin
com.adobe.ep.ux.tasklist.component
com.adobe.ep.ux.tasklist.domain
com.adobe.ep.ux.tasklist.skin
com.adobe.ep.ux.webdocumentviewer.domain
com.adobe.exm.expression
com.adobe.exm.expression.error
com.adobe.exm.expression.event
com.adobe.exm.expression.impl
com.adobe.fiber.runtime.lib
com.adobe.fiber.services
com.adobe.fiber.services.wrapper
com.adobe.fiber.styles
com.adobe.fiber.util
com.adobe.fiber.valueobjects
com.adobe.gravity.binding
com.adobe.gravity.context
com.adobe.gravity.flex.bundleloader
com.adobe.gravity.flex.progress
com.adobe.gravity.flex.serviceloader
com.adobe.gravity.framework
com.adobe.gravity.init
com.adobe.gravity.service.bundleloader
com.adobe.gravity.service.logging
com.adobe.gravity.service.manifest
com.adobe.gravity.service.progress
com.adobe.gravity.tracker
com.adobe.gravity.ui
com.adobe.gravity.utility
com.adobe.gravity.utility.async
com.adobe.gravity.utility.error
com.adobe.gravity.utility.events
com.adobe.gravity.utility.factory
com.adobe.gravity.utility.flex.async
com.adobe.gravity.utility.logging
com.adobe.gravity.utility.message
com.adobe.gravity.utility.sequence
com.adobe.gravity.utility.url
com.adobe.guides.control
com.adobe.guides.domain
com.adobe.guides.i18n
com.adobe.guides.spark.components.skins
com.adobe.guides.spark.components.skins.mx
com.adobe.guides.spark.headers.components
com.adobe.guides.spark.headers.skins
com.adobe.guides.spark.layouts.components
com.adobe.guides.spark.layouts.skins
com.adobe.guides.spark.navigators.components
com.adobe.guides.spark.navigators.renderers
com.adobe.guides.spark.navigators.skins
com.adobe.guides.spark.util
com.adobe.guides.spark.wrappers.components
com.adobe.guides.spark.wrappers.skins
com.adobe.guides.submit
com.adobe.icc.dc.domain
com.adobe.icc.dc.domain.factory
com.adobe.icc.editors.events
com.adobe.icc.editors.handlers
com.adobe.icc.editors.managers
com.adobe.icc.editors.model
com.adobe.icc.editors.model.config
com.adobe.icc.editors.model.el
com.adobe.icc.editors.model.el.operands
com.adobe.icc.editors.model.el.operators
com.adobe.icc.enum
com.adobe.icc.external.dc
com.adobe.icc.obj
com.adobe.icc.services
com.adobe.icc.services.category
com.adobe.icc.services.config
com.adobe.icc.services.download
com.adobe.icc.services.export
com.adobe.icc.services.external
com.adobe.icc.services.formbridge
com.adobe.icc.services.fragmentlayout
com.adobe.icc.services.layout
com.adobe.icc.services.letter
com.adobe.icc.services.locator
com.adobe.icc.services.module
com.adobe.icc.services.render
com.adobe.icc.services.submit
com.adobe.icc.services.user
com.adobe.icc.token
com.adobe.icc.vo
com.adobe.icc.vo.render
com.adobe.icomm.assetplacement.controller
com.adobe.icomm.assetplacement.controller.utils
com.adobe.icomm.assetplacement.data
com.adobe.icomm.assetplacement.model
com.adobe.livecycle.assetmanager.client
com.adobe.livecycle.assetmanager.client.event
com.adobe.livecycle.assetmanager.client.handler
com.adobe.livecycle.assetmanager.client.managers
com.adobe.livecycle.assetmanager.client.model
com.adobe.livecycle.assetmanager.client.model.cms
com.adobe.livecycle.assetmanager.client.service
com.adobe.livecycle.assetmanager.client.service.search
com.adobe.livecycle.assetmanager.client.service.search.cms
com.adobe.livecycle.assetmanager.client.utils
com.adobe.livecycle.content
com.adobe.livecycle.rca.model
com.adobe.livecycle.rca.model.constant
com.adobe.livecycle.rca.model.document
com.adobe.livecycle.rca.model.participant
com.adobe.livecycle.rca.model.reminder
com.adobe.livecycle.rca.model.stage
com.adobe.livecycle.rca.service
com.adobe.livecycle.rca.service.core
com.adobe.livecycle.rca.service.core.delegate
com.adobe.livecycle.rca.service.process
com.adobe.livecycle.rca.service.process.delegate
com.adobe.livecycle.rca.token
com.adobe.livecycle.ria.security.api
com.adobe.livecycle.ria.security.service
com.adobe.mosaic.layouts
com.adobe.mosaic.layouts.dragAndDrop
com.adobe.mosaic.layouts.interfaces
com.adobe.mosaic.mxml
com.adobe.mosaic.om.constants
com.adobe.mosaic.om.events
com.adobe.mosaic.om.impl
com.adobe.mosaic.om.interfaces
com.adobe.mosaic.skinning
com.adobe.mosaic.sparklib.editors
com.adobe.mosaic.sparklib.optionMenu
com.adobe.mosaic.sparklib.scrollableMenu
com.adobe.mosaic.sparklib.scrollableMenu.skins
com.adobe.mosaic.sparklib.tabLayout
com.adobe.mosaic.sparklib.tabLayout.events
com.adobe.mosaic.sparklib.tabLayout.layouts
com.adobe.mosaic.sparklib.tabLayout.skins
com.adobe.mosaic.sparklib.text
com.adobe.mosaic.sparklib.util
com.adobe.solutions.acm.authoring.presentation
com.adobe.solutions.acm.authoring.presentation.actionbar
com.adobe.solutions.acm.authoring.presentation.common
com.adobe.solutions.acm.authoring.presentation.events
com.adobe.solutions.acm.authoring.presentation.fragment
com.adobe.solutions.acm.authoring.presentation.letter
com.adobe.solutions.acm.authoring.presentation.letter.data
com.adobe.solutions.acm.authoring.presentation.preview
com.adobe.solutions.acm.authoring.presentation.rte
com.adobe.solutions.acm.ccr.presentation
com.adobe.solutions.acm.ccr.presentation.contentcapture
com.adobe.solutions.acm.ccr.presentation.contentcapture.events
com.adobe.solutions.acm.ccr.presentation.contentcapture.preview
com.adobe.solutions.acm.ccr.presentation.datacapture
com.adobe.solutions.acm.ccr.presentation.datacapture.renderers
com.adobe.solutions.acm.ccr.presentation.pdf
com.adobe.solutions.exm
com.adobe.solutions.exm.authoring
com.adobe.solutions.exm.authoring.components.controls
com.adobe.solutions.exm.authoring.components.toolbars
com.adobe.solutions.exm.authoring.domain
com.adobe.solutions.exm.authoring.domain.expression
com.adobe.solutions.exm.authoring.domain.impl
com.adobe.solutions.exm.authoring.domain.method
com.adobe.solutions.exm.authoring.domain.variable
com.adobe.solutions.exm.authoring.enum
com.adobe.solutions.exm.authoring.events
com.adobe.solutions.exm.authoring.model
com.adobe.solutions.exm.authoring.renderer
com.adobe.solutions.exm.authoring.view
com.adobe.solutions.exm.expression
com.adobe.solutions.exm.impl
com.adobe.solutions.exm.impl.method
com.adobe.solutions.exm.method
com.adobe.solutions.exm.mock
com.adobe.solutions.exm.mock.method
com.adobe.solutions.exm.runtime
com.adobe.solutions.exm.runtime.impl
com.adobe.solutions.exm.variable
com.adobe.solutions.prm.constant
com.adobe.solutions.prm.domain
com.adobe.solutions.prm.domain.factory
com.adobe.solutions.prm.domain.impl
com.adobe.solutions.prm.domain.manager
com.adobe.solutions.prm.presentation.asset
com.adobe.solutions.prm.presentation.constant
com.adobe.solutions.prm.presentation.document
com.adobe.solutions.prm.presentation.event
com.adobe.solutions.prm.presentation.file
com.adobe.solutions.prm.presentation.project
com.adobe.solutions.prm.presentation.team
com.adobe.solutions.prm.presentation.util
com.adobe.solutions.prm.service
com.adobe.solutions.prm.services.impl
com.adobe.solutions.prm.vo
com.adobe.solutions.rca.constant
com.adobe.solutions.rca.domain
com.adobe.solutions.rca.domain.common
com.adobe.solutions.rca.domain.factory
com.adobe.solutions.rca.domain.impl
com.adobe.solutions.rca.domain.impl.manager
com.adobe.solutions.rca.domain.manager
com.adobe.solutions.rca.presentation
com.adobe.solutions.rca.presentation.comment
com.adobe.solutions.rca.presentation.constant
com.adobe.solutions.rca.presentation.event
com.adobe.solutions.rca.presentation.gantt
com.adobe.solutions.rca.presentation.gantt.ruler
com.adobe.solutions.rca.presentation.template
com.adobe.solutions.rca.presentation.template.audit
com.adobe.solutions.rca.presentation.template.definition
com.adobe.solutions.rca.presentation.template.documents
com.adobe.solutions.rca.presentation.template.stages
com.adobe.solutions.rca.presentation.util
com.adobe.solutions.rca.service
com.adobe.solutions.rca.services.impl
com.adobe.solutions.rca.vo
com.adobe.solutions.rca.vo.um
com.adobe.viewsource
fl.accessibility
fl.containers
fl.controls
fl.controls.dataGridClasses
fl.controls.listClasses
fl.controls.progressBarClasses
fl.core
fl.data
fl.display
fl.events
fl.ik
fl.lang
fl.livepreview
fl.managers
fl.motion
fl.motion.easing
fl.rsl
fl.text
fl.transitions
fl.transitions.easing
fl.video
flash.accessibility
flash.concurrent
flash.crypto
flash.data
flash.desktop
flash.display
flash.display3D
flash.display3D.textures
flash.errors
flash.events
flash.external
flash.filesystem
flash.filters
flash.geom
flash.globalization
flash.html
flash.media
flash.net
flash.net.dns
flash.net.drm
flash.notifications
flash.permissions
flash.printing
flash.profiler
flash.sampler
flash.security
flash.sensors
flash.system
flash.text
flash.text.engine
flash.text.ime
flash.ui
flash.utils
flash.xml
flashx.textLayout
flashx.textLayout.compose
flashx.textLayout.container
flashx.textLayout.conversion
flashx.textLayout.edit
flashx.textLayout.elements
flashx.textLayout.events
flashx.textLayout.factory
flashx.textLayout.formats
flashx.textLayout.operations
flashx.textLayout.utils
flashx.undo
ga.controls
ga.layouts
ga.model
ga.uiComponents
ga.util
ga.views
ga.wrappers
lc.foundation
lc.foundation.domain
lc.foundation.events
lc.foundation.ui
lc.foundation.util
lc.preloader
lc.procmgmt
lc.procmgmt.commands
lc.procmgmt.domain
lc.procmgmt.events
lc.procmgmt.formbridge
lc.procmgmt.impl
lc.procmgmt.ui.attachments
lc.procmgmt.ui.controls
lc.procmgmt.ui.controls.card
lc.procmgmt.ui.controls.renderer
lc.procmgmt.ui.help
lc.procmgmt.ui.layout
lc.procmgmt.ui.presentationmodel
lc.procmgmt.ui.process
lc.procmgmt.ui.search
lc.procmgmt.ui.startpoint
lc.procmgmt.ui.task
lc.procmgmt.ui.task.form
lc.procmgmt.ui.task.form.commands
lc.procmgmt.ui.tracking
mx.accessibility
mx.automation
mx.automation.air
mx.automation.delegates
mx.automation.delegates.advancedDataGrid
mx.automation.delegates.charts
mx.automation.delegates.containers
mx.automation.delegates.controls
mx.automation.delegates.controls.dataGridClasses
mx.automation.delegates.controls.fileSystemClasses
mx.automation.delegates.core
mx.automation.delegates.flashflexkit
mx.automation.events
mx.binding
mx.binding.utils
mx.charts
mx.charts.chartClasses
mx.charts.effects
mx.charts.effects.effectClasses
mx.charts.events
mx.charts.renderers
mx.charts.series
mx.charts.series.items
mx.charts.series.renderData
mx.charts.styles
mx.collections
mx.collections.errors
mx.containers
mx.containers.accordionClasses
mx.containers.dividedBoxClasses
mx.containers.errors
mx.containers.utilityClasses
mx.controls
mx.controls.advancedDataGridClasses
mx.controls.dataGridClasses
mx.controls.listClasses
mx.controls.menuClasses
mx.controls.olapDataGridClasses
mx.controls.scrollClasses
mx.controls.sliderClasses
mx.controls.textClasses
mx.controls.treeClasses
mx.controls.videoClasses
mx.core
mx.core.windowClasses
mx.data
mx.data.crypto
mx.data.errors
mx.data.events
mx.data.messages
mx.data.mxml
mx.data.offline.errors
mx.data.utils
mx.effects
mx.effects.easing
mx.effects.effectClasses
mx.events
mx.filters
mx.flash
mx.formatters
mx.geom
mx.graphics
mx.graphics.codec
mx.graphics.shaderClasses
mx.logging
mx.logging.errors
mx.logging.targets
mx.managers
mx.messaging
mx.messaging.channels
mx.messaging.config
mx.messaging.errors
mx.messaging.events
mx.messaging.management
mx.messaging.messages
mx.modules
mx.netmon
mx.olap
mx.olap.aggregators
mx.preloaders
mx.printing
mx.resources
mx.rpc
mx.rpc.events
mx.rpc.http
mx.rpc.http.mxml
mx.rpc.livecycle
mx.rpc.mxml
mx.rpc.remoting
mx.rpc.remoting.mxml
mx.rpc.soap
mx.rpc.soap.mxml
mx.rpc.wsdl
mx.rpc.xml
mx.skins
mx.skins.halo
mx.skins.spark
mx.skins.wireframe
mx.skins.wireframe.windowChrome
mx.states
mx.styles
mx.utils
mx.validators
org.osmf.containers
org.osmf.display
org.osmf.elements
org.osmf.events
org.osmf.layout
org.osmf.logging
org.osmf.media
org.osmf.metadata
org.osmf.net
org.osmf.net.dvr
org.osmf.net.httpstreaming
org.osmf.net.metrics
org.osmf.net.qos
org.osmf.net.rtmpstreaming
org.osmf.net.rules
org.osmf.traits
org.osmf.utils
spark.accessibility
spark.automation.delegates
spark.automation.delegates.components
spark.automation.delegates.components.gridClasses
spark.automation.delegates.components.mediaClasses
spark.automation.delegates.components.supportClasses
spark.automation.delegates.skins.spark
spark.automation.events
spark.collections
spark.components
spark.components.calendarClasses
spark.components.gridClasses
spark.components.mediaClasses
spark.components.supportClasses
spark.components.windowClasses
spark.core
spark.effects
spark.effects.animation
spark.effects.easing
spark.effects.interpolation
spark.effects.supportClasses
spark.events
spark.filters
spark.formatters
spark.formatters.supportClasses
spark.globalization
spark.globalization.supportClasses
spark.layouts
spark.layouts.supportClasses
spark.managers
spark.modules
spark.preloaders
spark.primitives
spark.primitives.supportClasses
spark.skins
spark.skins.mobile
spark.skins.mobile.supportClasses
spark.skins.spark
spark.skins.spark.mediaClasses.fullScreen
spark.skins.spark.mediaClasses.normal
spark.skins.spark.windowChrome
spark.skins.wireframe
spark.skins.wireframe.mediaClasses
spark.skins.wireframe.mediaClasses.fullScreen
spark.transitions
spark.utils
spark.validators
spark.validators.supportClasses
xd.core.axm.enterprise.view.components
xd.core.axm.enterprise.view.skins
xd.core.axm.view.components
xd.core.axm.view.components.support

Элементы языка

Глобальные константы
Глобальные функции
Операторы
Инструкции, ключевые слова и директивы
Специальные типы

Приложения

Новые возможности
Ошибки компилятора
Предупреждения компилятора
Ошибки времени выполнения
Миграция ActionScript 3
Поддерживаемые наборы символов
Только MXML
Элементы движения XML
Теги Timed Text
устаревший_индекс
Константы реализации специальных возможностей
Использование примеров
Юридическая информация
Пакетair.update
Классpublic class ApplicationUpdaterUI
НаследованиеApplicationUpdaterUI Inheritance EventDispatcher Inheritance Object

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

Класс ApplicationUpdaterUI определяет основные функциональные возможности инфраструктуры обновления приложений Adobe® AIR® и предоставляет пользовательский интерфейс по умолчанию. (Класс ApplicationUpdater включает в себя возможность обновления без реализации пользовательского интерфейса по умолчанию.)

Этот класс включен в файл 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
 Inheritedconstructor : 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
 Inherited
addEventListener(type:String, listener:Function, useCapture:Boolean = false, priority:int = 0, useWeakReference:Boolean = false):void
Регистрирует объект прослушивателя события на объекте EventDispatcher для получения прослушивателем уведомления о событии.
EventDispatcher
  
    addResources(lang:String, res:Object):void
Динамически добавляет новый пакет ресурсов для указанного языка.
ApplicationUpdaterUI
  
    cancelUpdate():void
Отменяет процесс обновления.
ApplicationUpdaterUI
  
    checkNow():void
Начинает процесс обновления.
ApplicationUpdaterUI
 Inherited
Посылает событие в поток событий.
EventDispatcher
 Inherited
Проверяет, имеет ли объект EventDispatcher прослушиватели, зарегистрированные для определенного типа события.
EventDispatcher
 Inherited
Показывает, определено ли заданное свойство для объекта.
Object
  
    initialize():void
Выполняет инициализацию программы обновления.
ApplicationUpdaterUI
  
Начинает процесс обновления с помощью локального файла AIR.
ApplicationUpdaterUI
 Inherited
Показывает, есть ли экземпляр класса Object в цепи прототипов объекта, заданного в качестве параметра.
Object
 Inherited
Показывает наличие заданного свойства и его перечисляемость.
Object
 Inherited
removeEventListener(type:String, listener:Function, useCapture:Boolean = false):void
Удаляет прослушиватель из объекта EventDispatcher.
EventDispatcher
 Inherited
Задает доступность динамического свойства для операций цикла.
Object
 Inherited
Возвращает строковое представление этого объекта, отформатированного в соответствии со стандартами, принятыми для данной локали.
Object
 Inherited
Возвращает строковое представление заданного объекта.
Object
 Inherited
Возвращает элементарное значение заданного объекта.
Object
 Inherited
Проверяет, зарегистрирован ли прослушиватель события для указанного типа события с данным объектом EventDispatcher или любым его предшественником.
EventDispatcher
События
 Событие Сводка Определено
 Inherited[многоадресное событие] Отправляется, когда проигрыватель Flash Player или приложение AIR перемещается в фокус операционной системы и становится активным.EventDispatcher
  Отправляется непосредственно перед установкой обновления, после вызова метода installUpdate().ApplicationUpdaterUI
  Отправляется до начала процесса обновления, непосредственно перед попыткой программы обновления загрузить файл дескриптора обновления.ApplicationUpdaterUI
 Inherited[многоадресное событие] Отправляется, когда проигрыватель Flash Player или приложение AIR теряет фокус системы и становится неактивным.EventDispatcher
  Отправляется при завершении загрузки файла обновления.ApplicationUpdaterUI
  Отправляется в случае ошибки подключения к файлу обновления или его загрузки.ApplicationUpdaterUI
  Отправляется после вызова метода downloadUpdate() и установки подключения к серверу.ApplicationUpdaterUI
  
    error
Отправляется при возникновении ошибки во время инициализации или процесса обновления (если произошло непредвиденное событие).ApplicationUpdaterUI
  Отправляется в случае ошибки проверки файла, переданного в качестве параметра airFile в вызов метода installFromAIRFile().ApplicationUpdaterUI
  Отправляется после успешной проверки программой обновления файла в вызове метода installFromAIRFile().ApplicationUpdaterUI
  
    initialized
Отправляется после завершения инициализации.ApplicationUpdaterUI
  
    progress
Загружается файл, отправленный в качестве обновления.ApplicationUpdaterUI
  
    updateError
Отправляется в случае ошибки загрузки или разбора файла дескриптора обновления.ApplicationUpdaterUI
  
    updateStatus
Отправляется после успешной загрузки и интерпретации файла дескриптора обновления программой обновления.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

свойство 
isUpdateInProgress:Boolean  [только для чтения]

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

Свойство, принимающее логическое значение true, если выполняется обновление, и значение false, если нет.



Реализация
    public function get isUpdateInProgress():Boolean
    

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 — Этот объект содержит ключи и значения для перевода. Ключи берутся из файла свойств языка. В таблице ниже приведены возможные ключи (названия свойств).

Ключ Русское значение Диалоговое окно Описание
appWidth 530 Все Ширина диалогового окна.
titleWindow Обновление: Все Отображается в строке заголовка собственного окна перед именем приложения.
titleCheck Проверить наличие обновлений Проверка наличия обновлений Заголовок диалогового окна.
msgCheck Разрешить приложению выполнить проверку наличия обновлений? Проверка наличия обновлений Сообщение диалогового окна.
btnCheck Проверить наличие обновлений Проверка наличия обновлений Метка кнопки «Проверить наличие обновлений».
btnCancel Отмена Все диалоговые окна с кнопкой «Отмена» Метка кнопки «Отмена».
titleCheckNoUpdates Нет доступных обновлений Проверка наличия обновлений – Нет доступных обновлений Заголовок диалогового окна.
msgCheckNoUpdates Нет доступных обновлений для приложения. Проверка наличия обновлений – Нет доступных обновлений Сообщение диалогового окна.
btnClose Закрыть Все диалоговые окна с кнопкой «Закрыть» Метка кнопки «Закрыть».
titleCheckError Ошибка обновления Проверка наличия обновлений – Ошибка подключения Заголовок диалогового окна.
msgCheckError Во время проверки обновлений произошла ошибка. Ошибка# {0} Проверка наличия обновлений — Ошибка подключения Сообщение диалогового окна. Символ {0} будет заменен на идентификатор ошибки.
titleUpdate Доступно обновление Доступно обновление Заголовок диалогового окна.
msgUpdate Обновленная версия приложения доступна для загрузки. Доступно обновление Сообщение диалогового окна.
lblApplication Приложение: Доступно обновление Метка, отображаемая перед именем приложения.
lblInstalledVersion Установленная версия: Доступно обновление Метка, отображаемая перед обозначением установленной версии.
lblAvailableVersion Версия обновления: Доступно обновление Метка, отображаемая перед обозначением версии обновления.
btnDownload Загрузить сейчас Доступно обновление Метка кнопки «Загрузить сейчас»
btnDownloadLater Загрузить позже Доступно обновление Метка кнопки «Загрузить позже»
lnkReleaseNotes Заметки о выпуске Все со ссылкой на заметки о выпуске Имя ссылки «Заметки о выпуске».
titleProgress Ход загрузки... Ход загрузки Заголовок диалогового окна.
msgProgress Загрузка обновления Ход загрузки Сообщение диалогового окна.
titleDownloadError Ошибка загрузки Ошибка загрузки Заголовок диалогового окна.
msgDownloadError Во время загрузки обновления произошла ошибка. Ошибка# {0} Ошибка загрузки Сообщение диалогового окна. Символ {0} будет заменен на идентификатор ошибки.
titleInstall Установить обновление Установка обновления Заголовок диалогового окна.
msgInstall Обновление для приложения загружено и готово к установке. Установка обновления Сообщение диалогового окна.
btnInstall Установить сейчас Установка обновления Метка кнопки «Установить»
btnInstallLater Отложить до следующего запуска Установка обновления Метка кнопки «Отложить до следующего запуска»
titleFileUpdate Доступно обновление Файл – Доступно обновление Заголовок диалогового окна.
msgFileUpdate Файл содержит обновленную версию приложения. Установить? Файл — Доступно обновление Сообщение диалогового окна.
lblFile Файл: Файл — Доступно обновление Метка, отображаемая перед именем файла
titleFileNoUpdate Нет доступных обновлений Файл — Нет доступных обновлений Заголовок диалогового окна.
msgFileNoUpdate Файл не содержит более новую версию приложения. Файл – Нет доступных обновлений Сообщение диалогового окна.
titleFileError Ошибка файла Файл — Ошибка Заголовок диалогового окна.
msgFileError Во время проверки файла обновления произошла ошибка. Ошибка# {0} Файл – Ошибка Сообщение диалогового окна. Символ {0} будет заменен на идентификатор ошибки.
titleUnexpectedError Непредвиденная ошибка Непредвиденная ошибка Заголовок диалогового окна.
msgUnexpectedError Произошла непредвиденная ошибка. Ошибка# {0} Непредвиденная ошибка Сообщение диалогового окна. Символ {0} будет заменен на идентификатор ошибки.

Связанные элементы 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:UpdateEvent — Отправляется непосредственно перед началом процесса обновления.

    initialize

()метод 
public function initialize():void

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

Выполняет инициализацию программы обновления. При вызове данного метода происходит следующее:

  1. Выполняется инициализация инфраструктуры обновления с автоматической (и синхронной) установкой ожидающих обновлений. Этот метод следует вызывать при запуске приложения, так как он может вызвать перезапуск приложения.

  2. Выполняется проверка наличия отложенных обновлений и их установка.

  3. Если во время установки предыдущего обновления произошла ошибка, выполняется очистка файла обновления и данных о версии в области хранилища.

  4. Если срок задержки периодического таймера истек, начинается процесс обновления; в противном случае запускается периодический таймер. Однако при тестировании приложения в программе AIR Debug Launcher (ADL) попытка обновить приложение приводит к исключению IllegalOperationError.


События
initialized:UpdateEvent — Инициализация завершена.
 
error:ErrorEvent — Во время инициализации произошла ошибка.

    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:StatusFileUpdateEvent — Отправляется после успешной проверки файла AIR программой обновления.
 
updateError:StatusFileUpdateErrorEvent — Отправляется в случае ошибки разбора файла дескриптора обновления.
Сведения о событии
    

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.

Это событие имеет следующие свойства:

СвойствоЗначение
bubblesfalse
cancelablefalse; поведение по умолчанию, подлежащее отмене, не определено.
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.

Это событие имеет следующие свойства:

СвойствоЗначение
bubblesfalse
cancelablefalse; поведение по умолчанию, подлежащее отмене, не определено.
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.

Это событие имеет следующие свойства:

СвойствоЗначение
bubblesfalse
cancelablefalse; поведение по умолчанию, подлежащее отмене, не определено.
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.

Это событие имеет следующие свойства:

СвойствоЗначение
bubblesfalse
cancelablefalse; поведение по умолчанию, подлежащее отмене, не определено.
currentTargetОбъект, активно обрабатывающий объект Event с помощью прослушивателя событий.
targetОбъект обновления.
    

error

Событие  
Тип объекта события: flash.events.ErrorEvent
свойство ErrorEvent.type = flash.events.ErrorEvent.ERROR

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

Отправляется при возникновении ошибки во время инициализации или процесса обновления (если произошло непредвиденное событие).

Определяет значение свойства type объекта события error.

Это событие имеет следующие свойства:

СвойствоЗначение
bubblesfalse
cancelablefalse; поведение по умолчанию, подлежащее отмене, не определено.
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.

Это событие имеет следующие свойства:

СвойствоЗначение
bubblesfalse
cancelablefalse; поведение по умолчанию, подлежащее отмене, не определено.
currentTargetОбъект, активно обрабатывающий объект Event с помощью прослушивателя событий.
targetОбъект обновления.
    

progress

Событие  
Тип объекта события: flash.events.ProgressEvent
свойство ProgressEvent.type = flash.events.ProgressEvent.PROGRESS

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

Загружается файл, отправленный в качестве обновления.

Задает значение свойства type для объекта события progress.

Это событие имеет следующие свойства:

СвойствоЗначение
bubblesfalse
bytesLoadedЧисло элементов или байтов, загруженных на момент обработки события прослушивателем.
bytesTotalОбщее число элементов или байтов, которые в итоге будут получены в случае успешного завершения загрузки.
cancelablefalse; поведение по умолчанию, подлежащее отмене, не определено.
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 и более поздних версий) Метка версии из дескриптора программы обновления. Метка версии должна отображаться для пользователей вместо версии. Если метка версии не указана, это свойство является пустой строкой.




[ X ]Почему по-английски?
Содержимое Справочника ActionScript 3.0 отображается на английском языке

Не все части Справочника ActionScript 3.0 переводятся на все языки. Если какой-то текстовый элемент не переведен, он отображается на английском языке. Например, компонент ga.controls.HelpBox не переведен ни на один из языков. Это значит, что в русской версии справки компонент ga.controls.HelpBox будет отображаться на английском языке.