Definiowanie plików deskryptora aktualizacji i dodawanie pliku AIR do serwera internetowego

Podczas pracy z infrastrukturą aktualizacji środowiska AIR należy zdefiniować podstawowe informacje o dostępnej aktualizacji w plikach deskryptora aktualizacji przechowywanych na serwerze internetowym. Plik deskryptora aktualizacji jest prostym plikiem XML. Infrastruktura aktualizacji dołączona do aplikacji sprawdza zawartość tego pliku, aby stwierdzić, czy na serwerze została umieszczona nowa wersja.

Format pliku deskryptora aktualizacji uległ zmianie w środowisku AIR 2.5. W nowym formacie jest używana inna przestrzeń nazw. Oryginalna przestrzeń nazw to „http://ns.adobe.com/air/framework/update/description/1.0”. Przestrzeń nazw środowiska AIR 2.5 to „http://ns.adobe.com/air/framework/update/description/2.5”.

Aplikacje AIR utworzone dla wersji środowiska AIR starszych niż 2.5 mogą odczytywać tylko deskryptor aktualizacji dotyczący wersji 1.0. Aplikacje AIR utworzone za pomocą infrastruktury aktualizacji zawartej w środowisku AIR 2.5 lub nowszym mogą odczytywać tylko deskryptor aktualizacji dotyczący wersji 2.5. Z powodu tej niezgodności wersji często trzeba tworzyć dwa pliki deskryptora aktualizacji. Logika obsługująca aktualizowanie w wersjach aplikacji dla środowiska AIR 2.5 musi pobierać deskryptor aktualizacji korzystający z nowego formatu. Starsze wersje aplikacji AIR muszą nadal korzystać z oryginalnego formatu. Dla każdej wydanej aktualizacji należy zmodyfikować oba pliki (do czasu zakończenia obsługi wersji utworzonych dla wersji środowiska AIR starszych niż 2.5).

Plik deskryptora aktualizacji zawiera następujące dane:

  • versionNumber — nowa wersja aplikacji AIR. Element versionNumber należy stosować w deskryptorach aktualizacji używanych do aktualizowania aplikacji AIR 2.5. Podana wartość musi być taka sama jak ciąg znaków użyty w elemencie versionNumber w nowym pliku deskryptora aplikacji AIR. Jeśli numer wersji w pliku deskryptora aktualizacji nie jest zgodny z numerem wersji pliku AIR aktualizacji, infrastruktura aktualizacji generuje wyjątek.

  • version — nowa wersja aplikacji AIR. Element version należy stosować w deskryptorach aktualizacji używanych do aktualizowania aplikacji utworzonych dla wersji środowiska AIR starszych niż 2.5. Podana wartość musi być taka sama jak ciąg znaków użyty w elemencie version w nowym pliku deskryptora aplikacji AIR. Jeśli wersja w pliku deskryptora aktualizacji nie jest zgodna z wersją pliku AIR aktualizacji, infrastruktura aktualizacji generuje wyjątek.

  • versionLabel — ciąg znaków w postaci czytelnej dla człowieka, przeznaczony do wyświetlania dla użytkowników. Element versionLabel jest opcjonalny, ale można go określać tylko w plikach deskryptora aktualizacji w wersji 2.5. Ten element należy stosować, jeśli w pliku deskryptora aplikacji jest używany element versionLabel . (Dla obu elementów należy ustawić tę samą wartość).

  • url — lokalizacja pliku AIR aktualizacji. Jest to plik zawierający zaktualizowaną wersję aplikacji AIR.

  • description — opis nowej wersji. Te informacje mogą być wyświetlane dla użytkownika podczas aktualizacji.

Elementy version i url są wymagane. Element description jest opcjonalny.

Oto przykładowy plik deskryptora aktualizacji dla wersji 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>

Oto przykładowy plik deskryptora aktualizacji dla wersji 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>

Aby zdefiniować znacznik description w wielu językach, należy zastosować wiele elementów text definiujących atrybut lang : 

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

Umieszczamy plik deskryptora aktualizacji wraz z plikiem AIR aktualizacji na serwerze WWW.

Katalog templates dołączony do deskryptora aktualizacji zawiera przykładowe pliki deskryptorów aktualizacji. Zawierają one wersje w jednym języku oraz wersje wielojęzyczne.