| Paket | flash.desktop |
| Klasse | public final class Updater |
| Vererbung | Updater  Object |
| Sprachversion: | ActionScript 3.0 |
| Laufzeitversionen: | AIR 1.0 |
update()-Methode auf.
Die Updater-Klasse wird nur im Desktop-Profil unterstützt. Sie wird weder für erweiterte Desktop-Anwendungen (Anwendungen, die mit einem nativen Installer installiert werden) noch im Mobil-AIR-Profil oder in AIR-für-TV-Profilen unterstützt. Überprüfen Sie die Updater.isSupported-Eigenschaft.
Erweiterte Desktop-Anwendungen (Anwendungen, die mit einem nativen Installer installiert werden) können eine neue Version des nativen Installers herunterladen und diesen mithilfe der File.openWithDefaultApplication()-Methode starten.
Verwandte API-Elemente
Vererbte öffentliche Eigenschaften ausblenden
Vererbte öffentliche Eigenschaften anzeigen| Eigenschaft | Definiert von | ||
|---|---|---|---|
 | constructor : Object
Ein Verweis auf das Klassenobjekt oder die Konstruktorfunktion für eine angegebene Objektinstanz. | Object | |
| isSupported : Boolean [statisch] [schreibgeschützt]
Die isSupported-Eigenschaft hat den Wert „true“, wenn die Updater-Klasse auf der aktuellen Plattform verfügbar ist, andernfalls hat sie den Wert „false“. | Updater | ||
| Methode | Definiert von | ||
|---|---|---|---|
Updater()
Die Konstruktorfunktion für die Updater-Klasse. | Updater | ||
|
Gibt an, ob für ein Objekt eine bestimmte Eigenschaft definiert wurde. | Object | |
|
Gibt an, ob eine Instanz der Object-Klasse in der Prototypkette des Objekts vorhanden ist, das als Parameter angegeben wurde. | Object | |
|
Gibt an, ob die angegebene Eigenschaft vorhanden ist und durchlaufen werden kann. | Object | |
|
Legt die Verfügbarkeit einer dynamischen Eigenschaft für Schleifenoperationen fest. | Object | |
|
Gibt die Stringdarstellung dieses Objekts zurück, formatiert entsprechend den Konventionen des Gebietsschemas. | Object | |
|
Gibt das angegebene Objekt als String zurück. | Object | |
Aktualisiert die zurzeit ausgeführte Anwendung mit der Version der Anwendung, die in der angegebenen AIR-Datei enthalten ist. | Updater | ||
|
Gibt den Grundwert des angegebenen Objekts zurück. | Object | |
isSupported | Eigenschaft |
isSupported:Boolean [schreibgeschützt] | Sprachversion: | ActionScript 3.0 |
| Laufzeitversionen: | AIR 2 |
Die isSupported-Eigenschaft hat den Wert true, wenn die Updater-Klasse auf der aktuellen Plattform verfügbar ist, andernfalls hat sie den Wert false.
Implementierung
public static function get isSupported():Boolean Updater | () | Konstruktor |
public function Updater()| Laufzeitversionen: | AIR 1.0 |
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.
update | () | Methode |
public function update(airFile:File, version:String):void| Sprachversion: | ActionScript 3.0 |
| Laufzeitversionen: | AIR 1.0 |
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
airFile:File — Das File-Objekt, das auf die AIR-Datei verweist, die die aktualisierte Version der Anwendung enthält.
| |
version:String — Die erforderliche Version in der neuen AIR-Datei. Der String im version-Attribut des Haupt-application-Elements der Anwendungsdeskriptordatei für die AIR-Datei muss mit diesem Wert übereinstimmen, damit die Aktualisierung erfolgreich verläuft.
|
Auslöser
IllegalOperationError — Die Methode wurde beim Ausführen in ADL aufgerufen.
|
Verwandte API-Elemente
Beispiel ( Verwendung dieses Beispiels )
update()-Methode nicht um eine statische Methode der Klasse handelt. Sie instanziieren ein Updater-Objekt und rufen die update()-Methode dieses Objekts auf.
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);
Tue Jun 12 2018, 10:04 AM Z