ApplicationUpdaterUI

Paket	air.update
Klass	public class ApplicationUpdaterUI
Arv	ApplicationUpdaterUI EventDispatcher Object

Språkversion:

ActionScript 3.0

Körningsmiljöversioner:

AIR 1.5

Klassen ApplicationUpdaterUI definierar grundfunktionerna för uppdateringsramverket för Adobe^® AIR^®-program, och den innehåller ett standardanvändargränssnitt. (Klassen ApplicationUpdater definierar uppdateringsfunktioner utan att implementera 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. Versionen i katalogen frameworks/libs/air i AIR 2 SDK gäller för Flex 4-utveckling. Om du använder Flex 3 ska du använda versionen som finns i underkatalogen frameworks/libs/air/flex3.

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.

Klassen AIRUpdateUI implementerar ett standardanvändargränssnitt som programmet kan använda. Den förser användaren med grundläggande information och alternativ för programuppdateringar.

Uppdateringsprocessen går igenom en serie lägen:

Läge	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 install	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

ApplicationUpdater
flash.desktop.Updater

Publika egenskaper

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.	ApplicationUpdaterUI
		constructor : Object En referens till klassobjektet eller konstruktorfunktionen för en given objektinstans.	Object
		currentVersion : String [skrivskyddad] Den aktuella versionen av programmet.	ApplicationUpdaterUI
		delay : Number Intervallet i dagar mellan periodiska sökningar efter nya uppdateringar.	ApplicationUpdaterUI
		isCheckForUpdateVisible : Boolean Aktiverar synligheten för dialogrutorna Leta efter uppdatering, Ingen uppdatering och Uppdateringsfel.	ApplicationUpdaterUI
		isDownloadProgressVisible : Boolean Aktiverar synligheten för dialogrutan Ladda ned uppdatering.	ApplicationUpdaterUI
		isDownloadUpdateVisible : Boolean Aktiverar synligheten för dialogrutan Ladda ned uppdatering.	ApplicationUpdaterUI
		isFileUpdateVisible : Boolean Aktiverar synligheten för dialogrutorna Filuppdatering, Ingen filuppdatering och Filfel.	ApplicationUpdaterUI
		isFirstRun : Boolean [skrivskyddad] Om detta är den första körningen efter en lyckad uppdatering (true) eller inte (false).	ApplicationUpdaterUI
		isInstallUpdateVisible : Boolean Aktiverar synligheten för dialogrutan Installera uppdatering.	ApplicationUpdaterUI
		isNewerVersionFunction : Function En funktion som uppdateraren ska använda för att utföra versionsjämförelser.	ApplicationUpdaterUI
		isUnexpectedErrorVisible : Boolean Aktiverar synligheten för dialogrutan Oväntat fel.	ApplicationUpdaterUI
		isUpdateInProgress : Boolean [skrivskyddad] En boolesk egenskap som är true om en uppdatering körs, och annars false.	ApplicationUpdaterUI
		localeChain : Array En array som definierar språkkedjan som används av användargränssnittet.	ApplicationUpdaterUI
		previousApplicationStorageDirectory : File [skrivskyddad] Tidigare placering av programlagringskatalogen, om den har ändrats efter en uppdatering.	ApplicationUpdaterUI
		previousVersion : String [skrivskyddad] Den tidigare versionen av programmet.	ApplicationUpdaterUI
		updateDescriptor : XML [skrivskyddad] Innehållet i uppdateringsbeskrivningsfilen som hämtats från uppdaterings-URL:en.	ApplicationUpdaterUI
		updateURL : String Platsen för uppdateringsbeskrivningsfilen.	ApplicationUpdaterUI
		wasPendingUpdate : Boolean [skrivskyddad] Om det finns en uppskjuten uppdatering, även om det inte gick att installera den (true), och false i annat fall.	ApplicationUpdaterUI

Publika metoder

Dölj ärvda publika metoder

Visa ärvda publika metoder

	Metod		Definieras med
		ApplicationUpdaterUI() Konstruktorfunktionen.	ApplicationUpdaterUI
		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
		addResources(lang:String, res:Object):void Lägger dynamiskt till ett nytt resurspaket för det angivna språket.	ApplicationUpdaterUI
		cancelUpdate():void Avbryter uppdateringsprocessen.	ApplicationUpdaterUI
		checkNow():void Startar uppdateringsprocessen.	ApplicationUpdaterUI
		dispatchEvent(event:Event):Boolean Skickar en händelse till händelseflödet.	EventDispatcher
		hasEventListener(type:String):Boolean Kontrollerar om EventDispatcher-objektet har några avlyssnare registrerade för en viss typ av händelse.	EventDispatcher
		hasOwnProperty(name:String):Boolean Anger om det finns en egenskap angiven för ett objekt.	Object
		initialize():void Initierar uppdateraren.	ApplicationUpdaterUI
		installFromAIRFile(file:File):void Startar uppdateringsprocessen med en lokal AIR-fil.	ApplicationUpdaterUI
		isPrototypeOf(theClass:Object):Boolean Anger om en instans av klassen Object finns i prototypkedjan för objektet som anges som parameter.	Object
		propertyIsEnumerable(name:String):Boolean Anger om den angivna egenskapen finns och är uppräkningsbar.	Object
		removeEventListener(type:String, listener:Function, useCapture:Boolean = false):void Tar bort en avlyssnare från EventDispatcher-objektet.	EventDispatcher
		setPropertyIsEnumerable(name:String, isEnum:Boolean = true):void Anger tillgänglighet för en dynamisk egenskap för slingåtgärder.	Object
		toLocaleString():String Returnerar det här objektets strängrepresentation, formaterad i enlighet med språkspecifika konventioner.	Object
		toString():String Returnerar det angivna objektets strängbeteckning.	Object
		valueOf():Object Returnerar det angivna objektets primitiva värde.	Object
		willTrigger(type:String):Boolean 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

Klicka för mer information om händelser

Dölj ärvda händelser

Visa ärvda händelser

	Sammanfattning	Definieras med
activate	[utsändningshändelse] Skickas när Flash Player eller AIR får operativsystemfokus och blir aktivt.	EventDispatcher
beforeInstall	Skickas precis innan uppdateringen installeras, efter att metoden installUpdate() anropats.	ApplicationUpdaterUI
checkForUpdate	Skickas precis innan uppdateringsprocessen börjar, precis innan uppdateraren försöker att hämta uppdateringsbeskrivningsfilen.	ApplicationUpdaterUI
deactivate	[utsändningshändelse] Skickas när Flash Player eller AIR förlorar operativsystemfokus och blir inaktivt.	EventDispatcher
downloadComplete	Skickas när hämtningen av uppdateringsfilen är slutförd.	ApplicationUpdaterUI
downloadError	Skickas om det uppstår ett fel under anslutning eller hämtning av uppdateringsfilen.	ApplicationUpdaterUI
downloadStart	Skickas efter ett anrop till metoden downloadUpdate() när anslutningen till servern är upprättad.	ApplicationUpdaterUI
error	Skickas när ett fel inträffar antingen under initiering eller under uppdateringsprocessen (om något oväntat inträffar).	ApplicationUpdaterUI
fileUpdateError	Skickas när ett fel uppstår under validering av den fil som skickas som airFile-parameter i ett anrop till metoden installFromAIRFile().	ApplicationUpdaterUI
fileUpdateStatus	Skickas efter att uppdateraren validerat filen i anropet till metoden installFromAIRFile().	ApplicationUpdaterUI
initialized	Skickas efter att initieringen är slutförd.	ApplicationUpdaterUI
progress	Skickas när uppdateringsfilen hämtas.	ApplicationUpdaterUI
updateError	Skickas om ett fel uppstår under försök att hämta eller tolka uppdateringsbeskrivningsfilen.	ApplicationUpdaterUI
updateStatus	Skickas efter att uppdateraren slutfört hämtning och tolkning av uppdateringsbeskrivningsfilen.	ApplicationUpdaterUI

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. Den har också inställningar för att bestämma om programmet visar olika bekräftelsedialogrutor under uppdateringen. 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>
           <defaultUI>
              <dialog name="checkForUpdate" visible="true" />
               <dialog name="downloadUpdate" visible="false" />
               <dialog name="downloadProgress" visible="true" />
               <dialog name="installUpdate" visible="true" />    
           </defaultUI>
        </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 för objektet ApplicationUpdaterUI. delay, isCheckForUpdateVisible, isDownloadProgressVisible, isDownloadUpdateVisible, isFileUpdateVisible, isInstallUpdateVisible och updateURL.

Implementering
public function get configurationFile():File
public function set configurationFile(value:File):void

Relaterade API-element

delay
updateURL

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. Fördröjningen 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

Relaterade API-element

configurationFile

isCheckForUpdateVisible

egenskap

isCheckForUpdateVisible:Boolean

Språkversion:

ActionScript 3.0

Körningsmiljöversioner:

AIR 1.5

Aktiverar synligheten för dialogrutorna Leta efter uppdatering, Ingen uppdatering och Uppdateringsfel. När denna anges till true visar uppdateraren dessa dialogrutor under uppdateringen. Den kan också ställas in i uppdateringskonfigurationsfilen. Ett värde som ställs in med den här egenskapen åsidosätter inställningen i uppdateringskonfigurationsfilen.

Implementering
public function get isCheckForUpdateVisible():Boolean
public function set isCheckForUpdateVisible(value:Boolean):void

isDownloadProgressVisible

egenskap

isDownloadProgressVisible:Boolean

Språkversion:

ActionScript 3.0

Körningsmiljöversioner:

AIR 1.5

Aktiverar synligheten för dialogrutan Ladda ned uppdatering. När denna anges till true visar uppdateraren den här dialogrutan under uppdateringen. Den kan också ställas in i uppdateringskonfigurationsfilen. Ett värde som ställs in med den här egenskapen åsidosätter inställningen i uppdateringskonfigurationsfilen.

Implementering
public function get isDownloadProgressVisible():Boolean
public function set isDownloadProgressVisible(value:Boolean):void

isDownloadUpdateVisible

egenskap

isDownloadUpdateVisible:Boolean

Körningsmiljöversioner:

AIR 1.5

Aktiverar synligheten för dialogrutan Ladda ned uppdatering. När denna anges till true visar uppdateraren dessa dialogrutor under uppdateringen. Den kan också ställas in i uppdateringskonfigurationsfilen. Ett värde som ställs in med den här egenskapen åsidosätter inställningen i uppdateringskonfigurationsfilen.

Implementering
public function get isDownloadUpdateVisible():Boolean
public function set isDownloadUpdateVisible(value:Boolean):void

isFileUpdateVisible

egenskap

isFileUpdateVisible:Boolean

Språkversion:

ActionScript 3.0

Körningsmiljöversioner:

AIR 1.5

Aktiverar synligheten för dialogrutorna Filuppdatering, Ingen filuppdatering och Filfel. När denna anges till true visar uppdateraren dessa dialogrutor under uppdateringen. Den kan också ställas in i uppdateringskonfigurationsfilen. Ett värde som ställs in med den här egenskapen åsidosätter inställningen i uppdateringskonfigurationsfilen.

Implementering
public function get isFileUpdateVisible():Boolean
public function set isFileUpdateVisible(value:Boolean):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

wasPendingUpdate

isInstallUpdateVisible

egenskap

isInstallUpdateVisible:Boolean

Språkversion:

ActionScript 3.0

Körningsmiljöversioner:

AIR 1.5

Aktiverar synligheten för dialogrutan Installera uppdatering. När denna anges till true visar uppdateraren den här dialogrutan under uppdateringen. Den kan också ställas in i uppdateringskonfigurationsfilen. Ett värde som ställs in med den här egenskapen åsidosätter inställningen i uppdateringskonfigurationsfilen.

Implementering
public function get isInstallUpdateVisible():Boolean
public function set isInstallUpdateVisible(value:Boolean):void

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

isUnexpectedErrorVisible

egenskap

isUnexpectedErrorVisible:Boolean

Språkversion:

ActionScript 3.0

Körningsmiljöversioner:

AIR 1.5

Aktiverar synligheten för dialogrutan Oväntat fel. När denna anges till true visar programuppdateraren den här dialogrutan under uppdateringen. Den kan också ställas in i uppdateringskonfigurationsfilen. Ett värde som ställs in med den här egenskapen åsidosätter inställningen i uppdateringskonfigurationsfilen.

Implementering
public function get isUnexpectedErrorVisible():Boolean
public function set isUnexpectedErrorVisible(value:Boolean):void

isUpdateInProgress

egenskap

isUpdateInProgress:Boolean [skrivskyddad]

Språkversion:

ActionScript 3.0

Körningsmiljöversioner:

AIR 1.5

En boolesk egenskap som är true om en uppdatering körs, och annars false.

Implementering
public function get isUpdateInProgress():Boolean

localeChain

egenskap

localeChain:Array

Språkversion:

ActionScript 3.0

Körningsmiljöversioner:

AIR 1.5

En array som definierar språkkedjan som används av användargränssnittet. Oftast är det bara utvecklare av JavaScript (HTML) som använder den här egenskapen.

Flex-utvecklare kan använda ResourceManager för att hantera den lokala kedjan.

I ett HTML-baserat program sorteras språken som standard mellan språken i arrayen Capabilities.languages och de tio språk som stöds i användargränssnittet. Om ingen matchning hittas används engelska som språk.

Dessa JavaScript-exempel använder AIR HTML-lokaliseringsramverket, som ingår i AIR SDK. Det sorterar språken mot listan med språk, och anger sedan engelska som standardreservspråk:

 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;

Implementering
public function get localeChain():Array
public function set localeChain(value:Array):void

Relaterade API-element

addResources()

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 efter att uppdaterarobjektet har skickat 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

Relaterade API-element

configurationFile

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

isFirstRun

Konstruktordetaljer

()

Konstruktor

public function ApplicationUpdaterUI()

Språkversion:

ActionScript 3.0

Körningsmiljöversioner:

AIR 1.5

Konstruktorfunktionen.

Metoddetaljer

addResources

()

metod

public function addResources(lang:String, res:Object):void

Språkversion:

ActionScript 3.0

Körningsmiljöversioner:

AIR 1.5

Lägger dynamiskt till ett nytt resurspaket för det angivna språket. JavaScript-utvecklare använder den här metoden för att dynamiskt lägga till ett nytt språk för dialogrutorna som visas i programuppdaterarens användargränssnitt. (Flex-utvecklare kan lägga till ett nytt språk direkt i resurspaketet ”ApplicationUpdaterDialogs”.)

Parametrar

lang:String — Språkkoden (till exempel "ro" för rumänska).

res:Object — Objektet innehåller nycklar och värden för översättning. Nycklarna kommer från språkegenskapsfilen. I tabellen nedan beskrivs möjliga nycklar (egenskapsnamn).

Nyckel	Svenskt värde	Dialogruta	Beskrivning
`appWidth`	530	Alla	Bredd på dialogrutan.
`titleWindow`	Uppdaterar:	Alla	Visas i den inbyggda fönsternamnlisten före programnamnet.
`titleCheck`	Kontrollera om det finns uppdateringar	Kontrollera om det finns uppdateringar	Dialogrutans namn.
`msgCheck`	Ska programmet kunna söka efter uppdateringar?	Kontrollera om det finns uppdateringar	Dialogrutans meddelande.
`btnCheck`	Kontrollera om det finns uppdateringar	Kontrollera om det finns uppdateringar	Knappetiketten Kontrollera om det finns uppdateringar.
`btnCancel`	Avbryt	Alla dialogrutor med en Avbryt-knapp	Knappetiketten Avbryt.
`titleCheckNoUpdates`	Inga uppdateringar finns	Kontrollera om det finns uppdateringar – Inga uppdateringar finns	Dialogrutans namn.
`msgCheckNoUpdates`	Det finns inga uppdateringar för programmet.	Kontrollera om det finns uppdateringar – Inga uppdateringar finns	Dialogrutans meddelande.
`btnClose`	Stäng	Alla dialogrutor med knappen Stäng	Knappetiketten Stäng.
`titleCheckError`	Uppdateringsfel	Kontrollera om det finns uppdateringar – Anslutningsfel	Dialogrutans namn.
`msgCheckError`	Ett fel inträffade vid kontroll av uppdateringar. Error# {0}	Kontrollera om det finns uppdateringar – Anslutningsfel	Dialogrutans meddelande. {0} ersätts med fel-ID.
`titleUpdate`	Uppdatering finns	Uppdatering finns	Dialogrutans namn.
`msgUpdate`	Det finns en uppdaterad version av programmet att hämta.	Uppdatering finns	Dialogrutans meddelande.
`lblApplication`	Program:	Uppdatering finns	Etikett som visas före programnamnet.
`lblInstalledVersion`	Installerad version:	Uppdatering finns	Etikett som visas före den installerade versionen.
`lblAvailableVersion`	Uppdateringsversion:	Uppdatering finns	Etikett som visas före uppdateringsversionen.
`btnDownload`	Hämta nu	Uppdatering finns	Knappetiketten Hämta nu.
`btnDownloadLater`	Hämta senare	Uppdatering finns	Knappetiketten Hämta senare.
`lnkReleaseNotes`	Versionsinformation	Länken Alla med versionsinformation	Länknamnet ”Versionsinformation”.
`titleProgress`	Hämtningsförlopp...	Hämtningsförlopp	Dialogrutans namn.
`msgProgress`	Hämta uppdatering	Hämtningsförlopp	Dialogrutans meddelande.
`titleDownloadError`	Hämtningen misslyckades	Hämtningsfel	Dialogrutans namn.
`msgDownloadError`	Ett fel uppstod vid hämtning av data. Error# {0}	Hämtningsfel	Dialogrutans meddelande. {0} ersätts med fel-ID.
`titleInstall`	Installera uppdatering	Installera uppdatering	Dialogrutans namn.
`msgInstall`	Uppdateringen för programmet har hämtats och kan installeras.	Installera uppdatering	Dialogrutans meddelande.
`btnInstall`	Installera nu	Installera uppdatering	Knappetiketten ”Installera”
`btnInstallLater`	Skjut upp till omstart	Installera uppdatering	Knappetiketten ”Skjut upp till omstart”
`titleFileUpdate`	Uppdatering finns	Arkiv - Uppdatering finns	Dialogrutans namn.
`msgFileUpdate`	Filen innehåller en uppdaterad version av programmet. Installera?	Arkiv - Uppdatering finns	Dialogrutans meddelande.
`lblFile`	File:	Arkiv - Uppdatering finns	Etikett som visas före filnamnet.
`titleFileNoUpdate`	Det finns ingen uppdatering	Arkiv - Inga uppdateringar finns	Dialogrutans namn.
`msgFileNoUpdate`	Filen innehåller inte en nyare version av programmet.	Arkiv - Inga uppdateringar finns	Dialogrutans meddelande.
`titleFileError`	Filfel	Fil - Fel	Dialogrutans namn.
`msgFileError`	Det gick inte att validera uppdateringsfilen. Error# {0}	Fil - Fel	Dialogrutans meddelande. {0} ersätts med fel-ID.
`titleUnexpectedError`	Oväntat fel	Oväntat fel	Dialogrutans namn.
`msgUnexpectedError`	Ett oväntat fel inträffade. Error# {0}	Oväntat fel	Dialogrutans meddelande. {0} ersätts med fel-ID.

Relaterade API-element

localeChain

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

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.

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

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

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:

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

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:

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

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.

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:

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

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

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:

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

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:

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

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:

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

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.

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

isFirstRun (Boolean) true om det här är den första körningen efter en genomförd uppdatering, annars false.
previousVersion (String) Den tidigare versionen av programmet före uppgraderingen (ställs endast om isfirstRun är true).
currentVersion (String) Versionen från programbeskrivningsfilen för den version som är installerad.

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:

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

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:

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

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.

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:

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.

Juridiska meddelanden | Onlinesekretesspolicy

ApplicationUpdaterUI - AS3

Klasser x

configurationFile

currentVersion

delay

isCheckForUpdateVisible

isDownloadProgressVisible

isDownloadUpdateVisible

isFileUpdateVisible

isFirstRun

isInstallUpdateVisible

isNewerVersionFunction

isUnexpectedErrorVisible

isUpdateInProgress

localeChain

previousApplicationStorageDirectory

previousVersion

updateDescriptor

updateURL

wasPendingUpdate