| Pacchetto | air.update |
| Classe | public class ApplicationUpdater |
| Ereditarietà | ApplicationUpdater  EventDispatcher Object |
| Versione linguaggio: | ActionScript 3.0 |
| Versioni runtime: | AIR 1.5 |
Questa classe è inclusa nel file applicationupdater_ui.swc, incluso a propria volta nell'SDK Adobe AIR. Il file applicationupdater_ui.swc si trova nella directory frameworks/libs/air dell'SDK AIR.
Adobe ® Flex™ Builder™ carica automaticamente questa classe quando create un progetto per Adobe AIR. Dovete includere il file SWC quando compilate l'applicazione utilizzando l'SDK Adobe® Flex™.
La gestione degli aggiornamenti delle applicazioni può essere complicata. Il framework di aggiornamento AIR fornisce delle API che assistono gli sviluppatori nell'inserimento di buone funzionalità di aggiornamento nelle applicazioni AIR. La funzionalità nel framework di aggiornamento AIR assiste gli sviluppatori nell'esecuzione delle operazioni seguenti:
-
verifica periodica della presenza di aggiornamenti in base a un intervallo o alla richiesta dell'utente;
-
scaricamento dei file AIR (aggiornamenti) da un'origine Web;
-
notifica all'utente al momento della prima esecuzione della versione appena installata;
-
conferma che l'utente desidera verificare la presenza di aggiornamenti;
-
visualizzazione di informazioni sulla nuova versione di aggiornamento;
-
visualizzazione dell'avanzamento dello scaricamento e delle informazioni sugli errori.
Il framework di aggiornamento AIR consente di memorizzare informazioni sulla versione di aggiornamento di un'applicazione AIR sotto forma di semplici file XML di configurazione. Per la maggior parte delle applicazioni, l'impostazione di questi file di configurazione e l'inclusione di codice di base fornisce all'utente delle buone funzionalità di aggiornamento.
Utilizzate la classe AIRUpdater se desiderate definire un'interfaccia utente personalizzata da utilizzare con il framework di aggiornamento AIR.
Il processo di aggiornamento comprende una sequenza di stati. La proprietà currentState dell'oggetto Updater rispecchia lo stato corrente dell'aggiornamento:
| Valore di currentState | Descrizione |
|---|---|
| "UNINITIALIZED" | Il programma di aggiornamento non è stato inizializzato. |
| "INITIALIZING" | Il programma di aggiornamento è in fase di inizializzazione. |
| "READY" | Il programma di aggiornamento è stato inizializzato. |
| "BEFORE_CHECKING" | Il programma di aggiornamento non ha ancora verificato la presenza di un file descrittore di aggiornamento. |
| "CHECKING" | Il programma di aggiornamento sta verificando la presenza di un file descrittore di aggiornamento. |
| "AVAILABLE" | Il file descrittore di aggiornamento è disponibile. |
| "DOWNLOADING" | Il programma di aggiornamento sta scaricando il file AIR. |
| "DOWNLOADED" | Il programma di aggiornamento ha scaricato il file AIR. |
| "INSTALLING" | Il programma di aggiornamento sta installando il file AIR. |
| "PENDING_INSTALLING" | Il programma di aggiornamento è stato inizializzato e sono presenti degli aggiornamenti in sospeso. |
Quando tuttavia provate un'applicazione mediante l'applicazione AIR Debug Launcher (ADL), il tentativo di aggiornare l'applicazione genera un'eccezione IllegalOperationError.
Il framework di aggiornamento AIR è supportato solo nel profilo desktop. Non è supportato per le applicazioni desktop estese (applicazioni installate con un programma di installazione nativo), né nel profilo mobile (applicazioni iPhone scritte con ActionScript 3.0). Controllate la proprietà Updater.isSupported in fase runtime per verificare se il framework di aggiornamento è supportato.
Per informazioni dettagliate sull'uso del framework di aggiornamento AIR, vedete il capitolo "Aggiornamento di applicazioni AIR" in Creazione di applicazioni Adobe AIR.
Elementi API correlati
Nascondi proprietà pubbliche ereditate
Mostra proprietà pubbliche ereditate| Proprietà | Definito da | ||
|---|---|---|---|
| configurationFile : File
La posizione del file di configurazione che imposta i valori per le proprietà updateURL e delay. | ApplicationUpdater | ||
 | constructor : Object
