Referenshandbok för ActionScript® 3.0 i Adobe® Flash®-plattformen
Hem  |  Dölj paket och klasslista |  Paket  |  Klasser  |  Nyheter  |  Index  |  Bilagor  |  Varför på engelska?
Filter: Hämtar data från servern ...
Hämtar data från servern ...
air.update 

ApplicationUpdater  - AS3

Paketair.update
Klasspublic class ApplicationUpdater
ArvApplicationUpdater Inheritance EventDispatcher Inheritance Object

Språkversion: ActionScript 3.0
Körningsmiljöversioner: AIR 1.5

Klassen ApplicationUpdater definierar grundfunktionerna för uppdateringsramverket för Adobe® AIR®-program, utan att innehålla ett standardanvändargränssnitt. (Klassen ApplicationUpdaterUI innehåller uppdateringsfunktioner och ett standardanvändargränssnitt.)

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



Publika egenskaper
 EgenskapDefinieras med
      configurationFile : File
Platsen för den konfigurationsfil som anger värdena för updateURL och delay.
ApplicationUpdater
 Inheritedconstructor : 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
Publika metoder
 MetodDefinieras med
  
Konstruktorfunktionen.
ApplicationUpdater
 Inherited
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
  
    cancelUpdate():void
Avbryter uppdateringsprocessen.
ApplicationUpdater
  
Hämtar och tolkar uppdateringsbeskrivningsfilen asynkront.
ApplicationUpdater
  
    checkNow():void
Startar uppdateringsprocessen.
ApplicationUpdater
 Inherited
Skickar en händelse till händelseflödet.
EventDispatcher
  
Hämtar uppdateringsfilen asynkront.
ApplicationUpdater
 Inherited
Kontrollerar om EventDispatcher-objektet har några avlyssnare registrerade för en viss typ av händelse.
EventDispatcher
 Inherited
Anger om det finns en egenskap angiven för ett objekt.
Object
  
    initialize():void
Initierar uppdateraren.
ApplicationUpdater
  
Startar uppdateringsprocessen med en lokal AIR-fil.
ApplicationUpdater
  
Installerar uppdateringsfilen.
ApplicationUpdater
 Inherited
Anger om en instans av klassen Object finns i prototypkedjan för objektet som anges som parameter.
Object
 Inherited
Anger om den angivna egenskapen finns och är uppräkningsbar.
Object
 Inherited
removeEventListener(type:String, listener:Function, useCapture:Boolean = false):void
Tar bort en avlyssnare från EventDispatcher-objektet.
EventDispatcher
 Inherited
Anger tillgänglighet för en dynamisk egenskap för slingåtgärder.
Object
 Inherited
Returnerar det här objektets strängrepresentation, formaterad i enlighet med språkspecifika konventioner.
Object
 Inherited
Returnerar det angivna objektets strängbeteckning.
Object
 Inherited
Returnerar det angivna objektets primitiva värde.
Object
 Inherited
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ändelser
 Händelse Sammanfattning Definieras med
 Inherited[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
 Inherited[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
  
    error
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
  
    initialized
Skickas efter att initieringen är slutförd.ApplicationUpdater
  
    progress
Skickas när uppdateringsfilen hämtas.ApplicationUpdater
  
    updateError
Skickas om ett fel uppstår under försök att hämta eller tolka uppdateringsbeskrivningsfilen.ApplicationUpdater
  
    updateStatus
Skickas efter att uppdateraren slutfört hämtning och tolkning av uppdateringsbeskrivningsfilen.ApplicationUpdater
Egenskapsdetaljer
    

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):void

Relaterade 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():Boolean

Relaterade 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):void

Exempel  ( Så här använder du exemplet )
Följande kod definierar en anpassad funktion, 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():Boolean

Relaterade API-element

Konstruktordetaljer
    

ApplicationUpdater

()Konstruktor
public function ApplicationUpdater()

Språkversion: ActionScript 3.0
Körningsmiljöversioner: AIR 1.5

Konstruktorfunktionen.

Metoddetaljer

    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:StatusUpdateEvent — Uppdateraren har hämtat och tolkat uppdateringsbeskrivningsfilen.
 
