Definieren der Updatedeskriptordateien und Hinzufügen der AIR-Datei zum Webserver

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.