| Paquete | air.update |
| Clase | public class ApplicationUpdater |
| Herencia | ApplicationUpdater  EventDispatcher Object |
| Versión del lenguaje: | ActionScript 3.0 |
| Versiones de motor de ejecución: | AIR 1.5 |
Esta clase está incluida en el archivo applicationupdater_ui.swc del SDK de Adobe AIR. El archivo applicationupdater_ui.swc se encuentra en el directorio frameworks/libs/air del SDK de AIR.
Adobe ® Flex™ Builder™ carga esta clase automáticamente al crear un proyecto para Adobe AIR. Se debe incluir el archivo SWC al compilar la aplicación con el SDK de Adobe® Flex™.
Gestionar las actualizaciones de las aplicaciones puede llegar a ser complicado. El marco de la actualización de AIR proporciona API para ayudar a que los desarrolladores presenten buenas funciones de actualización en las aplicaciones de AIR. La funcionalidad del marco de la actualización de AIR ayuda a los desarrolladores del modo siguiente:
-
Comprobando periódicamente si hay actualizaciones en base a un intervalo de tiempo o a petición del usuario
-
Descargando archivos de AIR (actualizaciones) desde un origen web
-
Alertando al usuario la primera vez que ejecuta la versión recién instalada
-
Confirmando que el usuario desea comprobar si hay actualizaciones
-
Mostrando al usuario información sobre la versión de la nueva actualización
-
Mostrando al usuario el progreso de la descarga y la información sobre los posibles errores
El marco de la actualización de AIR permite almacenar información sobre la versión de la actualización de una aplicación de AIR en sencillos archivos XML de configuración. En la mayoría de aplicaciones, al definir los archivos de configuración e incluir algo de código básico, los resultados de funcionalidad de la actualización son buenos para el usuario.
Utilice la clase AIRUpdater si desea definir su propia interfaz de usuario en el marco de la actualización de AIR.
El proceso de actualización abarca una secuencia de estados. La propiedad currentState del objeto updater refleja el estado actual del proceso de actualización:
| currentState | Descripción |
|---|---|
| "UNINITIALIZED" | El proceso de actualización no se ha iniciado. |
| "INITIALIZING" | El proceso de actualización se está iniciando. |
| "READY" | El proceso de actualización se ha iniciado. |
| "BEFORE_CHECKING" | El proceso de actualización aún no ha encontrado el archivo descriptor de la actualización. |
| "CHECKING" | El proceso de actualización está buscando un archivo descriptor de la actualización. |
| "AVAILABLE" | El archivo descriptor de la actualización está disponible. |
| "DOWNLOADING" | El proceso de actualización está descargando el archivo de AIR. |
| "DOWNLOADED" | El proceso de actualización ha descargado el archivo de AIR. |
| "INSTALLING" | El proceso de actualización está instalando el archivo de AIR. |
| "PENDING_INSTALLING" | El proceso de actualización se ha iniciado y hay actualizaciones pendientes. |
Si se prueba la aplicación utilizando AIR Debug Launcher (ADL), al intentar actualizar la aplicación, el resultado será una excepción IllegalOperationError.
El marco de actualización de AIR sólo se admite en el perfil de escritorio. No se admite en aplicaciones de escritorio ampliado (aplicaciones instaladas con un archivo de instalación nativo), y no se admite en el perfil móvil (aplicaciones para iPhone escritas con ActionScript 3.0). Compruebe la propiedad Updater.isSupported en tiempo de ejecución para ver si se admite el marco de actualización.
Para obtener más información sobre el uso del marco de actualización de AIR, consulte el capítulo “Actualización de aplicaciones de AIR” de Creación de aplicaciones de Adobe AIR.
Elementos de API relacionados
Ocultar propiedades públicas heredadas
Mostrar propiedades públicas heredadas| Propiedad | Definido por | ||
|---|---|---|---|
| configurationFile : File
La ubicación del archivo de configuración que establece los valores de las propiedades delay y updateURL. | ApplicationUpdater | ||
 | constructor : Object
