Updater  - AS3

Die isSupported-Eigenschaft hat den Wert true, wenn die Updater-Klasse auf der aktuellen Plattform verfügbar ist, andernfalls hat sie den Wert false.

Die Konstruktorfunktion für die Updater-Klasse. Beachten Sie, dass die update()-Methode kein statisches Mitglied der Klasse ist. Sie müssen ein Updater-Objekt instanziieren und dann die update()-Methode dafür aufrufen.

Aktualisiert die zurzeit ausgeführte Anwendung mit der Version der Anwendung, die in der angegebenen AIR-Datei enthalten ist. Die Anwendung in der AIR-Datei muss dieselbe Anwendungskennung (appID) aufweisen wie die zurzeit ausgeführte Anwendung.

Durch den Aufruf dieser Methode wird die aktuelle Anwendung beendet (wie beim Aufruf der NativeApplication.exit()-Methode). Dies ist erforderlich, da Adobe AIR eine Anwendung nicht vollständig aktualisieren kann, wenn die Anwendung ausgeführt wird. Nachdem die neue Version der Anwendung erfolgreich installiert wurde, wird die Anwendung gestartet. Wenn die neue Version von der Laufzeitumgebung nicht erfolgreich installiert werden kann (weil zum Beispiel die Anwendungs-ID nicht mit der vorhandenen Version übereinstimmt), zeigt das AIR-Installationsprogramm eine Fehlermeldung an. Danach wird wieder die alte Version gestartet.

Unabhängig davon, ob die Aktualisierung erfolgreich verläuft oder nicht, startet der Aktualisierungsprozess die Anwendung neu. Aktualisierungen können aus verschiedenen Gründen fehlschlagen, zum Teil, ohne dass die Anwendung Einfluss darauf nehmen kann (zum Beispiel, wenn der Benutzer nicht über die Berechtigung zum Installieren der Anwendung verfügt). Anwendungen sollten fehlgeschlagene Versuche erkennen und den fehlgeschlagenen Vorgang nicht wiederholen. Die resultierende unendliche Schleife würde die Anwendung praktisch deaktivieren. Eine Möglichkeit, den Erfolg einer Aktualisierung zu überprüfen, besteht darin, die aktuelle Versionsnummer vor der Aktualisierung in eine Datei zu schreiben und sie dann mit der Versionsnummer nach dem Neustart der Anwendung zu vergleichen.

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

Wenn unter Mac OS eine aktualisierte Version der Anwendung installiert werden soll, benötigt der Benutzer die entsprechenden Systemberechtigungen, um im Anwendungsverzeichnis zu installieren. Unter Windows und Linux benötigt der Benutzer Administratorberechtigungen.

Wenn für die aktualisierte Version der Anwendung eine aktualisierte Version der Laufzeitumgebung erforderlich ist, wird die neue Laufzeitversion installiert. Um die Laufzeitumgebung zu aktualisieren, muss der Benutzer über Administratorberechtigungen für den Computer verfügen.

Hinweis: Aus Sicherheitsgründen ist die Angabe des version-Parameters erforderlich. Durch das obligatorische Überprüfen der Versionsnummer in der AIR-Datei wird verhindert, dass die Anwendung unbeabsichtigt eine ältere Version installiert, die möglicherweise Sicherheitslücken aufweist, die in der neueren Version behoben wurden.

Parameter

Verwandte API-Elemente

import flash.fileSystem.File;
import flash.desktop.Updater;
 
var updater:Updater = new Updater();
var airFile:File = File.applicationStorageDirectory.resolvePath("Example Application.air");
var version:String = "2.01";
updater.update(airFile, version);