Güncelleme ayarlarını XML yapılandırma dosyasında tanımlama

Güncelleme yapılandırma dosyası, bir XML dosyasıdır. Aşağıdaki öğeleri içerebilir:

  • updateURL — Bir Dize. Güncelleme tanımlayıcısının uzak sunucudaki konumunu temsil eder. Herhangi bir geçerli URLRequest konumu olanaklıdır. Konfigürasyon dosyası veya komut dosyası aracılığıyla updateURL özelliğini tanımlamalısınız (bkz. Güncelleme tanımlayıcı dosyalarını tanımlama ve AIR dosyasını web sunucunuza ekleme ). Güncelleyiciyi kullanmadan önce bu özelliği tanımlamanız gerekir ( Güncelleme çerçevesini başlatma ) bölümünde tanımlandığı biçimde updater nesnesinin initialize() yöntemini çağırmadan önce).

  • delay —Bir Sayı. Güncellemeleri kontrol etmek için gün cinsinden ( 0.25 gibi değerler geçerlidir) verilen zaman aralığını temsil eder. 0 değeri (varsayılan değer), güncelleyicinin otomatik bir dönemsel kontrol gerçekleştirmediğini belirtir.

ApplicationUpdaterUI için yapılandırma dosyası, updateURL ve delay öğelerinin yanı sıra aşağıdaki öğeyi içerebilir:

  • defaultUI : Bir dialog öğeleri listesi. Her dialog öğesi, kullanıcı arabiriminde iletişim kutusuna karşılık gelen bir name niteliği içerir. Her dialog öğesi, iletişim kutusunun görünür olup olmadığını tanımlayan bir visible niteliğine sahiptir. Varsayılan olarak true değerindedir. name niteliği için olası değerler şöyledir:

    • "checkForUpdate" —Güncellemeyi Kontrol Et, Güncelleme Yok ve Hatayı Güncelle iletişim kutularına karşılık gelir

    • "downloadUpdate" —Güncellemeyi İndir iletişim kutusuna karşılık gelir

    • "downloadProgress" —İndirme İlerlemesi ve İndirme Hatası iletişim kutularına karşılık gelir

    • "installUpdate" —Güncellemeyi Yükle iletişim kutusuna karşılık gelir

    • "fileUpdate" —Dosya Güncelleme, Dosya Güncellemesi Yok ve Dosya Hatası iletişim kutularına karşılık gelir

  • "unexpectedError" —Beklenmeyen Hata iletişim kutusuna karşılık gelir

    false olarak ayarlandığında, karşılık gelen iletişim kutusu güncelleme yordamının bölümü olarak görünmez.

Burada, ApplicationUpdater çerçevesine ilişkin yapılandırma dosyasının bir örneği bulunur: 

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

Burada, defaultUI öğesi için tanım içeren ApplicationUpdaterUI çerçevesine ilişkin yapılandırma dosyasının bir örneği bulunur: 

<?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> 
      <defaultUI> 
         <dialog name="checkForUpdate" visible="false" /> 
         <dialog name="downloadUpdate" visible="false" /> 
         <dialog name="downloadProgress" visible="false" /> 
      </defaultUI> 
</configuration>

configurationFile özelliğini dosyanın konumuna yönlendirin:

ActionScript örneği: 

appUpdater.configurationFile = new File("app:/cfg/updateConfig.xml");
JavaScript örneği: 
appUpdater.configurationFile = new air.File("app:/cfg/updateConfig.xml");

Güncelleme çerçevesinin templates dizini, örnek bir yapılandırma dosyası olan config-template.xml dosyasını içerir.