Una referencia a la clase de objeto o función constructora para una instancia de objeto determinada. | Object | |
| currentState : String [solo lectura]
El estado interno del actualizador. | ApplicationUpdater | ||
| currentVersion : String [solo lectura]
La versión actual de la aplicación. | ApplicationUpdater | ||
| delay : Number
El intervalo, en días, entre las comprobaciones periódicas de nuevas actualizaciones. | ApplicationUpdater | ||
| isFirstRun : Boolean [solo lectura]
Indica si se trata de la primera ejecución tras una actualización correcta (true) o no (false). | ApplicationUpdater | ||
| isNewerVersionFunction : Function
Una función que el proceso de actualización debe utilizar para llevar a cabo comparaciones de versiones. | ApplicationUpdater | ||
| previousApplicationStorageDirectory : File [solo lectura]
La ubicación anterior del directorio de almacenamiento aplicaciones, si ha cambiado tras alguna actualización. | ApplicationUpdater | ||
| previousVersion : String [solo lectura]
La versión anterior de la aplicación. | ApplicationUpdater | ||
| updateDescriptor : XML [solo lectura]
El contenido del archivo descriptor de la aplicación descargado de la dirección URL de actualización. | ApplicationUpdater | ||
| updateURL : String
La ubicación del archivo descriptor de la aplicación. | ApplicationUpdater | ||
| wasPendingUpdate : Boolean [solo lectura]
Indica si hay una actualización aplazada, incluso si no se ha instalado correctamente (true); false en caso contrario. | ApplicationUpdater | ||
| Método | Definido por | ||
|---|---|---|---|
La función del constructor. | ApplicationUpdater | ||
| addEventListener(type:String, listener:Function, useCapture:Boolean = false, priority:int = 0, useWeakReference:Boolean = false):void
Registra un objeto de detector de eventos con un objeto EventDispatcher, de modo que el detector reciba la notificación de un evento. | EventDispatcher | |
Cancela el proceso de actualización. | ApplicationUpdater | ||
Descarga e interpreta de forma asíncrona el archivo descriptor de la aplicación. | ApplicationUpdater | ||
Inicia el proceso de actualización. | ApplicationUpdater | ||
|
Distribuye un evento en el flujo del evento. | EventDispatcher | |
Descarga el archivo de actualización de forma asíncrona. | ApplicationUpdater | ||
|
Comprueba si el objeto EventDispatcher tiene detectores registrados para un tipo concreto de evento. | EventDispatcher | |
|
Indica si un objeto tiene definida una propiedad especificada. | Object | |
Inicializa el actualizador. | ApplicationUpdater | ||
Inicia el proceso de actualización usando un archivo de AIR local. | ApplicationUpdater | ||
Instala el archivo de actualización. | ApplicationUpdater | ||
|
Indica si hay una instancia de la clase Object en la cadena de prototipo del objeto especificado como parámetro. | Object | |
|
Indica si existe la propiedad especificada y si es enumerable. | Object | |
|
Elimina un detector del objeto EventDispatcher. | EventDispatcher | |
|
Establece la disponibilidad de una propiedad dinámica para operaciones de bucle. | Object | |
|
Devuelve la representación de cadena de este objeto, con formato según las convenciones específicas de configuración regional. | Object | |
|
Devuelve la representación de cadena del objeto especificado. | Object | |
|
Devuelve el valor simple del objeto especificado. | Object | |
|
Comprueba si hay registrado un detector de eventos con este objeto EventDispatcher o con cualquiera de sus ascendientes para el tipo de evento concreto. | EventDispatcher | |
| Evento | Resumen | Definido por | ||
|---|---|---|---|---|
| [evento broadcast] Se distribuye cuando Flash Player o AIR pasan a estar activos. | EventDispatcher | ||
| Se distribuye justo antes de instalar la actualización, una vez llamado el método installUpdate(). | ApplicationUpdater | |||
| Se distribuye antes de que se inicie el proceso de actualización, justo antes de que éste intente descargar el archivo descriptor de la actualización. | ApplicationUpdater | |||
| [evento broadcast] Se distribuye cuando Flash Player o de AIR pasan a estar inactivos. | EventDispatcher | ||
| Se distribuye cuando finaliza la descarga del archivo de actualización. | ApplicationUpdater | |||
| Se distribuye si se produce un error durante la conexión o la descarga del archivo de actualización. | ApplicationUpdater | |||
| Se distribuye después de una llamada al método downloadUpdate() y cuando se establece la conexión con el servidor. | ApplicationUpdater | |||
| Se distribuye cuando se produce un error, bien durante la inicialización o durante el proceso de actualización (si ocurre algo inesperado). | ApplicationUpdater | |||
| Se distribuye cuando se produce un error al validar el archivo transferido como parámetro airFile en una llamada al método installFromAIRFile(). | ApplicationUpdater | |||
| Se distribuye cuando el archivo de actualización valida correctamente el archivo en la llamada al método installFromAIRFile(). | ApplicationUpdater | |||
| Se distribuye una vez finalizada la inicialización. | ApplicationUpdater | |||
| Se distribuye durante el proceso de descarga del archivo de actualización. | ApplicationUpdater | |||
| Se distribuye cuando se produce un error al intentar descargar o analizar archivo descriptor de la aplicación. | ApplicationUpdater | |||
| Se distribuye cuando el archivo de actualización descarga e interpreta correctamente el archivo descriptor de la aplicación. | ApplicationUpdater | |||
configurationFile | propiedad |
configurationFile:File| Versión del lenguaje: | ActionScript 3.0 |
| Versiones de motor de ejecución: | AIR 1.5 |
La ubicación del archivo de configuración que establece los valores de las propiedades delay y updateURL. Si esta propiedad apunta a un archivo inexistente, al llamar al método initialize() se emitirá un error.
A continuación puede ver un archivo de configuración de muestra:
<?xml version="1.0" encoding="utf-8"?>
<configuration xmlns="http://ns.adobe.com/air/framework/update/configuration/1.0" >
<url>app:/server/update.xml</url>
<delay>1</delay>
</configuration>En lugar de cargar un archivo de configuración, se puede utilizar código ActionScript para establecer las propiedades delay y updateURL.
Implementación
public function get configurationFile():File public function set configurationFile(value:File):voidElementos de API relacionados
currentState | propiedad |
currentState:String [solo lectura] | Versión del lenguaje: | ActionScript 3.0 |
| Versiones de motor de ejecución: | AIR 1.5 |
El estado interno del actualizador. La propiedad puede configurarse con los siguientes valores:
-
"UNINITIALIZED": el proceso de actualización no se ha iniciado. -
"INITIALIZING": el proceso de actualización se está iniciando. -
"READY": el proceso de actualización se ha iniciado. -
"BEFORE_CHECKING": el proceso de actualización aún no ha encontrado el archivo descriptor de la actualización. -
"CHECKING": el proceso de actualización está buscando un archivo descriptor de la actualización. -
"AVAILABLE": el archivo descriptor de la actualización está disponible. -
"DOWNLOADING": el proceso de actualización está descargando el archivo de AIR. -
"DOWNLOADED": el proceso de actualización ha descargado el archivo de AIR. -
"INSTALLING": el proceso de actualización está instalando el archivo de AIR. -
"PENDING_INSTALLING": el proceso de actualización se ha iniciado y hay actualizaciones pendientes.
Implementación
public function get currentState():String currentVersion | propiedad |
currentVersion:String [solo lectura] | Versión del lenguaje: | ActionScript 3.0 |
| Versiones de motor de ejecución: | AIR 1.5 |
La versión actual de la aplicación. Esta propiedad se establece durante una llamada al método initialize(). Se establece en la versión del archivo descriptor de la aplicación.
Implementación
public function get currentVersion():String delay | propiedad |
delay:Number| Versión del lenguaje: | ActionScript 3.0 |
| Versiones de motor de ejecución: | AIR 1.5 |
El intervalo, en días, entre las comprobaciones periódicas de nuevas actualizaciones.
Un valor 0 (valor predeterminado) indica que el temporizador no está activo, por lo que no se lleva a cabo ninguna comprobación periódica. Se puede definir mediante esta propiedad o con el archivo de configuración. Si el valor se define con ambos métodos, se utiliza el valor establecido mediante esta propiedad.
El valor predeterminado es 0.
Implementación
public function get delay():Number public function set delay(value:Number):void isFirstRun | propiedad |
isFirstRun:Boolean [solo lectura] | Versión del lenguaje: | ActionScript 3.0 |
| Versiones de motor de ejecución: | AIR 1.5 |
Indica si se trata de la primera ejecución tras una actualización correcta (true) o no (false). El proceso de actualización establece este valor durante la llamada al método initialize(). El desarrollador debe comprobar que se ha establecido isFirstRun en true si es necesario migrar los datos de una versión a otra.
Implementación
public function get isFirstRun():BooleanElementos de API relacionados
isNewerVersionFunction | propiedad |
isNewerVersionFunction:Function| Versión del lenguaje: | ActionScript 3.0 |
| Versiones de motor de ejecución: | AIR 1.5 |
Una función que el proceso de actualización debe utilizar para llevar a cabo comparaciones de versiones. De forma predeterminada, el marco de la actualización compara las versiones para detectar si la versión del sitio remoto es más reciente que la de la aplicación instalada. Sin embargo, a veces la comparación predeterminada no coincide con el esquema de versiones del desarrollador. Establezca esta propiedad para suministrar una nueva función que realice la comparación.
La función predeterminada de comparación acepta versiones como x.y.z, donde x, y y z pueden ser letras o dígitos. Existen algunas condiciones especiales que la función de comparación predeterminada puede reconocer. Si la función de prueba encuentra "alpha", "beta" o "rc" en las cadenas de la versión, el orden es alpha < beta < rc.
Implementación
public function get isNewerVersionFunction():Function public function set isNewerVersionFunction(value:Function):voidEjemplo ( Cómo utilizar este ejemplo )
customFn, para el objeto appUpdate del proceso de actualización. La función del ejemplo es sencilla de forma intencionada. La función personalizada debe devolver un valor Boolean basado en las reglas del esquema de versiones.
appUpdate.isNewerVersionFunction = customFn;
function customFn (currentVersion:String, updateVersion:String):Boolean
{
return updateVersion > currentVersion;
}
previousApplicationStorageDirectory | propiedad |
previousApplicationStorageDirectory:File [solo lectura] | Versión del lenguaje: | ActionScript 3.0 |
| Versiones de motor de ejecución: | AIR 1.5 |
La ubicación anterior del directorio de almacenamiento aplicaciones, si ha cambiado tras alguna actualización. La ubicación del directorio de almacenamiento de aplicaciones cambia tras producirse una actualización con migración de certificado. Si no hay migración de certificado, el directorio de almacenamiento de aplicaciones no cambia cuando el usuario actualiza la aplicación. y esta propiedad se establece en null. Esta propiedad se establece durante una llamada al método initialize().
Un desarrollador puede firmar una nueva versión de la aplicación de AIR con un nuevo certificado si el desarrollador utiliza la opción -migrate al empaquetar el archivo de AIR con ADT. Si la versión de la nueva aplicación de AIR utiliza un nuevo certificado de firma, el directorio de almacenamiento local de la aplicación cambia cuando el usuario instala la nueva aplicación. Utilice esta propiedad para transferir datos desde el directorio de almacenamiento de aplicaciones antiguo al nuevo directorio (File.applicationStorageDirectory). Para obtener más información, consulte “Firma de un archivo de AIR para cambiar el certificado de la aplicación” en el capítulo “Creación de una aplicación de AIR mediante las herramientas de la línea de comandos” de la guía de desarrolladores de Adobe AIR.
Implementación
public function get previousApplicationStorageDirectory():File previousVersion | propiedad |
previousVersion:String [solo lectura] | Versión del lenguaje: | ActionScript 3.0 |
| Versiones de motor de ejecución: | AIR 1.5 |
La versión anterior de la aplicación. Esta propiedad se establece durante una llamada al método initialize(). Devuelve la versión anterior de la aplicación antes de la actualización (sólo se puede establecer si isfirstRun es true); en caso contrario, se establece en null.
Implementación
public function get previousVersion():String updateDescriptor | propiedad |
updateDescriptor:XML [solo lectura] | Versión del lenguaje: | ActionScript 3.0 |
| Versiones de motor de ejecución: | AIR 1.5 |
El contenido del archivo descriptor de la aplicación descargado de la dirección URL de actualización. Esta propiedad no es null sólo si el objeto updater distribuye un evento updateStatus.
Implementación
public function get updateDescriptor():XML updateURL | propiedad |
updateURL:String| Versión del lenguaje: | ActionScript 3.0 |
| Versiones de motor de ejecución: | AIR 1.5 |
La ubicación del archivo descriptor de la aplicación. Se acepta cualquier ubicación válida para una ruta URLRequest. Es el único parámetro obligatorio requerido por el proceso de actualización. Puede definir la dirección URL de actualización mediante esta propiedad o con el archivo de configuración. Si el valor se define con ambos métodos, el proceso de actualización utiliza el valor establecido mediante esta propiedad.
Implementación
public function get updateURL():String public function set updateURL(value:String):void wasPendingUpdate | propiedad |
wasPendingUpdate:Boolean [solo lectura] | Versión del lenguaje: | ActionScript 3.0 |
| Versiones de motor de ejecución: | AIR 1.5 |
Indica si hay una actualización aplazada, incluso si no se ha instalado correctamente (true); false en caso contrario. El proceso de actualización establece esta propiedad durante una llamada al método initialize(). Utilice las propiedades wasPendingUpdate y isFirstRun para comprobar si una actualización no se ha instalado correctamente (en cuyo caso, wasPendingUpdate se establece como true y isFirstRun como false).
Implementación
public function get wasPendingUpdate():BooleanElementos de API relacionados
ApplicationUpdater | () | Información sobre |
public function ApplicationUpdater()| Versión del lenguaje: | ActionScript 3.0 |
| Versiones de motor de ejecución: | AIR 1.5 |
La función del constructor.
cancelUpdate | () | método |
public function cancelUpdate():void| Versión del lenguaje: | ActionScript 3.0 |
| Versiones de motor de ejecución: | AIR 1.5 |
Cancela el proceso de actualización. Al llamar a este método, se cancelan las descargas pendientes, se eliminan los archivos descargados parcialmente y se reinicia el temporizador de comprobación periódica.
El proceso de actualización se puede cancelar en cualquier momento, salvo si la máquina de estados se encuentra en los estados "UNINITIALIZED" o "INITIALIZING". No ocurre nada si se le llama desde uno de los estados "UNINITIALIZED" o "INITIALIZING".
checkForUpdate | () | método |
public function checkForUpdate():void| Versión del lenguaje: | ActionScript 3.0 |
| Versiones de motor de ejecución: | AIR 1.5 |
Descarga e interpreta de forma asíncrona el archivo descriptor de la aplicación. Al llamar a este método, el estado del proceso de actualización pasa a "CHECKING". Llame a este método únicamente si se ha cancelado el evento checkForUpdate.
Este método sólo se ejecuta si el proceso de actualización se encuentra en el estado "BEFORE_CHECKING".
Eventos
updateStatus: — El proceso de actualización ha descargado e interpretado correctamente el archivo descriptor de actualización.
| |
updateError: — Se ha producido un error al intentar descargar o analizar archivo descriptor de la aplicación.
|
checkNow | () | método |
public function checkNow():void| Versión del lenguaje: | ActionScript 3.0 |
| Versiones de motor de ejecución: | AIR 1.5 |
Inicia el proceso de actualización. Llamar a este método no detiene el temporizador periódico; sin embargo, el método detecta que se está ejecutando un proceso de actualización y omitirá la iteración activa.
Este método sólo se ejecuta si el estado actual es "READY".
Este método puede hacer que el objeto updater distribuya el siguiente evento:
Eventos
checkForUpdate: — Se distribuye justo antes de que se inicie el proceso de actualización.
|
downloadUpdate | () | método |
public function downloadUpdate():void| Versión del lenguaje: | ActionScript 3.0 |
| Versiones de motor de ejecución: | AIR 1.5 |
Descarga el archivo de actualización de forma asíncrona. Al llamar a este método, el estado del proceso de actualización pasa a "DOWNLOADING". Se debe llamar a este método únicamente si se canceló el evento StatusUpdateEvent.UPDATE_STATUS cuando la propiedad available del evento era true.
Este método sólo se ejecuta si el estado actual es "AVAILABLE".
Eventos
downloadStart: — Se distribuye una vez establecida la conexión con el servidor.
| |
progress: — Se distribuye una vez finalizada la inicialización.
| |
downloadError: — Se distribuye si se produce un error durante la conexión o la descarga del archivo de actualización. También se distribuye para estados HTTP no válidos (como 404 - File not found).
|
initialize | () | método |
public function initialize():void| Versión del lenguaje: | ActionScript 3.0 |
| Versiones de motor de ejecución: | AIR 1.5 |
Inicializa el actualizador. Al cancelar este método ocurre lo siguiente:
-
Inicializa el marco de la actualización y en segundo plano (sincrónicamente), instala las actualizaciones pendientes. Debe llamar a este método durante el inicio de la aplicación, ya que tal vez la reinicie.
-
Comprueba si existe alguna actualización aplazada y, de ser así, la instala.
-
Si hubiera fallado algo en una actualización anterior, borra el archivo de actualización y la información sobre la versión de la zona de almacenamiento.
-
Si el temporizador periódico ha vencido, se inicia el proceso de actualización; en caso contrario, arranca el temporizador. Sin embargo, si se prueba la aplicación utilizando AIR Debug Launcher (ADL), al intentar actualizar la aplicación, el resultado será una excepción IllegalOperationError.
Eventos
initialized: — La inicialización ha concluido.
| |
error: — Se ha producido un error durante la inicialización.
|
installFromAIRFile | () | método |
public function installFromAIRFile(file:File):void| Versión del lenguaje: | ActionScript 3.0 |
| Versiones de motor de ejecución: | AIR 1.5 |
Inicia el proceso de actualización usando un archivo de AIR local.
Llamar a este método no afecta al proceso de actualización en curso (si el estado no es "DOWNLOADED").
Esta función resulta útil para una aplicación con el elemento customUpdateUI establecido en true en el archivo descriptor de la aplicación.
Al verificar una aplicación con AIR Debug Launcher (ADL), llamar a este método produce una excepción IllegalOperationError.
Parámetros
file:File — El archivo de AIR local que se va a instalar.
|
Eventos
fileUpdateStatus: — Se distribuye una vez que el proceso de actualización valida correctamente el archivo de AIR.
| |
updateError: — Se distribuye si se produce un error al intentar analizar el archivo descriptor de actualización.
|
installUpdate | () | método |
public function installUpdate():void| Versión del lenguaje: | ActionScript 3.0 |
| Versiones de motor de ejecución: | AIR 1.5 |
Instala el archivo de actualización. Al llamar al método, el estado del proceso pasa a "INSTALLING" y sólo debe llamarse si se canceló el evento downLoadComplete.
Llame a este método cuando el proceso de actualización se encuentre en el estado "DOWNLOADED". Si lo llama en cualquier otro estado, no producirá efecto alguno.
Al verificar una aplicación con AIR Debug Launcher (ADL), llamar a este método produce una excepción IllegalOperationError.
Eventos
beforeInstall: — Se distribuye justo antes de instalar la actualización. A veces, resulta útil evitar la instalación de la actualización en este momento, ya que el usuario podría perder todo el trabajo cuando el motor de ejecución cierre la aplicación para instalar la actualización.
|
beforeInstall | Evento |
air.update.events.UpdateEventpropiedad UpdateEvent.type =
air.update.events.UpdateEvent.BEFORE_INSTALL| Versión del lenguaje: | ActionScript 3.0 |
| Versiones de motor de ejecución: | AIR 1.5 |
Se distribuye justo antes de instalar la actualización, una vez llamado el método installUpdate(). A veces, resulta útil evitar la instalación de la actualización en este momento, ya que el usuario podría perder todo el trabajo cuando el motor de ejecución cierre la aplicación para instalar la actualización.
Al llamar a este método preventDefault(), se aplaza la instalación hasta el siguiente reinicio. Si llama al método preventDefault(), no se podrán iniciar procesos de actualización adicionales durante la sesión de la aplicación (mediante llamada al método installUpdate() o por comprobación periódica).
El comportamiento predeterminado de la biblioteca ApplicationUpdater es descargar el archivo descriptor de la actualización. Puede llamar al método preventDefault() para cancelar este comportamiento.
UpdateEvent.BEFORE_INSTALL define el valor de la propiedad type del objeto de evento para un evento beforeInstall.
Este evento tiene las propiedades siguientes:
| Propiedad | Valor |
|---|---|
bubbles | false |
cancelable | false; no hay ningún comportamiento predeterminado que cancelar. |
currentTarget | Objeto que procesa de forma activa el objeto de evento con un detector de eventos. |
target | El objeto updater. |
checkForUpdate | Evento |
air.update.events.UpdateEventpropiedad UpdateEvent.type =
air.update.events.UpdateEvent.CHECK_FOR_UPDATE| Versión del lenguaje: | ActionScript 3.0 |
| Versiones de motor de ejecución: | AIR 1.5 |
Se distribuye antes de que se inicie el proceso de actualización, justo antes de que éste intente descargar el archivo descriptor de la actualización. El proceso de actualización puede distribuir este evento como resultado de llamar directamente al método checkNow() o por el vencimiento del temporizador de la comprobación periódica.
UpdateEvent.CHECK_FOR_UPDATE define el valor de la propiedad type del objeto de evento para un evento checkForUpdate.
Este evento tiene las propiedades siguientes:
| Propiedad | Valor |
|---|---|
bubbles | false |
cancelable | false; no hay ningún comportamiento predeterminado que cancelar. |
currentTarget | Objeto que procesa de forma activa el objeto de evento con un detector de eventos. |
target | El objeto updater. |
downloadComplete | Evento |
air.update.events.UpdateEventpropiedad UpdateEvent.type =
air.update.events.UpdateEvent.DOWNLOAD_COMPLETE| Versión del lenguaje: | ActionScript 3.0 |
| Versiones de motor de ejecución: | AIR 1.5 |
Se distribuye cuando finaliza la descarga del archivo de actualización.
Normalmente, este evento se utiliza para visualizar un mensaje que pregunte al usuario si desea continuar con la instalación de la actualización.
El comportamiento predeterminado de la biblioteca ApplicationUpdater es llamar automáticamente al método installUpdate().
UpdateEvent.DOWNLOAD_COMPLETE define el valor de la propiedad type del objeto de evento para un evento downloadComplete.
Este evento tiene las propiedades siguientes:
| Propiedad | Valor |
|---|---|
bubbles | false |
cancelable | false; no hay ningún comportamiento predeterminado que cancelar. |
currentTarget | Objeto que procesa de forma activa el objeto de evento con un detector de eventos. |
target | El objeto updater. |
downloadError | Evento |
air.update.events.DownloadErrorEventpropiedad DownloadErrorEvent.type =
air.update.events.DownloadErrorEvent.DOWNLOAD_ERROR| Versión del lenguaje: | ActionScript 3.0 |
| Versiones de motor de ejecución: | AIR 1.5 |
Se distribuye si se produce un error durante la conexión o la descarga del archivo de actualización. También se distribuye para estados HTTP no válidos (como 404 - File not found).
Si se distribuye este evento, se reinicia automáticamente el temporizador periódico (si el desfase es superior a 0).
La constanteDownloadErrorEvent.DOWNLOAD_ERROR define el valor de la propiedad type del objeto de evento para un evento downloadError.
La propiedad errorID de un objeto DownloadErrorEvent es un entero que define la información del error (consulte la siguiente tabla). Una propiedad subErrorID adicional puede contener más información sobre el error.
| Código de error | Descripción |
|---|---|
| 16800 | Se produce durante la validación del archivo de actualización descargado. La propiedad subErrorID puede contener información adicional. |
| 16801 | Archivo de Adobe AIR no válido (falta application.xml). |
| 16802 | Archivo de Adobe AIR no válido (falta tipo MIME). |
| 16803 | Archivo de Adobe AIR no válido (formato). |
| 16804 | Archivo de Adobe AIR no válido (indicadores no válidos). |
| 16805 | Archivo de Adobe AIR no válido (compresión desconocida). |
| 16806 | Archivo de Adobe AIR no válido (nombre de archivo no válido). |
| 16807 | Archivo de Adobe AIR no válido (corrupto). |
| 16808 | El archivo de configuración no existe. |
| 16809 | La propiedad updateURL no está establecida. |
| 16810 | Reservado. |
| 16811 | Archivo de configuración no válido (versión de configuración desconocida). |
| 16812 | Archivo de configuración no válido (falta dirección URL). |
| 16813 | Archivo de configuración no válido (formato de aplazamiento). |
| 16814 | Archivo de configuración no válido (valores de defaultUI no válidos). |
| 16815 | Descriptor de actualización no válido (versión de descriptor desconocida). |
| 16816 | Descriptor de actualización no válido (falta versión de actualización). |
| 16817 | Descriptor de actualización no válido (descripción no válida). |
| 16818 | Error de E/S al guardar datos en el disco. La propiedad subErrorID puede contener información adicional. |
| 16819 | Error de seguridad durante la descarga. La propiedad subErrorID puede contener información adicional. |
| 16820 | Código de estado HTTP no válido. La propiedad subErrorID puede contener el código de estado no válido. |
| 16821 | Reservado. |
| 16822 | Error de E/S durante la descarga. La propiedad subErrorID puede contener información adicional. |
| 16823 | Error de final de archivo al guardar datos en el disco. La propiedad subErrorID puede contener información adicional. |
| 16824 | Descriptor de actualización no válido. La propiedad subErrorID puede contener información adicional. |
| 16825 | El archivo de actualización contiene una aplicación con distinto identificador. |
| 16826 | El archivo de actualización no contiene una versión más reciente de la aplicación. |
| 16827 | La versión del archivo de actualización no coincide con la del descriptor de actualización. |
| 16828 | No es posible actualizar la aplicación, la mayor parte de las veces porque se está ejecutando en AIR Debug Launcher (ADL). |
| 16829 | No se encuentra el archivo de actualización en el momento de la instalación. |
downloadStart | Evento |
air.update.events.UpdateEventpropiedad UpdateEvent.type =
air.update.events.UpdateEvent.DOWNLOAD_START| Versión del lenguaje: | ActionScript 3.0 |
| Versiones de motor de ejecución: | AIR 1.5 |
Se distribuye después de una llamada al método downloadUpdate() y cuando se establece la conexión con el servidor. Cuando se utiliza la biblioteca ApplicationUpdater, se suele querer que el controlador de eventos del evento muestra una barra de progreso para que el usuario pueda ver el progreso de la descarga.
UpdateEvent.DOWNLOAD_START define el valor de la propiedad type del objeto de evento para un evento downloadStart.
Este evento tiene las propiedades siguientes:
| Propiedad | Valor |
|---|---|
bubbles | false |
cancelable | false; no hay ningún comportamiento predeterminado que cancelar. |
currentTarget | Objeto que procesa de forma activa el objeto de evento con un detector de eventos. |
target | El objeto updater. |
error | Evento |
flash.events.ErrorEventpropiedad ErrorEvent.type =
flash.events.ErrorEvent.ERROR| Versión del lenguaje: | ActionScript 3.0 |
| Versiones de motor de ejecución: | AIR 1.5 |
Se distribuye cuando se produce un error, bien durante la inicialización o durante el proceso de actualización (si ocurre algo inesperado).
Define el valor de la propiedadtype de un objeto de evento error.
Este evento tiene las propiedades siguientes:
| Propiedad | Valor |
|---|---|
bubbles | false |
cancelable | false; no hay ningún comportamiento predeterminado que cancelar. |
currentTarget | Objeto que procesa de forma activa el objeto de evento con un detector de eventos. |
target | El objeto en el que se produce un error de operación de red. |
text | Texto que se mostrará como mensaje de error. |
fileUpdateError | Evento |
air.update.events.StatusFileUpdateErrorEventpropiedad StatusFileUpdateErrorEvent.type =
air.update.events.StatusFileUpdateErrorEvent.FILE_UPDATE_ERROR| Versión del lenguaje: | ActionScript 3.0 |
| Versiones de motor de ejecución: | AIR 1.5 |
Se distribuye cuando se produce un error al validar el archivo transferido como parámetro airFile en una llamada al método installFromAIRFile().
StatusUpdateErrorEvent.UPDATE_ERROR define el valor de la propiedad type del objeto de evento para un evento statusUpdateError.
fileUpdateStatus | Evento |
air.update.events.StatusFileUpdateEventpropiedad StatusFileUpdateEvent.type =
air.update.events.StatusFileUpdateEvent.FILE_UPDATE_STATUS| Versión del lenguaje: | ActionScript 3.0 |
| Versiones de motor de ejecución: | AIR 1.5 |
Se distribuye cuando el archivo de actualización valida correctamente el archivo en la llamada al método installFromAIRFile().
StatusUpdateEvent.UPDATE_STATUS define el valor de la propiedad type del objeto de evento para un evento updateStatus.
Este evento tiene las propiedades siguientes:
| Propiedad | Valor |
|---|---|
available | Indica si hay disponible una versión distinta a la de la aplicación activa (true); en caso contrario, es false (misma versión). |
path | La propiedad nativePath del objeto File de actualización especificada por el parámetro airFile en una llamada al método installFromAIRFile(). |
version | Indica la versión de la nueva actualización. |
initialized | Evento |
air.update.events.UpdateEventpropiedad UpdateEvent.type =
air.update.events.UpdateEvent.INITIALIZED| Versión del lenguaje: | ActionScript 3.0 |
| Versiones de motor de ejecución: | AIR 1.5 |
Se distribuye una vez finalizada la inicialización.
La constanteUpdateEvent.INITIALIZED define el valor de la propiedad type del objeto de evento para un evento initialized.
Este evento tiene las propiedades siguientes:
| Propiedad | Valor |
|---|---|
bubbles | false |
cancelable | false; no hay ningún comportamiento predeterminado que cancelar. |
currentTarget | Objeto que procesa de forma activa el objeto de evento con un detector de eventos. |
target | El objeto updater. |
progress | Evento |
flash.events.ProgressEventpropiedad ProgressEvent.type =
flash.events.ProgressEvent.PROGRESS| Versión del lenguaje: | ActionScript 3.0 |
| Versiones de motor de ejecución: | AIR 1.5 |
Se distribuye durante el proceso de descarga del archivo de actualización.
Define el valor de la propiedadtype de un objeto de evento progress.
Este evento tiene las propiedades siguientes:
| Propiedad | Valor |
|---|---|
bubbles | false |
bytesLoaded | Número de elementos o bytes cargados en el momento en que el detector procesa el evento. |
bytesTotal | Número total de elementos o bytes que se cargarán en última instancia si el proceso de carga se realiza correctamente. |
cancelable | false; no hay ningún comportamiento predeterminado que cancelar. |
currentTarget | Objeto que procesa de forma activa el objeto de evento con un detector de eventos. |
target | El objeto que informa sobre el progreso. |
updateError | Evento |
air.update.events.StatusUpdateErrorEventpropiedad StatusUpdateErrorEvent.type =
air.update.events.StatusUpdateErrorEvent.UPDATE_ERROR| Versión del lenguaje: | ActionScript 3.0 |
| Versiones de motor de ejecución: | AIR 1.5 |
Se distribuye cuando se produce un error al intentar descargar o analizar archivo descriptor de la aplicación.
Cuando el proceso de actualización distribuye este evento, el temporizador periódico se reinicia automáticamente (si el desfase es superior a 0). La aplicación debe considerar ocultar cualquier ventana de error cuando el proceso de actualización distribuya un nuevo evento checkForUpdate.
StatusUpdateErrorEvent.UPDATE_ERROR define el valor de la propiedad type del objeto de evento para un evento statusUpdateError.
updateStatus | Evento |
air.update.events.StatusUpdateEventpropiedad StatusUpdateEvent.type =
air.update.events.StatusUpdateEvent.UPDATE_STATUS| Versión del lenguaje: | ActionScript 3.0 |
| Versiones de motor de ejecución: | AIR 1.5 |
Se distribuye cuando el archivo de actualización descarga e interpreta correctamente el archivo descriptor de la aplicación.
El comportamiento predeterminado es iniciar la actualización si la propiedad available del objeto StatusUpdateEvent se establece en true. Este comportamiento se puede evitar sólo si se utiliza la clase ApplicationUpdater, no cuando se utiliza la clase ApplicationUpdatorUI.
StatusUpdateEvent.UPDATE_STATUS define el valor de la propiedad type del objeto de evento para un evento updateStatus.
Este evento tiene las propiedades siguientes:
| Propiedad | Valor |
|---|---|
available | Se establece en true si el archivo descriptor de la aplicación especifica una versión distinta a la de la aplicación actual; false en caso contrario (la versión es la misma). |
version | La cadena que representa la nueva versión disponible. |
details | Un conjunto que define la cadena details de cada uno de los idiomas admitidos. Si no hay ninguna descripción localizada, ésta se define como un conjunto donde el primer elemento es una cadena vacía ("") y el segundo elemento es la cadena de detalles. Si hay descripciones localizadas, cada elemento del conjunto será un conjunto con dos elementos. El primer elemento es el código de la configuración regional. El segundo es la descripción. Por ejemplo, el siguiente conjunto tiene subconjuntos de dos idiomas (inglés EE.UU. y francés): ["en-US", "Hello World"], ["fr", "Bonjour monde"]. Los idiomas se muestran en el mismo orden que en el descriptor de actualización. El texto de los detalles propiedad se especifica en el archivo descriptor de actualización. |
versionLabel | (AIR 2.5 y posterior) La etiqueta de la versión del descriptor de la aplicación de la actualización. La etiqueta de la versión debe mostrarse a usuarios en lugar de la versión. Si no se especifica ninguna etiqueta de versión, esta propiedad es una cadena vacía. |
Tue Jun 12 2018, 02:12 PM Z