| Paquete | flash.desktop |
| Clase | public final class Updater |
| Herencia | Updater  Object |
| Versión del lenguaje: | ActionScript 3.0 |
| Versiones de motor de ejecución: | AIR 1.0 |
update().
La clase Updater 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 de AIR ni perfiles de AIR para TV. Compruebe la propiedad Updater.isSupported.
Aplicación de escritorio ampliado (aplicaciones instaladas con un archivo de instalación nativo) que pueden descargar una nueva versión del archivo de instalación nativo e iniciarlo utilizando el método File.openWithDefaultApplication().
Elementos de API relacionados
Ocultar propiedades públicas heredadas
Mostrar propiedades públicas heredadas| Propiedad | Definido por | ||
|---|---|---|---|
 | constructor : Object
Una referencia a la clase de objeto o función constructora para una instancia de objeto determinada. | Object | |
| isSupported : Boolean [estática] [solo lectura]
La propiedad isSupported se establece en true si la clase Updater está disponible en la plataforma actual; en caso contrario, se establece en false. | Updater | ||
| Método | Definido por | ||
|---|---|---|---|
Updater()
La función constructora de la clase Updater. | Updater | ||
|
Indica si un objeto tiene definida una propiedad especificada. | Object | |
|
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 | |
|
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 | |
Actualiza la aplicación en ejecución con una versión de la aplicación contenida en el archivo de AIR especificado. | Updater | ||
|
Devuelve el valor simple del objeto especificado. | Object | |
isSupported | propiedad |
isSupported:Boolean [solo lectura] | Versión del lenguaje: | ActionScript 3.0 |
| Versiones de motor de ejecución: | AIR 2 |
La propiedad isSupported se establece en true si la clase Updater está disponible en la plataforma actual; en caso contrario, se establece en false.
Implementación
public static function get isSupported():Boolean Updater | () | Información sobre |
public function Updater()| Versiones de motor de ejecución: | AIR 1.0 |
La función constructora de la clase Updater. Tenga en cuenta que el método update() no es un miembro estático de la clase. Debe crear una instancia del objeto Updater y llamar a su método update().
update | () | método |
public function update(airFile:File, version:String):void| Versión del lenguaje: | ActionScript 3.0 |
| Versiones de motor de ejecución: | AIR 1.0 |
Actualiza la aplicación en ejecución con una versión de la aplicación contenida en el archivo de AIR especificado. La aplicación del archivo de AIR debe tener el mismo identificador de aplicación (appID) que la aplicación en ejecución.
Al llamar a este método, se cierra la aplicación actual (como si llamara al método NativeApplication.exit()). Es necesario realizar esta acción porque Adobe AIR no puede actualizar completamente una aplicación si ésta se está ejecutando. Una vez completada correctamente la instalación de la nueva versión de la aplicación, ésta se inicia. Si el motor de ejecución no consigue instalar correctamente la nueva versión (por ejemplo, si su ID de aplicación no coincide con la versión existente), el instalador de AIR presenta un mensaje de error al usuario y se vuelve a abrir la versión anterior.
El proceso de actualización vuelve a abrir la aplicación se haya realizado o no correctamente la actualización. Las actualizaciones pueden fallar por diversos motivos, algunos de ellos fuera del control de la aplicación (como la falta de privilegios de un usuario para instalar la aplicación). Las aplicaciones deben encargarse de detectar errores y evitar intentar la misma actualización fallida más de una vez. El bucle infinito resultante deshabilitaría definitivamente la aplicación. Una forma de conseguir actualizaciones correctas es escribir el número de versión actual en un archivo antes de iniciar la actualización y, después, compararlo con el número de versión cuando vuelva a abrirse la aplicación.
Al verificar la aplicación con AIR Debug Launcher (ADL), llamar al método update() produce una excepción IllegalOperationError.
En Mac OS, para instalar una versión actualizada de una aplicación, el usuario debe disponer de los privilegios necesarios para instalar aplicaciones en el directorio de aplicaciones. En Windows o en Linux, el usuario debe disponer de privilegios de administrador.
Si la versión actualizada de la aplicación requiere una versión actualizada del motor de ejecución, se instala la versión más reciente del motor de ejecución. Para actualizar el motor de ejecución, el usuario debe disponer de privilegios de administrador en el equipo.
Nota: es preciso especificar el parámetro version por motivos de seguridad. Al solicitar a la aplicación que verifique el número de versión del archivo de AIR, la aplicación no instala de forma accidental una versión anterior que aún pueda contener vulnerabilidades de seguridad solucionadas en versiones posteriores.
Parámetros
airFile:File — Objeto File que apunta al archivo de AIR que contiene la versión de actualización de la aplicación
| |
version:String — Versión requerida por el nuevo archivo de AIR. La cadena del atributo version del elemento application principal del archivo descriptor de la aplicación para el archivo de AIR debe coincidir con este valor para que la actualización se realice correctamente.
|
Emite
IllegalOperationError — Se llamó al método durante la ejecución en ADL.
|
Elementos de API relacionados
Ejemplo ( Cómo utilizar este ejemplo )
update() no es un método estático de la clase. Cree una instancia del objeto Updater y llame al método update() de dicho objeto.
import flash.fileSystem.File;
import flash.desktop.Updater;
var updater:Updater = new Updater();
var airFile:File = File.applicationStorageDirectory.resolvePath("Example Application.air");
var version:String = "2.01";
updater.update(airFile, version);
Tue Jun 12 2018, 02:12 PM Z