ActionScript® 3.0 Referenzhandbuch für die Adobe® Flash®-Plattform
Home  |  Liste der Pakete und Klassen ausblenden |  Pakete  |  Klassen  |  Neue Funktionen  |  Stichwortverzeichnis  |  Anhänge  |  Warum auf Englisch?
Filter: Daten werden vom Server abgerufen...
Daten werden vom Server abgerufen...
air.update 

ApplicationUpdater  - AS3

Paketair.update
Klassepublic class ApplicationUpdater
VererbungApplicationUpdater Inheritance EventDispatcher Inheritance Object

Sprachversion: ActionScript 3.0
Laufzeitversionen: AIR 1.5

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

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.

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.

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



Öffentliche Eigenschaften
 EigenschaftDefiniert von
      configurationFile : File
Der Speicherort der Konfigurationsdatei, die die Werte für die delay- und updateURL-Eigenschaften festlegt.
ApplicationUpdater
 Inheritedconstructor : Object
Ein Verweis auf das Klassenobjekt oder die Konstruktorfunktion für eine angegebene Objektinstanz.
Object
      currentState : String
[schreibgeschützt] Der interne Status des Updaters.
ApplicationUpdater
      currentVersion : String
[schreibgeschützt] Die aktuelle Version der Anwendung.
ApplicationUpdater
      delay : Number
Das Intervall in Tagen zwischen regelmäßigen Suchen nach neuen Updates.
ApplicationUpdater
      isFirstRun : Boolean
[schreibgeschützt] Gibt an, ob dies die erste Ausführung nach einer erfolgreichen Aktualisierung („true“) ist oder nicht („false“).
ApplicationUpdater
      isNewerVersionFunction : Function
Eine Funktion, die der Updater verwenden sollte, um Versionsvergleiche auszuführen.
ApplicationUpdater
      previousApplicationStorageDirectory : File
[schreibgeschützt] Der vorherige Speicherort des Anwendungsspeicherordners, falls er nach einer Aktualisierung geändert wurde.
ApplicationUpdater
      previousVersion : String
[schreibgeschützt] Die vorherige Version der Anwendung.
ApplicationUpdater
      updateDescriptor : XML
[schreibgeschützt] Der Inhalt der Updatedeskriptordatei, der von der Aktualisierungs-URL heruntergeladen wurde.
ApplicationUpdater
      updateURL : String
Der Speicherort der Updatedeskriptordatei.
ApplicationUpdater
      wasPendingUpdate : Boolean
[schreibgeschützt] Gibt an, ob es sich um eine verschobene Aktualisierung handelt, auch wenn sie nicht installiert werden konnte („true“); andernfalls „false“.
ApplicationUpdater
Öffentliche Methoden
 MethodeDefiniert von
  
Die Konstruktorfunktion.
ApplicationUpdater
 Inherited
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
  
    cancelUpdate():void
Bricht den Aktualisierungsvorgang ab.
ApplicationUpdater
  
Lädt die Updatedeskriptordatei asynchron herunter und interpretiert sie.
ApplicationUpdater
  
    checkNow():void
Startet den Aktualisierungsvorgang.
ApplicationUpdater
 Inherited
Sendet ein Ereignis in den Ereignisablauf.
EventDispatcher
  
Lädt die Updatedatei asynchron herunter.
ApplicationUpdater
 Inherited
Überprüft, ob das EventDispatcher-Objekt Listener für einen bestimmten Ereignistyp registriert hat.
EventDispatcher
 Inherited
Gibt an, ob für ein Objekt eine bestimmte Eigenschaft definiert wurde.
Object
  
    initialize():void
Initialisiert den Updater.
ApplicationUpdater
  
Startet den Aktualisierungsvorgang mithilfe einer lokalen AIR-Datei.
ApplicationUpdater
  
Installiert die Updatedatei.
ApplicationUpdater
 Inherited
Gibt an, ob eine Instanz der Object-Klasse in der Prototypkette des Objekts vorhanden ist, das als Parameter angegeben wurde.
Object
 Inherited
