| Pacchetto | flash.desktop |
| Classe | public final class Updater |
| Ereditarietà | Updater  Object |
| Versione linguaggio: | ActionScript 3.0 |
| Versioni runtime: | AIR 1.0 |
update().
La classe Updater è supportata solo nel profilo desktop. Non è supportata per le applicazioni desktop estese (applicazioni installate con un programma di installazione nativo), né nel profilo AIR mobile o nei dispositivi AIR per TV. Consultate la proprietà Updater.isSupported.
Le applicazioni desktop estese (applicazioni installate con un programma di installazione nativo) possono scaricare una nuova versione del programma di installazione nativo e avviarla mediante il metodo File.openWithDefaultApplication().
Elementi API correlati
Nascondi proprietà pubbliche ereditate
Mostra proprietà pubbliche ereditate| Proprietà | Definito da | ||
|---|---|---|---|
 | constructor : Object
Un riferimento all'oggetto classe o alla funzione di costruzione per una determinata istanza di oggetto. | Object | |
| isSupported : Boolean [statico] [sola lettura]
La proprietà isSupported è impostata su true se la classe Updater è disponibile nella piattaforma corrente, altrimenti è impostata su false. | Updater | ||
| Metodo | Definito da | ||
|---|---|---|---|
Updater()
La funzione di costruzione per la classe Updater. | Updater | ||
|
Indica se per un oggetto è definita una proprietà specifica. | Object | |
|
Indica se un'istanza della classe Object si trova nella catena di prototipi dell'oggetto specificato come parametro. | Object | |
|
Indica se la proprietà specificata esiste ed è enumerabile. | Object | |
|
Imposta la disponibilità di una proprietà dinamica per le operazioni cicliche. | Object | |
|
Restituisce la rappresentazione in formato stringa di questo oggetto, formattato in base alle convenzioni specifiche per le versioni localizzate. | Object | |
|
Restituisce la rappresentazione in formato stringa dell'oggetto specificato. | Object | |
Aggiorna l'applicazione in esecuzione con la versione dell'applicazione contenuta nel file AIR specificato. | Updater | ||
|
Restituisce il valore di base dell'oggetto specificato. | Object | |
isSupported | proprietà |
isSupported:Boolean [sola lettura] | Versione linguaggio: | ActionScript 3.0 |
| Versioni runtime: | AIR 2 |
La proprietà isSupported è impostata su true se la classe Updater è disponibile nella piattaforma corrente, altrimenti è impostata su false.
Implementazione
public static function get isSupported():Boolean Updater | () | Funzione di costruzione |
public function Updater()| Versioni runtime: | AIR 1.0 |
La funzione di costruzione per la classe Updater. Tenete presente che il metodo update() non è un membro statico della classe. Dovete creare un'istanza di un oggetto Updater, quindi chiamare il metodo update() su tale istanza dell'oggetto.
update | () | metodo |
public function update(airFile:File, version:String):void| Versione linguaggio: | ActionScript 3.0 |
| Versioni runtime: | AIR 1.0 |
Aggiorna l'applicazione in esecuzione con la versione dell'applicazione contenuta nel file AIR specificato. L'applicazione contenuta nel file AIR deve avere lo stesso identificatore di applicazione (appID) dell'applicazione in esecuzione.
Se chiamate questo metodo, l'applicazione corrente viene chiusa (come se si chiamasse il metodo NativeApplication.exit()). Ciò è necessario perché Adobe AIR non è in grado di aggiornare completamente un'applicazione in esecuzione. Una volta installata la nuova versione dell'applicazione, l'applicazione viene avviata. Se non è possibile installare la nuova versione in fase di runtime (ad esempio, perché l'ID dell'applicazione non corrisponde a quello della versione esistente), il programma di installazione di AIR visualizza un messaggio di errore e la versione precedente viene riavviata.
La procedura di aggiornamento riavvia l'applicazione a prescindere dalla riuscita o meno dell'aggiornamento. Gli aggiornamenti possono non riuscire per svariati motivi, inclusi alcuni che esulano dal controllo dell'applicazione (ad esempio, privilegi insufficienti da parte dell'utente per installare l'applicazione). Le applicazioni devono essere in grado di individuare gli errori per evitare di ripetere tentativi di aggiornamento non riusciti. Il ciclo infinito risultante avrebbe come effetto la disattivazione dell'applicazione. Un modo per verificare la buona riuscita di un aggiornamento è scrivere il numero di versione corrente su un file prima di iniziare la procedura di aggiornamento, quindi confrontarlo con il numero di versione dell'applicazione che viene rilanciata.
Durante il test di un'applicazione mediante AIR Debug Launcher (ADL), una chiamata al metodo update() provoca un'eccezione IllegalOperationError.
In Mac OS, per installare la versione aggiornata di un'applicazione, l'utente deve disporre di privilegi di sistema adeguati per eseguire installazioni nella directory dell'applicazione. In Windows o Linux, l'utente deve avere privilegi di amministratore.
Se la versione aggiornata dell'applicazione richiede una versione aggiornata di runtime, la nuova versione del runtime viene installata. Per aggiornare il runtime, l'utente deve disporre di privilegi amministrativi per il computer.
Nota: per ragioni di sicurezza, è necessario specificare il parametro version. Richiedendo all'applicazione di verificare il numero di versione nel file AIR, l'applicazione evita di installare inavvertitamente vecchie versioni che potrebbero contenere vulnerabilità di sicurezza successivamente risolte.
Parametri
airFile:File — L'oggetto File che punta al file AIR contenente la versione aggiornata dell'applicazione.
| |
version:String — La versione richiesta nel nuovo file AIR. Perché l'aggiornamento abbia esito positivo, è necessario che la stringa nell'attributo version dell'elemento application principale del file descrittore dell'applicazione relativo al file AIR corrisponda a questo valore.
|
Genera
IllegalOperationError — Il metodo è stato chiamato quando in esecuzione in ADL.
|
Elementi API correlati
Esempio ( Come utilizzare questo esempio )
update() non è un metodo statico della classe. Create un'istanza di un oggetto Updater, quindi chiamate il metodo update() di tale oggetto.
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:44 PM Z