Güncelleme tanımlayıcı dosyalarını tanımlama ve AIR dosyasını web sunucunuza ekleme

AIR güncelleme çerçevesini kullandığınızda, web sunucunuzda saklanan güncelleme tanımlayıcı dosyalarında bulunan güncelleme hakkında temel bilgileri tanımlarsınız. Güncelleme tanımlayıcı dosyası, basit bir XML dosyasıdır. Uygulamada yer alan güncelleme çerçevesi, yeni bir sürümün yüklenip yüklenmediğini görmek için bu dosyayı kontrol eder.

Güncelleme tanımlayıcı dosyasının biçimi AIR 2.5 için değişmiştir. Yeni biçim farklı bir ad alanı kullanır. Orijinal ad alanı“http://ns.adobe.com/air/framework/update/description/1.0” şeklindeydi. AIR 2.5 ad alanı“http://ns.adobe.com/air/framework/update/description/2.5” şeklindedir.

AIR 2.5'ten önce oluşturulmuş AIR uygulamaları yalnızca sürüm 1.0 güncelleme tanımlayıcısını okuyabilir. AIR 2.5 veya sonraki sürümlere dahil güncelleyici çerçevesi kullanılarak oluşturulmuş AIR uygulamaları yalnızca sürüm 2.5 güncelleme tanımlayıcısını okuyabilir. Bu sürüm uyumsuzluğu nedeniyle genellikle iki güncelleme tanımlayıcı dosyası oluşturmanız gerekir. Uygulamanızın AIR 2.5 sürümlerindeki güncelleme mantığı yeni biçimi kullanan bir güncelleme tanımlayıcısını indirmelidir. AIR uygulamanızın önceki sürümleri aynı biçimi kullanmaya devam etmelidir. İki dosya da yayınladığınız her güncelleme için değiştirilmelidir (siz AIR 2.5'ten önce oluşturulan sürümleri desteklemeyi durdurana kadar)

Güncelleme tanımlayıcı dosyası aşağıdaki verileri içerir:

  • versionNumber —AIR uygulamasının yeni sürümü. versionNumber öğesini AIR 2.5 uygulamalarını güncellemek için kullanılan güncelleme tanımlayıcılarında kullanın. Değer yeni AIR uygulama tanımlayıcı dosyasının versionNumber öğesinde kullanılanla aynı dize olmalıdır. Güncelleme tanımlayıcı dosyasının sürüm numarası, güncelleme AIR dosyasının sürümü numarasıyla eşleşmiyorsa, güncelleme çerçevesi istisna verir.

  • version —AIR uygulamasının yeni sürümü. AIR 2.5'ten önce oluşturulmuş uygulamaları güncellemek için kullanılan uygulama tanımlayıcılarda version öğesini kullanın. Değer yeni AIR uygulama tanımlayıcı dosyasının version öğesinde kullanılanla aynı dize olmalıdır. Güncelleme tanımlayıcı dosyasının sürümü, güncelleme AIR dosyasının sürümüyle eşleşmiyorsa, güncelleme çerçevesi istisna verir.

  • versionLabel —Kullanıcılara gösterilmesi planlanan kişiler tarafından okunabilen sürüm dizesi. versionLabel isteğe bağlıdır, ancak yalnızca 2.5 sürümü güncelleme tanımlayıcı dosyalarında belirtilebilir. Uygulama tanımlayıcısında bir versionLabel öğesi kullanıyorsanız kullanın ve aynı değere ayarlayın.

  • url —Güncelleme AIR dosyasının konumu. Bu, AIR uygulamasının güncelleme sürümünü içeren dosyadır.

  • description —Yeni sürüme ilişkin ayrıntılar. Bu bilgi, güncelleme işlemi sırasında kullanıcıya gösterilebilir.

version ve url öğeleri zorunludur. description öğesi isteğe bağlıdır.

Örnek bir 2.5 sürümü güncelleme tanımlayıcı dosyası: 

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

Ve örnek bir 1.0 sürümü güncelleme tanımlayıcı dosyası: 

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

Birden çok dil kullanarak description etiketini tanımlamak istiyorsanız, bir lang niteliği tanımlayan birden çok text öğesi kullanın: 

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

Güncelleme tanımlayıcı dosyasını web sunucunuzda güncelleme AIR dosyasıyla birlikte konumlandırın.

Güncelleme tanımlayıcısına dahil olan templates dizini örnek güncelleme tanımlayıcı dosyaları içerir. Bunlar tek dilli ve çok dilli sürümler içerir.