updateError:StatusUpdateErrorEvent — 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:UpdateEvent — 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:UpdateEvent — Skickas när anslutningen till servern har upprättats.
 
progress:ProgressEvent — Skickas efter att initieringen är slutförd.
 
downloadError:DownloadErrorEvent — 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:

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

  2. Den kontrollerar om det finns en uppdatering som har skjutits upp och installerar den.

  3. Om något har gått fel med en tidigare uppdatering raderas uppdateringsfilen och versionsinformationen från lagringsutrymmet.

  4. 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:UpdateEvent — Initieringen är klar.
 
error:ErrorEvent — 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:StatusFileUpdateEvent — Skickas när uppdateraren har lyckats validera AIR-filen.
 
updateError:StatusFileUpdateErrorEvent — 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:UpdateEvent — 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.
Händelsedetaljer
    

beforeInstall

Händelse
Typ av händelseobjekt: air.update.events.UpdateEvent
egenskap 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.

Konstanten 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:

EgenskapVärde
bubblesfalse
cancelablefalse; det finns inget standardbeteende att avbryta.
currentTargetDet objekt som aktivt behandlar Event-objektet med en händelseavlyssnare.
targetUpdater-objektet.
    

checkForUpdate

Händelse  
Typ av händelseobjekt: air.update.events.UpdateEvent
egenskap 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.

Konstanten 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:

EgenskapVärde
bubblesfalse
cancelablefalse; det finns inget standardbeteende att avbryta.
currentTargetDet objekt som aktivt behandlar Event-objektet med en händelseavlyssnare.
targetUpdater-objektet.
    

downloadComplete

Händelse  
Typ av händelseobjekt: air.update.events.UpdateEvent
egenskap 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().

Konstanten 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:

EgenskapVärde
bubblesfalse
cancelablefalse; det finns inget standardbeteende att avbryta.
currentTargetDet objekt som aktivt behandlar Event-objektet med en händelseavlyssnare.
targetUpdater-objektet.
    

downloadError

Händelse  
Typ av händelseobjekt: air.update.events.DownloadErrorEvent
egenskap 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).

Konstanten DownloadErrorEvent.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, felkodBeskrivning
16800Inträffar när den hämtade uppdateringsfilen valideras. Egenskapen subErrorID kan innehålla mer information.
16801Ogiltig Adobe AIR-fil (application.xml saknas).
16802Ogiltig Adobe AIR-fil (MIME-typen saknas).
16803Ogiltig Adobe AIR-fil (format).
16804Ogiltig Adobe AIR-fil (ogiltiga flaggor).
16805Ogiltig Adobe AIR-fil (okänd komprimering).
16806Ogiltig Adobe AIR-fil (ogiltigt filnamn).
16807Ogiltig Adobe AIR-fil (skadad).
16808Konfigurationsfilen finns inte.
16809updateURL-egenskapen är inte inställd.
16810Reserverad.
16811Ogiltig konfigurationsfil (okänd konfigurationsversion).
16812Ogiltig konfigurationsfil (URL saknas).
16813Ogiltig konfigurationsfil (fördröjningsformat).
16814Ogiltig konfigurationsfil (ogiltiga defaultUI-värden).
16815Ogiltig uppdateringsbeskrivning (okänd beskrivningsversion).
16816Ogiltig uppdateringsbeskrivning (uppdateringsversionen saknas).
16817Ogiltig uppdateringsbeskrivning (ogiltig beskrivning).
16818IO-fel när data sparas på disken. Egenskapen subErrorID kan innehålla mer information.
16819Säkerhetsfel under hämtning. Egenskapen subErrorID kan innehålla mer information.
16820Ogiltig HTTP-statuskod. subErrorID-egenskapen kan innehålla den ogiltiga statuskoden.
16821Reserverad.
16822I/O-fel vid hämtning. Egenskapen subErrorID kan innehålla mer information.
16823Filslutsfel när data sparas på disk. Egenskapen subErrorID kan innehålla mer information.
16824Ogiltig uppdateringsbeskrivning. Egenskapen subErrorID kan innehålla mer information.
16825Uppdateringsfilen innehåller ett program med ett annat program-ID.
16826Uppdateringsfilen innehåller inte en nyare version av programmet.
16827Versionen som finns i uppdateringsfilen matchar inte versionen från uppdateringsbeskrivningen.
16828Det går inte att uppdatera programmet, vanligtvis på grund av att programmet körs i AIR Debug Launcher (ADL).
16829Uppdateringsfilen saknas vid installationen.
    

downloadStart

Händelse  
Typ av händelseobjekt: air.update.events.UpdateEvent
egenskap 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.

Konstanten 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:

EgenskapVärde
bubblesfalse
cancelablefalse; det finns inget standardbeteende att avbryta.
currentTargetDet objekt som aktivt behandlar Event-objektet med en händelseavlyssnare.
targetUpdater-objektet.
    

error

Händelse  
Typ av händelseobjekt: flash.events.ErrorEvent
egenskap 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 ett error-händelseobjekts type-egenskap.

Den här händelsen har följande egenskaper:

EgenskapVärde
bubblesfalse
cancelablefalse; det finns inget standardbeteende att avbryta.
currentTargetDet objekt som aktivt behandlar Event-objektet med en händelseavlyssnare.
targetObjektet är med om ett nätverksfel.
textText som visas som felmeddelande.
    

fileUpdateError

Händelse  
Typ av händelseobjekt: air.update.events.StatusFileUpdateErrorEvent
egenskap 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().

Konstanten StatusUpdateErrorEvent.UPDATE_ERROR definierar värdet på type-egenskapen för händelseobjektet för en statusUpdateError-händelse.
    

fileUpdateStatus

Händelse  
Typ av händelseobjekt: air.update.events.StatusFileUpdateEvent
egenskap 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().

Konstanten 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:

EgenskapVärde
availableAnger om det finns en annan version än det installerade programmets version tillgänglig (true), annars false (samma version).
pathnativePath-egenskapen för update File-objektet som anges av parametern airFile i ett anrop till metoden installFromAIRFile().
versionAnger den nya uppdateringens version.

    

initialized

Händelse  
Typ av händelseobjekt: air.update.events.UpdateEvent
egenskap 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.

Konstanten UpdateEvent.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:

EgenskapVärde
bubblesfalse
cancelablefalse; det finns inget standardbeteende att avbryta.
currentTargetDet objekt som aktivt behandlar Event-objektet med en händelseavlyssnare.
targetUpdater-objektet.
    

progress

Händelse  
Typ av händelseobjekt: flash.events.ProgressEvent
egenskap 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 ett progress-händelseobjekts type-egenskap.

Den här händelsen har följande egenskaper:

EgenskapVärde
bubblesfalse
bytesLoadedAntalet objekt eller byte som har lästs in när avlyssnaren bearbetar händelsen.
bytesTotalDet totala antalet objekt eller byte som kommer att ha lästs in om inläsningen lyckas.
cancelablefalse; det finns inget standardbeteende att avbryta.
currentTargetDet objekt som aktivt behandlar Event-objektet med en händelseavlyssnare.
targetObjektet rapporterar förlopp.
    

updateError

Händelse  
Typ av händelseobjekt: air.update.events.StatusUpdateErrorEvent
egenskap 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.

Konstanten StatusUpdateErrorEvent.UPDATE_ERROR definierar värdet på type-egenskapen för händelseobjektet för en statusUpdateError-händelse.
    

updateStatus

Händelse  
Typ av händelseobjekt: air.update.events.StatusUpdateEvent
egenskap 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.

Konstanten 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:

EgenskapVärde
availableStäll in på true om uppdateringsbeskrivningen anger en annan version än den för det aktuella programmet, annars på false (versionen är densamma).
versionSträngen som representerar den nya tillgängliga versionen.
informationEn 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.




[ X ]Varför på engelska?
Innehåll i Referenshandbok för ActionScript 3.0 i Adobe Flash-plattformen är på engelska

Det är inte alla delar av Referenshandbok för ActionScript 3.0 i Adobe Flash-plattformen som översätts till alla språk. Om ett språkelement inte översätts visas det på engelska. Klassen ga.controls.HelpBox översätts till exempel inte till något språk. I den svenska versionen av referenshandboken visas därför klassen ga.controls.HelpBox på engelska.