Temel örnek: ApplicationUpdaterUI sürümünü kullanma

Güncelleme çerçevesinin ApplicationUpdaterUI sürümü, uygulamanızda kolayca kullanabileceğiniz basit bir arabirim sunar. Aşağıdaki, temel bir örnektir.

Önce, güncelleme çerçevesini çağıran bir AIR uygulaması oluşturun:

  1. Uygulamanız HTML tabanlı bir AIR uygulamasıysa, applicationupdaterui.swf dosyasını yükleyin: 

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

  2. AIR uygulama program mantığınızda, bir ApplicationUpdaterUI nesnesini başlatın.

    ActionScript'te şu kodu kullanın: 

    var appUpdater:ApplicationUpdaterUI = new ApplicationUpdaterUI();

    JavaScript'te şu kodu kullanın: 

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

    Bu kodu uygulama yüklendiğinde yürütülen bir başlatma işlevine eklemek isteyebilirsiniz.

  3. updateConfig.xml adlı bir metin dosyası oluşturun ve bu dosyaya aşağıdakini ekleyin: 

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

    updateConfig.xml dosyasının URL öğesini web sunucunuzdaki güncelleme tanımlayıcı dosyasının son konumuyla eşleşecek biçimde düzenleyin. (Sonraki yordama bakın.)

    delay , uygulamanın kontroller ve güncellemeler arasında beklediği gün sayısıdır.

  4. updateConfig.xml dosyasını AIR uygulamanızın proje dizinine ekleyin.

  5. Updater nesnesinin updateConfig.xml dosyasına başvurmasını sağlayın ve nesnenin initialize() yöntemini çağırın.

    ActionScript'te şu kodu kullanın: 
    appUpdater.configurationFile = new File("app:/updateConfig.xml"); 
appUpdater.initialize();
    JavaScript'te şu kodu kullanın: 
    appUpdater.configurationFile = new air.File("app:/updateConfig.xml"); 
appUpdater.initialize();

  6. İlk uygulamadan farklı bir sürüme sahip olan AIR uygulamasının ikinci sürümünü oluşturun. (Sürüm, uygulama tanımlayıcı dosyasında, version öğesinde belirtilmiştir.)

Daha sonra, AIR uygulamasının güncelleme sürümünü web sunucunuza ekleyin:

  1. AIR dosyasının güncelleme sürümünü web sunucunuza yerleştirin.

  2. updateDescriptor.2.5.xml adlı bir metin dosyası oluşturun ve bu dosyaya aşağıdakileri ekleyin: 

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

    updateDescriptor.xml dosyasının versionNumber , URL ve description öğelerini güncelleme AIR dosyanızla eşleşecek biçimde düzenleyin. Bu güncelleme tanımlayıcısı biçimi, AIR 2.5 SDK'ye (veya üstüne) dahil olan güncelleme çerçevesini kullanan uygulamalar tarafından kullanılır.

  3. updateDescriptor.1.0.xml adlı bir metin dosyası oluşturun ve bu dosyaya aşağıdakileri ekleyin: 

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

    updateDescriptor.xml dosyasının version , URL ve description öğelerini güncelleme AIR dosyanızla eşleşecek biçimde düzenleyin. Bu güncelleme tanımlayıcısı biçimi, AIR 2 SDK'ye (veya önceki sürümlere) dahil olan güncelleme çerçevesini kullanan uygulamalar tarafından kullanılır.

    Not: Bu ikinci güncelleme tanımlayıcısı dosyasının oluşturulması, yalnızca AIR 2.5'ten önce oluşturulmuş uygulamalar için güncelleme destekliyorsanız gereklidir.

  4. updateDescriptor.2.5.xml ve updateDescriptor.1.0.xml dosyasını, güncelleme AIR dosyasını içeren aynı web sunucusu dizinine ekleyin.

Bu temel bir örnektir, ancak çoğu uygulama için yeterli olan güncelleme işlevlerini sağlar. Bu belgenin devamı, güncelleme çerçevesini ihtiyaçlarınıza en uygun şekilde nasıl kullanabileceğinizi açıklar.

Güncelleme çerçevesinin başka bir örneği için, Adobe AIR geliştirici merkezinde aşağıdaki örnek uygulamaya bakın: