ApplicationUpdaterUI  - AS3

La posizione del file di configurazione che imposta i valori per le proprietà delay e updateURL. Inoltre, fornisce delle impostazioni per determinare se l'applicazione visualizza varie finestre di dialogo di conferma durante il processo di aggiornamento. 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>
           <defaultUI>
              <dialog name="checkForUpdate" visible="true" />
               <dialog name="downloadUpdate" visible="false" />
               <dialog name="downloadProgress" visible="true" />
               <dialog name="installUpdate" visible="true" />    
           </defaultUI>
        </configuration>

Anziché caricare un file di configurazione, potete utilizzare il codice ActionScript per impostare le seguenti proprietà dell'oggetto ApplicationUpdaterUI: delay, isCheckForUpdateVisible, isDownloadProgressVisible, isDownloadUpdateVisible, isFileUpdateVisible, isInstallUpdateVisible e updateURL.

Elementi API correlati

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. Il ritardo può essere impostato 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.

Elementi API correlati

Attiva la visibilità delle finestre di dialogo Verifica aggiornamenti, Nessun aggiornamento ed Errore di aggiornamento. Se l'impostazione è true, il programma di aggiornamento visualizza queste finestre di dialogo come parte del processo di aggiornamento. L'impostazione può essere effettuata anche nel file di configurazione dell'aggiornamento. Un valore impostato mediante questa proprietà ignora l'impostazione nel file di configurazione dell'aggiornamento.

Attiva la visibilità della finestra di dialogo Scarica aggiornamento. Se l'impostazione è true, il programma di aggiornamento visualizza questa finestra di dialogo come parte del processo di aggiornamento. L'impostazione può essere effettuata anche nel file di configurazione dell'aggiornamento. Un valore impostato mediante questa proprietà ignora l'impostazione nel file di configurazione dell'aggiornamento.

Attiva la visibilità della finestra di dialogo Scarica aggiornamento. Se l'impostazione è true, il programma di aggiornamento visualizza queste finestre di dialogo come parte del processo di aggiornamento. L'impostazione può essere effettuata anche nel file di configurazione dell'aggiornamento. Un valore impostato mediante questa proprietà ignora l'impostazione nel file di configurazione dell'aggiornamento.

Attiva la visibilità delle finestre di dialogo Aggiornamento file, Nessun aggiornamento file ed Errore file. Se l'impostazione è true, il programma di aggiornamento visualizza queste finestre di dialogo come parte del processo di aggiornamento. L'impostazione può essere effettuata anche nel file di configurazione dell'aggiornamento. Un valore impostato mediante questa proprietà ignora l'impostazione nel file di configurazione dell'aggiornamento.

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

Attiva la visibilità della finestra di dialogo Installa aggiornamento. Se l'impostazione è true, il programma di aggiornamento visualizza questa finestra di dialogo come parte del processo di aggiornamento. L'impostazione può essere effettuata anche nel file di configurazione dell'aggiornamento. Un valore impostato mediante questa proprietà ignora l'impostazione nel file di configurazione dell'aggiornamento.

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;
}

Attiva la visibilità della finestra di dialogo Errore inatteso. Se l'impostazione è true, il programma di aggiornamento dell'applicazione visualizza questa finestra di dialogo come parte del processo di aggiornamento. L'impostazione può essere effettuata anche nel file di configurazione dell'aggiornamento. Un valore impostato mediante questa proprietà ignora l'impostazione nel file di configurazione dell'aggiornamento.

Una proprietà di tipo Boolean che è true se è in esecuzione un aggiornamento oppure false in caso contrario.

Un array che definisce la sequenza di versioni locali utilizzata dall'interfaccia utente. Di solito, solo gli sviluppatori JavaScript (HTML) utilizzano questa proprietà.

Gli sviluppatori Flex possono utilizzare ResourceManager per gestire la sequenza di versioni locali.

Per impostazione predefinita, in un'applicazione basata sull'HTML, le lingue vengono ordinate tra quelle presenti nell'array Capabilities.languages e le dieci lingue supportate dall'interfaccia utente. Se non viene trovata alcuna corrispondenza, l'interfaccia utente utilizza la lingua inglese.

Questo esempio di JavaScript utilizza il framework di localizzazione HTML AIR incluso nel SDK di AIR. Ordina le lingue rispetto all'elenco delle lingue, quindi imposta l'inglese come lingua di riserva predefinita:

 appUpdater.addResources("ro_RO", {titleCheck: "Titlu", msgCheck: "Mesaj", btnCheck: "Buton"});
        appUpdater.addResources("hu", {titleCheck: "Cím", msgCheck: "Üzenet"}); 
        var languages = ["ro", "hu"];
        languages = languages.concat(air.Capabilities.languages);
        var sortedLanguages = air.Localizer.sortLanguagesByPreference(languages, air.Capabilities.language, "en-US");  
        sortedLanguages.push("en-US");
        appUpdater.localeChain = sortedLanguages;

Elementi API correlati

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

Elementi API correlati

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.

Aggiunge dinamicamente un nuovo pacchetto di risorse per la lingua specificata. Gli sviluppatori JavaScript utilizzano questo metodo per aggiungere dinamicamente una nuova lingua per le finestre di dialogo visualizzate dall'interfaccia utente del programma di aggiornamento dell'applicazione (Gli sviluppatori Flex possono aggiungere direttamente una nuova lingua al bundle di risorse "ApplicationUpdaterDialogs").

Parametri

Elementi API correlati

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

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:

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

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

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.

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à di sola lettura:

• isFirstRun (Boolean) true se si tratta della prima esecuzione dopo un aggiornamento completato correttamente; false in caso contrario.

• previousVersion (String) La versione precedente dell'applicazione prima dell'aggiornamento (impostata solo seisfirstRun è true).

• currentVersion (String) La versione del file descrittore dell'aggiornamento della versione attualmente installata.

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.

Questo evento ha le seguenti proprietà: