Aktualisieren von AIR-Anwendungen

Wenn die update()-Methode durch eine Anwendung in der Laufzeitumgebung aufgerufen wird, wird die Anwendung durch die Laufzeitumgebung geschlossen, und sie versucht anschließend, die neue Version anhand der AIR-Datei zu installieren. Die Laufzeitumgebung prüft, ob die in der AIR-Datei angegebenen Anwendungs- und Herausgeber-IDs mit denjenigen der Anwendung, die die update()-Methode aufruft, übereinstimmen. (Weitere Informationen zur Anwendungs-ID und Herausgeber-ID finden Sie unter AIR-Anwendungsdeskriptordateien.) Sie prüft auch, ob der version-String mit dem version-String, der an die update()-Methode übergeben wird, übereinstimmt. Bei erfolgreichem Abschluss der Installation wird die neue Version der Anwendung von der Laufzeitumgebung geöffnet. Andernfalls (falls die Installation nicht abgeschlossen werden kann) wird die vorhandene Version der Anwendung wieder geöffnet.

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 muss der Benutzer über Administratorberechtigungen verfügen.

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

Wenn Sie eine Anwendung mit ADL testen, führt der Aufruf der update()-Methode zu einem Laufzeitausnahmefehler.

Der·String,·der·als·version-Parameter·der·update()-Methode·angegeben·ist,·muss·mit·dem·String·im·version-·oder·versionnumber-Attribut in der Anwendungsdeskriptordatei der zu installierenden AIR-Datei übereinstimmen. Aus Sicherheitsgründen ist die Angabe des version-Parameters erforderlich. Da die Anwendung die Versionsnummer in der AIR-Datei überprüfen muss, wird ausgeschlossen, dass die Anwendung versehentlich eine ältere Version installiert. (Eine ältere Version der Anwendung enthält möglicherweise Sicherheitsschwachstellen, die in der derzeit installierten Anwendung behoben wurden.) Außerdem sollte der version-String in der AIR-Datei mit dem version-String in der installierten Anwendung verglichen werden, um Downgrade-Angriffe zu verhindern.

In Versionen vor AIR 2.5 kann der Versionsstring ein beliebiges Format haben, wie etwa „2.01“ oder „Version 2“. In AIR 2.5 oder höher muss der Versionsstring eine Folge von bis zu drei dreistelligen Zahlen sein, die durch Punkte getrennt sind. So sind zum Beispiel „.0“, „1.0“ und „67.89.999“ gültige Versionsnummern. Vor dem Aktualisieren der Anwendung sollten Sie den Updateversionsstring validieren.

Wenn eine Adobe AIR-Anwendung eine AIR-Datei vom Internet herunterlädt, empfiehlt es sich, einen Mechanismus zu bieten, mit dem der Webservice der Adobe AIR-Anwendung die Version der heruntergeladenen Datei mitteilen kann. Anschließend kann die Anwendung diesen String als version-Parameter der update()-Methode verwenden. Wird die AIR-Datei auf andere Weise abgerufen, sodass die Version der AIR-Datei unbekannt ist, kann die AIR-Anwendung durch eine Überprüfung der AIR-Datei die Versionsinformationen feststellen. (Bei einer AIR-Datei handelt es sich um ein ZIP-komprimiertes Archiv und bei der Anwendungsdeskriptordatei um den zweiten Datensatz in diesem Archiv.)

Weitere Informationen zur Anwendungsdeskriptordatei finden Sie unter AIR-Anwendungsdeskriptordateien.

Das Veröffentlichen von Updates in Ad-hoc-Weise kompliziert die Verwaltung mehrerer Anwendungsversionen und erschwert das Verfolgen von Zertifikatablaufdaten. Möglicherweise laufen Zertifikate ab, bevor Sie ein Update veröffentlichen.

Die Adobe AIR-Laufzeitumgebung behandelt ein Anwendungsupdate, das ohne Migrationssignatur veröffentlicht wird, als neue Anwendung. Benutzer müssen ihre aktuelle AIR-Anwendung deinstallieren, bevor sie das Anwendungsupdate installieren können.

Um dieses Problem zu lösen, laden Sie jede aktualisierte Anwendung mit dem neuesten Zertifikat an eine separate Bereitstellungs-URL hoch. Schließen Sie einen Mechanismus ein, der Sie daran erinnert, Migrationssignaturen anzuwenden, wenn der 180-Tage-Toleranzzeitraum für das Zertifikat begonnen hat. Weitere Informationen finden Sie unter Signieren einer aktualisierten Version einer AIR-Anwendung.

Informationen zum Anwenden von Signaturen finden Sie unter ADT-Befehle.

Führen Sie Folgendes aus, um das Anwenden von Migrationssignaturen zu vereinfachen:

• Laden Sie jede aktualisierte Anwendung auf eine separate Bereitstellungs-URL hoch.

• Laden Sie die Updatedeskriptor-XML-Datei und das neueste Zertifikat für das Update auf dieselbe URL hoch.

• Signieren Sie die aktualisierte Anwendung mit dem neuesten Zertifikat.

• Wenden Sie mit dem Zertifikat, das zum Signieren der vorherigen Version auf einer anderen URL verwendet wurde, eine Migrationssignatur auf die aktualisierte Anwendung an.

Das AIR-Updateframework ist im Verzeichnis „frameworks/libs/air“ des AIR 2 SDK enthalten. Es umfasst die folgenden Dateien:

• applicationupdater.swc – Definiert die grundlegenden Funktionen der Updatebibliothek zur Verwendung in ActionScript. Diese Version hat keine Benutzeroberfläche.

• applicationupdater.swf – Definiert die grundlegenden Funktionen der Updatebibliothek zur Verwendung in JavaScript. Diese Version hat keine Benutzeroberfläche.

• applicationupdater_ui.swc – Definiert eine Flex 4-Version der grundlegenden Funktionalität der Updatebibliothek einschließlich einer Benutzeroberfläche, mit der Ihre Anwendung Updateoptionen anzeigen kann.

• applicationupdater_ui.swf – Definiert eine JavaScript-Version der grundlegenden Funktionalität der Updatebibliothek einschließlich einer Benutzeroberfläche, mit der Ihre Anwendung Updateoptionen anzeigen kann.

Weitere Informationen finden Sie in den folgenden Abschnitten:

• Einrichten der Flex-Entwicklungsumgebung

• Einschließen von Frameworkdateien in eine HTML-basierte AIR-Anwendung

• Basisbeispiel – Verwenden der ApplicationUpdaterUI-Version

Die SWC-Dateien im Verzeichnis „frameworks/libs/air“ des AIR 2 SDK definieren Klassen, die Sie für die Entwicklung mit Flex und Flash verwenden können.

Um das Updateframework beim Kompilieren mit dem Flex-SDK zu verwenden, schließen Sie entweder die Datei „ApplicationUpdater.swc“ oder die Datei „ApplicationUpdater_UI.swc“ in den Aufruf des amxmlc-Compilers mit ein. Im folgenden Beispiel lädt der Compiler die Datei „ApplicationUpdater.swc“ in das Unterverzeichnis „lib“ des Flex SDK-Verzeichnisses:

amxmlc -library-path+=lib/ApplicationUpdater.swc  -- myApp.mxml

Im folgenden Beispiel lädt der Compiler die Datei „ApplicationUpdater_UI.swc“ in das Unterverzeichnis „lib“ des Flex SDK-Verzeichnisses:

amxmlc -library-path+=lib/ApplicationUpdater_UI.swc  -- myApp.mxml

Beim Entwickeln mit Flash Builder fügen Sie die SWC-Datei auf der Registerkarte „Library Path“ unter „Flex Build Path“ im Dialogfeld „Properties“ hinzu.

Achten Sie darauf, die SWC-Dateien in das Verzeichnis zu kopieren, auf das Sie im amxmlc-Compiler (bei Verwendung des Flex-SDK) oder in Flash Builder verweisen.

Das Verzeichnis „frameworks/html“ des Updateframeworks enthält die folgenden SWF-Dateien:

• applicationupdater.swf – Definiert die grundlegende Funktionalität der Updatebibliothek ohne Benutzeroberfläche

• applicationupdater_ui.swf – Definiert die grundlegende Funktionalität der Updatebibliothek einschließlich einer Benutzeroberfläche, mit der Ihre Anwendung Updateoptionen anzeigen kann

JavaScript-Code in AIR-Anwendungen kann in SWF-Dateien definierte Klassen verwenden.

