| Pacchetto | air.update |
| Classe | public class ApplicationUpdaterUI |
| Ereditarietà | ApplicationUpdaterUI  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. La versione nella directory frameworks/libs/air dell'SDK AIR 2 è destinata allo sviluppo in Flex 4. Se utilizzate Flex 3, utilizzate invece la versione presente nella sottodirectory frameworks/libs/air/flex3.
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.
La classe AIRUpdateUI implementa un'interfaccia utente predefinita utilizzabile dall'applicazione. Fornisce all'utente le informazioni e le opzioni di base relative agli aggiornamenti dell'applicazione.
Il processo di aggiornamento prevede una sequenza di stati.
| Stato | 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 install | 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. | ApplicationUpdaterUI | ||
 | constructor : Object
Un riferimento all'oggetto classe o alla funzione di costruzione per una determinata istanza di oggetto. | Object | |
| currentVersion : String [sola lettura]
La versione corrente dell'applicazione. | ApplicationUpdaterUI | ||
| delay : Number
L'intervallo, espresso in giorni, che intercorre tra la verifica periodica della presenza di nuovi aggiornamenti. | ApplicationUpdaterUI | ||
| isCheckForUpdateVisible : Boolean
Attiva la visibilità delle finestre di dialogo Verifica aggiornamenti, Nessun aggiornamento ed Errore di aggiornamento. | ApplicationUpdaterUI | ||
| isDownloadProgressVisible : Boolean
Attiva la visibilità della finestra di dialogo Scarica aggiornamento. | ApplicationUpdaterUI | ||
| isDownloadUpdateVisible : Boolean
Attiva la visibilità della finestra di dialogo Scarica aggiornamento. | ApplicationUpdaterUI | ||
| isFileUpdateVisible : Boolean
Attiva la visibilità delle finestre di dialogo Aggiornamento file, Nessun aggiornamento file ed Errore file. | ApplicationUpdaterUI | ||
| isFirstRun : Boolean [sola lettura]
Indica se questa è la prima esecuzione dopo un aggiornamento completato correttamente (true) o meno (false). | ApplicationUpdaterUI | ||
| isInstallUpdateVisible : Boolean
Attiva la visibilità della finestra di dialogo Installa aggiornamento. | ApplicationUpdaterUI | ||
| isNewerVersionFunction : Function
Una funzione che deve essere utilizzata dal programma di aggiornamento per effettuare i confronti tra le versioni. | ApplicationUpdaterUI | ||
| isUnexpectedErrorVisible : Boolean
Attiva la visibilità della finestra di dialogo Errore inatteso. | ApplicationUpdaterUI | ||
| isUpdateInProgress : Boolean [sola lettura]
Una proprietà di tipo Boolean che è true se è in esecuzione un aggiornamento oppure false in caso contrario. | ApplicationUpdaterUI | ||
| localeChain : Array
Un array che definisce la sequenza di versioni locali utilizzata dall'interfaccia utente. | ApplicationUpdaterUI | ||
| previousApplicationStorageDirectory : File [sola lettura]
La posizione precedente della directory di memorizzazione dell'applicazione, se è cambiata dopo un aggiornamento. | ApplicationUpdaterUI | ||
| previousVersion : String [sola lettura]
La versione precedente dell'applicazione. | ApplicationUpdaterUI | ||
| updateDescriptor : XML [sola lettura]
Il contenuto del file descrittore di aggiornamento scaricato dall'URL di aggiornamento. | ApplicationUpdaterUI | ||
| updateURL : String
La posizione del file descrittore di aggiornamento. | ApplicationUpdaterUI | ||
| wasPendingUpdate : Boolean [sola lettura]
Indica se era presente un aggiornamento posticipato, anche se l'installazione non è riuscita (true); false, in caso contrario. | ApplicationUpdaterUI | ||
| Metodo | Definito da | ||
|---|---|---|---|
La funzione di costruzione. | ApplicationUpdaterUI | ||
| 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 | |
Aggiunge dinamicamente un nuovo pacchetto di risorse per la lingua specificata. | ApplicationUpdaterUI | ||
Annulla il processo di aggiornamento. | ApplicationUpdaterUI | ||
Avvia il processo di aggiornamento. | ApplicationUpdaterUI | ||
|
Invia un evento nel flusso di eventi. | EventDispatcher | |
|
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. | ApplicationUpdaterUI | ||
Avvia il processo di aggiornamento utilizzando un file AIR locale. | ApplicationUpdaterUI | ||
|
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(). | ApplicationUpdaterUI | |||
| Inviato prima dell'avvio del processo, appena prima che il programma di aggiornamento tenti di scaricare il file descrittore di aggiornamento. | ApplicationUpdaterUI | |||
| [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. | ApplicationUpdaterUI | |||
| Inviato se si verifica un errore durante la connessione o durante lo scaricamento del file di aggiornamento. | ApplicationUpdaterUI | |||
| Inviato dopo che è stato chiamato il metodo downloadUpdate() ed è stata stabilita la connessione al server. | ApplicationUpdaterUI | |||
| Inviato quando si è verificato un errore durante l'inizializzazione o durante il processo di aggiornamento (in caso di imprevisto). | ApplicationUpdaterUI | |||
| Inviato quando si verifica un errore durante la convalida del file passato come parametro airFile in una chiamata al metodo installFromAIRFile(). | ApplicationUpdaterUI | |||
| Inviato dopo che il programma di aggiornamento ha convalidato con successo il file nella chiamata al metodo installFromAIRFile(). | ApplicationUpdaterUI | |||
| Inviato al termine dell'inizializzazione. | ApplicationUpdaterUI | |||
| Inviato quando il file di aggiornamento viene scaricato. | ApplicationUpdaterUI | |||
| Inviato se si verifica un errore durante il tentativo di scaricare o analizzare il file descrittore di aggiornamento. | ApplicationUpdaterUI | |||
| Inviato dopo che il programma di aggiornamento ha scaricato e interpretato correttamente il file descrittore di aggiornamento. | ApplicationUpdaterUI | |||
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. 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.
Implementazione
public function get configurationFile():File public function set configurationFile(value:File):voidElementi API correlati
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. 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.
Implementazione
public function get delay():Number public function set delay(value:Number):voidElementi API correlati
isCheckForUpdateVisible | proprietà |
isCheckForUpdateVisible:Boolean| Versione linguaggio: | ActionScript 3.0 |
| Versioni runtime: | AIR 1.5 |
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.
Implementazione
public function get isCheckForUpdateVisible():Boolean public function set isCheckForUpdateVisible(value:Boolean):void isDownloadProgressVisible | proprietà |
isDownloadProgressVisible:Boolean| Versione linguaggio: | ActionScript 3.0 |
| Versioni runtime: | AIR 1.5 |
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.
Implementazione
public function get isDownloadProgressVisible():Boolean public function set isDownloadProgressVisible(value:Boolean):void isDownloadUpdateVisible | proprietà |
isDownloadUpdateVisible:Boolean| Versioni runtime: | AIR 1.5 |
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.
Implementazione
public function get isDownloadUpdateVisible():Boolean public function set isDownloadUpdateVisible(value:Boolean):void isFileUpdateVisible | proprietà |
isFileUpdateVisible:Boolean| Versione linguaggio: | ActionScript 3.0 |
| Versioni runtime: | AIR 1.5 |
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.
Implementazione
public function get isFileUpdateVisible():Boolean public function set isFileUpdateVisible(value:Boolean):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
isInstallUpdateVisible | proprietà |
isInstallUpdateVisible:Boolean| Versione linguaggio: | ActionScript 3.0 |
| Versioni runtime: | AIR 1.5 |
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.
Implementazione
public function get isInstallUpdateVisible():Boolean public function set isInstallUpdateVisible(value:Boolean):void 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;
}
isUnexpectedErrorVisible | proprietà |
isUnexpectedErrorVisible:Boolean| Versione linguaggio: | ActionScript 3.0 |
| Versioni runtime: | AIR 1.5 |
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.
Implementazione
public function get isUnexpectedErrorVisible():Boolean public function set isUnexpectedErrorVisible(value:Boolean):void isUpdateInProgress | proprietà |
localeChain | proprietà |
localeChain:Array| Versione linguaggio: | ActionScript 3.0 |
| Versioni runtime: | AIR 1.5 |
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;Implementazione
public function get localeChain():Array public function set localeChain(value:Array):voidElementi API correlati
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 dopo che 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):voidElementi API correlati
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
ApplicationUpdaterUI | () | Funzione di costruzione |
public function ApplicationUpdaterUI()| Versione linguaggio: | ActionScript 3.0 |
| Versioni runtime: | AIR 1.5 |
La funzione di costruzione.
addResources | () | metodo |
public function addResources(lang:String, res:Object):void| Versione linguaggio: | ActionScript 3.0 |
| Versioni runtime: | AIR 1.5 |
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
lang:String — Il codice della lingua (ad esempio "it" per italiano).
| |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
res:Object — L'oggetto contiene le chiavi e i valori per la traduzione. Le chiavi sono quelle del file della proprietà language. La tabella seguente elenca le chiavi possibili (nomi di proprietà).
|
Elementi API correlati
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".
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.
|
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.
|
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).
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.
La costanteUpdateEvent.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.
Questo evento ha le seguenti proprietà di sola lettura:
-
isFirstRun(Boolean)truese si tratta della prima esecuzione dopo un aggiornamento completato correttamente;falsein 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.
UpdateEvent.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.
La costanteStatusUpdateEvent.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