Un riferimento all'oggetto classe o alla funzione di costruzione per una determinata istanza di oggetto. | Object | |
| currentState : String [sola lettura]
Lo stato interno del programma di aggiornamento. | ApplicationUpdater | ||
| currentVersion : String [sola lettura]
La versione corrente dell'applicazione. | ApplicationUpdater | ||
| delay : Number
L'intervallo, espresso in giorni, che intercorre tra la verifica periodica della presenza di nuovi aggiornamenti. | ApplicationUpdater | ||
| isFirstRun : Boolean [sola lettura]
Indica se questa è la prima esecuzione dopo un aggiornamento completato correttamente (true) o meno (false). | ApplicationUpdater | ||
| isNewerVersionFunction : Function
Una funzione che deve essere utilizzata dal programma di aggiornamento per effettuare i confronti tra le versioni. | ApplicationUpdater | ||
| previousApplicationStorageDirectory : File [sola lettura]
La posizione precedente della directory di memorizzazione dell'applicazione, se è cambiata dopo un aggiornamento. | ApplicationUpdater | ||
| previousVersion : String [sola lettura]
La versione precedente dell'applicazione. | ApplicationUpdater | ||
| updateDescriptor : XML [sola lettura]
Il contenuto del file descrittore di aggiornamento scaricato dall'URL di aggiornamento. | ApplicationUpdater | ||
| updateURL : String
La posizione del file descrittore di aggiornamento. | ApplicationUpdater | ||
| wasPendingUpdate : Boolean [sola lettura]
Indica se era presente un aggiornamento posticipato, anche se l'installazione non è riuscita (true); false, in caso contrario. | ApplicationUpdater | ||
| Metodo | Definito da | ||
|---|---|---|---|
La funzione di costruzione. | ApplicationUpdater | ||
| addEventListener(type:String, listener:Function, useCapture:Boolean = false, priority:int = 0, useWeakReference:Boolean = false):void
Registra un oggetto listener di eventi con un oggetto EventDispatcher, in modo che il listener riceva la notifica di un evento. | EventDispatcher | |
Annulla il processo di aggiornamento. | ApplicationUpdater | ||
Scarica e interpreta in modo asincrono il file descrittore di aggiornamento. | ApplicationUpdater | ||
Avvia il processo di aggiornamento. | ApplicationUpdater | ||
|
Invia un evento nel flusso di eventi. | EventDispatcher | |
Scarica in modo asincrono il file di aggiornamento. | ApplicationUpdater | ||
|
Verifica se per l'oggetto EventDispatcher sono presenti listener registrati per un tipo specifico di evento. | EventDispatcher | |
|
Indica se per un oggetto è definita una proprietà specifica. | Object | |
Inizializza il programma di aggiornamento. | ApplicationUpdater | ||
Avvia il processo di aggiornamento utilizzando un file AIR locale. | ApplicationUpdater | ||
Installa il file di aggiornamento. | ApplicationUpdater | ||
|
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 | |
|
Rimuove un listener dall'oggetto EventDispatcher. | EventDispatcher | |
|
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 | |
|
Restituisce il valore di base dell'oggetto specificato. | Object | |
|
Verifica se un listener di eventi è registrato con questo oggetto EventDispatcher o qualsiasi suo antenato per il tipo di evento specificato. | EventDispatcher | |
| Evento | Riepilogo | Definito da | ||
|---|---|---|---|---|
| [evento di trasmissione] Inviato quando Flash Player o l'applicazione AIR ottiene lo stato di attivazione del sistema operativo ed entra nello stato attivo. | EventDispatcher | ||
| Inviato appena prima di installare l'aggiornamento, dopo che è stato chiamato il metodo installUpdate(). | ApplicationUpdater | |||
| Inviato prima dell'avvio del processo, appena prima che il programma di aggiornamento tenti di scaricare il file descrittore di aggiornamento. | ApplicationUpdater | |||
| [evento di trasmissione] Inviato quando Flash Player o l'applicazione AIR perde l'attivazione del sistema operativo e sta entrando nello stato inattivo. | EventDispatcher | ||
| Inviato quando viene completato lo scaricamento del file di aggiornamento. | ApplicationUpdater | |||
| Inviato se si verifica un errore durante la connessione o durante lo scaricamento del file di aggiornamento. | ApplicationUpdater | |||
| Inviato dopo che è stato chiamato il metodo downloadUpdate() ed è stata stabilita la connessione al server. | ApplicationUpdater | |||
| Inviato quando si è verificato un errore durante l'inizializzazione o durante il processo di aggiornamento (in caso di imprevisto). | ApplicationUpdater | |||
| Inviato quando si verifica un errore durante la convalida del file passato come parametro airFile in una chiamata al metodo installFromAIRFile(). | ApplicationUpdater | |||
| Inviato dopo che il programma di aggiornamento ha convalidato con successo il file nella chiamata al metodo installFromAIRFile(). | ApplicationUpdater | |||
| Inviato al termine dell'inizializzazione. | ApplicationUpdater | |||
| Inviato quando il file di aggiornamento viene scaricato. | ApplicationUpdater | |||
| Inviato se si verifica un errore durante il tentativo di scaricare o analizzare il file descrittore di aggiornamento. | ApplicationUpdater | |||
| Inviato dopo che il programma di aggiornamento ha scaricato e interpretato correttamente il file descrittore di aggiornamento. | ApplicationUpdater | |||
configurationFile | proprietà |
configurationFile:File| Versione linguaggio: | ActionScript 3.0 |
| Versioni runtime: | AIR 1.5 |
La posizione del file di configurazione che imposta i valori per le proprietà delay e updateURL. Se questa proprietà fa riferimento a un file non esistente, la chiamata al metodo initialize() provoca la generazione di un errore.
Qui di seguito è riportato un esempio di file di configurazione:
<?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>Anziché caricare un file di configurazione, potete utilizzare il codice ActionScript per impostare le proprietà delay e updateURL.
Implementazione
public function get configurationFile():File public function set configurationFile(value:File):voidElementi API correlati
currentState | proprietà |
currentState:String [sola lettura] | Versione linguaggio: | ActionScript 3.0 |
| Versioni runtime: | AIR 1.5 |
Lo stato interno del programma di aggiornamento. La proprietà può essere impostata sui valori seguenti:
-
"UNINITIALIZED"- Il programma di aggiornamento non è stato inizializzato. -
"INITIALIZING"- Il programma di aggiornamento è in fase di inizializzazione. -
"READY"- Il programma di aggiornamento è stato inizializzato. -
"BEFORE_CHECKING"- Il programma di aggiornamento non ha ancora verificato la presenza di un file descrittore di aggiornamento. -
"CHECKING"- Il programma di aggiornamento sta verificando la presenza di un file descrittore di aggiornamento. -
"AVAILABLE"- Il file descrittore di aggiornamento è disponibile. -
"DOWNLOADING"- Il programma di aggiornamento sta scaricando il file AIR. -
"DOWNLOADED"- Il programma di aggiornamento ha scaricato il file AIR. -
"INSTALLING"- Il programma di aggiornamento sta installando il file AIR. -
"PENDING_INSTALLING"- Il programma di aggiornamento è stato inizializzato e sono presenti degli aggiornamenti in sospeso.
Implementazione
public function get currentState():String currentVersion | proprietà |
currentVersion:String [sola lettura] | Versione linguaggio: | ActionScript 3.0 |
| Versioni runtime: | AIR 1.5 |
La versione corrente dell'applicazione. Questa proprietà viene impostata durante una chiamata al metodo initialize(). Viene impostata sulla versione del file descrittore dell'applicazione.
Implementazione
public function get currentVersion():String delay | proprietà |
delay:Number| Versione linguaggio: | ActionScript 3.0 |
| Versioni runtime: | AIR 1.5 |
L'intervallo, espresso in giorni, che intercorre tra la verifica periodica della presenza di nuovi aggiornamenti.
Il valore 0 (predefinito) indica che il timer non è attivo, quindi non viene effettuata alcuna verifica periodica. L'impostazione avviene sia mediante questa proprietà sia mediante il file di configurazione. Quando il valore viene impostato mediante entrambi i metodi, viene utilizzato il valore impostato mediante questa proprietà.
Il valore predefinito è 0.
Implementazione
public function get delay():Number public function set delay(value:Number):void isFirstRun | proprietà |
isFirstRun:Boolean [sola lettura] | Versione linguaggio: | ActionScript 3.0 |
| Versioni runtime: | AIR 1.5 |
Indica se questa è la prima esecuzione dopo un aggiornamento completato correttamente (true) o meno (false). Il programma di aggiornamento imposta questo valore durante l chiamata al metodo initialize(). Lo sviluppatore deve controllare che isFirstRun sia impostato su true, se è necessario migrare dei dati da una versione all'altra.
Implementazione
public function get isFirstRun():BooleanElementi API correlati
isNewerVersionFunction | proprietà |
isNewerVersionFunction:Function| Versione linguaggio: | ActionScript 3.0 |
| Versioni runtime: | AIR 1.5 |
Una funzione che deve essere utilizzata dal programma di aggiornamento per effettuare i confronti tra le versioni. Per impostazione predefinita, il framework di aggiornamento confronta le versioni per verificare se la versione del sito remoto è più recente di quella dell'applicazione installata. Tuttavia, talvolta il confronto predefinito non corrisponde allo schema sulla versione dello sviluppatore. Impostate questa proprietà per fornire una nuova funzione che effettua il confronto.
La funzione di confronto predefinita accetta versioni quali x.y.z, dove x, y e z possono contenere lettere e cifre. Esistono alcune condizioni speciali che vengono riconosciute dalla funzione di confronto predefinita. Se la funzione di prova trova "alpha", "beta" o "rc" nelle stringhe relative alla versione, l'ordine è alpha < beta < rc.
Implementazione
public function get isNewerVersionFunction():Function public function set isNewerVersionFunction(value:Function):voidEsempio ( Come utilizzare questo esempio )
customFn, per l'oggetto Updater appUpdate. La funzione dell'esempio è volutamente semplice. La funzione personalizzata deve restituire un valore booleano basato sulle regole dello scherma sulla versione.
appUpdate.isNewerVersionFunction = customFn;
function customFn (currentVersion:String, updateVersion:String):Boolean
{
return updateVersion > currentVersion;
}
previousApplicationStorageDirectory | proprietà |
previousApplicationStorageDirectory:File [sola lettura] | Versione linguaggio: | ActionScript 3.0 |
| Versioni runtime: | AIR 1.5 |
La posizione precedente della directory di memorizzazione dell'applicazione, se è cambiata dopo un aggiornamento. La posizione della directory di memorizzazione dell'applicazione cambia dopo un aggiornamento con una migrazione di certificato. Se non è presente una migrazione di certificato, la directory di memorizzazione dell'applicazione non cambia quando l'utente aggiorna l'applicazione e questa proprietà viene impostata su null. Questa proprietà viene impostata durante una chiamata al metodo initialize().
Uno sviluppatore può firmare la nuova versione dell'applicazione AIR con un nuovo certificato se utilizza l'opzione -migrate quando distribuisce il file AIR sotto forma di pacchetto con ADT. Se una nuova versione di un'applicazione AIR utilizza un nuovo certificato di firma, la directory di memorizzazione locale dell'applicazione cambia quando l'utente installa la nuova versione. Utilizzate questa proprietà per trasferire i dati dalla precedente directory di memorizzazione dell'applicazione a quella nuova (File.applicationStorageDirectory). Per ulteriori informazioni, vedete la sezione "Firma di un file AIR per la modifica del certificato dell'applicazione" del capitolo "Creazione di un'applicazione AIR mediante gli strumenti della riga di comando" della guida per sviluppatori di Adobe AIR.
Implementazione
public function get previousApplicationStorageDirectory():File previousVersion | proprietà |
previousVersion:String [sola lettura] | Versione linguaggio: | ActionScript 3.0 |
| Versioni runtime: | AIR 1.5 |
La versione precedente dell'applicazione. Questa proprietà viene impostata durante una chiamata al metodo initialize(). Restituisce la versione precedente dell'applicazione prima dell'aggiornamento (impostata solo se isfirstRun è true); in caso contrario, è impostata su null.
Implementazione
public function get previousVersion():String updateDescriptor | proprietà |
updateDescriptor:XML [sola lettura] | Versione linguaggio: | ActionScript 3.0 |
| Versioni runtime: | AIR 1.5 |
Il contenuto del file descrittore di aggiornamento scaricato dall'URL di aggiornamento. Questa proprietà è diversa da null solo se l'oggetto Updater invia un evento updateStatus.
Implementazione
public function get updateDescriptor():XML updateURL | proprietà |
updateURL:String| Versione linguaggio: | ActionScript 3.0 |
| Versioni runtime: | AIR 1.5 |
La posizione del file descrittore di aggiornamento. Viene accettata qualunque posizione valida per un percorso URLRequest. Si tratta dell'unica impostazione obbligatoria richiesta dal programma di aggiornamento. Potete impostare l'URL dell'aggiornamento sia mediante questa proprietà sia mediante il file di configurazione. Quando il valore viene impostato mediante entrambi i metodi, il programma di aggiornamento utilizza il valore impostato mediante questa proprietà.
Implementazione
public function get updateURL():String public function set updateURL(value:String):void wasPendingUpdate | proprietà |
wasPendingUpdate:Boolean [sola lettura] | Versione linguaggio: | ActionScript 3.0 |
| Versioni runtime: | AIR 1.5 |
Indica se era presente un aggiornamento posticipato, anche se l'installazione non è riuscita (true); false, in caso contrario. Il programma di aggiornamento imposta questa proprietà durante una chiamata al metodo initialize(). Utilizzate le proprietà wasPendingUpdate e isFirstRun per verificare la presenza di un aggiornamento la cui installazione non è riuscita (nel qual caso wasPendingUpdate è impostato su true e isFirstRun è impostato su false).
Implementazione
public function get wasPendingUpdate():BooleanElementi API correlati
ApplicationUpdater | () | Funzione di costruzione |
public function ApplicationUpdater()| Versione linguaggio: | ActionScript 3.0 |
| Versioni runtime: | AIR 1.5 |
La funzione di costruzione.
cancelUpdate | () | metodo |
public function cancelUpdate():void| Versione linguaggio: | ActionScript 3.0 |
| Versioni runtime: | AIR 1.5 |
Annulla il processo di aggiornamento. La chiamata a questo metodo annulla qualunque scaricamento in sospeso, cancella tutti gli eventuali file scaricati in modo incompleto e riavvia il timer di controllo periodico.
Il processo di aggiornamento può essere annullato in qualunque momento a eccezione di quando lo stato è "UNINITIALIZED" o "INITIALIZING". Non produce alcun effetto se viene chiamato quando lo stato è "UNINITIALIZED" o "INITIALIZING".
checkForUpdate | () | metodo |
public function checkForUpdate():void| Versione linguaggio: | ActionScript 3.0 |
| Versioni runtime: | AIR 1.5 |
Scarica e interpreta in modo asincrono il file descrittore di aggiornamento. Se chiamate questo metodo, lo stato del programma di aggiornamento diventa "CHECKING". Chiamate questo metodo solo se l'evento checkForUpdate è stato annullato.
Questo metodo viene eseguito solo quando il programma di aggiornamento è nello stato "BEFORE_CHECKING".
Eventi
updateStatus: — Il programma di aggiornamento ha scaricato e interpretato correttamente il file descrittore di aggiornamento.
| |
updateError: — Si è verificato un errore durante il tentativo di scaricare o analizzare il file descrittore di aggiornamento.
|
checkNow | () | metodo |
public function checkNow():void| Versione linguaggio: | ActionScript 3.0 |
| Versioni runtime: | AIR 1.5 |
Avvia il processo di aggiornamento. La chiamata a questo metodo non interrompe il timer periodico; tuttavia, il metodo rileva che è in corso un processo di aggiornamento e salta l'iterazione corrente.
Questo metodo viene eseguito solo se lo stato corrente è "READY".
Questo metodo può provocare l'invio dell'evento seguente da parte dell'oggetto Updater:
Eventi
checkForUpdate: — Inviato appena prima dell'inizio del processo di aggiornamento.
|
downloadUpdate | () | metodo |
public function downloadUpdate():void| Versione linguaggio: | ActionScript 3.0 |
| Versioni runtime: | AIR 1.5 |
Scarica in modo asincrono il file di aggiornamento. Se chiamate questo metodo, lo stato del sistema diventa "DOWNLOADING". Questo metodo deve essere chiamato solo se l'evento StatusUpdateEvent.UPDATE_STATUS è stato annullato quando la proprietà available dell'evento era true.
Questo metodo viene eseguito solo se lo stato corrente è "AVAILABLE".
Eventi
downloadStart: — Inviato dopo che è stata stabilita la connessione al server.
| |
progress: — Inviato al termine dell'inizializzazione.
| |
downloadError: — Inviato se si verifica un errore durante la connessione o durante lo scaricamento del file di aggiornamento. Inviato anche in caso di stati HTTP non validi (Ad esempio, 404 - File non trovato).
|
initialize | () | metodo |
public function initialize():void| Versione linguaggio: | ActionScript 3.0 |
| Versioni runtime: | AIR 1.5 |
Inizializza il programma di aggiornamento. La chiamata a questo metodo esegue le operazioni seguenti:
-
Inizializza il framework di aggiornamento, installando in modo sincrono e senza emettere alcun messaggio di errore tutti gli eventuali aggiornamenti in sospeso. Dovete chiamare questo metodo durante l'avvio dell'applicazione, poiché potrebbe provocarne il riavvio.
-
Verifica la presenza di un aggiornamento rimandato e lo installa.
-
Se durante un aggiornamento precedente si è verificato qualche imprevisto, cancella il file dell'aggiornamento e le informazioni sulla versione dall'area di memorizzazione.
-
Se il ritardo del timer periodico è scaduto, avvia il processo di aggiornamento; altrimenti, avvia il timer periodico. Tuttavia, quando provate un'applicazione mediante l'applicazione AIR Debug Launcher (ADL), il tentativo di aggiornare l'applicazione genera un'eccezione IllegalOperationError.
Eventi
initialized: — L'inizializzazione è stata completata.
| |
error: — Si è verificato un errore durante l'inizializzazione.
|
installFromAIRFile | () | metodo |
public function installFromAIRFile(file:File):void| Versione linguaggio: | ActionScript 3.0 |
| Versioni runtime: | AIR 1.5 |
Avvia il processo di aggiornamento utilizzando un file AIR locale.
La chiamata a questo metodo non ha alcun effetto se è in esecuzione un processo di aggiornamento (se lo stato non è "DOWNLOADED").
Questa funzione è utile per un'applicazione il cui elemento customUpdateUI è impostato su true nel file descrittore dell'applicazione.
Durante il test di un'applicazione mediante AIR Debug Launcher (ADL), una chiamata a questo metodo genera un'eccezione IllegalOperationError.
Parametri
file:File — Il file AIR locale da installare.
|
Eventi
fileUpdateStatus: — Inviato dopo che il programma di aggiornamento ha convalidato correttamente il file AIR.
| |
updateError: — Inviato se si verifica un errore durante il tentativo di analizzare il file descrittore di aggiornamento.
|
installUpdate | () | metodo |
public function installUpdate():void| Versione linguaggio: | ActionScript 3.0 |
| Versioni runtime: | AIR 1.5 |
Installa il file di aggiornamento. Se chiamate questo metodo, lo stato diventa "INSTALLING". Questo metodo deve essere chiamato solo se l'evento downLoadComplete è stato annullato.
Chiamate questo metodo quando il programma di aggiornamento è nello stato "DOWNLOADED". Se quando lo chiamate è in un altro stato, non ottenete alcun effetto.
Durante il test di un'applicazione mediante AIR Debug Launcher (ADL), una chiamata a questo metodo genera un'eccezione IllegalOperationError.
Eventi
beforeInstall: — Inviato appena prima di installare l'aggiornamento. Talvolta, è utile impedire l'installazione dell'aggiornamento in questa fase, poiché l'utente potrebbe perdere tutto il lavoro in corso quando il runtime chiude l'applicazione per installare l'aggiornamento.
|
beforeInstall | Evento |
air.update.events.UpdateEventproprietà UpdateEvent.type =
air.update.events.UpdateEvent.BEFORE_INSTALL| Versione linguaggio: | ActionScript 3.0 |
| Versioni runtime: | AIR 1.5 |
Inviato appena prima di installare l'aggiornamento, dopo che è stato chiamato il metodo installUpdate(). Talvolta, è utile impedire l'installazione dell'aggiornamento in questa fase, poiché l'utente potrebbe perdere tutto il lavoro in corso quando il runtime chiude l'applicazione per installare l'aggiornamento.
Se chiamate il metodo preventDefault() di questo evento, l'installazione viene posticipata fino al riavvio successivo. Se chiamate il metodo preventDefault(), non potete avviare alcun processo di aggiornamento aggiuntivo durante la sessione dell'applicazione (mediante una chiamata al metodo installUpdate() o a causa del controllo periodico).
Il comportamento predefinito della libreria ApplicationUpdater consiste nello scaricare il file descrittore di aggiornamento. Potete chiamare il metodo preventDefault() per annullare questo comportamento.
UpdateEvent.BEFORE_INSTALL definisce il valore della proprietà type dell'oggetto evento per un evento beforeInstall.
Questo evento ha le seguenti proprietà:
| Proprietà | Valore |
|---|---|
bubbles | false |
cancelable | false; non è presente alcun comportamento predefinito da annullare. |
currentTarget | L'oggetto che elabora attivamente l'oggetto Event con un listener di eventi. |
target | L'oggetto Updater. |
checkForUpdate | Evento |
air.update.events.UpdateEventproprietà UpdateEvent.type =
air.update.events.UpdateEvent.CHECK_FOR_UPDATE| Versione linguaggio: | ActionScript 3.0 |
| Versioni runtime: | AIR 1.5 |
Inviato prima dell'avvio del processo, appena prima che il programma di aggiornamento tenti di scaricare il file descrittore di aggiornamento. Il programma di aggiornamento può inviare questo evento come conseguenza della chiamata diretta al metodo checkNow() o perché il timer del controllo periodico è scaduto.
UpdateEvent.CHECK_FOR_UPDATE definisce il valore della proprietà type dell'oggetto evento per un evento checkForUpdate.
Questo evento ha le seguenti proprietà:
| Proprietà | Valore |
|---|---|
bubbles | false |
cancelable | false; non è presente alcun comportamento predefinito da annullare. |
currentTarget | L'oggetto che elabora attivamente l'oggetto Event con un listener di eventi. |
target | L'oggetto Updater. |
downloadComplete | Evento |
air.update.events.UpdateEventproprietà UpdateEvent.type =
air.update.events.UpdateEvent.DOWNLOAD_COMPLETE| Versione linguaggio: | ActionScript 3.0 |
| Versioni runtime: | AIR 1.5 |
Inviato quando viene completato lo scaricamento del file di aggiornamento.
Di solito, questo evento viene utilizzato per visualizzare un messaggio che chiede all'utente se desidera procedere con l'installazione dell'aggiornamento.
Il comportamento predefinito della libreria ApplicationUpdater consiste nel chiamare automaticamente il metodo installUpdate().
UpdateEvent.DOWNLOAD_COMPLETE definisce il valore della proprietà type dell'oggetto evento per un evento downloadComplete.
Questo evento ha le seguenti proprietà:
| Proprietà | Valore |
|---|---|
bubbles | false |
cancelable | false; non è presente alcun comportamento predefinito da annullare. |
currentTarget | L'oggetto che elabora attivamente l'oggetto Event con un listener di eventi. |
target | L'oggetto Updater. |
downloadError | Evento |
air.update.events.DownloadErrorEventproprietà DownloadErrorEvent.type =
air.update.events.DownloadErrorEvent.DOWNLOAD_ERROR| Versione linguaggio: | ActionScript 3.0 |
| Versioni runtime: | AIR 1.5 |
Inviato se si verifica un errore durante la connessione o durante lo scaricamento del file di aggiornamento. Inviato anche in caso di stati HTTP non validi (Ad esempio, 404 - File non trovato).
Quando viene inviato questo evento il timer periodico viene riavviato automaticamente (se il ritardo è superiore a 0).
La costanteDownloadErrorEvent.DOWNLOAD_ERROR definisce il valore della proprietà typedell'oggetto evento per un evento downloadError.
La proprietà errorID di un oggetto DownloadErrorEvent è un intero che definisce le informazioni relative all'errore (consultate la tabella seguente). Una proprietà subErrorID aggiuntiva potrebbe contenere maggiori informazioni relative all'errore.
| Codice di errore errorID | Descrizione |
|---|---|
| 16800 | Si verifica durante la convalida del file di aggiornamento scaricato. La proprietà subErrorID può contenere informazioni aggiuntive. |
| 16801 | File di Adobe AIR non valido (application.xml mancante). |
| 16802 | File di Adobe AIR non valido (tipo MIME mancante). |
| 16803 | File di Adobe AIR non valido (formato). |
| 16804 | File di Adobe AIR non valido (flag non validi). |
| 16805 | File di Adobe AIR non valido (compressione sconosciuta). |
| 16806 | File di Adobe AIR non valido (nome file non valido). |
| 16807 | File di Adobe AIR non valido (danneggiato). |
| 16808 | Il file di configurazione non esiste. |
| 16809 | La proprietà updateURL non è impostata. |
| 16810 | Riservato. |
| 16811 | File di configurazione non valido (versione di configurazione sconosciuta). |
| 16812 | File di configurazione non valido (URL mancante). |
| 16813 | File di configurazione non valido (formato ritardo). |
| 16814 | File di configurazione non valido (valori di defaultUI non validi). |
| 16815 | Descrittore dell'aggiornamento non valido (versione descrittore sconosciuta). |
| 16816 | Descrittore dell'aggiornamento non valido (versione aggiornamento mancante). |
| 16817 | Descrittore dell'aggiornamento non valido (descrizione non valida). |
| 16818 | Errore di I/O durante il salvataggio su disco dei dati. La proprietà subErrorID può fornire maggiori informazioni. |
| 16819 | Errore di sicurezza durante lo scaricamento. La proprietà subErrorID può fornire maggiori informazioni. |
| 16820 | Codice di stato HTTP non valido. La proprietà subErrorID può contenere il codice di stato non valido. |
| 16821 | Riservato. |
| 16822 | Errore di I/O durante lo scaricamento. La proprietà subErrorID può fornire maggiori informazioni. |
| 16823 | Errore di fine di file durante il salvataggio su disco dei dati. La proprietà subErrorID può fornire maggiori informazioni. |
| 16824 | Descrittore dell'aggiornamento non valido. La proprietà subErrorID può fornire maggiori informazioni. |
| 16825 | Il file di aggiornamento contiene un'applicazione con un ID applicazione diverso. |
| 16826 | Il file di aggiornamento non contiene una versione più recente dell'applicazione. |
| 16827 | La versione contenuta nel file di aggiornamento non corrisponde alla versione del descrittore dell'aggiornamento. |
| 16828 | Impossibile aggiornare l'applicazione, solitamente poiché l'applicazione è in esecuzione in AIR Debug Launcher (ADL). |
| 16829 | File di aggiornamento mancante al momento dell'installazione. |
downloadStart | Evento |
air.update.events.UpdateEventproprietà UpdateEvent.type =
air.update.events.UpdateEvent.DOWNLOAD_START| Versione linguaggio: | ActionScript 3.0 |
| Versioni runtime: | AIR 1.5 |
Inviato dopo che è stato chiamato il metodo downloadUpdate() ed è stata stabilita la connessione al server. Quando utilizzate la libreria ApplicationUpdater, potete fare in modo che il gestore eventi per l'evento visualizza una barra di avanzamento che segnali all'utente l'avanzamento dello scaricamento.
UpdateEvent.DOWNLOAD_START definisce il valore della proprietà type dell'oggetto evento per un evento downloadStart.
Questo evento ha le seguenti proprietà:
| Proprietà | Valore |
|---|---|
bubbles | false |
cancelable | false; non è presente alcun comportamento predefinito da annullare. |
currentTarget | L'oggetto che elabora attivamente l'oggetto Event con un listener di eventi. |
target | L'oggetto Updater. |
error | Evento |
flash.events.ErrorEventproprietà ErrorEvent.type =
flash.events.ErrorEvent.ERROR| Versione linguaggio: | ActionScript 3.0 |
| Versioni runtime: | AIR 1.5 |
Inviato quando si è verificato un errore durante l'inizializzazione o durante il processo di aggiornamento (in caso di imprevisto).
Definisce il valore della proprietàtype di un oggetto evento error.
Questo evento ha le seguenti proprietà:
| Proprietà | Valore |
|---|---|
bubbles | false |
cancelable | false; non è presente alcun comportamento predefinito da annullare. |
currentTarget | L'oggetto che elabora attivamente l'oggetto Event con un listener di eventi. |
target | L'oggetto interessato da un errore di funzionamento di rete. |
text | Testo da visualizzare come messaggio di errore. |
fileUpdateError | Evento |
air.update.events.StatusFileUpdateErrorEventproprietà StatusFileUpdateErrorEvent.type =
air.update.events.StatusFileUpdateErrorEvent.FILE_UPDATE_ERROR| Versione linguaggio: | ActionScript 3.0 |
| Versioni runtime: | AIR 1.5 |
Inviato quando si verifica un errore durante la convalida del file passato come parametro airFile in una chiamata al metodo installFromAIRFile().
StatusUpdateErrorEvent.UPDATE_ERROR definisce il valore della proprietà type dell'oggetto evento per un evento statusUpdateError.
fileUpdateStatus | Evento |
air.update.events.StatusFileUpdateEventproprietà StatusFileUpdateEvent.type =
air.update.events.StatusFileUpdateEvent.FILE_UPDATE_STATUS| Versione linguaggio: | ActionScript 3.0 |
| Versioni runtime: | AIR 1.5 |
Inviato dopo che il programma di aggiornamento ha convalidato con successo il file nella chiamata al metodo installFromAIRFile().
StatusUpdateEvent.UPDATE_STATUS definisce il valore della proprietà type dell'oggetto evento per un evento updateStatus.
Questo evento ha le seguenti proprietà:
| Proprietà | Valore |
|---|---|
available | Indica se è disponibile una versione differente rispetto a quella dell'applicazione corrente (true); false in caso contrario (stessa versione). |
path | La proprietà nativePath dell'oggetto File di aggiornamento specificato dal parametro airFile in una chiamata al metodo installFromAIRFile(). |
version | Indica la versione del nuovo aggiornamento. |
initialized | Evento |
air.update.events.UpdateEventproprietà UpdateEvent.type =
air.update.events.UpdateEvent.INITIALIZED| Versione linguaggio: | ActionScript 3.0 |
| Versioni runtime: | AIR 1.5 |
Inviato al termine dell'inizializzazione.
La costanteUpdateEvent.INITIALIZED definisce il valore della proprietà type dell'oggetto evento per un evento initialized.
Questo evento ha le seguenti proprietà:
| Proprietà | Valore |
|---|---|
bubbles | false |
cancelable | false; non è presente alcun comportamento predefinito da annullare. |
currentTarget | L'oggetto che elabora attivamente l'oggetto Event con un listener di eventi. |
target | L'oggetto Updater. |
progress | Evento |
flash.events.ProgressEventproprietà ProgressEvent.type =
flash.events.ProgressEvent.PROGRESS| Versione linguaggio: | ActionScript 3.0 |
| Versioni runtime: | AIR 1.5 |
Inviato quando il file di aggiornamento viene scaricato.
Definisce il valore della proprietàtype di un oggetto evento progress.
Questo evento ha le seguenti proprietà:
| Proprietà | Valore |
|---|---|
bubbles | false |
bytesLoaded | Il numero di elementi o di byte caricati nel momento in cui il listener elabora l'evento. |
bytesTotal | Il numero totale di elementi o byte che vengono caricati se il processo di caricamento viene completato correttamente. |
cancelable | false; non è presente alcun comportamento predefinito da annullare. |
currentTarget | L'oggetto che elabora attivamente l'oggetto Event con un listener di eventi. |
target | L'oggetto che riporta l'avanzamento. |
updateError | Evento |
air.update.events.StatusUpdateErrorEventproprietà StatusUpdateErrorEvent.type =
air.update.events.StatusUpdateErrorEvent.UPDATE_ERROR| Versione linguaggio: | ActionScript 3.0 |
| Versioni runtime: | AIR 1.5 |
Inviato se si verifica un errore durante il tentativo di scaricare o analizzare il file descrittore di aggiornamento.
Quando il programma di aggiornamento invia questo evento, il timer periodico viene riavviato automaticamente (se l'impostazione del ritardo è superiore a 0). L'applicazione deve nascondere qualunque finestra di dialogo di errore quando l'aggiornamento invia un nuovo evento checkForUpdate.
StatusUpdateErrorEvent.UPDATE_ERROR definisce il valore della proprietà type dell'oggetto evento per un evento statusUpdateError.
updateStatus | Evento |
air.update.events.StatusUpdateEventproprietà StatusUpdateEvent.type =
air.update.events.StatusUpdateEvent.UPDATE_STATUS| Versione linguaggio: | ActionScript 3.0 |
| Versioni runtime: | AIR 1.5 |
Inviato dopo che il programma di aggiornamento ha scaricato e interpretato correttamente il file descrittore di aggiornamento.
Il comportamento predefinito consiste nell'avviare lo scaricamento se la proprietà available dell'oggetto StatusUpdateEvent è impostata su true. Il comportamento predefinito può essere impedito solo quando si utilizza la classe ApplicationUpdater, non quando si utilizza la classe ApplicationUpdatorUI.
StatusUpdateEvent.UPDATE_STATUS definisce il valore della proprietà type dell'oggetto evento per un evento updateStatus.
Questo evento ha le seguenti proprietà:
| Proprietà | Valore |
|---|---|
available | Impostate su true se il file descrittore di aggiornamento specifica una versione diversa da quella dell'applicazione corrente; false in caso contrario (la versione è la stessa). |
version | La stringa che rappresenta la nuova versione disponibile. |
details | Un array che definisce la stringa details per ciascuna delle lingue supportate. Se non è presenta alcuna descrizione dettagliata, viene definita sotto forma di un array in cui il primo elemento è una stringa vuota ("") e il secondo è la stringa details. Quando sono presenti delle descrizioni localizzate, ogni elemento dell'array è esso stesso un array con due elementi. Il primo elemento è il codice della versione localizzata, mentre il secondo è la descrizione. Ad esempio, l'array seguente è dotato di array secondari per due lingue (inglese americano e francese): ["en-US", "Hello World"], ["fr", "Bonjour monde"]. Le lingue vengono elencate con lo stesso ordine che hanno nel descrittore dell'aggiornamento. Il testo della proprietà details è specificato nel file descrittore dell'aggiornamento. |
versionLabel | (AIR 2.5+) L'etichetta di versione del descrittore applicazione dell'aggiornamento. L'etichetta di versione deve essere visualizzata agli utenti invece della versione. Se non viene specificata un'etichetta di versione, questa proprietà è una stringa vuota. |
Tue Jun 12 2018, 02:44 PM Z