Um das Update-Framework zu verwenden, schließen Sie die Datei „applicationupdater.swf“ bzw. die Datei „applicationupdater_ui.swf“ in das Anwendungsverzeichnis (oder ein Unterverzeichnis) ein. Schließen Sie dann in die HTML-Datei, die das Framework verwendet (im JavaScript-Code), ein script-Tag ein, das die Datei lädt:

<script src="applicationUpdater.swf" type="application/x-shockwave-flash"/>

Oder verwenden Sie dieses script-Tag, um die Datei „applicationupdater_ui.swf“ zu laden:

<script src="applicationupdater_ui.swf" type="application/x-shockwave-flash"/>

Die in diesen beiden Dateien definierte API wird im Rest des vorliegenden Dokuments beschrieben.

Die ApplicationUpdaterUI-Version des Updateframeworks bietet eine Basisoberfläche, die Sie unkompliziert in Ihrer Anwendung verwenden können. Nachstehend finden Sie ein grundlegendes Beispiel.

Erstellen Sie zunächst die AIR-Anwendung, die das Updateframework aufruft:

1. Wenn es sich bei Ihrer Anwendung um eine HTML-basierte AIR-Anwendung handelt, laden Sie die Datei „applicationupdaterui.swf“:

   <script src="ApplicationUpdater_UI.swf" type="application/x-shockwave-flash"/>

2. Instanziieren Sie im Programmcode der AIR-Anwendung ein ApplicationUpdaterUI-Objekt.

   Verwenden Sie in ActionScript den folgenden Code:

   var appUpdater:ApplicationUpdaterUI = new ApplicationUpdaterUI(); 

   Verwenden Sie in JavaScript den folgenden Code:

   var appUpdater = new runtime.air.update.ApplicationUpdaterUI(); 

   Sie können diesen Code einer Initialisierungsfunktion hinzufügen, die nach dem Laden der Anwendung ausgeführt wird.

3. Erstellen Sie eine Textdatei mit dem Namen „updateConfig.xml“ und fügen Sie ihr Folgendes hinzu:

   <?xml version="1.0" encoding="utf-8"?> 
   <configuration xmlns="http://ns.adobe.com/air/framework/update/configuration/1.0"> 
        <url>http://example.com/updates/update.xml</url> 
       <delay>1</delay> 
   </configuration>

   Bearbeiten Sie das URL-Element der Datei „updateConfig.xml“, sodass es dem Speicherort der Updatedeskriptordatei auf Ihrem Webserver entspricht (siehe nächstes Verfahren).

   Mit delay wird die Anzahl der Tage angegeben, nach denen die Anwendung nach Updates sucht.

4. Fügen Sie die Datei „updateConfig.xml“ dem Projektverzeichnis Ihrer AIR-Anwendung hinzu.

5. Legen Sie fest, dass das Updaterobjekt auf die Datei „updateConfig.xml“ verweist, und rufen Sie die initialize()-Methode des Objekts auf.

   Verwenden Sie in ActionScript den folgenden Code:

   appUpdater.configurationFile = new File("app:/updateConfig.xml"); 
   appUpdater.initialize();

   Verwenden Sie in JavaScript den folgenden Code:

   appUpdater.configurationFile = new air.File("app:/updateConfig.xml"); 
   appUpdater.initialize();

6. Erstellen Sie eine zweite Version der AIR-Anwendung, die eine andere Versionsnummer als die erste Anwendung hat. (Die Version wird in der Anwendungsdeskriptordatei im version-Element angegeben.)

Als Nächstes fügen Sie die Updateversion der AIR-Anwendung Ihrem Webserver hinzu:

1. Legen Sie die Updateversion der AIR-Datei auf dem Webserver ab.

2. Erstellen Sie eine Textdatei mit dem Namen „updateDescriptor.2.5.xml“ und fügen Sie ihr Folgendes hinzu:

   <?xml version="1.0" encoding="utf-8"?> 
        <update xmlns="http://ns.adobe.com/air/framework/update/description/2.5"> 
          <versionNumber>1.1</versionNumber> 
          <url>http://example.com/updates/sample_1.1.air</url> 
          <description>This is the latest version of the Sample application.</description> 
       </update>

   Bearbeiten Sie die Elemente versionNumber, URL und description der Datei „updateDescriptor.xml“, um sie an die AIR-Updatedatei anzupassen. Dieses Updatedeskriptorformat wird von Anwendungen verwendet, die mit dem Update-Framework, das im AIR 2.5 SDK (und höher) enthalten ist.

3. Erstellen Sie eine Textdatei mit dem Namen „updateDescriptor.1.0.xml“ und fügen Sie ihr Folgendes hinzu:

   <?xml version="1.0" encoding="utf-8"?> 
        <update xmlns="http://ns.adobe.com/air/framework/update/description/1.0"> 
          <version>1.1</version> 
          <url>http://example.com/updates/sample_1.1.air</url> 
          <description>This is the latest version of the Sample application.</description> 
       </update>

   Bearbeiten Sie die Elemente version, URL und description der Datei „updateDescriptor.xml“, um sie an die AIR-Updatedatei anzupassen. Dieses Updatedeskriptorformat wird von Anwendungen verwendet, die das im AIR 2 SDK enthaltene Update-Framework verwenden.

   Hinweis: Diese zweite Updatedeskriptordatei brauchen Sie nur dann zu erstellen, wenn Sie Updates von Anwendungen, die vor AIR 2.5. erstellt wurden, unterstützen.

4. Fügen Sie die Dateien „updateDescriptor.2.5.xml“ und „updateDescriptor.1.0.xml“ zu demselben Webserververzeichnis hinzu, das die AIR-Updatedatei enthält.

Dies ist ein Basisbeispiel, es bietet jedoch für viele Anwendungen ausreichende Updatefunktionalität. In den verbleibenden Abschnitten dieses Dokuments wird beschrieben, wie Sie das Updateframework am besten für Ihre Zwecke einsetzen können.

Ein weiteres Verwendungsbeispiel für das Updateframework finden Sie in den folgenden Beispielanwendungen im Adobe AIR Developer Center:

Da die Regeln für das Zuweisen von Anwendungsversionsnummern in AIR 2.5 geändert wurden, kann das Update-Framework von AIR 2 die Versionsinformationen in einem AIR 2.5-Anwendungsdeskriptor nicht analysieren. Wegen dieser Inkompatibilität müssen Sie Ihre Anwendung aktualisieren, damit sie das neue Update-Framework verwendet, BEVOR Sie die Anwendung auf die Verwendung des AIR 2.5 SDK aktualisieren. Somit sind für die Aktualisierung Ihrer Anwendung von einer beliebigen Version vor AIR 2.5 auf AIR 2.5 oder höher ZWEI Updates erforderlich. Das erste Update muss den AIR 2-Namespace verwenden und die AIR 2.5-Update-Frameworkbibliothek enthalten (Sie können das Anwendungspaket dennoch mit dem AIR 2.5 SDK erstellen). Das zweite Update kann den AIR 2.5-Namespace verwenden und die neuen Funktionen Ihrer Anwendung enthalten.

Es ist auch möglich, dass das Zwischenupdate abgesehen vom Aktualisieren der AIR 2.5-Anwendung direkt mit der AIR-Updater-Klasse nichts ausführt.

Das folgende Beispiel veranschaulicht das Aktualisieren einer Anwendung von Version 1.0 auf Version 2.0. Dabei verwendet Version 1.0 den alten 2.0-Namespace. Version 2.0 verwendet den 2.5-Namespace und weist neue Funktionen auf, die mit AIR 2.5 APIs implementiert wurden.

1. Erstellen Sie eine Zwischenversion der Anwendung, Version 1.0.1, die auf Version 1.0 der Anwendung basiert.

   1. Verwenden Sie beim Erstellen der Anwendung das Anwendungs-Update-Framework von AIR 2.5.

      Hinweis: Verwenden Sie applicationupdater.swc oder applicationupdater_ui.swc für AIR-Anwendungen, die auf Flash-Technologie basieren, und applicationupdater.swf oder applicationupdater_ui.swf für HTML-basierte AIR-Anwendungen.

   2. Erstellen Sie eine Updatedeskriptordatei für Version 1.0.1, indem Sie den alten Namespace und die alte Version verwenden, wie nachstehend beschrieben:

      <?xml version="1.0" encoding="utf-8"?> 
          <update xmlns="http://ns.adobe.com/air/framework/update/description/2.0"> 
              <version>1.0.1</version> 
              <url>http://example.com/updates/sample_1.0.1.air</url> 
              <description>This is the intermediate version.</description> 
          </update>

2. Erstellen Sie Version 2.0 der Anwendung, die AIR 2.5 APIs und den 2.5-Namespace verwendet.

3. Erstellen Sie einen Updatedeskriptor, um die Anwendung von Version 1.0.1 auf Version 2.0 zu aktualisieren.

<?xml version="1.0" encoding="utf-8"?> 
    <update xmlns="http://ns.adobe.com/air/framework/update/description/2.5"> 
        <version>2.0</version> 
        <url>http://example.com/updates/sample_2.0.air</url> 
        <description>This is the intermediate version.</description> 
    </update>

Wenn Sie das AIR-Updateframework verwenden, definieren Sie grundlegende Informationen über das gültige Update in Updatedeskriptordateien, die auf dem Webserver gespeichert werden. Eine Updatedeskriptordatei ist eine einfache XML-Datei. Das in der Anwendung enthaltene Updateframework überprüft diese Datei, um festzustellen, ob eine neue Version hochgeladen wurde.

Das Format der Updatedeskriptordatei wurde in AIR 2.5 geändert. Das neue Format verwendet einen anderen Namespace. Der ursprüngliche Namespace ist „http://ns.adobe.com/air/framework/update/description/1.0“. Der AIR 2.5-Namespace ist „http://ns.adobe.com/air/framework/update/description/2.5“.

AIR-Anwendungen, die vor AIR 2.5 erstellt wurden, können nur den Updatedeskriptor der Version 1.0 lesen. AIR-Anwendungen, die mit dem in AIR 2.5 oder höher erstellten Updater-Framework erstellt wurden, können nur den Updatedeskriptor der Version 2.5 lesen. Aufgrund dieser Versionsinkompatibilität müssen Sie häufig zwei Updatedeskriptordateien erstellen. Die Aktualisierungslogik in den AIR 2.5-Versionen Ihrer Anwendung muss einen Updatedeskriptor herunterladen, der das neue Format verwendet. Frühere Versionen Ihrer AIR-Anwendung müssen weiterhin das ursprüngliche Format verwenden. Beide Dateien müssen für jedes Update, das Sie veröffentlichen, geändert werden (bis Sie die Unterstützung von vor AIR 2.5. erstellten Versionen einstellen).

Die Updatedeskriptordatei enthält die folgenden Daten:

• versionNumber – Die neue Version der AIR-Anwendung. Verwenden Sie das versionNumber-Element in Updatedeskriptoren, die zum Aktualisieren von AIR 2.5-Anwendungen verwendet werden. Der Wert muss derselbe String sein, der im versionNumber-Element der neuen AIR-Anwendungsdeskriptordatei verwendet wird. Wenn die Versionsnummer in der Updatedeskriptordatei nicht mit der Versionsnummer in der AIR-Updatedatei übereinstimmt, gibt das Updateframework eine Ausnahme aus.

• version – Die neue Version der AIR-Anwendung. Verwenden Sie das version-Element in Updatedeskriptoren, die zum Aktualisieren von Anwendungen verwendet werden, die vor AIR 2.5 erstellt wurden. Der Wert muss derselbe String sein, der im version-Element der neuen AIR-Anwendungsdeskriptordatei verwendet wird. Wenn die Version in der Updatedeskriptordatei nicht mit der Version in der AIR-Updatedatei übereinstimmt, gibt das Updateframework eine Ausnahme aus.

• versionLabel – Die Klartextversion des Strings, die den Benutzern angezeigt werden soll. Das versionLabel-Element ist optional, kann aber nur in Updatedeskriptordateien der Version 2.5 angegeben werden. Verwenden Sie es, wenn Sie versionLabel im Anwendungsdeskriptor verwenden, und setzen Sie es auf denselben Wert.

• url – Der Speicherort der AIR-Updatedatei. Dies ist die Datei, die die aktualisierte Version der AIR-Anwendung enthält.

• description – Details zur neuen Version. Diese Informationen können dem Benutzer während des Updateprozesses angezeigt werden.

Die Elemente version und url sind obligatorisch. Das Element description ist optional.

Folgendes ist ein Beispiel einer Updatedeskriptordatei der Version 2.5:

<?xml version="1.0" encoding="utf-8"?> 
     <update xmlns="http://ns.adobe.com/air/framework/update/description/2.5"> 
       <versionNumber>1.1.1</versionNumber> 
       <url>http://example.com/updates/sample_1.1.1.air</url> 
       <description>This is the latest version of the Sample application.</description> 
    </update>

Folgendes ist ein Beispiel einer Updatedeskriptordatei der Version 1.0:

<?xml version="1.0" encoding="utf-8"?> 
     <update xmlns="http://ns.adobe.com/air/framework/update/description/1.0"> 
       <version>1.1.1</version> 
       <url>http://example.com/updates/sample_1.1.1.air</url> 
       <description>This is the latest version of the Sample application.</description> 
    </update>

Wenn Sie das description-Tag in mehreren Sprachen definieren möchten, verwenden Sie mehrere text-Elemente, die ein lang-Attribut definieren:

<?xml version="1.0" encoding="utf-8"?> 
     <update xmlns="http://ns.adobe.com/air/framework/update/description/2.5"> 
       <versionNumber>1.1.1</versionNumber> 
       <url>http://example.com/updates/sample_1.1.1.air</url> 
       <description> 
           <text xml:lang="en">English description</text> 
           <text xml:lang="fr">French description</text> 
           <text xml:lang="ro">Romanian description</text> 
       </description> 
    </update>

Legen Sie die Updatedeskriptordatei zusammen mit der AIR-Datei auf dem Webserver ab.

Das Vorlagenverzeichnis, das im Updatedeskriptor enthalten ist, enthält Beispiele für Updatedeskriptordateien. Diese enthalten sowohl ein- als auch mehrsprachige Versionen.

Nach dem Laden des AIR-Updateframeworks in den Code (siehe Einrichten der Flex-Entwicklungsumgebung und Einschließen von Frameworkdateien in eine HTML-basierte AIR-Anwendung) müssen Sie ein Updaterobjekt instanziieren, wie im folgenden Beispiel.

ActionScript-Beispiel:

var appUpdater:ApplicationUpdater = new ApplicationUpdater();

JavaScript-Beispiel:

var appUpdater = new runtime.air.update.ApplicationUpdater();

Im vorherigen Code wurde die ApplicationUpdater-Klasse, die keine Benutzeroberfläche zur Verfügung stellt, verwendet. Wenn Sie die ApplicationUpdaterUI-Klasse verwenden möchten, die eine Benutzeroberfläche bietet, verwenden Sie Folgendes.

ActionScript-Beispiel:

var appUpdater:ApplicationUpdaterUI = new ApplicationUpdaterUI();

JavaScript-Beispiel:

var appUpdater = new runtime.air.update.ApplicationUpdaterUI();

Bei den verbleibenden Codebeispielen in diesem Dokument wird davon ausgegangen, dass Sie ein Updaterobjekt mit dem Namen appUpdater instanziiert haben.

ApplicationUpdater und ApplicationUpdaterUI können beide über eine Konfigurationsdatei konfiguriert werden, die mit der Anwendung geliefert wird, oder über ActionScript oder JavaScript in der Anwendung.

Das AIR-Updateframework führt beim Updatevorgang die folgenden Schritte aus:

1. Bei der Updaterinitialisierung wird überprüft, ob innerhalb des definierten Zeitraums nach Updates gesucht wurde (siehe Konfigurieren der Updateeinstellungen). Wenn eine Suche nach Updates fällig ist, wird der Updateprozess fortgesetzt.

2. Der Updater lädt die Updatedeskriptordatei asynchron herunter und interpretiert sie.

3. Der Updater lädt die AIR-Updatedatei herunter.

4. Der Updater installiert die aktualisierte Version der Anwendung.

Das Updaterobjekt löst nach Abschluss der einzelnen Schritte Ereignisse aus. In der ApplicationUpdater-Version können Sie die Ereignisse abbrechen, die den erfolgreichen Abschluss eines Prozessschrittes anzeigen. Wenn Sie eines dieser Ereignisse abbrechen, wird der nächste Prozessschritt abgebrochen. In der ApplicationUpdaterUI-Version zeigt der Updater ein Dialogfeld an, das dem Benutzer bei jedem Prozessschritt die Möglichkeit zum Abbrechen oder Fortsetzen des Prozesses gibt.

Wenn Sie das Ereignis abbrechen, können Sie den Prozess durch den Aufruf von Methoden des Updaterobjekts fortsetzen.

Während die ApplicationUpdater-Version des Updaters den Updateprozess durchläuft, wird der aktuelle Status in einer currentState-Eigenschaft aufgezeichnet. Diese Eigenschaft ist auf einen String mit folgenden möglichen Werte festgelegt:

• "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 es gibt ausstehende Updates.

Einige Methoden des Updaterobjekts werden nur ausgeführt, wenn sich der Updater in einem bestimmten Status befindet.

Nach dem Einstellen der Konfigurationseigenschaften (siehe Basisbeispiel – Verwenden der ApplicationUpdaterUI-Version) rufen Sie die initialize()-Methode auf, um das Update zu initialisieren:

appUpdater.initialize();

Diese Methode führt Folgendes aus:

• Sie initialisiert das Updateframework, wobei ohne weitere Meldung synchron die ggf. ausstehenden Updates installiert werden. Es ist erforderlich, diese Methode beim Anwendungsstart aufzurufen, da sie die Anwendung beim Aufrufen möglicherweise neu startet.

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

• Wenn es beim Updateprozess zu einem Fehler kommt, löscht die Methode die Updatedatei und die Versionsinformationen aus dem Anwendungsspeicherbereich.

• Wenn die Verzögerung abgelaufen ist, wird der Updateprozess gestartet. Andernfalls wird der Timer neu gestartet.

Das Aufrufen diese Methode kann dazu führen, dass das Updaterobjekt die folgenden Ereignisse auslöst:

• UpdateEvent.INITIALIZED – Wird ausgelöst, wenn die Initialisierung abgeschlossen ist.

• ErrorEvent.ERROR – Wird ausgelöst, wenn es bei der Initialisierung zu einem Fehler kommt.

Beim Auslösen des UpdateEvent.INITIALIZED-Ereignisses ist der Updateprozess abgeschlossen.

Wenn Sie die initialize()-Methode aufrufen, beginnt der Updater mit dem Updateprozess und führt alle Schritte basierend auf der Verzögerungseinstellung des Timers aus. Sie können den Updateprozess aber jederzeit starten, indem Sie die checkNow()-Methode des Updaterobjekts aufrufen:

appUpdater.checkNow();

Diese Methode hat keine Auswirkungen, wenn der Updateprozess bereits ausgeführt wird. Andernfalls wird der Updateprozess gestartet.

Das Updaterobjekt kann das folgende Ereignis als Resultat des Aufrufs der checkNow()-Methode auslösen:

• UpdateEvent.CHECK_FOR_UPDATE, direkt vor dem Versuch, die Updatedeskriptordatei herunterzuladen.

Wenn Sie das checkForUpdate-Ereignis abbrechen, können Sie die checkForUpdate()-Methode des Updaterobjekts aufrufen. (Lesen Sie dazu den nächsten Abschnitt.) Wenn Sie das Ereignis nicht abbrechen, wird der Updateprozess fortgesetzt, um nach der Updatedeskriptordatei zu suchen.

In der ApplicationUpdaterUI-Version kann der Benutzer den Prozess über die Schaltfläche „Abbrechen“ in den Dialogfeldern der Benutzeroberfläche abbrechen. Außerdem lässt sich der Updateprozess programmgesteuert abbrechen, indem die cancelUpdate()-Methode des ApplicationUpdaterUI-Objekts aufgerufen wird.

Sie können die Eigenschaften des ApplicationUpdaterUI-Objekts festlegen oder Elemente in der Updatekonfigurationsdatei definieren, um anzugeben, welche Dialogfeldbestätigungen vom Updater angezeigt werden. Weitere Informationen finden Sie unter Konfigurieren der Updateeinstellungen.

Sie können die preventDefault()-Methode von Ereignisobjekten aufrufen, die vom ApplicationUpdater-Objekt ausgelöst werden, um Schritte des Updateprozesses abzubrechen (siehe Der Updateprozess). Das Abbrechen des Standardverhaltens gibt der Anwendung die Möglichkeit, den Benutzer in einer Meldung zu fragen, ob der Vorgang fortgesetzt werden soll.

In den folgenden Abschnitten wird beschrieben, wie Sie den Updateprozess nach Abbruch eines Prozessschrittes fortsetzen.

Sie können die installFromAIRFile()-Methode aufrufen, um die Updateversion von einer AIR-Datei auf dem Computer des Benutzers zu installieren:

appUpdater.installFromAIRFile();

Mit dieser Methode installiert der Updater eine Updateversion der Anwendung aus der AIR-Datei.

Die installFromAIRFile()-Methode kann die folgenden Ereignisse auslösen:

• StatusFileUpdateEvent.FILE_UPDATE_STATUS – Wird ausgelöst, nachdem der ApplicationUpdater die mit der installFromAIRFile()-Methode gesendete Datei erfolgreich validiert hat. Dieses Ereignis verfügt über die folgenden Eigenschaften:

  • available – Die Eigenschaft hat den Wert true, wenn eine andere Version verfügbar ist als die der aktuellen Anwendung; andernfalls (wenn die Versionen identisch sind) hat sie den Wert false.

  • version – Der String, der die neue verfügbare Version darstellt.

  • path – Repräsentiert den nativen Pfad der Updatedatei.

  Sie können dieses Ereignis abbrechen, wenn die available-Eigenschaft des StatusFileUpdateEvent-Objekts den Wert true hat. Das Abbrechen dieses Ereignisses führt dazu, dass das Update nicht fortgesetzt wird. Rufen Sie die installUpdate()-Methode auf, um das abgebrochene Update fortzusetzen.

• StatusFileUpdateErrorEvent.FILE_UPDATE_ERROR – Es ist ein Fehler aufgetreten und der Updater konnte die AIR-Anwendung nicht installieren.

Sie können die cancelUpdate()-Methode aufrufen, um den Updateprozess abzubrechen:

appUpdater.cancelUpdate();

Mit dieser Methode werden alle ausstehenden Downloads abgebrochen, unvollständig heruntergeladene Dateien werden gelöscht und der Timer für die regelmäßige Suche nach Updates wird zurückgesetzt.

Die Methode hat keine Auswirkungen, wenn das Updaterobjekt initialisiert wird.

Die ApplicationUpdaterUI-Klasse stellt eine Standardbenutzeroberfläche für den Updateprozess bereit. Dazu gehören Dialogfelder, in denen der Benutzer den Prozess starten oder abbrechen und ähnliche Aktionen ausführen kann.

Mit dem description-Element der Updatedeskriptordatei können Sie die Beschreibung der Anwendung in mehreren Sprachen definieren. Verwenden Sie mehrere text-Elemente, die lang-Attribute definieren, wie im Folgenden:

<?xml version="1.0" encoding="utf-8"?> 
     <update xmlns="http://ns.adobe.com/air/framework/update/description/1.0"> 
       <version>1.1a1</version> 
       <url>http://example.com/updates/sample_1.1a1.air</url> 
       <description> 
           <text xml:lang="en">English description</text> 
           <text xml:lang="fr">French description</text> 
           <text xml:lang="ro">Romanian description</text> 
       </description> 
    </update>

Das Updateframework verwendet die Beschreibung, die am besten zum Gebietsschema des Endbenutzers passt. Weitere Informationen finden Sie unter „Definieren der Updatedeskriptordatei und Hinzufügen der AIR-Datei zum Webserver“.

Flex-Entwickler können eine neue Sprache direkt zum "ApplicationUpdaterDialogs"-Bundle hinzufügen.

JavaScript-Entwickler können die addResources()-Methode des Updaterobjekts aufrufen. Diese Methode fügt dynamisch ein neues Ressourcen-Bundle für eine Sprache hinzu. Das Ressourcen-Bundle definiert lokalisierte Strings für eine Sprache. Diese Strings werden in verschiedenen Textfeldern in Dialogfeldern verwendet.

JavaScript-Entwickler können die localeChain-Eigenschaft der ApplicationUpdaterUI-Klasse verwenden, um die von der Benutzeroberfläche verwendeten Gebietsschemaeinstellungen zu definieren. Normalerweise verwenden nur Entwickler, die mit JavaScript (HTML) arbeiten, diese Eigenschaft. Flex-Entwickler können die Gebietsschemaeinstellungen mit dem ResourceManager verwalten.

Im folgenden JavaScript-Code werden zum Beispiel Ressourcen-Bundle für Rumänisch und Ungarisch definiert:

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;

Weitere Informationen finden Sie unter der Beschreibung der addResources()-Methode der ApplicationUpdaterUI-Klasse im Referenzhandbuch.