| Paket | air.update |
| Klass | public class ApplicationUpdater |
| Arv | ApplicationUpdater  EventDispatcher Object |
| Språkversion: | ActionScript 3.0 |
| Körningsmiljöversioner: | AIR 1.5 |
Den här klassen ingår i filen applicationupdater_ui.swc som ingår i Adobe Flex SDK. Filen applicationupdater_ui.swc finns i katalogen frameworks/libs/air i AIR SDK.
Adobe® Flex™ Builder™ läser automatiskt in den här klassen när du skapar ett projekt för Adobe AIR. Du ska ta med SWC-filen när du kompilerar programmet med hjälp av Adobe® Flex™ SDK.
Det kan vara komplicerat att hantera programuppdateringar. I AIR-uppdateringsramverket finns programmeringsgränssnitt som gör det enklare för utvecklare att skapa lämpliga uppdateringsfunktioner i AIR-program. Funktionerna i AIR-uppdateringsramverket hjälper utvecklare med följande:
-
Regelbundet söka efter uppdateringar utifrån ett intervall eller på användarens begäran
-
Hämta AIR-filer (uppdateringar) från en webbkälla
-
Informera användaren vid den första körningen av den nyinstallerade versionen
-
Bekräfta att användaren vill söka efter uppdateringar
-
Visa information om den nya uppdateringsversionen för användaren
-
Visa information om hämtningsförlopp och fel för användaren
Med AIR-uppdateringsramverket kan du lagra information om uppdateringsversionen av ett AIR-program i enkla XML-konfigurationsfiler. För de flesta program kan du genom att ställa in dessa konfigurationsfiler och inkludera en del enkel kod skapa en passande uppdateringsfunktion för slutanvändaren.
Använd klassen AIRUpdater om du vill definiera ett eget användargränssnitt som ska användas med AIR-uppdateringsramverket.
Uppdateringsprocessen omfattar en serie lägen. Egenskapen currentState för uppdaterarobjektet återspeglar det aktuella läget för uppdateraren:
| Värde på currentState | Beskrivning |
|---|---|
| "UNINITIALIZED" | Uppdateraren har inte initierats. |
| "INITIALIZING" | Uppdateraren initieras. |
| "READY" | Uppdateraren har inte initierats |
| ”BEFORE_CHECKING” | Uppdateraren har ännu inte sökt efter uppdateringsbeskrivningsfilen. |
| "CHECKING" | Uppdateraren söker efter en uppdateringsbeskrivningsfil. |
| "AVAILABLE" | Uppdateringsbeskrivningsfilen är tillgänglig. |
| "DOWNLOADING" | Uppdateraren hämtar AIR-filen. |
| "DOWNLOADED" | Uppdateraren har hämtat AIR-filen. |
| "INSTALLING" | Uppdateraren installerar AIR-filen. |
| ”PENDING_INSTALLING” | Uppdateraren har initierats och det finns väntande uppdateringar. |
När du testar ett program med AIR Debug Launcher (ADL) inträffar ett IllegalOperationError-undantag om du försöker uppdatera programmet.
AIR-uppdateringsramverket stöds bara i skrivbordsprofilen. Det stöds inte för utökade skrivbordsprogram (program som installeras med ett inbyggt installationsprogram) och det stöds inte heller i mobilprofilen (iPhone-program som skapats med ActionScript 3.0). Kontrollera egenskapen Updater.isSupported vid körning för att se om uppdateringsramverket stöds.
Mer information om hur du använder AIR-uppdateringsramverket finns i kapitlet ”Uppdatera AIR-program” i Skapa Adobe AIR-program.
Relaterade API-element
Dölj ärvda publika egenskaper
Visa ärvda publika egenskaper| Egenskap | Definieras med | ||
|---|---|---|---|
| configurationFile : File
Platsen för den konfigurationsfil som anger värdena för updateURL och delay. | ApplicationUpdater | ||
 | constructor : Object
