Re: Adobe Flash Player Uygulama Başlatma Hatası
Emmanuelle Riker
AIR uygulaması iin tanımlayıcı bilgiler belirten com.adobe.air.AIR launchApplication() yntemini ağıran bir Flash kimlik kartı veya uygulamasını barındıran bir web sayfasını ziyaret ederse. (Uygulama tanımlayıcı ayrıca tarayıcı başlatması iin bir true bildirimi iermelidir.)
Bir AIR uygulaması ağrıldığında, AIR, NativeApplication nesnesi yoluyla invoke tr bir InvokeEvent nesnesi gnderir. Bir uygulama zamanının kendini başlatmasını ve olay dinleyicisini kaydetmesini sağlamak iin, invoke olayları atılmak yerine kuyruğa gnderilir. Bir dinleyici kaydedildiğinde sıradaki tm olaylar iletilir.
invoke olaylarını almak iin, NativeApplication nesnesinin (NativeApplication.nativeApplication)addEventListener() yntemini ağırın. Bir olay dinleyicisi invoke olayı iin kaydolduğunda, kayıttan nce gerekleşen tm invoke olaylarını da alır. Sıradaki invoke olayları, addEventListener() yntemine yapılan ağrı geri dndkten sonra kısa aralıklarla, bir kerede bir olay olmak zere gnderilir. Bu işlem sırasında yeni bir invoke olayı gerekleşirse, bu olay sıradaki bir veya daha fazla olaydan nce gnderilebilir. Bu olay sıralaması sayesinde, başlatma kodunuz alışmadan nce gerekleşen tm invoke olaylarını işleyebilirsiniz. Bir olay dinleyicisini alışmaya sonradan ekleseniz de (uygulama başlatıldıktan sonra), uygulamanın başlamasından itibaren gerekleşen tm invoke olaylarını alacağını gz nnde bulundurun.
AIR uygulamasının yalnızca bir rneği başlatılır. Zaten alışmakta olan bir uygulama tekrar ağrılırsa, AIR alışan rneğe yeni bir invoke olayı gnderir. Bir invoke olayına yanıt vermek ve uygun eylemi gerekleştirmek (yeni bir belge penceresi amak gibi) AIR uygulamasının sorumluluğundadır.
InvokeEvent nesnesi uygulamaya iletilen tm argmanların yanı sıra, uygulamanın ağrıldığı dizini de ierir. Uygulama bir dosya tr ilişkilendirmesi nedeniyle ağrıldıysa, dosya yolunun tamamı komut satırı argmanlarına dahil edilir. Benzer şekilde uygulama bir uygulama gncellemesi nedeniyle ağrıldıysa, gncelleme AIR dosyası yolunun tamamı sağlanır.
Bir işlemde birden ok dosya aıldığında, Mac OS X'te tek bir InvokeEvent nesnesi gnderilir. Her bir dosya arguments dizisinde mevcuttur. Windows ve Linux'ta her dosya iin ayrı bir InvokeEvent nesnesi gnderilir.
Bir AIR uygulamasının başlatılmasıyla ilişkilendirilen komut satırı argmanları, NativeApplication nesnesi tarafından gnderilen InvokeEvent nesnesinde iletilir. InvokeEvent arguments zelliği, bir AIR uygulaması ağrıldığında işletim sistemi tarafından verilen bir dizi argmanı ierir. Argmanlar greceli dosya yolları ieriyorsa, yolları genellikle currentDirectory zelliğini kullanarak zebilirsiniz.
Bir uygulama, uygulama tarafından kaydedilen trde bir dosya aıldığı iin ağrıldığında, dosyanın yerel yolu komut satırı argmanlarına dize olarak dahil edilir. (Dosyada istenilen işlemin aılmasından veya gerekleştirilmesinden uygulamanız sorumludur.) Benzer şekilde bir uygulama kendisini gncellemek zere programlandığında (standart AIR gncelleme kullanıcı arabirimine gvenmek yerine), kullanıcı, eşleşen uygulama kimliğine sahip bir uygulama ieren AIR dosyasını ift tıklattığında AIR dosyasının yerel yolu da dahil edilir.
Aşağıdaki rnek invoke olayı iin dinleyicilerin nasıl kaydedileceğini ve olayın nasıl işleneceğini gsterir. rnek, alınan tm invocation olaylarının gnlğn tutar ve geerli dizini ve komut satırı argmanlarını gsterir.
Bir AIR uygulaması, geerli kullanıcı oturum atığında NativeApplicationstartAtLogin zelliğine true değeri verilerek otomatik olarak başlatılacak duruma getirilebilir. Bir kez ayarlandıktan sonra, kullanıcı her oturum atığında uygulama otomatik olarak başlatılır. Uygulama, ayar false olarak değiştirilene, kullanıcı ayarı işletim sisteminden elle değiştirene veya uygulama kaldırılana kadar başlangıta aılmaya devam eder. Oturum aılırken başlatma, bir alışma zamanı ayarıdır. Ayar yalnızca geerli kullanıcıya yneliktir. Ayrıca startAtLogin zelliğinin true olarak başarıyla ayarlanması iin uygulama yklenmelidir. Uygulama yklenmemişken zellik ayarlanırsa (ADL ile başlatıldığında olduğu gibi) bir hata verilir.
Bir uygulamanın otomatik olarak mı yoksa bir kullanıcı eylemi sonucunda mı aıldığını belirlemek iin InvokeEvent nesnesinin reason zelliğini inceleyebilirsiniz. zellik InvokeEventReason.LOGIN ğesine eşit ise uygulama otomatik olarak başlamış demektir. Başka herhangi bir başlatma yolunda, reason zelliği InvokeEventReason.STANDARD ğesine eşittir. reason zelliğine erişmek iin, uygulamanız AIR 1.5.1'i hedef almalıdır (uygulama tanımlama dosyasında doğru ad alanı değerini ayarlayarak).
Aşağıdaki basitleştirilmiş uygulama bir invoke olayı meydana geldiğinde nasıl davranacağına karar vermek iin InvokeEvent reason zelliğini kullanıyor. Reason zelliği "oturum ama" ise, uygulama arka planda kalır. Değil ise bu zellik ana uygulamayı grnr hale getirir. Bu deseni kullanan uygulama genelde oturum ama sırasında aılır, bylece arka planda işleme veya olay izlemeye devam edebilir ve kullanıcı tarafından tetiklenen bir invoke olayına yanıt olarak bir pencere aar.
Bir web sitesi, tarayıcı başlatma zelliğini kullanarak, tarayıcıdan başlatılacak şekilde ayarlı olan yklenmiş AIR uygulamasını başlatabilir. Tarayıcı başlatmaya yalnızca uygulama tanımlayıcı dosyası allowBrowserInvocation ayarını true olarak ayarladıysa izin verilir:
BrowserInvokeEvent olaylarını almak iin, AIR uygulamasında NativeApplication nesnesinin (NativeApplication.nativeApplication) addEventListener() yntemini ağırın. Bir olay dinleyicisi BrowserInvokeEvent olayı iin kaydolduğunda, kayıttan nce gerekleşen tm BrowserInvokeEvent olaylarını da alır. Bu olaylar addEventListener() yntemine yapılan ağrı geri dndkten sonra gnderilir, ancak bu gnderme işlemi, kayıttan sonra alınmış olma ihtimali bulunan diğer BrowserInvokeEvent olaylarından nce gerekleşmeyebilir. Bu sayede, başlatma kodunuzun alışmasından nce gerekleşen (uygulama başlangıta tarayıcıdan ağrıldığında olduğu gibi) BrowserInvokeEvent olaylarını işleyebilirsiniz. Bir olay dinleyicisini alışmaya sonradan ekleseniz de (uygulama başlatıldıktan sonra), uygulamanın başlamasından itibaren gerekleşen tm BrowserInvokeEvent olaylarını alacağını gz nnde bulundurun.
"www.adobe.com" veya "www.example.org" gibi tarayıcıdaki ieriğin gvenlik etki alanı. Bu zellik yalnızca uzak gvenlik sanal alanındaki ierik iin (ağ etki alanından gelen ierik) ayarlanır. Yerel veya uygulama gvenlik sanal alanındaki ierik iin ayarlanmaz.
Tarayıcı başlatma zelliğini kullanırsanız, gvenlik sonularını dikkate aldığınızdan emin olun. Bir web sitesi bir AIR uygulaması atığında, BrowserInvokeEvent nesnesinin arguments zelliği yoluyla veri gnderebilir. Bu verileri dosya veya kod ykleme API'leri gibi duyarlı bir işlemde kullanırken dikkatli olun. Tehlike dzeyi, uygulamanın verilerle ne yaptığına bağlı olarak değişir. Yalnızca belirli bir web sitesinin uygulamayı ağırmasını bekliyorsanız, uygulama BrowserInvokeEvent nesnesinin securityDomain zelliğini kontrol etmelidir. Ayrıca uygulamayı ağıran web sitesinin HTTP'leri kullanmasını gerekli kılabilirsiniz, bunu da BrowserInvokeEvent nesnesinin isHTTPS zelliğini kontrol ederek doğrulayabilirsiniz.
Uygulama, iletilen verileri doğrulamalıdır. rneğin bir uygulamanın URL'leri belirli bir etki alanına iletmesi bekleniyorsa, URL'lerin gerekten de o etki alanına işaret ettiğini doğrulamalıdır. Bylece bir saldırganın, uygulamayı yanıltarak duyarlı verileri kendisine gndermesini sağlaması engellenebilir.
Hibir uygulama, yerel kaynaklara işaret edebilecek BrowserInvokeEvent argmanlarını kullanmamalıdır. rneğin bir uygulama, tarayıcı tarafından iletilen bir yola dayalı olarak File nesneleri oluşturmamalıdır. Uzak yolların tarayıcı tarafından iletilmesi bekleniyorsa, uygulama, yolların uzak bir protokol yerine file:// protokoln kullanmasını sağlamalıdır.
Bir uygulamayı sonlandırmanın en hızlı yolu NativeApplication exit () yntemini ağırmaktır. Bu yol, uygulamanızda kaydedilecek veri veya temizlenecek harici kaynaklar olmadığında işe yarar. exit() ğesini ağırmak tm pencereleri kapatır ve uygulamayı sonlandırır. Ancak uygulamanızın pencerelerinin veya diğer bileşenlerinin, rneğin gerekli verileri kaydetmek zere sonlandırma işlemini kesmesine izin vermek iin, uygun uyarı olaylarını exit() ğesini ağırmadan nce gnderin.
Bir uygulamayı başarıyla kapatırken dşnlecek bir başka nokta, kapatma işlemi nasıl başlarsa başlasın tek bir alışma yolu sağlamaktır. Kullanıcı (veya işletim sistemi) uygulama sonlandırmayı aşağıdaki yollarla tetikleyebilir:
rneğin kullanıcı varsayılan menden uygulamadan ık komutunu setiğinde işletim sisteminden uygulamadan ıkış komutunu seerek. (Bu yalnızca Mac OS'de gerekleşir; Windows ve Linux, sistem kromu aracılığıyla uygulama ıkış komutu sağlamaz.)
Bir ıkış komutu bu rotalardan biriyle işletim sisteminde araya girdiğinde, NativeApplication bir exiting olayı gnderir. Hibir dinleyici exiting olayını iptal etmezse, tm aık pencereler kapanır. Her pencere bir closing ve ardından bir close olayı gnderir. Pencerelerden biri closing olayını iptal ederse, kapatma işlemi durur.
Pencerelerin kapanma sırası uygulamanız iin bir sorunsa, NativeApplication ğesinden exiting olayını dinleyin ve pencereleri kendiniz uygun bir sırayla kapatın. Bunu yapmanız gerekebilir, rneğin ara paletleri olan bir belge pencereniz varsa. Sistemin paletleri kapatması uygunsuz, hatta daha da kt olabilirdi, ancak kullanıcı bazı verileri kaydetmek iin ıkış komutunu iptal etmeye karar verdi. Windows'ta exiting olayını yalnızca son pencereyi kapattıktan sonra alırsınız (NativeApplication nesnesinin autoExit zelliği true değerine ayarlıysa).
d3342ee215