Het updateframework initialiseren

Nadat u de configuratie-eigenschappen hebt ingesteld (zie Eenvoudig voorbeelden: De ApplicationUpdaterUI-versie gebruiken ), roept u de methode initialize() aan om de update te initialiseren:

appUpdater.initialize();

Deze methode doet het volgende:

  • De methode initialiseert het updateframework, waarbij eventuele updates in behandeling synchroon zonder toezicht worden geïnstalleerd. Het is verplicht deze methode aan te roepen tijdens het opstarten van de toepassing, omdat de toepassing tijdens het aanroepen mogelijk opnieuw wordt opgestart.

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

  • Als er tijdens het updateproces een fout optreedt, worden het updatebestand en de versie-informatie gewist uit het opslaggebied van de toepassing.

  • Als de opgegeven vertragingsperiode (delay) is verlopen, wordt het updateproces gestart. Als dat niet het geval is, wordt de timer opnieuw gestart.

Het aanroepen van deze methode kan als resultaat hebben dat het updater-object de volgende gebeurtenissen verzendt:

  • UpdateEvent.INITIALIZED —Wordt verzonden wanneer de initialisatie is voltooid.

  • ErrorEvent.ERROR —Wordt verzonden wanneer er tijdens de initialisatie een fout optreedt.

Na het verzenden van de gebeurtenis UpdateEvent.INITIALIZED is het updateproces voltooid.

Wanneer u de methode initialize() aanroept, start de updater het updateproces en worden alle stappen voltooid op basis van de ingestelde waarde voor delay. U kunt het updateproces echter altijd opstarten door de methode checkNow() van het updater-object aan te roepen:

appUpdater.checkNow();

Deze methode doet niets als het updateproces al actief is. Zo niet, dan wordt het updateproces gestart.

Het updater-object kan als resultaat van het aanroepen van de methode checkNow() de volgende gebeurtenis verzenden:

  • gebeurtenis UpdateEvent.CHECK_FOR_UPDATE vlak voordat de poging het update-descriptorbestand te downloaden, wordt uitgevoerd.

Als u de gebeurtenis checkForUpdate annuleert, kunt u de methode checkForUpdate() van het updater-object aanroepen. (Zie de volgende sectie.) Als u de gebeurtenis niet annuleert, controleert het updateproces op het update-descriptorbestand.