Gibt an, ob die angegebene Eigenschaft vorhanden ist und durchlaufen werden kann.
Object
 Inherited
removeEventListener(type:String, listener:Function, useCapture:Boolean = false):void
Entfernt einen Listener aus dem EventDispatcher-Objekt.
EventDispatcher
 Inherited
Legt die Verfügbarkeit einer dynamischen Eigenschaft für Schleifenoperationen fest.
Object
 Inherited
Gibt die Stringdarstellung dieses Objekts zurück, formatiert entsprechend den Konventionen des Gebietsschemas.
Object
 Inherited
Gibt das angegebene Objekt als String zurück.
Object
 Inherited
Gibt den Grundwert des angegebenen Objekts zurück.
Object
 Inherited
Überprüft, ob bei diesem EventDispatcher-Objekt oder bei einem seiner Vorgänger ein Ereignis-Listener für einen bestimmten Ereignistyp registriert ist.
EventDispatcher
Ereignisse
 Ereignis Übersicht Definiert von
 Inherited[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.ApplicationUpdater
  Wird vor dem Beginn des Aktualisierungsvorgangs ausgelöst, unmittelbar bevor der Updater versucht, die Updatedeskriptordatei herunterzuladen.ApplicationUpdater
 Inherited[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.ApplicationUpdater
  Wird ausgelöst, wenn ein Fehler bei der Verbindung oder dem Herunterladen der Updatedatei auftritt.ApplicationUpdater
  Wird ausgelöst, nachdem ein Aufruf der downloadUpdate()-Methode ausgeführt und die Verbindung zum Server hergestellt wurde.ApplicationUpdater
  
    error
Wird ausgelöst, wenn ein Fehler bei der Initialisierung oder während des Aktualisierungsvorgangs (bei einem unerwarteten Ereignis) auftritt.ApplicationUpdater
  Wird ausgelöst, wenn ein Fehler bei der Überprüfung der als airFile-Parameter übergebenen Datei in einem Aufruf der installFromAIRFile()-Methode auftritt.ApplicationUpdater
  Wird ausgelöst, nachdem der Updater erfolgreich die Datei im Aufruf der installFromAIRFile()-Methode überprüft hat.ApplicationUpdater
  
    initialized
Wird ausgelöst, nachdem die Initialisierung abgeschlossen ist.ApplicationUpdater
  
    progress
Wird abgesetzt, wenn die Updatedatei heruntergeladen wird.ApplicationUpdater
  
    updateError
Wird ausgelöst, wenn ein Fehler beim Versuch des Herunterladens oder Parsings der Updatedeskriptordatei auftritt.ApplicationUpdater
  
    updateStatus
Wird ausgelöst, nachdem der Updater die Updatedeskriptordatei erfolgreich heruntergeladen und interpretiert hat.ApplicationUpdater
Eigenschaftendetails
    

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



Implementierung
    public function get configurationFile():File
    public function set configurationFile(value:File):void

Verwandte API-Elemente

    

currentState

Eigenschaft 
currentState:String  [schreibgeschützt]

Sprachversion: ActionScript 3.0
Laufzeitversionen: AIR 1.5

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.



Implementierung
    public function get currentState():String
    

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. Sie können den Wert über diese Eigenschaft oder über die Konfigurationsdatei festlegen. Wenn der Wert mithilfe beider Methoden festgelegt ist, wird der durch diese Eigenschaft festgelegte Wert verwendet.

Der Standardwert ist 0.



Implementierung
    public function get delay():Number
    public function set delay(value:Number):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():Boolean

Verwandte API-Elemente

    

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):void

Beispiel  ( Verwendung dieses Beispiels )
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

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 nicht „null“, nur das Updaterobjekt löst ein updateStatus-Ereignis aus.



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):void
    

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():Boolean

Verwandte API-Elemente

Konstruktordetails
    

ApplicationUpdater

()Konstruktor
public function ApplicationUpdater()

Sprachversion: ActionScript 3.0
Laufzeitversionen: AIR 1.5

Die Konstruktorfunktion.

Methodendetails

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

()Methode 
public function checkForUpdate():void

Sprachversion: ActionScript 3.0
Laufzeitversionen: AIR 1.5

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.


Ereignisse
updateStatus:StatusUpdateEvent — Der Updater hat die Updatedeskriptordatei erfolgreich heruntergeladen und interpretiert.
 
updateError:StatusUpdateErrorEvent — Ein Fehler ist beim Versuch des Herunterladens oder Parsings der Updatedeskriptordatei aufgetreten.

    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:UpdateEvent — Wird unmittelbar vor Beginn des Aktualisierungsvorgangs ausgelöst.

    downloadUpdate

()Methode 
public function downloadUpdate():void

Sprachversion: ActionScript 3.0
Laufzeitversionen: AIR 1.5

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.


Ereignisse
downloadStart:UpdateEvent — Wird ausgelöst, nachdem die Verbindung zum Server hergestellt wurde.
 
progress:ProgressEvent — Wird ausgelöst, nachdem die Initialisierung abgeschlossen ist.
 
downloadError: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“).

    initialize

()Methode 
public function initialize():void

Sprachversion: ActionScript 3.0
Laufzeitversionen: AIR 1.5

Initialisiert den Updater. Das Aufrufen dieser Methode bewirkt Folgendes:

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

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

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

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


Ereignisse
initialized:UpdateEvent — Die Initialisierung ist abgeschlossen.
 
error:ErrorEvent — 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 Auswirkung, wenn ein Aktualisierungsvorgang ausgeführt wird (wenn der Status nicht "DOWNLOADED" ist).

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

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

Parameter

file:File — Die zu installierende AIR-Datei.


Ereignisse
fileUpdateStatus:StatusFileUpdateEvent — Wird ausgelöst, nachdem der Updater die AIR-Datei erfolgreich überprüft hat.
 
updateError:StatusFileUpdateErrorEvent — Wird ausgelöst, wenn ein Fehler beim Versuch des Parsings der Updatedeskriptordatei auftritt.

    installUpdate

()Methode 
public function installUpdate():void

Sprachversion: ActionScript 3.0
Laufzeitversionen: AIR 1.5

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

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

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


Ereignisse
beforeInstall:UpdateEvent — Wird 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.
Ereignisdetails
    

beforeInstall

Ereignis
Ereignisobjekttyp: air.update.events.UpdateEvent
Eigenschaft 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).

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

Die 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:

EigenschaftWert
bubblesfalse
cancelablefalse. Es gibt kein Standardverhalten, das abgebrochen werden kann.
currentTargetDas Objekt, welches das Ereignisobjekt aktiv mit einem Ereignis-Listener verarbeitet.
targetDas Updaterobjekt.
    

checkForUpdate

Ereignis  
Ereignisobjekttyp: air.update.events.UpdateEvent
Eigenschaft 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.

Die 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:

EigenschaftWert
bubblesfalse
cancelablefalse. Es gibt kein Standardverhalten, das abgebrochen werden kann.
currentTargetDas Objekt, welches das Ereignisobjekt aktiv mit einem Ereignis-Listener verarbeitet.
targetDas Updaterobjekt.
    

downloadComplete

Ereignis  
Ereignisobjekttyp: air.update.events.UpdateEvent
Eigenschaft 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.

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.

Die UpdateEvent.DOWNLOAD_COMPLETE-Konstante definiert den Wert der type-Eigenschaft des Ereignisobjekts für ein downloadComplete-Ereignis.

Dieses Ereignis verfügt über die folgenden Eigenschaften:

EigenschaftWert
bubblesfalse
cancelablefalse. Es gibt kein Standardverhalten, das abgebrochen werden kann.
currentTargetDas Objekt, welches das Ereignisobjekt aktiv mit einem Ereignis-Listener verarbeitet.
targetDas Updaterobjekt.
    

downloadError

Ereignis  
Ereignisobjekttyp: air.update.events.DownloadErrorEvent
Eigenschaft 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).

Die DownloadErrorEvent.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-FehlercodeBeschreibung
16800Tritt bei der Überprüfung der heruntergeladenen Updatedatei auf. Die subErrorID-Eigenschaft stellt möglicherweise zusätzliche Informationen bereit.
16801Ungültige Adobe AIR-Datei (application.xml fehlt).
16802Ungültige Adobe AIR-Datei (MIME-Typ fehlt).
16803Ungültige Adobe AIR-Datei (Format).
16804Ungültige Adobe AIR-Datei (ungültige Flags).
16805Ungültige Adobe AIR-Datei (unbekannte Komprimierung).
16806Ungültige Adobe AIR-Datei (ungültiger Dateiname).
16807Ungültige Adobe AIR-Datei (beschädigt).
16808Konfigurationsdatei nicht vorhanden.
16809Die updateURL-Eigenschaft ist nicht festgelegt.
16810Reserviert.
16811Ungültige Konfigurationsdatei (unbekannte Konfigurationsversion).
16812Ungültige Konfigurationsdatei (URL fehlt).
16813Ungültige Konfigurationsdatei (Verzögerungsformat).
16814Ungültige Konfigurationsdatei (ungültige defaultUI-Werte).
16815Ungültiger Updatedeskriptor (unbekannte Deskriptorversion).
16816Ungültiger Updatedeskriptor (Updateversion fehlt).
16817Ungültiger Updatedeskriptor (ungültige Beschreibung).
16818IO-Fehler beim Speichern von Daten auf eine Festplatte. Die subErrorID-Eigenschaft stellt möglicherweise mehr Informationen bereit.
16819Sicherheitsfehler beim Herunterladen. Die subErrorID-Eigenschaft stellt möglicherweise mehr Informationen bereit.
16820Ungültiger HTTP-Statuscode. Die subErrorID-Eigenschaft enthält möglicherweise den ungültigen Statuscode.
16821Reserviert.
16822E/A-Fehler beim Herunterladen. Die subErrorID-Eigenschaft stellt möglicherweise mehr Informationen bereit.
16823EOF-Fehler beim Speichern von Daten auf eine Festplatte. Die subErrorID-Eigenschaft stellt möglicherweise mehr Informationen bereit.
16824Ungültiger Updatedeskriptor. Die subErrorID-Eigenschaft stellt möglicherweise mehr Informationen bereit.
16825Die Updatedatei enthält eine Anwendung mit einer unterschiedlichen Anwendungs-ID.
16826Die Updatedatei enthält keine neuere Version der Anwendung.
16827Die in der Updatedatei enthaltene Version stimmt nicht mit der Version vom Updatedeskriptor überein.
16828Die Anwendung kann nicht aktualisiert werden, da sie normalerweise im AIR Debug Launcher (ADL) ausgeführt wird.
16829Fehlende Updatedatei bei der Installation.
    

downloadStart

Ereignis  
Ereignisobjekttyp: air.update.events.UpdateEvent
Eigenschaft 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.

Die 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:

EigenschaftWert
bubblesfalse
cancelablefalse. Es gibt kein Standardverhalten, das abgebrochen werden kann.
currentTargetDas Objekt, welches das Ereignisobjekt aktiv mit einem Ereignis-Listener verarbeitet.
targetDas Updaterobjekt.
    

error

Ereignis  
Ereignisobjekttyp: flash.events.ErrorEvent
Eigenschaft 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 Eigenschaft type eines error-Ereignisobjekts.

Dieses Ereignis verfügt über die folgenden Eigenschaften:

EigenschaftWert
bubblesfalse
cancelablefalse. Es gibt kein Standardverhalten, das abgebrochen werden kann.
currentTargetDas Objekt, welches das Ereignisobjekt aktiv mit einem Ereignis-Listener verarbeitet.
targetDas Objekt, bei dem der Netzwerkvorgang fehlschlägt.
textDer als Fehlermeldung anzuzeigende Text.
    

fileUpdateError

Ereignis  
Ereignisobjekttyp: air.update.events.StatusFileUpdateErrorEvent
Eigenschaft 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.

Die StatusUpdateErrorEvent.UPDATE_ERROR-Konstante definiert den Wert der type-Eigenschaft des Ereignisobjekts für ein statusUpdateError-Ereignis.
    

fileUpdateStatus

Ereignis  
Ereignisobjekttyp: air.update.events.StatusFileUpdateEvent
Eigenschaft 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.

Die 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:

EigenschaftWert
availableZeigt an, ob eine andere Version als die der aktuellen Anwendung verfügbar ist (true); andernfalls false (gleiche Version).
pathDie nativePath-Eigenschaft des File-Objekts der Aktualisierung, die durch den airFile-Parameter in einem Aufruf der installFromAIRFile()-Methode festgelegt wurde.
versionZeigt die Version des neuen Updates an.

    

initialized

Ereignis  
Ereignisobjekttyp: air.update.events.UpdateEvent
Eigenschaft UpdateEvent.type = air.update.events.UpdateEvent.INITIALIZED

Sprachversion: ActionScript 3.0
Laufzeitversionen: AIR 1.5

Wird ausgelöst, nachdem die Initialisierung abgeschlossen ist.

Die UpdateEvent.INITIALIZED-Konstante definiert den Wert der type-Eigenschaft des Ereignisobjekts für ein initialized-Ereignis.

Dieses Ereignis verfügt über die folgenden Eigenschaften:

EigenschaftWert
bubblesfalse
cancelablefalse. Es gibt kein Standardverhalten, das abgebrochen werden kann.
currentTargetDas Objekt, welches das Ereignisobjekt aktiv mit einem Ereignis-Listener verarbeitet.
targetDas Updaterobjekt.
    

progress

Ereignis  
Ereignisobjekttyp: flash.events.ProgressEvent
Eigenschaft 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 Eigenschaft type eines progress-Ereignisobjekts.

Dieses Ereignis verfügt über die folgenden Eigenschaften:

EigenschaftWert
bubblesfalse
bytesLoadedDie Anzahl der geladenen Elemente oder Byte zu dem Zeitpunkt, zu dem der Listener das Ereignis verarbeitet.
bytesTotalDie Gesamtanzahl der Elemente oder Byte, die bei einem erfolgreichen Ladevorgang schließlich geladen werden.
cancelablefalse. Es gibt kein Standardverhalten, das abgebrochen werden kann.
currentTargetDas Objekt, welches das Ereignisobjekt aktiv mit einem Ereignis-Listener verarbeitet.
targetDas Objekt, dessen Fortschritt protokolliert wird.
    

updateError

Ereignis  
Ereignisobjekttyp: air.update.events.StatusUpdateErrorEvent
Eigenschaft 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.

Die StatusUpdateErrorEvent.UPDATE_ERROR-Konstante definiert den Wert der type-Eigenschaft des Ereignisobjekts für ein statusUpdateError-Ereignis.
    

updateStatus

Ereignis  
Ereignisobjekttyp: air.update.events.StatusUpdateEvent
Eigenschaft 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.

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.

Die 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:

EigenschaftWert
availableAls true festgelegt, wenn die Updatedeskriptordatei eine Version festlegt, die sich von der Version der aktuellen Anwendung unterscheidet; andernfalls false (die Version ist gleich).
versionDer String, der die neue verfügbare Version repräsentiert.
detailsEin 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.




[ X ]Warum auf Englisch?
Inhalt des ActionScript 3.0-Referenzhandbuchs wird in englischer Sprache angezeigt

Nicht alle Teile des ActionScript 3.0-Referenzhandbuchs wurden in alle Sprachen übersetzt. Wenn der Text zu einem Sprachelement nicht übersetzt wurde, wird er auf Englisch angezeigt. Zum Beispiel wurden die Informationen zur ga.controls.HelpBox-Klasse nicht in andere Sprachen übersetzt. In der deutschen Version des Referenzhandbuchs erscheint der Abschnitt zur ga.controls.HelpBox-Klasse deshalb auf Englisch.