En referens till klassobjektet eller konstruktorfunktionen för en given objektinstans. | Object | |
| currentState : String [skrivskyddad]
Uppdaterarens interna läge. | ApplicationUpdater | ||
| currentVersion : String [skrivskyddad]
Den aktuella versionen av programmet. | ApplicationUpdater | ||
| delay : Number
Intervallet i dagar mellan periodiska sökningar efter nya uppdateringar. | ApplicationUpdater | ||
| isFirstRun : Boolean [skrivskyddad]
Om detta är den första körningen efter en lyckad uppdatering (true) eller inte (false). | ApplicationUpdater | ||
| isNewerVersionFunction : Function
En funktion som uppdateraren ska använda för att utföra versionsjämförelser. | ApplicationUpdater | ||
| previousApplicationStorageDirectory : File [skrivskyddad]
Tidigare placering av programlagringskatalogen, om den har ändrats efter en uppdatering. | ApplicationUpdater | ||
| previousVersion : String [skrivskyddad]
Den tidigare versionen av programmet. | ApplicationUpdater | ||
| updateDescriptor : XML [skrivskyddad]
Innehållet i uppdateringsbeskrivningsfilen som hämtats från uppdaterings-URL:en. | ApplicationUpdater | ||
| updateURL : String
Platsen för uppdateringsbeskrivningsfilen. | ApplicationUpdater | ||
| wasPendingUpdate : Boolean [skrivskyddad]
Om det finns en uppskjuten uppdatering, även om det inte gick att installera den (true), och false i annat fall. | ApplicationUpdater | ||
| Metod | Definieras med | ||
|---|---|---|---|
Konstruktorfunktionen. | ApplicationUpdater | ||
| addEventListener(type:String, listener:Function, useCapture:Boolean = false, priority:int = 0, useWeakReference:Boolean = false):void
Registrerar ett händelseavlyssnarobjekt för ett EventDispatcher-objekt så att avlyssnaren får meddelanden om händelser. | EventDispatcher | |
Avbryter uppdateringsprocessen. | ApplicationUpdater | ||
Hämtar och tolkar uppdateringsbeskrivningsfilen asynkront. | ApplicationUpdater | ||
Startar uppdateringsprocessen. | ApplicationUpdater | ||
|
Skickar en händelse till händelseflödet. | EventDispatcher | |
Hämtar uppdateringsfilen asynkront. | ApplicationUpdater | ||
|
Kontrollerar om EventDispatcher-objektet har några avlyssnare registrerade för en viss typ av händelse. | EventDispatcher | |
|
Anger om det finns en egenskap angiven för ett objekt. | Object | |
Initierar uppdateraren. | ApplicationUpdater | ||
Startar uppdateringsprocessen med en lokal AIR-fil. | ApplicationUpdater | ||
Installerar uppdateringsfilen. | ApplicationUpdater | ||
|
Anger om en instans av klassen Object finns i prototypkedjan för objektet som anges som parameter. | Object | |
|
Anger om den angivna egenskapen finns och är uppräkningsbar. | Object | |
|
Tar bort en avlyssnare från EventDispatcher-objektet. | EventDispatcher | |
|
Anger tillgänglighet för en dynamisk egenskap för slingåtgärder. | Object | |
|
Returnerar det här objektets strängrepresentation, formaterad i enlighet med språkspecifika konventioner. | Object | |
|
Returnerar det angivna objektets strängbeteckning. | Object | |
|
Returnerar det angivna objektets primitiva värde. | Object | |
|
Kontrollerar om en händelseavlyssnare är registrerad för det här EventDispatcher-objektet eller något av dess överordnade objekt för den angivna händelsetypen. | EventDispatcher | |
| Händelse | Sammanfattning | Definieras med | ||
|---|---|---|---|---|
| [utsändningshändelse] Skickas när Flash Player eller AIR får operativsystemfokus och blir aktivt. | EventDispatcher | ||
| Skickas precis innan uppdateringen installeras, efter att metoden installUpdate() anropats. | ApplicationUpdater | |||
| Skickas precis innan uppdateringsprocessen börjar, precis innan uppdateraren försöker att hämta uppdateringsbeskrivningsfilen. | ApplicationUpdater | |||
| [utsändningshändelse] Skickas när Flash Player eller AIR förlorar operativsystemfokus och blir inaktivt. | EventDispatcher | ||
| Skickas när hämtningen av uppdateringsfilen är slutförd. | ApplicationUpdater | |||
| Skickas om det uppstår ett fel under anslutning eller hämtning av uppdateringsfilen. | ApplicationUpdater | |||
| Skickas efter ett anrop till metoden downloadUpdate() när anslutningen till servern är upprättad. | ApplicationUpdater | |||
| Skickas när ett fel inträffar antingen under initiering eller under uppdateringsprocessen (om något oväntat inträffar). | ApplicationUpdater | |||
| Skickas när ett fel uppstår under validering av den fil som skickas som airFile-parameter i ett anrop till metoden installFromAIRFile(). | ApplicationUpdater | |||
| Skickas efter att uppdateraren validerat filen i anropet till metoden installFromAIRFile(). | ApplicationUpdater | |||
| Skickas efter att initieringen är slutförd. | ApplicationUpdater | |||
| Skickas när uppdateringsfilen hämtas. | ApplicationUpdater | |||
| Skickas om ett fel uppstår under försök att hämta eller tolka uppdateringsbeskrivningsfilen. | ApplicationUpdater | |||
| Skickas efter att uppdateraren slutfört hämtning och tolkning av uppdateringsbeskrivningsfilen. | ApplicationUpdater | |||
configurationFile | egenskap |
configurationFile:File| Språkversion: | ActionScript 3.0 |
| Körningsmiljöversioner: | AIR 1.5 |
Platsen för den konfigurationsfil som anger värdena för delay och updateURL. Om den här egenskapen pekar på en fil som inte finns, uppstår ett fel om metoden initialize() anropas.
Nedan finns ett exempel på en konfigurationsfil:
<?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>I stället för att läsa in en konfigurationsfil kan du använda ActionScript --koden när du ställer in egenskaperna delay och updateURL.
Implementering
public function get configurationFile():File public function set configurationFile(value:File):voidRelaterade API-element
currentState | egenskap |
currentState:String [skrivskyddad] | Språkversion: | ActionScript 3.0 |
| Körningsmiljöversioner: | AIR 1.5 |
Uppdaterarens interna läge. Egenskapen kan ha följande värden:
-
"UNINITIALIZED"– Uppdateraren har inte initierats. -
"INITIALIZING"– Uppdateraren initieras. -
"READY"– Uppdateraren har inte initierats -
"BEFORE_CHECKING"– Uppdateraren har ännu inte sökt efter uppdateringsbeskrivningsfilen. -
"CHECKING"– Uppdateraren söker efter en uppdateringsbeskrivningsfil. -
"AVAILABLE"– Uppdateringsbeskrivningsfilen är tillgänglig. -
"DOWNLOADING"– Uppdateraren hämtar AIR-filen. -
"DOWNLOADED"– Uppdateraren har hämtat AIR-filen. -
"INSTALLING"– Uppdateraren installerar AIR-filen. -
"PENDING_INSTALLING"– Uppdateraren har initierats och det finns väntande uppdateringar.
Implementering
public function get currentState():String currentVersion | egenskap |
currentVersion:String [skrivskyddad] | Språkversion: | ActionScript 3.0 |
| Körningsmiljöversioner: | AIR 1.5 |
Den aktuella versionen av programmet. Den här egenskapen ställs in under ett anrop till metoden initialize(). Den ställs in på versionen från programbeskrivningsfilen.
Implementering
public function get currentVersion():String delay | egenskap |
delay:Number| Språkversion: | ActionScript 3.0 |
| Körningsmiljöversioner: | AIR 1.5 |
Intervallet i dagar mellan periodiska sökningar efter nya uppdateringar.
Värdet 0 (standardvärdet) som anger att tidtagaren inte är aktiv, så att inga periodiska kontroller utförs. Det kan ställas in via den här egenskapen eller konfigurationsfilen. När värdet ställs in med båda metoderna, används värdet som ställs in med egenskapen.
Standardvärdet är 0.
Implementering
public function get delay():Number public function set delay(value:Number):void isFirstRun | egenskap |
isFirstRun:Boolean [skrivskyddad] | Språkversion: | ActionScript 3.0 |
| Körningsmiljöversioner: | AIR 1.5 |
Om detta är den första körningen efter en lyckad uppdatering (true) eller inte (false). Uppdateraren ställer in det här värdet under anropet till metoden initialize(). Utvecklaren bör kontrollera att isFirstRun ställs in på true om data behöver flyttas från en version till en annan.
Implementering
public function get isFirstRun():BooleanRelaterade API-element
isNewerVersionFunction | egenskap |
isNewerVersionFunction:Function| Språkversion: | ActionScript 3.0 |
| Körningsmiljöversioner: | AIR 1.5 |
En funktion som uppdateraren ska använda för att utföra versionsjämförelser. Som standard genomförs en versionsjämförelse i uppdateringsramverket för att känna av om versionen från fjärrplatsen är nyare än versionen på det installerade programmet. Ibland matchar inte standardjämförelsen utvecklarens versionsschema. Ange den här egenskapen om du vill skapa en ny funktion som utför jämförelsen.
Standardjämförelsefunktionen accepterar versioner som x.y.z, där x, y och z kan innehålla bokstäver och siffror. Det finns några speciella villkor som standardjämförelsefunktionen känner igen. Om testfunktionen hittar "alpha", "beta" eller "rc" i versionssträngarna blir ordningen alpha < beta < rc.
Implementering
public function get isNewerVersionFunction():Function public function set isNewerVersionFunction(value:Function):voidExempel ( Så här använder du exemplet )
customFn, för uppdaterarobjektet appUpdate. Exempelfunktionen är avsiktligt enkel. Din anpassade funktion bör returnera ett booleskt värde baserat på reglerna i versionsschemat.
appUpdate.isNewerVersionFunction = customFn;
function customFn (currentVersion:String, updateVersion:String):Boolean
{
return updateVersion > currentVersion;
}
previousApplicationStorageDirectory | egenskap |
previousApplicationStorageDirectory:File [skrivskyddad] | Språkversion: | ActionScript 3.0 |
| Körningsmiljöversioner: | AIR 1.5 |
Tidigare placering av programlagringskatalogen, om den har ändrats efter en uppdatering. Programlagringskatalogens placering ändras efter en uppgradering med en certifikatflyttning. Om ingen certifikatflyttning sker, ändras inte programlagringskatalogen när användaren uppdaterar programmet. och den här egenskapen ställs in på null. Den här egenskapen ställs in under ett anrop till metoden initialize().
En utvecklare kan signera en ny version av AIR-programmet med ett nytt certifikat om utvecklaren använder alternativet -migrate när AIR-filen paketeras med ADT. Om en ny version av AIR-programmet använder ett nytt signeringscertifikat, ändras programmets lokala lagringskatalog när användaren installerar den nya versionen. Använd den här egenskapen om du vill överföra data från den gamla programlagringskatalogen till den nya (File.applicationStorageDirectory). Mer information finns i ”Signera en AIR-fil för att byta programcertifikatet” i kapitlet ”Skapa ett AIR-program med verktygen på kommandoraden” i utvecklarhandboken för Adobe AIR.
Implementering
public function get previousApplicationStorageDirectory():File previousVersion | egenskap |
previousVersion:String [skrivskyddad] | Språkversion: | ActionScript 3.0 |
| Körningsmiljöversioner: | AIR 1.5 |
Den tidigare versionen av programmet. Den här egenskapen ställs in under ett anrop till metoden initialize(). Returnerar den tidigare versionen av programmet före uppgraderingen (ställs bara in om isfirstRun är true), annars ställs den in på null.
Implementering
public function get previousVersion():String updateDescriptor | egenskap |
updateDescriptor:XML [skrivskyddad] | Språkversion: | ActionScript 3.0 |
| Körningsmiljöversioner: | AIR 1.5 |
Innehållet i uppdateringsbeskrivningsfilen som hämtats från uppdaterings-URL:en. Den här egenskapen är icke-null bara när uppdaterarobjektet skickar en updateStatus-händelse.
Implementering
public function get updateDescriptor():XML updateURL | egenskap |
updateURL:String| Språkversion: | ActionScript 3.0 |
| Körningsmiljöversioner: | AIR 1.5 |
Platsen för uppdateringsbeskrivningsfilen. Alla platser som är giltiga för en URLRequest-sökväg accepteras. Detta är den enda obligatoriska inställningen som uppdateringen behöver. Du kan ställa in uppdaterings-URL:en via den här egenskapen eller konfigurationsfilen. När värdet ställs in med båda metoderna används värdet som ställs in med egenskapen.
Implementering
public function get updateURL():String public function set updateURL(value:String):void wasPendingUpdate | egenskap |
wasPendingUpdate:Boolean [skrivskyddad] | Språkversion: | ActionScript 3.0 |
| Körningsmiljöversioner: | AIR 1.5 |
Om det finns en uppskjuten uppdatering, även om det inte gick att installera den (true), och false i annat fall. Uppdateraren ställer in den här egenskapen under ett anrop till metoden initialize(). Använd egenskaperna wasPendingUpdate och isFirstRun om du vill kontrollera om en uppdatering inte har kunnat installeras (i så fall ställs wasPendingUpdate in på true och isFirstRun ställs in på false).
Implementering
public function get wasPendingUpdate():BooleanRelaterade API-element
ApplicationUpdater | () | Konstruktor |
public function ApplicationUpdater()| Språkversion: | ActionScript 3.0 |
| Körningsmiljöversioner: | AIR 1.5 |
Konstruktorfunktionen.
cancelUpdate | () | metod |
public function cancelUpdate():void| Språkversion: | ActionScript 3.0 |
| Körningsmiljöversioner: | AIR 1.5 |
Avbryter uppdateringsprocessen. Om du anropar den här metoden avbryts alla väntande hämtningar, alla ofullständiga hämtningsfiler tas bort och den periodiska kontrolltidtagaren startar om.
Uppdateringsprocessen kan avbrytas när som helst utom när läget är ”UNINITIALIZED” eller ”INITIALIZING”. Inget händer när den anropas i läget ”UNINITIALIZED” eller ”INITIALIZING”.
checkForUpdate | () | metod |
public function checkForUpdate():void| Språkversion: | ActionScript 3.0 |
| Körningsmiljöversioner: | AIR 1.5 |
Hämtar och tolkar uppdateringsbeskrivningsfilen asynkront. Om du anropar den här metoden flyttas uppdaterarens läge till ”CHECKING”. Anropa bara den här metoden om checkForUpdate-händelsen avbryts.
Den här metoden körs bara när uppdateraren är i läget ”BEFORE_CHECKING”.
Händelser
updateStatus: — Uppdateraren har hämtat och tolkat uppdateringsbeskrivningsfilen.
| |
updateError: — Ett fel inträffar under försök att hämta eller tolka uppdateringsbeskrivningsfilen.
|
checkNow | () | metod |
public function checkNow():void| Språkversion: | ActionScript 3.0 |
| Körningsmiljöversioner: | AIR 1.5 |
Startar uppdateringsprocessen. Om du anropar den här metoden stannar inte den periodiska tidtagaren, men metoden identifierar att en uppdateringsprocess körs och hoppar över den aktuella iterationen.
Den här metoden körs bara om det aktuella läget är ”READY”.
Den här metoden gör så att uppdaterarobjektet skickar följande händelse:
Händelser
checkForUpdate: — Skickas precis innan uppdateringsprocessen inleds.
|
downloadUpdate | () | metod |
public function downloadUpdate():void| Språkversion: | ActionScript 3.0 |
| Körningsmiljöversioner: | AIR 1.5 |
Hämtar uppdateringsfilen asynkront. Om du anropar den här metoden flyttas läget till ”DOWNLOADING”. Du behöver bara anropa den här metoden om händelsen StatusUpdateEvent.UPDATE_STATUS avbryts när den tillgängliga egenskapen för händelsen är true.
Den här metoden körs bara om det aktuella läget är ”AVAILABLE”.
Händelser
downloadStart: — Skickas när anslutningen till servern har upprättats.
| |
progress: — Skickas efter att initieringen är slutförd.
| |
downloadError: — Skickas om det uppstår ett fel under anslutning eller hämtning av uppdateringsfilen. Skickas också för ogiltig HTTP-status (till exempel 404 - Filen hittades inte).
|
initialize | () | metod |
public function initialize():void| Språkversion: | ActionScript 3.0 |
| Körningsmiljöversioner: | AIR 1.5 |
Initierar uppdateraren. Om du anropar den här metoden sker följande:
-
Den initierar uppdateringsramverket och installerar tyst (och asynkront) alla väntande uppdateringar. Du bör anropa den här metoden när programmet startar, eftersom den kan starta om programmet.
-
Den kontrollerar om det finns en uppdatering som har skjutits upp och installerar den.
-
Om något har gått fel med en tidigare uppdatering raderas uppdateringsfilen och versionsinformationen från lagringsutrymmet.
-
Om den periodiska tidsinställda fördröjningen har gått ut, startar uppdateringsprocessen om, annars startar den periodiska tidtagaren. När du testar ett program med AIR Debug Launcher (ADL) inträffar ett IllegalOperationError-undantag när du försöker att uppdatera programmet.
Händelser
initialized: — Initieringen är klar.
| |
error: — Ett fel sker under initieringen.
|
installFromAIRFile | () | metod |
public function installFromAIRFile(file:File):void| Språkversion: | ActionScript 3.0 |
| Körningsmiljöversioner: | AIR 1.5 |
Startar uppdateringsprocessen med en lokal AIR-fil.
Att anropa den här metoden har ingen effekt om en uppdateringsprocess körs (om läget inte är "DOWNLOADED").
Den här funktionen är användbar för ett program som har customUpdateUI-elementet inställt på true i programbeskrivningsfilen.
När du testar ett program med AIR Debug Launcher (ADL) orsakar anrop till metoden ett IllegalOperationError-undantag.
Parametrar
file:File — Den lokala AIR-filen som ska installeras.
|
Händelser
fileUpdateStatus: — Skickas när uppdateraren har lyckats validera AIR-filen.
| |
updateError: — Skickas om ett fel uppstår under försök att tolka uppdateringsbeskrivningsfilen.
|
installUpdate | () | metod |
public function installUpdate():void| Språkversion: | ActionScript 3.0 |
| Körningsmiljöversioner: | AIR 1.5 |
Installerar uppdateringsfilen. Om du anropar metoden flyttar läget fram till ”INSTALLING” och den behöver bara anropas om händelsen downLoadComplete anropas.
Anropa den här metoden när uppdateraren är i läget ”DOWNLOADED”. Om du anropar den i något annat läge händer ingenting.
När du testar ett program med AIR Debug Launcher (ADL) orsakar anrop till metoden ett IllegalOperationError-undantag.
Händelser
beforeInstall: — Skickas precis innan uppdateringen installeras. Ibland kan det vara praktiskt att vid den här tidpunkten förhindra installationen, eftersom användaren kan förlora allt aktuellt arbete när körningen avslutar programmet för att installera uppdateringen.
|
beforeInstall | Händelse |
air.update.events.UpdateEventegenskap UpdateEvent.type =
air.update.events.UpdateEvent.BEFORE_INSTALL| Språkversion: | ActionScript 3.0 |
| Körningsmiljöversioner: | AIR 1.5 |
Skickas precis innan uppdateringen installeras, efter att metoden installUpdate() anropas. Ibland kan det vara praktiskt att vid den här tidpunkten förhindra installationen, eftersom användaren kan förlora allt aktuellt arbete när körningen avslutar programmet för att installera uppdateringen.
Om du anropar den här händelsens preventDefault()-metod skjuts installationen upp till nästa omstart. Om du anropar metoden preventDefault() kan inga fler uppdateringsprocesser starta under programsessionen (via ett anrop till metoden installUpdate() eller på grund av den periodiska kontrollen).
Standardbeteendet för ApplicationUpdater-biblioteket är att hämta uppdateringsbeskrivningsfilen. Du kan anropa metoden preventDefault() om du vill avbryta det här beteendet.
UpdateEvent.BEFORE_INSTALL definierar värdet på type-egenskapen för händelseobjektet för en beforeInstall-händelse.
Den här händelsen har följande egenskaper:
| Egenskap | Värde |
|---|---|
bubbles | false |
cancelable | false; det finns inget standardbeteende att avbryta. |
currentTarget | Det objekt som aktivt behandlar Event-objektet med en händelseavlyssnare. |
target | Updater-objektet. |
checkForUpdate | Händelse |
air.update.events.UpdateEventegenskap UpdateEvent.type =
air.update.events.UpdateEvent.CHECK_FOR_UPDATE| Språkversion: | ActionScript 3.0 |
| Körningsmiljöversioner: | AIR 1.5 |
Skickas precis innan uppdateringsprocessen börjar, precis innan uppdateraren försöker att hämta uppdateringsbeskrivningsfilen. Uppdateraren kan skicka den här händelsen som ett resultat av ett direkt anrop till metoden checkNow(), eller på grund av att den periodiska kontrolltidtagaren har gått ut.
UpdateEvent.CHECK_FOR_UPDATE definierar värdet på type-egenskapen för händelseobjektet för en checkForUpdate-händelse.
Den här händelsen har följande egenskaper:
| Egenskap | Värde |
|---|---|
bubbles | false |
cancelable | false; det finns inget standardbeteende att avbryta. |
currentTarget | Det objekt som aktivt behandlar Event-objektet med en händelseavlyssnare. |
target | Updater-objektet. |
downloadComplete | Händelse |
air.update.events.UpdateEventegenskap UpdateEvent.type =
air.update.events.UpdateEvent.DOWNLOAD_COMPLETE| Språkversion: | ActionScript 3.0 |
| Körningsmiljöversioner: | AIR 1.5 |
Skickas när hämtningen av uppdateringsfilen är slutförd.
Vanligtvis används den här händelsen för att visa ett meddelande som frågar om användaren vill fortsätta att installera uppdateringen.
Standardbeteendet för ApplicationUpdater-biblioteket är att automatiskt anropa metoden installUpdate().
UpdateEvent.DOWNLOAD_COMPLETE definierar värdet på type-egenskapen för händelseobjektet för en downloadComplete-händelse.
Den här händelsen har följande egenskaper:
| Egenskap | Värde |
|---|---|
bubbles | false |
cancelable | false; det finns inget standardbeteende att avbryta. |
currentTarget | Det objekt som aktivt behandlar Event-objektet med en händelseavlyssnare. |
target | Updater-objektet. |
downloadError | Händelse |
air.update.events.DownloadErrorEventegenskap DownloadErrorEvent.type =
air.update.events.DownloadErrorEvent.DOWNLOAD_ERROR| Språkversion: | ActionScript 3.0 |
| Körningsmiljöversioner: | AIR 1.5 |
Skickas om det uppstår ett fel under anslutning eller hämtning av uppdateringsfilen. Skickas också för ogiltig HTTP-status (till exempel 404 - Filen hittades inte).
När den här händelsen skickas startar den periodiska tidtagaren om automatiskt (om fördröjningen är större än 0).
KonstantenDownloadErrorEvent.DOWNLOAD_ERROR definierar värdet på type-egenskapen för händelseobjektet för en downloadError-händelse.
Egenskapen errorID för ett DownloadErrorEvent-objekt är ett heltal som definierar felinformation (se tabellen nedan). En extra subErrorID-egenskap kan innehålla mer felinformation.
| errorID, felkod | Beskrivning |
|---|---|
| 16800 | Inträffar när den hämtade uppdateringsfilen valideras. Egenskapen subErrorID kan innehålla mer information. |
| 16801 | Ogiltig Adobe AIR-fil (application.xml saknas). |
| 16802 | Ogiltig Adobe AIR-fil (MIME-typen saknas). |
| 16803 | Ogiltig Adobe AIR-fil (format). |
| 16804 | Ogiltig Adobe AIR-fil (ogiltiga flaggor). |
| 16805 | Ogiltig Adobe AIR-fil (okänd komprimering). |
| 16806 | Ogiltig Adobe AIR-fil (ogiltigt filnamn). |
| 16807 | Ogiltig Adobe AIR-fil (skadad). |
| 16808 | Konfigurationsfilen finns inte. |
| 16809 | updateURL-egenskapen är inte inställd. |
| 16810 | Reserverad. |
| 16811 | Ogiltig konfigurationsfil (okänd konfigurationsversion). |
| 16812 | Ogiltig konfigurationsfil (URL saknas). |
| 16813 | Ogiltig konfigurationsfil (fördröjningsformat). |
| 16814 | Ogiltig konfigurationsfil (ogiltiga defaultUI-värden). |
| 16815 | Ogiltig uppdateringsbeskrivning (okänd beskrivningsversion). |
| 16816 | Ogiltig uppdateringsbeskrivning (uppdateringsversionen saknas). |
| 16817 | Ogiltig uppdateringsbeskrivning (ogiltig beskrivning). |
| 16818 | IO-fel när data sparas på disken. Egenskapen subErrorID kan innehålla mer information. |
| 16819 | Säkerhetsfel under hämtning. Egenskapen subErrorID kan innehålla mer information. |
| 16820 | Ogiltig HTTP-statuskod. subErrorID-egenskapen kan innehålla den ogiltiga statuskoden. |
| 16821 | Reserverad. |
| 16822 | I/O-fel vid hämtning. Egenskapen subErrorID kan innehålla mer information. |
| 16823 | Filslutsfel när data sparas på disk. Egenskapen subErrorID kan innehålla mer information. |
| 16824 | Ogiltig uppdateringsbeskrivning. Egenskapen subErrorID kan innehålla mer information. |
| 16825 | Uppdateringsfilen innehåller ett program med ett annat program-ID. |
| 16826 | Uppdateringsfilen innehåller inte en nyare version av programmet. |
| 16827 | Versionen som finns i uppdateringsfilen matchar inte versionen från uppdateringsbeskrivningen. |
| 16828 | Det går inte att uppdatera programmet, vanligtvis på grund av att programmet körs i AIR Debug Launcher (ADL). |
| 16829 | Uppdateringsfilen saknas vid installationen. |
downloadStart | Händelse |
air.update.events.UpdateEventegenskap UpdateEvent.type =
air.update.events.UpdateEvent.DOWNLOAD_START| Språkversion: | ActionScript 3.0 |
| Körningsmiljöversioner: | AIR 1.5 |
Skickas efter ett anrop till metoden downloadUpdate() när anslutningen till servern är upprättad. När du använder ApplicationUpdater-biblioteket kanske du vill att händelsehanteraren för den här händelsen ska visa en förloppsindikator för att rapportera hämtningsförloppet för användaren.
UpdateEvent.DOWNLOAD_START definierar värdet på type-egenskapen för händelseobjektet för en downloadStart-händelse.
Den här händelsen har följande egenskaper:
| Egenskap | Värde |
|---|---|
bubbles | false |
cancelable | false; det finns inget standardbeteende att avbryta. |
currentTarget | Det objekt som aktivt behandlar Event-objektet med en händelseavlyssnare. |
target | Updater-objektet. |
error | Händelse |
flash.events.ErrorEventegenskap ErrorEvent.type =
flash.events.ErrorEvent.ERROR| Språkversion: | ActionScript 3.0 |
| Körningsmiljöversioner: | AIR 1.5 |
Skickas när ett fel inträffar antingen under initiering eller under uppdateringsprocessen (om något oväntat inträffar).
Definierar värdet för etterror-händelseobjekts type-egenskap.
Den här händelsen har följande egenskaper:
| Egenskap | Värde |
|---|---|
bubbles | false |
cancelable | false; det finns inget standardbeteende att avbryta. |
currentTarget | Det objekt som aktivt behandlar Event-objektet med en händelseavlyssnare. |
target | Objektet är med om ett nätverksfel. |
text | Text som visas som felmeddelande. |
fileUpdateError | Händelse |
air.update.events.StatusFileUpdateErrorEventegenskap StatusFileUpdateErrorEvent.type =
air.update.events.StatusFileUpdateErrorEvent.FILE_UPDATE_ERROR| Språkversion: | ActionScript 3.0 |
| Körningsmiljöversioner: | AIR 1.5 |
Skickas när ett fel uppstår under validering av den fil som skickas som airFile-parameter i ett anrop till metoden installFromAIRFile().
StatusUpdateErrorEvent.UPDATE_ERROR definierar värdet på type-egenskapen för händelseobjektet för en statusUpdateError-händelse.
fileUpdateStatus | Händelse |
air.update.events.StatusFileUpdateEventegenskap StatusFileUpdateEvent.type =
air.update.events.StatusFileUpdateEvent.FILE_UPDATE_STATUS| Språkversion: | ActionScript 3.0 |
| Körningsmiljöversioner: | AIR 1.5 |
Skickas efter att uppdateraren validerat filen i anropet till metoden installFromAIRFile().
StatusUpdateEvent.UPDATE_STATUS definierar värdet på type-egenskapen för händelseobjektet för en updateStatus-händelse.
Den här händelsen har följande egenskaper:
| Egenskap | Värde |
|---|---|
available | Anger om det finns en annan version än det installerade programmets version tillgänglig (true), annars false (samma version). |
path | nativePath-egenskapen för update File-objektet som anges av parametern airFile i ett anrop till metoden installFromAIRFile(). |
version | Anger den nya uppdateringens version. |
initialized | Händelse |
air.update.events.UpdateEventegenskap UpdateEvent.type =
air.update.events.UpdateEvent.INITIALIZED| Språkversion: | ActionScript 3.0 |
| Körningsmiljöversioner: | AIR 1.5 |
Skickas efter att initieringen är slutförd.
KonstantenUpdateEvent.INITIALIZED definierar värdet på type-egenskapen för händelseobjektet för en initialized-händelse.
Den här händelsen har följande egenskaper:
| Egenskap | Värde |
|---|---|
bubbles | false |
cancelable | false; det finns inget standardbeteende att avbryta. |
currentTarget | Det objekt som aktivt behandlar Event-objektet med en händelseavlyssnare. |
target | Updater-objektet. |
progress | Händelse |
flash.events.ProgressEventegenskap ProgressEvent.type =
flash.events.ProgressEvent.PROGRESS| Språkversion: | ActionScript 3.0 |
| Körningsmiljöversioner: | AIR 1.5 |
Skickas när uppdateringsfilen hämtas.
Definierar värdet för ettprogress-händelseobjekts type-egenskap.
Den här händelsen har följande egenskaper:
| Egenskap | Värde |
|---|---|
bubbles | false |
bytesLoaded | Antalet objekt eller byte som har lästs in när avlyssnaren bearbetar händelsen. |
bytesTotal | Det totala antalet objekt eller byte som kommer att ha lästs in om inläsningen lyckas. |
cancelable | false; det finns inget standardbeteende att avbryta. |
currentTarget | Det objekt som aktivt behandlar Event-objektet med en händelseavlyssnare. |
target | Objektet rapporterar förlopp. |
updateError | Händelse |
air.update.events.StatusUpdateErrorEventegenskap StatusUpdateErrorEvent.type =
air.update.events.StatusUpdateErrorEvent.UPDATE_ERROR| Språkversion: | ActionScript 3.0 |
| Körningsmiljöversioner: | AIR 1.5 |
Skickas om ett fel uppstår under försök att hämta eller tolka uppdateringsbeskrivningsfilen.
När uppdateraren skickar den här händelsen startar den periodiska tidtagaren om automatiskt (om fördröjningsinställningen är större än 0). Programmet bör överväga att dölja feldialogrutorna när uppdateraren skickar en ny checkForUpdate-händelse.
StatusUpdateErrorEvent.UPDATE_ERROR definierar värdet på type-egenskapen för händelseobjektet för en statusUpdateError-händelse.
updateStatus | Händelse |
air.update.events.StatusUpdateEventegenskap StatusUpdateEvent.type =
air.update.events.StatusUpdateEvent.UPDATE_STATUS| Språkversion: | ActionScript 3.0 |
| Körningsmiljöversioner: | AIR 1.5 |
Skickas efter att uppdateraren slutfört hämtning och tolkning av uppdateringsbeskrivningsfilen.
Standardbeteendet för att börja hämta uppdateringsfilen om den tillgängliga egenskapen för objektet StatusUpdateEvent ställs in på true. Du kan bara förhindra standardbeteendet när klassen ApplicationUpdater används, inte när du använder klassen ApplicationUpdatorUI.
StatusUpdateEvent.UPDATE_STATUS definierar värdet på type-egenskapen för händelseobjektet för en updateStatus-händelse.
Den här händelsen har följande egenskaper:
| Egenskap | Värde |
|---|---|
available | Ställ in på true om uppdateringsbeskrivningen anger en annan version än den för det aktuella programmet, annars på false (versionen är densamma). |
version | Strängen som representerar den nya tillgängliga versionen. |
information | En array som definierar informationssträngen för varje språk som stöds. Om det inte finns någon lokaliserad beskrivning, definieras denna som en array där det första elementet är en tom sträng ("") och det andra elementet är informationssträngen. När det finns lokaliserade beskrivningar är varje element i arrayen självt en array med två element. Det första elementet är språkkoden, och den andra är beskrivningen. Följande array har till exempel underarrayer för två språk (amerikansk engelska och franska): ["en-US", "Hello World"], ["fr", "Bonjour monde"]. Språken anges i samma ordning som i uppdateringsbeskrivningen. Texten för egenskapen details anges i uppdateringens beskrivningsfil. |
versionLabel | (AIR 2.5+) Versionsetiketten från uppdateringens programbeskrivningsfil. Versionsetiketten bör visas för användare i stället för versionen. Om ingen versionsetikett anges är den här egenskapen en tom sträng. |
Tue Jun 12 2018, 01:40 PM Z