air.updateApplicationUpdater Die ApplicationUpdater-Klasse definiert die grundlegende Funktionalität des Updateframeworks für Adobe® AIR®-Anwendungen, ohne eine Standardbenutzeroberfläche bereitzustellen.flash.events:EventDispatcher Die ApplicationUpdater-Klasse definiert die grundlegende Funktionalität des Updateframeworks für Adobe^® AIR^®-Anwendungen, ohne eine Standardbenutzeroberfläche bereitzustellen. (Die ApplicationUpdaterUI-Klasse enthält eine Aktualisierungsfunktionalität und eine Standardbenutzeroberfläche.)

Adobe^® Flex™ Builder™ lädt diese Klasse automatisch, wenn Sie ein Projekt für Adobe AIR erstellen. Sie sollten die SWC-Datei einbeziehen, wenn Sie die Anwendung mit dem Adobe^® Flex™ SDK kompilieren.

Die Verwaltung der Aktualisierungen von Anwendungen kann kompliziert sein. Das AIR-Updateframework stellt APIs bereit, mit denen Entwickler gute Aktualisierungsmöglichkeiten in AIR-Anwendungen einbinden können. Die Funktionalität im AIR-Updateframework unterstützt Entwickler bei Folgendem:

Regelmäßige Suche nach Updates in bestimmten Intervallen oder auf Anforderung des Benutzers
Herunterladen von AIR-Dateien (Updates) von einer Webquelle
Informieren des Benutzers beim ersten Ausführen der neu installierten Version
Bestätigen, dass der Benutzer nach Updates suchen möchte
Anzeigen von Informationen zur neuen Updateversion für den Benutzer
Anzeigen des Downloadfortschritts und von Fehlermeldungen für den Benutzer

Das AIR-Updateframework ermöglicht das Speichern von Informationen zur Updateversion einer AIR-Anwendung in einfachen XML-Konfigurationsdateien. Bei den meisten Anwendungen erzielen Sie mit dem Einrichten dieser Konfigurationsdateien und dem Einfügen einiger Basiscodezeilen eine gute Aktualisierungsfunktionalität für den Endbenutzer.

Verwenden Sie die AIRUpdater-Klasse, wenn Sie eine eigene Benutzeroberfläche für die Verwendung mit dem AIR-Updateframework verwenden möchten.

Der Aktualisierungsvorgang enthält eine Statussequenz. Die currentState-Eigenschaft des Updaterobjekts entspricht dem aktuellen Status des Updaters:

currentState-Wert Beschreibung „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.

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

Das AIR-Updateframework wird nur im Desktop-Profil unterstützt. Es wird weder für erweiterte Desktop-Anwendungen (Anwendungen, die mit einem nativen Installer installiert werden) noch im Mobil-Profil (iPhone-Anwendungen, die mit ActionScript 3.0 geschrieben werden) unterstützt. Überprüfen Sie zur Laufzeit die Updater.isSupported-Eigenschaft, um festzustellen, ob das Updateframework unterstützt wird.

Weitere Details zur Verwendung des AIR-Updateframeworks finden Sie im Kapitel „Aktualisieren von AIR-Anwendungen“ in Entwickeln von Adobe AIR 1.5-Anwendungen mit Adobe Flash.

error Wird ausgelöst, wenn ein Fehler bei der Initialisierung oder während des Aktualisierungsvorgangs (bei einem unerwarteten Ereignis) auftritt.flash.events.ErrorEvent.ERRORflash.events.ErrorEvent Wird ausgelöst, wenn ein Fehler bei der Initialisierung oder während des Aktualisierungsvorgangs (bei einem unerwarteten Ereignis) auftritt. progress Wird abgesetzt, wenn die Updatedatei heruntergeladen wird.flash.events.ProgressEvent.PROGRESSflash.events.ProgressEvent Wird abgesetzt, wenn die Updatedatei heruntergeladen wird. fileUpdateError Wird ausgelöst, wenn ein Fehler bei der Überprüfung der als airFile-Parameter übergebenen Datei in einem Aufruf der installFromAIRFile()-Methode auftritt.air.update.events.StatusFileUpdateErrorEvent.FILE_UPDATE_ERRORair.update.events.StatusFileUpdateErrorEvent Wird ausgelöst, wenn ein Fehler bei der Überprüfung der als airFile-Parameter übergebenen Datei in einem Aufruf der installFromAIRFile()-Methode auftritt. fileUpdateStatus Wird ausgelöst, nachdem der Updater erfolgreich die Datei im Aufruf der installFromAIRFile()-Methode überprüft hat.air.update.events.StatusFileUpdateEvent.FILE_UPDATE_STATUSair.update.events.StatusFileUpdateEvent Wird ausgelöst, nachdem der Updater erfolgreich die Datei im Aufruf der installFromAIRFile()-Methode überprüft hat. downloadError Wird ausgelöst, wenn ein Fehler bei der Verbindung oder dem Herunterladen der Updatedatei auftritt.air.update.events.DownloadErrorEvent.DOWNLOAD_ERRORair.update.events.DownloadErrorEvent 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).

updateError Wird ausgelöst, wenn ein Fehler beim Versuch des Herunterladens oder Parsings der Updatedeskriptordatei auftritt.air.update.events.StatusUpdateErrorEvent.UPDATE_ERRORair.update.events.StatusUpdateErrorEvent 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.

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.

beforeInstall Wird unmittelbar vor der Installation des Updates ausgelöst, nachdem die installUpdate()-Methode aufgerufen wurde.air.update.events.UpdateEvent.BEFORE_INSTALLair.update.events.UpdateEvent 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.

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.

downloadStart Wird ausgelöst, nachdem ein Aufruf der downloadUpdate()-Methode ausgeführt und die Verbindung zum Server hergestellt wurde.air.update.events.UpdateEvent.DOWNLOAD_STARTair.update.events.UpdateEvent 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. checkForUpdate Wird vor dem Beginn des Aktualisierungsvorgangs ausgelöst, unmittelbar bevor der Updater versucht, die Updatedeskriptordatei herunterzuladen.air.update.events.UpdateEvent.CHECK_FOR_UPDATEair.update.events.UpdateEvent 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. initialized Wird ausgelöst, nachdem die Initialisierung abgeschlossen ist.air.update.events.UpdateEvent.INITIALIZEDair.update.events.UpdateEvent Wird ausgelöst, nachdem die Initialisierung abgeschlossen ist. ApplicationUpdater Die Konstruktorfunktion. Die Konstruktorfunktion. cancelUpdate Bricht den Aktualisierungsvorgang ab. 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.

checkForUpdate Lädt die Updatedeskriptordatei asynchron herunter und interpretiert sie. 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.

updateStatusair.update.events:StatusUpdateEventDer Updater hat die Updatedeskriptordatei erfolgreich heruntergeladen und interpretiert. Der Updater hat die Updatedeskriptordatei erfolgreich heruntergeladen und interpretiert.updateErrorair.update.events:StatusUpdateErrorEventEin Fehler ist beim Versuch des Herunterladens oder Parsings der Updatedeskriptordatei aufgetreten. Ein Fehler ist beim Versuch des Herunterladens oder Parsings der Updatedeskriptordatei aufgetreten.checkNow Startet den Aktualisierungsvorgang. 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:

checkForUpdateair.update.events:UpdateEventWird unmittelbar vor Beginn des Aktualisierungsvorgangs ausgelöst. Wird unmittelbar vor Beginn des Aktualisierungsvorgangs ausgelöst.downloadUpdate Lädt die Updatedatei asynchron herunter. 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.

downloadStartair.update.events:UpdateEventWird ausgelöst, nachdem die Verbindung zum Server hergestellt wurde. Wird ausgelöst, nachdem die Verbindung zum Server hergestellt wurde.progressflash.events:ProgressEventWird ausgelöst, nachdem die Initialisierung abgeschlossen ist. Wird ausgelöst, nachdem die Initialisierung abgeschlossen ist.downloadErrorair.update.events:DownloadErrorEventWird 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“). Wird ausgelöst, wenn ein Fehler bei der Verbindung oder dem Herunterladen der Updatedatei auftritt.initialize Initialisiert den Updater. Initialisiert den Updater. Das Aufrufen dieser Methode bewirkt Folgendes:

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.
Sie sucht nach einer verschobenen Aktualisierung und installiert sie ggf.
Wenn eine vorherige Aktualisierung fehlgeschlagen ist, werden die Updatedatei und die Versionsinformationen aus dem Speicherbereich gelöscht.
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.

initializedair.update.events:UpdateEventDie Initialisierung ist abgeschlossen. Die Initialisierung ist abgeschlossen.errorflash.events:ErrorEventBei der Initialisierung tritt ein Fehler auf. Bei der Initialisierung tritt ein Fehler auf.installFromAIRFile Startet den Aktualisierungsvorgang mithilfe einer lokalen AIR-Datei.fileflash.filesystem:FileDie zu installierende AIR-Datei. 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.

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.

beforeInstallair.update.events:UpdateEventWird unmittelbar vor der Installation der Aktualisierung ausgelöst. 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. Wird unmittelbar vor der Installation der Aktualisierung ausgelöst.configurationFile Der Speicherort der Konfigurationsdatei, die die Werte für die delay- und updateURL-Eigenschaften festlegt.flash.filesystem:File 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.

currentState Der interne Status des Updaters.String 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.

currentVersion Die aktuelle Version der Anwendung.String Die aktuelle Version der Anwendung. Diese Eigenschaft wird bei einem Aufruf der initialize()-Methode festgelegt. Sie wird als die Version der Anwendungsdeskriptordatei festgelegt. delay Das Intervall in Tagen zwischen regelmäßigen Suchen nach neuen Updates.Number0 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.

isFirstRun Gibt an, ob dies die erste Ausführung nach einer erfolgreichen Aktualisierung („true“) ist oder nicht („false“).Boolean 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. isNewerVersionFunction Eine Funktion, die der Updater verwenden sollte, um Versionsvergleiche auszuführen.Function 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.

Der folgende Code definiert die benutzerdefinierte Funktion customFn für das appUpdate-Updaterobjekt. Die Beispielsfunktion ist absichtlich einfach gehalten. Ihre benutzerdefinierte Funktion sollte einen booleschen Wert zurückgeben, der auf den Regeln Ihres Versionsschemas basiert. appUpdate.isNewerVersionFunction = customFn; function customFn (currentVersion:String, updateVersion:String):Boolean { return updateVersion > currentVersion; } previousApplicationStorageDirectory Der vorherige Speicherort des Anwendungsspeicherordners, falls er nach einer Aktualisierung geändert wurde.flash.filesystem:File 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.

previousVersion Die vorherige Version der Anwendung.String 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. updateDescriptor Der Inhalt der Updatedeskriptordatei, der von der Aktualisierungs-URL heruntergeladen wurde.XML 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. updateURL Der Speicherort der Updatedeskriptordatei.String 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. wasPendingUpdate Gibt an, ob es sich um eine verschobene Aktualisierung handelt, auch wenn sie nicht installiert werden konnte („true“); andernfalls „false“.Boolean 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). ApplicationUpdaterUI Die ApplicationUpdater-Klasse definiert die grundlegende Funktionalität des Updateframeworks für Adobe® AIR®-Anwendungen und stellt eine Standardbenutzeroberfläche bereit.flash.events:EventDispatcher Die ApplicationUpdaterUI-Klasse definiert die grundlegende Funktionalität des Updateframeworks für Adobe^® AIR^®-Anwendungen und stellt eine Standardbenutzeroberfläche bereit. (Die ApplicationUpdater-Klasse enthält eine Aktualisierungsfunktionalität, ohne eine Standardbenutzeroberfläche zu implementieren.)

Diese Klasse ist in der Datei „applicationupdater_ui.swc“ enthalten, die Teil des Adobe AIR-SDK ist. Die Datei „applicationupdater_ui.swc“ befindet sich im Verzeichnis „frameworks/libs/air“ des AIR-SDK. Die Version im Verzeichnis „frameworks/libs/air“ im AIR 2 SDK ist für die Flex 4-Entwicklung bestimmt. Wenn Sie mit Flex 3 arbeiten, verwenden Sie die Version im Unterverzeichnis „frameworks/libs/air/flex3“.

Regelmäßige Suche nach Updates in bestimmten Intervallen oder auf Anforderung des Benutzers
Herunterladen von AIR-Dateien (Updates) von einer Webquelle
Informieren des Benutzers beim ersten Ausführen der neu installierten Version
Bestätigen, dass der Benutzer nach Updates suchen möchte
Anzeigen von Informationen zur neuen Updateversion für den Benutzer
Anzeigen des Downloadfortschritts und von Fehlermeldungen für den Benutzer

Die AIRUpdateUI-Klasse implementiert eine Standardbenutzeroberfläche, die Ihre Anwendung verwenden kann. Sie bietet dem Benutzer grundlegende Informationen und Optionen für Anwendungsaktualisierungen.

Der Aktualisierungsvorgang durchläuft eine Statussequenz:

Status Beschreibung UninitializedDer Updater wurde nicht initialisiert.InitializingDer Updater wird initialisiert.ReadyDer Updater wurde initialisiert.Before checkingDer Updater hat noch nicht nach der Updatedeskriptordatei gesucht.CheckingDer Updater sucht nach einer Updatedeskriptordatei.AvailableDie Updatedeskriptordatei ist verfügbar.DownloadingDer Updater lädt die AIR-Datei herunter.DownloadedDer Updater hat die AIR-Datei heruntergeladen.InstallingDer Updater installiert die AIR-Datei.Pending installDer Updater wurde initialisiert und Aktualisierungen stehen aus.

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

Weitere Details zur Verwendung des AIR-Updateframeworks finden Sie im Kapitel „Updating AIR Applications“ (Aktualisieren von AIR-Anwendungen) in Developing Adobe AIR Applications with Adobe Flex.

Weitere Details zur Verwendung des AIR-Updateframeworks finden Sie im Kapitel „Aktualisieren von AIR-Anwendungen“ in Entwickeln von Adobe AIR 1.5-Anwendungen mit Adobe Flash.

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

updateStatus Wird ausgelöst, nachdem der Updater die Updatedeskriptordatei erfolgreich heruntergeladen und interpretiert hat.air.update.events.StatusUpdateEvent.UPDATE_STATUSair.update.events.StatusUpdateEvent Wird ausgelöst, nachdem der Updater die Updatedeskriptordatei erfolgreich heruntergeladen und interpretiert hat. beforeInstall Wird unmittelbar vor der Installation des Updates ausgelöst, nachdem die installUpdate()-Methode aufgerufen wurde.air.update.events.UpdateEvent.BEFORE_INSTALLair.update.events.UpdateEvent 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.

downloadComplete Wird ausgelöst, wenn das Herunterladen der Updatedatei abgeschlossen ist. air.update.events.UpdateEvent.DOWNLOAD_COMPLETEair.update.events.UpdateEvent Wird ausgelöst, wenn das Herunterladen der Updatedatei abgeschlossen ist. downloadStart Wird ausgelöst, nachdem ein Aufruf der downloadUpdate()-Methode ausgeführt und die Verbindung zum Server hergestellt wurde.air.update.events.UpdateEvent.DOWNLOAD_STARTair.update.events.UpdateEvent 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. checkForUpdate Wird vor dem Beginn des Aktualisierungsvorgangs ausgelöst, unmittelbar bevor der Updater versucht, die Updatedeskriptordatei herunterzuladen.air.update.events.UpdateEvent.CHECK_FOR_UPDATEair.update.events.UpdateEvent 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. initialized Wird ausgelöst, nachdem die Initialisierung abgeschlossen ist.air.update.events.UpdateEvent.INITIALIZEDair.update.events.UpdateEvent Wird ausgelöst, nachdem die Initialisierung abgeschlossen ist.

Dieses Ereignis verfügt über die folgenden schreibgeschützten Eigenschaften:

isFirstRun (Boolescher Wert) true, wenn dies die erste Ausführung nach einer erfolgreichen Aktualisierung ist; andernfalls false.
previousVersion (String) Die vorherige Version der Anwendung vor der Aktualisierung (nur festgelegt, wenn isfirstRun true ist).
currentVersion (String) Die Version von der Anwendungsdeskriptordatei der aktuell installierten Version.

ApplicationUpdaterUI Die Konstruktorfunktion. Die Konstruktorfunktion. addResources Fügt dynamisch ein neues Ressourcen-Bundle für die festgelegte Sprache hinzu.langStringDer Sprachcode (z. B. "ro" für Rumänisch). resObjectDas Objekt enthält die Schlüssel und Werte für die Übersetzung. Die Schlüssel stammen aus der Spracheigenschaftsdatei. Die folgende Tabelle enthält die möglichen Schlüssel (Eigenschaftsnamen).

Schlüssel Deutscher Wert Dialogfeld Beschreibung appWidth 530 Alle Breite des Dialogfelds. titleWindow Aktualisierung wird durchgeführt: Alle Wird in der nativen Fenstertitelleiste vor dem Anwendungsnamen angezeigt. titleCheck Nach Updates suchen Nach Updates suchen Dialogfeldtitel. msgCheck Zulassen, dass die Anwendung nach Updates sucht? Nach Updates suchen Dialogfeldmeldung. btnCheck Nach Updates suchen Nach Updates suchen Beschriftung der Schaltfläche „Nach Updates suchen“. btnCancel Abbrechen Alle Dialogfelder mit der Schaltfläche „Abbrechen“ Beschriftung der Schaltfläche „Abbrechen“. titleCheckNoUpdates Keine Updates verfügbar CheckForUpdates – Keine Updates verfügbar Dialogfeldtitel. msgCheckNoUpdates Für die Anwendung sind keine Updates verfügbar. Nach Updates suchen – Keine Updates verfügbar Dialogfeldmeldung. btnClose Schließen Alle Dialogfelder mit der Schaltfläche „Schließen“ Beschriftung der Schaltfläche „Schließen“ titleCheckError Updatefehler Nach Updates suchen – Verbindungsfehler Dialogfeldtitel. msgCheckError Bei der Suche nach Updates ist ein Fehler aufgetreten. Fehlernr. {0} Nach Updates suchen – Verbindungsfehler Dialogfeldmeldung. {0} wird durch die Fehler-ID ersetzt. titleUpdate Update verfügbar Update verfügbar Dialogfeldtitel. msgUpdate Eine aktualisierte Version der Anwendung steht zum Herunterladen bereit. Update verfügbar Dialogfeldmeldung. lblApplication Anwendung: Update verfügbar Beschriftung, die vor dem Anwendungsnamen angezeigt wird. lblInstalledVersion Installierte Version: Update verfügbar Beschriftung, die vor der installierten Version angezeigt wird. lblAvailableVersion Updateversion: Update verfügbar Beschriftung, die vor der Updateversion angezeigt wird. btnDownload Jetzt herunterladen Update verfügbar Beschriftung der Schaltfläche „Jetzt herunterladen“ btnDownloadLater Später herunterladen Update verfügbar Beschriftung der Schaltfläche „Später herunterladen“. lnkReleaseNotes Versionshinweise Alle mit einem Hyperlink „Versionshinweise“ Der Hyperlinkname „Versionshinweise“. titleProgress Downloadfortschritt... Downloadfortschritt Dialogfeldtitel. msgProgress Update wird heruntergeladen Downloadfortschritt Dialogfeldmeldung. titleDownloadError Download fehlgeschlagen Downloadfehler Dialogfeldtitel. msgDownloadError Beim Herunterladen des Updates ist ein Fehler aufgetreten. Fehlernr. {0} Downloadfehler Dialogfeldmeldung. {0} wird durch die Fehler-ID ersetzt. titleInstall Update installieren Update installieren Dialogfeldtitel. msgInstall Das Update für die Anwendung wurde heruntergeladen und ist bereit zur Installation. Update installieren Dialogfeldmeldung. btnInstall Jetzt installieren Update installieren Beschriftung der Schaltfläche „Installieren“ btnInstallLater Nach dem Neustart Update installieren Beschriftung der Schaltfläche „Nach dem Neustart“ titleFileUpdate Update verfügbar Datei – Update verfügbar Dialogfeldtitel. msgFileUpdate Die Datei enthält eine aktualisierte Version der Anwendung. Installieren? Datei – Update verfügbar Dialogfeldmeldung. lblFile File: Datei – Update verfügbar Beschriftung, die vor dem Dateinamen angezeigt wird. titleFileNoUpdate Kein Update verfügbar Datei – Keine Updates verfügbar Dialogfeldtitel. msgFileNoUpdate Die Datei enthält keine neuere Version der Anwendung. Datei – Keine Updates verfügbar Dialogfeldmeldung. titleFileError Dateifehler Datei – Fehler Dialogfeldtitel. msgFileError Ein Fehler ist beim Validieren der Updatedatei aufgetreten. Fehlernr. {0} Datei – Fehler Dialogfeldmeldung. {0} wird durch die Fehler-ID ersetzt. titleUnexpectedError Unerwarteter Fehler Unerwarteter Fehler Dialogfeldtitel. msgUnexpectedError Ein unerwarteter Fehler ist aufgetreten. Fehlernr. {0} Unerwarteter Fehler Dialogfeldmeldung. {0} wird durch die Fehler-ID ersetzt.

Fügt dynamisch ein neues Ressourcen-Bundle für die festgelegte Sprache hinzu. JavaScript-Entwickler verwenden diese Methode, um dynamisch eine neue Sprache für die Dialogfelder hinzuzufügen, die die Updater-UI der Anwendung anzeigt. (Flex-Entwickler können direkt eine neue Sprache zum Ressourcen-Bundle „ApplicationUpdaterDialogs“ hinzufügen.) cancelUpdate Bricht den Aktualisierungsvorgang ab. 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, 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.

checkNow Startet den Aktualisierungsvorgang. 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:

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.
Sie sucht nach einer verschobenen Aktualisierung und installiert sie ggf.
Wenn eine vorherige Aktualisierung fehlgeschlagen ist, werden die Updatedatei und die Versionsinformationen aus dem Speicherbereich gelöscht.
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.

Das Aufrufen dieser Methode hat keine Wirkung, 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.

