Building Adobe AIR Applications

CREACIÓN DE APLICACIONES DE ADOBE AIR
Actualización de aplicaciones de AIR
appUpdater.installUpdate(file);
Al llamar a este método, updater instala una versión de actualización del archivo de AIR. El método incluye un
parámetro, file, que es un objeto File que hace referencia al archivo de AIR para usar como actualización.
El objeto ApplicationUpdater puede distribuir el evento beforeInstall como resultado de la llamada al método
installUpdate():
UpdateEvent.BEFORE_INSTALL: se distribuye justo antes de la instalación de la actualización. En ocasiones,
resulta útil evitar la instalación de la actualización en este momento, de modo que el usuario pueda completar el
trabajo actual antes de que continúe la actualización. Con la llamada al método preventDefault() del objeto
Event se pospone la instalación hasta el siguiente reinicio y no puede comenzar ningún proceso de actualización
adicional. (Se incluyen actualizaciones que podrían aparecer con la llamada al método checkNow() o debido a la
comprobaciones periódicas.)
Instalación desde un archivo arbitrario de AIR
Puede llamar al método installFromAIRFile() para instalar la versión de actualización desde un archivo de AIR en
el equipo del usuario:
appUpdater.installFromAIRFile();
Este método hace que updater instale una versión de actualización de la aplicación desde el archivo de AIR.
El método installFromAIRFile() puede distribuir los siguientes eventos:
StatusFileUpdateEvent.FILE_UPDATE_STATUS: se distribuye una vez que ApplicationUpdater ha validado
correctamente el archivo enviado utilizando el método installFromAIRFile(). Este evento tiene las propiedades
siguientes:
available: se establece en true si existe una versión distinta disponible a la de la aplicación actual; de lo
contrario, se establece en false (las versiones son las mismas).
version: cadena que representa la nueva versión disponible.
path: representa la ruta nativa del archivo de actualización.
Puede cancelar este evento si la propiedad disponible del objeto StatusFileUpdateEvent se define como true. La
cancelación del evento implica que no continúe la actualización. Llame al método installUpdate() para
continuar con la actualización cancelada.
StatusFileUpdateErrorEvent.FILE_UPDATE_ERROR: hubo un error y updater no pudo instalar la aplicación de AIR.
Cancelación del proceso de actualización
Puede llamar al método cancelUpdate() para cancelar el proceso de actualización:
appUpdater.cancelUpdate();
Este método cancela todas las descargas pendientes, elimina todos los archivos descargados incompletos y reinicia el
temporizador de comprobación periódica.
El método no realiza ninguna operación si el objeto updater se está inicializando.
Localización de la interfaz ApplicationUpdaterUI
La clase ApplicationUpdaterUI proporciona una interfaz de usuario predeterminada para el proceso de actualización.
Esto incluye cuadros de diálogo que permiten al usuario iniciar y cancelar el proceso y llevar a cabo otras operaciones
relacionadas.
Última modificación 30/10/2012
279