| Paquete | air.update |
| Clase | public class ApplicationUpdaterUI |
| Herencia | ApplicationUpdaterUI  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. La versión del directorio frameworks/libs/air en el SDK de AIR 2 es para el desarrollo de Flex 4. Si usa Flex 3, utilice la versión del subdirectorio frameworks/libs/air/flex3.
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.
La clase AIRUpdateUI implementa una interfaz de usuario predeterminada para que la pueda utilizar la aplicación. Proporciona al usuario información básica y opciones relacionadas con las actualizaciones de la aplicación.
El proceso de actualización abarca una secuencia de estados:
| Estado | 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 install | 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. | ApplicationUpdaterUI | ||
 | constructor : Object
Una referencia a la clase de objeto o función constructora para una instancia de objeto determinada. | Object | |
| currentVersion : String [solo lectura]
La versión actual de la aplicación. | ApplicationUpdaterUI | ||
| delay : Number
El intervalo, en días, entre las comprobaciones periódicas de nuevas actualizaciones. | ApplicationUpdaterUI | ||
| isCheckForUpdateVisible : Boolean
Activa la visibilidad de los cuadros de diálogo de comprobación de actualizaciones, ausencia de actualizaciones o errores de actualización. | ApplicationUpdaterUI | ||
| isDownloadProgressVisible : Boolean
Activa la visibilidad del cuadro de diálogo de descarga de actualización. | ApplicationUpdaterUI | ||
| isDownloadUpdateVisible : Boolean
Activa la visibilidad del cuadro de diálogo de descarga de actualización. | ApplicationUpdaterUI | ||
| isFileUpdateVisible : Boolean
Activa la visibilidad de los cuadros de diálogo de actualización de archivo, archivos sin actualización y errores de archivo. | ApplicationUpdaterUI | ||
| isFirstRun : Boolean [solo lectura]
Indica si se trata de la primera ejecución tras una actualización correcta (true) o no (false). | ApplicationUpdaterUI | ||
| isInstallUpdateVisible : Boolean
Activa la visibilidad del cuadro de diálogo de instalación de actualizaciones. | ApplicationUpdaterUI | ||
| isNewerVersionFunction : Function
Una función que el proceso de actualización debe utilizar para llevar a cabo comparaciones de versiones. | ApplicationUpdaterUI | ||
| isUnexpectedErrorVisible : Boolean
Activa la visibilidad del cuadro de diálogo de error inesperado. | ApplicationUpdaterUI | ||
| isUpdateInProgress : Boolean [solo lectura]
Una propiedad Boolean. Es true si hay una actualización en curso; en caso contrario, false. | ApplicationUpdaterUI | ||
| localeChain : Array
Un conjunto que define la cadena de configuración regional usada por la interfaz del usuario. | ApplicationUpdaterUI | ||
| previousApplicationStorageDirectory : File [solo lectura]
La ubicación anterior del directorio de almacenamiento aplicaciones, si ha cambiado tras alguna actualización. | ApplicationUpdaterUI | ||
| previousVersion : String [solo lectura]
La versión anterior de la aplicación. | ApplicationUpdaterUI | ||
| updateDescriptor : XML [solo lectura]
El contenido del archivo descriptor de la aplicación descargado de la dirección URL de actualización. | ApplicationUpdaterUI | ||
| updateURL : String
La ubicación del archivo descriptor de la aplicación. | ApplicationUpdaterUI | ||
| wasPendingUpdate : Boolean [solo lectura]
Indica si hay una actualización aplazada, incluso si no se ha instalado correctamente (true); false en caso contrario. | ApplicationUpdaterUI | ||
| Método | Definido por | ||
|---|---|---|---|
La función del constructor. | ApplicationUpdaterUI | ||
| 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 | |
Añade dinámicamente un nuevo lote de recursos para el idioma especificado. | ApplicationUpdaterUI | ||
Cancela el proceso de actualización. | ApplicationUpdaterUI | ||
Inicia el proceso de actualización. | ApplicationUpdaterUI | ||
|
Distribuye un evento en el flujo del evento. | EventDispatcher | |
|
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. | ApplicationUpdaterUI | ||
Inicia el proceso de actualización usando un archivo de AIR local. | ApplicationUpdaterUI | ||
|
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(). | ApplicationUpdaterUI | |||
| 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. | ApplicationUpdaterUI | |||
| [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. | ApplicationUpdaterUI | |||
| Se distribuye si se produce un error durante la conexión o la descarga del archivo de actualización. | ApplicationUpdaterUI | |||
| Se distribuye después de una llamada al método downloadUpdate() y cuando se establece la conexión con el servidor. | ApplicationUpdaterUI | |||
| Se distribuye cuando se produce un error, bien durante la inicialización o durante el proceso de actualización (si ocurre algo inesperado). | ApplicationUpdaterUI | |||
| Se distribuye cuando se produce un error al validar el archivo transferido como parámetro airFile en una llamada al método installFromAIRFile(). | ApplicationUpdaterUI | |||
| Se distribuye cuando el archivo de actualización valida correctamente el archivo en la llamada al método installFromAIRFile(). | ApplicationUpdaterUI | |||
| Se distribuye una vez finalizada la inicialización. | ApplicationUpdaterUI | |||
| Se distribuye durante el proceso de descarga del archivo de actualización. | ApplicationUpdaterUI | |||
| Se distribuye cuando se produce un error al intentar descargar o analizar archivo descriptor de la aplicación. | ApplicationUpdaterUI | |||
| Se distribuye cuando el archivo de actualización descarga e interpreta correctamente el archivo descriptor de la aplicación. | ApplicationUpdaterUI | |||
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. También cuenta con parámetros para determinar si la aplicación muestra diversos cuadros de diálogo durante el proceso de la aplicación. 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>
<defaultUI>
<dialog name="checkForUpdate" visible="true" />
<dialog name="downloadUpdate" visible="false" />
<dialog name="downloadProgress" visible="true" />
<dialog name="installUpdate" visible="true" />
</defaultUI>
</configuration>En lugar de cargar un archivo de configuración, se puede utilizar código ActionScript para definir las siguientes propiedades del objeto ApplicationUpdaterUI: delay, isCheckForUpdateVisible, isDownloadProgressVisible, isDownloadUpdateVisible, isFileUpdateVisible, isInstallUpdateVisible y updateURL.
Implementación
public function get configurationFile():File public function set configurationFile(value:File):voidElementos de API relacionados
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. El aplazamiento se puede establecer mediante esta propiedad o con el archivo de configuración. Cuando se establece el valor con ambos métodos, se utiliza el valor definido con esta propiedad.
El valor predeterminado es 0.
Implementación
public function get delay():Number public function set delay(value:Number):voidElementos de API relacionados
isCheckForUpdateVisible | propiedad |
isCheckForUpdateVisible:Boolean| Versión del lenguaje: | ActionScript 3.0 |
| Versiones de motor de ejecución: | AIR 1.5 |
Activa la visibilidad de los cuadros de diálogo de comprobación de actualizaciones, ausencia de actualizaciones o errores de actualización. Cuando se establece en true, el proceso de actualización muestra estos cuadros de diálogo como parte del proceso. También se puede establecer en el archivo de configuración de actualización. Un valor establecido con esta propiedad anula los parámetros del archivo del configuración de actualización.
Implementación
public function get isCheckForUpdateVisible():Boolean public function set isCheckForUpdateVisible(value:Boolean):void isDownloadProgressVisible | propiedad |
isDownloadProgressVisible:Boolean| Versión del lenguaje: | ActionScript 3.0 |
| Versiones de motor de ejecución: | AIR 1.5 |
Activa la visibilidad del cuadro de diálogo de descarga de actualización. Si se establece en true, el proceso de actualización muestra este cuadro de diálogo como parte del proceso. También se puede establecer en el archivo de configuración de actualización. Un valor establecido con esta propiedad anula los parámetros del archivo del configuración de actualización.
Implementación
public function get isDownloadProgressVisible():Boolean public function set isDownloadProgressVisible(value:Boolean):void isDownloadUpdateVisible | propiedad |
isDownloadUpdateVisible:Boolean| Versiones de motor de ejecución: | AIR 1.5 |
Activa la visibilidad del cuadro de diálogo de descarga de actualización. Cuando se establece en true, el proceso de actualización muestra estos cuadros de diálogo como parte del proceso. También se puede establecer en el archivo de configuración de actualización. Un valor establecido con esta propiedad anula los parámetros del archivo del configuración de actualización.
Implementación
public function get isDownloadUpdateVisible():Boolean public function set isDownloadUpdateVisible(value:Boolean):void isFileUpdateVisible | propiedad |
isFileUpdateVisible:Boolean| Versión del lenguaje: | ActionScript 3.0 |
| Versiones de motor de ejecución: | AIR 1.5 |
Activa la visibilidad de los cuadros de diálogo de actualización de archivo, archivos sin actualización y errores de archivo. Cuando se establece en true, el proceso de actualización muestra estos cuadros de diálogo como parte del proceso. También se puede establecer en el archivo de configuración de actualización. Un valor establecido con esta propiedad anula los parámetros del archivo del configuración de actualización.
Implementación
public function get isFileUpdateVisible():Boolean public function set isFileUpdateVisible(value:Boolean):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
isInstallUpdateVisible | propiedad |
isInstallUpdateVisible:Boolean| Versión del lenguaje: | ActionScript 3.0 |
| Versiones de motor de ejecución: | AIR 1.5 |
Activa la visibilidad del cuadro de diálogo de instalación de actualizaciones. Si se establece en true, el proceso de actualización muestra este cuadro de diálogo como parte del proceso. También se puede establecer en el archivo de configuración de actualización. Un valor establecido con esta propiedad anula los parámetros del archivo del configuración de actualización.
Implementación
public function get isInstallUpdateVisible():Boolean public function set isInstallUpdateVisible(value:Boolean):void 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;
}
isUnexpectedErrorVisible | propiedad |
isUnexpectedErrorVisible:Boolean| Versión del lenguaje: | ActionScript 3.0 |
| Versiones de motor de ejecución: | AIR 1.5 |
Activa la visibilidad del cuadro de diálogo de error inesperado. Si se establece en true, el proceso de actualización de la aplicación muestra este cuadro de diálogo como parte del proceso. También se puede establecer en el archivo de configuración de actualización. Un valor establecido con esta propiedad anula los parámetros del archivo del configuración de actualización.
Implementación
public function get isUnexpectedErrorVisible():Boolean public function set isUnexpectedErrorVisible(value:Boolean):void isUpdateInProgress | propiedad |
localeChain | propiedad |
localeChain:Array| Versión del lenguaje: | ActionScript 3.0 |
| Versiones de motor de ejecución: | AIR 1.5 |
Un conjunto que define la cadena de configuración regional usada por la interfaz del usuario. Normalmente, sólo utilizan esta propiedad los desarrolladores de JavaScript (HTML).
Los desarrolladores de Flex pueden utilizar la propiedad ResourceManager para gestionar la configuración regional.
De forma predeterminada, en una aplicación basada en HTML, los idiomas se ordenan en el conjunto Capabilities.languages y los diez idiomas admitidos por la interfaz de usuario. Si no se encuentra ninguna coincidencia, la interfaz de usuario utiliza el inglés.
Este ejemplo de JavaScript utiliza la arquitectura de localización HTML de AIR (incluida en el SDK de AIR). Ordena los idiomas comparándolos con la lista de idiomas y, después, establece el inglés como idioma de reserva predeterminado:
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;Implementación
public function get localeChain():Array public function set localeChain(value:Array):voidElementos de API relacionados
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 únicamente cuando 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):voidElementos de API relacionados
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
ApplicationUpdaterUI | () | Información sobre |
public function ApplicationUpdaterUI()| Versión del lenguaje: | ActionScript 3.0 |
| Versiones de motor de ejecución: | AIR 1.5 |
La función del constructor.
addResources | () | método |
public function addResources(lang:String, res:Object):void| Versión del lenguaje: | ActionScript 3.0 |
| Versiones de motor de ejecución: | AIR 1.5 |
Añade dinámicamente un nuevo lote de recursos para el idioma especificado. Los desarrolladores de JavaScript utilizan este método para añadir dinámicamente un nuevo idioma a los cuadros de diálogo que se visualizan en la interfaz de usuario del proceso de actualización. (Los desarrolladores de Flex pueden añadir directamente un nuevo idioma al paquete de recursos "ApplicationUpdaterDialogs".)
Parámetros
lang:String — El código de idioma (por ejemplo, "ro" para rumano).
| |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
res:Object — El objeto contiene las claves y valores para la traducción. Las claves son las que se incluyen en el archivo de propiedades de cada idioma. En la tabla siguiente se incluyen las posibles claves (nombres de propiedades).
|
Elementos de API relacionados
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".
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.
|
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.
|
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).
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.
La constanteUpdateEvent.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.
Este evento tiene las siguientes propiedades de sólo lectura:
-
isFirstRun(Boolean) Estruesi es la primera ejecución tras una actualización correcta;falseen caso contrario. -
previousVersion(String) La versión anterior de la aplicación antes de la actualización (se establece sólo siisfirstRunestrue). -
currentVersion(String) La versión del archivo descriptor de la aplicación de la versión instalada en ese momento.
UpdateEvent.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.
La constanteStatusUpdateEvent.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