fileUpdateStatusair.update.events:StatusFileUpdateEventWird ausgelöst, nachdem der Updater die AIR-Datei erfolgreich überprüft hat. Wird ausgelöst, nachdem der Updater die AIR-Datei erfolgreich überprüft hat.updateErrorair.update.events:StatusFileUpdateErrorEventWird ausgelöst, wenn ein Fehler beim Versuch des Parsings der Updatedeskriptordatei auftritt. Wird ausgelöst, wenn ein Fehler beim Versuch des Parsings der Updatedeskriptordatei auftritt.configurationFile Der Speicherort der Konfigurationsdatei, die die Werte für die delay- und updateURL-Eigenschaften festlegt.flash.filesystem:File Der Speicherort der Konfigurationsdatei, die die Werte für die delay- und updateURL-Eigenschaften festlegt. Außerdem sind Einstellungen vorhanden, ob die Anwendung verschiedene Bestätigungsdialogfelder beim Aktualisierungsvorgang anzeigt. 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> <defaultUI> <dialog name="checkForUpdate" visible="true" /> <dialog name="downloadUpdate" visible="false" /> <dialog name="downloadProgress" visible="true" /> <dialog name="installUpdate" visible="true" /> </defaultUI> </configuration>

Anstatt eine Konfigurationsdatei zu laden, können Sie den ActionScript --Code verwenden, um die folgenden Eigenschaften des ApplicationUpdaterUI-Objekts festzulegen: delay-, isCheckForUpdateVisible-, isDownloadProgressVisible-, isDownloadUpdateVisible-, isFileUpdateVisible-, isInstallUpdateVisible- und updateURL-Eigenschaften.

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

isCheckForUpdateVisible Aktiviert die Sichtbarkeit der Dialogfelder „Nach Updates suchen“, „Keine Updates verfügbar“ und „Updatefehler“.Boolean Aktiviert die Sichtbarkeit der Dialogfelder „Nach Updates suchen“, „Keine Updates verfügbar“ und „Updatefehler“. Wenn true festgelegt wird, zeigt der Updater diese Dialogfelder als Teil des Aktualisierungsvorgangs an. Dies kann auch in der Aktualisierungskonfigurationsdatei festgelegt werden. Ein mithilfe dieser Eigenschaft festgelegter Wert überschreibt die Einstellung in der Aktualisierungskonfigurationsdatei. isDownloadProgressVisible Aktiviert die Sichtbarkeit des Dialogfelds „Update herunterladen“.Boolean Aktiviert die Sichtbarkeit des Dialogfelds „Update herunterladen“. Wenn true festgelegt wird, zeigt der Updater diese Dialogfelder als Teil des Aktualisierungsvorgangs an. Dies kann auch in der Aktualisierungskonfigurationsdatei festgelegt werden. Ein mithilfe dieser Eigenschaft festgelegter Wert überschreibt die Einstellung in der Aktualisierungskonfigurationsdatei. isDownloadUpdateVisible Aktiviert die Sichtbarkeit des Dialogfelds „Update herunterladen“.Boolean Aktiviert die Sichtbarkeit des Dialogfelds „Update herunterladen“. Wenn true festgelegt wird, zeigt der Updater diese Dialogfelder als Teil des Aktualisierungsvorgangs an. Dies kann auch in der Aktualisierungskonfigurationsdatei festgelegt werden. Ein mithilfe dieser Eigenschaft festgelegter Wert überschreibt die Einstellung in der Aktualisierungskonfigurationsdatei. isFileUpdateVisible Aktiviert die Sichtbarkeit der Dialogfelder „Datei-Update“, „Kein Datei-Update“ und „Dateifehler“.Boolean Aktiviert die Sichtbarkeit der Dialogfelder „Datei-Update“, „Kein Datei-Update“ und „Dateifehler“. Wenn true festgelegt wird, zeigt der Updater diese Dialogfelder als Teil des Aktualisierungsvorgangs an. Dies kann auch in der Aktualisierungskonfigurationsdatei festgelegt werden. Ein mithilfe dieser Eigenschaft festgelegter Wert überschreibt die Einstellung in der Aktualisierungskonfigurationsdatei. isFirstRun Gibt an, ob dies die erste Ausführung nach einer erfolgreichen Aktualisierung („true“) ist oder nicht („false“).Boolean 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. isInstallUpdateVisible Aktiviert die Sichtbarkeit des Dialogfelds „Update installieren“.Boolean Aktiviert die Sichtbarkeit des Dialogfelds „Update installieren“. Wenn true festgelegt wird, zeigt der Updater diese Dialogfelder als Teil des Aktualisierungsvorgangs an. Dies kann auch in der Aktualisierungskonfigurationsdatei festgelegt werden. Ein mithilfe dieser Eigenschaft festgelegter Wert überschreibt die Einstellung in der Aktualisierungskonfigurationsdatei. isNewerVersionFunction Eine Funktion, die der Updater verwenden sollte, um Versionsvergleiche auszuführen.Function 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.

Der folgende Code definiert die benutzerdefinierte Funktion customFn für das appUpdate-Updaterobjekt. Die Beispielsfunktion ist absichtlich einfach gehalten. Ihre benutzerdefinierte Funktion sollte einen booleschen Wert zurückgeben, der auf den Regeln Ihres Versionsschemas basiert. appUpdate.isNewerVersionFunction = customFn; function customFn (currentVersion:String, updateVersion:String):Boolean { return updateVersion > currentVersion; } isUnexpectedErrorVisible Aktiviert die Sichtbarkeit des Dialogfelds „Unerwarteter Fehler“.Boolean Aktiviert die Sichtbarkeit des Dialogfelds „Unerwarteter Fehler“. Wenn true festgelegt wird, zeigt der Anwendungsupdater dieses Dialogfeld als Teil des Aktualisierungsvorgangs an. Dies kann auch in der Aktualisierungskonfigurationsdatei festgelegt werden. Ein mithilfe dieser Eigenschaft festgelegter Wert überschreibt die Einstellung in der Aktualisierungskonfigurationsdatei. isUpdateInProgress Ein boolescher Ausdruck, der als „true“ festgelegt ist, wenn eine Aktualisierung ausgeführt wird, andernfalls „false“.Boolean Eine boolesche Eigenschaft, die als true festgelegt ist, wenn eine Aktualisierung ausgeführt wird, andernfalls false. localeChain Ein Array, das die Gebietsschemakette definiert, die von der Benutzeroberfläche verwendet wird.Array Ein Array, das die Gebietsschemakette definiert, die von der Benutzeroberfläche verwendet wird. Üblicherweise verwenden nur JavaScript-Entwickler (HTML) diese Eigenschaft.

Flex-Entwickler können den ResourceManager verwenden, um die Gebietsschemakette zu verarbeiten.

Standardmäßig werden die Sprachen in einer HTML-basierten Anwendung im Hinblick auf die Sprachen im Capabilities.languages-Array und die zehn Sprachen sortiert, die von der Benutzeroberfläche unterstützt werden. Wenn keine Übereinstimmung gefunden wird, wird die Benutzeroberfläche in englischer Sprache angezeigt.

Dieses JavaScript-Beispiel verwendet die AIR-HTML-Lokalisierungsarchitektur, die im AIR SDK enthalten ist. Die Sprachen werden im Hinblick auf die Liste der Sprachen sortiert und anschließend wird Englisch als die standardmäßige Fallback-Sprache festgelegt.

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; previousApplicationStorageDirectory Der vorherige Speicherort des Anwendungsspeicherordners, falls er nach einer Aktualisierung geändert wurde.flash.filesystem:File 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.

previousVersion Die vorherige Version der Anwendung.String 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. updateDescriptor Der Inhalt der Updatedeskriptordatei, der von der Aktualisierungs-URL heruntergeladen wurde.XML Der Inhalt der Updatedeskriptordatei, der von der Aktualisierungs-URL heruntergeladen wurde. Diese Eigenschaft ist nur nicht „null“, nachdem das Updaterobjekt ein updateStatus-Ereignis auslöst. updateURL Der Speicherort der Updatedeskriptordatei.String 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. wasPendingUpdate Gibt an, ob es sich um eine verschobene Aktualisierung handelt, auch wenn sie nicht installiert werden konnte („true“); andernfalls „false“.Boolean 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).