Paket | air.update |
Sınıf | public class ApplicationUpdater |
Miras Alma | ApplicationUpdater EventDispatcher Object |
Dil Sürümü: | ActionScript 3.0 |
Çalışma Zamanı Sürümleri: | AIR 1.5 |
Bu sınıf Adobe AIR SDK'de bulunan applicationupdater_ui.swc dosyasında yer alır. applicationupdater_ui.swc dosyası, AIR SDK'nin frameworks/libs/air dizininde bulunur.
Adobe AIR için bir proje oluşturduğunuzda, Adobe® Flex™ Builder™ bu sınıfı otomatik olarak yükler. Uygulamayı Adobe® Flex™ SDK'yi kullanarak derlediğinizde, SWC dosyasını da dahil etmelisiniz.
Uygulama güncellemelerini yönetmek, karmaşık bir süreç olabilir. AIR güncelleme çerçevesi, AIR uygulamalarında iyi güncelleme özellikleri sağlama konusunda geliştiricileri destekleyen API'ler sağlar. AIR güncelleme çerçevesindeki işlevler, geliştiricileri şu konularda destekler:
-
Bir aralığı temel alarak veya kullanıcı isteği üzerine güncellemeleri dönemsel olarak kontrol etme
-
Bir web kaynağından AIR dosyalarını (güncellemeleri) indirme
-
Yeni yüklenen sürümün ilk çalıştırılmasında kullanıcıyı uyarma
-
Kullanıcının güncellemeleri kontrol etmek isteyip istemediğini teyit etme
-
Kullanıcıya yeni güncelleme sürümü hakkında bilgi görüntüleme
-
Kullanıcıya indirme ilerlemesi ve hata bilgisini görüntüleme
AIR güncelleme çerçevesi, AIR uygulamasının güncelleme sürümü hakkındaki bilgiyi basit XML konfigürasyon dosyalarında saklamanıza olanak verir. Çoğu uygulama için, bu konfigürasyon dosyalarını kurma ve bunlara bazı basit kodları dahil etme, son kullanıcıya kullanışlı güncelleme işlevleri sağlar.
AIR güncelleme çerçevesiyle kullanmak üzere kendi kullanıcı arabiriminizi tanımlamak istiyorsanız, AIRUpdater sınıfını kullanın.
Güncelleme işlemi, bir dizi durum içerir. Updater nesnesinin currentState
özelliği, güncelleyicinin geçerli durumunu yansıtır:
currentState değeri | Açıklama |
---|---|
"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 mevcut. |
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.
AIR güncelleme çerçevesi yalnızca masaüstü profilinde desteklenir. Bu çerçeve genişletilen masaüstü uygulamalarında (yerel bir yükleyici ile yüklenen uygulamalarda) ve mobil profilde (ActionScript 3.0 ile yazılan iPhone uygulamaları) desteklenmez. Güncelleme çerçevesinin desteklenip desteklenmediğini anlamak için çalışma zamanındaki Updater.isSupported
özelliğine bakın.
AIR güncelleme çerçevesinin kullanımıyla ilgili ayrıntılar için Adobe AIR Uygulamalarını Oluşturma içinde "AIR Uygulamalarını Güncelleme" bölümüne bakın.
İlgili API Öğeleri
Özellik | Tanımlayan: | ||
---|---|---|---|
configurationFile : File
delay ve updateURL özelliklerine ilişkin değerleri ayarlayan konfigürasyon dosyasının konumu. | ApplicationUpdater | ||
constructor : Object
Belirli bir nesne örneği için sınıf nesnesine veya yapıcı işlevine bir başvuru. | Object | ||
currentState : String [salt okunur]
Güncelleyicinin dahili durumu. | ApplicationUpdater | ||
currentVersion : String [salt okunur]
Uygulamanın geçerli sürümü. | ApplicationUpdater | ||
delay : Number
Yeni güncellemelerin dönemsel kontrolleri arasındaki gün cinsinden aralık. | ApplicationUpdater | ||
isFirstRun : Boolean [salt okunur]
Bunun başarılı bir güncellemeden sonraki ilk çalıştırma olup (true) olmadığı (false). | ApplicationUpdater | ||
isNewerVersionFunction : Function
Güncelleyicinin sürüm karşılaştırmaları gerçekleştirmek için kullanması gereken işlev. | ApplicationUpdater | ||
previousApplicationStorageDirectory : File [salt okunur]
Güncellemeden sonra değiştirildiyse, uygulama saklama dizininin önceki konumu. | ApplicationUpdater | ||
previousVersion : String [salt okunur]
Uygulamanın önceki sürümü. | ApplicationUpdater | ||
updateDescriptor : XML [salt okunur]
Güncelleme URL'sinden indirilen güncelleme açıklayıcı dosyasının içeriği. | ApplicationUpdater | ||
updateURL : String
Güncelleme açıklayıcı dosyasının konumu. | ApplicationUpdater | ||
wasPendingUpdate : Boolean [salt okunur]
Yüklenememiş olsa bile ertelenmiş bir güncelleme olup (true) olmadığı (false). | ApplicationUpdater |
Yöntem | Tanımlayan: | ||
---|---|---|---|
Yapıcı işlevi. | ApplicationUpdater | ||
addEventListener(type:String, listener:Function, useCapture:Boolean = false, priority:int = 0, useWeakReference:Boolean = false):void
EventDispatcher nesnesi olan bir olay dinleyici nesnesini, dinleyicinin bir olayın bildirimini alması için kaydeder. | EventDispatcher | ||
Güncelleme işlemini iptal eder. | ApplicationUpdater | ||
Güncelleme açıklayıcı dosyasını eşzamansız olarak indirir ve yükler. | ApplicationUpdater | ||
Güncelleme işlemini başlatır. | ApplicationUpdater | ||
Olay akışına bir olay gönderir. | EventDispatcher | ||
Güncelleme dosyasını eşzamansız olarak indirir. | ApplicationUpdater | ||
EventDispatcher nesnesinin belirli bir olay türü için kayıtlı dinleyicisi olup olmadığını kontrol eder. | EventDispatcher | ||
Bir nesnenin belirli bir özelliğinin tanımlı olup olmadığını gösterir. | Object | ||
Güncelleyiciyi başlatır. | ApplicationUpdater | ||
Yerel bir AIR dosyası kullanarak güncelleme işlemini başlatır. | ApplicationUpdater | ||
Güncelleme dosyasını yükler. | ApplicationUpdater | ||
Object sınıfının bir örneğinin parametre olarak belirtilen nesnenin prototip zincirinde olup olmadığını gösterir. | Object | ||
Belirtilen özelliğin bulunup bulunmadığını ve numaralandırılabilir olup olmadığını gösterir. | Object | ||
EventDispatcher nesnesinden bir dinleyiciyi kaldırır. | EventDispatcher | ||
Dinamik bir özelliğin döngü işlemlerinde kullanılabilirliğini ayarlar. | Object | ||
Bu nesnenin, yerel ayara özel kurallara göre biçimlendirilmiş dize temsilini döndürür. | Object | ||
Belirtilen nesnenin dize olarak temsil edilen halini döndürür. | Object | ||
Belirtilen nesnenin temel değerini döndürür. | Object | ||
Bir olay dinleyicisinin bu EventDispatcher nesnesiyle mi, yoksa onun belirtilen olay türüne yönelik üst öğelerinden biriyle mi kayıtlı olduğunu kontrol eder. | EventDispatcher |
Olay | Özet | Tanımlayan: | ||
---|---|---|---|---|
[broadcast olayı] Flash Player veya AIR uygulaması işletim sistemi odağına gelip etkin olduğunda gönderilir. | EventDispatcher | |||
installUpdate() yöntemi çağrıldıktan sonra, güncellemeyi yüklemeden hemen önce gönderilir. | ApplicationUpdater | |||
Güncelleme işlemi başlamadan önce, güncelleyici güncelleme açıklayıcı dosyasını indirmeye çalışmadan hemen önce gönderilir. | ApplicationUpdater | |||
[broadcast olayı] Çalışan Flash Player veya AIR uygulaması sistem odağını kaybettiğinde ve etkin olmayan duruma geldiğinde gönderilir. | EventDispatcher | |||
Güncelleme dosyasının indirilmesi tamamlandığında gönderilir. | ApplicationUpdater | |||
Güncelleme dosyasına bağlanma veya bu dosyayı indirme sırasında hata oluştuğunda gönderilir. | ApplicationUpdater | |||
downloadUpdate() yöntemine yapılan çağrıdan ve sunucuya bağlantı oluşturulduktan sonra gönderilir. | ApplicationUpdater | |||
Başlatma veya güncelleme işlevi sırasında hata oluştuğunda gönderilir (beklenmeyen bir durum gerçekleştiğinde). | ApplicationUpdater | |||
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. | ApplicationUpdater | |||
Güncelleyici installFromAIRFile() yöntemine yapılan çağrıdaki dosyayı başarıyla doğruladıktan sonra gönderilir. | ApplicationUpdater | |||
Başlatma tamamlandıktan sonra gönderilir. | ApplicationUpdater | |||
Güncelleme dosyası indirilirken gönderilir. | ApplicationUpdater | |||
Güncelleme açıklayıcı dosyasını indirmeye veya ayrıştırmaya çalışma sırasında hata oluştuğunda gönderilir. | ApplicationUpdater | |||
Güncelleyici güncelleme açıklayıcı dosyasını başarıyla indirip yorumladıktan sonra gönderilir. | ApplicationUpdater |
configurationFile | özellik |
configurationFile:File
Dil Sürümü: | ActionScript 3.0 |
Çalışma Zamanı Sürümleri: | AIR 1.5 |
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.
Uygulama
public function get configurationFile():File
public function set configurationFile(value:File):void
İlgili API Öğeleri
currentState | özellik |
currentState:String
[salt okunur] Dil Sürümü: | ActionScript 3.0 |
Çalışma Zamanı Sürümleri: | AIR 1.5 |
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.
Uygulama
public function get currentState():String
currentVersion | özellik |
delay | özellik |
delay:Number
Dil Sürümü: | ActionScript 3.0 |
Çalışma Zamanı Sürümleri: | AIR 1.5 |
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.
Uygulama
public function get delay():Number
public function set delay(value:Number):void
isFirstRun | özellik |
isFirstRun:Boolean
[salt okunur] Dil Sürümü: | ActionScript 3.0 |
Çalışma Zamanı Sürümleri: | AIR 1.5 |
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.
Uygulama
public function get isFirstRun():Boolean
İlgili API Öğeleri
isNewerVersionFunction | özellik |
isNewerVersionFunction:Function
Dil Sürümü: | ActionScript 3.0 |
Çalışma Zamanı Sürümleri: | AIR 1.5 |
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.
Uygulama
public function get isNewerVersionFunction():Function
public function set isNewerVersionFunction(value:Function):void
Örnek ( Bu örnek nasıl kullanılır? )
appUpdate
updater nesnesi için özel bir işlev olan customFn
işlevini tanımlar. Örnek işlev bilerek basitleştirilmiştir. Özel işleviniz, versiyon oluşturma şemanızın kuralları temelinde bir Boolean değeri döndürmelidir.
appUpdate.isNewerVersionFunction = customFn; function customFn (currentVersion:String, updateVersion:String):Boolean { return updateVersion > currentVersion; }
previousApplicationStorageDirectory | özellik |
previousApplicationStorageDirectory:File
[salt okunur] Dil Sürümü: | ActionScript 3.0 |
Çalışma Zamanı Sürümleri: | AIR 1.5 |
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“.
Uygulama
public function get previousApplicationStorageDirectory():File
previousVersion | özellik |
previousVersion:String
[salt okunur] Dil Sürümü: | ActionScript 3.0 |
Çalışma Zamanı Sürümleri: | AIR 1.5 |
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.
Uygulama
public function get previousVersion():String
updateDescriptor | özellik |
updateDescriptor:XML
[salt okunur] Dil Sürümü: | ActionScript 3.0 |
Çalışma Zamanı Sürümleri: | AIR 1.5 |
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.
Uygulama
public function get updateDescriptor():XML
updateURL | özellik |
updateURL:String
Dil Sürümü: | ActionScript 3.0 |
Çalışma Zamanı Sürümleri: | AIR 1.5 |
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.
Uygulama
public function get updateURL():String
public function set updateURL(value:String):void
wasPendingUpdate | özellik |
wasPendingUpdate:Boolean
[salt okunur] Dil Sürümü: | ActionScript 3.0 |
Çalışma Zamanı Sürümleri: | AIR 1.5 |
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.)
Uygulama
public function get wasPendingUpdate():Boolean
İlgili API Öğeleri
ApplicationUpdater | () | Yapıcı |
public function ApplicationUpdater()
Dil Sürümü: | ActionScript 3.0 |
Çalışma Zamanı Sürümleri: | AIR 1.5 |
Yapıcı işlevi.
cancelUpdate | () | yöntem |
public function cancelUpdate():void
Dil Sürümü: | ActionScript 3.0 |
Çalışma Zamanı Sürümleri: | AIR 1.5 |
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.
checkForUpdate | () | yöntem |
public function checkForUpdate():void
Dil Sürümü: | ActionScript 3.0 |
Çalışma Zamanı Sürümleri: | AIR 1.5 |
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.
Olaylar
updateStatus: — Güncelleyici, güncelleme açıklayıcı dosyasını başarıyla indirdi ve yorumladı.
| |
updateError: — Güncelleme açıklayıcı dosyasını indirmeye veya ayrıştırmaya çalışma sırasında hata oluştu.
|
checkNow | () | yöntem |
public function checkNow():void
Dil Sürümü: | ActionScript 3.0 |
Çalışma Zamanı Sürümleri: | AIR 1.5 |
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:
Olaylar
checkForUpdate: — Güncelleme işlemi başlamadan hemen önce gönderilir.
|
downloadUpdate | () | yöntem |
public function downloadUpdate():void
Dil Sürümü: | ActionScript 3.0 |
Çalışma Zamanı Sürümleri: | AIR 1.5 |
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.
Olaylar
downloadStart: — Sunucuya bağlantı kurulduktan sonra gönderilir.
| |
progress: — Başlatma tamamlandıktan sonra gönderilir.
| |
downloadError: — 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).
|
initialize | () | yöntem |
public function initialize():void
Dil Sürümü: | ActionScript 3.0 |
Çalışma Zamanı Sürümleri: | AIR 1.5 |
Güncelleyiciyi başlatır. Bu yöntemin çağrılması şunu gerçekleştirir:
-
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.
-
Ertelenmiş bir güncelleme olup olmadığını kontrol eder ve varsa bunu yükler.
-
Önceki bir güncellemede herhangi bir hata oluştuysa, güncelleme dosyasını ve sürüm bilgisini depolama alanından temizler.
-
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.
Olaylar
initialized: — Başlatma tamamlandı.
| |
error: — Başlatma sırasında hata oluştu.
|
installFromAIRFile | () | yöntem |
public function installFromAIRFile(file:File):void
Dil Sürümü: | ActionScript 3.0 |
Çalışma Zamanı Sürümleri: | AIR 1.5 |
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
file:File — Yüklenecek yerel AIR dosyası.
|
Olaylar
fileUpdateStatus: — Güncelleyici AIR dosyasını başarıyla doğruladıktan sonra gönderilir.
| |
updateError: — Güncelleme açıklayıcı dosyasını ayrıştırmaya çalışma sırasında hata oluştuğunda gönderilir.
|
installUpdate | () | yöntem |
public function installUpdate():void
Dil Sürümü: | ActionScript 3.0 |
Çalışma Zamanı Sürümleri: | AIR 1.5 |
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.
Olaylar
beforeInstall: — Güncellemenin yüklenmesinden 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.
|
beforeInstall | Olay |
air.update.events.UpdateEvent
özellik UpdateEvent.type =
air.update.events.UpdateEvent.BEFORE_INSTALL
Dil Sürümü: | ActionScript 3.0 |
Çalışma Zamanı Sürümleri: | AIR 1.5 |
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.
UpdateEvent.BEFORE_INSTALL
sabiti, beforeInstall
olayı için event nesnesinin type
özelliğinin değerini tanımlar.
Bu olay şu özelliklere sahiptir:
Özellik | Değer |
---|---|
bubbles | false |
cancelable | false ; iptal edilecek varsayılan davranış yoktur. |
currentTarget | Bu Event nesnesini olay dinleyicisiyle etkin olarak işleyen nesne. |
target | Updater nesnesi. |
checkForUpdate | Olay |
air.update.events.UpdateEvent
özellik UpdateEvent.type =
air.update.events.UpdateEvent.CHECK_FOR_UPDATE
Dil Sürümü: | ActionScript 3.0 |
Çalışma Zamanı Sürümleri: | AIR 1.5 |
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.
UpdateEvent.CHECK_FOR_UPDATE
sabiti, checkForUpdate
olayı için event nesnesinin type
özelliğinin değerini tanımlar.
Bu olay şu özelliklere sahiptir:
Özellik | Değer |
---|---|
bubbles | false |
cancelable | false ; iptal edilecek varsayılan davranış yoktur. |
currentTarget | Bu Event nesnesini olay dinleyicisiyle etkin olarak işleyen nesne. |
target | Updater nesnesi. |
downloadComplete | Olay |
air.update.events.UpdateEvent
özellik UpdateEvent.type =
air.update.events.UpdateEvent.DOWNLOAD_COMPLETE
Dil Sürümü: | ActionScript 3.0 |
Çalışma Zamanı Sürümleri: | AIR 1.5 |
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.
UpdateEvent.DOWNLOAD_COMPLETE
sabiti, downloadComplete
olayı için event nesnesinin type
özelliğinin değerini tanımlar.
Bu olay şu özelliklere sahiptir:
Özellik | Değer |
---|---|
bubbles | false |
cancelable | false ; iptal edilecek varsayılan davranış yoktur. |
currentTarget | Bu Event nesnesini olay dinleyicisiyle etkin olarak işleyen nesne. |
target | Updater nesnesi. |
downloadError | Olay |
air.update.events.DownloadErrorEvent
özellik DownloadErrorEvent.type =
air.update.events.DownloadErrorEvent.DOWNLOAD_ERROR
Dil Sürümü: | ActionScript 3.0 |
Çalışma Zamanı Sürümleri: | AIR 1.5 |
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.DOWNLOAD_ERROR
sabiti, downloadError
olayı için olay nesnesinin type
özelliği değerini tanımlar.
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.
errorID Hata kodu | Açıklama |
---|---|
16800 | İndirilen güncelleme dosyasının doğrulanması sırasında oluşur. subErrorID özelliği ek bilgi içerebilir. |
16801 | Geçersiz Adobe AIR dosyası (eksik application.xml). |
16802 | Geçersiz Adobe AIR dosyası (eksik MIME türü). |
16803 | Geçersiz Adobe AIR dosyası (biçim). |
16804 | Geçersiz Adobe AIR dosyası (geçersiz bayraklar). |
16805 | Geçersiz Adobe AIR dosyası (bilinmeyen sıkıştırma). |
16806 | Geçersiz Adobe AIR dosyası (geçersiz dosya adı). |
16807 | Geçersiz Adobe AIR dosyası (bozuk). |
16808 | Konfigürasyon mevcut değil. |
16809 | updateURL özelliği ayarlanmadı. |
16810 | Ayrıldı. |
16811 | Geçersiz konfigürasyon dosyası (bilinmeyen konfigürasyon sürümü). |
16812 | Geçersiz konfigürasyon dosyası (URL eksik). |
16813 | Geçersiz konfigürasyon dosyası (gecikme biçimi). |
16814 | Geçersiz konfigürasyon dosyası (geçersiz defaultUI değerleri). |
16815 | Geçersiz güncelleme tanımlayıcısı (bilinmeyen tanımlayıcı sürümü). |
16816 | Geçersiz güncelleme tanımlayıcısı (eksik güncelleme sürümü). |
16817 | Geçersiz güncelleme tanımlayıcısı (geçersiz açıklama). |
16818 | Verilerin diske kaydedilmesi sırasında IO hatası. subErrorID özelliği, daha fazla bilgi sağlayabilir. |
16819 | İndirme sırasında güvenlik hatası. subErrorID özelliği, daha fazla bilgi sağlayabilir. |
16820 | Geçersiz HTTP durum kodu. subErrorID özelliği geçersiz durum kodunu içerebilir. |
16821 | Ayrıldı. |
16822 | İndirme sırasında I/O hatası. subErrorID özelliği, daha fazla bilgi sağlayabilir. |
16823 | Verilerin diske kaydedilmesi sırasında dosya sonu hatası. subErrorID özelliği, daha fazla bilgi sağlayabilir. |
16824 | Geçersiz güncelleme tanımlayıcısı. subErrorID özelliği, daha fazla bilgi sağlayabilir. |
16825 | Güncelleme dosyası, farklı bir uygulama kimliğine sahip olan bir uygulama içeriyor. |
16826 | Güncelleme dosyası, uygulamanın daha yeni bir sürümünü içermiyor. |
16827 | Güncelleme dosyasında bulunan sürüm, güncelleme tanımlayıcısındaki sürümle eşleşmiyor. |
16828 | Uygulama, büyük olasılıkla AIR Hata Ayıklama Başlatıcısı'nda (ADL) çalıştığından güncellenemiyor. |
16829 | Yükleme zamanında eksik güncelleme dosyası. |
downloadStart | Olay |
air.update.events.UpdateEvent
özellik UpdateEvent.type =
air.update.events.UpdateEvent.DOWNLOAD_START
Dil Sürümü: | ActionScript 3.0 |
Çalışma Zamanı Sürümleri: | AIR 1.5 |
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.
UpdateEvent.DOWNLOAD_START
sabiti, downloadStart
olayı için event nesnesinin type
özelliğinin değerini tanımlar.
Bu olay şu özelliklere sahiptir:
Özellik | Değer |
---|---|
bubbles | false |
cancelable | false ; iptal edilecek varsayılan davranış yoktur. |
currentTarget | Bu Event nesnesini olay dinleyicisiyle etkin olarak işleyen nesne. |
target | Updater nesnesi. |
error | Olay |
flash.events.ErrorEvent
özellik ErrorEvent.type =
flash.events.ErrorEvent.ERROR
Dil Sürümü: | ActionScript 3.0 |
Çalışma Zamanı Sürümleri: | AIR 1.5 |
Başlatma veya güncelleme işlevi sırasında hata oluştuğunda gönderilir (beklenmeyen bir durum gerçekleştiğinde).
Birerror
olay nesnesinin type
özelliğinin değerini tanımlar.
Bu olay şu özelliklere sahiptir:
Özellik | Değer |
---|---|
bubbles | false |
cancelable | false ; iptal edilecek varsayılan davranış yoktur. |
currentTarget | Bu Event nesnesini olay dinleyicisiyle etkin olarak işleyen nesne. |
target | Ağ işlemi arızası yaşayan nesne. |
text | Hata mesajı olarak gösterilecek metin. |
fileUpdateError | Olay |
air.update.events.StatusFileUpdateErrorEvent
özellik StatusFileUpdateErrorEvent.type =
air.update.events.StatusFileUpdateErrorEvent.FILE_UPDATE_ERROR
Dil Sürümü: | ActionScript 3.0 |
Çalışma Zamanı Sürümleri: | AIR 1.5 |
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.
StatusUpdateErrorEvent.UPDATE_ERROR
sabiti, statusUpdateError
olayı için olay nesnesinin type
özelliği değerini tanımlar.
fileUpdateStatus | Olay |
air.update.events.StatusFileUpdateEvent
özellik StatusFileUpdateEvent.type =
air.update.events.StatusFileUpdateEvent.FILE_UPDATE_STATUS
Dil Sürümü: | ActionScript 3.0 |
Çalışma Zamanı Sürümleri: | AIR 1.5 |
Güncelleyici installFromAIRFile()
yöntemine yapılan çağrıdaki dosyayı başarıyla doğruladıktan sonra gönderilir.
StatusUpdateEvent.UPDATE_STATUS
sabiti, updateStatus
olayı için olay nesnesinin type
özelliği değerini tanımlar.
Bu olay şu özelliklere sahiptir:
Özellik | Değer |
---|---|
available | Geçerli uygulamanın sürümünden farklı bir sürümün bulunup bulunmadığını gösterir (true ); aksi halde false (aynı sürüm). |
path | installFromAIRFile() yöntemine yapılan çağrıdaki airFile parametresiyle belirtilen güncelleme File dosyasının nativePath özelliği. |
version | Yeni güncellemenin sürümünü gösterir. |
initialized | Olay |
air.update.events.UpdateEvent
özellik UpdateEvent.type =
air.update.events.UpdateEvent.INITIALIZED
Dil Sürümü: | ActionScript 3.0 |
Çalışma Zamanı Sürümleri: | AIR 1.5 |
Başlatma tamamlandıktan sonra gönderilir.
UpdateEvent.INITIALIZED
sabiti, initialized
olayı için event nesnesinin type
özelliğinin değerini tanımlar.
Bu olay şu özelliklere sahiptir:
Özellik | Değer |
---|---|
bubbles | false |
cancelable | false ; iptal edilecek varsayılan davranış yoktur. |
currentTarget | Bu Event nesnesini olay dinleyicisiyle etkin olarak işleyen nesne. |
target | Updater nesnesi. |
progress | Olay |
flash.events.ProgressEvent
özellik ProgressEvent.type =
flash.events.ProgressEvent.PROGRESS
Dil Sürümü: | ActionScript 3.0 |
Çalışma Zamanı Sürümleri: | AIR 1.5 |
Güncelleme dosyası indirilirken gönderilir.
Birprogress
olay nesnesinin type
özelliği değerini tanımlar.
Bu olay şu özelliklere sahiptir:
Özellik | Değer |
---|---|
bubbles | false |
bytesLoaded | Dinleyici olayı işlerken yüklenen öğe veya bayt sayısı. |
bytesTotal | Yükleme işlemi başarılı olursa yüklenecek toplam öğe veya bayt sayısı. |
cancelable | false ; iptal edilecek varsayılan davranış yoktur. |
currentTarget | Bu Event nesnesini olay dinleyicisiyle etkin olarak işleyen nesne. |
target | İlerlemeyi bildiren nesne. |
updateError | Olay |
air.update.events.StatusUpdateErrorEvent
özellik StatusUpdateErrorEvent.type =
air.update.events.StatusUpdateErrorEvent.UPDATE_ERROR
Dil Sürümü: | ActionScript 3.0 |
Çalışma Zamanı Sürümleri: | AIR 1.5 |
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.
StatusUpdateErrorEvent.UPDATE_ERROR
sabiti, statusUpdateError
olayı için olay nesnesinin type
özelliği değerini tanımlar.
updateStatus | Olay |
air.update.events.StatusUpdateEvent
özellik StatusUpdateEvent.type =
air.update.events.StatusUpdateEvent.UPDATE_STATUS
Dil Sürümü: | ActionScript 3.0 |
Çalışma Zamanı Sürümleri: | AIR 1.5 |
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.
StatusUpdateEvent.UPDATE_STATUS
sabiti, updateStatus
olayı için olay nesnesinin type
özelliği değerini tanımlar.
Bu olay şu özelliklere sahiptir:
Özellik | Değer |
---|---|
available | Güncelleme açıklayıcı dosyası, geçerli uygulama sürümünden farklı olan bir sürüm belirlediğinde true olarak; aksi halde (sürüm aynı olduğunda) false olarak ayarlanır. |
version | Kullanılabilir yeni sürümü temsil eden dize. |
details | Desteklenen her dil için details dizesini tanımlayan bir dizi. Yerelleştirilmiş bir açıklama mevcut değilse, bu ilk öğenin boş bir dize ("" ) ve ikinci öğenin ayrıntılar dizesi olduğu bir dizide tanımlanır. Yerelleştirilmiş açıklamalar mevcutsa, dizideki her öğe iki öğeye sahip olan bir dizidir. İlk öğe yerel ayar kodu, ikinci öğe açıklamadır. Örneğin, aşağıdaki dizi iki dil için alt diziler içerir (İngilizce-ABD ve Fransızca): ["en-US", "Hello World"], ["fr", "Bonjour monde"] . Diller, güncelleme açıklamasındaki sırayla listelenir. Ayrıntılar özelliği metni güncelleme açıklaması dosyasında belirtilir. |
versionLabel | (AIR 2.5+) Güncellemenin uygulama açıklamasındaki sürüm etiketi. Kullanıcılara sürüm yerine sürüm etiketi görüntülenmelidir. Sürüm etiketi belirtilmezse bu özellik boş bir dizedir. |
Tue Jun 12 2018, 01:09 PM Z