| Paket | air.update |
| Sınıf | public class ApplicationUpdaterUI |
| Miras Alma | ApplicationUpdaterUI  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. AIR 2 SDK'de frameworks/libs/air dizininde bulunan sürüm, Flex 4 geliştirmesi içindir. Flex 3 kullanıyorsanız, frameworks/libs/air/flex3 alt dizinindeki sürümü kullanın.
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.
AIRUpdateUI sınıfı, uygulamanızın kullanabileceği varsayılan bir kullanıcı arabirimi uygular. Kullanıcıya temel bilgiler ve uygulama güncellemelerine ilişkin seçenekler sunar.
Güncelleme işlemi, bir dizi durum içerir:
| Durum | 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 install | 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
Miras Alınan Genel Özellikleri Gizle
Miras Alınan Genel Özellikleri Göster| Özellik | Tanımlayan: | ||
|---|---|---|---|
| configurationFile : File
delay ve updateURL özelliklerine ilişkin değerleri ayarlayan konfigürasyon dosyasının konumu. | ApplicationUpdaterUI | ||
 | constructor : Object
Belirli bir nesne örneği için sınıf nesnesine veya yapıcı işlevine bir başvuru. | Object | |
| currentVersion : String [salt okunur]
Uygulamanın geçerli sürümü. | ApplicationUpdaterUI | ||
| delay : Number
Yeni güncellemelerin dönemsel kontrolleri arasındaki gün cinsinden aralık. | ApplicationUpdaterUI | ||
| isCheckForUpdateVisible : Boolean
Güncellemeyi Kontrol Et, Güncelleme Yok ve Güncelleme Hatası iletişim kutularının görünürlüğünü etkinleştirir. | ApplicationUpdaterUI | ||
| isDownloadProgressVisible : Boolean
Güncellemeyi İndir iletişim kutusunun görünürlüğünü etkinleştirir. | ApplicationUpdaterUI | ||
| isDownloadUpdateVisible : Boolean
Güncellemeyi İndir iletişim kutusunun görünürlüğünü etkinleştirir. | ApplicationUpdaterUI | ||
| isFileUpdateVisible : Boolean
Dosya Güncelleme, Dosya Güncelleme Yok ve Dosya Hatası iletişim kutularının görünürlüğünü etkinleştirir. | ApplicationUpdaterUI | ||
| isFirstRun : Boolean [salt okunur]
Bunun başarılı bir güncellemeden sonraki ilk çalıştırma olup (true) olmadığı (false). | ApplicationUpdaterUI | ||
| isInstallUpdateVisible : Boolean
Güncellemeyi Yükle iletişim kutusunun görünürlüğünü etkinleştirir. | ApplicationUpdaterUI | ||
| isNewerVersionFunction : Function
Güncelleyicinin sürüm karşılaştırmaları gerçekleştirmek için kullanması gereken işlev. | ApplicationUpdaterUI | ||
| isUnexpectedErrorVisible : Boolean
Beklenmeyen Hata iletişim kutusunun görünürlüğünü etkinleştirir. | ApplicationUpdaterUI | ||
| isUpdateInProgress : Boolean [salt okunur]
Güncelleme çalışmaktaysa true, aksi halde false olan bir Boolean özelliği. | ApplicationUpdaterUI | ||
| localeChain : Array
Kullanıcı arabirimi tarafından kullanılan yerel ayar zincirini tanımlayan bir dizi. | ApplicationUpdaterUI | ||
| previousApplicationStorageDirectory : File [salt okunur]
Güncellemeden sonra değiştirildiyse, uygulama saklama dizininin önceki konumu. | ApplicationUpdaterUI | ||
| previousVersion : String [salt okunur]
Uygulamanın önceki sürümü. | ApplicationUpdaterUI | ||
| updateDescriptor : XML [salt okunur]
Güncelleme URL'sinden indirilen güncelleme açıklayıcı dosyasının içeriği. | ApplicationUpdaterUI | ||
| updateURL : String
Güncelleme açıklayıcı dosyasının konumu. | ApplicationUpdaterUI | ||
| wasPendingUpdate : Boolean [salt okunur]
Yüklenememiş olsa bile ertelenmiş bir güncelleme olup (true) olmadığı (false). | ApplicationUpdaterUI | ||
| Yöntem | Tanımlayan: | ||
|---|---|---|---|
Yapıcı işlevi. | ApplicationUpdaterUI | ||
| 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 | |
Belirtilen dil için dinamik olarak yeni bir kaynak paketi ekler. | ApplicationUpdaterUI | ||
Güncelleme işlemini iptal eder. | ApplicationUpdaterUI | ||
Güncelleme işlemini başlatır. | ApplicationUpdaterUI | ||
|
Olay akışına bir olay gönderir. | EventDispatcher | |
|
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. | ApplicationUpdaterUI | ||
Yerel bir AIR dosyası kullanarak güncelleme işlemini başlatır. | ApplicationUpdaterUI | ||
|
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. | ApplicationUpdaterUI | |||
| Güncelleme işlemi başlamadan önce, güncelleyici güncelleme açıklayıcı dosyasını indirmeye çalışmadan hemen önce gönderilir. | ApplicationUpdaterUI | |||
| [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. | ApplicationUpdaterUI | |||
| Güncelleme dosyasına bağlanma veya bu dosyayı indirme sırasında hata oluştuğunda gönderilir. | ApplicationUpdaterUI | |||
| downloadUpdate() yöntemine yapılan çağrıdan ve sunucuya bağlantı oluşturulduktan sonra gönderilir. | ApplicationUpdaterUI | |||
| Başlatma veya güncelleme işlevi sırasında hata oluştuğunda gönderilir (beklenmeyen bir durum gerçekleştiğinde). | ApplicationUpdaterUI | |||
| 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. | ApplicationUpdaterUI | |||
| Güncelleyici installFromAIRFile() yöntemine yapılan çağrıdaki dosyayı başarıyla doğruladıktan sonra gönderilir. | ApplicationUpdaterUI | |||
| Başlatma tamamlandıktan sonra gönderilir. | ApplicationUpdaterUI | |||
| Güncelleme dosyası indirilirken gönderilir. | ApplicationUpdaterUI | |||
| Güncelleme açıklayıcı dosyasını indirmeye veya ayrıştırmaya çalışma sırasında hata oluştuğunda gönderilir. | ApplicationUpdaterUI | |||
| Güncelleyici güncelleme açıklayıcı dosyasını başarıyla indirip yorumladıktan sonra gönderilir. | ApplicationUpdaterUI | |||
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. Ayrıca, güncelleme işlemi sırasında uygulamanın farklı teyit iletişim kutuları görüntüleyip görüntülemediğini belirlemeye yöneliş ayarlar da içerir. 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>
<defaultUI>
<dialog name="checkForUpdate" visible="true" />
<dialog name="downloadUpdate" visible="false" />
<dialog name="downloadProgress" visible="true" />
<dialog name="installUpdate" visible="true" />
</defaultUI>
</configuration>ApplicationUpdaterUI nesnesinin şu özelliklerini ayarlamak için, konfigürasyon dosyasını yüklemek yerine ActionScript kodunu kullanabilirsiniz: delay, isCheckForUpdateVisible, isDownloadProgressVisible, isDownloadUpdateVisible, isFileUpdateVisible, isInstallUpdateVisible ve updateURL özellikleri.
Uygulama
public function get configurationFile():File public function set configurationFile(value:File):voidİlgili API Öğeleri
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. Gecikme, bu özellik aracılığıyla veya konfigürasyon dosyası aracılığıyla ayarlanabilir. Değer her iki yöntem kullanılarak ayarlandığında, bu ö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İlgili API Öğeleri
isCheckForUpdateVisible | özellik |
isCheckForUpdateVisible:Boolean| Dil Sürümü: | ActionScript 3.0 |
| Çalışma Zamanı Sürümleri: | AIR 1.5 |
Güncellemeyi Kontrol Et, Güncelleme Yok ve Güncelleme Hatası iletişim kutularının görünürlüğünü etkinleştirir. true olarak ayarlandığında, güncelleyici bu iletişim kutularını güncelleme işleminin parçası olarak görüntüler. Bu, güncelleme konfigürasyon dosyasında da ayarlanabilir. Bu özelliği kullanan bir değer kümesi, güncelleme konfigürasyon dosyasındaki ayarı geçersiz kılar.
Uygulama
public function get isCheckForUpdateVisible():Boolean public function set isCheckForUpdateVisible(value:Boolean):void isDownloadProgressVisible | özellik |
isDownloadProgressVisible:Boolean| Dil Sürümü: | ActionScript 3.0 |
| Çalışma Zamanı Sürümleri: | AIR 1.5 |
Güncellemeyi İndir iletişim kutusunun görünürlüğünü etkinleştirir. true olarak ayarlandığında, güncelleyici bu iletişim kutusunu güncelleme işleminin parçası olarak görüntüler. Bu, güncelleme konfigürasyon dosyasında da ayarlanabilir. Bu özelliği kullanan bir değer kümesi, güncelleme konfigürasyon dosyasındaki ayarı geçersiz kılar.
Uygulama
public function get isDownloadProgressVisible():Boolean public function set isDownloadProgressVisible(value:Boolean):void isDownloadUpdateVisible | özellik |
isDownloadUpdateVisible:Boolean| Çalışma Zamanı Sürümleri: | AIR 1.5 |
Güncellemeyi İndir iletişim kutusunun görünürlüğünü etkinleştirir. true olarak ayarlandığında, güncelleyici bu iletişim kutularını güncelleme işleminin parçası olarak görüntüler. Bu, güncelleme konfigürasyon dosyasında da ayarlanabilir. Bu özelliği kullanan bir değer kümesi, güncelleme konfigürasyon dosyasındaki ayarı geçersiz kılar.
Uygulama
public function get isDownloadUpdateVisible():Boolean public function set isDownloadUpdateVisible(value:Boolean):void isFileUpdateVisible | özellik |
isFileUpdateVisible:Boolean| Dil Sürümü: | ActionScript 3.0 |
| Çalışma Zamanı Sürümleri: | AIR 1.5 |
Dosya Güncelleme, Dosya Güncelleme Yok ve Dosya Hatası iletişim kutularının görünürlüğünü etkinleştirir. true olarak ayarlandığında, güncelleyici bu iletişim kutularını güncelleme işleminin parçası olarak görüntüler. Bu, güncelleme konfigürasyon dosyasında da ayarlanabilir. Bu özelliği kullanan bir değer kümesi, güncelleme konfigürasyon dosyasındaki ayarı geçersiz kılar.
Uygulama
public function get isFileUpdateVisible():Boolean public function set isFileUpdateVisible(value:Boolean):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
isInstallUpdateVisible | özellik |
isInstallUpdateVisible:Boolean| Dil Sürümü: | ActionScript 3.0 |
| Çalışma Zamanı Sürümleri: | AIR 1.5 |
Güncellemeyi Yükle iletişim kutusunun görünürlüğünü etkinleştirir. true olarak ayarlandığında, güncelleyici bu iletişim kutusunu güncelleme işleminin parçası olarak görüntüler. Bu, güncelleme konfigürasyon dosyasında da ayarlanabilir. Bu özelliği kullanan bir değer kümesi, güncelleme konfigürasyon dosyasındaki ayarı geçersiz kılar.
Uygulama
public function get isInstallUpdateVisible():Boolean public function set isInstallUpdateVisible(value:Boolean):void 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;
}
isUnexpectedErrorVisible | özellik |
isUnexpectedErrorVisible:Boolean| Dil Sürümü: | ActionScript 3.0 |
| Çalışma Zamanı Sürümleri: | AIR 1.5 |
Beklenmeyen Hata iletişim kutusunun görünürlüğünü etkinleştirir. true olarak ayarlandığında, Uygulama Güncelleyicisi bu iletişim kutusunu güncelleme işleminin parçası olarak görüntüler. Bu, güncelleme konfigürasyon dosyasında da ayarlanabilir. Bu özelliği kullanan bir değer kümesi, güncelleme konfigürasyon dosyasındaki ayarı geçersiz kılar.
Uygulama
public function get isUnexpectedErrorVisible():Boolean public function set isUnexpectedErrorVisible(value:Boolean):void isUpdateInProgress | özellik |
localeChain | özellik |
localeChain:Array| Dil Sürümü: | ActionScript 3.0 |
| Çalışma Zamanı Sürümleri: | AIR 1.5 |
Kullanıcı arabirimi tarafından kullanılan yerel ayar zincirini tanımlayan bir dizi. Bu özelliği genellikle JavaScript (HTML) geliştiricileri kullanır.
Flex geliştiricileri, yerel ayar zincirini yönetmek için ResourceManager kullanabilir.
Varsayılan olarak, HTML tabanlı bir uygulamada diller Capabilities.languages dizisinde yer alan bu diller ve kullanıcı arabirimi tarafından desteklenen on dil arasında sıralanır. Eşleşme bulunamadığında, kullanıcı arabirimi İngilizce dilini kullanır.
Bu JavaScript örneği, AIR SDK'ye dahil olan AIR HTML yerelleştirme çerçevesini kullanır. Dil listesine karşı dilleri sıralar ve İngilizce'yi varsayılan temel dil olarak ayarlar:
appUpdater.addResources("ro_RO", {titleCheck: "Titlu", msgCheck: "Mesaj", btnCheck: "Buton"});
appUpdater.addResources("hu", {titleCheck: "Cím", msgCheck: "Üzenet"});
var languages = ["ro", "hu"];
languages = languages.concat(air.Capabilities.languages);
var sortedLanguages = air.Localizer.sortLanguagesByPreference(languages, air.Capabilities.language, "en-US");
sortedLanguages.push("en-US");
appUpdater.localeChain = sortedLanguages;Uygulama
public function get localeChain():Array public function set localeChain(value:Array):voidİlgili API Öğeleri
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önderdikten sonra null dışında bir değere sahip olur.
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İlgili API Öğeleri
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
ApplicationUpdaterUI | () | Yapıcı |
public function ApplicationUpdaterUI()| Dil Sürümü: | ActionScript 3.0 |
| Çalışma Zamanı Sürümleri: | AIR 1.5 |
Yapıcı işlevi.
addResources | () | yöntem |
public function addResources(lang:String, res:Object):void| Dil Sürümü: | ActionScript 3.0 |
| Çalışma Zamanı Sürümleri: | AIR 1.5 |
Belirtilen dil için dinamik olarak yeni bir kaynak paketi ekler. JavaScript geliştiricileri, uygulama güncelleyici arabiriminin görüntülediği iletişim kutuları için dinamik olarak yeni bir dil eklemek üzere bu yöntemi kullanır. (Flex geliştiricileri, "ApplicationUpdaterDialogs" kaynak paketine doğrudan yeni bir dil ekleyebilir.)
Parametreler
lang:String — Dil kodu (örneğin Rumence için "ro").
| |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
res:Object — Nesne, çeviriye ilişkin anahtarlar ve değerler içeriyor. Anahtarlar, dil özellik dosyasında bulunan anahtarlardır. Aşağıdaki tablo, olası anahtarları listeler (özellik adları).
|
İlgili API Öğeleri
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.
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.
|
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ı herhangi bir etki oluşturmaz (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.
|
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).
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.
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.
Bu olay şu salt okunur özelliklere sahiptir:
-
isFirstRun(Boolean), bu başarılı güncellemeden sonraki ilk çalıştırmaysatrue; aksi haldefalse. -
previousVersion(Dize) Uygulamanın yükseltmeden önceki sürümü. (YalnızcaisfirstRuntrueolduğunda ayarlanır.) -
currentVersion(Dize) Güncel olarak yüklenmiş sürümün uygulama açıklayıcı dosyasındaki sürümü.
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.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