ApplicationUpdaterUI  - AS3

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.

Relaterade API-element

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.

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.

Relaterade API-element

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.

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.

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.

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.

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.

Relaterade API-element

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.

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.

appUpdate.isNewerVersionFunction = customFn; 

function customFn (currentVersion:String, updateVersion:String):Boolean 
{
    return updateVersion > currentVersion;
}

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.

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

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;

Relaterade API-element

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.

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.

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.

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.

Relaterade API-element

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

Relaterade API-element

Konstruktorfunktionen.

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

Relaterade API-element

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

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:

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.

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

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

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

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.

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

Skickas när hämtningen av uppdateringsfilen är slutförd.

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

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

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.

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.

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

Skickas när ett fel inträffar antingen under initiering eller under uppdateringsprocessen (om något oväntat inträffar).

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

Skickas när ett fel uppstår under validering av den fil som skickas som airFile-parameter i ett anrop till metoden installFromAIRFile().

Skickas efter att uppdateraren validerat filen i anropet till metoden installFromAIRFile().

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

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.

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

Skickas när uppdateringsfilen hämtas.

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

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.

Skickas efter att uppdateraren slutfört hämtning och tolkning av uppdateringsbeskrivningsfilen.

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