ApplicationUpdater  - AS3

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.

Elementi API correlati

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.

La versione corrente dell'applicazione. Questa proprietà viene impostata durante una chiamata al metodo initialize(). Viene impostata sulla versione del file descrittore dell'applicazione.

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.

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.

Elementi API correlati

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.

appUpdate.isNewerVersionFunction = customFn; 

function customFn (currentVersion:String, updateVersion:String):Boolean 
{
    return updateVersion > currentVersion;
}

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.

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.

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.

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à.

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).

Elementi API correlati

La funzione di costruzione.

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".

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".

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:

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".

Inizializza il programma di aggiornamento. La chiamata a questo metodo esegue le operazioni seguenti:

1. 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.

2. Verifica la presenza di un aggiornamento rimandato e lo installa.

3. Se durante un aggiornamento precedente si è verificato qualche imprevisto, cancella il file dell'aggiornamento e le informazioni sulla versione dall'area di memorizzazione.

4. 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.

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

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.

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.

Questo evento ha le seguenti proprietà:

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.

Questo evento ha le seguenti proprietà:

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().

Questo evento ha le seguenti proprietà:

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 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.

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.

Questo evento ha le seguenti proprietà:

Inviato quando si è verificato un errore durante l'inizializzazione o durante il processo di aggiornamento (in caso di imprevisto).

Questo evento ha le seguenti proprietà:

Inviato quando si verifica un errore durante la convalida del file passato come parametro airFile in una chiamata al metodo installFromAIRFile().

Inviato dopo che il programma di aggiornamento ha convalidato con successo il file nella chiamata al metodo installFromAIRFile().

Questo evento ha le seguenti proprietà:

Inviato al termine dell'inizializzazione.

Questo evento ha le seguenti proprietà:

Inviato quando il file di aggiornamento viene scaricato.

Questo evento ha le seguenti proprietà:

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.

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.

Questo evento ha le seguenti proprietà: