ApplicationUpdater  - AS3

Der Speicherort der Konfigurationsdatei, die die Werte für die delay- und updateURL-Eigenschaften festlegt. Wenn diese Eigenschaft auf eine nicht vorhandene Datei verweist, führt der Aufruf der initialize()-Methode dazu, dass ein Fehler ausgegeben wird.

Ein Beispiel einer Konfigurationsdatei:

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

Anstatt eine Konfigurationsdatei zu laden, können Sie den ActionScript --Code verwenden, um die delay- und updateURL-Eigenschaften festzulegen.

Verwandte API-Elemente

Der interne Status des Updaters. Diese Eigenschaft kann auf einen der folgenden Werte eingestellt sein:

• "UNINITIALIZED": Der Updater wurde nicht initialisiert.

• "INITIALIZING": Der Updater wird initialisiert.

• "READY": Der Updater wurde initialisiert.

• "BEFORE_CHECKING": Der Updater hat noch nicht nach der Updatedeskriptordatei gesucht.

• "CHECKING": Der Updater sucht nach einer Updatedeskriptordatei.

• "AVAILABLE": Die Updatedeskriptordatei ist verfügbar.

• "DOWNLOADING": Der Updater lädt die AIR-Datei herunter.

• "DOWNLOADED": Der Updater hat die AIR-Datei heruntergeladen.

• "INSTALLING": Der Updater installiert die AIR-Datei.

• "PENDING_INSTALLING": Der Updater wurde initialisiert und Aktualisierungen stehen aus.

Die aktuelle Version der Anwendung. Diese Eigenschaft wird bei einem Aufruf der initialize()-Methode festgelegt. Sie wird als die Version der Anwendungsdeskriptordatei festgelegt.

Das Intervall in Tagen zwischen regelmäßigen Suchen nach neuen Updates.

Der Wert 0 (der Standardwert) zeigt an, dass der Timer nicht aktiv ist, sodass keine regelmäßige Suche ausgeführt wird. Sie können den Wert über diese Eigenschaft oder über die Konfigurationsdatei festlegen. Wenn der Wert mithilfe beider Methoden festgelegt ist, wird der durch diese Eigenschaft festgelegte Wert verwendet.

Der Standardwert ist 0.

Gibt an, ob dies die erste Ausführung nach einer erfolgreichen Aktualisierung (true) ist oder nicht (false). Der Updater legt diesen Wert während des Aufrufs der initialize()-Methode fest. Der Entwickler sollte überprüfen, ob isFirstRun als true festgelegt ist, wenn Daten von einer Version auf die andere migriert werden sollen.

Verwandte API-Elemente

Eine Funktion, die der Updater verwenden sollte, um Versionsvergleiche auszuführen. Standardmäßig führt das Updateframework einen Versionsvergleich durch, um zu erkennen, ob die Version der Remote Site neuer als die Version der installierten Anwendung ist. Manchmal stimmt der Standardvergleich jedoch nicht mit dem Versionsschema des Entwicklers überein. Legen Sie diese Eigenschaft fest, um eine neue Funktion bereitzustellen, die den Vergleich ausführt.

Die Standardvergleichsfunktion akzeptiert Versionen wie x.y.z, wobei x, y, z Buchstaben und Ziffern enthalten können. Es gibt einige spezielle Bedingungen, die die Standardvergleichsfunktion erkennt. Wenn die Testfunktion in den Versionsstrings "alpha", "beta" oder "rc" findet, ist die Reihenfolge alpha < beta < rc.

appUpdate.isNewerVersionFunction = customFn; 

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

Der vorherige Speicherort des Anwendungsspeicherordners, falls er nach einer Aktualisierung geändert wurde. Der Speicherort des Anwendungsspeicherordners wird nach einer Aktualisierung mit einer Zertifikatmigration geändert. Findet keine Zertifikatmigration statt, wird der Anwendungsspeicherordner nicht geändert, wenn der Benutzer die Anwendung aktualisiert und diese Eigenschaft ist als null festgelegt. Diese Eigenschaft wird bei einem Aufruf der initialize()-Methode festgelegt.

Entwickler können die neue Version der AIR-Anwendung mit einem neuen Zertifikat unterzeichnen, wenn sie beim Komprimieren der AIR-Datei mit ADT die -migrate-Option verwenden. Wenn eine neue Version einer AIR-Anwendung ein neues Signaturzertifikat verwendet, wird der lokale Speicherordner der Anwendung geändert, sobald der Benutzer die neue Version installiert. Verwenden Sie diese Eigenschaft, um Daten vom alten Anwendungsspeicherordner in den neuen Anwendungsspeicherordner zu übertragen (File.applicationStorageDirectory). Weitere Informationen finden Sie unter „Unterzeichnen von AIR-Dateien, um das Anwendungszertifikat zu wechseln“ im Kapitel „Erstellen von AIR-Anwendungen mit Befehlszeilenwerkzeugen“ des Adobe AIR-Entwicklerhandbuchs.

Die vorherige Version der Anwendung. Diese Eigenschaft wird bei einem Aufruf der initialize()-Methode festgelegt. Gibt die vorherige Version der Anwendung vor dem Upgrade zurück (nur festgelegt, wenn isfirstRun true ist); andernfalls als null festgelegt.

Der Inhalt der Updatedeskriptordatei, der von der Aktualisierungs-URL heruntergeladen wurde. Diese Eigenschaft ist nicht „null“, nur das Updaterobjekt löst ein updateStatus-Ereignis aus.

Der Speicherort der Updatedeskriptordatei. Jeder für einen URLRequest-Pfad gültige Speicherort wird akzeptiert. Dies ist die einzige obligatorische Einstellung, die der Updater erfordert. Sie können die Aktualisierungs-URL über diese Eigenschaft oder über die Konfigurationsdatei festlegen. Wenn der Wert mithilfe beider Methoden festgelegt ist, verwendet der Updater den durch diese Eigenschaft festgelegten Wert.

Gibt an, ob es sich um eine verschobene Aktualisierung handelt, auch wenn sie nicht installiert werden konnte (true); andernfalls false. Der Updater legt diese Eigenschaft während eines Aufrufs der initialize()-Methode fest. Verwenden Sie die wasPendingUpdate- und isFirstRun-Eigenschaften, um zu überprüfen, ob die Installation eines Updates fehlgeschlagen ist (in diesem Fall wird wasPendingUpdate als true und isFirstRun als false festgelegt).

Verwandte API-Elemente

Die Konstruktorfunktion.

Bricht den Aktualisierungsvorgang ab. Das Aufrufen dieser Methode bricht alle ausstehenden Downloads ab, löscht unvollständig heruntergeladene Dateien und startet den Timer für die regelmäßige Suche neu.

Der Aktualisierungsvorgang kann jederzeit abgebrochen werden, außer wenn sich der Zustandsautomat im Status „UNINITIALIZED“ oder „INITIALIZING“ befindet. Dies hat keine Auswirkung, wenn die Methode in einem der Status „UNINITIALIZED“ oder „INITIALIZING“ aufgerufen wird.

Lädt die Updatedeskriptordatei asynchron herunter und interpretiert sie. Durch Aufrufen dieser Methode springt der Updaterstatus auf „CHECKING“. Rufen Sie diese Methode nur auf, wenn das checkForUpdate-Ereignis abgebrochen wurde.

Diese Methode wird nur ausgeführt, wenn der Updater sich im Status „BEFORE_CHECKING“ befindet.

Startet den Aktualisierungsvorgang. Das Aufrufen dieser Methode stoppt nicht den Timer für die regelmäßige Suche; die Methode erkennt jedoch, dass ein Aktualisierungsvorgang ausgeführt wird und überspringt die aktuelle Iteration.

Diese Methode wird nur ausgeführt, wenn der aktuelle Status „READY“ ist.

Diese Methode kann dazu führen, dass das Updaterobjekt das folgende Ereignis auslöst:

Lädt die Updatedatei asynchron herunter. Durch Aufrufen dieser Methode springt der Zustandsautomat auf „DOWNLOADING“. Diese Methode muss nur aufgerufen werden, wenn das StatusUpdateEvent.UPDATE_STATUS-Ereignis abgebrochen wurde, während die available-Eigenschaft des Ereignisses als „true“ festgelegt war.

Diese Methode wird nur ausgeführt, wenn der aktuelle Status „AVAILABLE“ ist.

Initialisiert den Updater. Das Aufrufen dieser Methode bewirkt Folgendes:

1. Sie initialisiert das Updateframework, wobei ohne weitere Meldung (und synchron) die ggf. ausstehenden Aktualisierungen installiert werden. Sie sollten diese Methode beim Anwendungsstart aufrufen, da dadurch die Anwendung möglicherweise neu gestartet wird.

2. Sie sucht nach einer verschobenen Aktualisierung und installiert sie ggf.

3. Wenn eine vorherige Aktualisierung fehlgeschlagen ist, werden die Updatedatei und die Versionsinformationen aus dem Speicherbereich gelöscht.

4. Wenn die Timer-Verzögerung abgelaufen ist, wird der Aktualisierungsvorgang gestartet; andernfalls wird der Timer gestartet. Wenn Sie jedoch eine Anwendung mit dem AIR Debug Launcher (ADL) testen, führt ein Versuch der Aktualisierung der Anwendung zu einer IllegalOperationError-Ausnahme.

Startet den Aktualisierungsvorgang mithilfe einer lokalen AIR-Datei.

Das Aufrufen dieser Methode hat keine Auswirkung, wenn ein Aktualisierungsvorgang ausgeführt wird (wenn der Status nicht "DOWNLOADED" ist).

Diese Funktion ist für eine Anwendung nützlich, die das customUpdateUI-Element in der Anwendungsdeskriptordatei als true festgelegt hat.

Wenn Sie eine Anwendung mit dem AIR Debug Launcher (ADL) testen, führt der Aufruf dieser Methode zu einer IllegalOperationError-Ausnahme.

Parameter

Installiert die Updatedatei. Durch Aufrufen der Methode springt der Zustandsautomat auf „INSTALLING“ und muss nur aufgerufen werden, wenn das downLoadComplete-Ereignis abgebrochen wurde.

Rufen Sie diese Methode auf, wenn der Updater sich im Status „DOWNLOADED“ befindet. Das Aufrufen in einem anderen Status hat keine Auswirkung.

Wenn Sie eine Anwendung mit dem AIR Debug Launcher (ADL) testen, führt der Aufruf dieser Methode zu einer IllegalOperationError-Ausnahme.

Wird kurz vor der Installation des Updates ausgelöst, nachdem die installUpdate()-Methode aufgerufen wurde. Es kann sinnvoll sein, die Installation des Updates zu diesem Zeitpunkt zu verhindern, da der Benutzer die gesamte aktuelle Arbeit verlieren kann, wenn die Laufzeit die Anwendung beendet, um das Update zu installieren.

Das Aufrufen der preventDefault()-Methode dieses Ereignisses verschiebt die Installation bis zum nächsten Neustart. Wenn Sie die preventDefault()-Methode aufrufen, kann in dieser Anwendungssitzung kein zusätzlicher Aktualisierungsvorgang gestartet werden (über einen Aufruf der installUpdate()-Methode oder aufgrund der regelmäßigen Suche).

Das Standardverhalten der ApplicationUpdater-Bibliothek besteht darin, die Updatedeskriptordatei herunterzuladen. Sie können die preventDefault()-Methode aufrufen, um das Standardverhalten abzubrechen.

Dieses Ereignis verfügt über die folgenden Eigenschaften:

Wird vor dem Beginn des Aktualisierungsvorgangs ausgelöst, unmittelbar bevor der Updater versucht, die Updatedeskriptordatei herunterzuladen. Der Updater kann dieses Ereignis als ein Ergebnis des direkten Aufrufs der checkNow()-Methode auslösen oder weil der Timer für die regelmäßige Suche abgelaufen ist.

Dieses Ereignis verfügt über die folgenden Eigenschaften:

Wird ausgelöst, wenn das Herunterladen der Updatedatei abgeschlossen ist.

Normalerweise wird dieses Ereignis zur Anzeige einer Meldung verwendet, in der der Benutzer gefragt wird, ob er mit der Installation des Updates fortfahren möchte.

Das Standardverhalten für die ApplicationUpdater-Bibliothek besteht darin, automatisch die installUpdate()-Methode aufzurufen.

Dieses Ereignis verfügt über die folgenden Eigenschaften:

Wird ausgelöst, wenn ein Fehler bei der Verbindung oder dem Herunterladen der Updatedatei auftritt. Das Ereignis wird auch ausgelöst, wenn ein ungültiger HTTP-Status vorliegt (z. B. „404 – Datei nicht gefunden“).

Beim Auslösen dieses Ereignisses wird der Timer für die regelmäßige Suche automatisch neu gestartet (wenn die Verzögerung größer als 0 ist).

Die errorID-Eigenschaft eines DownloadErrorEvent-Objekts ist eine Ganzzahl, die Fehlerinformationen definiert (siehe folgende Tabelle). Eine zusätzliche subErrorID-Eigenschaft enthält möglicherweise mehr Fehlerinformationen.

Wird ausgelöst, nachdem ein Aufruf der downloadUpdate()-Methode ausgeführt und die Verbindung zum Server hergestellt wurde. Wenn Sie die ApplicationUpdater-Bibliothek verwenden, möchten Sie möglicherweise, dass die Ereignisprozedur für den Benutzer eine Downloadfortschrittsleiste anzeigt.

Dieses Ereignis verfügt über die folgenden Eigenschaften:

Wird ausgelöst, wenn ein Fehler bei der Initialisierung oder während des Aktualisierungsvorgangs (bei einem unerwarteten Ereignis) auftritt.

Dieses Ereignis verfügt über die folgenden Eigenschaften:

Wird ausgelöst, wenn ein Fehler bei der Überprüfung der als airFile-Parameter übergebenen Datei in einem Aufruf der installFromAIRFile()-Methode auftritt.

Wird ausgelöst, nachdem der Updater erfolgreich die Datei im Aufruf der installFromAIRFile()-Methode überprüft hat.

Dieses Ereignis verfügt über die folgenden Eigenschaften:

Wird ausgelöst, nachdem die Initialisierung abgeschlossen ist.

Dieses Ereignis verfügt über die folgenden Eigenschaften:

Wird abgesetzt, wenn die Updatedatei heruntergeladen wird.

Dieses Ereignis verfügt über die folgenden Eigenschaften:

Wird ausgelöst, wenn ein Fehler beim Versuch des Herunterladens oder Parsings der Updatedeskriptordatei auftritt.

Löst der Updater dieses Ereignis aus, wird der Timer für die regelmäßige Suche automatisch neu gestartet (wenn die Verzögerung größer als 0 ist). Die Anwendung sollte das Ausblenden von Fehlermeldungen berücksichtigen, wenn der Updater ein neues checkForUpdate-Ereignis auslöst.

Wird ausgelöst, nachdem der Updater die Updatedeskriptordatei erfolgreich heruntergeladen und interpretiert hat.

Das Standardverhalten besteht darin, das Update herunterzuladen, wenn die Verfügbarkeit der available-Eigenschaft des StatusUpdateEvent-Objekts als true festgelegt ist. Das Standardverhalten kann nur bei Verwendung der ApplicationUpdater-Klasse verhindert werden und nicht bei Verwendung der ApplicationUpdatorUI-Klasse.

Dieses Ereignis verfügt über die folgenden Eigenschaften: