| Paket | air.update |
| Klasse | public class ApplicationUpdaterUI |
| Vererbung | ApplicationUpdaterUI  EventDispatcher Object |
| Sprachversion: | ActionScript 3.0 |
| Laufzeitversionen: | AIR 1.5 |
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“.
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.
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 |
|---|---|
| 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 install | 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.
Ausführliche Informationen zur Verwendung des AIR-Updateframeworks finden Sie im Kapitel „Aktualisieren von AIR-Anwendungen“ in Erstellen von Adobe AIR-Anwendungen .
Verwandte API-Elemente
Vererbte öffentliche Eigenschaften ausblenden
Vererbte öffentliche Eigenschaften anzeigen| Eigenschaft | Definiert von | ||
|---|---|---|---|
| configurationFile : File
Der Speicherort der Konfigurationsdatei, die die Werte für die delay- und updateURL-Eigenschaften festlegt. | ApplicationUpdaterUI | ||
 | constructor : Object
Ein Verweis auf das Klassenobjekt oder die Konstruktorfunktion für eine angegebene Objektinstanz. | Object | |
| currentVersion : String [schreibgeschützt]
Die aktuelle Version der Anwendung. | ApplicationUpdaterUI | ||
| delay : Number
Das Intervall in Tagen zwischen regelmäßigen Suchen nach neuen Updates. | ApplicationUpdaterUI | ||
| isCheckForUpdateVisible : Boolean
Aktiviert die Sichtbarkeit der Dialogfelder „Nach Updates suchen“, „Keine Updates verfügbar“ und „Updatefehler“. | ApplicationUpdaterUI | ||
| isDownloadProgressVisible : Boolean
Aktiviert die Sichtbarkeit des Dialogfelds „Update herunterladen“. | ApplicationUpdaterUI | ||
| isDownloadUpdateVisible : Boolean
Aktiviert die Sichtbarkeit des Dialogfelds „Update herunterladen“. | ApplicationUpdaterUI | ||
| isFileUpdateVisible : Boolean
Aktiviert die Sichtbarkeit der Dialogfelder „Datei-Update“, „Kein Datei-Update“ und „Dateifehler“. | ApplicationUpdaterUI | ||
| isFirstRun : Boolean [schreibgeschützt]
Gibt an, ob dies die erste Ausführung nach einer erfolgreichen Aktualisierung („true“) ist oder nicht („false“). | ApplicationUpdaterUI | ||
| isInstallUpdateVisible : Boolean
Aktiviert die Sichtbarkeit des Dialogfelds „Update installieren“. | ApplicationUpdaterUI | ||
| isNewerVersionFunction : Function
Eine Funktion, die der Updater verwenden sollte, um Versionsvergleiche auszuführen. | ApplicationUpdaterUI | ||
| isUnexpectedErrorVisible : Boolean
Aktiviert die Sichtbarkeit des Dialogfelds „Unerwarteter Fehler“. | ApplicationUpdaterUI | ||
| isUpdateInProgress : Boolean [schreibgeschützt]
Ein boolescher Ausdruck, der als „true“ festgelegt ist, wenn eine Aktualisierung ausgeführt wird, andernfalls „false“. | ApplicationUpdaterUI | ||
| localeChain : Array
Ein Array, das die Gebietsschemakette definiert, die von der Benutzeroberfläche verwendet wird. | ApplicationUpdaterUI | ||
| previousApplicationStorageDirectory : File [schreibgeschützt]
Der vorherige Speicherort des Anwendungsspeicherordners, falls er nach einer Aktualisierung geändert wurde. | ApplicationUpdaterUI | ||
| previousVersion : String [schreibgeschützt]
Die vorherige Version der Anwendung. | ApplicationUpdaterUI | ||
| updateDescriptor : XML [schreibgeschützt]
Der Inhalt der Updatedeskriptordatei, der von der Aktualisierungs-URL heruntergeladen wurde. | ApplicationUpdaterUI | ||
| updateURL : String
Der Speicherort der Updatedeskriptordatei. | ApplicationUpdaterUI | ||
| wasPendingUpdate : Boolean [schreibgeschützt]
Gibt an, ob es sich um eine verschobene Aktualisierung handelt, auch wenn sie nicht installiert werden konnte („true“); andernfalls „false“. | ApplicationUpdaterUI | ||
| Methode | Definiert von | ||
|---|---|---|---|
Die Konstruktorfunktion. | ApplicationUpdaterUI | ||
| addEventListener(type:String, listener:Function, useCapture:Boolean = false, priority:int = 0, useWeakReference:Boolean = false):void
Registriert ein Ereignis-Listener-Objekt bei einem EventDispatcher-Objekt, sodass der Listener über ein Ereignis benachrichtigt wird. | EventDispatcher | |
Fügt dynamisch ein neues Ressourcen-Bundle für die festgelegte Sprache hinzu. | ApplicationUpdaterUI | ||
Bricht den Aktualisierungsvorgang ab. | ApplicationUpdaterUI | ||
Startet den Aktualisierungsvorgang. | ApplicationUpdaterUI | ||
|
Sendet ein Ereignis in den Ereignisablauf. | EventDispatcher | |
|
Überprüft, ob das EventDispatcher-Objekt Listener für einen bestimmten Ereignistyp registriert hat. | EventDispatcher | |
|
Gibt an, ob für ein Objekt eine bestimmte Eigenschaft definiert wurde. | Object | |
Initialisiert den Updater. | ApplicationUpdaterUI | ||
Startet den Aktualisierungsvorgang mithilfe einer lokalen AIR-Datei. | ApplicationUpdaterUI | ||
|
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 | |
|
Entfernt einen Listener aus dem EventDispatcher-Objekt. | EventDispatcher | |
|
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 | |
|
Gibt den Grundwert des angegebenen Objekts zurück. | Object | |
|
Überprüft, ob bei diesem EventDispatcher-Objekt oder bei einem seiner Vorgänger ein Ereignis-Listener für einen bestimmten Ereignistyp registriert ist. | EventDispatcher | |
| Ereignis | Übersicht | Definiert von | ||
|---|---|---|---|---|
| [broadcast event] Wird ausgelöst, wenn Flash Player oder eine AIR-Anwendung den Betriebssystemfokus erhält und aktiv wird. | EventDispatcher | ||
| Wird unmittelbar vor der Installation des Updates ausgelöst, nachdem die installUpdate()-Methode aufgerufen wurde. | ApplicationUpdaterUI | |||
| Wird vor dem Beginn des Aktualisierungsvorgangs ausgelöst, unmittelbar bevor der Updater versucht, die Updatedeskriptordatei herunterzuladen. | ApplicationUpdaterUI | |||
| [broadcast event] Wird ausgelöst, wenn Flash Player- oder die AIR-Anwendung den Fokus verliert und inaktiv wird. | EventDispatcher | ||
| Wird ausgelöst, wenn das Herunterladen der Updatedatei abgeschlossen ist. | ApplicationUpdaterUI | |||
| Wird ausgelöst, wenn ein Fehler bei der Verbindung oder dem Herunterladen der Updatedatei auftritt. | ApplicationUpdaterUI | |||
| Wird ausgelöst, nachdem ein Aufruf der downloadUpdate()-Methode ausgeführt und die Verbindung zum Server hergestellt wurde. | ApplicationUpdaterUI | |||
| Wird ausgelöst, wenn ein Fehler bei der Initialisierung oder während des Aktualisierungsvorgangs (bei einem unerwarteten Ereignis) auftritt. | ApplicationUpdaterUI | |||
| Wird ausgelöst, wenn ein Fehler bei der Überprüfung der als airFile-Parameter übergebenen Datei in einem Aufruf der installFromAIRFile()-Methode auftritt. | ApplicationUpdaterUI | |||
| Wird ausgelöst, nachdem der Updater erfolgreich die Datei im Aufruf der installFromAIRFile()-Methode überprüft hat. | ApplicationUpdaterUI | |||
| Wird ausgelöst, nachdem die Initialisierung abgeschlossen ist. | ApplicationUpdaterUI | |||
| Wird abgesetzt, wenn die Updatedatei heruntergeladen wird. | ApplicationUpdaterUI | |||
| Wird ausgelöst, wenn ein Fehler beim Versuch des Herunterladens oder Parsings der Updatedeskriptordatei auftritt. | ApplicationUpdaterUI | |||
| Wird ausgelöst, nachdem der Updater die Updatedeskriptordatei erfolgreich heruntergeladen und interpretiert hat. | ApplicationUpdaterUI | |||
configurationFile | Eigenschaft |
configurationFile:File| Sprachversion: | ActionScript 3.0 |
| Laufzeitversionen: | AIR 1.5 |
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.
Implementierung
public function get configurationFile():File public function set configurationFile(value:File):voidVerwandte API-Elemente
currentVersion | Eigenschaft |
currentVersion:String [schreibgeschützt] | Sprachversion: | ActionScript 3.0 |
| Laufzeitversionen: | AIR 1.5 |
Die aktuelle Version der Anwendung. Diese Eigenschaft wird bei einem Aufruf der initialize()-Methode festgelegt. Sie wird als die Version der Anwendungsdeskriptordatei festgelegt.
Implementierung
public function get currentVersion():String delay | Eigenschaft |
delay:Number| Sprachversion: | ActionScript 3.0 |
| Laufzeitversionen: | AIR 1.5 |
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. 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.
Der Standardwert ist 0.
Implementierung
public function get delay():Number public function set delay(value:Number):voidVerwandte API-Elemente
isCheckForUpdateVisible | Eigenschaft |
isCheckForUpdateVisible:Boolean| Sprachversion: | ActionScript 3.0 |
| Laufzeitversionen: | AIR 1.5 |
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.
Implementierung
public function get isCheckForUpdateVisible():Boolean public function set isCheckForUpdateVisible(value:Boolean):void isDownloadProgressVisible | Eigenschaft |
isDownloadProgressVisible:Boolean| Sprachversion: | ActionScript 3.0 |
| Laufzeitversionen: | AIR 1.5 |
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.
Implementierung
public function get isDownloadProgressVisible():Boolean public function set isDownloadProgressVisible(value:Boolean):void isDownloadUpdateVisible | Eigenschaft |
isDownloadUpdateVisible:Boolean| Laufzeitversionen: | AIR 1.5 |
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.
Implementierung
public function get isDownloadUpdateVisible():Boolean public function set isDownloadUpdateVisible(value:Boolean):void isFileUpdateVisible | Eigenschaft |
isFileUpdateVisible:Boolean| Sprachversion: | ActionScript 3.0 |
| Laufzeitversionen: | AIR 1.5 |
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.
Implementierung
public function get isFileUpdateVisible():Boolean public function set isFileUpdateVisible(value:Boolean):void isFirstRun | Eigenschaft |
isFirstRun:Boolean [schreibgeschützt] | Sprachversion: | ActionScript 3.0 |
| Laufzeitversionen: | AIR 1.5 |
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.
Implementierung
public function get isFirstRun():BooleanVerwandte API-Elemente
isInstallUpdateVisible | Eigenschaft |
isInstallUpdateVisible:Boolean| Sprachversion: | ActionScript 3.0 |
| Laufzeitversionen: | AIR 1.5 |
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.
Implementierung
public function get isInstallUpdateVisible():Boolean public function set isInstallUpdateVisible(value:Boolean):void isNewerVersionFunction | Eigenschaft |
isNewerVersionFunction:Function| Sprachversion: | ActionScript 3.0 |
| Laufzeitversionen: | AIR 1.5 |
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.
Implementierung
public function get isNewerVersionFunction():Function public function set isNewerVersionFunction(value:Function):voidBeispiel ( Verwendung dieses Beispiels )
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 | Eigenschaft |
isUnexpectedErrorVisible:Boolean| Sprachversion: | ActionScript 3.0 |
| Laufzeitversionen: | AIR 1.5 |
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.
Implementierung
public function get isUnexpectedErrorVisible():Boolean public function set isUnexpectedErrorVisible(value:Boolean):void isUpdateInProgress | Eigenschaft |
localeChain | Eigenschaft |
localeChain:Array| Sprachversion: | ActionScript 3.0 |
| Laufzeitversionen: | AIR 1.5 |
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;Implementierung
public function get localeChain():Array public function set localeChain(value:Array):voidVerwandte API-Elemente
previousApplicationStorageDirectory | Eigenschaft |
previousApplicationStorageDirectory:File [schreibgeschützt] | Sprachversion: | ActionScript 3.0 |
| Laufzeitversionen: | AIR 1.5 |
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.
Implementierung
public function get previousApplicationStorageDirectory():File previousVersion | Eigenschaft |
previousVersion:String [schreibgeschützt] | Sprachversion: | ActionScript 3.0 |
| Laufzeitversionen: | AIR 1.5 |
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.
Implementierung
public function get previousVersion():String updateDescriptor | Eigenschaft |
updateDescriptor:XML [schreibgeschützt] | Sprachversion: | ActionScript 3.0 |
| Laufzeitversionen: | AIR 1.5 |
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.
Implementierung
public function get updateDescriptor():XML updateURL | Eigenschaft |
updateURL:String| Sprachversion: | ActionScript 3.0 |
| Laufzeitversionen: | AIR 1.5 |
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.
Implementierung
public function get updateURL():String public function set updateURL(value:String):voidVerwandte API-Elemente
wasPendingUpdate | Eigenschaft |
wasPendingUpdate:Boolean [schreibgeschützt] | Sprachversion: | ActionScript 3.0 |
| Laufzeitversionen: | AIR 1.5 |
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).
Implementierung
public function get wasPendingUpdate():BooleanVerwandte API-Elemente
ApplicationUpdaterUI | () | Konstruktor |
public function ApplicationUpdaterUI()| Sprachversion: | ActionScript 3.0 |
| Laufzeitversionen: | AIR 1.5 |
Die Konstruktorfunktion.
addResources | () | Methode |
public function addResources(lang:String, res:Object):void| Sprachversion: | ActionScript 3.0 |
| Laufzeitversionen: | AIR 1.5 |
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.)
Parameter
lang:String — Der Sprachcode (z. B. "ro" für Rumänisch).
| |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
res:Object — Das 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).
|
Verwandte API-Elemente
cancelUpdate | () | Methode |
public function cancelUpdate():void| Sprachversion: | ActionScript 3.0 |
| Laufzeitversionen: | AIR 1.5 |
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 | () | Methode |
public function checkNow():void| Sprachversion: | ActionScript 3.0 |
| Laufzeitversionen: | AIR 1.5 |
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:
Ereignisse
checkForUpdate: — Wird unmittelbar vor Beginn des Aktualisierungsvorgangs ausgelöst.
|
initialize | () | Methode |
public function initialize():void| Sprachversion: | ActionScript 3.0 |
| Laufzeitversionen: | AIR 1.5 |
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.
Ereignisse
initialized: — Die Initialisierung ist abgeschlossen.
| |
error: — Bei der Initialisierung tritt ein Fehler auf.
|
installFromAIRFile | () | Methode |
public function installFromAIRFile(file:File):void| Sprachversion: | ActionScript 3.0 |
| Laufzeitversionen: | AIR 1.5 |
Startet den Aktualisierungsvorgang mithilfe einer lokalen AIR-Datei.
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.
Parameter
file:File — Die zu installierende AIR-Datei.
|
Ereignisse
fileUpdateStatus: — Wird ausgelöst, nachdem der Updater die AIR-Datei erfolgreich überprüft hat.
| |
updateError: — Wird ausgelöst, wenn ein Fehler beim Versuch des Parsings der Updatedeskriptordatei auftritt.
|
beforeInstall | Ereignis |
air.update.events.UpdateEventEigenschaft UpdateEvent.type =
air.update.events.UpdateEvent.BEFORE_INSTALL| Sprachversion: | ActionScript 3.0 |
| Laufzeitversionen: | AIR 1.5 |
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).
UpdateEvent.BEFORE_INSTALL-Konstante definiert den Wert der type-Eigenschaft des Ereignisobjekts für ein beforeInstall-Ereignis.
Dieses Ereignis verfügt über die folgenden Eigenschaften:
| Eigenschaft | Wert |
|---|---|
bubbles | false |
cancelable | false. Es gibt kein Standardverhalten, das abgebrochen werden kann. |
currentTarget | Das Objekt, welches das Ereignisobjekt aktiv mit einem Ereignis-Listener verarbeitet. |
target | Das Updaterobjekt. |
checkForUpdate | Ereignis |
air.update.events.UpdateEventEigenschaft UpdateEvent.type =
air.update.events.UpdateEvent.CHECK_FOR_UPDATE| Sprachversion: | ActionScript 3.0 |
| Laufzeitversionen: | AIR 1.5 |
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.
UpdateEvent.CHECK_FOR_UPDATE Konstante definiert den Wert der type-Eigenschaft des Ereignisobjekts für ein checkForUpdate-Ereignis.
Dieses Ereignis verfügt über die folgenden Eigenschaften:
| Eigenschaft | Wert |
|---|---|
bubbles | false |
cancelable | false. Es gibt kein Standardverhalten, das abgebrochen werden kann. |
currentTarget | Das Objekt, welches das Ereignisobjekt aktiv mit einem Ereignis-Listener verarbeitet. |
target | Das Updaterobjekt. |
downloadComplete | Ereignis |
air.update.events.UpdateEventEigenschaft UpdateEvent.type =
air.update.events.UpdateEvent.DOWNLOAD_COMPLETE| Sprachversion: | ActionScript 3.0 |
| Laufzeitversionen: | AIR 1.5 |
Wird ausgelöst, wenn das Herunterladen der Updatedatei abgeschlossen ist.
DieUpdateEvent.DOWNLOAD_COMPLETE-Konstante definiert den Wert der type-Eigenschaft des Ereignisobjekts für ein downloadComplete-Ereignis.
Dieses Ereignis verfügt über die folgenden Eigenschaften:
| Eigenschaft | Wert |
|---|---|
bubbles | false |
cancelable | false. Es gibt kein Standardverhalten, das abgebrochen werden kann. |
currentTarget | Das Objekt, welches das Ereignisobjekt aktiv mit einem Ereignis-Listener verarbeitet. |
target | Das Updaterobjekt. |
downloadError | Ereignis |
air.update.events.DownloadErrorEventEigenschaft DownloadErrorEvent.type =
air.update.events.DownloadErrorEvent.DOWNLOAD_ERROR| Sprachversion: | ActionScript 3.0 |
| Laufzeitversionen: | AIR 1.5 |
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).
DieDownloadErrorEvent.DOWNLOAD_ERROR-Konstante definiert den Wert der type-Eigenschaft des Ereignisobjekts für ein downloadError-Ereignis.
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.
| errorID-Fehlercode | Beschreibung |
|---|---|
| 16800 | Tritt bei der Überprüfung der heruntergeladenen Updatedatei auf. Die subErrorID-Eigenschaft stellt möglicherweise zusätzliche Informationen bereit. |
| 16801 | Ungültige Adobe AIR-Datei (application.xml fehlt). |
| 16802 | Ungültige Adobe AIR-Datei (MIME-Typ fehlt). |
| 16803 | Ungültige Adobe AIR-Datei (Format). |
| 16804 | Ungültige Adobe AIR-Datei (ungültige Flags). |
| 16805 | Ungültige Adobe AIR-Datei (unbekannte Komprimierung). |
| 16806 | Ungültige Adobe AIR-Datei (ungültiger Dateiname). |
| 16807 | Ungültige Adobe AIR-Datei (beschädigt). |
| 16808 | Konfigurationsdatei nicht vorhanden. |
| 16809 | Die updateURL-Eigenschaft ist nicht festgelegt. |
| 16810 | Reserviert. |
| 16811 | Ungültige Konfigurationsdatei (unbekannte Konfigurationsversion). |
| 16812 | Ungültige Konfigurationsdatei (URL fehlt). |
| 16813 | Ungültige Konfigurationsdatei (Verzögerungsformat). |
| 16814 | Ungültige Konfigurationsdatei (ungültige defaultUI-Werte). |
| 16815 | Ungültiger Updatedeskriptor (unbekannte Deskriptorversion). |
| 16816 | Ungültiger Updatedeskriptor (Updateversion fehlt). |
| 16817 | Ungültiger Updatedeskriptor (ungültige Beschreibung). |
| 16818 | IO-Fehler beim Speichern von Daten auf eine Festplatte. Die subErrorID-Eigenschaft stellt möglicherweise mehr Informationen bereit. |
| 16819 | Sicherheitsfehler beim Herunterladen. Die subErrorID-Eigenschaft stellt möglicherweise mehr Informationen bereit. |
| 16820 | Ungültiger HTTP-Statuscode. Die subErrorID-Eigenschaft enthält möglicherweise den ungültigen Statuscode. |
| 16821 | Reserviert. |
| 16822 | E/A-Fehler beim Herunterladen. Die subErrorID-Eigenschaft stellt möglicherweise mehr Informationen bereit. |
| 16823 | EOF-Fehler beim Speichern von Daten auf eine Festplatte. Die subErrorID-Eigenschaft stellt möglicherweise mehr Informationen bereit. |
| 16824 | Ungültiger Updatedeskriptor. Die subErrorID-Eigenschaft stellt möglicherweise mehr Informationen bereit. |
| 16825 | Die Updatedatei enthält eine Anwendung mit einer unterschiedlichen Anwendungs-ID. |
| 16826 | Die Updatedatei enthält keine neuere Version der Anwendung. |
| 16827 | Die in der Updatedatei enthaltene Version stimmt nicht mit der Version vom Updatedeskriptor überein. |
| 16828 | Die Anwendung kann nicht aktualisiert werden, da sie normalerweise im AIR Debug Launcher (ADL) ausgeführt wird. |
| 16829 | Fehlende Updatedatei bei der Installation. |
downloadStart | Ereignis |
air.update.events.UpdateEventEigenschaft UpdateEvent.type =
air.update.events.UpdateEvent.DOWNLOAD_START| Sprachversion: | ActionScript 3.0 |
| Laufzeitversionen: | AIR 1.5 |
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.
UpdateEvent.DOWNLOAD_START-Konstante definiert den Wert der type-Eigenschaft des Ereignisobjekts für ein downloadStart-Ereignis.
Dieses Ereignis verfügt über die folgenden Eigenschaften:
| Eigenschaft | Wert |
|---|---|
bubbles | false |
cancelable | false. Es gibt kein Standardverhalten, das abgebrochen werden kann. |
currentTarget | Das Objekt, welches das Ereignisobjekt aktiv mit einem Ereignis-Listener verarbeitet. |
target | Das Updaterobjekt. |
error | Ereignis |
flash.events.ErrorEventEigenschaft ErrorEvent.type =
flash.events.ErrorEvent.ERROR| Sprachversion: | ActionScript 3.0 |
| Laufzeitversionen: | AIR 1.5 |
Wird ausgelöst, wenn ein Fehler bei der Initialisierung oder während des Aktualisierungsvorgangs (bei einem unerwarteten Ereignis) auftritt.
Definiert den Wert der Eigenschafttype eines error-Ereignisobjekts.
Dieses Ereignis verfügt über die folgenden Eigenschaften:
| Eigenschaft | Wert |
|---|---|
bubbles | false |
cancelable | false. Es gibt kein Standardverhalten, das abgebrochen werden kann. |
currentTarget | Das Objekt, welches das Ereignisobjekt aktiv mit einem Ereignis-Listener verarbeitet. |
target | Das Objekt, bei dem der Netzwerkvorgang fehlschlägt. |
text | Der als Fehlermeldung anzuzeigende Text. |
fileUpdateError | Ereignis |
air.update.events.StatusFileUpdateErrorEventEigenschaft StatusFileUpdateErrorEvent.type =
air.update.events.StatusFileUpdateErrorEvent.FILE_UPDATE_ERROR| Sprachversion: | ActionScript 3.0 |
| Laufzeitversionen: | AIR 1.5 |
Wird ausgelöst, wenn ein Fehler bei der Überprüfung der als airFile-Parameter übergebenen Datei in einem Aufruf der installFromAIRFile()-Methode auftritt.
StatusUpdateErrorEvent.UPDATE_ERROR-Konstante definiert den Wert der type-Eigenschaft des Ereignisobjekts für ein statusUpdateError-Ereignis.
fileUpdateStatus | Ereignis |
air.update.events.StatusFileUpdateEventEigenschaft StatusFileUpdateEvent.type =
air.update.events.StatusFileUpdateEvent.FILE_UPDATE_STATUS| Sprachversion: | ActionScript 3.0 |
| Laufzeitversionen: | AIR 1.5 |
Wird ausgelöst, nachdem der Updater erfolgreich die Datei im Aufruf der installFromAIRFile()-Methode überprüft hat.
StatusUpdateEvent.UPDATE_STATUS-Konstante definiert den Wert der type-Eigenschaft des Ereignisobjekts für ein updateStatus-Ereignis.
Dieses Ereignis verfügt über die folgenden Eigenschaften:
| Eigenschaft | Wert |
|---|---|
available | Zeigt an, ob eine andere Version als die der aktuellen Anwendung verfügbar ist (true); andernfalls false (gleiche Version). |
path | Die nativePath-Eigenschaft des File-Objekts der Aktualisierung, die durch den airFile-Parameter in einem Aufruf der installFromAIRFile()-Methode festgelegt wurde. |
version | Zeigt die Version des neuen Updates an. |
initialized | Ereignis |
air.update.events.UpdateEventEigenschaft UpdateEvent.type =
air.update.events.UpdateEvent.INITIALIZED| Sprachversion: | ActionScript 3.0 |
| Laufzeitversionen: | AIR 1.5 |
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; andernfallsfalse. -
previousVersion(String) Die vorherige Version der Anwendung vor der Aktualisierung (nur festgelegt, wennisfirstRuntrueist). -
currentVersion(String) Die Version von der Anwendungsdeskriptordatei der aktuell installierten Version.
UpdateEvent.INITIALIZED-Konstante definiert den Wert der type-Eigenschaft des Ereignisobjekts für ein initialized-Ereignis.
Dieses Ereignis verfügt über die folgenden Eigenschaften:
| Eigenschaft | Wert |
|---|---|
bubbles | false |
cancelable | false. Es gibt kein Standardverhalten, das abgebrochen werden kann. |
currentTarget | Das Objekt, welches das Ereignisobjekt aktiv mit einem Ereignis-Listener verarbeitet. |
target | Das Updaterobjekt. |
progress | Ereignis |
flash.events.ProgressEventEigenschaft ProgressEvent.type =
flash.events.ProgressEvent.PROGRESS| Sprachversion: | ActionScript 3.0 |
| Laufzeitversionen: | AIR 1.5 |
Wird abgesetzt, wenn die Updatedatei heruntergeladen wird.
Definiert den Wert der Eigenschafttype eines progress-Ereignisobjekts.
Dieses Ereignis verfügt über die folgenden Eigenschaften:
| Eigenschaft | Wert |
|---|---|
bubbles | false |
bytesLoaded | Die Anzahl der geladenen Elemente oder Byte zu dem Zeitpunkt, zu dem der Listener das Ereignis verarbeitet. |
bytesTotal | Die Gesamtanzahl der Elemente oder Byte, die bei einem erfolgreichen Ladevorgang schließlich geladen werden. |
cancelable | false. Es gibt kein Standardverhalten, das abgebrochen werden kann. |
currentTarget | Das Objekt, welches das Ereignisobjekt aktiv mit einem Ereignis-Listener verarbeitet. |
target | Das Objekt, dessen Fortschritt protokolliert wird. |
updateError | Ereignis |
air.update.events.StatusUpdateErrorEventEigenschaft StatusUpdateErrorEvent.type =
air.update.events.StatusUpdateErrorEvent.UPDATE_ERROR| Sprachversion: | ActionScript 3.0 |
| Laufzeitversionen: | AIR 1.5 |
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.
StatusUpdateErrorEvent.UPDATE_ERROR-Konstante definiert den Wert der type-Eigenschaft des Ereignisobjekts für ein statusUpdateError-Ereignis.
updateStatus | Ereignis |
air.update.events.StatusUpdateEventEigenschaft StatusUpdateEvent.type =
air.update.events.StatusUpdateEvent.UPDATE_STATUS| Sprachversion: | ActionScript 3.0 |
| Laufzeitversionen: | AIR 1.5 |
Wird ausgelöst, nachdem der Updater die Updatedeskriptordatei erfolgreich heruntergeladen und interpretiert hat.
DieStatusUpdateEvent.UPDATE_STATUS-Konstante definiert den Wert der type-Eigenschaft des Ereignisobjekts für ein updateStatus-Ereignis.
Dieses Ereignis verfügt über die folgenden Eigenschaften:
| Eigenschaft | Wert |
|---|---|
available | Als true festgelegt, wenn die Updatedeskriptordatei eine Version festlegt, die sich von der Version der aktuellen Anwendung unterscheidet; andernfalls false (die Version ist gleich). |
version | Der String, der die neue verfügbare Version repräsentiert. |
details | Ein Array, das den details-String für jede unterstützte Sprache definiert. Wenn keine lokalisierte Beschreibung vorhanden ist, wird es als ein Array definiert, in dem das erste Element ein leerer String ("") und das zweite Element der details-String ist. Wenn lokalisierte Beschreibungen vorhanden sind, ist jedes Element im Array ein eigenes Array mit zwei Elementen. Das erste Element ist der Gebietsschema-Code und das zweite ist die Beschreibung. Beispiel: Das folgende Array hat untergeordnete Arrays für zwei Sprachen (US-Englisch und Französisch): ["en-US", "Hello World"], ["fr", "Bonjour monde"]. Die Sprachen werden in der gleichen Reihenfolge wie im Updatedeskriptor aufgelistet. Der Text der details-Eigenschaft wird in der Update-Deskriptordatei angegeben. |
versionLabel | (AIR 2.5+) Die Versionsbezeichnung aus dem Anwendungsdeskriptor des Updates. Die Versionsbezeichnung sollte dem Benutzer anstatt „Version“ angezeigt werden. Wenn keine Versionsbezeichnung angegeben wird, ist die Eigenschaft ein leerer String. |
Tue Jun 12 2018, 10:04 AM Z