ApplicationUpdater  - AS3

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.

Elementos de API relacionados

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.

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.

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.

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.

Elementos de API relacionados

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.

appUpdate.isNewerVersionFunction = customFn; 

function customFn (currentVersion:String, updateVersion:String):Boolean 
{
    return updateVersion > currentVersion;
}

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.

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.

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.

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.

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).

Elementos de API relacionados

La función del constructor.

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".

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".

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:

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".

Inicializa el actualizador. Al cancelar este método ocurre lo siguiente:

1. 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.

2. Comprueba si existe alguna actualización aplazada y, de ser así, la instala.

3. 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.

4. 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.

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

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.

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.

Este evento tiene las propiedades siguientes:

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.

Este evento tiene las propiedades siguientes:

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().

Este evento tiene las propiedades siguientes:

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 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.

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.

Este evento tiene las propiedades siguientes:

Se distribuye cuando se produce un error, bien durante la inicialización o durante el proceso de actualización (si ocurre algo inesperado).

Este evento tiene las propiedades siguientes:

Se distribuye cuando se produce un error al validar el archivo transferido como parámetro airFile en una llamada al método installFromAIRFile().

Se distribuye cuando el archivo de actualización valida correctamente el archivo en la llamada al método installFromAIRFile().

Este evento tiene las propiedades siguientes:

Se distribuye una vez finalizada la inicialización.

Este evento tiene las propiedades siguientes:

Se distribuye durante el proceso de descarga del archivo de actualización.

Este evento tiene las propiedades siguientes:

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.

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.

Este evento tiene las propiedades siguientes: