ApplicationUpdater  - AS3

delay ve updateURL özelliklerine ilişkin değerleri ayarlayan konfigürasyon dosyasının konumu. Bu özellik mevcut olmayan bir dosyaya işaret ediyorsa, initialize() yönteminin çağrılması, Error atılmasıyla sonuçlanır.

Örnek bir konfigürasyon dosyası şöyledir:

 <?xml version="1.0" encoding="utf-8"?> 
         <configuration xmlns="http://ns.adobe.com/air/framework/update/configuration/1.0" >
           <url>app:/server/update.xml</url>
           <delay>1</delay>
        </configuration>

delay ve updateURL özelliklerini ayarlamak için bir konfigürasyon dosyası yüklemek yerine ActionScript kodunu kullanabilirsiniz.

İlgili API Öğeleri

Güncelleyicinin dahili durumu. Özellik aşağıdaki değerlere ayarlanabilir:

• "UNINITIALIZED"—Güncelleyici başlatılmadı.

• "INITIALIZING"—Güncelleyici başlatılıyor.

• "READY"—Güncelleyici başlatıldı.

• "BEFORE_CHECKING"—Güncelleyici henüz güncelleme açıklayıcı dosyasını kontrol etmedi.

• "CHECKING"—Güncelleyici, güncelleme açıklayıcı dosyasını kontrol ediyor.

• "AVAILABLE"—Güncelleme açıklayıcı dosyası mevcut.

• "DOWNLOADING"—Güncelleyici, AIR dosyasını indiriyor.

• "DOWNLOADED"—Güncelleyici, AIR dosyasını indirdi.

• "INSTALLING"—Güncelleyici, AIR dosyasını yüklüyor.

• "PENDING_INSTALLING"—Güncelleyici başlatıldı ve beklemede olan güncellemeler var.

Uygulamanın geçerli sürümü. Bu özellik, initialize() yöntemine yapılan çağrı sırasında ayarlanır. Uygulama açıklayıcı dosyasındaki sürüme ayarlanır.

Yeni güncellemelerin dönemsel kontrolleri arasındaki gün cinsinden aralık.

0 değeri (varsayılan değer), zamanlayıcının etkin olmadığını, yani dönemsel kontrolün gerçekleştirilmediğini gösterir. Bu değer, bu özellik aracılığıyla veya konfigürasyon dosyası aracılığıyla ayarlanabilir. Değer her iki yöntem kullanılarak ayarlandığında, özelliği kullanan değer kümesi kullanılır.

Varsayılan değer şudur 0.

Bunun başarılı bir güncellemeden sonraki ilk çalıştırma olup (true) olmadığı (false). Güncelleyici, bu değeri initialize() yöntemine yapılan çağrı sırasında ayarlar. Verilerin bir sürümden diğerine geçirilmesi gerekiyorsa, geliştirici isFirstRun öğesinin true olarak ayarlanıp ayarlanmadığını kontrol etmelidir.

İlgili API Öğeleri

Güncelleyicinin sürüm karşılaştırmaları gerçekleştirmek için kullanması gereken işlev. Güncelleme çerçevesi, varsayılan olarak uzak sitedeki sürümün yüklenen uygulamanın sürümünden daha yeni olup olmadığını algılamak için bir sürüm karşılaştırması yapar. Ancak, varsayılan karşılaştırma bazen geliştiricinin sürüm oluşturma şemasıyla eşleşmez. Karşılaştırmayı yapan yeni bir işlev sağlamak için bu özelliği ayarlayın.

Varsayılan karşılaştırma işlevi, x, y ve z'nin harfler ve rakamlar içerebileceği x.y.z gibi sürümleri kabul eder. Varsayılan karşılaştırma işlevinin tanıdığı bazı özel koşullar vardır. Test işlevi sürüm dizelerinde "alpha", "beta" veya "rc" bulduğunda, sıra alpha < beta < rc biçimindedir.

appUpdate.isNewerVersionFunction = customFn; 

function customFn (currentVersion:String, updateVersion:String):Boolean 
{
    return updateVersion > currentVersion;
}

Güncellemeden sonra değiştirildiyse, uygulama saklama dizininin önceki konumu. Sertifika geçişiyle yükseltmeden sonra, uygulama saklama dizininin konumu değişir. Sertifika geçişi yoksa, kullanıcı uygulamayı güncellediğinde uygulama saklama dizini değişmez. ve bu özellik null değerine ayarlanır. Bu özellik, initialize() yöntemine yapılan çağrı sırasında ayarlanır.

Geliştirici, AIR dosyasını ADT ile paketleme sırasında -migrate seçeneğini kullanıyorsa, AIR uygulamasının yeni sürümünü yeni bir sertifikayla imzalayabilir. AIR uygulamasının yeni sürümü yeni bir imzalama sertifikası kullanıyorsa, kullanıcı yeni sürümü yüklediğinde uygulamanın yerel saklama dizini değişir. Eski uygulama saklama dizininden yeni uygulama saklama dizinine veri aktarmak için bu özelliği kullanın (File.applicationStorageDirectory). Daha fazla bilgi için bkz. Adobe AIR geliştirici kılavuzunun “Komut satırı araçlarını kullanarak bir AIR uygulaması oluşturma“ bölümündeki “Uygulama sertifikasını değiştirmek için AIR dosyasını imzalama“.

Uygulamanın önceki sürümü. Bu özellik, initialize() yöntemine yapılan çağrı sırasında ayarlanır. Uygulamanın yükseltmeden önceki sürümünü döndürür (yalnızca isfirstRun true olduğunda ayarlanır); aksi takdirde, null değerine ayarlanır.

Güncelleme URL'sinden indirilen güncelleme açıklayıcı dosyasının içeriği. Bu özellik, yalnızca updater nesnesi bir updateStatus olayı gönderdiğinde null dışında bir değere sahiptir.

Güncelleme açıklayıcı dosyasının konumu. Bir URLRequest yolu için geçerli olan tüm konumlar kabul edilir. Bu, güncelleyici tarafından istenilen tek zorunlu ayardır. Güncelleme URL'sini bu özellik yoluyla veya konfigürasyon dosyası yoluyla ayarlayabilirsiniz. Değer her iki yöntem kullanılarak ayarlandığında, güncelleyici bu özelliği kullanan değer kümesini kullanır.

Yüklenememiş olsa bile ertelenmiş bir güncelleme olup (true) olmadığı (false). Güncelleyici, bu özelliği initialize() yöntemine yapılan çağrı sırasında ayarlar. Yüklenemeyen bir güncelleme bulunup bulunmadığını kontrol etmek için wasPendingUpdate ve isFirstRun özelliklerini kullanın. (Bu durumda wasPendingUpdate true ve isFirstRun false olarak ayarlanır.)

İlgili API Öğeleri

Yapıcı işlevi.

Güncelleme işlemini iptal eder. Bu yöntemin çağrılması, tamamlanmamış tüm indirilen dosyaları silerek beklemede olan tüm indirmeleri iptal eder ve dönemsel kontrol zamanlayıcısını yeniden başlatır.

Güncelleme işlemi, durum makinesinin "UNINITIALIZED" veya "INITIALIZING" durumunda olduğu zamanlar hariç herhangi bir zamanda iptal edilebilir. "UNINITIALIZED" veya "INITIALIZING" durumlarından herhangi birinde çağrıldığı zaman sonuç vermez.

Güncelleme açıklayıcı dosyasını eşzamansız olarak indirir ve yükler. Bu yöntemin çağrılması güncelleyici durumunu "CHECKING" yapar. Bu yöntemi yalnızca checkForUpdate olayı iptal edildiyse çağırın.

Bu yöntem, yalnızca güncelleyici "BEFORE_CHECKING" durumunda olduğunda yürütülür.

Güncelleme işlemini başlatır. Bu yöntemin çağrılması dönemsel zamanlayıcıyı durdurmaz; ancak yöntem bir güncelleme işleminin çalışmakta olduğunu algılar ve geçerli yinelemeyi atlar.

Bu yöntem, yalnızca geçerli durum "READY" olduğunda yürütülür.

Bu yöntem, updater nesnesinde aşağıdaki olayın gönderilmesiyle sonuçlanabilir:

Güncelleme dosyasını eşzamansız olarak indirir. Bu yöntemin çağrılması durum makinesini "DOWNLOADING" yapar. Bu yöntem, yalnızca olayın available özelliği true durumundayken StatusUpdateEvent.UPDATE_STATUS olayı iptal edildiğinde çağrılmalıdır.

Bu yöntem, yalnızca geçerli durum "AVAILABLE" olduğunda yürütülür.

Güncelleyiciyi başlatır. Bu yöntemin çağrılması şunu gerçekleştirir:

1. Bekleyen tüm güncellemeleri sessizce (ve eşzamanlı olarak) yükleyerek güncelleme çerçevesini başlatır. Uygulamayı yeniden başlayabileceğinden, bu yöntemi uygulama başlangıcında çağırmalısınız.

2. Ertelenmiş bir güncelleme olup olmadığını kontrol eder ve varsa bunu yükler.

3. Önceki bir güncellemede herhangi bir hata oluştuysa, güncelleme dosyasını ve sürüm bilgisini depolama alanından temizler.

4. Dönemsel zamanlayıcı gecikmesinin süresi dolduysa, güncelleme işlemini başlatır; aksi halde dönemsel zamanlayıcıyı başlatır. Ancak, AIR Hata Ayıklama Başlatıcısı (ADL) uygulaması kullanılarak bir uygulama test edilirken, uygulamayı güncellemeye çalışmak bir IllegalOperationError istisnasıyla sonuçlanır.

Yerel bir AIR dosyası kullanarak güncelleme işlemini başlatır.

Bir güncelleme işlemi çalışıyorsa, bu yöntemin çağrılması sonuç vermez (durum, "DOWNLOADED" değilse).

Bu işlev, uygulama açıklayıcı dosyasında true olarak ayarlanmış customUpdateUI öğesi içeren bir uygulama için kullanışlıdır.

Uygulamanın AIR Hata Ayıklama Başlatıcısı (ADL) uygulaması kullanılarak test edilmesi sırasında bu yöntemin çağrılması, IllegalOperationError istisnasıyla sonuçlanır.

Parametreler

Güncelleme dosyasını yükler. Yöntemin çağrılması durum makinesini "INSTALLING" yapar ve yalnızca downLoadComplete olayı iptal edildiğinde çağrılmalıdır.

Bu yöntemi, güncelleyici "DOWNLOADED" durumunda olduğunda çağırın. Yöntemin başka bir durumdayken çağrılması sonuç vermez.

Uygulamanın AIR Hata Ayıklama Başlatıcısı (ADL) uygulaması kullanılarak test edilmesi sırasında bu yöntemin çağrılması, IllegalOperationError istisnasıyla sonuçlanır.

installUpdate() yöntemi çağrıldıktan sonra, güncellemeyi yüklemeden hemen önce gönderilir. Bazı durumlarda, çalışma zamanı güncellemeyi yüklemek için uygulamadan çıktığında kullanıcı geçerli çalışmasının tümünü kaybedebileceğinden, bu sırada güncellemenin yüklenmesini önlemek yararlıdır.

Bu olayın preventDefault() yönteminin çağrılması, yüklemeyi bir sonraki yeniden başlatmaya kadar erteler. preventDefault() yöntemini çağırırsanız, bu uygulama oturumu sırasında ek güncelleme işlemi başlatılamaz (installUpdate() yöntemine çağrı yoluyla veya dönemsel kontrol nedeniyle).

ApplicationUpdater kütüphanesi için varsayılan davranış, güncelleme açıklayıcı dosyasının indirilmesidir. Bu davranışı iptal etmek için preventDefault() yöntemini çağırabilirsiniz.

Bu olay şu özelliklere sahiptir:

Güncelleme işlemi başlamadan önce, güncelleyici güncelleme açıklayıcı dosyasını indirmeye çalışmadan hemen önce gönderilir. Güncelleyici bu olayı doğrudan checkNow() yönteminin çağrılmasının sonucu olarak veya dönemsel kontrol zamanlayıcısının süresi dolduğundan gönderebilir.

Bu olay şu özelliklere sahiptir:

Güncelleme dosyasının indirilmesi tamamlandığında gönderilir.

Bu yöntem genellikle, kullanıcının güncellemeyi yüklemeye devam etmek isteyip istemediğini soran bir mesaj görüntülemek için kullanılır.

ApplicationUpdater kütüphanesi için varsayılan davranış, installUpdate() yönteminin otomatik olarak çağrılmasıdır.

Bu olay şu özelliklere sahiptir:

Güncelleme dosyasına bağlanma veya bu dosyayı indirme sırasında hata oluştuğunda gönderilir. Ayrıca geçersiz HTTP durumları için de gönderilir (404 - Dosya bulunamadı gibi).

Bu olay gönderildiğinde, dönemsel zamanlayıcı otomatik olarak yeniden başlatılır (gecikme 0'dan büyükse).

DownloadErrorEvent nesnesinin errorID özelliği, hata bilgisini tanımlayan bir tam sayıdır (bkz. aşağıdaki tablo). Ek bir subErrorID özelliği daha fazla hata bilgisi içerebilir.

downloadUpdate() yöntemine yapılan çağrıdan ve sunucuya bağlantı oluşturulduktan sonra gönderilir. ApplicationUpdater kütüphanesini kullanırken, bu olaya ilişkin olay işleyicisinin kullanıcıya indirme ilerlemesini bildirmek üzere bir ilerleme çubuğu görüntülemesini isteyebilirsiniz.

Bu olay şu özelliklere sahiptir:

Başlatma veya güncelleme işlevi sırasında hata oluştuğunda gönderilir (beklenmeyen bir durum gerçekleştiğinde).

Bu olay şu özelliklere sahiptir:

installFromAIRFile() yöntemine yapılan çağrıda airFile parametresi olarak aktarılan dosyanın doğrulanması sırasında hata oluştuğunda gönderilir.

Güncelleyici installFromAIRFile() yöntemine yapılan çağrıdaki dosyayı başarıyla doğruladıktan sonra gönderilir.

Bu olay şu özelliklere sahiptir:

Başlatma tamamlandıktan sonra gönderilir.

Bu olay şu özelliklere sahiptir:

Güncelleme dosyası indirilirken gönderilir.

Bu olay şu özelliklere sahiptir:

Güncelleme açıklayıcı dosyasını indirmeye veya ayrıştırmaya çalışma sırasında hata oluştuğunda gönderilir.

Güncelleyici bu olayı gönderdiğinde, dönemsel zamanlayıcı otomatik olarak yeniden başlatılır (gecikme ayarı 0'dan büyükse). Güncelleyici yeni bir checkForUpdate olayı gönderdiğinde, uygulama tüm hata iletişim kutularını saklamayı göz önüne almalıdır.

Güncelleyici güncelleme açıklayıcı dosyasını başarıyla indirip yorumladıktan sonra gönderilir.

StatusUpdateEvent nesnesinin available özelliği true olarak ayarlandığında varsayılan davranış güncellemeyi indirmeye başlamaktır. Varsayılan davranış ApplicationUpdatorUI sınıfı kullanılırken değil, yalnızca ApplicationUpdater sınıfı kullanılırken önlenebilir.

Bu olay şu özelliklere sahiptir: