Prosty przykład: korzystanie z wersji ApplicationUpdaterUI

Wersja architektury aktualizacji zapisana w pliku ApplicationUpdaterUI udostępnia prosty interfejs, który łatwo można włączyć do własnych aplikacji. Poniżej przedstawiono prosty przykład.

Najpierw tworzymy aplikację AIR, która wywołuje architekturę aktualizacji:

  1. Jeśli aplikacja AIR jest oparta na języku HTML, należy wczytać plik applicationupdater_ui.swf. 

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

  2. W logice programowej aplikacji AIR tworzymy instancję obiektu ApplicationUpdaterUI.

    W języku ActionScript należałoby użyć następującego kodu: 

    var appUpdater:ApplicationUpdaterUI = new ApplicationUpdaterUI();

    W języku JavaScript należałoby użyć następującego kodu: 

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

    Celowe może być dodanie tego kodu do funkcji inicjującej, wykonywanej po załadowaniu aplikacji.

  3. Tworzymy plik tekstowy o nazwie updateConfig.xml i dodajemy do niego następujący kod: 

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

    Modyfikujemy element URL pliku updateConfig.xml w taki sposób, aby wskazywał docelową lokalizację pliku deskryptora aktualizacji na serwerze WWW (patrz następna procedura).

    Wartość delay to liczba dni, co jaką aplikacja sprawdza dostępność aktualizacji.

  4. Dodajemy plik updateConfig.xml file do katalogu projektu aplikacji AIR.

  5. Powodujemy, że obiekt Updater odwołuje się do pliku updateConfig.xml, i wywołujemy metodę initialize() obiektu.

    W języku ActionScript należałoby użyć następującego kodu: 
    appUpdater.configurationFile = new File("app:/updateConfig.xml"); 
appUpdater.initialize();
    W języku JavaScript należałoby użyć następującego kodu: 
    appUpdater.configurationFile = new air.File("app:/updateConfig.xml"); 
appUpdater.initialize();

  6. Tworzymy drugą wersję aplikacji AIR, o innym numerze niż pierwsza aplikacja. (Wersja jest podana w pliku deskryptora, w elemencie version ).

Następnie dodajemy zaktualizowaną wersję aplikacji AIR na serwer WWW:

  1. Umieszczamy pliku AIR wersji zaktualizowanej na serwerze WWW.

  2. Należy utworzyć plik tekstowy o nazwie updateDescriptor.2.5.xml i dodać do niego następującą treść: 

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

    Należy edytować elementy versionNumber , URL i description pliku updateDescriptor.xml w taki sposób, aby odpowiadały plikowi AIR aktualizacji. Ten format deskryptora aktualizacji jest używany przez aplikacje korzystające z infrastruktury aktualizacji dołączonej do zestawu SDK środowiska AIR 2.5 i nowszych wersji.

  3. Należy utworzyć plik tekstowy o nazwie updateDescriptor.1.0.xml i dodać do niego następującą treść: 

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

    Należy edytować elementy version , URL i description pliku updateDescriptor.xml w taki sposób, aby wskazywały na plik AIR aktualizacji. Ten format deskryptora aktualizacji jest używany przez aplikacje korzystające z infrastruktury aktualizacji dołączonej do zestawu SDK środowiska AIR 2 i starszych wersji.

    Uwaga: Utworzenie drugiego z podanych plików deskryptora aktualizacji jest konieczne tylko w przypadku obsługi aktualizacji aplikacji opracowanych dla środowiska AIR w wersji starszej niż 2.5.

  4. Należy dodać pliki updateDescriptor.2.5.xml i updateDescriptor.1.0.xml do tego samego katalogu serwera internetowego, który zawiera plik AIR aktualizacji.

Choć jest to prosty przykład, zapewnia on funkcjonalność aktualizacji wystarczającą w wielu zastosowaniach. W pozostałej części tego dokumentu opisano sposoby wykorzystania architektury aktualizacji odpowiednio do indywidualnych potrzeb.

Dodatkowe przykłady użycia architektury aktualizacji zawiera następująca aplikacja w serwisie Centrum programowania Adobe AIR: