ApplicationUpdaterUI  - AS3

De locatie van het configuratiebestand waarin de waarden zijn ingesteld voor de eigenschappen delay en updateURL. Er zijn ook instellingen om te bepalen of de toepassing verschillende bevestigingsvensters weergeeft tijdens het updateproces. Als deze eigenschap naar een niet-bestaand bestand verwijst, treedt er een fout op als de methode initialize() wordt aangeroepen.

Hier volgt een voorbeeld van een configuratiebestand:

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

In plaats van een configuratiebestand te laden, kunt u ActionScript-code gebruiken om de volgende eigenschappen van het object ApplicationUpdaterUI in te stellen: de eigenschappen delay, isCheckForUpdateVisible, isDownloadProgressVisible, isDownloadUpdateVisible, isFileUpdateVisible, isInstallUpdateVisible en updateURL.

Verwante API-elementen

De huidige versie van de toepassing. Deze eigenschap wordt ingesteld tijdens het aanroepen van de methode initialize(). De eigenschap wordt ingesteld op de versie uit het toepassingsbeschrijvingsbestand.

Het interval, in dagen, tussen periodieke controles op nieuwe updates.

De waarde 0 (de standaardwaarde) geeft aan dat de timer niet actief is, zodat er geen periodieke controles worden uitgevoerd. De vertraging kan worden ingesteld via deze eigenschap of via het configuratiebestand. Wanneer de waarde is ingesteld met beide methoden, wordt de waarde gebruikt die met deze eigenschap is ingesteld.

De standaardwaarde is 0.

Verwante API-elementen

Hiermee wordt de zichtbaarheid van de dialoogvensters Controleren op updates, Geen update en Updatefout ingeschakeld. Als de waarde true is, worden deze dialoogvensters weergegeven tijdens het updateproces. Dit kan ook worden ingesteld in het configuratiebestand van de update. De waarde die met deze eigenschap is ingesteld, overschrijft de instelling in het configuratiebestand van de update.

Hiermee wordt de zichtbaarheid van het dialoogvenster Update downloaden ingeschakeld. Als de waarde true is, wordt dit dialoogvenster weergegeven tijdens het updateproces. Dit kan ook worden ingesteld in het configuratiebestand van de update. De waarde die met deze eigenschap is ingesteld, overschrijft de instelling in het configuratiebestand van de update.

Hiermee wordt de zichtbaarheid van het dialoogvenster Update downloaden ingeschakeld. Als de waarde true is, worden deze dialoogvensters weergegeven tijdens het updateproces. Dit kan ook worden ingesteld in het configuratiebestand van de update. De waarde die met deze eigenschap is ingesteld, overschrijft de instelling in het configuratiebestand van de update.

Hiermee wordt de zichtbaarheid van de dialoogvensters Bestandsupdate, Geen bestandsupdate en Bestandsfout ingeschakeld. Als de waarde true is, worden deze dialoogvensters weergegeven tijdens het updateproces. Dit kan ook worden ingesteld in het configuratiebestand van de update. De waarde die met deze eigenschap is ingesteld, overschrijft de instelling in het configuratiebestand van de update.

Geeft aan of dit de eerste uitvoering is na een geslaagde update (true) of niet (false). Deze waarde wordt ingesteld na het aanroepen van de methode initialize(). De ontwikkelaar moet controleren of isFirstRun op true is ingesteld als er gegevens moeten worden gemigreerd van de ene versie naar een andere.

Verwante API-elementen

Hiermee wordt de zichtbaarheid van het dialoogvenster Update installeren ingeschakeld. Als de waarde true is, wordt dit dialoogvenster weergegeven tijdens het updateproces. Dit kan ook worden ingesteld in het configuratiebestand van de update. De waarde die met deze eigenschap is ingesteld, overschrijft de instelling in het configuratiebestand van de update.

Een functie die de updater moet gebruiken om versies te vergelijken. Standaard worden versies vergeleken om te bepalen of de versie van de externe site nieuwer is dan de versie van de geïnstalleerde toepassing. Soms komt de standaardvergelijkingsfunctie echter niet overeen met het versieschema van de ontwikkelaar. Stel deze eigenschap in om een nieuwe vergelijkingsfunctie op te geven.

De standaardvergelijkingsfunctie accepteert versies zoals x.y.z, waarbij x, y en z letters en cijfers kunnen bevatten. Er zijn enkele speciale voorwaarden die de standaardvergelijkingsfunctie herkent. Als de testfunctie "alpha", "beta" of "rc" aantreft in de versietekenreeksen, is de volgorde: alpha < beta < rc.

appUpdate.isNewerVersionFunction = customFn; 

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

Hiermee wordt de zichtbaarheid van het dialoogvenster Onverwachte fout ingeschakeld. Als de waarde true is, wordt dit dialoogvenster weergegeven tijdens het updateproces. Dit kan ook worden ingesteld in het configuratiebestand van de update. De waarde die met deze eigenschap is ingesteld, overschrijft de instelling in het configuratiebestand van de update.

Een Booleaanse eigenschap die de waarde true heeft als er een update wordt uitgevoerd en anders de waarde false heeft.

Een array waarin de taalvolgorde is gedefinieerd die wordt gebruikt in de gebruikersinterface. Gewoonlijk gebruiken alleen JavaScript-ontwikkelaars (HTML-ontwikkelaars) deze eigenschap.

Flex-ontwikkelaars kunnen de taalvolgorde beheren met de ResourceManager.

Standaard worden in een HTML-toepassing de talen gesorteerd op basis van de talen in de array Capabilities.languages en de tien talen die worden onderstenud in de gebruikersinterface. Als er geen overeenkomst wordt gevonden, wordt de Engelse taal gebruikt in de gebruikersinterface.

In dit JavaScript-voorbeeld wordt het HTML-localisatieframework van AIR gebruikt, inclusief de SDK van AIR. De talen worden gesorteerd volgens de lijst met talen en vervolgens wordt Engels ingesteld als de standaardreservetaal:

 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;

Verwante API-elementen

De vorige locatie van de opslagmap van de toepassing, als deze na een update is gewijzigd. De locatie van de opslagmap van de toepassing wordt gewijzigd na een upgrade met een certificaatmigratie. Als er geen certificaatmigratie plaatsvindt, verandert de opslagmap van de toepassing niet wanneer de gebruiker de toepassing bijwerkt. en deze eigenschap wordt ingesteld op null. Deze eigenschap wordt ingesteld tijdens het aanroepen van de methode initialize().

Een nieuwe versie van een AIR-toepassing kan met een nieuw certificaat worden ondertekend als de ontwikkelaar de optie -migrate gebruikt wanneer het AIR-pakket wordt gemaakt met ADT. Als een nieuwe versie van een AIR-toepassing een nieuw handtekeningcertificaat gebruikt, verandert de lokale opslagmap van de toepassing wanneer de gebruiker de nieuwe versie installeert. Gebruik deze eigenschap om gegevens vanuit de oude opslagmap van de toepassing over te brengen naar de nieuwe opslagmap (File.applicationStorageDirectory). Raadpleeg 'Een AIR-bestand ondertekenen om het toepassingscertificaat te wijzigen' in het hoofdstuk 'AIR-toepassingen maken met de opdrachtregelprogramma's' van de handleiding voor ontwikkelaars van Adobe AIR voor meer informatie.

De vorige versie van de toepassing. Deze eigenschap wordt ingesteld tijdens het aanroepen van de methode initialize(). Retourneert de vorige versie van de toepassing vóór de upgrade (wordt alleen ingesteld als isfirstRun true is); anders is de waarde null.

De inhoud van het updatebeschrijvingsbestand dat is gedownload uit de update-URL. Deze eigenschap is alleen niet null nadat het updaterobject een gebeurtenis updateStatus heeft verzonden.

De locatie van het updatebeschrijvingsbestand. Elke locatie die geldig is voor een URLRequest-pad, wordt geaccepteerd. Dit is de enige verplichte instelling voor de updater. U kunt de URL van de update instellen via deze eigenschap of via het configuratiebestand. Waneer de waarde met beide methoden is ingesteld, gebruikt de updater de waarde die met deze eigenschap is ingesteld.

Verwante API-elementen

Geeft aan of er een uitgestelde update was, ook als de installatie daarvan is mislukt (true); anders is de waarde false. Deze eigenschap wordt ingesteld tijdens het aanroepen van de methode initialize(). Gebruik de eigenschappen wasPendingUpdate en isFirstRun om te controleren of de installatie van een update is mislukt (in dat geval is wasPendingUpdate ingesteld op true en is isFirstRun ingesteld op false).

Verwante API-elementen

De constructorfunctie.

Er wordt dynamisch een nieuwe bronnenbundel toegevoegd voor de opgegeven taal. JavaScript-ontwikkelaars gebruiken deze methode om dynamisch een nieuwe taal toe te voegen voor de dialoogvensters die in de gebruikersinterface van de updater worden weergegeven. (Flex-ontwikkelaars kunnen een nieuwe taal rechtstreeks toevoegen aan de bronnenbundel ApplicationUpdaterDialogs.)

Parameters

Verwante API-elementen

Hiermee wordt het updateproces geannuleerd. Als deze methode wordt aangeroepen, worden alle downloads die in behandeling zijn, geannuleerd, worden alle onvolledig gedownloade bestanden verwijderd en wordt de periodieke controletimer opnieuw gestart.

Het updateproces kan op elk moment worden geannuleerd, behalve wanneer de status "uninitialized" of "initializing" is. Er gebeurt niets wanneer de methode wordt aangeroepen als de status "uninitialized" of "initializing" is.

Het updateproces starten. Als deze methode wordt aangeroepen, wordt de periodieke timer niet gestopt. Er wordt echter ontdekt dat er een updateproces wordt uitgevoerd en de huidige iteratie wordt overgeslagen.

Deze methode wordt alleen uitgevoerd als de huidige status "Ready" is.

Deze methode kan ertoe leiden dat het updaterobject de volgende gebeurtenis verzendt:

Hiermee wordt de updater geïnitialiseerd. Als u deze methode aanroept, gebeurt het volgende:

1. Het updateframework wordt geïnitialiseerd en alle updates die in behandeling zijn, worden stil (en synchroon) geïnstalleerd. U moet deze methode tijdens het starten van de toepassing aanroepen, omdat de toepassing mogelijk opnieuw moet worden opgestart.

2. Als er een uitgestelde update aanwezig is, wordt deze geïnstalleerd.

3. Als er iets verkeerd is gegaan tijdens een vorige update, worden het updatebestand en de versiegegevens in het opslaggebied gewist.

4. Als de tijd van de periodieke timer is verstreken, wordt het updateproces gestart; anders wordt de periodieke timer gestart. Wanneer u echter een toepassing test met de toepassing AIR Debug Launcher (ADL), wordt de uitzondering IllegalOperationError gegenereerd als u probeert de toepassing bij te werken.

Hiermee wordt het updateproces gestart met een lokaal AIR-bestand.

Het aanroepen van deze methode heeft geen effect als er een updateproces wordt uitgevoerd (als de status niet "Downloaded" is).

Deze functie is nuttig voor een toepassing waarbij het element customUpdateUI is ingesteld op true in het toepassingsbeschrijvingsbestand.

Wanneer u een toepassing test met de toepassing AIR Debug Launcher (ADL), leidt het aanroepen van deze methode tot de uitzondering IllegalOperationError.

Parameters

Wordt verzonden vlak voordat de update wordt geïnstalleerd, nadat de methode installUpdate() is aangeroepen. Het is soms beter om de installatie van de update op dit moment te verhinderen, omdat de gebruiker al het huidige werk zou kunnen kwijtraken wanneer de runtime de toepassing afsluit om de update te installeren.

Door de methode preventDefault() van deze gebeurtenis aan te roepen, wordt de installatie uitgesteld totdat de toepassing opnieuw wordt gestart. Als u de methode preventDefault() aanroept, kan er geen ander updateproces worden gestart tijdens deze toepassingssessie (via het aanroepen van de methode installUpdate() of wegens de periodieke controle).

Deze gebeurtenis heeft de volgende eigenschappen:

Wordt verzonden voordat het updateproces begint, vlak voordat de updater het updatebeschrijvingsbestand probeert te downloaden. De updater kan deze gebeurtenis verzenden nadat de methode checkNow() rechtstreeks is aanroepen of omdat de timer voor periodieke controle is verlopen.

Deze gebeurtenis heeft de volgende eigenschappen:

Wordt verzonden wanneer het downloaden van updatebestand is voltooid.

Deze gebeurtenis heeft de volgende eigenschappen:

Wordt verzonden als er een fout optreedt wanneer verbinding wordt gemaakt met het updatebestand of wanneer het wordt gedownload. Wordt ook verzonden voor een ongeldige HTTP-status (zoals 404 - Bestand niet gevonden).

Wanneer deze gebeurtenis wordt verzonden, wordt de periodieke timer automatisch opnieuw gestart (als de vertraging groter is dan 0).

De eigenschap errorID van een object DownloadErrorEvent is een geheel getal waarmee informatie over de fout wordt gedefinieerd (zie de volgende tabel). Een extra eigenschap subErrorID kan meer informatie over de fout bevatten.

Wordt verzonden nadat de methode downloadUpdate() is aangeroepen en de verbinding met de server tot stand is gebracht. Wanneer u de ApplicationUpdater-bibliotheek gebruikt, kunt u met de gebeurtenishandler voor deze gebeurtenis een voortgangsbalk weergeven om de voortgang van het downloaden aan de gebruiker te tonen.

Deze gebeurtenis heeft de volgende eigenschappen:

Wordt verzonden wanneer er een fout is opgetreden tijden de initialisatie of tijdens het updateproces (als er iets onverwachts is gebeurd).

Deze gebeurtenis heeft de volgende eigenschappen:

Wordt verzonden wanneer er een fout optreedt tijdens het valideren van het bestand dat is doorgegeven met de parameter airFile in een aanroep van de methode installFromAIRFile().

Wordt verzonden nadat het bestand in de aanroep van de methode installFromAIRFile() met succes is gevalideerd.

Deze gebeurtenis heeft de volgende eigenschappen:

Wordt verzonden nadat de initialisatie is voltooid.

Deze gebeurtenis heeft de volgende alleen-lezen-eigenschappen:

• isFirstRun (Booleaanse waarde) true als dit de eerste uitvoering na een geslaagde update is; anders is de waarde false.

• previousVersion (tekenreeks) De vorige versie van de toepassing vóór de upgrade (wordt alleen ingesteld als isfirstRun true is).

• currentVersion (tekenreeks) De versie van het toepassingsbeschrijvingsbestand van de momenteel geïnstalleerde versie.

Deze gebeurtenis heeft de volgende eigenschappen:

Verzonden tijdens het downloaden van het updatebestand.

Deze gebeurtenis heeft de volgende eigenschappen:

Wordt verzonden als er een fout optreedt wanneer wordt geprobeerd het updatebeschrijvingsbestand te downloaden of te parseren.

Wanneer deze gebeurtenis door de updater wordt verzonden, wordt de periodieke timer automatisch opnieuw gestart (als de vertraging groter is dan 0). De toepassing zou dialoogvensters met foutmeldingen kunnen verbergen wanneer de updater een nieuwe gebeurtenis checkForUpdate verzendt.

Wordt verzonden nadat het updatebeschrijvingsbestand met succes is gedownload en geïnterpreteerd.

Deze gebeurtenis heeft de volgende eigenschappen: