Yardım PDF`sini İndir

Transkript

ADOBE FLASH CS4 PROFESSIONAL
ile
ADOBE AIR 1.1 uygulamalari geliştirme
®
®
© 2008 Adobe Systems Incorporated. Tüm hakları saklıdır.
Telif Hakkı
Adobe® Flash® CS4 Professional ile Adobe® AIR™ 1.1 Uygulamaları Geliştirme
Bu kılavuz son kullanıcı sözleşmesini içeren bir yazılımla birlikte verilmişse bu kılavuz ve onda anlatılan yazılım lisanslıdır ve yalnızca bu lisansa uygun şekilde
kullanılabilir veya kopyalanabilir. Bu türde bir lisans tarafından izin verildiği durumlar dışında, bu kılavuzun hiçbir bölümü Adobe Systems Incorporated
şirketinden önceden yazılı izin alınmadan çoğaltılamaz, geri alma sistemlerinde depolanamaz veya elektronik, mekanik, kayıt yoluyla veya diğer herhangi bir
şekilde veya herhangi bir yöntemle aktarılamaz. Bu kılavuz son kullanıcı lisans sözleşmesi içermeyen bir yazılımla dağıtılmamış olsa bile bu kılavuzdaki içeriğin
telif hakkı yasalarıyla korunduğunu unutmayın.
Bu kılavuzun içeriği yalnızca bilgi amaçlıdır, önceden haber verilmeden değiştirilebilir ve Adobe Systems Incorporated şirketinin bir taahhüdü olarak
yorumlanmamalıdır. Adobe Systems Incorporated bu kılavuzdaki bilgilerin hatalı veya yanlış olması durumunda hiçbir sorumluluk veya yükümlülük kabul
etmez.
Projenize dahil etmek isteyebileceğiniz mevcut resimlerin ve görüntülerin telif hakkı yasalarıyla korunuyor olabileceğini unutmayın. Bu türde malzemenin yeni
çalışmanıza yetkisiz olarak katılması, telif hakkı sahibinin haklarını ihlal etmek anlamına gelebilir. Lütfen telif hakkı sahibinden gerekli tüm izinleri aldığınızdan
emin olun.
Örnek şablonlarda şirket veya şahıs adlarına yapılmış olan göndermeler yalnızca anlatım amacıyla olup gerçek kuruluş veya şahıslarla bir ilgisi yoktur.
Adobe, the Adobe logo, Acrobat, ActionScript, Adobe AIR, ColdFusion, Dreamweaver, Flash, Flex, Flex Builder, and Reader are either registered trademarks or
trademarks of Adobe Systems Incorporated in the United States and/or other countries.
Microsoft and Windows are either registered trademarks or trademarks of Microsoft Corporation in the United States and/or other countries. Apple, Macintosh,
and Mac OS are trademarks of Apple Inc., registered in the United States and other countries. Java is a trademark or registered trademark of Sun Microsystems,
Inc. in the United States and other countries. All other trademarks are the property of their respective owners.
This product includes software developed by the Apache Software Foundation (http://www.apache.org/)
MPEG Layer-3 audio compression technology licensed by Fraunhofer IIS and Thomson Multimedia (http://www.mp3licensing.com).
Speech compression and decompression technology licensed from Nellymoser, Inc. (www.nellymoser.com)
Video compression and decompression is powered by On2 TrueMotion video technology. © 1992-2005 On2 Technologies, Inc. All Rights Reserved.
http://www.on2.com.
This product includes software developed by the OpenSymphony Group (http://www.opensymphony.com/)
This product contains either BSAFE and/or TIPEM software by RSA Security, Inc.
Sorenson Spark™ video compression and decompression technology licensed from Sorenson Media, Inc.
Adobe Systems Incorporated, 345 Park Avenue, San Jose, California 95110, USA.
Notice to U.S. Government End Users. The Software and Documentation are “Commercial Items,” as that term is defined at 48 C.F.R. §2.101, consisting of
“Commercial Computer Software” and “Commercial Computer Software Documentation,” as such terms are used in 48 C.F.R. §12.212 or 48 C.F.R. §227.7202,
as applicable. Consistent with 48 C.F.R. §12.212 or 48 C.F.R. §§227.7202-1 through 227.7202-4, as applicable, the Commercial Computer Software and
Commercial Computer Software Documentation are being licensed to U.S. Government end users (a) only as Commercial Items and (b) with only those rights
as are granted to all other end users pursuant to the terms and conditions herein. Unpublished-rights reserved under the copyright laws of the United States.
Adobe Systems Incorporated, 345 Park Avenue, San Jose, CA 95110-2704, USA. For U.S. Government End Users, Adobe agrees to comply with all applicable
equal opportunity laws including, if appropriate, the provisions of Executive Order 11246, as amended, Section 402 of the Vietnam Era Veterans Readjustment
Assistance Act of 1974 (38 USC 4212), and Section 503 of the Rehabilitation Act of 1973, as amended, and the regulations at 41 CFR Parts 60-1 through 60-60,
60-250, and 60-741. The affirmative action clause and regulations contained in the preceding sentence shall be incorporated by reference.
iii
İçindekiler
Bölüm 1: Adobe AIR yüklemesi
Adobe AIR için Sistem Gereksinimleri
.................................................................................. 1
Adobe AIR'i yükleme
.................................................................................................. 2
Adobe AIR'i kaldırma
.................................................................................................. 2
AIR örnek uygulamalarını yükleme ve çalıştırma
........................................................................ 2
Bölüm 2: Flash CS3 için Adobe AIR Güncellemesi'ni ayarlama
Flash CS3 için Adobe AIR Güncellemesi'ne yönelik sistem gereksinimleri
Flash CS3 için Adobe AIR güncellemesini kaldırma
Flash için Adobe AIR güncellemesi yükleme CS3
................................................ 4
...................................................................... 4
........................................................................ 5
Flash CS3 uygulamasına yönelik Adobe AIR eklemeleri
.................................................................. 5
Bölüm 3: Adobe AIR'e Giriş
Bölüm 4: AIR Kaynaklarını bulma
Bölüm 5: Flash CS3 veya CS4'te ilk AIR uygulamanızı oluşturma
Flash içinde Hello World uygulamasını oluşturma . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10
Uygulamayı test etme
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10
Bir Flash uygulamasını Adobe AIR uygulamasına çevirme
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 12
Bölüm 6: Flash CS3 Professional için Adobe AIR Güncellemesi
Bir Adobe AIR dosyası oluşturma . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13
Adobe AIR yayınlama ayarlarını belirleme
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13
Bir Adobe AIR uygulamasının önizlemesini görüntüleme
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 15
Bir Adobe AIR uygulamasının hatalarını ayıklama
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 15
AIR uygulaması ve yükleme dosyaları oluşturma
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 15
Özel bir uygulama tanımlayıcı dosyası oluşturma
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 20
Uygulamanızı imzalama
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 21
Bölüm 7: AIR güvenliği
AIR güvenlik temelleri . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 23
Yükleme ve güncellemeler
Sanal alanlar
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 23
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 26
HTML güvenliği
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 29
Farklı etki alanlarındaki içerikler arasında komut dosyası oluşturma
Diske yazma
Güvenilmeyen içerikle güvenli biçimde çalışma
Geliştiriciler için en iyi güvenlik uygulamaları
Kod imzalama
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 34
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 37
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 38
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 39
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 40
Bölüm 8: AIR uygulamasının özelliklerini ayarlama
Uygulama tanımlayıcı dosyasının yapısı . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 41
Uygulama tanımlayıcı dosyasında özellikleri tanımlama
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 42
ADOBE FLASH CS4 PROFESSIONAL ILE ADOBE AIR 1.1 UYGULAMALARI GELIŞTIRME iv
İçindekiler
Bölüm 9: Adobe AIR uygulamasındaki yeni işlevler
Yeni runtime sınıfları . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 49
Yeni işlevlere sahip runtime sınıfları
Hizmet izleme çerçevesi sınıfları
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 51
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 52
Bölüm 10: Yerel pencerelerle çalışma
Yerel pencereler hakkında ek çevrimiçi bilgiler
AIR penceresi temelleri
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 53
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 53
Pencereler oluşturma
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 58
Pencereleri yönetme
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 65
Pencere olaylarını dinleme
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 71
Tam ekran pencereleri görüntüleme
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 72
Bölüm 11: Ekranlar
Ekranlar hakkında ek çevrimiçi bilgi
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 73
Ekran temelleri
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 73
Ekranları numaralandırma
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 74
Bölüm 12: Yerel menülerle çalışma
Yerel menüler hakkında ek çevrimiçi bilgiler
AIR menüsü temelleri
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 77
Yerel menüler oluşturma
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 81
Bağlam menüleri hakkında
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 83
HTML'deki bağlam menüleri hakkında
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 84
Yerel menüleri tanıtıcı biçimde tanımlama
Açılır menüleri görüntüleme
Menü olaylarını işleme
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 77
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 85
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 87
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 87
Örnek: Pencere ve uygulama menüsü
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 89
Bölüm 13: Görev çubuğu simgeleri
Görev çubuğu simgeleri hakkında ek çevrimiçi bilgi
Görev çubuğu simgeleri hakkında
Dock simgeleri
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 92
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 92
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 93
Sistem Tepsisi simgeleri
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 93
Pencere görev çubuğu simge ve düğmeleri
Bölüm 14: Dosya sistemiyle çalışma
AIR Dosya API'si hakkında ek çevrimiçi bilgiler
AIR dosyası temel bilgileri
File nesneleriyle çalışma
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 95
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 97
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 97
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 98
Dosya sistemi bilgilerini alma
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 106
Dizinlerle çalışma
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 106
Dosyalarla çalışma
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 108
Dosyaları okuma ve dosyalara yazma
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 111
Bölüm 15: Sürükle ve bırak
Sürükleme ve bırakma hakkında ek çevrimiçi bilgiler
Sürükleme ve bırakma temel bilgileri
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 122
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 122
ADOBE FLASH CS4 PROFESSIONAL ILE ADOBE AIR 1.1 UYGULAMALARI GELIŞTIRME v
İçindekiler
Dışarı sürükleme hareketini destekleme
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 124
İçeri sürükleme hareketini destekleme
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 126
HTML Sürükle ve bırak
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 128
Bölüm 16: Kopyalama ve yapıştırma
Kopyalama ve yapıştırma hakkında ek çevrimiçi bilgiler
Kopyalama ve yapıştırma temel bilgileri
Sistem panosundan okuma ve sistem panosuna yazma
HTML kopyala ve yapıştır
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 137
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 137
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 138
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 139
Kopyalama ve yapıştırma için menü komutları ve tuş girişleri
Pano veri formatları
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 140
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 143
Bölüm 17: Bayt dizileriyle çalışma
ByteArray okuma ve yazma . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 148
ByteArray örneği: Bir .zip dosyasını okuma
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 153
Bölüm 18: Yerel SQL veritabanlarıyla çalışma
Yerel SQL veritabanları hakkında ek çevrimiçi bilgi
Yerel SQL veritabanları hakkında
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 157
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 158
Veritabanı oluşturma ve değiştirme
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 161
SQL veritabanı verilerini değiştirme
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 164
Senkronize ve senkronize olmayan veritabanı işlemlerini kullanma
SQL veritabanlarıyla çalışmak için stratejiler
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 181
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 185
Bölüm 19: Şifreli verileri saklama
Bölüm 20: HTML ortamı hakkında
HTML ortamına genel bakış . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 191
AIR ve Webkit uzantıları
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 193
Bölüm 21: HTML ve JavaScript'te programlama
HTMLLoader sınıfı hakkında . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 206
Güvenlik ilişkili JavaScript hatalarını önleme
AIR API sınıflarına JavaScript'ten erişme
AIR'deki URL'ler hakkında
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 207
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 211
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 212
ActionScript nesnelerini JavaScript için kullanılabilir duruma getirme
HTML DOM ve JavaScript nesnelerine ActionScript'ten erişme
SWF içeriğini HTML'e gömme
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 213
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 215
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 216
HTML sayfasında ActionScript kitaplıkları kullanma
Date ve RegExp nesnelerini dönüştürme
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 216
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 218
HTML stil sayfasını ActionScript'ten değiştirme
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 218
Farklı güvenlik sanal alanlarında çapraz komut dosyası içeriği
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 220
Bölüm 22: HTML ile ilgili olayları işleme
HTMLLoader olayları . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 224
DOM olaylarını ActionScript ile işleme
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 224
Yakalanmayan JavaScript istisnalarına yanıt verme
Çalışma zamanı olaylarını JavaScript'le işleme
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 225
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 227
ADOBE FLASH CS4 PROFESSIONAL ILE ADOBE AIR 1.1 UYGULAMALARI GELIŞTIRME vi
İçindekiler
Bölüm 23: HTML Kabı için Komut Dosyası Oluşturma
HTMLLoader nesnelerinin görüntü özellikleri . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 230
HTML içeriğini kaydırma
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 232
HTML geçmiş listesine erişme
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 233
HTML içeriği yüklenirken kullanılan kullanıcı aracısını ayarlama
HTML içeriğinde kullanım için karakter kodlamasını ayarlama
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 234
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 234
HTML içeriği için tarayıcı benzeri kullanıcı arabirimleri tanımlama
HTMLLoader sınıfının alt sınıflarını oluşturma
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 235
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 242
Bölüm 24: PDF içeriği ekleme
PDF Özelliklerini Saptama . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 244
PDF içeriğini yükleme
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 245
Komut dosyası PDF içeriği
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 245
AIR'de PDF içeriği için bilinen sınırlamalar
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 247
Bölüm 25: Dijital haklar yönetimini kullanma
Dijital haklar yönetimiyle ilgili ek çevrimiçi bilgiler
Şifreli FLV iş akışını anlama
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 248
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 249
NetStream sınıfında değişiklikler
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 250
DRMStatusEvent sınıfını kullanma
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 252
DRMAuthenticateEvent sınıfını kullanma
DRMErrorEvent sınıfını kullanma
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 253
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 254
Bölüm 26: Uygulama başlatma ve uygulamadan çıkma seçenekleri
Uygulama başlatma . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 257
Komut satırı argümanlarını yakalama
Oturum açılırken başlatma
Tarayıcı başlatma
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 258
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 260
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 260
Uygulama sonlandırma
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 262
Bölüm 27: Uygulama ayarlarını okuma
Uygulama tanımlayıcı dosyasını okuma . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 264
Uygulama ve yayıncı kimliklerini getirme
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 264
Bölüm 28: Çalışma zamanı ve işletim sistemi bilgileriyle çalışma
Dosya ilişkilendirmelerini yönetme . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 265
Çalıştırma zamanı sürümü ve yama düzeyini getirme
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 266
AIR özelliklerini saptama
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 266
Kullanıcı varlığını izleme
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 266
Bölüm 29: Ağ bağlantısını izleme
Ağ bağlantısı değişikliklerini saptama
Servis izleme temelleri
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 268
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 268
HTTP bağlantısını saptama
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 269
Soket bağlantısını saptama
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 269
ADOBE FLASH CS4 PROFESSIONAL ILE ADOBE AIR 1.1 UYGULAMALARI GELIŞTIRME vii
İçindekiler
Bölüm 30: URL istekleri ve ağ iletişimi
URLRequest sınıfını kullanma . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 270
URLStream sınıfındaki değişiklikler
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 273
Varsayılan sistem web tarayıcısında bir URL açma
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 273
Bölüm 31: AIR uygulamalarını Dağıtma, Yükleme ve Çalıştırma
AIR uygulamasını masaüstünden yükleme ve çalıştırma . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 275
AIR uygulamalarını web sayfasından yükleme ve çalıştırma
Kuruluş konuşlandırma
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 276
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 283
AIR dosyasını dijital olarak imzalama
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 284
Bölüm 32: AIR uygulamalarını güncelleme
Uygulamaları güncelleme hakkında . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 290
Özel uygulama güncelleme kullanıcı arabirimini sunma
Kullanıcının bilgisayarına bir AIR dosyası indirme
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 291
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 292
Uygulamanın ilk kez çalışıp çalışmadığını görmek için kontrol edin
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 292
Bölüm 33: AIR uygulamalarını yerelleştirme
Yerelleştirmeye giriş . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 294
Uygulama yükleyicisindeki uygulama adını ve açıklamasını yerelleştirme
Bir yerel ayar seçme
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 294
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 295
Flaş içeriğini yerelleştirme
HTML içeriğini yerelleştirme
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 295
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 295
Tarihleri, saatleri ve para birimlerini yerelleştirme
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 303
Bölüm 34: Komut satırı araçlarını kullanarak AIR uygulaması oluşturma
AIR Hata Ayıklama Başlatıcısı'nı (ADL) Kullanma . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 304
AIR yükleme dosyasını AIR Geliştirici Aracı (ADT) kullanarak paketleme
Uygulama sertifikasını değiştirmek için AIR dosyasını imzalama
ADT ile kendinden imzalı bir sertifika oluşturma
Apache Ant aracını SDK araçlarıyla kullanma
Dizin
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 306
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 312
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 313
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 314
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 318
1
Bölüm 1: Adobe AIR yüklemesi
Adobe® AIR™ sayesinde AIR uygulamalarını masaüstünde çalıştırabilirsiniz. Çalışma zamanını şu şekillerde
yükleyebilirsiniz:
• Çalışma zamanını ayrı yükleyerek (bir AIR uygulaması da yüklemeden)
• İlk kez bir AIR uygulaması yükleyerek (ayrıca çalışma zamanını da yüklemeniz istenir)
• AIR SDK, Adobe® Flex™ Builder™ 3 veya Adobe Flex™ 3 SDK gibi (AIR komut satırı geliştirme araçlarını içeren) bir
AIR geliştirme ortamı kurarak
Çalışma zamanının her bilgisayarda yalnızca bir kere yüklenmesi gerekir.
Adobe AIR için Sistem Gereksinimleri
Adobe AIR uygulamasını çalıştırmak için sistem gereksinimleri şunlardır:
• Temel Adobe AIR uygulamaları için:
İşlemci
Windows
Macintosh
Intel® Pentium® 1.0 GHz veya daha hızlı bir
işlemci
PowerPC® G3 1.0 GHz veya daha hızlı bir işlemci
ya da
Intel Core™ Duo 1.83 GHz veya daha hızlı bir
işlemci
Bellek
256 MB RAM
256 MB RAM
OS
Windows 2000 Service Pack 4;
Mac OS X 10.4.10 veya 10.5.x (PowerPC);
Windows XP SP2;
Mac OS X 10.4.x veya 10.5.x (Intel)
Vista
• Donanım ölçeklemeyle tam ekran video kullanan Adobe AIR uygulamaları için:
İşlemci
Windows
Macintosh
Intel® Pentium® 2.0 GHz veya daha hızlı bir
işlemci
PowerPC® G4 1.8GHz GHz veya daha hızlı bir
işlemci ya da
Intel Core™ Duo 1.33GHz veya daha hızlı bir
işlemci
Bellek
512 MB RAM; 32 MB video RAM
256 MB RAM; 32 MB video RAM
OS
Windows 2000 Service Pack 4;
Mac OS X v.10.4.10 veya v.10.5 (Intel veya
PowerPC)
Windows XP SP2;
Vista
NOT: H.264 videoyu görüntülemek için
kullanılan codec, Intel işlemci kullanılmasını
gerektirir
ADOBE FLASH CS4 PROFESSIONAL ILE ADOBE AIR 1.1 UYGULAMALARI GELIŞTIRME 2
Adobe AIR yüklemesi
Adobe AIR'i yükleme
AIR'in Windows® ve Mac OS X sürümlerini indirmek ve yüklemek için aşağıdaki talimatları kullanın.
Bir kullanıcı çalışma zamanını güncellemek için bilgisayarda yönetimsel ayrıcalıklara sahip olmalıdır.
Çalışma zamanını Windows kurulu bir bilgisayara yükleme
1 çalışma zamanı kurulum dosyasını indirin.
2 Çalışma zamanı yükleme dosyasını çift tıklatın.
3 Yüklemeyi tamamlamak için yükleme penceresindeki istemleri izleyin.
Çalışma zamanını Mac kurulu bir bilgisayara yükleme
1 çalışma zamanı kurulum dosyasını indirin.
2 Çalışma zamanı yükleme dosyasını çift tıklatın.
3 Yüklemeyi tamamlamak için yükleme penceresindeki istemleri izleyin.
4 Yükleyici bir Kimlik Denetimi penceresi görüntülerse, Mac OS kullanıcı adınızı ve parolanızı girin.
Çalışma zamanını yükledikten sonra, aşağıdaki yordamları kullanarak kaldırabilirsiniz.
Çalışma zamanını Windows kurulu bir bilgisayardan kaldırma
1 Windows Başlat menüsünde, Ayarlar > Denetim Masası öğelerini seçin.
2 Program Ekle veya Kaldır denetim masasını seçin.
3 Çalışma zamanını kaldırmak için “Adobe AIR”i seçin.
4 Değiştir/Kaldır düğmesini tıklatın.
Çalışma zamanını Mac kurulu bir bilgisayardan kaldırma
• /Applications klasöründe bulunan “Adobe AIR Uninstaller”ı çift tıklatın.
AIR örnek uygulamalarını yükleme ve çalıştırma
AIR özellikleri gösteren bazı örnek uygulamalar mevcuttur. Aşağıdaki talimatları kullanarak onlara erişebilir ve onları
yükleyebilirsiniz:
1 AIR örnek uygulamalarını indirin ve çalıştırın. Kaynak kodun yanı sıra derlenen uygulamalar da kullanılabilir.
2 Örnek bir uygulamayı indirmek ve çalıştırmak için, örnek uygulamanın Şimdi Yükle düğmesini tıklatın.
Uygulamayı yüklemeniz ve çalıştırmanız istenir.
Adobe AIR yüklemesi
3 Örnek uygulamaları indirmeyi ve sonra çalıştırmayı seçerseniz, indirme linklerini seçin. AIR uygulamalarını
istediğiniz zaman şu şekillerde çalıştırabilirsiniz:
• Windows'ta masaüstündeki uygulama simgesini çift tıklatarak veya Windows Başlat menüsünden seçerek.
• Mac OS'de varsayılan olarak kullanıcı dizininizin Uygulamalar klasöründe yüklü olan uygulama simgesini çift
tıklatarak (örneğin Macintosh'ta HD/Users/JoeUser/Applications/).
Not: Bu talimatların güncellemeleri için, şu adreste bulunan AIR sürüm notlarını kontrol edin:
http://www.adobe.com/go/learn_air_relnotes.
4
Bölüm 2: Flash CS3 için Adobe AIR
Güncellemesi'ni ayarlama
Adobe® Flash® CS3 Professional için Adobe® AIR™ Güncellemesi, Flash ile AIR uygulamaları geliştirmenizi sağlayan
öğeler ekleyerek Flash geliştirme ortamını zenginleştirir. Flash içinde AIR uygulama dosyaları oluşturmanıza, test
etmenize ve bu dosyaların hataları ayıklamanıza olanak tanır.
Adobe® Flash® CS4 Professional, AIR uygulamaları oluşturma işlemi için yerleşik desteğe sahiptir. Daha fazla bilgi için,
Flash Uygulamasını Kullanma bölümündeki Adobe AIR için yayınlama konusunu inceleyin.
Flash CS3 için Adobe AIR Güncellemesi'ne yönelik
sistem gereksinimleri
AIR uygulamaları geliştirmek ve çalıştırmak üzere Flash CS3 uygulamasını kullanabilmek için aşağıdaki yazılımları
yüklemiş olmanız gerekir:
• Flash CS3 Professional
Flash CS3 Professional uygulamasına sahip değilseniz Adobe web sitesinden satın alabilirsiniz:
http://www.adobe.com/products/flash
• Adobe AIR
Adobe AIR uygulamasını yükleme ile ilgili bilgiler için bkz. “Adobe AIR yüklemesi” sayfa 1.
• Flash CS3 için Adobe AIR güncellemesi
Daha önce Flash CS3 için Adobe AIR güncellemesi yüklediyseniz Flash CS3 için Adobe AIR güncellemesini kaldırma
bölümündeki adımları izleyerek bu uygulamayı kaldırın. Daha önce Flash CS3 için Adobe AIR güncellemesi
yüklemediyseniz“Flash için Adobe AIR güncellemesi yükleme CS3” sayfa 5 bölümüne geçin.
Flash CS3 için Adobe AIR güncellemesini kaldırma
Flash CS3 için Adobe AIR güncellemesini daha önceden yüklediyseniz, yeni Flash CS3 için Adobe AIR güncellemesini
yüklemeden önce aşağıdaki adımları takip ederek eskisini kaldırın.
1 Aşağıdaki klasörü silin:
(Windows) HD:\Program Files\Adobe\Adobe Flash CS3\AIK
(Mac) HD:/Applications/Adobe Flash CS3/AIK
2 Aşağıdaki konumu açın:
(Windows) HD:\Program Files\Adobe\Adobe Flash CS3\<dil>\First Run\Commands\
(Mac) HD:/Applications/Adobe Flash CS3/First Run/Commands
ve aşağıdaki dosyaları/klasörleri silin:
• AIR klasörü
Flash CS3 için Adobe AIR Güncellemesi'ni ayarlama
• AIR - Application and Installer Settings.jsfl
• AIR - Create AIR File.jsfl
3 Aşağıdaki dosyayı silin:
(Windows) HD:\Program Files\Adobe\Adobe Flash CS3\<dil>\Configuration\External Libraries\FLAir.dll
(Mac) HD:/Applications/Adobe Flash CS3/Configuration/External Libraries/FLAir.bundle.
4 Aşağıdaki dosyayı silin:
(Windows) HD:\Program Files\Adobe\Adobe Flash CS3\<dil>\Configuration\Players\AdobeAIR1_0.xml
(Mac) HD:/Applications/Adobe Flash CS3/Configuration/Players/ AdobeAIR1_0.xml
5 Aşağıdaki konumu açın:
(Windows) HD:\Document and Settings\<kullanıcı adı>\Local Settings\Application Data\Adobe\Flash
CS3\<dil>\Configuration\Commands\
(Mac) HD:/Users/<username>/Library/Application Support/Adobe/Flash CS3/<dil>/Configuration/Commands/
ve aşağıdaki dosyaları/klasörleri silin:
• AIR klasörü
• AIR - Application and Installer Settings.jsfl
• AIR - Create AIR File.jsfl
Not: Windows işletim sisteminde belirtilen konumu göremiyorsanız klasör seçeneklerinden "Gizli dosyaları göster"
seçeneğini işaretleyin.
Flash için Adobe AIR güncellemesi yükleme CS3
Flash CS3 için Adobe AIR güncellemesini yüklemeden önce Flash uygulamasını ve açık olan tarayıcı pencerelerini
kapatın.
• Flash CS3 için Adobe AIR güncellemesi uygulamasını indirin.
• Güncellemeyi indirdikten sonra güncelleme yama dosyasını çift tıklatıp yükleyin.
Flash CS3 uygulamasına yönelik Adobe AIR eklemeleri
Adobe AIR güncellemesini yükledikten sonra, Flash içerisinde aşağıdaki değişiklikleri görebilirsiniz:
• Yayınlama Ayarları iletişim kutusunda (Dosya -> Yayınlama Ayarları) Flash sekmesi altında bulunan Sürüm
menüsüne Adobe AIR 1.0 için yeni bir giriş eklenmiştir.
• Karşılama ekranı güncellenmiş, bir Flash Dosyası (Adobe AIR) oluşturmak için kullanılabilecek olan yeni bir giriş
eklenmiştir.
(Windows) HD:\Program Files\Adobe\Adobe Flash CS3\tr\FirstRun\StartPage
(Windows) HD:\Program Files\Adobe\Adobe Flash CS3\tr\FirstRun\StartPage\resources
Not: Macintosh bilgisayarlarda Karşılama ekranında Flash Dosyası (Adobe AIR) görünmüyorsa, aşağıdaki klasörü
silin ve Flash uygulamasını yeniden başlatın:
Flash CS3 için Adobe AIR Güncellemesi'ni ayarlama
HD:/Users/<kullanıcı adı>/Libraries/Application Support/Adobe/Flash CS3/<dil>/Configuration/StartPage
• ActionScript 3.0/Classes klasörü içindeki tüm ActionScript 3.0 API'lerini ve Adobe AIR API'lerini içeren yeni
playerglobal.swc dosyası eklenmiştir.
(Windows) HD:\Program Files\Adobe\Adobe Flash CS3\tr\Configuration\ActionScript 3.0 Classes
(Mac) HD:/Applications/Adobe Flash CS3/Configuration/ActionScript 3.0/Classes/
• Yeni jsfl dosyaları (AIR - Application and Installer Settings.jsfl, AIR - Publish AIR File.jsfl) eklenmiştir.
(Windows) HD:\Program Files\Adobe\Adobe Flash CS3\tr\FirstRun\Commands
(Mac) HD:/Applications/Adobe Flash CS3/First Run/Commands/
• Adobe AIR Yazılım Geliştirme Kiti (AIK) eklenmiştir.
(Windows) HD:\Program Files\Adobe\Adobe Flash CS3\AIK
• Harici kitaplık eklenmiştir.
(Windows) HD:\Program Files\Adobe\Adobe Flash CS3\tr\Configuration\External Libraries
(Mac) HD:/Applications/Adobe Flash CS3/Configuration/External Libraries/
• Hedef yapılandırma dosyası eklenmiştir.
(Windows) HD:\Program Files\Adobe\Adobe Flash CS3\tr\Configuration\Players\
(Mac) HD:/Applications/Adobe Flash CS3/Configuration/Players
7
Bölüm 3: Adobe AIR'e Giriş
Adobe® AIR™, masaüstünde Zengin Internet Uygulamaları (RIA'lar) kurmak ve konuşlandırmak için var olan web
geliştirme becerilerinizi (Adobe® Flash® CS3 Professional, Adobe® Flex™, HTML, JavaScript®, Ajax) yükseltmenizi
sağlayacak işletim sistemleri arası çalışma zamanıdır .
AIR, kullanımını en pratik bulduğunuz araçları ve yaklaşımları geliştirmek için alışkın olduğunuz ortamlarda
çalışmanızı ve Flash, Flex, HTML, JavaScript ve Ajax uygulamalarını destekleyerek ihtiyaçlarınızı karşılayacak en iyi
deneyimi yaşamanızı sağlar.
Örneğin aşağıdaki teknolojilerin biri veya bir kombinasyonu kullanılarak uygulamalar geliştirilebilir:
• Flash / Flex / ActionScript
• HTML / JavaScript / CSS / Ajax
• PDF herhangi bir uygulamayla geliştirilebilir
Bunun sonucunda AIR uygulamaları şu şekillerde kullanılabilir:
• Flash veya Flex'e dayalı olarak: Kök içeriği Flash/Flex (SWF) olan uygulama
• HTML veya PDF'yle beraber Flash veya Flex'e dayalı olarak. HTML (HTML, JS, CSS) veya PDF içeriğiyle beraber
kök içeriği Flash/Flex (SWF) olan uygulamalar
• HTML tabanlı. Kök içeriği HTML, JS, CSS olan uygulama
• Flash/Flex veya PDF'yle beraber HTML tabanlı. Flash/Flex (SWF) veya PDF içeriğiyle beraber kök içeriği HTML
olan uygulamalar
Kullanıcılar AIR uygulamalarıyla etkileşime, yerel masaüstü uygulamalarıyla geçtikleri gibi geçerler. Kullanıcının
bilgisayarına çalışma zamanı yüklenir, ardından AIR uygulamaları yüklenir ve diğer masaüstü uygulamaları gibi
çalışır.
Çalışma zamanı, uygulamaların konuşlandırılması için tutarlı bir işletim sistemleri arası platform ve çerçeve sağlar ve
böylece masaüstleri arasında tutarlı işlevsellik ve etkileşim sağlayarak tarayıcılar arası testi ortadan kaldırır. Belirli bir
işletim sistemi için geliştirme yapmak yerine, çalışma zamanını hedef aldığınızda şu gibi faydalardan yararlanırsınız:
• AIR için geliştirilen uygulamalar, size ek bir iş yükü getirmeden birden çok işletim sistemi arasında çalışır. Çalışma
zamanı, AIR tarafından desteklenen tüm işletim sistemlerinde tutarlı ve tahmin edilebilir sunumlar ve etkileşimler
sağlar.
• Var olan web teknolojilerini ve tasarım modellerini geliştirmeniz ve geleneksel masaüstü geliştirme teknolojilerini
veya yerel kod karmaşıklığını öğrenmeden web tabanlı uygulamalarınızı masaüstüne genişletebilmeniz sağlanarak
uygulamalar daha hızlı oluşturulabilir.
• Uygulama geliştirme, C ve C++ gibi düşük düzeyli diller kullanmaktan daha kolaydır. Her işletim sistemi için farklı
olan, karmaşık, düşük düzey API'leri öğrenmeniz gerekmez.
AIR için uygulama geliştirirken, zengin bir çerçeve ve API kümesi geliştirebilirsiniz:
• Çalışma zamanı ve AIR çerçevesi tarafından sağlanan AIR'e özgü API'ler
• SWF dosyalarında ve Flex çerçevesinde kullanılan ActionScript API'leri (bunun yanında diğer ActionScript tabanlı
kitaplıklar ve çerçeveler)
Adobe AIR'e Giriş
• HTML, CSS ve JavaScript
• Çoğu Ajax çerçevesi
AIR, uygulamaların oluşturulma, konuşlandırılma ve deneyim edilme şekillerini ciddi bir şekilde değiştirir. Daha
yaratıcı bir kontrole sahip olursunuz ve geleneksel masaüstü geliştirme teknolojilerini öğrenmeden Flash, Flex, HTML
ve Ajax tabanlı uygulamalarınızı masaüstüne genişletebilirsiniz.
9
Bölüm 4: AIR Kaynaklarını bulma
Adobe® AIR™ uygulamalarının geliştirilmesi hakkında daha fazla bilgi için aşağıdaki kaynaklara bakınız:
Kaynak
Konum
ActionScript 3.0'ı Programlama
http://www.adobe.com/go/learn_fl_cs4_programmingAS3_tr
ActionScript 3.0 Dil ve Bileşen Başvurusu (AIR dahil)
http://www.adobe.com/go/learn_flashcs4_langref_tr
Flash için Adobe AIR Hızlı Başlangıçları
http://www.adobe.com/go/learn_air_flash_qs_tr
Flash'ı Kullanma
http://www.adobe.com/go/learn_fl_cs4_using_tr
ActionScript 3.0 Bileşenlerini Kullanma
http://www.adobe.com/go/learn_fl_cs4_as3components_tr
Adobe ve topluluk uzmanlarına ait makaleler, örnekler ve sunumları http://www.adobe.com/devnet/air/ linklerindeki
Adobe AIR Geliştirici Bağlantısı'nda bulabilirsiniz. Buradan Adobe AIR ve ilişkili yazılımları da indirebilirsiniz.
Flash geliştiricilerine özgü bir bölümü http://www.adobe.com/devnet/air/flash/ linklerinde bulabilirsiniz.
Ürününüze ilişkin sorun giderme bilgilerini bulmak ve ücretli - ücretsiz teknik destek seçeneklerini öğrenmek için
www.adobe.com/support adresindeki Adobe Support web sitesini ziyaret edin. Adobe Press kitaplarına, çeşitli eğitim
kaynaklarına, Adobe yazılım sertifikası programlarına ve daha fazlasına erişim için Training (Eğitim) bağlantısını
izleyin.
10
Bölüm 5: Flash CS3 veya CS4'te ilk AIR
uygulamanızı oluşturma
Adobe® AIR™ uygulamasının nasıl çalıştığını hızlı ve uygulamalı olarak görmek için bu konu başlığı altındaki
talimatları izleyip basit bir "Hello World" AIR uygulaması oluşturun ve paketleyin.
Daha önce yapmadıysanız Flash CS3 için Adobe AIR güncellemesini indirin ve yükleyin. Flash CS3 için Adobe AIR
uygulamasını yükleme ile ilgili daha fazla bilgi için “Flash CS3 için Adobe AIR Güncellemesi'ni ayarlama” sayfa 4
bölümünü inceleyin.
Flash CS4 kullanıyorsanız Adobe AIR desteği yerleşiktir, bu nedenle çalışmaya başlamak için herhangi bir şeyi
yüklemenize gerek yoktur.
Flash içinde Hello World uygulamasını oluşturma
Flash içinde bir Adobe AIR uygulaması oluşturma, sıradan bir Flash uygulaması oluşturmaya benzer. Aradaki fark,
Karşılama ekranından başlayarak bir Flash dosyası (Adobe AIR) oluşturmanız ve sonunda uygulama ve yükleyici
ayarlarını oluşturup AIR uygulamanızı yüklemenizdir. Aşağıdaki adımlar size basit bir Hello World uygulaması
oluşturma sürecinde kılavuzluk edecektir.
Hello World uygulamasını oluşturmak için
1 Flash uygulamasını başlatın.
2 Karşılama Ekranı'nda Adobe AIR yayınlama ayarları ile boş bir FLA dosyası oluşturmak için Flash Dosyası (Adobe
AIR) seçeneğini tıklatın.
3 Flash CS3 ile Adobe AIR için Geliştirme İşlemi özet iletişim kutusuna yanıt vermek için Tamam düğmesini tıklatın.
Bu iletişim kutusunun ilk açılışı birkaç saniye sürebilir. (Bu iletişim kutusu Flash CS4 uygulamasında
görüntülenmez.)
4 Araçlar panelinde Metin aracını seçin ve Sahne Alanı'nın ortasında statik bir metin alanı (varsayılan) oluşturun. 15
- 20 karakter alacak şekilde genişletin.
5 Metin alanına "Hello World" metnini yazın.
6 Dosyayı bir ad vererek (örneğin helloAIR) kaydedin.
Uygulamayı test etme
1 Uygulamayı Adobe AIR'de test etmek için Ctrl + Enter tuşlarına basın veya Kontrol Et -> Filmi Test Et'i seçin.
2 Film Hatalarını Ayıkla özelliğini kullanmak için ilk olarak uygulamaya ActionScript kodu ekleyin. Aşağıdaki gibi
bir izleme ifadesi ekleyerek bunu hızlı bir şekilde deneyebilirsiniz:
trace("Running AIR application using Debug Movie");
3 Uygulamayı Film Hatalarını Ayıkla özelliği ile çalıştırmak için Ctrl + Shift + Enter tuşlarına basın veya Kontrol Et-
> Film Hatalarını Ayıkla'yı seçin.
Flash CS3 veya CS4'te ilk AIR uygulamanızı oluşturma
4 Flash CS3'te AIR - Uygulama ve Yükleyici Ayarları iletişim kutusunu açmak için menüden Komutlar > AIR -
Uygulama ve Yükleyici Ayarları öğesini seçin. Flash CS4'te Dosya > AIR Ayarları'nı seçerek bu iletişim kutusunu
açabilirsiniz.
5 Adobe AIR paketini kendinden imzalı bir dijital sertifika ile imzalayın:
a Dijital İmza iletişim kutusunu açmak için Dijital İmza istemine yönelik Ayarla düğmesini tıklatın.
b Kendinden İmzalı Dijital Sertifika Oluştur iletişim kutusunu açmak için Oluştur düğmesini tıklatın.
c Yayıncı adı, Birim, Kurum adı, E-posta, Ülke, Şifre ve Şifreyi Doğrulayın bilgilerini tamamlayın.
d Sertifika türünü belirleyin. Sertifika Türü seçeneği güvenlik düzeyini belirlemenizi sağlar: 1024-RSA, 1024-bit
anahtar (daha az güvenli) kullanırken 2048-RSA, 2048-bit anahtar kullanır (daha güvenli).
e Farklı kaydet girişini tamamlayarak veya bir klasör konumuna göz atmak için Gözat... düğmesini tıklatarak
bilgiyi bir sertifika dosyası içine kaydedin. (Örneğin C:/Temp/mycert.pfx) Kaydetme işlemini tamamladığınızda
Tamam düğmesini tıklatın.
f
Flash Dijital İmza İletişim Kutusuna geri döner. Oluşturduğunuz kendinden imzalı sertifikanın yolu ve dosya
adı Sertifika metin kutusunda görüntülenir. Görüntülenmiyorsa, yol ve dosya adını girin veya Gözat düğmesini
tıklatarak dosyayı bulup seçin.
Flash CS3 veya CS4'te ilk AIR uygulamanızı oluşturma
g Dijital İmza iletişim kutusu Şifre metin alanına c adımında atadığınız şifreyi girin ve Tamam düğmesini tıklatın.
Adobe AIR uygulamalarınızı imzalama ile ilgili daha fazla bilgi için “Uygulamanızı imzalama” sayfa 21
bölümünü inceleyin.
6 Uygulama ve yükleyici dosyasını oluşturmak için AIR Dosyasını Yayınla düğmesini tıklatın. AIR dosyasını
oluşturmadan önce SWF ve application.xml dosyalarını oluşturmak için Filmi Test Et veya Film Hatalarını Ayıkla
eylemlerini önceden gerçekleştirmeniz gerekir.
7 Uygulamayı yüklemek için, uygulamanızı kaydettiğiniz klasörün içinde bulunan AIR dosyasını (application.air) çift
tıklatın.
8 Uygulama Yüklemesi iletişim kutusunda Yükle düğmesini tıklatın.
9 Yükleme Tercihlerini ve Konum ayarlarını inceledikten sonra "Yüklemeden sonra uygulamayı başlat" onay
kutusunun işaretli olduğundan emin olun. Ardından Devam düğmesini tıklatın.
10 Yükleme Tamamlandı mesajı görüntülendiğinde Son düğmesini tıklatın.
Hello World uygulaması aşağıdaki resimde gösterildiği gibi görünür:
Bir Flash uygulamasını Adobe AIR uygulamasına
çevirme
Var olan bir Flash uygulamasını da AIR uygulamasına dönüştürebilirsiniz. Flash CS3'te bu işlemi gerçekleştirme
konusunda bilgi almak için bkz. “Adobe AIR yayınlama ayarlarını belirleme” sayfa 13. Flash CS4 kullanıyorsanız,
Flash Uygulamasını Kullanma bölümündeki Adobe AIR için yayınlama konusunu inceleyin.
13
Bölüm 6: Flash CS3 Professional için
Adobe AIR Güncellemesi
Adobe® Flash® CS3 Professional için Adobe® AIR™ güncellemesi, geliştirme ortamını zenginleştirerek Flash ile Adobe
AIR uygulamaları oluşturmanızı, hatalarını ayıklamanızı ve paketlemenizi sağlar. Bir Adobe AIR uygulaması
oluşturma süreci; bir Adobe AIR FLA dosyası oluşturma, uygun yayınlama ayarlarını yapma, uygulamayı geliştirme
ve uygulamayı konuşlandırmak için uygulama ve yükleyici dosyalarını oluşturma adımlarını içerir.
Adobe® Flash® CS4 Professional kullanıyorsanız AIR uygulamaları oluşturma konusunda daha fazla bilgi için Flash
Uygulamasını Kullanma bölümündeki Adobe AIR için yayınlama konusunu inceleyin.
Uygulamanız içerisinde kullanabileceğiniz Adobe AIR ActionScript™ API'leri hakkında bilgi için ActionScript 3.0 Dil
ve Bileşenler Başvurusu'nu inceleyin.
Adobe AIR ActionScript API'lerinin listesi için bkz. “Adobe AIR uygulamasındaki yeni işlevler” sayfa 49.
Not: air.net paketinde sınıf kullanmak için ilk olarak ServiceMonitorShim bileşenini Bileşenler panelinden Kitaplık
paneline sürükleyin ve ActionScript 3.0 kodunuzun içerisine aşağıdaki import ifadesini ekleyin:
import air.net.*;
Bir Adobe AIR dosyası oluşturma
Flash Karşılama ekranını kullanarak bir Flash Dosyası (Adobe AIR) oluşturabilir veya bir Flash Dosyası (ActionScript™
3.0) oluşturup bunu Yayınlama Ayarları iletişim kutusundan bir Adobe AIR dosyasına dönüştürebilirsiniz. Ancak
Yeni Belge iletişim kutusunu kullanarak (Dosya > Yeni) bir Adobe AIR dosyası oluşturamazsınız. Bir Flash dosyasını
Adobe AIR dosyasına dönüştürmeyle ilgili bilgiler için bkz. “Adobe AIR yayınlama ayarlarını belirleme” sayfa 13.
1 Flash uygulamasını başlatın ya da Flash uygulamasını zaten başlattıysanız, açık pencereleri kapatarak Karşılama
ekranına geri dönün.
Not: Flash Karşılama ekranını devre dışı bıraktıysanız Düzen > Tercihler'i seçip Genel kategorisindeki Başlangıç
açılır menüsünde Karşılama Ekranı'nı işaretleyerek yeniden görüntülenmesini sağlayabilirsiniz.
2 Karşılama Ekranı'nda, Flash Dosyası'nı (Adobe AIR) tıklatın.
Adobe AIR uygulama ayarlarına ve Yardım belgelerine nasıl erişeceğinizi bildiren bir uyarı iletişim kutusu açılır.
Bir Daha Gösterme seçeneğini işaretleyerek bu uyarının gelecekte bir daha gösterilmemesini sağlayabilirsiniz,
ancak bunu yaparsanız ileride tekrar gösterilmesini sağlamanın hiçbir yolu yoktur.
Adobe AIR yayınlama ayarlarını belirleme
Bir AIR dosyasının ayarlarını incelemek veya değiştirmek ve bir Flash Dosyası (ActionScript 3.0) belgesini Flash
Dosyası (Adobe AIR) belgesine dönüştürmek için Flash yayınlama ayarlarını kullanın.
Adobe AIR yayınlama ayarlarını görüntüleme
1 Flash Karşılama ekranında bir Flash Dosyası (Adobe AIR) belgesi açın.
Flash CS3 Professional için Adobe AIR Güncellemesi
2 Dosya > Yayınlama Ayarları'nı seçin ve Flash sekmesini tıklatarak Adobe AIR yayınlama ayarlarını açın.
Bir Adobe AIR belgesi açtığınızda Sürüm menüsünde Adobe AIR 1.0 otomatik olarak seçilidir. ActionScript™
sürümü otomatik olarak ActionScript 3.0'a ayarlanmıştır. Yerel oynatma güvenliği ayarı AIR SWF dosyası ile ilgili
olmadığından silik biçimde görüntülenir.
Açtığınız bir Flash FLA dosyasını yayınlama ayarlarını değiştirerek bir Flash AIR dosyasına dönüştürebilirsiniz.
Yayınlama Ayarları iletişim kutusunu kullanarak bir Flash FLA dosyasını Flash AIR dosyasına dönüştürme
1 Şunlardan birini yapın:
• Var olan bir Flash dosyasını açın.
• Yeni bir Flash dosyası oluşturmak için Karşılama ekranını kullanın veya Dosya > Yeni seçin.
2 Dosya > Yayınlama Ayarları'nı seçin.
3 Flash sekmesindeki Sürüm açılır menüsünden Adobe AIR 1.0'ı seçin.
ActionScript sürümü girişi devre dışıdır çünkü bir AIR dosyası için yalnızca ActionScript 3.0 seçilebilir.
Flash dosyası ve Adobe AIR dosyası için kalan varsayılan seçenekler için aynıdır.
4 Yayınla düğmesini tıklattıktan sonra Tamam düğmesini tıklatarak Yayınlama Ayarları iletişim kutusunu kapatın.
Seçim aracı seçildiğinde Özellik denetçisi artık Player hedefinin Adobe AIR 1 olduğunu gösterir.
Not: Adobe AIR 1.0 profilini seçtiğinizde, Flash otomatik olarak Classpath ortam değişkenine AIR playerglobal.swc
dosyasının konumunu ekler. AIR playerglobal.swc dosyası ActionScript AIR API'lerini kullanmanızı sağlar. Ancak
Adobe AIR 1'den Adobe® Flash® Player 9'a geçtiğinizde Flash otomatik olarak varsayılan profile geri dönmez veya
Classpath ayarını Flash Player 9 için playerglobal.swc dosyasını kullanacak şekilde değiştirmez. Yayınlama ayarını
Adobe AIR 1 yerine Flash Player 9 olarak değiştirirseniz, yayınlama profilini de Varsayılan olarak değiştirmeniz
gerekir.
Yayınlama Ayarları iletişim kutusu ile ilgili daha fazla bilgi için www.adobe.com/go/learn_fl_using_tr adresindeki
Flash Uygulamasını Kullanma başlığına bakın.
Komutlar menüsünü kullanarak bir Flash FLA dosyasını Flash AIR uygulamasına dönüştürme
1 Flash FLA dosyanızı açın.
2 Yeni bir Flash Dosyası (ActionScript 3.0) açıyorsanız bu dosyayı kaydedin. Kaydetmemeniz halinde bir sonraki
adımda bir uyarı mesajı görüntülenir.
3 Komutlar > AIR - Uygulama ve Yükleyici Ayarları'nı seçin.
Dosyayı Adobe AIR yayınlama ayarlarına dönüştürmeyi isteyip istemediğinizi soran bir uyarı kutusu açılır.
4 FLA dosyasını Adobe AIR yayınlama ayarlarına dönüştürmek için Tamam'ı tıklatın. AIR - Uygulama ve Yükleyici
Ayarları iletişim kutusu açılır.
AIR - Uygulama ve Yükleyici Ayarları iletişim kutusu hakkında bilgi için bkz. “AIR uygulaması ve yükleme
dosyaları oluşturma” sayfa 15.
Dönüştürdüğünüz AIR FLA dosyasında Filmi Test Et, Film Hatalarını Ayıkla ve AIR Dosyası Oluştur komutlarını
kullanabilirsiniz.
Bir Adobe AIR uygulamasının önizlemesini görüntüleme
AIR uygulama penceresinde açılacağı şekilde bir Flash AIR SWF dosyasının önizlemesini görüntüleyebilirsiniz.
Uygulamayı paketleyip yüklemeden önce uygulamanın görsel öğelerinin nasıl görüneceğini görmek istediğinizde
önizleme görüntülemek işinize yarayacaktır.
1 Yayınlama ayarlarını bir Adobe AIR uygulamasına göre yaptığınızdan emin olun. Daha fazla bilgi için bkz. “Adobe
AIR yayınlama ayarlarını belirleme” sayfa 13.
2 Kontrol > Filmi Test Et'i seçin veya Ctrl + Enter tuşlarına basın.
Uygulama ayarlarını AIR - Uygulama ve Yükleyici Ayarları iletişim kutusunu kullanarak yapmamanız halinde,
Flash sizin yerinize SWF dosyasının yazıldığı klasörün içinde bir varsayılan uygulama tanımlayıcı dosyası (swfadıapp.xml) oluşturur. AIR - Uygulama ve Yükleyici Ayarları iletişim kutusunu kullanarak uygulama ayarlarını
yapmanız halinde uygulama tanımlayıcı dosyası yaptığınız bu ayarları gösterir.
Bir Adobe AIR uygulamasının hatalarını ayıklama
Adobe AIR SWF dosyasının hataları, uzaktan hata ayıklama durumu dışında bir Flash Player 9 ActionScript 3.0 SWF
dosyası gibi ayıklanabilir.
1 Adobe AIR yayınlama ayarlarını yaptığınızdan emin olun.
2 Eylemler paneline (Pencere > Eylemler) ActionScript kodu ekleyin. Test etmek için Eylemler paneline, Zaman
Çizelgesi'nin ilk karesine aşağıdaki gibi bir trace() ifadesi ekleyebilirsiniz:
trace("My application is running");
3 Hata Ayıkla > Film Hatalarını Ayıkla'yı seçin veya Ctrl + Shift + Enter tuşlarına basın.
Flash, ActionScript hata ayıklayıcıyı başlatır ve SWF dosyasını hata ayıklama bilgileriyle birlikte dışa aktarır.
Uygulama ayarlarını AIR - Uygulama ve Yükleyici Ayarları iletişim kutusunu kullanarak yapmamanız halinde,
Flash sizin yerinize SWF dosyasının yazıldığı klasörün içinde bir varsayılan uygulama tanımlayıcı dosyası (swfadıapp.xml) oluşturur. AIR - Uygulama ve Yükleyici Ayarlarını kullanarak uygulama ayarlarını yapmanız halinde
uygulama tanımlama dosyası yaptığınız bu ayarları gösterir.
Uygulamanızın hatalarını ayıklamak için Hata Ayıkla > Film Hatalarını Ayıkla'yı seçtiğinizde veya Ctrl + Shift +
Enter tuşlarına bastığınızda Flash, uygulamanızın ActionScript kodu içerip içermediğini belirten bir uyarı
görüntüler.
AIR uygulaması ve yükleme dosyaları oluşturma
Uygulamanızı tamamladıktan sonra konuşlandırmak için AIR uygulamasını ve yükleyici dosyalarını oluşturun.
Adobe AIR Flash Komutlar menüsüne iki yeni öğe ekler: AIR - Uygulama ve Yükleyici Ayarları ve AIR - AIR Dosyası
Oluştur. AIR uygulamasını ve yükleyici ayarlarını oluşturduktan sonra varolan ayarlarla AIR (.air) dosyasını yeniden
oluşturmak için AIR - AIR Dosyası Oluştur öğesini kullanabilirsiniz.
Adobe AIR uygulama ve yükleyici dosyalarını oluşturma
1 Flash içinde Adobe AIR uygulamanızı oluşturan sayfayı veya sayfa dizisini açın.
2 AIR - Uygulama ve Yükleyici Ayarları iletişim kutusunu açmadan önce Adobe AIR FLA dosyasını kaydedin.
3 Komutlar > AIR - Uygulama ve Yükleyici Ayarları'nı seçin.
4 AIR - Uygulama ve Yükleyici Ayarları iletişim kutusunda gerekli alanları doldurduktan sonra AIR Dosyasını
Yayınla düğmesini tıklatın.
AIR Dosyasını Yayınla düğmesini tıklattığınızda şu öğeler paketlenir: FLA dosyası, SWF dosyası, uygulama
tanımlayıcı dosyası, uygulama simge dosyaları ve Eklenen Dosyalar metin kutusunda listelenen dosyalar. Daha
önce dijital sertifika oluşturmadıysanız, AIR Dosyasını Yayınla düğmesini tıklattığınızda Flash, Dijital İmza iletişim
kutusunu görüntüler.
AIR - Uygulama ve Yükleyici Ayarları iletişim kutusu iki bölüme ayrılmıştır: Uygulama Ayarları ve Yükleyici Ayarları.
Bu ayarlarla ilgili daha fazla bilgi için aşağıdaki bölümleri inceleyin.
Uygulama ayarları
AIR - Uygulama ve Yükleyici Ayarları iletişim kutusunun Uygulama ayarları bölümünde aşağıdaki seçenekler yer alır:
Dosya Adı Uygulamanın ana dosyasının adı. Varsayılan olarak SWF dosyasının adını alır.
Ad Yükleyici tarafından uygulama dosya adını ve uygulama klasörünü oluşturmak için kullanılan ad. Bu adın
yalnızca, dosya adları veya klasör adları için geçerli olan karakterleri içermesi gerekir. Varsayılan olarak SWF
dosyasının adını alır.
Sürüm İsteğe bağlı. Uygulamanız için bir sürüm numarası belirtir. Varsayılan olarak boştur.
Kimlik Uygulamanıza benzersiz bir kimlik ile tanımlar. İsterseniz varsayılan kimliği değiştirebilirsiniz. Kimlikte
boşluk veya özel karakter kullanmayın. Geçerli karakterler: 0-9, a-z, A-Z, . (nokta) ve - (tire), 1 ila 212 karakter
uzunluğunda. Varsayılan olarak com.adobe.example eklindedir.uygulama_adı.
Açıklama İsteğe bağlı. Kullanıcı uygulamayı yüklediğinde görüntülenecek bir uygulama açıklaması girmenize olanak
tanır. Varsayılan olarak boştur.
Telif Hakkı İsteğe bağlı. Kullanıcı uygulamayı yüklediğinde görüntülenecek bir telif hakkı bildirimi girmenize olanak
tanır.
Pencere Stili Kullanıcı uygulamayı bilgisayarında çalıştırdığında kullanıcı arabiriminde kullanılacak pencere stilini
(veya kenarlığını) belirtir. İşletim sisteminin kullandığı görsel stile başvuran Sistem Kenarlığı seçeneğini
belirleyebilirsiniz. Ayrıca Özel Kenarlık (opak) veya Özel Kenarlık (saydam) seçeneğini de belirleyebilirsiniz.
Uygulamanızı sistem kenarlığı olmadan görüntülemek için Hiçbiri seçeneğini belirleyin. Sistem Kenarlığı seçeneği
uygulamayı işletim sistemi standardı pencere kontrolü ile çevreler. Özel Kenarlık (opak) seçeneği standart sistem
kenarlığını kaldırarak kendi uygulamanıza özel bir kenarlık oluşturmanıza olanak tanır. (Özel kenarlık doğrudan FLA
dosyası içinde oluşturulur.) Özel Kenarlık (saydam) seçeneği de Özel Kenarlık (opak) gibidir, ancak sayfa kenarlarına
saydamlık ekler. Bu saydamlık kare veya dikdörtgen şeklinde olmayan uygulama pencerelerinin kullanılabilmesini
sağlar.
Simge İsteğe bağlı. Uygulama için bir simge belirtmenize olanak verir. Uygulama kurulduktan ve Adobe AIR'de
çalıştırıldıktan sonra bu simge gösterilir. Simgenin farklı boyutlarda görüntülenebilmesini sağlamak için dört farklı
boyut (128, 48, 32 ve 16 piksel) belirtebilirsiniz. Örneğin simge, dosya tarayıcısında küçük resim, ayrıntı ve döşeme
görünümlerinde görüntülenebilir. Ayrıca masaüstü simgesi olarak ve AIR uygulama penceresinin başlığında da
görüntülenebileceği gibi başka yerlerde de kullanılabilir.
Herhangi bir simge dosyası belirtilmemesi halinde simge görüntüsü için varsayılan örnek AIR uygulama simgesi
kullanılır.
Bir simge belirtmek için AIR - Uygulama ve Yükleyici Ayarları iletişim kutusunda Simge Görüntüsü Seç düğmesini
tıklatın. Açılan Simge görüntüleri iletişim kutusunda, simge boyutlarından her biri için klasörü tıklatın ve kullanılacak
simge dosyasını seçin. Dosyalar PNG (Portable Network Graphics - Taşınabilir Ağ Grafiği) formatında olmalıdır.
Aşağıdaki resimde varsayılan Adobe AIR uygulama simgelerini görüntüleyen Simge Görüntüleri iletişim kutusu
gösterilmektedir.
Farklı boyutlarda uygulama simgesi görüntüsü belirtme
Belirttiğiniz görüntünün boyutları istenen ölçülerde olmalıdır (128x128, 48x48, 32x32 veya 16x16). Simge
boyutlarından herhangi birine uygun bir görüntü belirtmemeniz halinde Adobe AIR verilen görüntülerden birini
ölçekleyerek eksik simge görüntüsünün yerine koyar.
Gelişmiş Ayarlar
AIR - Uygulama ve Yükleyici Ayarları iletişim kutusunda bulunan Ayarlar düğmesi uygulama tanımlayıcı dosyası için
gelişmiş ayarlar belirlemenize olanak tanır. Ayarlar düğmesini tıklattığınızda Gelişmiş Ayarlar iletişim kutusu
görüntülenir.
Gelişmiş Ayarlar iletişim kutusu uygulamanın işlemesi gereken ilişkilendirilmiş dosya türlerini belirtmenize olanak
tanır. Örneğin uygulamanızın HTML dosyalarını işleme konusunda ana uygulama olmasını istiyorsanız bunu
İlişkilendirilmiş Dosya Türleri metin kutusunda belirtmeniz gerekir.
Ayrıca uygulamanın aşağıda gösterilen kısımları için de ayar belirtebilirsiniz:
• Başlangıç penceresinin boyutu ve yerleşimi
• Uygulamanın yükleneceği klasör
• Uygulamanın yerleştirileceği Program menü klasörü.
İletişim kutusu şu seçenekleri içerir:
İlişkilendirilmiş dosya türleri AIR uygulamasının işleyeceği ilişkilendirilmiş dosya türlerini belirtmenizi sağlar. Metin
kutusuna yeni bir dosya türü eklemek için Artı (+) düğmesini tıklatın. Artı düğmesini tıklattığınızda Dosya Türü
Ayarları iletişim kutusu açılır. Eksi (-) düğmesini tıklattığınızda metin kutusunda seçili olan öğe kaldırılır. Kalem
düğmesini tıklattığınızda Dosya Türü Ayarları iletişim kutusu açılır ve metin kutusunda seçtiğiniz öğeyi
düzenlemenizi sağlar. Varsayılan olarak Eksi (-) ve Kalem düğmeleri silik biçimde görüntülenir. Metin kutusunda bir
öğe seçtiğinizde Eksi (-) ve Kalem düğmeleri etkinleşerek seçtiğiniz öğeyi kaldırmanızı veya düzenlemenizi sağlar.
Metin kutusundaki varsayılan değeri Hiçbiri'dir.
İlişkilendirilmiş dosya türleri için dosya türü ayarları ile ilgili daha fazla bilgi için, bkz. “Dosya türü ayarları” sayfa 18.
Başlangıç penceresi ayarları Başlangıç uygulama penceresi için boyut ve yerleşim ayarlarını belirtmenizi sağlar.
• Genişlik: Pencerenin başlangıç genişliğini piksel cinsinden belirtir. Bu değer varsayılan olarak boş bırakılmıştır.
• Yükseklik: Pencerenin başlangıç yüksekliğini piksel cinsinden belirtir. Bu değer varsayılan olarak boş bırakılmıştır.
• X: Pencerenin başlangıç yatay konumunu piksel cinsinden belirtir. Bu değer varsayılan olarak boş bırakılmıştır.
• Y: Pencerenin başlangıç dikey konumunu piksel cinsinden belirtir. Bu değer varsayılan olarak boş bırakılmıştır.
• Maksimum Genişlik ve Maksimum Yükseklik: Pencerenin maksimum boyutunu piksel cinsinden belirtir. Bu
değerler varsayılan olarak boş bırakılmıştır.
• Minimum Genişlik ve Minimum Yükseklik: Pencerenin minimum boyutunu piksel cinsinden belirtir. Bu değerler
varsayılan olarak boş bırakılmıştır.
• Büyütülebilir: Kullanıcının pencereyi büyütüp büyütemeyeceğini belirtmenizi sağlar. Bu seçenek varsayılan olarak
seçilidir (veya true değeri verilmiştir).
• Küçültülebilir: Kullanıcının pencereyi küçültüp küçültemeyeceğini belirtmenizi sağlar. Bu seçenek varsayılan
olarak seçilidir (veya true değeri verilmiştir).
• Yeniden Boyutlandırılabilir: Kullanıcının pencereyi yeniden boyutlandırıp boyutlandıramayacağını belirtmenizi
sağlar. Bu seçenek belirlenmezse; Maksimum Genişlik, Maksimum Yükseklik, Minimum Genişlik ve Minimum
Yükseklik seçenekleri silik biçimde görüntülenir. Bu seçenek varsayılan olarak seçilidir (veya true değeri
verilmiştir).
• Görünür: Uygulama penceresinin başlangıçta görünür olup olmayacağını belirtmenizi sağlar. Bu seçenek
varsayılan olarak seçilidir (veya true değeri verilmiştir).
Diğer Ayarlar Yükleme ile ilgili aşağıdaki ek bilgileri belirtmenizi sağlar:
• Yükleme Klasörü: Uygulamanın yüklendiği klasörü belirtir.
• Program Menü Klasörü: Uygulama için program menü klasörü adını belirtir.
• Özel Güncelleme Kullanıcı Arabirimi: Bir kullanıcının zaten yüklenmiş olan bir uygulamanın AIR dosyasını
açtığında ne olacağını belirtir. Varsayılan olarak AIR, kullanıcının yüklenmiş olan sürümü AIR dosyası içinde
bulunan sürümle güncelleştirmesini sağlayan bir iletişim kutusu görüntüler. Kullanıcının bu kararı vermesini
istemiyor ve uygulamanın güncellemeleri üzerinde tam denetime sahip olmasını istiyorsanız bu seçeneği belirleyin.
Bu seçenek varsayılan davranışı geçersiz kılar ve uygulama kendi güncellemeleri üzerinde denetime sahip olur.
Bir AIR uygulamasını programsal olarak güncellemek konusunda bilgi için bkz. “AIR uygulamalarını güncelleme”
sayfa 290.
Dosya türü ayarları
Uygulama için ilişkilendirilmiş dosya türlerinde ekleme veya düzenleme yapmak için Gelişmiş Ayarlar iletişim
kutusundaki Artı (+) veya Kalem düğmesini tıklattığınızda Flash, Dosya Türü Ayarları iletişim kutusunu görüntüler.
Bu iletişim kutusundaki iki gerekli alan Ad ve Uzantı alanlarıdır. Tamam'ı tıklattığınızda bu alanlardan herhangi birisi
boşsa Flash bir hata iletişim kutusu görüntüler.
İlişkilendirilmiş bir dosya türü için aşağıdaki ayarları belirtebilirsiniz:
Ad Dosya türünün adı (ör: Köprü Metni İşaretleme Dili, Metin Dosyası veya Örnek).
Uzantı Boşluksuz ve en fazla 39 temel alfanümerik karakterden (A-Za-z0-9) oluşan dosya adı uzantısı (örneğin html,
txt veya xmpl).
Açıklama İsteğe bağlı. Dosya türü açıklaması (örneğin Adobe Video Dosyası).
İçerik türü İsteğe bağlı. Dosya için MIME türünü belirtir.
Dosya Türü Simge Ayarları İsteğe bağlı. Dosya türü ile ilişkilendirilmiş bir simge belirtmenizi sağlar. Simgenin farklı
boyutlarda görüntülenebilmesini sağlamak için dört farklı boyut (128x128, 48x48, 32x32 ve 16x16) belirtebilirsiniz.
Örneğin simge, dosya tarayıcısında küçük resim, ayrıntı ve döşeme görünümlerinde görüntülenebilir.
Belirttiğiniz görüntünün belirttiğiniz boyutta olması gerekir. Boyutlardan herhangi biri için bir dosya
belirtmediğinizde AIR en yakın boyuttaki görüntüyü kullanır ve eksik olanın boyutlarına uyacak şekilde ölçekler.
Bir simge belirtmek için simge boyutu klasörünü tıklatıp kullanılacak simge dosyasını seçin ya da istemin yanındaki
metin kutusuna simge dosyasının yolunu ve dosya adını girin. Simge dosyası PNG formatında olmalıdır.
Yeni bir dosya türü oluşturulduktan sonra Gelişmiş Ayarlar iletişim kutusundaki Dosya Türü liste kutusunda
gösterilir.
Uygulama tanımlayıcı dosyası ayarları
Belirttiğiniz uygulama ayarları uygulama_adi-app.xml dosyasına kaydedilir. Ancak Flash uygulamasına özel bir
uygulama tanımlayıcı dosyası kullanmak istediğinizi belirtme seçeneğiniz de vardır.
Özel Uygulama Tanımlayıcı Dosyası Kullan Özel bir uygulama tanımlayıcı dosyası kullanmanızı sağlar. Özel
Uygulama Tanımlayıcı Dosyası Kullan seçeneğini belirlediğinizde iletişim kutusunun Uygulama Ayarları bölümü silik
biçimde görüntülenir. Özel uygulama tanımlayıcı dosyasının konumunu, Özel Uygulama Tanımlayıcı Dosyası Kullan
düğmesinin altında bulunan metin alanına girerek veya klasör simgesini tıklatıp dosyanın konumuna gözatarak
belirtebilirsiniz. Uygulama tanımlayıcı dosyası ile ilgili daha fazla bilgi için bkz. “Özel bir uygulama tanımlayıcı dosyası
oluşturma” sayfa 20.
Yükleyici ayarları
AIR - Uygulama ve Yükleyici Ayarları iletişim kutusunun ikinci kısmı uygulamayı yükleme ile ilgili ayarları içerir.
Dijital İmza Tüm Adobe AIR uygulamalarının başka bir sisteme yüklenebilmesi için imzalanmış olması gerekir. Bir
Flash Adobe AIR uygulamasına dijital imza atamak ile ilgili bilgi için bkz. “Uygulamanızı imzalama” sayfa 21.
Hedef AIR dosyasının kaydedileceği yeri belirtir. Varsayılan konum FLA dosyasını kaydettiğiniz dizindir. Farklı bir
konum seçmek için klasör simgesini tıklatın. Varsayılan paket adı .air dosya uzantısına sahip olan uygulama adıdır.
Eklenen Dosyalar/Klasörler Uygulamanıza eklenecek diğer dosya ve klasörleri belirtir. Dosya eklemek için Artı (+)
düğmesini, klasör eklemek için ise klasör düğmesini tıklatın. Listenizde bulunan bir dosyayı veya klasörü silmek için
silmek istediğiniz dosyayı veya klasörü seçtikten sonra Eksi (-) düğmesini tıklatın.
Varsayılan olarak uygulama tanımlayıcı dosyası ve ana SWF dosyası paket listesine otomatik olarak eklenir. Paket
listesi Adobe AIR FLA dosyasını henüz yayınlamamış olsanız dahi bu dosyaları gösterir. Paket listesi dosyaları ve
klasörleri düz bir yapıda gösterir. Bir klasör içindeki dosyalar listelenmez ve dosyaların tam yol adları gösterilir, ancak
gerektiği zaman kısaltılır.
Simge dosyaları listeye dahil edilmez. Flash uygulaması dosyaları paketlediğinde simge dosyalarını SWF dosyasının
konumuna göre geçici bir klasöre kopyalar. Flash uygulaması paketleme tamamlandıktan sonra klasörü siler.
Uygulama ve yükleyici dosyalarının oluşturulamaması
Uygulama ve yükleyici dosyaları aşağıdaki durumlarda oluşturulamaz:
• Uygulama kimliği dizesinin uzunluğunun hatalı olması veya kullanılan karakterlerin geçersiz olması durumunda.
Uygulama kimliği dizesi 1 ila 212 karakterden oluşabilir ve aşağıdaki karakterleri içerebilir: 0-9, a-z, A-Z, . (nokta),
- (tire).
• Yükleyici listesinde bulunan dosyaların var olmaması durumunda.
• Özel simge dosyalarının boyutlarının hatalı olması durumunda.
• AIR hedef klasörünün yazma erişimine sahip olmaması durumunda.
• Uygulamayı imzalamamış olmanız veya daha sonra imzalanacak bir Adobe AIRI uygulaması olduğunu
belirtmemiş olmanız durumunda.
Özel bir uygulama tanımlayıcı dosyası oluşturma
Uygulama tanımlayıcı dosyası bir metin düzenleyici ile düzenleyebileceğiniz bir XML dosyasıdır. Özel bir uygulama
tanımlayıcı dosyası oluşturmak için istediğiniz değerleri belirtmek için değerleri düzenleyin. Varsayılan değerler şu
şekildedir:
• id = com.adobe.example.swfadı
• fileName = swfadı
• name = swfadı
• version = 1.0
• description = blank
• copyright = blank
• initialWindow
• title = name
• content = swfadı.swf
• systemChrome = standard, type = normal
• transparent = false
• visible = true
• icon
• image128x128 = icons/AIRApp_128.png
• customUpdateUI = false
• allowBrowserInvocation = false
Uygulama tanımlayıcı dosyası ile ilgili daha fazla bilgi için, bkz. “AIR uygulamasının özelliklerini ayarlama”
sayfa 41.
Uygulamanızı imzalama
Tüm Adobe AIR uygulamalarının başka bir sisteme yüklenebilmesi için imzalanmış olması gerekir. Ancak Flash
uygulamanın daha sonra imzalanabilmesi için imzalanmamış Adobe AIR yükleyici dosyaları oluşturmanıza da olanak
tanır. Bu imzalanmamış Adobe AIR yükleyici dosyalarına AIRI paketi adı verilir. Bu özellik sertifika başka bir
bilgisayarda olduğunda veya imzalama işlemi uygulama geliştirme işleminden ayrı olarak yapıldığı durumlarda
kullanılmaya yöneliktir.
Bir kök sertifika yetkilisinden önceden satın alınmış dijital bir sertifika ile bir Adobe AIR uygulamasını imzalama
1 AIR - Uygulama ve Yükleyici Ayarları iletişim kutusunda bulunan Dijital İmza Ayarla düğmesini tıklatın. Dijital
İmza iletişim kutusu açılır.
İletişim kutusunda Adobe AIR uygulamanızı dijital bir sertifika ile imzalamanızı veya bir AIRI paketi hazırlamanızı
sağlayan iki seçenek düğmesi bulunur. AIR uygulamanızı imzalarsanız, bir kök sertifika yetkilisi tarafından verilmiş
olan bir dijital sertifikayı kullanabilir veya kendinden imzalı bir sertifika oluşturabilirsiniz. Kendinden imzalı bir
sertifika oluşturmak kolaydır, ancak bir kök sertifika yetkilisi tarafından verilen bir sertifika kadar güvenilir
değildir.
Bir AIR uygulamasını imzalamak için kullanılan Dijital İmza iletişim kutusu
2 Açılır menüden bir sertifika dosyası seçin veya bir sertifika dosyasını bulmak için Gözat düğmesini tıklatın.
3 Sertifikayı seçin.
4 Bir şifre girin.
5 Tamam'ı tıklatın.
AIR uygulamanızı imzalama hakkında daha fazla bilgi için bkz. “AIR dosyasını dijital olarak imzalama” sayfa 284.
Kendinden imzalı bir dijital sertifika oluşturma
1 Oluştur düğmesini tıklatın. Kendinden İmzalı Dijital Sertifika iletişim kutusu açılır.
2 Yayıncı adı, Birim, Kurum adı, Ülke, Şifre ve Şifreyi Onaylayın bilgilerini tamamlayın.
3 Sertifika türünü belirtin.
Tür seçeneği sertifikanın sahip olacağı güvenlik düzeyini belirlemenizi sağlar: 1024-RSA, 1024-bit anahtar (daha az
güvenli) kullanırken 2048-rsa, 2048-bit anahtar kullanır (daha güvenli).
4 Farklı Kaydet girişini tamamlayarak veya bir klasör konumuna göz atmak için Gözat düğmesini tıklatarak bilgiyi
bir sertifika dosyası içine kaydedin.
5 Tamam'ı tıklatın.
6 Dijital İmza iletişim kutusunda bu yordamın ikinci adımında atadığınız şifreyi girin ve Tamam'ı tıklatın.
Bir dijital sertifika belirledikten sonra, Ayarla düğmesi Değiştir düğmesine dönüşür.
Bu oturum için kullandığınız şifrenin Flash uygulaması tarafından hatırlanmasını istiyorsanız Bu Oturum için Şifreyi
Anımsa seçeneğini tıklatın.
Tamam'ı tıklattığınızda Zaman Damgası seçeneği belirlenmemişse dijital sertifikanın süresi dolduğunda uygulamanın
yüklenmeyeceğini belirten bir uyarı iletişim kutusu açılır. Bu uyarıya yanıt olarak Evet seçeneğini tıklatırsanız zaman
bilgisi devre dışı bırakılır. Hayır seçeneğini tıklatırsanız Zaman Damgası seçeneği otomatik olarak seçilir ve zaman
damgası özelliği etkin hale gelir.
Kendinden imzalı bir dijital sertifika oluşturma ile ilgili daha fazla bilgi için, bkz. “AIR dosyasını dijital olarak
imzalama” sayfa 284.
Ayrıca dijital imza kullanmadan bir AIR Intermediate (AIRI) uygulaması da oluşturabilirsiniz. Ancak siz dijital imza
ekleyene kadar hiçbir kullanıcı uygulamayı masaüstüne yükleyemez.
Daha sonra imzalanacak bir AIRI paketi oluşturma
❖ Dijital İmza iletişim kutusunda Daha Sonra İmzalanacak Bir AIRI Paketi Hazırla'yı seçin ve Tamam'ı tıklatın.
Dijital imza durumu daha sonra imzalanacak bir AIRI paketi hazırlamayı seçtiğinizi gösterecek şekilde değişir ve
Ayarla düğmesi de Değiştir düğmesine dönüşür.
23
Bölüm 7: AIR güvenliği
Bu başlık, AIR uygulamasını geliştirirken dikkate almanız gereken güvenlik sorunlarını tartışır.
AIR güvenlik temelleri
AIR uygulamaları, yerel uygulamalardaki kullanıcı ayrıcalıklarının aynılarıyla çalışır. Bu ayrıcalıklar genellikle
dosyaları okuma ve yazma, uygulamaları başlatma, ekranda çizim yapma ve ağla iletişim kurma gibi işletim sistemi
özelliklerine kapsamlı erişim sağlar. Yerel uygulamalarda geçerli olan kullanıcıya özgü ayrıcalıklar gibi işletim sistemi
kısıtlamaları, aynı şekilde AIR uygulamalarında da geçerlidir.
Adobe® AIR™ güvenlik modeli, Adobe® Flash® Player güvenlik modelinin evrilmiş bir hali olsa da, güvenlik sözleşmesi
tarayıcıdaki içeriğe uygulanan güvenlik sözleşmesinden farklıdır. Bu sözleşme, geliştiricilere tarayıcı tabanlı
uygulamalar için alışılmadık özgürlükler ile zengin deneyimler sağlayan kapsamlı işlevlerin güvenli yollarını sunar.
Çalışma zamanının bellek yönetimi sağlayabilmesi için, AIR uygulamaları, derlenmiş bayt kodu (SWF içeriği) veya
yorumlanmış komut dosyası (JavaScript, HTML) kullanılarak yazılır. Bu, AIR uygulamalarının arabellek taşması ve
bellek bozulması gibi bellek yönetimiyle ilişkili güvenlik açıklarından etkilenme olasılığını en aza indirir. Bunlar, yerel
kodda yazılan masaüstü uygulamalarını etkileyen en yaygın güvenlik açıklarından bazılarıdır.
Yükleme ve güncellemeler
AIR uygulamaları, air uzantısını kullanan AIR yükleyici dosyaları yoluyla dağıtılır. Adobe AIR yüklendiğinde ve bir
AIR yükleyici dosyası açıldığında, çalışma zamanı yükleme işlemini yönetir.
Not: Geliştiriciler bir sürüm, uygulama adı ve yayıncı kaynağı belirtebilir, ancak ilk uygulama yükleme iş akışının
kendisi değiştirilemez. Tüm AIR uygulamaları çalışma zamanı tarafından yönetilen güvenli, düzene koyulmuş ve tutarlı
bir yükleme yordamını paylaştığından, bu kısıtlama kullanıcılar için avantajlıdır. Uygulama özelleştirmesi gerekliyse,
uygulama ilk yürütüldüğünde sağlanabilir.
Çalışma zamanı yükleme konumu
SWF dosyalarının Flash Player tarayıcı eklentisinin yüklenmesini gerektirdiği gibi, AIR uygulamaları da kullanıcının
bilgisayarında önce çalışma zamanının yüklenmesini gerektirir.
Çalışma zamanı, kullanıcının bilgisayarında aşağıdaki konuma yüklenir:
• Mac OS: /Library/Frameworks/
• Windows: C:\Program
Files\Common Files\Adobe AI
Mac OS'de uygulamanın güncellenmiş bir sürümünü yüklemek için, kullanıcının uygulama dizinine yükemek için
yeterli sistem ayrıcalıklarına sahip olması gerekir. Windows'ta, kullanıcının yönetici ayrıcalıklarına sahip olması
gerekir.
Çalışma zamanı iki şekilde yüklenebilir: kesintisiz yükleme özelliğini kullanarak (doğrudan bir web tarayıcısından
yükleme) veya elle yükleme yoluyla. Daha fazla bilgi için bkz. “AIR uygulamalarını Dağıtma, Yükleme ve Çalıştırma”
sayfa 275.
AIR güvenliği
Kesintisiz yükleme (çalışma zamanı ve uygulama)
Kesintisiz yükleme özelliği, geliştiricilere Adobe AIR'i henüz yüklememiş kullanıcılar için düzenlenmiş bir yükleme
deneyimi sağlar. Kesintisiz yükleme yönteminde geliştirici, yüklemeye ilişkin uygulamayı sunan bir SWF dosyası
oluşturur. Kullanıcı uygulamayı yüklemek için SWF dosyasını tıklattığında, SWF dosyası çalışma zamanını saptamaya
çalışır. Çalışma zamanı saptanamazsa, yüklenir ve hemen geliştirici uygulamasına ilişkin yükleme işlemiyle
etkinleştirilir.
Elle yükleme
Alternatif olarak, kullanıcı AIR dosyasını açmadan önce çalışma zamanını elle indirip yükleyebilir. Daha sonra
geliştirici AIR dosyasını farklı şekillerde dağıtabilir (örneğin, e-posta veya bir web sitesindeki HTML linki yoluyla).
AIR dosyası açıldığında, çalışma zamanı uygulama yüklemesini işlemeye başlar.
Bu işlem hakkında daha fazla bilgi için bkz. “AIR uygulamalarını Dağıtma, Yükleme ve Çalıştırma” sayfa 275
Uygulama yükleme akışı
AIR güvenlik modeli, kullanıcıların AIR uygulamasının yüklenip yüklenmeyeceğine karar vermelerine olanak tanır.
AIR yükleme deneyimi, kullanıcıların güvenle ilgili bu kararı daha kolay vermelerini sağlayan yerel uygulama yükleme
teknolojilerinin üzerinde çeşitli iyileştirmeler sağlar.
• Çalışma zamanı, AIR uygulaması bir web tarayıcısındaki linkten yüklendiğinde bile, tüm işletim sistemlerinde
tutarlı bir yükleme deneyimi sağlar. Çoğu yerel uygulama yükleme deneyimi, güvenlik bilgisi sağlıyorsa bile, bunu
tarayıcıya veya diğer uygulamalara bağlı olarak sağlar.
• AIR uygulaması yükleme deneyimi, uygulamanın kaynağını ve uygulamanın hangi ayrıcalıkları kullanabileceğine
ilişkin bilgiyi tanımlar (kullanıcı yüklemenin ilerlemesine izin verirse).
• Çalışma zamanı, AIR uygulamasının yükleme işlemini yönetir. AIR uygulaması, çalışma zamanının kullandığı
yükleme işlemini değiştiremez.
Genellikle, kullanıcılar güvenmedikleri veya doğrulanamayan bir kaynaktan gelen masaüstü uygulamalarını
yüklememelidir. Yerel uygulamalara ilişkin güvenlik kanıtının zorluğu, diğer yüklenebilir uygulamalar için olduğu
gibi, AIR uygulamaları için de aynı şekilde geçerlidir.
Uygulama hedefi
Yükleme dizini, aşağıdaki seçeneklerden biri kullanılarak ayarlanabilir:
1 Kullanıcı, yükleme sırasında hedefi özelleştirebilir. Uygulama, kullanıcının belirttiği yere yüklenir.
2 Kullanıcı yükleme hedefini değiştirmezse, uygulama çalışma zamanı tarafından belirlenen varsayılan yola yüklenir:
• Mac OS: ~/Uygulamalar/
• Windows XP ve öncesi: C:\Program
Dosyaları\
• Windows Vista: ~/Apps/
Geliştirici uygulama tanımlayıcı dosyasında bir installFolder ayarı belirlerse, uygulama bu dizinin bir alt yoluna
yüklenir.
AIR güvenliği
AIR dosya sistemi
AIR uygulamaları için yükleme işlemi, geliştiricinin AIR yükleyici dosyasına dahil ettiği tüm dosyaları kullanıcının
yerel bilgisayarına kopyalar. Yüklenen uygulama şunlardan oluşur:
• Windows: AIR yükleyici dosyasında bulunan tüm dosyaları içeren bir dizin. Çalışma zamanı AIR uygulamasının
yüklenmesi sırasında bir exe dosyası da oluşturur.
• Mac OS: AIR yükleyici dosyasının tüm içeriğini içeren bir app dosyası. Bu, Finder'daki "Paket İçeriğini Göster"
seçeneği kullanılarak denetlenebilir. Çalışma zamanı, bu app dosyasını AIR uygulaması yüklemesinin bir parçası
olarak oluşturur.
AIR uygulaması şu şekilde çalıştırılır:
• Windows: Yükleme klasöründeki .exe dosyasını veya bu dosyaya karşılık gelen bir kısayolu çalıştırarak (Başlangıç
Menüsü veya masaüstündeki bir kısayol gibi).
• Mac OS: .app dosyasını veya bunu işaret eden bir takma adı çalıştırarak.
Uygulama dosya sistemi, uygulama işleviyle ilişkili alt dizinler de içerir. Örneğin, şifrelenmiş yerel depoya yazılmış
bilgi, uygulamanın uygulama kimliğine göre adlandırılan dizindeki bir alt dizine kaydedilir.
AIR uygulama depolaması
AIR uygulamaları, kullanıcının sabit sürücüsündeki herhangi bir konuma yazma ayrıcalığına sahiptir; ancak,
geliştiriciler uygulamalarına ilişkin yerel depo için app-storage:/ yolunu kullanmaya teşvik edilir. Uygulamadan
app-storage:/ konumuna yazılan dosyalar, kullanıcının işletim sistemine bağlı standart bir konumda
konumlandırılır.
• Mac OS'de: <appData> kullanıcının “tercihler klasörü”, genellikle
/Kullanıcılar/<user>/Kitaplık/Tercihler olduğunda, uygulamanın depolama dizini
<appData>/<appId>/Yerel Depo/ olur.
• Windows'ta: <appData> kullanıcının CSIDL_APPDATA “Özel Klasör”ü, genellikle
C:\Belgeler ve
Ayarlar\<userName>\Uygulama Verileri olduğunda, uygulamanın depolama dizini
<appData>\<appId>\Yerel Depo\ olur.
Uygulama depolama dizinine air.File.applicationStorageDirectory özelliği yoluyla erişebilirsiniz.
İçindekilere File sınıfının resolvePath() yöntemini kullanarak erişebilirsiniz. Ayrıntılar için bkz. “Dosya sistemiyle
çalışma” sayfa 97.
Adobe AIR'i güncelleme
Kullanıcı, çalışma zamanının güncellenmiş bir versiyonunu gerektiren bir AIR uygulaması yüklediğinde, çalışma
zamanı otomatik olarak gerekli çalışma zamanı güncellemesini yükler.
Kullanıcı, çalışma zamanını güncellemek için bilgisayara ilişkin yönetici ayrıcalıklarına sahip olmalıdır.
AIR uygulamalarını güncelleme
Yazılım güncellemelerinin geliştirilmesi ve konuşlandırılması, yerel kod uygulamalarının karşılaştığı en büyük
güvenlik sorunlarından biridir. AIR API, bu sorunu gidermek için bir mekanizma sağlar: başlatmadan sonra bir AIR
dosyası için uzak konumu kontrol etmek üzere Updater.update() yöntemi çağrılabilir. Güncelleme gerekliyse, AIR
dosyası indirilir, yüklenir ve uygulama yeniden başlatılır. Geliştiriciler bu sınıfı yalnızca yeni işlevler sağlamak için
değil, olası güvenlik açıklarına yanıt vermek için de kullanabilirler.
AIR güvenliği
Not: Geliştiriciler, uygulama tanımlayıcı dosyasının version özelliğini ayarlayarak uygulamanın sürümünü
belirleyebilirler. AIR, sürüm dizesini hiçbir şekilde yorumlamaz. Bu nedenle, “3.0” sürümü “2.0 sürümünden daha yeni
bir sürüm olarak varsayılmaz.” Anlamlı bir sürüm oluşturma tutmak geliştiriciye bağlıdır. Ayrıntılar için bkz.
“Uygulama tanımlayıcı dosyasında özellikleri tanımlama” sayfa 42.
AIR uygulamasını kaldırma
Kullanıcı bir AIR uygulamasını kaldırabilir:
• Windows'ta: Uygulamayı kaldırmak için Program Ekle/Kaldır panelini kullanma.
• Mac OS'de: App dosyasını yükleme konumundan silme
AIR uygulamasının kaldırılması, uygulama dizinindeki tüm dosyaları kaldırır. Ancak, uygulamanın uygulama
dizininin dışına yazmış olabileceği dosyaları kaldırmaz. AIR uygulamalarının kaldırılması, AIR uygulamasının
uygulama dizininin dışındaki dosyalarda yaptığı değişiklikleri geri almaz.
AIR şu şekilde kaldırılabilir:
• Windows'ta: Denetim Masası'ndan Program Ekle/Kaldır'ı çalıştırdıktan sonra Adobe AIR'i ve daha sonra “Kaldır”ı
seçerek.
• Mac OS'de: Uygulamalar dizinindeki Adobe AIR Uninstaller uygulamasını çalıştırarak.
Yöneticiler için Windows kayıt defteri ayarları
Windows'ta, yöneticiler bilgisayarı AIR uygulamasını ve çalışma zamanı güncellemelerini engelleyecek (veya bunlara
izin verecek) şekilde yapılandırabilir. Bu ayarlar, Windows kayıt defterinde aşağıdaki anahtarın altında bulunur:
HKLM\Yazılım\Politikalar\Adobe\AIR. Bunlar, aşağıdakileri içerir:
Kayıt defteri ayarı
Açıklama
AppInstallDisabled
AIR uygulamasının yüklenebileceğini ve kaldırılabileceğini belirtir. “İzinli” için 0, “izinli değil” için 0 olarak
ayarlanır.
UntrustedAppInstallDisabled
Güvenilmeyen AIR uygulamalarının (güvenilir bir sertifika içermeyen uygulamalar) yüklenmesine izin
verildiğini belirtir (bkz. “AIR dosyasını dijital olarak imzalama” sayfa 284). “İzinli” için 0, “izinli değil” için 0
olarak ayarlanır.
UpdateDisabled
Çalışma zamanının arka plan görevi veya açık yüklemenin bir parçası olarak güncellenebileceğini belirtir.
“İzinli” için 0, “izinli değil” için 0 olarak ayarlanır.
Sanal alanlar
AIR, izinleri AIR uygulamasındaki dahili ve harici her bir dosyaya göre tanımlayan kapsamlı bir güvenlik mimarisi
sağlar. İzinler, dosyalara kaynaklarına göre verilir ve sanal alan adı verilen mantıksal güvenlik gruplamalarına atanır.
AIR uygulaması sanal alanları hakkında
Sanal alanların çalışma zamanı güvenlik modeli, uygulama sanal alanı eklemesini içeren Flash Player güvenlik
modelinden oluşur. Uygulama sanal alanında olmayan dosyalar, Flash Player güvenlik modeli tarafından belirtilenlere
benzer güvenlik kısıtlamaları içerir.
AIR güvenliği
Çalışma zamanı, kodun erişebileceği verilerin aralığını ve yürütebileceği işlemleri tanımlamak için bu güvenlik sanal
alanlarını kullanır. Yerel güvenliği sağlamak için, her bir sanal alandaki dosyalar diğer sanal alandaki dosyalardan
ayrılır. Örneğin, harici bir İnternet URL'sinden AIR uygulamasına yüklenen bir SWF dosyası uzak bir sanal alana
yerleştirilir ve varsayılan olarak uygulama dizininde yer alan, uygulama sanal alanına atanmış dosyalara komut dosyası
oluşturma iznine sahip değildir.
Aşağıdaki tablo tüm sanal alan türlerini açıklar:
Sanal alan
Açıklama
uygulama
Dosya uygulama dizininde yer alır ve tüm AIR ayrıcalıkları kümesiyle çalışır.
uzak
Dosya, bir İnternet URL'sindendir ve Flash Player'daki uzak dosyalara uygulanan kurallara benzeyen etki
alanına dayalı sanal alan kurallarına göre çalışır. (Her ağ etki alanı için http://www.example.com and
https://foo.example.org gibi ayrı uzak sanal alanlar mevcuttur.)
yerel-güvenli
Dosya, yerel bir dosyadır ve kullanıcı bu dosyayı Ayar Yöneticisi veya Flash Player yapılandırma dosyasını
kullanarak güvenilir olarak belirlemiştir. Dosya yerel veri kaynaklarını okuyabilir ve İnternet'le iletişim
kurabilir, ancak tüm AIR ayrıcalıkları kümesine sahip değildir.
ağ iletişimiyle yerel
Dosya, ağ hedefiyle yayınlanmış yerel bir SWF dosyasıdır, ancak kullanıcı tarafından açık olarak
güvenilmez. Dosya, İnternet'le iletişim kurabilir, ancak yerel veri kaynaklarını okuyamaz. Bu sanal alan,
yalnızca SWF içeriği tarafından kullanılabilir.
dosya sistemiyle yerel
Dosya, ağ hedefiyle yayınlanmamış yerel bir komut dosyasıdır ve kullanıcı tarafından açık olarak
güvenilmez. Bu, güvenilmeyen JavaScript dosyaları içerir. Dosya yerel veri kaynaklarını okuyabilir, ancak
İnternet'le iletişim kuramaz.
Bu başlık, öncelikle uygulama sanal alanına ve uygulama sanal alanının AIR uygulamasındaki diğer sanal alanlarla
ilişkisine odaklanır. Diğer sanal alanlara atanan içeriği kullanan geliştiriciler, Flash Player güvenlik modeli hakkınaki
diğer belgeleri de okumalıdır. Bkz. ActionScript 3.0'ı Programlama
(http://www.adobe.com/go/flashCS3_progAS3_security_tr) belgesi ve Flash Player 9 Security belgesi
(http://www.adobe.com/go/fp9_0_security_tr) içindeki “Flash Player Security” bölümü.
Uygulama sanal alanı
Uygulama yüklendiğinde, AIR yükleyici dosyasında bulunan tüm dosyalar kullanıcının bilgisayarında bir uygulama
dizinine yüklenir. Geliştiriciler, koddaki bu dizine app:/ URL şeması (bkz. “URL'lerde AIR URL şemalarını kullanma”
sayfa 271) yoluyla başburabilir. Uygulama dizin ağacındaki tüm dosyalar, uygulama çalıştığında uygulama sanal
alanına atanır. Uygulama sanal alanındaki içerik, yerel dosya sistemiyle etkileşim dahil, bir AIR uygulamasının
kullanabileceği tüm ayrıcalıklarla donatılmıştır.
Çoğu AIR uygulaması, uygulamayı çalıştırmak için yalnızca yerel olarak yüklenen bu dosyaları kullanır. Ancak, AIR
uygulamaları yalnızca uygulama dizinindeki dosyalarla kısıtlanmamıştır - tüm kaynaklardan tüm dosya türlerini
yükleyebilir. Bu, kullanıcı bilgisayarındaki yerel dosyaların yanı sıra, yerel ağda ve İnternet'te bulunan kullanılabilir
harici kaynaklardaki dosyaları da içerir. Dosya türünün güvenlik kısıtlamaları üzerinde etkisi yoktur; yüklenen HTML
dosyaları, aynı kaynaktan yüklenen SWF dosyalarıyla aynı güvenlik ayrıcalıklarına sahiptir.
Uygulama güvenlik sanal alanındaki içerik, diğer sanal alanlardaki içeriğin kullanımının engellendiği AIR API'lerine
erişebilir. Örneğin, uygulamaya ilişkin uygulama tanımlayıcı dosyasının içeriğini döndüren
air.NativeApplication.nativeApplication.applicationDescriptor özelliği, uygulama güvenlik sanal
alanındaki içerikle kısıtlanmıştır. Başka bir kısıtlanmış API örneği, yerel dosya sistemine okuma ve yazma için
yöntemler içeren FileStream sınıfıdır.
Yalnızca uygulama güvenlik sanal alanındaki içerik tarafından kullanılabilen ActionScript API'leri Adobe AIR için
ActionScript 3.0 Dil Başvurusu içinde AIR logosuyla gösterilir. Bu API'lerin diğer sanal alanlarda kullanılması, çalışma
zamanının SecurityError istisnası atmasına neden olur.
AIR güvenliği
HTML içeriği (HTMLLoader nesnesindeki), tüm AIR JavaScript API'leri (AIRAliases.js dosyasının kullanımı
sırasında window.runtime özelliği veya air nesnesi yoluyla kullanılabilen) uygulama güvenlik sanal alanındaki içerik
tarafından kullanılabilir. Başka bir sanal alandaki HTML içeriği window.runtime özelliğine erişime sahip değildir, bu
nedenle bu içerik AIR API'lerine erişemez.
JavaScript ve HTML kısıtlamaları
Uygulama güvenlik sanal alanındaki HTML içeriği için, kod yüklendikten sonra dizeleri dinamik olarak yürütülebilir
koda dönüştürebilen API'lerin kullanımına ilişkin sınırlamalar mevcuttur. Bunun amacı, uygulamanın yanlışlıkla
uygulama dışı kaynaklardan (güvenli olmayabilecek ağ etki alanları gibi) kod yerleştirmesini (ve yürütmesini)
engellemektir. Bir örnek, eval() işlevi kullanımıdır. Ayrıntılar için bkz. “Farklı sanal alanlardaki içerik için kod
kısıtlamaları” sayfa 31.
ActionScript metin alanı içeriğindeki img etiketlerindeki kısıtlamalar
Olası kimlik avı saldırılarını önlemek için, uygulama güvenlik sanal alanında yer alan SWF içeriğindeki ActionScript
TextField nesnelerinde bulunan HTML içeriğinde img etiketleri yoksayılır.
Asfunction kısıtlamaları
Uygulama sanal alanındaki içerik, ActionScript 2.0 metin alanlarındaki HTML içeriğinde asfunction protokolünü
kullanamaz.
Etki alanları arası kalıcı önbelleğe erişim yok
Uygulama sanal alanındaki SWF içeriği, Flash Player 9 Update 3'e eklenmiş bir özellik olan etki alanları arası önbelleği
kullanamaz. Bu özellik, Flash Player'ın Adobe platform bileşen içeriğini kalıcı olarak önbelleğe almasını ve bu içeriği
talep üzerine yüklenen SWF içeriğinde yeniden kullanmasını sağlar (içeriğin birçok kez yüklenme ihtiyacını ortadan
kaldırır).
Uygulama dışı sanal alanlardaki içeriğin ayrıcalıkları
Ağdan veya İnternet'ten yüklenen dosyalar, uzak sanal alana atanır. Uygulama dizininin dışından yüklenen dosyalar
dosya sistemiyle yerel, a ileti imiyle yerel veya yerel-güvenilir sanal alana atanır; bu dosyanın nasıl
oluşturulduğuna ve kullanıcının Flash Player Global Ayarları Yöneticisi yoluyla dosyaya açık olarak güvenip
güvenmediğine bağlıdır. Ayrıntılar için bkz.
http://www.macromedia.com/support/documentation/tr/flashplayer/help/settings_manager.html.
JavaScript ve HTML kısıtlamaları
Uygulama güvenlik sanal alanındaki içerikten farklı olarak, uygulama dışı bir güvenlik sanal alanında yer alan
JavaScript içeriği, dinamik olarak oluşturulan kodu yürütmek için her zaman eval() işlevini çağırabilir . Ancak,
uygulama dışı güvenlik sanal alanında JavaScript için kısıtlamalar mevcuttur. Bunlar:
• Uygulama dışı sanal alandaki JavaScript kodunun window.runtime nesnesine erişimi yoktur, ve aynı şekilde bu
kod AIR API'lerini yürütemez.
• Varsayılan olarak, uygulama dışı güvenlik sanal alanındaki içerik, isteği çağıran etki alanı dışındaki etki
alanlarından veri yüklemek için XMLHttpRequest çağrılarını kullanamaz. Ancak, uygulama kodu mevcut karede
veya iframe'de allowCrossdomainXHR niteliğini ayarlayarak uygulama dışı içeriğe bunu yapması için izin verebilir.
Daha fazla bilgi için bkz. “Farklı etki alanlarındaki içerikler arasında komut dosyası oluşturma” sayfa 34.
• JavaScript window.open() yönteminin çağrılmasına ilişkin kısıtlamalar mevcuttur. Ayrıntılar için bkz. “JavaScript
window.open() yönteminin çağrılmasına ilişkin kısıtlamalar” sayfa 33.
Ayrıntılar için bkz. “Farklı sanal alanlardaki içerik için kod kısıtlamaları” sayfa 31.
AIR güvenliği
CSS, kare, iframe ve img öğelerinin yüklenmesine ilişkin kısıtlamalar
Uzak (ağ) güvenlik sanal alanlarındaki HTML içeriği uzak etki alanlarından (ağ URL'lerinden) yalnızca kare, iframe
ve img içeriği yükleyebilir.
Dosya sistemiyle yerel, ağ iletişimiyle yerel veya yerel-güvenilir sanal alanlardaki HTML içeriği yerel sanal alanlardan
(uygulamadan veya ağ URL'lerinden değil) yalnızca kare, iframe ve img içeriğini okuyabilir.
HTML güvenliği
Çalışma zamanı, HTML ve JavaScript'teki olası güvenlik açıklarının üstesinden gelmek için kurallar uygular ve
mekanizmalar sağlar. Uygulamanız temel olarak JavaScript'te yazılmış olduğunda veya HTML ve JavaScript içeriğini
SWF tabanlı bir uygulamaya yüklediğinizde aynı kurallar uygulanır. Uygulama sanal alanında ve uygulama dışı
güvenlik sanal alanındaki içerik (bkz. “Sanal alanlar” sayfa 26) farklı ayrıcalıklara sahiptir. Iframe'e veya kareye içerik
yüklenirken, çalışma zamanı, karedeki veya iframe'deki içeriğin uygulama güvenlik sanal alanındaki içerikle güvenli
biçimde iletişim kurmasını sağlayan güvenli bir sanal alan köprüsü mekanizması sağlar.
Bu başlık, AIR HTML güvenlik mimarisini ve uygulamanızı kurmak için iframe'lerin, çerçevelerin ve sanal alan
köprüsünün nasıl kullanılacağını açıklar.
Daha fazla bilgi için bkz. “Güvenlik ilişkili JavaScript hatalarını önleme” sayfa 207.
HTML tabanlı uygulamanızın yapılandırılmasına genel bakış
Çerçeveler ve iframe'ler, AIR'de HTML içeriğinin düzenlenmesi için uygun bir yapı sağlar. Çerçeveler, hem veri
kalıcılığını korumak hem de uzak içerikle güvenli bir şekilde çalışmak için yollar sağlar.
AIR'de HTML, normal, sayfa tabanlı düzenini koruduğundan, HTML içeriğinizin üst karesi farklı bir sayfaya
“geçtiğinde” HTML ortamı tamamen yenilenir. Kareleri ve iframe'leri, tarayıcıda çalışan bir web uygulaması için
yapacağınız gibi veri kalıcılığını korumak amacıyla kullanabilirsiniz. Üst karede ana uygulama nesnelerinizi
tanımladığınızda, bu nesneler karenin yeni bir sayfaya geçmesine izin vermediğiniz sürece korunur. Uygulamanın
geçici bölümlerini yüklemek ve görüntülemek için alt kareleri ve iframe'leri kullanın. (Veri kalıcılığını korumak için
karelerin yanı sıra veya karelerin yerine kullanılabilecek çeşitli yollar mevcuttur. Bunlar tanımlama bilgilerini, yerel
paylaşılan nesneleri, yerel dosya deposunu, şifrelenmiş dosya deposunu ve yerel veritabanı deposunu içerir.)
AIR'de HTML, yürütülebilir kod ve veriler arasındaki normal, bulanık çizgisini korur. Bu nedenle AIR, HTML
ortamının üst karesindeki içeriği uygulama sanal alanına yerleştirir ve bir metin dizesini yürütülebilir bir nesneye
dönüştürebilen eval() gibi tüm işlemleri kısıtlar. Bu kısıtlama, uygulama uzak içerik yüklemediğinde bile uygulanır.
AIR'deki uzak HTML içeriğiyle güvenli bir biçimde çalışmak için kareleri ve iframe'leri kullanmalısınız. Uzak içerik
yüklemediğinizde bile, içeriğin eval() kısıtlaması olmadan çalışabilmesi için içeriği sanal alandaki alt karede
çalıştırmanız daha uygun olabilir. (Bazı JavaScript uygulama çerçevelerini kullanırken sanal alana yerleştirme işlemi
gerekli olabilir.) Uygulama sanal alanındaki JavaScript kısıtlamalarının tam listesi için bkz. “Farklı sanal alanlardaki
içerik için kod kısıtlamaları” sayfa 31.
AIR'de HTML uzak, büyük olasılıkla güvenli olmayan içerik yükleme özelliğini koruduğundan, AIR, bir etki
alanındaki içeriğin farklı bir etki alanındaki içerikle etkileşime girmesini engelleyen aynı kaynak politikasını uygular.
Uygulama içeriği ve farklı etki alanındaki içerik arasında etkileşime izin vermek için, üst ve alt kare arasında arabirim
olarak görev yapacak bir köprü kurabilirsiniz.
Üst-alt sanal alan ilişkisini kurma
AIR, HTML kare ve iframe öğelerine sandboxRoot ve documentRoot niteliklerini ekler. Bu nitelikler, uygulama
içeriğini başka bir etki alanından gelmiş gibi ele almanızı sağlar:
AIR güvenliği
Nitelik
Açıklama
sandboxRoot
Kare içeriğinin yerleştirileceği sanal alan ve etki alanını belirlemek için kullanılacak URL. URL şemasının kullanması
gereken file:, http: veya https:.
documentRoot
Kare içeriğinin yükleneceği kaynak URL. URL şemasının kullanması gereken file:, app: veya app-storage:.
Aşağıdaki örnek, uygulamanın sanal alan alt dizinine yüklenen içeriği uzak sanal alanda ve www.example.com etki
alanında çalışacak biçimde eşler:
<iframe
src="ui.html"
sandboxRoot="http://www.example.com/local/"
documentRoot="app:/sandbox/">
</iframe>
Farklı sanal alanlarda veya etki alanlarında üst ve alt kareler arasında köprü kurma
AIR, her alt karenin window nesnesine childSandboxBridge ve parentSandboxBridge özelliklerini ekler. Bu
özellikler, üst ve alt kare arasında arabirim olarak görev yapacak köprüleri tanımlamanızı sağlar. Her köprü bir yöne
gider:
childSandboxBridge — childSandboxBridge özelliği alt karenin üst karedeki içeriğe bir arabirim göstermesini
sağlar. Arabirim göstermek için childSandbox özelliğini alt karedeki bir işleme veya nesneye ayarlarsınız. Böylece
nesneye veya işleve üst karedeki içerikten erişebilirsiniz. Aşağıdaki örnek, alt karede çalışan bir komut dosyasının bir
işlev ve bir özellik içeren nesneyi üst öğesine nasıl gösterdiğini açıklar:
var interface = {};
interface.calculatePrice = function(){
return .45 + 1.20;
}
interface.storeID = "abc"
window.childSandboxBridge = interface;
Bu alt içerik, "alt"kimli i atanmış bir iframe içindeyse, karenin childSandboxBridge özelliğini okuyarak üst
içerikten arabirime erişebilirsiniz:
var childInterface = document.getElementById("child").childSandboxBridge;
air.trace(childInterface.calculatePrice()); //traces "1.65"
air.trace(childInterface.storeID)); //traces "abc"
parentSandboxBridge — parentSandboxBridge özelliği üst karenin alt karedeki içeriğe bir arabirim göstermesini
sağlar. Arabirim göstermek için alt karenin parentSandbox özelliğini üst karedeki bir işleve veya bir nesneye
ayarlarsınız. Böylece nesneye veya işleve alt karedeki içerikten erişebilirsiniz. Aşağıdaki örnek, üst karede çalışan bir
komut dosyasının saklama işlevi içeren bir nesneyi alt öğeye nasıl gösterdiğini açıklar:
var interface = {};
interface.save = function(text){
var saveFile = air.File("app-storage:/save.txt");
//write text to file
}
document.getElementById("child").parentSandboxBridge = interface;
Alt karedeki içerik, bu arabirimi kullanarak save.txt adlı dosyaya metin kaydedebilir. Ancak, dosya sistemine başka bir
erişimi olmayacaktır. Genellikle, uygulama içeriği diğer sanal alanlara olanaklı en dar arabirimi göstermelidir. Alt
içerik saklama işlevini aşağıdaki şekilde çağırabilir:
var textToSave = "A string.";
window.parentSandboxBridge.save(textToSave);
AIR güvenliği
Alt içerik parentSandboxBridge nesnesinin bir özelliğini ayarlamaya çalıştığında, çalışma zamanı bir SecurityError
istisnası atar. Üst içerik childSandboxBridge nesnesinin bir özelliğini ayarlamaya çalıştığında, çalışma zamanı bir
SecurityError istisnası atar.
Farklı sanal alanlardaki içerik için kod kısıtlamaları
Bu “HTML güvenliği” sayfa 29 başlığında tartışıldığı gibi, çalışma zamanı HTML ve JavaScript'teki olası güvenlik
açıklarının üstesinden gelebilmek için kurallar uygular ve mekanizmalar sağlar. Bu başlık, bu kısıtlamaları listeler.
Kod, bu kısıtlanmış API'leri çağırmaya çalıştığında, çalışma zamanı “Uygulama güvenlik sanal alanındaki JavaScript
kodu için Adobe AIR çalışma zamanı güvenlik ihlali” mesajını içeren bir hata verir.
JavaScript eval() işlevi ve benzer tekniklerin kullanımındaki kısıtlamalar
Uygulama güvenlik sanal alanındaki HTML içeriği için, kod yüklendiken sonra (body öğesinin onload olayı
gönderildikten ve onload işleyici işlevinin yürütülmesi tamamlandıktan sonra) dizeleri dinamik olarak yürütülebilir
koda dönüştürebilen API'lerin kullanımı için sınırlamalar mevcuttur. Bunun amacı, uygulamanın yanlışlıkla
uygulama dışı kaynaklardan (güvenli olmayabilecek ağ etki alanları gibi) kod yerleştirmesini (ve yürütmesini)
engellemektir.
Örneğin, uygulamanız DOM öğesinin innerHTML özelliğine yazmak için uzak bir kaynaktan dize verileri
kullanıyorsa, dize güvenli olmayan işlemler gerçekleştirebilecek yürütülebilir (JavaScript) kod içerebilir. Ancak, içerik
yüklenirken uzak dizelerin DOM'a eklenme riski yoktur.
JavaScript eval() işlevinin kullanımında bir kısıtlama vardır. Uygulama sanal alanındaki kod yüklendikten ve onload
olay işleyicisindeki işlemeden sonra eval() işlevini sınırlı biçimde kullanabilirsiniz. Aşağıdaki kurallar, kodun
uygulama güvenlik sanal alanından yüklenmesinden sonraeval() işlevinin kullanımı için geçerlidir:
• Değişmez içeren ifadeler izinli. Örneğin:
eval("null");
eval("3 + .14");
eval("'foo'");
• Aşağıdaki gibi nesne değişmezleri izinlidir:
{ prop1: val1, prop2: val2 }
• Aşağıdaki gibi nesne değişmezi ayarlayıcı/alıcıları izinli değildir:
{ get prop1() { ... }, set prop1(v) { ... } }
• Aşağıdaki gibi dizi değişmezleri izinlidir:
[ val1, val2, val3 ]
• Aşağıdaki gibi özellik okumaları içeren ifadeler izinli değildir:
a.b.c
• İşlev başlatma izinli değil.
• İşlev tanımları izinli değil.
• Özellik ayarlama izinli değil.
• İşlev değişmezleri izinli değil.
Ancak, kod yüklenirken, onload olayından önce ve onload olay işleyici işlevinin yürütülmesi sırasında bu kısıtlamalar
uygulama güvenlik sanal alanındaki içeriğe uygulanmaz.
AIR güvenliği
Örneğin, kod yüklendikten sonra istisna atan çalışma zamanı aşağıdaki kodla sonuçlanır:
eval("alert(44)");
eval("myFunction(44)");
eval("NativeApplication.applicationID");
Örneğin eval() işlevini çağırma sırasında yapılan gibi dinamik olarak oluşturulan kod, uygulama sanal alanında
izinliyse bir güvenlik riski ortaya çıkarır. Örneğin, bir uygulama yanlışlıkla ağ etki alanından yüklenmiş bir dizeyi
yürütebilir ve bu dize kötü amaçlı bir kod içerebilir. Örneğin, bu kod kullanıcının bilgisayarındaki dosyaları değiştiren
veya silen bir kod olabilir. Veya yerel dosyanın içeriğini güvenilir olmayan bir ağ etki alanına bildiren bir kod olabilir.
Dinamik kod oluşturma yolları şunlardır:
•
eval() işlevini çağırma.
• Uygulama dizininin dışındaki bir komut dosyasını yükleyen komut dosyası etiketleri eklemek için innerHTML
özelliklerini veya DOM işlevlerini kullanma.
• Satır içi kod içeren komut dosyası etikeleri eklemek için innerHTML özelliklerini veya DOM işlevlerini kullanma
(src niteliği yoluyla komut dosyası yüklemek yerine).
• Uygulama dizininin dışıda yer alan bir JavaScript dosyası yüklemek üzere script etiketleri için src niteliğini
ayarlama.
•
Javascript URL şemasını kullama (href="javascript:alert('Test')" için olduğu gibi).
• İlk parametre (işlevin senkronize olmayan bir şekilde çalışacağını tanımlayan) işlev adı (setTimeout('x
= 4',
1000) gibi) yerine bir dize (değerlendirilecek) olduğunda setInterval() veya setTimout() işlevini kullanma.
•
document.write() veya document.writeln() çağırma.
Uygulama güvenlik sanal alanındaki kod, içerik yüklenirken yalnızca bu yöntemleri kullanabilir.
Bu kısıtlamalar, JSON nesne değişmezleriyle eval() işlevinin kullanılmasını engellemez. Bu, uygulama içeriğinizin
JSON JavaScript kitaplığıyla çalışmasını sağlar. Ancak, aşırı yüklü JSON kodu kullanımınız kısıtlanmıştır (olay
işleyicileriyle).
Diğer Ajax çerçeveleri ve JavaScript kod kitaplıkları için, çerçevedeki veya kitaplıktaki kodun dinamik olarak
oluşturulan kodlara ilişkin bu kısıtlamalarla çalışıp çalışmadığını kontrol edin. Çalışmıyorsa, uygulama dışı güvenlik
sanal alanına çerçeveyi veya kitaplığı kullanan içerik dahil edin. Ayrıntılar için bkz. “Uygulama dışı sanal alanlardaki
içeriğin ayrıcalıkları” sayfa 28 ve “Uygulama içeriği ve uygulama dışı içerik arasında komut dosyası oluşturma”
sayfa 38. Adobe, http://www.adobe.com/products/air/develop/ajax/features/ linklerinde uygulama güvenlik sanal
alanını desteklemek için bilinen Ajax çerçevelerinin listesini tutar.
Uygulama güvenlik sanal alanındaki içerikten farklı olarak, uygulama dışı bir güvenlik sanal alanında yer alan
JavaScript içeriği, dinamik olarak oluşturulan kodu yürütmek için her zaman eval() işlevini çağırabilir .
AIR API'lerine erişim sınırlamaları (uygulama dışı sanal alanlar için)
Uygulama dışı sanal alandaki JavaScript kodunun window.runtime nesnesine erişimi yoktur, ve aynı şekilde bu kod
AIR API'lerini yürütemez. Uygulama dışı güvenlik sanal alanındaki içerik aşağıdaki kodu çağırdığında, uygulama bir
TypeError istisnası atar:
try {
window.runtime.flash.system.NativeApplication.nativeApplication.exit();
}
catch (e)
{
alert(e);
}
AIR güvenliği
Uygulama dışı sanal alandaki içerik window.runtime nesnesini tanımadığından, istisna TypeError (tanımlanmamış
değer) türündedir, bu nedenle tanımlanmamış bir değer olarak görülür.
Uygulama dışı sanal alandaki içeriğe komut dosyası köprüsünü kullanarak çalışma zamanı işlevi gösterebilirsiniz.
Ayrıntılar için bkz. “Uygulama içeriği ve uygulama dışı içerik arasında komut dosyası oluşturma” sayfa 38.
XMLHttpRequest çağrılarının kullanımına ilişkin kısıtlamalar
Uygulama güvenlik sanal alanındaki HTML içeriği, HTML içeriği yüklenirken ve onLoad olayı sırasında uygulama
sanal alanının dışından veri yüklemek için senkronize XMLHttpRequest yöntemini kullanamaz.
Varsayılan olarak, uygulama dışı güvenlik sanal alanlarındaki HTML içeriği, isteği çağıran etki alanı dışındaki etki
alanlarından veri yüklemek üzere JavaScript XMLHttpRequest nesnesini kullanmak için izne sahip değildir. Bir frame
veya iframe etiketi allowcrosscomainxhr niteliğini dahil edebilir. Bu niteliğin null dışındaki bir değere ayarlanması,
karedeki veya iframe'deki içeriğin isteği çağıran kodun etki alanı dışındaki etki alanlarından veri yüklemek için
Javascript XMLHttpRequest nesnesi kullanmasına izin verir.
<iframe id="UI"
src="http://example.com/ui.html"
sandboxRoot="http://example.com/"
allowcrossDomainxhr="true"
documentRoot="app:/">
</iframe>
Daha fazla bilgi için bkz. “Farklı etki alanlarındaki içerikler arasında komut dosyası oluşturma” sayfa 34.
CSS, kare, iframe ve img öğelerinin yüklenmesine ilişkin kısıtlamalar (uygulama dışı sanal
alanlardaki içerik için)
Uzak (ağ) güvenlik sanal alanlarındaki HTML içeriği uzak sanal alanlardan (ağ URL'lerinden) yalnızca kare, iframe
ve img içeriği yükleyebilir.
Dosya sistemiyle yerel, ağ iletişimiyle yerel veya yerel-güvenilir sanal alanlardaki HTML içeriği yerel sanal alanlardan
(uygulamadan veya uzak sanal alanlardan değil) yalnızca kare, iframe ve img içeriğini okuyabilir.
JavaScript window.open() yönteminin çağrılmasına ilişkin kısıtlamalar
JavaScript window.open() yöntemine çağrı yoluyla oluşturulan bir pencere, uygulama dışı güvenlik sanal alanından
içerik görüntülediğinde, pencere başlığı ana (başlatılan) pencerenin başlığıyla başlar ve iki nokta karakteriyle devam
eder. Pencere başlığının bu bölümünü ekranın dışına taşımak için kodu kullanamazsınız.
Uygulama dışı güvenlik sanal alanlarındaki içerik, kullanıcı fare veya klavye etkileşimiyle tetiklenen bir olaya yanıt
olarak yalnızca JavaScript window.open() yöntemini başarıyla çağırabilir. Bu, uygulama dışı içeriğin aldatıcı biçimde
kullanılabilecek pencereler oluşturmasını engeller (örneğin kimlik avı saldırıları). Ayrıca, fare veya klavye olayı için
olay işleyici, window.open() yöntemini gecikmeden sonra yürütülmek üzere ayarlayamaz (örneğin setTimeout()
işlevini çağırarak).
Uzak sanal alanlardaki (ağ) içerik, içeriği uzak ağ sanal alanlarında açmak için yalnızca window.open() yöntemini
kullanabilir. İçeriği uygulamadan veya yerel sanal alanlardan açmak için window.open() yöntemini kullanamaz.
Dosya sistemiyle yerel, ağ iletişimiyle yerel veya yerel-güvenli sanal alanlardaki (bkz. “Sanal alanlar” sayfa 26 ) içerik,
içeriği yerel sanal alanlarda açmak için yalnızca window.open() yöntemini kullanabilir. İçeriği uygulamadan veya
uzak sanal alanlardan açmak için window.open() yöntemini kullanamaz.
AIR güvenliği
Kısıtlanmış kodu çağırmada hata
Bu güvenlik kısıtlamaları nedeniyle sanal alanda kullanımı kısıtlanmış olan kodu çağırdığınızda çalıştırma zamanı bir
JavaScript hatası gönderir: "Uygulama güvenlik sanal alanında JavaScript koduna ilişkin Adobe AIR çalıştırma zamanı
güvenlik ihlali."
Farklı etki alanlarındaki içerikler arasında komut
dosyası oluşturma
AIR uygulamaları yüklendiklerinde, özel ayrıcalıklara sahip olurlar. Aynı ayrıcalıkların uygulamanın parçası olmayan
uzak dosyalar ve yerel dosyalar dahil diğer içeriğe verilmemesi önemlidir.
AIR sanal alan köprüsü hakkında
Etki alanlarında yer alan içerik, normalde diğer etki alanlarında yer alan komut dosyalarını çağıramaz. AIR
uygulamalarını ayrıcalıklı bilgi veya kontrolün yanlışlıkla verilmesinden korumak için, uygulama sanal alanındaki
içeriğe (uygulamayla yüklenen içerik) aşağıdaki kısıtlamalar yerleştirilmiştir:
• Uygulama güvenlik sanal alanındaki kod, Security.allowDomain() yöntemini çağırarak diğer sanal alanlara izin
veremez. Uygulama güvenlik sanal alanından bu yöntemin çağrılmasının herhangi bir etkisi olmaz.
• Uygulama dışı içeriğin LoaderContext.securityDomain veya LoaderContext.applicationDomain özelliği
ayarlanarak uygulama sanal alanına aktarılması engellenir.
Yine de AIR uygulamasının ana AIR uygulamasındaki komut dosyalarına denetimli erişime sahip olmak için uzak bir
etki alanından içerik istediği, veya tam tersi durumlar olur. Çalışma zamanı, bunu gerçekleştirmek için iki sanal alan
arasında ağ geçidi olarak görev yapan bir sanal alan köprüsü mekanizması sağlar. Bir sanal alan köprüsü, uzak ve
uygulama güvenlik sanal alanları arasında açık etkileşim sağlar.
Sanal alan köprüsü, hem yüklenmiş hem de yüklenen komut dosyalarının erişebileceği iki nesne gösterir:
•
parentSandboxBridge nesnesi, yüklenen içeriğin yüklenmiş içerikteki komut dosyalarına özellikler ve işlevler
göstermesini sağlar.
•
childSandboxBridge nesnesi, yüklenmiş içeriğin yüklenen içerikteki komut dosyalarına özellikler ve işlevler
göstermesini sağlar.
Sanal alan köprüsü yoluyla gösterilen nesneler başvuruya göre değil, değere göre iletilir. Tüm veriler sıralanmıştır. Bu,
köprünün bir tarafıyla gösterilen nesnelerin diğer tarafıyla ayarlanamayacağı anlamına gelir ve gösterilen tüm nesneler
türsüzdür. Ayrıca, yalnızca basit nesneler ve işlevleri gösterebilirsiniz; karmaşık nesneleri gösteremezsiniz.
Alt içerik parentSandboxBridge nesnesinin bir özelliğini ayarlamaya çalıştığında, çalışma zamanı bir SecurityError
istisnası atar. Benzer şekilde, üst içerik childSandboxBridge nesnesinin bir özelliğini ayarlamaya çalıştığında, çalışma
zamanı bir SecurityError istisnası atar.
Sanal alan köprüsü örneği (SWF)
Bir AIR müzik deposu uygulamasının albümlerin fiyatını yayınlamak için uzak SWF içeriğine izin vermek istediğini,
ancak uzak SWF dosyasının fiyatın sağış fiyatı olup olmadığını açıklamasını istemediğini düşünün. Bu amaçla,
StoreAPI sınıfı fiyatı elde etmek için bir yöntem sağlar, ancak satış fiyatını saklı tutar. Daha sonra StoreAPI sınıfının
bir örneği, uzak SWF'yi yükleyen Loader nesnesinin LoaderInfo nesnesine ait parentSandboxBridge özelliğine
atanır.
AIR güvenliği
Aşağıdaki, AIR müzik deposuna ilişkin koddur:
<?xml version="1.0" encoding="utf-8"?>
<mx:WindowedApplication xmlns:mx="http://www.adobe.com/2006/mxml" layout="absolute"
title="Music Store" creationComplete="initApp()">
<mx:Script>
import flash.display.Loader;
import flash.net.URLRequest;
private var child:Loader;
private var isSale:Boolean = false;
private function initApp():void {
var request:URLRequest =
new URLRequest("http://[www.yourdomain.com]/PriceQuoter.swf")
child = new Loader();
child.contentLoaderInfo.parentSandboxBridge = new StoreAPI(this);
child.load(request);
container.addChild(child);
}
public function getRegularAlbumPrice():String {
return "$11.99";
}
public function getSaleAlbumPrice():String {
return "$9.99";
}
public function getAlbumPrice():String {
if(isSale) {
return getSaleAlbumPrice();
}
else {
return getRegularAlbumPrice();
}
}
</mx:Script>
<mx:UIComponent id="container" />
</mx:WindowedApplication>
StoreAPI nesnesi, normal albüm fiyatını elde etmek için ana uygulamayı çağırır, ancak getSaleAlbumPrice()
yöntemi çağrıldığında “Yok” mesajını döndürür. Aşağıdaki kod StoreAPI sınıfını tanımlar:
AIR güvenliği
public class StoreAPI
{
private static var musicStore:Object;
public function StoreAPI(musicStore:Object)
{
this.musicStore = musicStore;
}
public function getRegularAlbumPrice():String {
return musicStore.getRegularAlbumPrice();
}
public function getSaleAlbumPrice():String {
return "Not available";
}
public function getAlbumPrice():String {
return musicStore.getRegularAlbumPrice();
}
}
Aşağıdaki kod, depo fiyatını bildiren, ancak satış fiyatını bildiremeyen bir PriceQuoter SWF dosyası örneğini temsil eder:
package
{
import flash.display.Sprite;
import flash.system.Security;
import flash.text.*;
public class PriceQuoter extends Sprite
{
private var storeRequester:Object;
public function PriceQuoter() {
trace("Initializing child SWF");
trace("Child sandbox: " + Security.sandboxType);
storeRequester = loaderInfo.parentSandboxBridge;
var tf:TextField = new TextField();
tf.autoSize = TextFieldAutoSize.LEFT;
addChild(tf);
tf.appendText("Store price of album is: " + storeRequester.getAlbumPrice());
tf.appendText("\n");
tf.appendText("Sale price of album is: " + storeRequester.getSaleAlbumPrice());
}
}
}
Sanal alan köprüsü örneği (HTML)
HTML içeriğinde, parentSandboxBridge ve childSandboxBridge özellikleri alt belgenin JavaScript pencere
nesnesine eklenir. HTML içeriğinde köprü işlevlerinin nasıl kurulacağına ilişkin bir örnek için bkz. “Sanal alan köprü
arabirimini kurma” sayfa 221.
AIR güvenliği
API pozlamasını sınırlama
Sanal alan köprüleri pozlanırken, kötüye kullanma derecesini sınırlayan üst düzey API'ler göstermek önemlidir. Köprü
uygulamanızı çağıran içeriğin ödün verilmiş bir içerik olabileceğini aklınızda bulundurun (örneğin kod yerleştirmesi
yoluyla). Bu nedenle, örneğin köprü yoluyla readFile(path:String) yönteminin (rasgele bir dosyanın içeriğini
okuyan) gösterilmesi kötüye kullanım için açık oluşturabilir. Bir yol almayan ve belirli bir dosya okumayan
readApplicationSetting() API'sinin gösterilmesi daha uygundur. Daha anlamsal bir yaklaşım, bir bölümünden
ödün verildiğinde uygulamanın vereceği hasarı sınırlar.
Ayrıca bkz.
“Farklı güvenlik sanal alanlarında çapraz komut dosyası içeriği” sayfa 220
“Uygulama sanal alanı” sayfa 27
“Uygulama dışı sanal alanlardaki içeriğin ayrıcalıkları” sayfa 28
Diske yazma
Bir web tarayıcısında çalışan uygulamalar, kullanıcının yerel dosya sistemiyle sınırlı olarak etkileşime girer. Web
tarayıcıları, web içeriği yüklemenin kullanıcının bilgisayarından ödün verilmesiyle sonuçlanmamasını sağlamak için
güvenlik politikaları uygular. Örneğin, bir web tarayıcısında Flash Player aracılığıyla çalışan SWF dosyaları, önceden
kullanıcının bilgisayarında olan dosyalarla doğrudan etkileşim kuramaz. Paylaşılan nesneler ve tanımlama bilgileri,
kullanıcı tercihlerinin ve diğer verilerin korunması amacıyla kullanıcının bilgisayarına yazılabilir, ancak bu, dosya
sistem etkileşiminin sınırıdır. AIR uygulamaları, yerel olarak kurulduğundan, yerel dosya sistemi içinde okuyup
yazabilme özelliğini içeren farklı bir güvenlik sözleşmesine sahiptir.
Bu özgürlük, geliştiriciler için beraberinde yüksek sorumluluk getirir. Kaza eseri oluşan uygulama tehlikeleri yalnızca
uygulama işlevlerini değil, kullanıcı bilgisayarının bütünlüğünü de tehdit eder. Bu nedenle, geliştiriciler “Geliştiriciler
için en iyi güvenlik uygulamaları” sayfa 39 bölümünü okumalıdır.
AIR kullanıcıları, çeşitli URL şeması kurallarını kullanarak yerel dosya sistemine erişebilir ve dosyaları yazabilirler:
URL şeması
Açıklama
app:/
Uygulama dizinine başka ad. Bu yoldan erişilen dosyalar uygulama sanal alanına atanır ve çalışma zamanı
tarafından verilen tüm ayrıcalıklara sahiptir.
app-storage:/
Yerel depo dizinine başka ad, çalışma zamanı tarafından standartlaştırılmış. Bu yoldan erişilen dosyalar uygulama
dışı bir sanal alana atanır.
file:///
Kullanıcının sabit diskinin kökünü temsil eden başka ad. Bu yoldan erişilen bir dosya, uygulama dizininde
bulunuyorsa uygulama sanal alanına, aksi halde uygulama dışı sanal alana atanır.
Not: AIR uygulamaları app: URL şeması kullanarak içeriği değiştiremezler. Ayrıca, uygulama dizini yönetici ayarları
nedeniyle salt okunur olabilir.
Kullanıcının bilgisayarında yönetici kısıtlamaları olmadığı sürece, AIR uygulamaları kullanıcının sabit sürücüsünde
herhangi bir konuma yazma ayrıcalığına sahiptir. Geliştiricilerin uygulamalarıyla ilişkili yerel depo için appstorage:/ yolunu kullanmaları önerilir. Uygulamadan app-storage:/ hedefine yazılan dosyalar standart bir
konuma yerleştirilir.
• Mac OS'de: kullanıcının tercihler klasörü <appData> olduğunda, bir uygulamanın depo dizini
<appData>/<appId>/Yerel Depo/ olur. Bu genellikle /Kullanıcılar/<user>/Kitaplık/Tercihler
konumundadır.
AIR güvenliği
• Windows'ta: Kullanıcının CSIDL_APPDATA Özel Klasörü <appData> olduğunda, uygulamanın depo dizini
<appData>\<appId>\Local Store\ olur. Bu genellikle, C:\Belgeler ve Ayarlar\<userName>\Uygulama
Verileri konumundadır.
Bir uygulama kullanıcının dosya sisteminde var olan dosyalarla etkileşim kurmak üzere tasarlandıysa, “Geliştiriciler
için en iyi güvenlik uygulamaları” sayfa 39 bölümünü okuduğunuzdan emin olun.
Güvenilmeyen içerikle güvenli biçimde çalışma
Uygulama sanal alanına atanmayan içerik, ancak çalışma zamanının güvenlik ölçütlerini karşılayabilirse
uygulamanıza ek komut dosyası işlevleri sağlayabilir. Bu başlık, uygulama dışı içerikle AIR güvenlik sözleşmesini
açıklar.
Security.allowDomain()
AIR uygulamaları, uygulama dışı içerik için komut dosyası erişimini, Flash Player 9 tarayıcı eklentisinin güvenilmeyen
içerik için komut dosyası erişimini kısıtladığından daha sıkı biçimde kısıtlar. Örneğin, tarayıcıdaki Flash Player'da
yerel-güvenilir sanal alana atanmış bir SWF dosyası System.allowDomain() yöntemini çağırdığında, bu uzak
dosya uzak sanal alandan yerel-güvenilir sanal alana yeniden atanarak, belirtilen etki alanından yüklenen her SWF
dosyasına komut dosyası erişimi verilir. Kullanıcının bilgisayarındaki uygulama dışı dosyalara akılcı olmayan bir
biçimde erişim sağlayacağından, benzer yaklaşıma AIR uygulamalarındaki uygulama içeriğinden izin verilmez.
Security.allowDomain() yöntemine yapılan çağrılar dikkate alınmaksızın, uzak dosyalar uygulama sanal alanına
doğrudan erişemez.
Uygulama içeriği ve uygulama dışı içerik arasında komut dosyası oluşturma
Uygulama içeriği ve uygulama dışı içerik arasında komut dosyası oluşturan AIR uygulamaları, daha karmaşık güvenlik
düzenlemelerine sahiptir. Uygulama sanal alanında yer almayan dosyalar, sanal alan köprüsü kullanımı yoluyla
yalnızca uygulama sanal alanındaki dosyaların özelliklerine ve yöntemlerine erişebilir. Bir sanal alan köprüsü,
uygulama içeriği ve uygulama dışı içerik arasında, iki dosya arasındaki açık etkileşimi sağlayan bir ağ geçidi olarak
görev yapar. Sanal alan köprüleri, doğru kullanıldığında uygulama dışı içeriğin uygulama içeriğinin parçası olan nesne
başvurularına erişimini kısıtlayarak fazladan bir güvenlik katmanı sağlar.
Sanal alan köprülerinin faydaları, örnekle en iyi şekilde gösterilebilir. AIR müzik deposu uygulamasının, depo
uygulamasının sonradan iletişim kurabileceği kendi SWF dosyalarını oluşturmak isteyen reklamcılara bir API
sağlamak istediğini düşünün. Depo, reklamcılara depodan sanatçıları ve CD'leri arayabilecekleri yöntemler sağlamak,
ancak aynı zamanda güvenlik nedenleriyle bazı yöntemleri ve özellikleri üçüncü taraf SWF dosyasının kullanımına
kapatmak istiyor.
Bu işlevleri bir sanal alan köprüsü sağlayabilir. Varsayılan olarak, bir AIR uygulamasına çalışma zamanında harici
olarak yüklenen içerik, ana uygulamadaki yöntemler ve özelliklere erişemez. Geliştirici, özel bir sanal alan köprüsü
uygulamasıyla bu yöntemleri ve özellikleri göstermeden uzak içeriğe servis sağlayabilir. Sanal alan köprüsünü,
yükleyen ve yüklenen içerik arasındaki iletişimi nesne başvurularını göstermeden sağlayan, güvenilen ve
güvenilmeyen içerik arasında yer alan bir patika olarak düşünün.
Sanal alan köprülerinin nasıl güvenli biçimde kullanılacağına ilişkin daha fazla bilgi için bkz. “Farklı etki alanlarındaki
içerikler arasında komut dosyası oluşturma” sayfa 34.
AIR güvenliği
Dinamik olarak güvenilir olmayan SWF içeriği oluşturmaya karşı koruma
Loader.loadBytes() yöntemi, uygulamanın bir bayt dizisinden SWF içeriği oluşturması için bir yol sağlar. Ancak,
uzak kaynaktan yüklenen verilerdeki yerleştirme saldırıları, içerik yükleme sırasında ciddi hasara neden olabilir. Bu,
özellikle oluşturulan SWF içeriği tüm AIR API'leri kümesine erişebiliyorsa, uygulama sanal alanına veri yükleme
sırasında geçerlidir.
loadBytes() yöntemini yürütülebilir SWF kodu oluşturmadan kullanabilen geçerli kullanıcılar vardır. Örneğin,
görüntü zamanlamasını denetlemek için görüntü verileri oluşturmak amacıyla loadBytes() yöntemini
kullanabilirsiniz. Ses oynatma için dinamik SWF oluşturma gibi, kod yürütmeyi kullanan geçerli kullanıcılar da vardır.
AIR'de, loadBytes() yöntemi varsayılan olarak SWF içeriği yüklemenize izin vermez; yalnızca görüntü içeriği
yüklemenize izin verir. AIR'de loadBytes() yönteminin loaderContext özelliği, uygulamanın yürütülebilir SWF
içeriğini yüklemek üzere loadBytes() kullanmasına izin vermek için true olarak ayarlayabileceğiniz
allowLoadBytesCodeExecution özelliğini içerir. Aşağıdaki kod, bu özelliğin nasıl kullanılacağını gösterir:
var loader:Loader = new Loader();
var loaderContext:LoaderContext = new LoaderContext();
loaderContext.allowLoadBytesCodeExecution = true;
loader.loadBytes(bytes, loaderContext);
SWF içeriği yüklemek için loadBytes() çağırdığınızda ve LoaderContext nesnesinin
allowLoadBytesCodeExecution özelliği false (varsayılan) olarak ayarlandığında, the Loader nesnesi bir
SecurityError istisnası atar.
Not: Adobe AIR'in gelecekteki bir sürümünde bu API değişebilir. Bu gerçekleştiğinde, LoaderContext sınıfının
allowLoadBytesCodeExecution özelliğini kullanan içeriği yeniden derlemeniz gerekebilir.
Geliştiriciler için en iyi güvenlik uygulamaları
AIR uygulamaları web teknolojileri kullanılarak oluşturulmuş olsa da, geliştiricilerin tarayıcı güvenlik sanal alanı
içinde çalışmadıklarını bilmeleri önemlidir. Bu, yerel sisteme istemli veya istemsiz zarar verebilecek AIR uygulamaları
oluşturmanın mümkün olduğu anlamına gelir. AIR bu riski en aza indirmeye çalışmaktadır, ancak yine de güvenlik
açıklarının kullanılabileceği yollar mevcuttur. Bu başlık, önemli olası tehlikeleri konu alır.
Dosyaları uygulama güvenlik sanal alanına aktarmakdan doğan risk
Uygulama dizininde bulunan dosyalar, uygulama sanal alanına atanır ve tüm çalışma zamanı ayrıcalıklarına sahiptir.
Yerel dosya sistemine yazan uygulamaların app-storage:/ hedefine yazmaları önerilir. Dosyalar uygulama sanal
alanına atanmadığından ve daha düşük bir güvenlik riski sunduğundan, bu dizin kullanıcının bilgisayarındaki
uygulama dosyalarından ayrı olarak bulunur. Geliştiricilerin şunları dikkate alması önerilir:
• Bir dosyayı, yalnızca gerekli olduğunda bir AIR dosyasına dahil edin (yüklenen uygulamada).
• Bir komut dosyasını yalnızca davranışı tam olarak anlaşılır ve güvenilir olduğunda bir AIR dosyasına dahil edin
(yüklenen uygulamada).
• Uygulama dizinindeki içeriğe yazmayın veya bu içeriği değiştirmeyin. Çalışma zamanı, SecurityError istisnasını
atarak, uygulamaların app:/ URL şemasını kullanarak dosyaları ve dizinleri yazmasını veya değiştirmesini
engeller.
• Kod yürütmesine neden olabilecek AIR API yöntemlerine ilişkin parametreler olan ağ kaynaklarından gelen
verileri kullanmayın. Bu, Loader.loadBytes() yöntemini ve JavaScript eval() işlevini içerir.
AIR güvenliği
Yolları belirlemek için harici bir kaynak kullanmaktan doğan risk
Harici veri veya içerik kullanımı sırasında, AIR uygulamasından ödün verilebilir. Bu nedenle, ağdan veya dosya
sisteminden veri kullanırken özellikle dikkat edin. Güven sorumluluğu nihayetinde geliştiriciye ve kurduğu ağ
bağlantılarına bağlıdır, ancak yabancı veriler yapıları gereği risklidir ve hassas işlemlerde girdi olarak
kullanılmamalıdır. Geliştiriciler, aşağıdakilere karşı uyarılır:
• Dosya adını belirlemek için bir ağ kaynağından verileri kullanma
• Uygulamanın özel bilgi göndermek için kullandığı bir URL yapmak için bir ağ kaynağından verileri kullanma
Güvenli olmayan kimlik bilgilerinin kullanılması, saklanması veya
iletilmesinden doğan risk
Kullanıcı kimlik bilgilerinin kullanıcının yerel dosya sisteminde saklanması, yapısı gereği bu kimlik bilgilerinden ödün
verilebileceği riskini doğurur. Geliştiricilerin şunları dikkate alması önerilir:
• Kimlik bilgilerinin yerel olarak saklanması gerekiyorsa, kimlik bilgilerinin yerel dosya sistemine yazılırken
şifrelenmesi. Çalışma zamanı, EncryptedLocalStore sınıfı aracılığıyla, yüklenen her uygulamaya benzersiz
şifrelenmiş bir depo sağlar. Ayrıntılar için bkz. “Şifreli verileri saklama” sayfa 189.
• Kaynak güvenilir olmadıkça, bir ağ kaynağına şifrelenmemiş kullanıcı kimlik bilgilerini iletmeyin.
• Kimlik bilgileri oluşturmada hiçbir zaman varsayılan bir parola belirlemeyin - kullanıcıların kendi parolalarını
oluşturmalarına izin verin. Varsayılanı bırakan kullanıcılar, kimlik bilgilerini varsayılan parolayı önceden bilen bir
saldırgana göstermiş olurlar
İndirgeme saldırısından doğan risk
Uygulama yükleme sırasında, çalışma zamanı uygulamanın bir sürümünün yüklü olup olmadığını kontrol eder. Bir
uygulama önceden yüklenmişse, çalışma zamanı sürüm dizesini yüklenmekte olan uygulamanın sürümüyle
karşılaştırır. Bu dize farklıysa, kullanıcı yüklemeyi yükseltmeyi seçebilir. Çalışma zamanı, yeni yüklenen sürümün eski
sürümden daha yeni olacağını garanti etmez, yalnızca değişik olduğunu garanti eder. Saldırgan, bir güvenlik açığını
atlatmak için kullanıcıya daha eski bir sürüm dağıtabilir. Bu nedenle, uygulama çalışırken geliştiricinin sürüm
kontrolleri yapması önerilir. Uygulamaların gerekli güncellemeler için ağı kontrol etmesi, iyi bir fikirdir. Bu şekilde,
saldırgan kullanıcının eski sürümü çalıştırmasını sağlasa bile, bu eski sürüm güncellenmesi gerektiğini anlayacaktır.
Ayrıca, uygulamanız için açık bir sürüm belirleme şeması kullanmak, düşük bir sürüm yüklemeleri için kullanıcıların
kandırılmasını zorlaştıracaktır. Uygulama sürümlerinin sağlanmasına ilişkin ayrıntılar için bkz. “Uygulama
tanımlayıcı dosyasında özellikleri tanımlama” sayfa 42.
Kod imzalama
Tüm AIR yükleyici dosyaları kodlarının imzalanmış olması gerekir. Kod imzalama, belirtilen yazılım kaynağının
doğru olduğunu teyit etmeye ilişkin bir şifreleme işlemidir. AIR uygulamaları, bir sertifikayı harici bir sertifika
yetkilisinden (CA) bağlama veya kendi sertifikanızı oluşturma yoluyla imzalanabilir. İyi bilinen bir CA'dan alınan
ticari bir sertifika kesinlikle önerilir ve kullanıcılarınıza sahte bir ürünü değil, sizin uygulamanızı yüklediklerine ilişkin
güvence sağlar. Ancak, kendinden imzalı sertifikalar SDK'dan adt kullanılarak veya Flash, Flex Builder ya da sertifika
oluşturma için adt kullanan herhangi bir uygulama kullanılarak oluşturulabilir. Kendinden imzalı sertifikalar,
yüklenen uygulamanın orijinal olduğuna dair herhangi bir güvence sağlamaz.
AIR uygulamalarını dijital olarak imzalama hakkında daha fazla bilgi için bkz. “AIR dosyasını dijital olarak imzalama”
sayfa 284 ve “Komut satırı araçlarını kullanarak AIR uygulaması oluşturma” sayfa 304.
41
Bölüm 8: AIR uygulamasının özelliklerini
ayarlama
Bir AIR uygulamasını oluşturan tüm dosyaların ve varlıkların dışında, her AIR uygulaması bir uygulama tanımlayıcı
dosyası ister. Uygulama tanımlayıcı dosyası, uygulamanın temel özelliklerini tanımlayan bir XML dosyasıdır.
Adobe® AIR™ Update for Adobe® Flash® CS3 Professional kullanarak AIR uygulamaları geliştirirken, bir AIR projesi
oluşturduğunuzda uygulama tanımlayıcı dosyası otomatik olarak oluşturulur. Komutlar > AIR - Uygulama ve
Yükleyici Ayarları menüsünden uygulama tanımlayıcı ayarlarını değiştirebileceğiniz bir panele ulaşabilirsiniz.
Uygulama tanımlayıcı dosyasını elle de düzenleyebilirsiniz.
Uygulama tanımlayıcı dosyasının yapısı
Uygulama tanımlayıcı dosyası ad, sürüm, telif hakkı, vb. gibi, uygulamanın bütününü etkileyen özellikler içerir.
Uygulama tanımlayıcı dosyası için herhangi bir dosya adı kullanılabilir. Flash CS3 veya CS4'teki varsayılan ayarları
kullanarak bir AIR dosyası oluşturduğunuzda, uygulama tanımlayıcı dosyası application.xml olarak yeniden
adlandırılır ve AIR paketinin içinde özel bir dizine yerleştirilir.
Bu örnek bir uygulama tanımlayıcı dosyasıdır:
<?xml version="1.0" encoding="utf-8" ?>
<application xmlns="http://ns.adobe.com/air/application/1.1">
<id>com.example.HelloWorld</id>
<version>2.0</version>
<filename>Hello World</filename>
<name>Example Co. AIR Hello World</name>
<description>
<text xml:lang="en">This is a example.</text>
<text xml:lang="fr">C'est un exemple.</text>
<text xml:lang="es">Esto es un ejemplo.</text>
</description>
<copyright>Copyright (c) 2006 Example Co.</copyright>
<initialWindow>
<title>Hello World</title>
<content>
HelloWorld-debug.swf
</content>
<systemChrome>none</systemChrome>
<transparent>true</transparent>
<visible>true</visible>
<minimizable>true</minimizable>
<maximizable>false</maximizable>
<resizable>false</resizable>
<width>640</width>
<height>480</height>
<minSize>320 240</minSize>
<maxSize>1280 960</maxSize>
</initialWindow>
<installFolder>Example Co/Hello World</installFolder>
<programMenuFolder>Example Co</programMenuFolder>
AIR uygulamasının özelliklerini ayarlama
<icon>
<image16x16>icons/smallIcon.png</image16x16>
<image32x32>icons/mediumIcon.png</image32x32>
<image48x48>icons/bigIcon.png</image48x48>
<image128x128>icons/biggestIcon.png</image128x128>
</icon>
<customUpdateUI>true</customUpdateUI>
<allowBrowserInvocation>false</allowBrowserInvocation>
<fileTypes>
<fileType>
<name>adobe.VideoFile</name>
<extension>avf</extension>
<description>Adobe Video File</description>
<contentType>application/vnd.adobe.video-file</contentType>
<icon>
<image16x16>icons/avfIcon_16.png</image16x16>
</icon>
</fileType>
</fileTypes>
</application>
Uygulama tanımlayıcı dosyasında özellikleri tanımlama
Uygulama tanımlayıcı dosyası, kökünde, birçok niteliği olan bir application özelliği içerir:
<application version="1.0" xmlns="http://ns.adobe.com/air/application/1.1">
xmlns Varsayılan XML ad alanı olarak tanımlamanız gereken AIR ad alanı. AIR'in her ana sürümüyle (küçük
yamalarla değil) oluşan ad alanı değişiklikleri. “1.0” gibi ad alanının son parçası, uygulama tarafından gerekli kılınan
çalışma zamanı sürümünü gösterir.
minimumPatchLevel İsteğe bağlı. Uygulama tarafından istenen minimum Adobe AIR yama düzeyini belirlemek için
minimumPatchLevel niteliğini kullanın. AIR uygulamaları genellikle yalnızca uygulama tanımlayıcı dosyasındaki ad
alanını tanımlayarak kendileri için gerekli olan AIR sürümünü belirtir. Ad alanı AIR'in her ana sürümü için değişir
(1.0 veya 1.1 gibi). Ad alanı, yama sürümleri için değişmez. Yama sürümleri yalnızca sınırlı bir düzeltme kümesi içerir,
API değişikliği içermez. Genellikle uygulamalar hangi yama sürümünün gerekli olduğunu belirtmez. Ancak bir
yamadaki düzeltme, uygulamadaki bir sorunu giderebilir. Bu durumda uygulama, yamanın uygulama yüklenmeden
önce uygulanmasını sağlamak amacıyla minimumPatchLevel niteliği için bir değer belirtebilir. AIR uygulama
yükleyicisi gerekirse kullanıcıdan gerekli sürümü veya yamayı indirmesini ve yüklemesini ister. Aşağıdaki örnek,
minimumPatchLevel niteliği için bir değer belirten uygulama öğesini gösterir:
<application version="1.0"
xmlns="http://ns.adobe.com/air/application/1.1"
minimumPatchLevel="5331">
Temel uygulama bilgilerini tanımlama
Aşağıdaki öğeler uygulama kimliğini, sürümü, adı, dosya adını, açıklamayı ve telif hakkı bilgilerini tanımlar:
<id>com.example.samples.TestApp</id>
<version>2.0</version>
<filename>TestApp</filename>
<name>
<text xml:lang="en">Hello AIR</text>
<text xml:lang="fr">Bonjour AIR</text>
<text xml:lang="es">Hola AIR</text>
</name>
<description>An MP3 player.</description>
<copyright>Copyright (c) 2008 YourCompany, Inc.</copyright>
id Uygulama kimliği olarak da bilinen, uygulama için benzersiz olan tanımlayıcı bir dize. Nitelik değeri aşağıdaki
karakterlerle sınırlıdır:
• 0–9
• a–z
• a–z
• . (nokta)
• - (tire)
Değer 1 ila 212 karakter arasında olmalıdır. Bu öğe gereklidir.
id dizesi genellikle, ters çevrilen DNS etki alanı adresiyle, Java™ paket veya sınıf adıyla ya da bir Mac OS® X Universal
Type Identifier ile hizalı, noktayla ayrılan bir hiyerarşi kullanır. DNS benzeri biçim zorlanmaz ve AIR, ad ve gerçek
DNS etki alanları arasında bir ilişkilendirme oluşturmaz.
version Uygulamanın sürüm bilgilerini belirtir. (Çalışma zamanının sürümüyle hiçbir ilgisi yoktur). Sürüm dizesi,
uygulama tanımlı bir belirleyicidir. AIR, sürüm dizesini herhangi bir şekilde yorumlamaz. Bu nedenle “3.0”
sürümünün “2.0” sürümünden daha güncel olduğu varsayılmaz. Örnekler: "1.0", ".4", "0.5", "4.9", "1.3.4a". Bu
öğe gereklidir.
filename Uygulama yüklendiğinde uygulamanın dosya adı olarak kullanılacak dize (uzantısız). Uygulama dosyası
çalışma zamanında AIR uygulamasını başlatır. name değeri sağlanmazsa, filename öğesi de yükleme klasörünün adı
olarak kullanılır. Bu öğe gereklidir.
filename özelliği, çeşitli dosya sistemlerinde dosya adları olarak kullanımı yasak olan aşağıdaki karakterler dışında
herhangi bir Unicode (UTF-8) karakterini içerebilir:
Karakter
Onaltılık Kod
çeşitli
0x00 – x1F
*
x2A
"
x22
:
x3A
>
x3C
<
x3E
?
x3F
\
x5C
|
x7C
filename değeri noktayla bitemez.
name (İsteğe bağlı, ancak önerilir) AIR uygulama yükleyicisi tarafından görüntülenen başlık.
Tek bir metin düğümü belirtirseniz (birden çok text öğesi yerine), AIR uygulama yükleyicisi sistem diline
bakılmaksızın bu adı kullanır:
<name>Test Application</name>
AIR 1.0 uygulama tanımlayıcı şeması, ad için yalnızca bir tane basit metin düğümünün tanımlanmasına izin verir
(birden çok text öğesi değil).
AIR 1.1'de name öğesinde birden çok dil belirtebilirsiniz. Örneğin aşağıdaki örnek, adı üç dilde belirtir (İngilizce,
Fransızca ve İspanyolca):
<name>
<text xml:lang="en">Hello AIR</text>
<text xml:lang="fr">Bonjour AIR</text>
<text xml:lang="es">Hola AIR</text>
</name>
Her metin öğesinin xml:lang niteliği, RFC4646'da da (http://www.ietf.org/rfc/rfc4646.txt) tanımlandığı gibi bir dil
kodu belirtir.
AIR uygulama yükleyicisi, kullanıcının işletim sisteminin kullanıcı arabirimi diline en yakın eşleşme olan adı kullanır.
Örneğin, uygulama tanımlayıcı dosyasının name öğesinin en (English) yerel ayarları için bir değer içerdiği bir yükleme
düşünün. İşletim sistemi en (English) adını kullanıcı arabirimi dili olarak tanımlıyorsa, AIR uygulama yükleyicisi en
adını kullanır. Ayrıca sistem kullanıcı arabirimi adı en-US (U.S. English) olduğunda da en adını kullanır. Ancak
kullanıcı arabirimi dili en-US ise ve uygulama tanımlayıcı dosyası hem en-US hem de en-GB adlarını tanımlıyorsa,
AIR uygulama yükleyicisi en-US değerini kullanır. Uygulama, sistem kullanıcı arabirimi dilleriyle eşleşen bir ad
tanımlamazsa, AIR uygulama yükleyicisi, uygulama tanımlayıcı dosyasında tanımlı olan ilk name değerini kullanır.
Hiçbir name öğesi belirtilmemişse, AIR uygulama yükleyicisi filename öğesini uygulama adı olarak görüntüler.
name öğesi yalnızca AIR uygulama yükleyicisinde kullanılan uygulama başlığını tanımlar. AIR 1.1 uygulama
yükleyicisi birden çok dili destekler: Geleneksel Çince, Basitleştirilmiş Çince, İngilizce, Fransızca, Almanca, İtalyanca,
Japonca, Korece, Brezilya Portekizcesi, Rusça ve İspanyolca. AIR uygulama yükleyicisi görüntülenen dilini (uygulama
başlığı ve açıklamasının dışındaki metinler için), sistem kullanıcı arabirimi diline dayalı olarak seçer. Bu dil seçimi,
uygulama tanımlayıcı dosyasındaki ayarlardan bağımsızdır.
name öğesi, çalışan, yüklü uygulama için kullanılabilir olan yerel ayarları tanımlamaz. Çok dilli uygulamalar geliştirme
konusunda ayrıntılar için bkz. “AIR uygulamalarını yerelleştirme” sayfa 294.
description (İsteğe bağlı) AIR uygulama yükleyicisinde görüntülenen uygulama açıklaması.
Tek bir metin düğümü belirtirseniz (birden çok text öğesi değil), AIR uygulama yükleyicisi sistem diline bakılmaksızın
bu açıklamayı kullanır:
<description>This is a sample AIR application.</description>
AIR 1.0 uygulama tanımlayıcı şeması, ad için yalnızca bir tane basit metin düğümünün tanımlanmasına izin verir
(birden çok text öğesi değil).
AIR 1.1'de description öğesinde birden çok dil belirtebilirsiniz. Örneğin aşağıdaki örnek bir açıklamayı üç dilde
belirtir (İngilizce, Fransızca ve İspanyolca):
<description>
<text xml:lang="en">This is a example.</text>
<text xml:lang="fr">C'est un exemple.</text>
<text xml:lang="es">Esto es un ejemplo.</text>
</description>
kodu belirtir.
AIR uygulama yükleyicisi, kullanıcının işletim sisteminin kullanıcı arabirimi diline en yakın eşleşme olan açıklamayı
kullanır. Örneğin, uygulama tanımlayıcı dosyasının description öğesinin en (English) yerel ayarları için bir değer
içerdiği bir yükleme düşünün. Kullanıcının sistemi en (English) adını kullanıcı arabirimi dili olarak tanımlıyorsa, AIR
uygulama yükleyicisi en adını kullanır. Ayrıca sistem kullanıcı arabirimi adı en-US (U.S. English) olduğunda da en
adını kullanır. Ancak sistem kullanıcı arabirimi dili en-US ise ve uygulama tanımlayıcı dosyası hem en-US hem de enGB adlarını tanımlıyorsa, AIR uygulama yükleyicisi en-US değerini kullanır. Uygulama, sistem kullanıcı arabirimi
diliyle eşleşen bir ad tanımlamazsa, AIR uygulama yükleyicisi, uygulama tanımlayıcı dosyasında tanımlı olan ilk
description değerini kullanır.
Çok dilli uygulamalar geliştirme konusunda daha fazla bilgi için bkz. “AIR uygulamalarını yerelleştirme” sayfa 294.
copyright (İsteğe bağlı) AIR uygulaması için telif hakkı bilgileri. Mac OS'de telif hakkı metni, yüklü uygulamanın
Hakkında iletişim penceresinde görüntülenir. Mac OS'de telif hakkı bilgileri ayrıca, uygulamanın Info.plist dosyasının
NSHumanReadableCopyright alanında da kullanılır.
Yükleme klasörünü ve program menü klasörünü tanımlama
Yükleme ve program menü klasörleri aşağıdaki özellik ayarlarıyla tanımlanır:
<installFolder>Acme</installFolder>
<programMenuFolder>Acme/Applications</programMenuFolder>
installFolder (İsteğe bağlı) Varsayılan yükleme dizininin alt dizinini tanımlar.
Windows'ta varsayılan yükleme alt dizini, Program Dosyaları dizinidir. Mac OS'de bu dizin /Applications dizinidir.
Örneğin installFolder özelliği "Acme" olarak ayarlıysa ve bir uygulama "ExampleApp" olarak adlandırılırsa,
uygulama Windows'ta C:\Program Files\Acme\ExampleApp dizinine, MacOS'de /Applications/Acme/Example.app
dizinine yüklenir.
Aşağıda olduğu gibi yuvalanmış bir alt dizin belirtmek istiyorsanız, dizin ayırıcı karakteri olarak eğik çizgi (/)
karakterini kullanın:
<installFolder>Acme/Power Tools</installFolder>
installFolder özelliği, çeşitli dosya sistemlerinde klasör adı olarak kullanımı yasaklanmış olanların dışında tüm
Unicode (UTF-8) karakterlerini içerebilir (istisnaların bir listesi için yukarıda filename özelliğine bakın).
installFolder özelliği isteğe bağlıdır. installFolder özelliği tanımlamazsanız uygulama, name özelliğine dayalı
olarak varsayılan yükleme dizininin alt dizinine yüklenir.
programMenuFolder (İsteğe bağlı) Windows işletim sisteminin Tüm Programlar menüsündeki uygulamanın
kısayollarının hangi konuma yerleştirileceğini belirtir. (Bu ayar şu anda diğer işletim sistemlerinde yoksayılmaktadır.)
Özelliğin değerinde izin verilen karakterlere yönelik kısıtlamalar, installFolder özelliği için geçerli olanlarla
aynıdır. Bu değerin son karakteri olarak eğik çizgi (/) karakterini kullanmayın.
Başlangıç uygulama penceresinin özelliklerini tanımlama
Bir AIR uygulaması yüklendiğinde, çalışma zamanı, uygulamanın başlangıç penceresini oluşturmak için
initialWindow öğesindeki değerleri kullanır. Daha sonra çalışma zamanı content öğesinde belirtilen SWF veya
HTML dosyasını pencereye yükler.
Bu, initialWindow öğesine bir örnektir:
<initialWindow>
<content>AIRTunes.swf</content>
<title>AIR Tunes</title>
<systemChrome>none</systemChrome>
<transparent>true</transparent>
<visible>true</visible>
<minimizable>true</minimizable>
<maximizable>true</maximizable>
<resizable>true</resizable>
<width>400</width>
<height>600</height>
<x>150</x>
<y>150</y>
<minSize>300 300</minSize>
<maxSize>800 800</maxSize>
</initialWindow>
initialWindow öğesinin alt öğeleri, kök içerik dosyasının yükleneceği pencerenin özelliklerini ayarlar.
content content öğesi için belirtilen değer, uygulamanın ana içerik dosyasının URL'sidir. Bu bir SWF dosyası veya
HTML dosyası olabilir. URL, uygulama yükleme klasörünün köküne bağlı olarak belirtilir. (ADL ile bir AIR
uygulamasını çalıştırırken, URL, uygulama tanımlayıcı dosyasını içeren klasöre bağlıdır. Farklı bir kök dizin belirtmek
için, ADL'nin root-dir parametresini kullanabilirsiniz.)
Not: İçerik öğesinin değeri bir URL gibi işlev gördüğü için, içerik dosyasının adındaki karakterler RFC 1738'de belirtilen
kurallara göre URL kodlamalı olmalıdır. Örneğin boşluk karakterleri %20 olarak kodlanmalıdır.
title (İsteğe bağlı) Pencere başlığı.
systemChrome (İsteğe bağlı) Bu niteliği standard olarak ayarlarsanız, işletim sistemi tarafından sağlanan standart
sistem kromu görüntülenir. none olarak ayarlarsanız, hiçbir sistem kromu görüntülenmez. Sistem kromu ayarı
çalışma zamanında değiştirilemez.
transparent (İsteğe bağlı) Uygulama penceresinin alfa karışımını desteklemesini istiyorsanız, "true" olarak
ayarlayın. Saydamlık özelliğine sahip bir pencere daha yavaş çizebilir ve daha fazla bellek gerektirebilir. Saydamlık
ayarı çalışma zamanında değiştirilemez.
Önemli: transparent öğesini true olarak yalnızca systemChromenone olduğunda ayarlayabilirsiniz.
visible (İsteğe bağlı) Ana pencerenin oluşturulduğu andan itibaren görünür olmasını istiyorsanız true olarak
ayarlayın. Varsayılan olarak false değerindedir.
Ana pencereyi başlangıçta gizli bırakmak isteyebilirsiniz, böylece pencerenin konumunda, boyutunda ve içeriğinin
mizanpajında yapılan değişiklikler gösterilmez. Ardından pencerenin activate() yöntemini çağırarak veya visible
özelliğini true olarak değiştirerek pencereyi görüntüleyebilirsiniz. Ayrıntılar için bkz. “Yerel pencerelerle çalışma”
sayfa 53.
x, y, width, height (İsteğe bağlı) Uygulamanın ana penceresinin başlangıç sınırları. Bu değerleri ayarlamazsanız
pencere boyutu, kök SWF dosyasındaki ayarlar tarafından veya HTML ise işletim sistemi tarafından belirlenir.
minSize, maxSize (İsteğe bağlı) Pencerenin minimum ve maksimum boyutları. Ayarlamadığınız takdirde değerler
işletim sistemi tarafından belirlenir.
minimizable, maximizable, resizable (İsteğe bağlı) Pencere için küçültme, büyütme ve yeniden boyutlandırma
seçeneklerinden hangilerinin uygulanabileceğini belirtir. Bu ayarlar varsayılan olarak true şeklindedir.
Not: Mac OS X gibi, pencereleri büyütmenin yeniden boyutlandırma işlemi olduğu işletim sistemlerinde, pencerenin
yakınlaştırılmasını ve yeniden boyutlandırılmasını önlemek için hem büyütülebilir hem de yeniden boyutlandırılabilir
false olarak ayarlı olmalıdır.
Simge dosyalarını belirtme
icon özelliği, uygulama için kullanılacak bir veya daha fazla simge dosyasını belirtir. Bir simge dahil etmek isteğe
bağlıdır. Bir icon özelliği belirtmezseniz, işletim sistemi varsayılan bir simge görüntüler.
Belirtilen yol, uygulama kök dizinine bağlıdır. Simge dosyaları PNG formatında olmalıdır. Aşağıdaki simge
boyutlarının tümünü belirtebilirsiniz:
<icon>
<image16x16>icons/smallIcon.png</image16x16>
<image32x32>icons/mediumIcon.png</image32x32>
<image48x48>icons/bigIcon.png</image48x48>
<image128x128>icons/biggestIcon.png</image128x128>
</icon>
Belirli bir boyut için öğe mevcutsa, dosyadaki görüntü tam olarak belirtilen boyutta olmalıdır. Tüm boyutlar
sağlanmamışsa en yakın boyut, işletim sistemi tarafından simgenin kullanımı için uygun şekilde ölçeklenir.
Not: Belirtilen simgeler AIR paketine otomatik olarak eklenmez. Uygulama paketlendiğinde simge dosyaları doğru,
göreceli konumlarına dahil edilmelidir.
En iyi sonuç için, her kullanılabilir boyut için bir görüntü sağlayın. Buna ek olarak, simgelerin hem 16 hem de 32 bit
renk modlarında düzgün göründüğünden emin olun.
Uygulama güncellemeleri için özel kullanıcı arabirimi sağlama
AIR varsayılan yükleme iletişim kutularını kullanarak uygulamaları yükler ve günceller. Ancak, bir uygulamayı
güncellemek için kendi kullanıcı arabiriminizi de sağlayabilirsiniz. Uygulamanızın güncelleme işlemini kendisinin
işlemesi gerektiğini belirtmek için, customUpdateUI öğesini true olarak ayarlayın:
Uygulamanızın yüklü sürümünde customUpdateUI öğesi true olarak ayarlıyken kullanıcı yeni bir sürüm için AIR
dosyasını çift tıklattığında veya kesintisiz yükleme özelliğini kullanarak uygulamanın güncellemesini yüklediğinde,
çalışma zamanı, varsayılan AIR uygulama yükleyicisi yerine uygulamanın yüklü sürümünü açar. Uygulama
mantığınız güncelleme işlemine nasıl devam edileceğini belirleyebilir. (Bir yükseltme işleminin devam edebilmesi için,
AIR dosyasındaki uygulama kimliği ve yayıncı kimliği yüklü uygulamadakilerle eşleşmelidir.)
Not: customUpdateUI mekanizması, yalnızca uygulamanın önceden yüklenmiş olduğu ve kullanıcının bir güncelleme
içeren AIR yükleme dosyasını çift tıklattığı veya kesintisiz yükleme özelliğini kullanarak uygulamanın güncellemesini
yüklediği durumlarda çalışır. customUpdateUItrue olsa da olmasa da, özel kullanıcı arabiriminizi gerekli şekilde
görüntüleyerek kendi uygulama mantığınızı kullanıp bir güncellemeyi indirebilir ve başlatabilirsiniz.
Daha fazla bilgi için, bkz. “AIR uygulamalarını güncelleme” sayfa 290.
Uygulamanın tarayıcıdan başlatılmasına izin verme
Aşağıdaki ayarı belirtirseniz, yüklenen AIR uygulaması tarayıcı başlatma özelliği kullanılarak başlatılabilir
(kullanıcının bir web tarayıcısındaki bir sayfada bulunan linki tıklatmasıyla):
<allowBrowserInvocation>true</allowBrowserInvocation>
Varsayılan olarak false değerindedir.
Bu ayarı true olarak ayarlarsanız, “Tarayıcı başlatma” sayfa 260'da anlatılan güvenlik sonuçlarını göz önünde
bulundurduğunuzdan emin olun.
Daha fazla bilgi için bkz. “AIR uygulamalarını web sayfasından yükleme ve çalıştırma” sayfa 276.
Dosya türü ilişkilendirmelerini bildirme
fileTypes öğesi sayesinde, bir AIR uygulamasının ilişkilendirildiği dosya türlerini bildirebilirsiniz. Bir AIR
uygulaması yüklendiğinde, bildirilen tüm dosya türleri işletim sistemiyle kaydedilir ve önceden başka bir uygulamayla
ilişkilendirilmemişse, AIR uygulamasıyla ilişkilendirilir. Bir dosya türüyle başka bir uygulama arasındaki mevcut
ilişkiyi geçersiz kılmak için, çalışma zamanında NativeApplication.setAsDefaultApplication() yöntemini
kullanın (tercihen kullanıcının izniyle).
Not: Çalışma zamanı yöntemleri yalnızca uygulama tanımlayıcısında bildirilen dosya türlerinin ilişkilendirmelerini
yönetebilir.
<fileTypes>
<fileType>
<name>adobe.VideoFile</name>
<extension>avf</extension>
<description>Adobe Video File</description>
<contentType>application/vnd.adobe.video-file</contentType>
<icon>
<image16x16>icons/AIRApp_16.png</image16x16>
</icon>
</fileType>
</fileTypes>
fileTypes öğesi isteğe bağlıdır. Mevcutsa, herhangi bir sayıda fileType öğesi içerebilir.
name ve extension öğeleri, dahil ettiğiniz her fileType bildirimi için gereklidir. Aynı ad birden çok uzantı için
kullanılabilir. Uzantı dosya türünü benzersiz bir şekilde tanımlar. (Uzantının önünde nokta olmadan belirtildiğini
unutmayın.) description öğesi isteğe bağlıdır ve işletim sistemi kullanıcı arabirimi tarafından kullanıcıya
görüntülenir. contentType özelliği de isteğe bağlıdır, ancak bazı durumlarda bir dosyayı açmak için işletim sisteminin
en iyi uygulamayı bulmasına yardımcı olur. Değer, dosya içeriğinin MIME türü olmalıdır.
Dosya uzantısı için, uygulama simgesi öğesiyle aynı format kullanılarak simge belirtilebilir. Simge dosyaları ayrıca AIR
yükleme dosyasına da dahil edilmelidir (dosyalar otomatik olarak paketlenmez).
Bir dosya türü AIR uygulamasıyla ilişkilendirildiğinde, kullanıcının bu tür bir dosyayı her açışında uygulama çağrılır.
Uygulama zaten çalışıyorsa, AIR çalışan örneğe InvokeEvent nesnesini gönderir. Aksi takdirde uygulamayı ilk AIR
başlatır. Dosya yolu her iki durumda da NativeApplication nesnesi tarafından gönderilen InvokeEvent nesnesi
tarafından alınabilir. Dosyayı açmak için bu yolu kullanabilirsiniz.
Daha fazla bilgi için bkz. “Dosya ilişkilendirmelerini yönetme” sayfa 265 ve “Komut satırı argümanlarını yakalama”
sayfa 258.
49
Bölüm 9: Adobe AIR uygulamasındaki
yeni işlevler
Bu konu, Adobe® Flash® Player uygulamasında çalışan SWF içeriğinin kullanamadığı Adobe® AIR™ uygulamasındaki
yeni işlevlere genel bir bakış sağlar.
Yeni runtime sınıfları
Aşağıdaki runtime sınıfları Adobe AIR uygulamasında yenidir. Tarayıcıda çalışan SWF içeriği tarafından
kullanılamaz.
Sınıf
Paket
BrowserInvokeEvent
flash.events
Clipboard
flash.desktop
ClipboardFormats
flash.desktop
ClipboardTransferMode
flash.desktop
CompressionAlgorithm
flash.utils
DockIcon
flash.desktop
DRMAuthenticateEvent
flash.events
DRMErrorEvent
flash.events
DRMStatusEvent
flash.events
EncryptedLocalStore
flash.data
File
flash.filesystem
FileListEvent
flash.events
FileMode
flash.filesystem
FileStream
flash.filesystem
FocusDirection
flash.display
HTMLHistoryItem
flash.html
HTMLHost
flash.html
HTMLLoader
flash.html
HTMLPDFCapability
flash.html
HTMLUncaughtScriptExceptionEvent
flash.events
HTMLWindowCreateOptions
flash.html
Icon
flash.desktop
InteractiveIcon
flash.desktop
Adobe AIR uygulamasındaki yeni işlevler
Sınıf
Paket
InvokeEvent
flash.events
NativeApplication
flash.desktop
NativeDragActions
flash.desktop
NativeDragEvent
flash.events
NativeDragManager
flash.desktop
NativeDragOptions
flash.desktop
NativeMenu
flash.display
NativeMenuItem
flash.display
NativeWindow
flash.display
NativeWindowBoundsEvent
flash.events
NativeWindowDisplayState
flash.display
NativeWindowDisplayStateEvent
flash.events
NativeWindowInitOptions
flash.display
NativeWindowResize
flash.display
NativeWindowSystemChrome
flash.display
NativeWindowType
flash.display
NotificationType
flash.desktop
OutputProgressEvent
flash.events
RevocationCheckSettings
flash.security
Screen
flash.display
ScreenMouseEvent
flash.events
SignatureStatus
flash.security
SignerTrustSettings
flash.security
SQLCollationType
flash.data
SQLColumnNameStyle
flash.data
SQLColumnSchema
flash.data
SQLConnection
flash.data
SQLError
flash.errors
SQLErrorEvent
flash.events
SQLErrorOperation
flash.errors
SQLEvent
flash.events
SQLIndexSchema
flash.data
SQLResult
flash.data
SQLSchema
flash.data
Sınıf
Paket
SQLSchemaResult
flash.data
SQLStatement
flash.data
SQLTableSchema
flash.data
SQLTransactionLockType
flash.data
SQLTriggerSchema
flash.data
SQLUpdateEvent
flash.events
SQLViewSchema
flash.data
SystemTrayIcon
flash.desktop
Updater
flash.desktop
URLRequestDefaults
flash.net
XMLSignatureValidator
flash.utils
Ayrıca flash.security paketi IURIDereferencer arabirimini de içerir.
Yeni işlevlere sahip runtime sınıfları
Aşağıdaki sınıflar tarayıcıda çalışan SWF içeriği tarafından kullanılabilir, ancak AIR ek özellikler veya yöntemler
sağlar:
Sınıf
Özellik veya Yöntem
Capabilities
diller
Event
DISPLAYING
EXITING
HTML_BOUNDS_CHANGE
HTML_DOM_INITIALIZE
HTML_RENDER
LOCATION_CHANGE
NETWORK_CHANGE
USER_IDLE
USER_PRESENT
FileReference
uploadUnencoded()
HTTPStatusEvent
HTTP_RESPONSE_STATUS
responseURL
responseHeaders
KeyboardEvent
commandKey
controlKey
LoaderContext
allowLoadBytesCodeExecution
Sınıf
LoaderInfo
parentSandboxBridge
childSandboxBridge
NetStream
resetDRMVouchers()
setDRMAuthenticationCredentials()
URLRequest
followRedirects
manageCookies
shouldAuthenticate
shouldCacheResponse
userAgent
userCache
setLoginCredentials()
URLStream
httpResponseStatus olayı
Stage
nativeWindow
Security
APPLICATION
Bu yeni özelliklerin ve yöntemlerin çoğu yalnızca AIR uygulaması güvenlik sanal alanındaki içerik tarafından
kullanılabilir. Ancak URLRequest sınıflarındaki yeni üyeler, diğer sanal alanlarda çalışan içerik tarafından da
kullanılabilir.
ByteArray.compress() ve ByteArray.uncompress() yöntemlerinin her biri yeni bir algorithm parametresi
içerir, böylece deflate ve zlib sıkıştırmaları arasında seçim yapabilirsiniz.
Hizmet izleme çerçevesi sınıfları
air.net paketi ağ algılamasına yönelik sınıfları içerir. Bu paket yalnızca Adobe AIR uygulamasında çalışan içerik
tarafından kullanılır. ServiceMonitor.swc dosyasına dahildir.
Pakette aşağıdaki sınıflar bulunur:
• ServiceMonitor
• SocketMonitor
• URLMonitor
53
Bölüm 10: Yerel pencerelerle çalışma
Masaüstü pencerelerini oluşturmak ve yönetmek için Adobe® AIR® yerel pencere API'si tarafından sağlanan sınıfları
kullanırsınız.
Yerel pencereler hakkında ek çevrimiçi bilgiler
Yerel pencere API'si ve yerel pencerelerle çalışma hakkında daha fazla bilgiyi aşağıdaki kaynaklarda bulabilirsiniz:
Hızlı Başlangıçlar (Adobe AIR Geliştirici Bağlantısı)
• Bir pencereyle etkileşim kurma
• Yerel bir pencerenin görünümünü ve verdiği hissi özelleştirme
• Tost stili pencereler oluşturma
• Pencerelerin görüntü sırasını denetleme
• Yeniden boyutlandırılabilir, dikdörtgen olmayan pencereler oluşturma
Dil Başvurusu
• NativeWindow
• NativeWindowInitOptions
Adobe Geliştirici Bağlantısı Makaleleri ve Örnekleri
• Flash için Adobe AIR Geliştirici Bağlantısı ('AIR pencereleri'ni arama)
AIR penceresi temelleri
AIR, Flash®, Flex™ ve HTML programlama tekniklerini kullanarak yerel işletim sistemi pencereleri oluşturmak için
kullanımı kolay, platformlar arası bir pencere API'si sunar.
AIR'le uygulamanızın görünümünü geliştirmede büyük bir özgürlüğe sahip olursunuz. Oluşturduğunuz pencereler
Mac'te çalışırken Apple stiline veya Windows'ta çalışırken Microsoft yöntemlerine uyacak biçimde standart bir
masaüstü uygulaması gibi görünebilir. Veya uygulamanız nerede çalışırsa çalışsın kendi stilinizi oluşturmak için Flex
çerçevesinin sağladığı skin desteği olan, genişletilebilir kromu kullanabilirsiniz. Masaüstüne karşı şeffaflık ve alfa
harmanlaması için tam destek sağlayan vektör ve bitmap resimleriyle kendi pencerelerinizi de çizebilirsiniz.
Dikdörtgen pencerelerden sıkıldınız mı? Yuvarlak bir tane çizin.
AIR'deki Pencereler
AIR, pencerelerle çalışmak için üç ayrı API sağlar: ActionScript yönelimli NativeWindow sınıfı, NativeWindow
sınıfını sarak Flex çerçevesi mx:WindowedApplication ve mx:Window sınıfları ve HTML ortamındaki JavaScript
Window sınıfı.
Yerel pencerelerle çalışma
ActionScript pencereleri
Bir NativeWindow sınıfıyla pencereler oluşturduğunuzda, Flash Player sahnesini kullanın ve listeyi doğrudan
görüntüleyin. Bir NativeWindow öğesine görsel bir nesne eklemek için, nesneyi pencere sahnesinin görüntü listesine
veya bu sahnedeki başka bir görüntüleme nesnesine ekleyin.
Flex Framework pencereleri
Flex Framework, NativeWindow API'sini saran kendi pencere bileşenlerini tanımlar. Bu bileşenler, yani
mx:WindowedApplication ve mx:Window, çerçeve dışında kullanılamaz ve bu nedenle Flash Authoring ile
geliştirilmiş AIR uygulamalarında kullanılamazlar.
HTML pencereleri
HTML pencereleri oluşturduğunuzda, içeriği görüntülemek için HTML, CSS ve JavaScript kullanırsınız. HTML
penceresine görsel bir nesne eklemek için, bu içeriği HTML DOM'a eklersiniz. HTML pencereleri, NativeWindow
öğesinin özel bir kategorisidir. AIR ana bilgisayarı HTML pencerelerinde temel NativeWindow örneğine erişim
sağlayan bir nativeWindow özelliği tanımlar. Bu özelliği burada açıklanan NativeWindow özellikleri, yöntemleri ve
olaylarına erişmek için kullanabilirsiniz.
Not: JavaScript Window nesnesi de, mevcut pencere için komut dosyası oluşturmaya yönelik moveTo() ve close() gibi
yöntemlere sahiptir. Örtüşen yöntemler olduğunda, en uygun yöntemi kullanabilirsiniz.
İlk uygulama penceresi
Uygulamanızın ilk penceresi sizin için AIR tarafından otomatik olarak oluşturulur. AIR, uygulama tanımlayıcı
dosyasının initialWindow öğesinde belirtilen parametreleri kullanarak pencere özelliklerini ve içeriğini ayarlar.
Kök içerik bir SWF dosyası ise, AIR bir NativeWindow örneği oluşturur, SWF dosyasını yükler, ve bunu pencere
sahnesine ekler. Kök içerik bir HTML dosyası ise, AIR bir HTML penceresi oluşturur ve HTML'i yükler.
Uygulama tanımlayıcısında belirtilen pencere özellikleri hakkında daha fazla bilgi için bkz. “Uygulama tanımlayıcı
dosyasının yapısı” sayfa 41.
Yerel pencere sınıfları
Yerel pencere API'si aşağıdaki sınıfları içerir:
Paket
Sınıflar
flash.display
•
NativeWindow
•
NativeWindowInitOptions
•
•
NativeWindowResize
•
•
NativeWindowType
Pencere dizesi sabitleri aşağıdaki sınıflarda tanımlanmıştır:
flash.events
•
•
NativeWindowResize
•
•
NativeWindowType
•
NativeWindowBoundsEvent
•
NativeWindowDisplayStateEvent
Yerel pencere olay akışı
Yerel pencereler, ilgili bileşenleri önemli bir değişikliğin gerçekleşmek üzere olduğuna veya gerçekleştiğine dair
bilgilendirmek için olaylar gönderir. Birçok pencere ilişkili olay, çiftler halinde gönderilir. İlk olay, bir değişikliğin
gerçekleşmek üzere olduğuna dair uyarır. İkinci olay, değişikliğin yapıldığını bildirir. Bir uyarı olayını iptal
edebilirsiniz, ancak bir bildirim olayını iptal edemezsiniz. Aşağıdaki sıra, kullanıcı pencerenin büyütme düğmesini
tıklattığında gerçekleşen olay akışını gösterir:
1 NativeWindow nesnesi bir displayStateChanging olayı gönderir.
2 Hiçbir kayıtlı kullanıcı olayı iptal etmezse, pencere büyür.
3 NativeWindow nesnesi bir displayStateChange olayı gönderir.
NativeWindow nesnesi ayrıca pencere boyutu ve konumuyla ilgili değişiklikler için de olaylar gönderir. Pencere,
bu ilgili değişiklikler için uyarı olayları göndermez. İlgili değişiklikler şunlardır:
a Büyütme işlemi nedeniyle pencerenin sol üst köşesi hareket ettiğinde move olayı gönderilir.
b Büyütme işlemi nedeniyle pencere boyutu değiştiğinde resize olayı gönderilir.
Bir NativeWindow nesnesi, pencereyi simge durumuna küçültme, yeniden yükleme, kapatma, taşıma ve yeniden
boyutlandırma sırasında olayları benzer bir sırayla gönderir.
Uyarı olayları yalnızca, pencere kromu veya başka işletim sistemin tarafından kontrol edilen bir mekanizma bir
değişiklik başlattığında gönderilir. Pencere boyutu, konumu veya görüntü durumunu değiştirmek için bir window
yöntemini çağırdığınızda, pencere yalnızca değişikliği bildirmek için bir olay gönderir. İsterseniz pencere
dispatchEvent() yöntemini kullanarak bir uyarı olayı gönderebilir ve değişiklik devam etmeden önce uyarı
olayınızın iptal edilip edilmediğini kontrol edebilirsiniz.
Pencere API sınıfları, yöntemleri, özellikleri ve olayları hakkında ayrıntılı bilgi için bkz. ActionScript 3.0 Dil ve
Bileşen Başvurusu (http://www.adobe.com/go/learn_flash_aslr_tr).
Flash görüntü listesi kullanımı hakkında genel bilgi için ActionScript 3.0'ı Programlama
(http://www.adobe.com/go/programmingAS3_tr) başvurusunun “Görüntü Programlama” bölümüne bakın.
Yerel pencere stili ve davranışını denetleyen özellikler
Aşağıdaki özellikler, bir pencerenin temel görünümü ve davranışını denetler:
•
type
•
systemChrome
•
transparent
Bir pencere oluşturduğunuzda, pencere yapıcısına iletilen NativeWindowInitOptions nesnesindeki bu özellikleri
ayarlarsınız. AIR, özellikleri ilk uygulama penceresi için uygulama tanımlayıcısından okur. (Uygulama
tanımlayıcısında ayarlanamayan ve her zaman normal olarak ayarlanmış olan type özelliği hariç.) Bu özellikler
pencere oluşturulduktan sonra değiştirilemez.
Bu özelliklerin bazı ayarları birbirleriyle uyumsuzdur: transparent özelliği true olarak veya type özelliği hafif
olarak ayarlandığında systemChrome özelliği standart olarak ayarlanamaz.
Pencere türleri
AIR pencere türleri, üç işlevsel pencere türü oluşturmak için yerel işletim sisteminin krom ve görünürlük niteliklerini
birleştirir. Koddaki tür adlarına başvurmak için NativeWindowType sınıfında tanımlanan sabitleri kullanın. AIR,
aşağıdaki pencere türlerini sağlar:
Tür
Açıklama
Normal
Tipik bir pencere. Normal pencereler tam boyutlu krom stilini kullanır ve Windows görev çubuğu ile Mac OS X
pencere penüsünde görünürler.
Hizmet penceresi
Bir araç paleti. Hizmet pencereleri sistem kromunun daha ince bir versiyonunu kullanır ve Windows görev
çubuğu ile Mac OS X pencere menüsünde görünmezler.
Hafif
Hafif pencereler krom içermez ve Windows görev çubuğunda veya Mac OS X pencere menüsünde
görünmezler. Ayrıca, hafif pencereler Windows'ta Sistem (Alt+Ara çubuğu) menüsü içermezler. Hafif
pencereler, açılır kutular gibi kısa süreli görüntü alanları açan bildirim kabarcıkları ve denetimler için uygundur.
type özelliği hafif olarak ayarlandığında systemChrome özelliği yok olarak ayarlanmalıdır.
Pencere kromu
Pencere kromu, kullanıcıların masaüstü ortamında bir pencereyi değiştirmesine olanak veren denetimlerin kümesidir.
Krom öğeleri, başlık çubuğu, başlık çubuğu düğmeleri, kenarlık ve yeniden boyutlandırma kıskaçlarını içerir.
Sistem kromu
systemChrome özelliğini standart veya yok olarak ayarlayabilirsiniz. Pencerenize kullanıcının işletim sistemi
tarafından oluşturulan ve stillendirilen standart denetimler kümesini vermek için standart sistem kromunu seçin.
Pencere için kendi kromunuzu sağlamak istiyorsanız yok olarak ayarlayın. Koddaki sistem kromu ayarlarına
başvurmak için NativeWindowSystemChrome sınıfında tanımlanan sabitleri kullanın.
Sistem kromu sistem tarafından yönetilir. Uygulamanızın denetimlerin kendisine doğrudan erişimi yoktur, ancak
denetimler kullanıldığında gönderilen olaylara tepki verebilir. Pencere için standart krom kullandığınızda,
transparent özelliği false olarak ve type özelliği normal veya hizmet olarak ayarlanmalıdır.
Özel krom
Sistem kromu olmadan bir pencere oluşturduğunuzda, kullanıcı ve pencere arasındaki etkileşimleri işlemek için kendi
krom denetimlerinizi eklemeniz gerekir. Dikdörtgen olmayan, şeffaf pencereler de yapabilirsiniz.
Pencere şeffaflığı
Bir pencerenin masaüstü veya diğer pencerelerle alfa harmanlamasına izin vermek için transparent özelliğini true
olarak ayarlayın. transparent özelliği pencere oluşturulmadan ayarlanmalıdır ve değiştirilemez.
Şeffaf bir pencerenin varsayılan bir arka planı yoktur. Uygulama tarafından çizilen, nesne içermeyen pencere alanları
görünmezdir. Görüntülenen bir nesne birden küçük bir alfa ayarına sahipse, aynı penceredeki, diğer pencerelerdeki ve
masaüstündeki görüntüleme nesneleri de dahil nesnenin altındaki her şey görünür. Alfa harmanlamalı büyük alanlar
oluşturmak uzun sürebilir, bu nedenle efekt tutumlu kullanılmalıdır.
Şeffaf pencereler, şekil açısından düzensiz olan, “yavaşça kaybolan” veya görünmez olan kenarlıklara sahip
uygulamalar oluşturmak istediğinizde kullanışlıdır.
Şeffaflık, sistem kromu içeren pencerelerle kullanılamaz. Ayrıca, HTML'deki SWF ve PDF içeriği şeffaf pencerelerde
görüntülenmez. Daha fazla bilgi için bkz. “HTML sayfasına SWF ve PDF içeriği yüklenirken dikkate alınması
gerekenler” sayfa 231.
Bazı işletim sistemlerinde, donanım ve yazılım yapılandırması veya kullanıcı görüntü seçenekleri nedeniyle şeffaflık
desteklenmeyebilir. Şeffaflık desteklenmediğinde, uygulama siyah bir arka plana karşı birleştirilir. Bu durumlarda,
uygulamanın tamamen şeffaf olan alanları opak siyah olarak görüntülenir.
Statik NativeWindow.supportsTransparency özelliği, pencere şeffaflığının kullanılabilir olup olmadığını bildirir.
Bu özellik false olduğunda, örneğin, kullanıcıya bir uyarı iletişim kutusu veya geri dönüşlü, dikdörtgen, şeffaf
olmayan bir kullanıcı arabirimi görüntüleyebilirsiniz. Şeffaflığın Mac ve Windows işletim sistemleri tarafından her
zaman desteklendiğini unutmayın. Linux işletim sistemlerinde destek, bileşik bir pencere yöneticisi gerektirir, ancak
yine de kullanıcının görüntü seçenekleri veya donanım yapılandırması nedeniyle kullanılamayabilir.
HTML uygulama penceresinde şeffaflık
İçinde bulunduğu pencere şeffaf olsa bile, HTML pencereleri ve HTMLLoader nesnelerinde görüntülenen HTML
içeriğinin arka planı varsayılan olarak opaktır. HTML içeriği için görüntülenen varsayılan arka planı kapatmak için,
paintsDefaultBackground özelliğini false olarak ayarlayın. Aşağıdaki örnek bir HTMLLoader oluşturur ve
varsayılan arka planı kapatır:
var html:HTMLLoader = new HTMLLoader();
html.paintsDefaultBackground = false;
Bu örnek, bir HTML penceresinin varsayılan arka planını kapatmak için JavaScript kullanır:
window.htmlLoader.paintsDefaultBackground = false;
HTML belgesinde bulunan bir öğe, bir arka plan rengi ayarlıyorsa, bu öğenin arka planı şeffaf olmaz. Kısmi bir şeffaflık
(veya opaklık) değerinin ayarlanması desteklenmez. Ancak, benzer bir görsel efekt elde etmek için PNG formatındaki
şeffaf bir grafiği bir sayfanın veya sayfa öğesinin arka planı olarak kullanabilirsiniz.
Görsel bir pencere kataloğu
Aşağıdaki tablo, pencere özellik ayarlarının Mac OS X ve Windows işletim sistemlerindeki farklı bileşimlerinin
oluşturduğu görsel efektleri gösterir:
Pencere ayarları
Mac OS X
Microsoft Windows
Type: normal
SystemChrome: standart
Transparent: false
Type: hizmet
SystemChrome: standart
Transparent: false
Type: Herhangi biri
SystemChrome: yok
Transparent: false
Type: Herhangi biri
SystemChrome: yok
Transparent: true
mxWindowedApplication veya
mx:Window
Type: Herhangi biri
SystemChrome: yok
Transparent: true
Not: Aşağıdaki sistem kromu öğeleri AIR tarafından desteklenmez: OS X Araç Çubuğu, OS X Proxy Simgesi, Windows
başlık çubuğu simgeleri ve alternatif sistem kromu.
Pencereler oluşturma
AIR, bir uygulama için ilk pencereyi otomatik olarak oluşturur, ancak ihtiyacınız olan ek pencereleri oluşturabilirsiniz.
Yerel bir pencere oluşturmak için NativeWindow yapıcı yöntemini kullanın. HTML penceresi oluşturmak için
HTMLLoader createRootWindow() yöntemini kullanın veya bir HTML belgesinden JavaScript window.open()
yöntemini çağırın.
Pencere başlatma özelliklerini belirleme
Pencerenin başlatma özellikleri, masaüstü penceresi oluşturulduktan sonra değiştirilemez. Bu sabit özellikler ve
varsayılan değerleri şunlardır:
Özellik
Varsayılan değer
systemChrome
standard
type
normal
transparent
false
maximizable
true
minimizable
true
resizable
true
Uygulama tanımlayıcı dosyasında AIR tarafından oluşturulan ilk pencereye ilişkin özellikleri ayarlayın. AIR
uygulamasının ana penceresine ilişkin type özelliği her zaman normal olarak ayarlanır. (Tanımlayıcı dosyada
visible, width ve height gibi ek pencere özellikleri belirtilebilir, ancak bu özellikler her zaman değiştirilebilir.)
Uygulamanız tarafından NativeWindowInitOptions sınıfı kullanılarak oluşturulan diğer yerel pencereler ve HTML
pencereleri için özellikleri ayarlayın. Bir pencere oluşturduğunuzda, pencere özelliklerini belirten bir
NativeWindowInitOptions nesnesini NativeWindow yapıcı işlevine veya HTMLLoader createRootWindow()
yöntemine iletmelisiniz.
Aşağıdaki kod, bir hizmet penceresi için NativeWindowInitOptions nesnesi oluşturur:
var options:NativeWindowInitOptions = new NativeWindowInitOptions();
options.systemChrome = NativeWindowSystemChrome.STANDARD;
options.type = NativeWindowType.UTILITY
options.transparent = false;
options.resizable = false;
options.maximizable = false;
Transparent özelliği true olarak veya type özelliği hafif olarak ayarlandığında systemChrome özelliğinin standart
olarak ayarlanması desteklenmez.
Not: JavaScript window.open() işleviyle oluşturulan bir pencere için başlatma özelliklerini ayarlayamazsınız. Ancak,
kendi HTMLHost sınıfınızı uygulayarak bu pencerelerin oluşturulma biçimini geçersiz kılabilirsiniz. Daha fazla bilgi
için bkz. “window.open() için JavaScript çağrılarını işleme” sayfa 239.
İlk uygulama penceresini oluşturma
AIR, ilk uygulama penceresini uygulama tanımlayıcısında belirtilen özellikler temelinde oluşturur ve içerik öğesinde
başvurulan dosyayı yükler. İçerik bir SWF veya bir HTML dosyası olmalıdır.
Başlangıç penceresi, uygulamanızın ana penceresi olabilir veya yalnızca bir veya daha çok farklı pencerenin
başlatılması için görev yapabilir. Bu pencereyi görünür yapmanız gerekmez.
Flash geliştirme aracı, otomatik olarak bir SWF dosyası oluşturur ve siz AIR için bir projeyi test ederken veya
yayınlarken uygulama tanımlayıcısına uygun bir başvuru ekler. Ana zaman çizelgesi, uygulamanız için giriş noktası
olarak görev yapar.
Uygulamanız başladığında, AIR bir pencere oluşturur ve uygulama SWF dosyasını yükler. Masaüstü penceresini
ActionScript ile denetlemek için NativeWindow nesnesine başvuru almak üzere Stage nesnesinin nativeWindow
özelliğini kullanırsınız. Daha sonra window ve call window yöntemlerinin özelliklerini ayarlayabilirsiniz.
Aşağıdaki örnek, büyütülmüş durumdaji ana pencereyi etkinleştirir (Flash FLA'nın ana karesinden):
import flash.display.NativeWindow;
var mainWindow:NativeWindow = this.stage.nativeWindow;
mainWindow.maximize();
mainWindow.activate();
Bir NativeWindow oluşturma
Bir NativeWindow oluşturmak için, NativeWindowInitOptions nesnesini NativeWindow yapıcısına iletin:
var newWindow:NativeWindow = new NativeWindow(options);
Siz visible özelliğini true olarak ayarlayana veya activate() yöntemini çağırana kadar pencere görüntülenmez.
Pencere oluşturulduğunda, özelliklerini başlatabilir ve sahne özelliğiyle Flash görüntü listesi tekniklerini kullanarak
pencereye içerik yükleyebilirsiniz.
Neredeyse her durumda, yeni bir yerel pencerenin scaleMode özelliğini noScale olarak ayarlamalısınız
(StageScaleMode.NO_SCALE sabitini kullanın). Flash ölçek modları, uygulama geliştiricisinin uygulama görüntüsüne
ait en boy oranını önceden bilmediği durumlar için tasarlanmıştır. Ölçek modları, geliştiricinin en uygun dengeyi
seçmesine olanak verir: içeriği kesme, uzatma veya sıkıştırma, ya da boş alanla doldurma. AIR'de görüntü alanını
(pencere karesi) denetleyebildiğiniz için, pencereyi içeriğe veya içeriği pencereye göre ödün vermeden
boyutlandırabilirsiniz.
Not: Geçerli işletim sisteminde izin verilen maksimum ve minimum pencere boyutlarını belirlemek için aşağıdaki statik
NativeWindow özelliklerini kullanın:
var maxOSSize:Point = NativeWindow.systemMaxSize;
var minOSSize:Point = NativeWindow.systemMinSize;
Bir HTML penceresi oluşturma
Bir HTML penceresi oluşturmak için JavaScript Window.open() yöntemini veya AIR HTMLLoader sınıfının
createRootWindow() yöntemini çağırabilirsiniz.
Herhangi bir güvenlik sanal alanındaki HTML özelliği JavaScript Window.open() yöntemini kullanabilir. İçerik
uygulama sanal alanının dışında çalışıyorsa, open() yöntemi yalnızca fare tıklatması veya tuşa basma gibi bir kullanıcı
etkileşimine yanıt olarak çağrılabilir. open() yöntemi çağrıldığında, belirtilen URL'deki içeriği görüntülemek için
sistem kromu içeren bir pencere oluşturulur. Örneğin:
newWindow = window.open("xmpl.html", "logWindow", "height=600, width=400, top=10, left=10");
Not: JavaScript window.open() işleviyle oluşturulan pencereyi özelleştirmek için ActionScript'teki HTMLHost sınıfını
genişletebilirsiniz. Bkz. “HTMLHost sınıfının genişletilmesi hakkında” sayfa 235
Uygulama güvenlik sanal alanındaki içerik, daha güçlü HTMLLoader.createRootWindow() pencere oluşturma
yöntemine erişime sahiptir. Bu yöntemle, yeni bir pencereye ilişkin tüm oluşturma seçeneklerini belirleyebilirsiniz.
Örneğin, aşağıdaki JavaScript kodu 300x400 boyutunda, sistem kromu içermeyen hafif bir pencere oluşturur:
var options = new air.NativeWindowInitOptions();
options.systemChrome = "none";
options.type = "lightweight";
var windowBounds = new air.Rectangle(200,250,300,400);
newHTMLLoader = air.HTMLLoader.createRootWindow(true, options, true, windowBounds);
newHTMLLoader.load(new air.URLRequest("xmpl.html"));
Not: Yeni bir pencere tarafından yüklenen içerik uygulama güvenlik sanal alanının dışındaysa, pencere nesnesi AIR
özelliklerine sahip değildir: runtime, nativeWindow veya htmlLoader.
createRootWindow() yöntemiyle oluşturulan pencereler, açılan pencereden bağımsız kalırlar. JavaScript Window
nesnesinin parent ve opener özellikleri null değerindedir. Açılan pencere, createRootWindow() işlevinin
döndürdüğü HTMLLoader başvurusunu kullanarak yeni pencerenin Window nesnesine erişebilir. Önceki örnek
bağlamında, newHTMLLoader.window ifadesi oluşturulan pencerenin JavaScript Window nesnesine başvurur.
Not: createRootWindow() işlevi, JavaScript ve ActionScript'ten çağrılabilir.
Bir pencereye içerik ekleme
Bir AIR penceresine nasıl içerik eklediğiniz, pencerenin türüne bağlıdır. Bir film klibi oluşturabilir ve uygulama
durumunu denetlemek için zaman çizelgesini kullanabilirsiniz. HTML ile pencerenin temel içeriğini tanıtıcı biçimde
tanımlayabilirsiniz. Kaynakları SWF uygulamasına gömebilir veya ayrı uygulama dosyalarından yükleyebilirsiniz.
Flash ve HTML içeriği anında oluşturulabilir ve bir pencereye dinamik olarak eklenebilir.
SWF içeriği veya JavaScript içeren HTML içeriği yüklerken, AIR güvenlik modelini dikkate almalısınız. Uygulama
güvenlik sanal alanındaki, yani uygulamanızla yüklenen ve app ile yüklenebilen her içerik: URL şeması, tüm AIR
API'lerine erişmek için tüm ayrıcalıklara sahiptir. Bu sanal alanın dışından yüklenen her içerik AIR API'lerine
erişemez. Uygulama sanal alanının dışındaki JavaScript içeriği JavaScript Window nesnesinin runtime,
nativeWindow veya htmlLoader özelliklerini kullanamaz.
Güvenli çapraz komut dosyası oluşturmayı sağlamak için, uygulama içeriği ve uygulama dışı içerik arasında sınırlı bir
arabirim sağlamak üzere sanal alan köprüsünü kullanabilirsiniz. HTML içeriğinde, bu sayfadaki kodun harici içeriğe
ilişkin çapraz komut dosyası oluşturmasına izin vermek için uygulamanızın sayfalarını uygulama dışı bir sanal alana
eşleyebilirsiniz. Bkz. “AIR güvenliği” sayfa 23.
SWF veya görüntü yükleme
flash.display.Loader sınıfını kullanarak yerel bir pencerenin görüntü listesine Flash veya görüntüler
yükleyebilirsiniz:
package {
import
import
import
import
flash.display.Sprite;
flash.events.Event;
flash.net.URLRequest;
flash.display.Loader;
public class LoadedSWF extends Sprite
{
public function LoadedSWF(){
loader.load(new URLRequest("visual.swf"));
loader.contentLoaderInfo.addEventListener(Event.COMPLETE,loadFlash);
}
private function loadFlash(event:Event):void{
addChild(event.target.loader);
}
}
}
HTML tabanlı bir uygulamada kullanım için kitaplık kodu içeren bir SWF dosyası yükleyebilirsiniz. Bir HTML
penceresine SWF yüklemenin en basit yolu script etiketini kullanmaktır, ancak doğrudan Loader API'sini de
kullanabilirsiniz.
Not: ActionScript 1 veya 2 kullanılarak oluşturulan daha eski SWF dosyaları, aynı pencereye yüklendiklerinde sınıf
tanımları, tek ve genel değişkenler gibi genel durumları paylaşırlar. Buna benzer bir SWF dosyası doğru çalışmak için
dokunulmamış genel durumlara dayanıyorsa, aynı pencereye bir defadan fazla veya örtüşen sınıf tanımları veya
değişkenleri kullanılarak başka bir SWF dosyasıyla aynı pencereye yüklenemez. Bu içerik ayrı pencerelere yüklenebilir.
Bir NativeWindow'a HTML içeriği yükleme
Bir NativeWindow'a HTML içeriği yüklemek için HTMLLoader nesnesini pencere sahnesine ekleyip HTML içeriğini
HTMLLoader öğesine yükleyebilir veya HTMLLoader.createRootWindow() yöntemini kullanarak önceden bir
HTMLLoader nesnesi içeren bir pencere oluşturabilirsiniz. Aşağıdaki örnek, HTML içeriğini yerel pencere sahnesinde
300x500 piksel boyutundaki görüntü alanında görüntüler:
//newWindow is a NativeWindow instance
var htmlView:HTMLLoader = new HTMLLoader();
html.width = 300;
html.height = 500;
//set the stage so display objects are added to the top-left and not scaled
newWindow.stage.align = "TL";
newWindow.stage.scaleMode = "noScale";
newWindow.stage.addChild( htmlView );
//urlString is the URL of the HTML page to load
htmlView.load( new URLRequest(urlString) );
Not: HTML dosyasındaki SWF veya PDF içeriği, pencere şeffaflık kullanıyorsa (pencerenin transparent özelliği true
ise) veya HTMLLoader denetimi ölçeklendiyse görüntülenmez.
SWF içeriğini HTML penceresine bir kaplama olarak ekleme
HTML pencereleri bir NativeWindow örneğinin içinde bulunduğundan, Flash görüntü nesnelerini görüntü
listesindeki HTML katmanının üstüne ve altına ekleyebilirsiniz.
Bir görüntü nesnesini HTML katmanının üstüne eklemek için window.nativeWindow.stage özelliğinin
addChild() yöntemini kullanın. addChild() yöntemi, katmanlı içeriği pencerede bulunan tüm içeriğin üzerine
ekler.
HTML katmanının altına bir görüntü nesnesi eklemek için, dizin parametresine ilişkin sıfır değerini ileterek,
window.nativeWindow.stage özelliğinin addChildAt() yöntemini kullanın Bir nesnenin sıfır dizinine
yerleştirilmesi, HTML görüntüsü de dahil var olan içeriği bir katman yukarı taşır ve yeni içeriği bunun altına ekler.
HTML sayfasının altındaki katmanlı içeriğin görünür olması için HTMLlLoader nesnesinin
paintsDefaultBackground özelliğini false olarak ayarlamalısınız. Ayrıca, bir arka plan rengi ayarlayan sayfanın
her öğesi şeffaf olmayacaktır. Örneğin sayfanın gövde öğesi için bir arka plan rengi ayarladığınızda, sayfanın hiçbir yeri
şeffaf olmaz.
Aşağıdaki örnek, Flash görüntü nesnelerinin bir HTML sayfasına kaplama ve altlık olarak nasıl ekleneceğini gösterir.
Örnek, iki basit şekil nesnesi oluşturarak bunlardan birini HTML içeriğinin altına, diğerini üstüne ekler. Örnek,
enterFrame olayını temel alan şekil konumunu da günceller.
<html>
<head>
<title>Bouncers</title>
<script src="AIRAliases.js" type="text/javascript"></script>
<script language="JavaScript" type="text/javascript">
air.Shape = window.runtime.flash.display.Shape;
function Bouncer(radius, color){
this.radius = radius;
this.color = color;
//velocity
this.vX = -1.3;
this.vY = -1;
//Create a Shape object and draw a circle with its graphics property
this.shape = new air.Shape();
this.shape.graphics.lineStyle(1,0);
this.shape.graphics.beginFill(this.color,.9);
this.shape.graphics.drawCircle(0,0,this.radius);
this.shape.graphics.endFill();
//Set the starting position
this.shape.x = 100;
this.shape.y = 100;
//Moves the sprite by adding (vX,vY) to the current position
this.update = function(){
this.shape.x += this.vX;
this.shape.y += this.vY;
//Keep the sprite within the window
if( this.shape.x - this.radius < 0){
this.vX = -this.vX;
}
if( this.shape.y - this.radius < 0){
this.vY = -this.vY;
}
if( this.shape.x + this.radius > window.nativeWindow.stage.stageWidth){
this.vX = -this.vX;
}
if( this.shape.y + this.radius > window.nativeWindow.stage.stageHeight){
this.vY = -this.vY;
}
};
}
function init(){
//turn off the default HTML background
var bottom = new Bouncer(60,0xff2233);
var top = new Bouncer(30,0x2441ff);
//listen for the enterFrame event
window.htmlLoader.addEventListener("enterFrame",function(evt){
bottom.update();
top.update();
});
//add the bouncing shapes to the window stage
window.nativeWindow.stage.addChildAt(bottom.shape,0);
window.nativeWindow.stage.addChild(top.shape);
}
</script>
<body onload="init();">
<h1>de Finibus Bonorum et Malorum</h1>
<p>Sed ut perspiciatis unde omnis iste natus error sit voluptatem accusantium
doloremque laudantium, totam rem aperiam, eaque ipsa quae ab illo inventore veritatis
et quasi architecto beatae vitae dicta sunt explicabo.</p>
<p style="background-color:#FFFF00; color:#660000;">This paragraph has a background color.</p>
<p>At vero eos et accusamus et iusto odio dignissimos ducimus qui blanditiis
praesentium voluptatum deleniti atque corrupti quos dolores et quas molestias
excepturi sint occaecati cupiditate non provident, similique sunt in culpa qui
officia deserunt mollitia animi, id est laborum et dolorum fuga.</p>
</body>
</html>
Bu örnek, AIR'de ActionScript ve JavaScript arasındaki sınırları aşan bazı gelişmiş tekniklere temel bir giriş sağlar.
ActionScript görüntü nesneleri kullanmaya alışık değilseniz, daha fazla bilgi için lütfen ActionScript 3.0'ı
Programlama kılavuzunun Görüntü Programlama bölümüne başvurun.
Örnek: Yerel bir pencere oluşturma
Aşağıdaki örnek, yerel bir pencerenin nasıl oluşturulacağını gösterir:
public function createNativeWindow():void {
//create the init options
options.type = NativeWindowType.NORMAL;
//create the window
var newWindow:NativeWindow = new NativeWindow(options);
newWindow.title = "A title";
newWindow.width = 600;
newWindow.height = 400;
newWindow.stage.align = StageAlign.TOP_LEFT;
newWindow.stage.scaleMode = StageScaleMode.NO_SCALE;
//activate and show the new window
newWindow.activate();
}
Pencereleri yönetme
Masaüstü pencerelerinin görünümünü, davranışını ve yaşam döngüsünü yönetmek için NativeWindow sınıfının
özelliklerinive yöntemlerini kullanırsınız.
Bir NativeWindow örneği alma
Bir pencereyi değiştirmek için önce pencere örneğini almalısınız. Pencere örneğini aşağıdaki konumlardan birinden
alabilirsiniz:
Pencere yapıcısı Bu, yeni NativeWindow için pencere yapıcısıdır.
Pencere sahnesi Bu, stage.nativeWindow öğesidir.
Sahnedeki herhangi bir görüntü nesnesi Bu, myDisplayObject.stage.nativeWindow öğesidir.
Bir pencere olayı Olay nesnesinin target özelliği, olayı gönderen pencereye başvurur.
HTMLLoader veya HTML penceresinin genel nativeWindow özelliği Bu, window.nativeWindow öğesidir.
nativeApplication nesnesi NativeApplication.nativeApplication.activeWindow uygulamanın etkin
penceresine başvurur (ancak, etkin pencere bu AIR uygulamasına ait bir pencere değilse null değerini döndürür).
NativeApplication.nativeApplication.openedWindows dizisi, AIR uygulamasındaki kapatılmamış tüm
pencereleri içerir.
Pencereleri etkinleştirme, gösterme ve gizleme
Bir pencereyi etkinleştirmek için NativeWindow activate() yöntemini çağırın. Bir pencerenin etkinleştirilmesi
pencereyi öne çıkarır, ona klavye ve fare odağı kazandırır ve gerektiğinde pencereyi yeniden yükleyerek veya visible
özelliğini true olarak ayarlayarak pencereyi görünür duruma getirir. Bir pencereni etkinleştirilmesi uygulamadaki
diğer pencerelerin sırasını değiştirmez. Activate() yönteminin çağrılması, pencerenin activate olayı
göndermesine neden olur.
Bir pencereyi etkinleştirmeden göstermek için visible özelliğini true olarak ayarlayın. Bu, pencereyi öne çıkarır,
ancak odağı pencereye atamaz.
Bir pencereyi görünümden gizlemek için, visible özelliğini false olarak ayarlayın. Bir pencerenin gizlenmesi
pencereyi, ilgili görev çubuğu simgelerini ve Mac OS X'te Pencereler menüsündeki girişi engeller.
Not: Mac OS X'te, dock simgesi içeren simge durumuna küçültülmüş bir pencereyi tamamen gizlemek mümkün değildir.
Simge durumuna küçültülen bir pencerede visible özelliği false olarak ayarlandıysa, pencereye ilişkin dock simgesi
görüntülenmeye devam eder. Kullanıcı simgeyi tıklattığında, pencere görünür bir duruma yeniden yüklenir ve
görüntülenir.
Pencere görüntü sırasını değiştirme
AIR, pencerelerin görüntü sırasını doğrudan değiştirmek için birkaç yöntem sağlar. Bir pencereyi görüntü sırasının
önüne veya arkasına, bir pencereyi başka bir pencerenin üzerine veya ardına taşıyabilirsiniz. Aynı zamanda, kullanıcı
pencereleri etkinleştirerek yeniden sıralayabilir.
Bir pencerenin alwaysInFront özelliğini true olarak ayarlayarak, bu pencereyi diğer pencerelerin önünde
tutabilirsiniz. Birden çok pencere bu ayara sahip olduğunda, bu pencerelerin görüntü sırası kendi aralarında belirlenir,
ancak bu pencereler her zaman alwaysInFront özelliği false olarak ayarlanmış pencerelerin önünde sıralanır. AIR
uygulaması etkin olmadığında bile, en üst grupta yer alan pencereler diğer uygulamalardaki pencerelerin üzerinde
görüntülenir. Bu davranış kullanıcı için zorlayıcı olabileceğinden, alwaysInFront özelliği yalnızca gerekli ve uygun
olduğunda true olarak ayarlanmalıdır. Uygun kullanım örnekleri şunları içerir:
• Araç ipuçları, açılır listeler, özel menüler veya açılan kutular gibi denetimler için geçici açılır pencereler. Odağı
kaybettiklerinde bu tür pencerelerin kapatılmaları gerektiğinden, kullanıcının başka bir pencereyi
görüntülemesinin engellenmesi can sıkıcı olmayabilir.
• Çok acil hata mesajları ve uyarılar. Kullanıcının zamanında yanıt vermemesi durumunda kurtarılamayacak bir
değişikliğin gerçekleşme olasılığı, bir uyarı penceresini ekranın önüne taşımayı gerekli kılabilir. Ancak çoğu hata ve
uyarı, normal pencere görüntü sırasında işlenebilir.
• Kısa süreli tost stili pencereler.
Not: AIR, alwaysInFront özelliğinin uygun kullanımını zorlamaz. Ancak, uygulamanız bir kullanıcının iş akışını
aksatıyorsa, uygulamanın kullanıcının çöp kutusuna gönderilme ihtimali de yüksektir.
NativeWindow sınıfı, bir pencerenin diğer pencerelere göre görüntü sırasını ayarlamak için aşağıdaki özellikleri ve
yöntemleri sağlar:
Üye
Açıklama
alwaysInFront özelliği
Pencerenin en üst pencere grubunda görüntülenip görüntülenmediğini belirtir.
Neredeyse her durumda, false en iyi ayardır. false değerinin true olarak değiştirilmesi pencereyi diğer
tüm pencerelerin önüne getirir (ancak pencereyi etkinleştirmez). true değerinin false olarak
değiştirilmesi pencereyi en üst grupta kalan pencerelerin arkasında, ancak hala diğer pencerelerin
önünde sıralar. Özelliğin bir pencere için geçerli değerine ayarlanması, pencere görüntü sırasını
değiştirmez.
orderToFront()
Pencereyi öne getirir.
orderInFrontOf()
Pencereyi belirli bir pencerenin önüne getirir.
orderToBack()
Pencereyi diğer pencerelerin arkasına gönderir.
orderBehind()
Pencereyi doğrudan belirli bir pencerenin arkasına gönderir.
activate()
Pencereyi öne geçirir (pencereyi görünür duruma getirerek ve odağı pencereye atayarak).
Not: Bir pencere gizli (visible özelliği false) veya simge durumundaysa, görüntü sırası yöntemlerinin etkisi olmaz.
Bir pencereyi kapatma
Bir pencereyi kapatmak için NativeWindow.close() yöntemini kullanın.
Bir pencerenin kapatılması pencere içeriğini boşaltır, ancak diğer nesneler bu içeriğe başvuruyorsa, içerik nesneleri
ortadan kaldırılmaz. NativeWindow.close() yöntemi senkronize olmayan biçimde yürütülür, pencerede bulunan
uygulama kapatma işlemi sırasında çalışmaya devam eder. Close yöntemi, kapatma işlemi başarılı olduğunda bile bir
close olayı gönderir. NativeWindow nesnesi teknik olarak hala geçerlidir, ancak çoğu özellik ve yönteme kapatılmış
bir pencerede erişmek, bir IllegalOperationError oluşturur. Kapatılan bir pencereyi yeniden açamazsınız. Pencerenin
kapanıp kapanmadığını test etmek için pencerenin closed özelliğini kontrol edin. Bir pencereyi görünümden
gizlemek için NativeWindow.visible özelliğini false olarak ayarlayın.
Nativeapplication.autoExit özelliği varsayılan true değerinde olduğunda, son pencere kapandığında uygulama
kapanır.
Pencere işlemlerinin iptaline izin verme
Bir pencere sistem kromu kullandığında, uygun olayların varsayılan davranışı dinlenerek veya iptal edilerek
kullanıcının pencereyle etkileşimi iptal edilebilir. Örneğin, bir kullanıcı sistem kromu kapatma düğmesini
tıklattığında, closing olayı gönderilir. Bir kayıtlı dinleyici olayın preventDefault() yöntemini çağırdığında,
pencere kapanmaz.
Pencere sistem kromu kullanmıyorsa, hedeflenen değişikliklerin bildirim olayları değişiklik yapılmadan önce
otomatik olarak gönderilmez. Bu nedenle, bir pencereyi kapatmaya, pencere durumunu değiştirmeye veya pencere
sınırı özelliklerinden birini ayarlamaya ilişkin yöntemleri çağırırsanız, değişiklik iptal edilemez. Pencere değişikliği
yapılmadan uygulamanızdaki bileşenleri bilgilendirmek için, uygulama mantığınız pencerenin dispatchEvent()
yöntemini kullanarak ilgili bildirim olayını gönderebilir.
Örneğin, aşağıdaki mantık bir pencere kapatma düğmesi için iptal edilebilir bir olay işleyicisi uygular:
public function onCloseCommand(event:MouseEvent):void{
var closingEvent:Event = new Event(Event.CLOSING,true,true);
dispatchEvent(closing);
if(!closingEvent.isDefaultPrevented()){
win.close();
}
}
Olay preventDefault() yöntemi bir dinleyici tarafından çağrılırsa, dispatchEvent() yöntemi false değerini
döndürür. Ancak, bu yöntem başka nedenlerle de false değerini döndürebilir, bu nedenle değişikliğin iptal edilmesi
gerekip gerekmediğini test etmek için açıkça isDefaultPrevented() yöntemini kullanmak daha uygundur.
Bir pencereyi büyütme, simge durumuna küçültme ve geri yükleme
Pencereyi büyütmek için NativeWindow maximize() yöntemini kullanın.
myWindow.maximize();
Pencereyi simge durumuna küçültmek için NativeWindow minimize() yöntemini kullanın.
myWindow.minimize();
Pencereyi geri yüklemek için (yani, simge durumuna küçültülmeden veya büyütülmeden önceki boyutuna geri
döndürmek için), NativeWindow restore() yöntemini kullanın.
myWindow.restore();
Not: Bir AIR penceresini büyütme sonucunda ortaya çıkan davranış, Mac OS X standart davranışından farklıdır.
Uygulama tarafından tanımlanmış “standart” bir boyut ve kullanıcı tarafından ayarlanan son boyut arasında geçiş
yapmak yerine, AIR pencereleri uygulama veya kullanıcı tarafından ayarlanan son boyut ve ekranın tam kullanılabilir
alanı arasında geçiş yapar.
Örnek: Bir pencereyi simge durumuna küçültme, büyütme, geri yükleme ve
kapatma
Flash için aşağıdaki ActionScript örneği, NativeWindow minimize(), maximize(), restore() ve close()
yöntemlerini tetikleyen dört tıklatılabilir metin alanı oluşturur:
package
{
import flash.events.MouseEvent;
import flash.text.TextField;
public class MinimizeExample extends Sprite
{
public function MinimizeExample():void
{
var minTextBtn:TextField = new TextField();
minTextBtn.x = 10;
minTextBtn.y = 10;
minTextBtn.text = "Minimize";
minTextBtn.background = true;
minTextBtn.border = true;
minTextBtn.selectable = false;
addChild(minTextBtn);
minTextBtn.addEventListener(MouseEvent.CLICK, onMinimize);
var maxTextBtn:TextField = new TextField();
maxTextBtn.x = 120;
maxTextBtn.y = 10;
maxTextBtn.text = "Maximize";
maxTextBtn.background = true;
maxTextBtn.border = true;
maxTextBtn.selectable = false;
addChild(maxTextBtn);
maxTextBtn.addEventListener(MouseEvent.CLICK, onMaximize);
var restoreTextBtn:TextField = new TextField();
restoreTextBtn.x = 230;
restoreTextBtn.y = 10;
restoreTextBtn.text = "Restore";
restoreTextBtn.background = true;
restoreTextBtn.border = true;
restoreTextBtn.selectable = false;
addChild(restoreTextBtn);
restoreTextBtn.addEventListener(MouseEvent.CLICK, onRestore);
var closeTextBtn:TextField = new TextField();
closeTextBtn.x = 340;
closeTextBtn.y = 10;
closeTextBtn.text = "Close Window";
closeTextBtn.background = true;
closeTextBtn.border = true;
closeTextBtn.selectable = false;
addChild(closeTextBtn);
closeTextBtn.addEventListener(MouseEvent.CLICK, onCloseWindow);
}
function onMinimize(event:MouseEvent):void
{
this.stage.nativeWindow.minimize();
}
function onMaximize(event:MouseEvent):void
{
this.stage.nativeWindow.maximize();
}
function onRestore(event:MouseEvent):void
{
this.stage.nativeWindow.restore();
}
function onCloseWindow(event:MouseEvent):void
{
this.stage.nativeWindow.close();
}
}
}
Bir pencereyi yeniden boyutlandırma ve taşıma
Bir pencere sistem kromu kullandığında, krom, pencerenin yeniden boyutlandırılması ve masaüstünde taşınması için
sürükleme denetimleri sağlar. Pencere sistem kromu kullanmıyorsa, kullanıcının pencereyi yeniden boyutlandırması
ve taşımasını olanaklı kılmak için kendi denetimlerinizi eklemelisiniz.
Not: Bir pencereyi yeniden boyutlandırmak veya taşımak için, önce NativeWindow örneğine bir başvuru almalısınız.
Bir pencere başvurusunun nasıl alınacağı hakkında bilgi için “Bir NativeWindow örneği alma” sayfa 65.
Bir pencereyi yeniden boyutlandırma
Bir pencereyi yeniden boyutlandırmak için NativeWindow startResize() yöntemini kullanın. Bu yöntem bir
mouseDown olayından çağrıldığında, yeniden boyutlandırma işlemi fareyle başlatışır ve işletim sistemi bir mouseUp
olayı aldığında tamamlanır. startResize() yöntemini çağırırken, pencerenin yeniden boyutlandırılacağı ilk kenar ve
köşeyi belirten bir argüman iletirsiniz.
Sahnenin ölçekleme modu, pencere sahnesi ve içeriklerinin pencere yeniden boyutlandırıldığında nasıl davranacağını
belirler. Sahne ölçekleme modlarının, web tarayıcısında olduğu gibi, uygulamanın görüntü alanının boyutu veya en
boy oranının denetiminde olmadığı durumlar için tasarlanmış olduğunu unutmayın. Genellikle scaleMode özelliğini
StageScaleMode.NO_SCALE olarak ayarladığınızda en iyi sonuçları alırsınız. Yine de, pencere içeriğinin
ölçeklenmesini istiyorsanız, değişen pencere sınırlarına yanıt olarak scaleX ve scaleY parametrelerini
ayarlayabilirsiniz.
Bir pencereyi taşıma
Bir pencereyi yeniden boyutlandırmadan taşımak için NativeWindow startMove() yöntemini kullanın.
startResize() yöntemi gibi, startMove() yöntemi bir mouseDown olayından çağrıldığında, taşıma işlemi fareyle
başlatılmıştır ve işletim sistemi bir mouseUp olayı aldığında tamamlanır.
startResize ve startMove yöntemleri hakkında daha fazla bilgi için bkz. ActionScript 3.0 Dil ve Bileşenler
Başvurusu (http://www.adobe.com/go/learn_air_aslr_tr).
Örnek: Pencereleri yeniden boyutlandırma ve taşıma
Aşağıdaki örnek bir pencerede yeniden boyutlandırma ve taşıma işlemlerinin nasıl başlatılacağını gösterir:
package
{
import flash.display.NativeWindowResize;
public class NativeWindowResizeExample extends Sprite
{
public function NativeWindowResizeExample():void
{
// Fills a background area.
this.graphics.beginFill(0xFFFFFF);
this.graphics.drawRect(0, 0, 400, 300);
this.graphics.endFill();
// Creates a square area where a mouse down will start the resize.
var resizeHandle:Sprite =
createSprite(0xCCCCCC, 20, this.width - 20, this.height - 20);
resizeHandle.addEventListener(MouseEvent.MOUSE_DOWN, onStartResize);
// Creates a square area where a mouse down will start the move.
var moveHandle:Sprite = createSprite(0xCCCCCC, 20, this.width - 20, 0);
moveHandle.addEventListener(MouseEvent.MOUSE_DOWN, onStartMove);
}
public function createSprite(color:int, size:int, x:int, y:int):Sprite
{
var s:Sprite = new Sprite();
s.graphics.beginFill(color);
s.graphics.drawRect(0, 0, size, size);
s.graphics.endFill();
s.x = x;
s.y = y;
this.addChild(s);
return s;
}
public function onStartResize(event:MouseEvent):void
{
this.stage.nativeWindow.startResize(NativeWindowResize.BOTTOM_RIGHT);
}
public function onStartMove(event:MouseEvent):void
{
this.stage.nativeWindow.startMove();
}
}
}
Pencere olaylarını dinleme
Bir pencerenin gönderdiği olayları dinlemek için, pencere örneğiyle bir dinleyiciyi kaydedin. Örneğin, closing olayını
dinlemek için, bir dinleyiciyi pencereyle aşağıdaki gibi kaydedin:
myWindow.addEventListener(Event.CLOSING, onClosingEvent);
Bir olay gönderildiğinde target özelliği olayı gönderen pencereye başvurur.
Çoğu pencere olayının iki ilişkili mesajı vardır. İlk mesaj, bir pencere değişikliği yapılacağına (ve bunun iptal
edilebileceğine) işaret ederken, ikinci mesaj değişikliğin gerçekleştiğini bildirir. Örneğin, kullanıcı pencerenin
kapatma düğmesini tıklattığında, closing olayı mesajı gönderilir. Hiçbir dinleyici olayı iptal etmezse, pencere kapatılır
ve close olayı tüm dinleyicilere gönderilir.
Genellikle closing gibi uyarı olayları, yalnızca bir olayı tetiklemek için sistem kromu kullanıldıysa gönderilir.
Örneğin, pencere close() yönteminin çağrılması otomatik olarak closing olayını göndermez—yalnızca close olayı
gönderilir. Ancak, bir closing olayı nesnesi oluşturabilir ve bunu pencerenin dispatchEvent() yöntemini kullanarak
gönderebilirsiniz.
Bir Event nesnesi gönderen pencere olayları:
Olay
Açıklama
activate
Pencere odak aldığında gönderilir.
deactivate
Pencere odağı kaybettiğinde gönderilir.
closing
Pencere kapatılmak üzere olduğunda gönderilir. Bu otomatik olarak yalnızca sistem kromu kapatma düğmesine
basıldığında veya Mac OS X'te Çıkış komutu çağrıldığında gerçekleşir.
close
Pencere kapatıldığında gönderilir.
Bir NativeWindowBoundsEvent nesnesi gönderen pencere olayları:
Olay
Açıklama
moving
Pencerenin sol üst köşesi taşıma, yeniden boyutlandırma veya pencere görüntü durumu değişikliği sonucunda
konumunu değiştirmeden hemen önce gönderilir.
move
Sol üst köşe konumunu değiştirdikten sonra gönderilir.
resizing
Pencere genişliği veya yüksekliği, yeniden boyutlandırma veya görüntü durumu değişikliği sonucunda
değişmeden hemen önce gönderilir.
resize
Pencere boyut değiştirdikten sonra gönderilir.
NativeWindowBoundsEvent olayları için, bekleyen veya tamamlanan bir değişiklikten önce ve sonraki pencere
sınırlarını belirlemek üzere beforeBounds ve afterBounds özelliklerini kullanabilirsiniz.
Bir NativeWindowDisplayStateEvent nesnesi gönderen pencere olayları:
Olay
Açıklama
displayStateChanging
Pencere görüntü durumu değişmeden hemen önce gönderilir.
displayStateChange
Pencere görüntü durumu değiştikten sonra gönderilir.
NativeWindowDisplayStateEvent olayları için, bekleyen veya tamamlanan bir değişiklikten önce ve sonraki pencere
görüntü durumunu belirlemek üzere beforeDisplayState ve afterDisplayState özelliklerini kullanabilirsiniz.
Tam ekran pencereleri görüntüleme
Sahne'nin displayState özelliğini StageDisplayState.FULL_SCREEN_INTERACTIVE olarak ayarlama, pencereyi
tam ekran moduna geçirir ve bu modda klavye girişine izin verilir. (Bir tarayıcıda çalışan SWF içeriğinde, klavye
girişine izin verilmez). Kullanıcı, tam ekran modundan çıkmak için Escape tuşuna basar.
Flash için aşağıdaki ActionScript örneği, basit bir tam ekranlı metin uçbirimi simüle eder:
import
import
import
import
flash.display.StageDisplayState;
flash.text.TextField;
flash.text.TextFormat;
public class FullScreenTerminalExample extends Sprite
{
public function FullScreenTerminalExample():void
{
var terminal:TextField = new TextField();
terminal.multiline = true;
terminal.wordWrap = true;
terminal.selectable = true;
terminal.background = true;
terminal.backgroundColor = 0x00333333;
this.stage.displayState = StageDisplayState.FULL_SCREEN_INTERACTIVE;
addChild(terminal);
terminal.width = 550;
terminal.height = 400;
terminal.text = "Welcome to the dumb terminal application. Press the ESC key to
exit.\n_";
var tf:TextFormat = new TextFormat();
tf.font = "Courier New";
tf.color = 0x00CCFF00;
tf.size = 12;
terminal.setTextFormat(tf);
terminal.setSelection(terminal.text.length - 1, terminal.text.length);
}
}
73
Bölüm 11: Ekranlar
Bilgisayara eklenen masaüstü görüntü ekranları hakkındaki bilgiye erişmek için Adobe® AIR® Screen sınıfını kullanın.
Ekranlar hakkında ek çevrimiçi bilgi
Screen sınıfı ve ekranlarla çalışma hakkında daha fazla bilgiyi şu kaynaklarda bulabilirsiniz:
• Sanal masaüstünü ölçme
Dil Başvurusu
• Ekran
• Flash için Adobe AIR Geliştirici Bağlantısı ('AIR ekranları'nı arama)
Ekran temelleri
Ekran API'si, sistem ekran bilgisinin elde edilmesi için statik üyeler ve belirli bir ekranın açıklanması için örnek üyeler
sağlayan Screen adlı tek bir sınıf içerir.
Bilgisayar sistemi, sanal alana yerleştirilmiş çeşitli masaüstü ekranlarına karşılık gelen, kendisine eklenmiş birkaç
monitör ve görüntü içerebilir. AIR Screen sınıfı ekranlar, ekranların göreceli olarak yerleştirilmesi ve kullanılabilir
alanları hakkında bilgi sağlar. Aynı ekrana birden çok monitör eşleniyorsa, yalnızca bir ekran mevcut olur. Ekran
boyutu monitörün görüntü alanından büyükse, ekranın hangi bölümünün geçerli olarak görünür olduğunu
belirlemenin bir yolu yoktur.
Ekran, bağımsız bir masaüstü görüntü alanını temsil eder. Ekranlar, görsel masaüstü içinde dikdörtgenler olarak
tanımlanır. Birincil görüntü olarak belirlenen ekranın sol üst köşesi, görsel masaüstü koordinat sisteminin başlangıç
noktasıdır. Ekranı tanımlamak için kullanılan tüm deperler piksel cinsinden verilir.
Ekranlar
Screen bounds
Virtual screen
Usable bounds
Bu ekran yerleştirmesinde, görsel masaüstünde iki ekran bulunuyor. Ana ekranın (#1) sol üst köşesinin koordinatları her zaman (0,0)'dır.
Ekran yerleştirmesi ekran #2'yi ana ekran olarak belirleyecek biçimde değiştirilirse, ekran #1'in koordinatları negatif olur. Ekrana ilişkin
kullanılabilir sınırlar bildirilirken menü çubukları, görev çubukları ve dock'lar hariç tutulur.
Ekran API sınıfı, yöntemleri, özellikleri ve olayları hakkında ayrıntılı bilgi için bkz. ActionScript 3.0 Dil ve Bileşen
Başvurusu (http://www.adobe.com/go/learn_air_aslr_tr).
Ekranları numaralandırma
Sanal masaüstü ekranlarını aşağıdaki ekran yöntemleri ve özellikleriyle numaralandırabilirsiniz:
Yöntem veya Özellik
Açıklama
Screen.screens
Kullanılabilir ekranları açıklayan bir dizi Screen nesnesi sağlar. Dizinin sırasının önemli olmadığını göz
önünde bulundurun.
Screen.mainScreen
Ana ekran için bir Screen nesnesi sağlar Mac OS X'te ana ekran her zaman menü çubuğunu görüntüleyen
ekrandır. Windows'ta ana ekran, sistem tarafından belirlenen birincil ekrandır.
Screen.getScreensForRectangle() Belirtilen dikdörtgenle kesişen ekranları tanımlayan bir dizi Screen nesnesi sağlar. Bu yönteme aktarılan
dikdörtgen, sanal masaüstündeki piksel koordinatlarındadır. Hiçbir ekran dikdörtgenle kesişmiyorsa,
dizi boştur. Bu yöntemi, bir pencerenin hangi ekranlarda görüntülendiğini bulmak için kullanabilirsiniz.
Screen class yöntemleri ve özelliklerinden dönen değerleri kaydetmemelisiniz. Kullanıcı veya işletim sistemi var olan
ekranları ve bu ekranların yerleştirilmesini her zaman değiştirebilir.
Aşağıdaki örnek, ok tuşlarına basılmasına yanıt olarak bir pencereyi birden çok ekran arasında taşımak için ekran
API'sini kullanır. Pencereyi sonraki ekrana taşımak için örnek ekranlar dizisini getirir ve bu diziyi dikey veya yatay
olarak sıralar (basılan ok tuşuna göre). Daha sonra kod sıralanan dizide her ekranı geçerli ekranın koordinatlarıyla
karşılaştırarak ilerler. Örnek, pencerenin geçerli ekranını tanımlamak için pencere sınırlarında iletilen
Screen.getScreensForRectangle() yöntemini çağırır.
Ekranlar
package {
import
import
import
import
import
import
flash.display.Screen;
flash.events.KeyboardEvent;
flash.ui.Keyboard;
flash.display.StageAlign;
flash.display.StageScaleMode;
public class ScreenExample extends Sprite
{
public function ScreenExample()
{
stage.align = StageAlign.TOP_LEFT;
stage.scaleMode = StageScaleMode.NO_SCALE;
stage.addEventListener(KeyboardEvent.KEY_DOWN,onKey);
}
private function onKey(event:KeyboardEvent):void{
if(Screen.screens.length > 1){
switch(event.keyCode){
case Keyboard.LEFT :
moveLeft();
break;
case Keyboard.RIGHT :
moveRight();
break;
case Keyboard.UP :
moveUp();
break;
case Keyboard.DOWN :
moveDown();
break;
}
}
}
private function moveLeft():void{
var currentScreen = getCurrentScreen();
var left:Array = Screen.screens;
left.sort(sortHorizontal);
for(var i:int = 0; i < left.length - 1; i++){
if(left[i].bounds.left < stage.nativeWindow.bounds.left){
stage.nativeWindow.x +=
left[i].bounds.left - currentScreen.bounds.left;
stage.nativeWindow.y += left[i].bounds.top - currentScreen.bounds.top;
}
}
}
private function moveRight():void{
var currentScreen:Screen = getCurrentScreen();
var left:Array = Screen.screens;
left.sort(sortHorizontal);
for(var i:int = left.length - 1; i > 0; i--){
if(left[i].bounds.left > stage.nativeWindow.bounds.left){
stage.nativeWindow.x +=
Ekranlar
left[i].bounds.left - currentScreen.bounds.left;
stage.nativeWindow.y += left[i].bounds.top - currentScreen.bounds.top;
}
}
}
private function moveUp():void{
var top:Array = Screen.screens;
top.sort(sortVertical);
for(var i:int = 0; i < top.length - 1; i++){
if(top[i].bounds.top < stage.nativeWindow.bounds.top){
stage.nativeWindow.x += top[i].bounds.left - currentScreen.bounds.left;
stage.nativeWindow.y += top[i].bounds.top - currentScreen.bounds.top;
break;
}
}
}
private function moveDown():void{
var top:Array = Screen.screens;
top.sort(sortVertical);
for(var i:int = top.length - 1; i > 0; i--){
if(top[i].bounds.top > stage.nativeWindow.bounds.top){
stage.nativeWindow.x += top[i].bounds.left - currentScreen.bounds.left;
stage.nativeWindow.y += top[i].bounds.top - currentScreen.bounds.top;
break;
}
}
}
private function sortHorizontal(a:Screen,b:Screen):int{
if (a.bounds.left > b.bounds.left){
return 1;
} else if (a.bounds.left < b.bounds.left){
return -1;
} else {return 0;}
}
private function sortVertical(a:Screen,b:Screen):int{
if (a.bounds.top > b.bounds.top){
return 1;
} else if (a.bounds.top < b.bounds.top){
return -1;
} else {return 0;}
}
private function getCurrentScreen():Screen{
var current:Screen;
var screens:Array = Screen.getScreensForRectangle(stage.nativeWindow.bounds);
(screens.length > 0) ? current = screens[0] : current = Screen.mainScreen;
return current;
}
}
}
77
Bölüm 12: Yerel menülerle çalışma
Uygulama, pencere, bağlam menülerini ve açılır menüleri tanımlamak için yerel menü API'lerindeki sınıfları kullanın.
Yerel menüler hakkında ek çevrimiçi bilgiler
Yerel menü API'si ve yerel menülerle çalışma hakkında daha fazla bilgiyi aşağıdaki kaynaklarda bulabilirsiniz:
• AIR uygulamasına yerel menüler ekleme
Dil Başvurusu
• NativeMenu
• NativeMenuItem
• Flash için Adobe Geliştirici Bağlantısı ('AIR menüleri'ni arama)
AIR menüsü temelleri
Yerel menü sınıfları, uygulamanızın çalıştığı işletim sisteminin yerel menü özelliklerine erişmenizi sağlar. NativeMenu
nesneleri uygulama menüleri (Mac OS X'te bulunan), pencere menüleri (Windows'ta bulunan), bağlam menüleri ve
açılır menüler için kullanılabilir.
AIR menüsü sınıfları
Adobe® AIR™ Menu sınıfları şunları içerir:
Paket
Sınıflar
flash.display
•
NativeMenu
•
NativeMenuItem
•
ContextMenu
•
ContextMenuItem
•
Olay
•
ContextMenuEvent
flash.ui
flash.events
Yerel menülerle çalışma
Menü çeşitleri
AIR, aşağıdaki menü türlerini destekler:
Uygulama menüleri Uygulama menüsü, tüm uygulamada geçerli olan genel bir menüdür. Uygulama menüleri Mac
OS X'te desteklenir, ancak Windows'ta desteklenmez. Mac OS X'te, işletim sistemi otmatik olarak bir uygulama
menüsü oluşturur. Standart menülere öğeler ve alt menüler eklemek için AIR menü API'lerini kullanabilirsiniz. Var
olan menü komutlarını yönetmek için dinleyiciler ekleyebilirsiniz. Veya var olan öğeleri kaldırabilirsiniz.
Pencere menüleri Pencere menüsü tek bir pencereyle ilişkilendirilmiştir ve başlık menüsünün altında görüntülenir.
Menüler, bir NativeMenu nesnesi oluşturma ve bu nesneyi NativeWindow nesnesinin menu özelliğine atama yoluyla
bir pencereye eklenebilir. Pencere menüleri Windows işletim sisteminde desteklenir, ancak Mac OS X'te desteklenmez.
Yerel menüler yalnızca sistem kenarlığına sahip pencerelerle kullanılabilir.
Bağlam menüleri Bağlam menüleri, SWF içeriğindeki etkileşimli bir nesnenin veya HTML içeriğindeki bir belge
öğesinin sağ tıklatılması veya command tuşuna basılı tutularak tıklatılması yoluyla açılır. AIR NativeMenu sınıfını
kullanarak bağlam menüsü oluşturabilirsiniz. (Eski Adobe® Flash® ContextMenu sınıfını da kullanabilirsiniz.) HTML
içeriğinde, HTML öğesine bağlam menüleri eklemek için Webkit HTML ve JavaScript API'lerini kullanabilirsiniz.
Dock ve sistem tepsisi simge menüleri Bu simge menüleri bağlam menülerine benzer ve Mac OS X dock'unda veya
Windows bildirim alanındaki bir uygulama simgesine atanmıştır. Dock ve sistem tepsisi simge menüleri, NativeMenu
sınıfını kullanır. Mac OS X'te, menüdeki öğeler standart işletim sistemi öğelerinin üzerine eklenmiştir. Windows'ta
standart menü yoktur.
Açılır menüler AIR açılır menüsü, bağlam menüsüne benzer, ancak belirli bir uygulama nesnesi veya bileşeni ile
ilişkilendirilmiş olmayabilir. Açılır menüler, herhangi bir NativeMenu nesnesinin display() yönteminin çağrılması
yoluyla pencerenin herhangi bir yerinde görüntülenebilir.
Özel menüler Yerel menüler tamamen işletim sistemiyle çizilir ve bu nedenle Flash ve HTML oluşturma modellerinin
dışında yer alır. MXML, ActionScript veya JavaScript kullanarak kendinize ait yerel olmayan menüler
oluşturabilirsiniz. AIR menü sınıfları, yerel menülerin çizimini denetleme olanağı sunmaz.
Varsayılan menüler
Aşağıdaki varsayılan menüler işletim sistemi veya yerleşik bir AIR sınıfı tarafından sağlanır:
• Mac OS X'teki uygulama menüsü
• Mac OS X'teki dock simgesi menüsü
• HTML içeriğinde seçilen metin ve görüntüler için bağlam menüsü
• TextField nesnesinde (veya TextField'ı genişleten bir nesnede) seçilen metin için bağlam menüsü
Menü yapısı
Menüler yapıları gereği hiyerarşiktir. NativeMenu nesneleri, alt NativeMenuItem nesneleri içerebilir. Alt menüleri
temsil eden NativeMenuItem nesneleri, buna karşılık NativeMenu nesnelerini içerebilir. Yapıdaki üst veya kök düzey
menü nesneleri, uygulama ve pencere menülerine ilişkin menü çubuğunu temsil eder. (Bağlam menüleri, simge
menüleri ve açılır menüler menü çubuğu içermez).
Aşağıdaki diyagram, tipik bir menünün yapısını gösterir. Kök menü, menü çubuğunu temsil eder ve Dosya alt menüsü
ile Düzen alt menüsüne başvuruda bulunan iki menü öğesi içerir. Bu yapıdaki Dosya alt menüsü iki komut öğesinin
yanı sıra Son Kullanılan Menüyü Aç alt menüsüne başvuruda bulunan ve kendisi üç öğe içeren bir öğeyi içerir. Düzen
alt menüsü üç komut ve bir ayırıcı içerir.
NativeMenu
Root Menu
NativeMenuItem
“File”
NativeMenu
File Menu
NativeMenuItem
“New”
NativeMenuItem
“Save”
NativeMenuItem
“Open Recent”
NativeMenu
NativeMenuItem
NativeMenu
Open Recent Menu
NativeMenuItem
“GreatGatsby.pdf”
NativeMenuItem
“WarAndPeace.pdf”
NativeMenuItem
“Iliad.pdf”
“Edit”
Edit Menu
NativeMenuItem
“Copy”
NativeMenuItem
“Paste”
NativeMenuItem
Separator
NativeMenuItem
“Preferences”
Alt menünün tanımlanması, hem NativeMenu hem de NativeMenuItem nesnesini gerektirir. NativeMenuItem
nesnesi, üst menüde görüntülenen etiketi tanımlar ve kullanıcının alt menüyü açmasını sağlar. NativeMenu nesnesi,
alt menüdeki öğeler için konteyner işlevi görür. The NativeMenuItem nesnesi, NativeMenuItem submenu özelliği
aracılığıyla NativeMenu nesnesine başvuruda bulunur.
Bu menüyü oluşturan bir kod örneğini görüntülemek için bkz. “Örnek: Pencere ve uygulama menüsü” sayfa 89.
Menü olayları
NativeMenu ve NativeMenuItem nesnelerinin her ikisi de displaying ve select olaylarını gönderir:
Görüntüleme: Menü görüntülenmeden hemen önce, menü ve menü öğeleri tüm kayıtlı dinleyicilere bir displaying
olayı gönderir. displaying olayı, size menü içeriklerini veya öğe görünümünü kullanıcıya gösterilmeden önce
güncelleme fırsatı verir. Örneğin, “Son Kullanılanları Aç” menüsünün displaying olayına ilişkin dinleyicide, menü
öğelerini son görüntülenen belgelerin güncel listesini yansıtacak biçimde değiştirebilirsiniz.
Event nesnesinin target özelliği her zaman görüntülenmek üzere olan menüdür. currentTarget, dinleyicinin
üzerinde kayıtlı olduğu nesnedir: menünün kendisi veya öğelerinden biridir.
Not: Displaying olayı, menünün veya menü öğelerinden birinin durumuna erişildiğinde de gönderilir.
Seç: Kullanıcı bir komut öğesini seçtiğinde öğe kayıtlı dinleyicilere bir select olayı gönderir. Alt menü ve ayırıcı
öğeleri seçilemez ve bu nedenle hiçbir zaman select olayı gönderemez.
select olayı, bir menü öğesinden bu öğeyi içeren menüye doğru ve kök menüye kadar baloncuk oluşturur. Select
olaylarını doğrudan bir öğe üzerinde veya daha yüksek sesle menü yapısında dinleyebilirsiniz. Menüde select olayını
dinlediğinizde, olayın target özelliğini kullanarak seçilen öğeyi tanımlayabilirsiniz. Olay menü hiyerarşisi boyunca
kabarcık oluştururken olay nesnesinin currentTarget özelliği geçerli menü nesnesini tanımlar.
Not: ContextMenu ve ContextMenuItem nesneleri menuItemSelect ve menuSelect olaylarının yanı sıra select ve
displaying olaylarını da gönderir.
Menü komutları için tuş eşdeğerleri
Menü komutuna bir tuş eşdeğeri (bazen hızlandırıcı olarak adlandırılır) atayabilirsiniz. Tuşa veya tuş bileşimine
basıldığında, menü öğesi kayıtlı dinleyicilere bir select olayı gönderir. Komutun çağrılması için, öğeyi içeren menü
uygulama menüsünün veya etkin pencerenin bölümü olmalıdır.
Tuş eşdeğerleri, ana anahtarı temsil eden bir dize ve ayrıca basılması gereken bir dizi değiştirici tuş olmak üzere iki
bölümden oluşur. Ana anahtarı atamak için, menü öğesi keyEquivalent özelliğini bu tuş için tek karakter dizesi
olarak ayarlayın. Büyük harf kullandığınızda, shift tuşu değiştirici dizisine otomatik olarak eklenir.
Mac OS X'te, varsayılan değiştirici (Keyboard.COMMAND) komut tuşudur. Windows'ta, (Keyboard.CONTROL) ctrl
tuşudur. Bu varsayılan tuşlar değiştirici dizisine otomatik olarak eklenir. Farklı değiştirici tuşlar atamak için
keyEquivalentModifiers özelliğine istenen tuş kodlarını içeren yeni bir dizi atayın. Varsayılan dizinin üzerine
üzerine yazılır. Varsayılan değiştiricileri kullansanız da kendi değiştirici dizinizi atasanız da, keyEquivalent
özelliğine atadığınız dize büyük harf olduğunda shift tuşu eklenir. Değiştirici tuşlar için kullanılacak tuş kodlarına
ilişkin sabitler Keyboard sınıfında tanımlanır.
Atanan tuş eşdeğer dizesi, otomatik olarak menü öğesi adının yanında görüntülenir. Format kullanıcının işletim
sistemine ve sistem tercihlerine bağlıdır.
Not: Windows işletim sisteminde bir tuş değiştirici dizisine Keyboard.COMMAND değerini atadığınızda, menüde tuş
eşdeğeri görüntülenmez. Ancak, menü komutunu etkinleştirmek için ctrl tuşu kullanılmalıdır.
Aşağıdaki örnek, menü öğesine ilişkin tuş eşdeğeri olarak Ctrl+Shift+G tuşlarını atamaktadır:
var item:NativeMenuItem = new NativeMenuItem("Ungroup");
item.keyEquivalent = "G";
Bu örnek, doğrudan değiştirici dizisini ayarlayarak tuş eşdeğeri olarak Ctrl+Shift+G tuşlarını atar:
var item:NativeMenuItem = new NativeMenuItem("Ungroup");
item.keyEquivalent = "G";
item.keyEquivalentModifiers = [Keyboard.CONTROL];
Not: Tuş eşdeğerleri yalnızca uygulama ve pencere menüleri için tetiklenir. Bağlam menüsüne veya açılır menüye bir tuş
eşdeğeri atadığınızda, tuş eşdeğeri menü etiketinde görüntülenir, ancak ilişkili menü komutu hiçbir zaman çağrılmaz.
Anımsatıcılar
Anımsatıcılar, menülere ilişkin işletim sistemi klavye arabiriminin bir parçasıdır. Hem Mac OS X hem de Windows,
kullanıcıların klavye yoluyla menüleri açmasına ve komutları seçmesine olanak tanır, ancak ikisi arasında küçük
farklar vardır. Mac OS X'te kullanıcı menünün ilk veya iki harfini yazar ve ardından return tuşuna basar.
Windows'ta yalnızca tek bir harf önemlidir. Varsayılan olarak, önemli harf etiketteki ilk karakterdir. Ancak menü
öğesine bir anımsatıcı atadığınızda, önemli karakter belirlenen harf olarak değişir. Bir menüdeki iki öğe aynı önemli
karaktere sahip olduğunda (anımsatıcı atanmış olup olmaması önemli değildir) kullanıcının menü ile klavye etkileşimi
biraz değişir. Kullanıcı, menüyü veya komutu seçmek üzere tek bir harfe basmak yerine, harfe istenen öğeyi
vurgulamak için gerekli olduğu kadar basmalı ve daha sonra seçimi tamamlamak için Enter tuşunu kullanmalıdır.
Tutarlı davranışı korumak için, pencere menülerine ilişkin bir menüdeki her kaleme benzersiz bir anımsatıcı atamanız
tavsiye edilir.
Anımsatıcı karakteri etiket dizesinde dizin olarak belirleyin. Etiketteki ilk karakterin dizini 0'dır. Bu nedenle,
etiketlenen menü öğesi “Format” için “r” anımsatıcısını kullanmak üzere mnemonicIndex özelliğini 2'ye
eşitlemelisiniz.
var item:NativeMenuItem = new NativeMenuItem("Format");
item.mnemonicIndex = 2;
Menü öğesi durumu
Menü öğeleri iki durum özelliğine sahiptir, checked ve enabled:
checked Öğe etiketinin yanında bir onay işareti görüntülemek için true özelliğini belirleyin.
item.checked = true;
enabled Komutun etkin olup olmadığını kontrol etmek için değeri true ve false arasında değiştirin. Etkin olmayan
öğeler silik bir görselliğe sahiptir ve select olayları göndermez.
item.enabled = false;
Menü öğesine nesne ekleme
NativeMenuItem sınıfının data özelliği, her öğede rasgele bir nesneye başvuruda bulunabilmenizi sağlar. Örneğin,
“Son Kullanılanları Aç” menüsünde her bir menü öğesine her belge için File nesnesi atayabilirsiniz.
var file:File = File.applicationStorageDirectory.resolvePath("GreatGatsby.pdf")
var menuItem:NativeMenuItem = docMenu.addItem(new NativeMenuItem(file.name));
menuItem.data = file;
Yerel menüler oluşturma
Bu başlık, AIR tarafından desteklenen çeşitli türlerdeki yerel menülerin nasıl oluşturulduğunu açıklar.
Root menu nesnesi oluşturma
Menü kökü olarak görev yapacak bir NativeMenu nesnesi oluşturmak için NativeMenu yapıcısını kullanın:
var root:NativeMenu = new NativeMenu();
Kök menü, uygulama ve pencere menüleri için menü çubuğunu temsil eder ve yalnızca alt menüleri açan öğeleri
içermelidir. Bağlam menüsü ve açılır menüler menü çubuğu içermez. Bu nedenle kök menü, alt menülerin yanı sıra
komutlar ve ayırıcı da içermelidir.
Menü oluşturulduktan sonra, menü öğelerini ekleyebilirsiniz. Öğeleri belirli bir dizine menu nesnesinin addItemAt()
yöntemini kullanarak eklemediğiniz sürece, öğeler menüye eklendikleri sıraya göre görüntülenir.
Menüyü uygulama, pencere, simge veya bağlam menüsü olarak atayın veya aşağıdaki bölümlerde gösterildiği gibi açılır
menü olarak görüntüleyin:
Uygulama menüsünü ayarlama
NativeApplication.nativeApplication.menu = root;
Not: Mac OS X, her uygulama için standart öğeler içeren bir menü tanımlar. NativeApplication nesnesinin menu
özelliğine yeni bir NativeMenu nesnesinin atanması, standart menüyü değiştirir. Değiştirmek yerine, standart menüyü
de kullanabilirsiniz.
Pencere menüsünü ayarlama
nativeWindowObject.menu = root;
Etkileşimli bir nesnede bağlam menüsünü ayarlama
interactiveObject.contextMenu = root;
Dock simgesi menüsünü ayarlama
DockIcon(NativeApplication.nativeApplication.icon).menu = root;
Not: Mac OS X, uygulama dock simgesi için standart bir menü tanımlar. DockIcon nesnesinin menu özelliğine yeni bir
NativeMenu atadığınızda, bu menüdeki öğeler standart öğelerin üzerinde görüntülenir. Standart menü öğelerini
kaldıramaz, değiştiremez veya bu öğelere erişemezsiniz.
Sistem tepsisi simge menüsünü ayarlama
SystemTrayIcon(NativeApplication.nativeApplication.icon).menu = root;
Menüyü açılır menü olarak görüntüleme
root.display(stage, x, y);
Alt menü oluşturma
Alt menü oluşturmak için, üst menüye bir NativeMenuItem nesnesi ekleyin ve daha sonra öğenin submenu özelliğine
alt menüyü tanımlayan NativeMenu nesnesini atayın. AIR, alt menü öğeleri ve bu öğelere ilişkin menü nesneleri
oluşturmak için iki yol sunar:
addSubmenu() yöntemiyle bir menü öğesi ve buna ilişkin menü nesnesini tek bir adımda oluşturabilirsiniz:
var editMenuItem:NativeMenuItem = root.addSubmenu(new NativeMenu(), "Edit");
Menü öğesini oluşturabilir ve menü nesnesini submenu özelliğine ayrıca da atayabilirsiniz:
var editMenuItem:NativeMenuItem = root.addItem("Edit", false);
editMenuItem.submenu = new NativeMenu();
Menü komutu oluşturma
Menü komutu oluşturmak için menüye bir NativeMenuItem nesnesi ve menü komutunu uygulayan işleve başvuran
bir olay dinleyicisi ekleyin:
var copy:NativeMenuItem = new NativeMenuItem("Copy", false);
copy.addEventListener(Event.SELECT, onCopyCommand);
editMenu.addItem(copy);
Select olayını komut öğesinin üzerinde dinleyebilir (örnekte gösterildiği gibi) veya select olayını üst menü
nesnesinde dinleyebilirsiniz.
Not: Alt menüleri ve ayırıcı satırları temsil eden menü öğeleri, select olayları göndermez ve bu nedenle komut olarak
kullanılamaz.
Menü ayırıcı satırı oluşturma
Ayırıcı satır oluşturmak için, yapıcıdaki isSeparator parametresini true olarak ayarlayarak bir NativeMenuItem
oluşturun. Daha sonra ayırıcı öğeyi doğru yerdeki menüye ekleyin:
var separatorA:NativeMenuItem = new NativeMenuItem("A", true);
editMenu.addItem(separatorA);
Ayırıcı için belirtilen bir etiket varsa, görüntülenmez.
Bağlam menüleri hakkında
SWF içeriğinde, InteractiveObject nesnesinden miras alınan her nesnenin contextMenu özelliğine bir menü nesnesi
atanarak, bu nesneye bir bağlam menüsü verilebilir. contextMenu öğesine atanan menü nesnesi NativeMenu veya
type ContextMenu tipinde olabilir.
Eski bağlam menüsü API sınıfları, daha önceden bağlam menüleri içeren ActionScript kodunu kullanmanızı sağlar.
ContextMenu sınıfını kullanıyorsanız, bununla birlikte ContextMenuItem sınıfını da kullanmalısınız; bir
ContextMenu nesnesine NativeMenuItem nesneleri ve bir NativeMenu nesnesine ContextMenuItem nesneleri
ekleyemezsiniz. Bağlam menüsü API'si kullanmanın en önemli dezavantajı, bu API'nin alt menüleri
desteklememesidir.
ContextMenu sınıfı, addItem() gibi NativeMenu sınıfından miras alınan yöntemleri içerse de, bu yöntemler yanlış
öğe dizisine öğeler ekler. Bağlam menüsünde tüm öğeler items dizisine değil, customItems dizisine eklenmelidir.
Menüdeki öğeleri eklemek ve yönetmek için bağlam menülerine ilişkin NativeMenu nesnelerini veya yalnızca miras
alınmayan ContextMenu yöntemleri ve özelliklerini kullanın.
Aşağıdaki örnek bir hareketli görüntü oluşturur ve basit bir düzenleme bağlam menüsü ekler:
var sprite:Sprite = new Sprite();
sprite.contextMenu = createContextMenu()
private function createContextMenu():ContextMenu{
var editContextMenu:ContextMenu = new ContextMenu();
var cutItem:ContextMenuItem = new ContextMenuItem("Cut")
cutItem.addEventListener(ContextMenuEvent.MENU_ITEM_SELECT, doCutCommand);
editContextMenu.customItems.push(cutItem);
var copyItem:ContextMenuItem = new ContextMenuItem("Copy")
copyItem.addEventListener(ContextMenuEvent.MENU_ITEM_SELECT, doCopyCommand);
editContextMenu.customItems.push(copyItem);
var pasteItem:ContextMenuItem = new ContextMenuItem("Paste")
pasteItem.addEventListener(ContextMenuEvent.MENU_ITEM_SELECT, doPasteCommand);
editContextMenu.customItems.push(pasteItem);
return editContextMenu
}
private function doCutCommand(event:ContextMenuEvent):void{trace("cut");}
private function doCopyCommand(event:ContextMenuEvent):void{trace("copy");}
private function doPasteCommand(event:ContextMenuEvent):void{trace("paste");}
Not: Tarayıcı ortamında görüntülenen SWF içeriğinin aksine, AIR'deki bağlam menüleri yerleşik komutlar içermez.
HTML'deki bağlam menüleri hakkında
HTML içeriğinde, contextmenu olayı bir bağlam menüsünü görüntülemek için kullanılabilir. Varsayılan olarak
bağlam menüsü, kullanıcı seçilen metinde bağlam menüsü olayını çağırdığında görüntülenir (metni sağ tıklatma veya
command tuşuna basılı tutarak tıklatma yoluyla). Varsayılam menünün açılmasını önlemek için, contextmenu olayını
dinleyin ve event nesnesinin preventDefault() yöntemini çağırın:
function showContextMenu(event){
event.preventDefault();
}
Özel bağlam menüsünü DHTML tekniklerini kullanarak veya bir AIR yerel bağlam menüsünü görüntüleyerek
görüntüleyebilirsiniz. Aşağıdaki örnek, HTML contextmenu olayına yanıt olarak menü display() yöntemini
çağırma yoluyla yerel bir bağlam menüsünü görüntüler:
<html>
<head>
<script src="AIRAliases.js" language="JavaScript" type="text/javascript"></script>
<script language="javascript" type="text/javascript">
function showContextMenu(event){
contextMenu.display(window.nativeWindow.stage, event.clientX, event.clientY);
}
function createContextMenu(){
var menu = new air.NativeMenu();
var command = menu.addItem(new air.NativeMenuItem("Custom command"));
command.addEventListener(air.Event.SELECT, onCommand);
return menu;
}
function onCommand(){
air.trace("Context command invoked.");
}
var contextMenu = createContextMenu();
</script>
</head>
<body>
<p oncontextmenu="showContextMenu(event)" style="-khtml-user-select:auto;">Custom context
menu.</p>
</body>
</html>
Yerel menüleri tanıtıcı biçimde tanımlama
Menü ve menü öğeleri özelliklerinin kodlanması biraz zahmetli olabilir. Ancak, menüler hiyerarşik bir yapıda
olduklarından, doğru olan XML formatlı bir tanım kullanarak menü oluşturan bir işlev yazmaktır.
Aşağıdaki sınıf, yapıcısına bir XML nesnesi alarak NativeMenu öğesini şunu yapmak için geliştirir:
package
{
import flash.display.NativeMenu;
import flash.display.NativeMenuItem;
import flash.events.Event;
public class DeclarativeMenu extends NativeMenu
{
public function DeclarativeMenu(XMLMenuDefinition:XML):void
{
super();
addChildrenToMenu(this, XMLMenuDefinition.children());
}
private function addChildrenToMenu(menu:NativeMenu,
children:XMLList):NativeMenuItem
{
var menuItem:NativeMenuItem;
var submenu:NativeMenu;
for each (var child:XML in children)
{
if (String(child.@label).length > 0)
{
menuItem = new NativeMenuItem(child.@label);
menuItem.name = child.name();
}
else
{
menuItem = new NativeMenuItem(child.name());
menuItem.name = child.name();
}
menu.addItem(menuItem);
if (child.children().length() > 0)
{
menuItem.submenu = new NativeMenu();
addChildrenToMenu(menuItem.submenu,child.children());
}
}
return menuItem;
}
} //End class
} //End package
Bu sınıfa sahip bir menü oluşturmak, XML menü tanımını aşağıdaki şekilde onaylayın:
var menuDefinition:XML =
<root>
<FileMenu label='File'>
<NewMenu label='New'>
<NewTextFile label='Text file'/>
<NewFolder label='Folder'/>
<NewProject label='Project'/>
</NewMenu>
<OpenCommand label='Open'/>
<SaveCommand label='Save'/>
</FileMenu>
<EditMenu label='Edit'>
<CutCommand label='Cut'/>
<CopyCommand label='Copy'/>
<PasteCommand label='Paste'/>
</EditMenu>
<FoodItems label='Food Items'>
<Jellyfish/>
<Tripe/>
<Gizzard/>
</FoodItems>
</root>;
var test:DeclarativeMenu = new DeclarativeMenu(menuDefinition);
Menü olaylarını dinlemek için kök menü düzeyinde dinleyebilir ve hangi komutun seçildiğini saptamak için
event.target.name özelliğini kullanabilirsiniz. Ayrıca menüdeki öğeleri ada göre arayabilir ve ayrı ayrı olay
dinleyicileri oluşturabilirsiniz.
Açılır menüleri görüntüleme
Menü display() yöntemini çağırarak herhangi bir NativeMenu nesnesini bir pencerenin üzerinde rasgele bir
zamanda ve yerde görüntüleyebilirsiniz. Yöntem, sahneye başvuru gerektirir; bu nedenle yalnızca uygulama sanal
alanındaki içerik menüyü açılır biçimde görüntüleyebilir.
Aşağıdaki yöntem, fare tıklatmasına karşılık olarak popupMenu adlı bir NativeMenu nesnesi tarafından tanımlanan
menüyü görüntüler:
private function onMouseClick(event:MouseEvent):void {
popupMenu.display(event.target.stage, event.stageX, event.stageY);
}
Not: Menünün doğrudan bir olaya karşılık olarak görüntülenmesi gerekmez. Herhangi bir yöntem display() işlevini
çağırabilir.
Menü olaylarını işleme
Kullanıcı menüyü veya bir menü öğesini seçtiğinde, menü olayları gönderir.
Menu sınıfları için olay özeti
Menü olaylarını işlemek için menülere veya ayrı ayrı öğelere olay dinleyicileri ekleyin.
Nesne
Gönderilen olaylar
NativeMenu
NativeMenuEvent.DISPLAYING
NativeMenuEvent.SELECT (alt öğelerden ve alt menülerden yayılan)
NativeMenuItem
NativeMenuEvent.SELECT
NativeMenuEvent.DISPLAYING (üst menüden yayılan)
ContextMenu
ContextMenuEvent.MENU_SELECT
ContextMenuItem
ContextMenuEvent.MENU_ITEM_SELECT
NativeMenu.SELECT
Menü olaylarını seç
Bir menü öğesini tıklatmayı işlemek için, NativeMenuItem nesnesine select olayına ilişkin bir olay dinleyicisi
ekleyin:
var menuCommandX:NativeMenuItem = new NativeMenuItem("Command X");
menuCommand.addEventListener(Event.SELECT, doCommandX)
Select olayı mevcut menülere baloncuk oluşturduğundan, bir üst menüdeki select olaylarını da dinleyebilirsiniz
Menü düzeyinde dinleme sırasında, hangi menü komutunun seçildiğini belirlemek için olay nesnesinin target
özelliğini kullanabilirsiniz. Aşağıdaki örnek, seçilen komutun etiketini gösterir:
var colorMenuItem:NativeMenuItem = new NativeMenuItem("Choose a color");
var colorMenu:NativeMenu = new NativeMenu();
colorMenuItem.submenu = colorMenu;
var red:NativeMenuItem = new NativeMenuItem("Red");
var green:NativeMenuItem = new NativeMenuItem("Green");
var blue:NativeMenuItem = new NativeMenuItem("Blue");
colorMenu.addItem(red);
colorMenu.addItem(green);
colorMenu.addItem(blue);
if(NativeApplication.supportsMenu){
NativeApplication.nativeApplication.menu.addItem(colorMenuItem);
NativeApplication.nativeApplication.menu.addEventListener(Event.SELECT, colorChoice);
} else if (NativeWindow.supportsMenu){
var windowMenu:NativeMenu = new NativeMenu();
this.stage.nativeWindow.menu = windowMenu;
windowMenu.addItem(colorMenuItem);
windowMenu.addEventListener(Event.SELECT, colorChoice);
}
function colorChoice(event:Event):void {
var menuItem:NativeMenuItem = event.target as NativeMenuItem;
trace(menuItem.label + " has been selected");
}
ContextMenuItem sınıfını kullanıyorsanız, select olayını veya menuItemSelect olayını dinleyebilirsiniz.
menuItemSelect olayı size bağlam menüsünü içeren nesne hakkında ek bilgi verir, ancak mevcut menülere kabarcık
oluşturmaz.
Menü olaylarını görüntüleme
Menü açılışını işlemek için, menü görüntülenmeden önce gönderilen displaying olayı için dinleyici ekleyebilirsiniz.
Menüyü güncellemek için, örneğin öğeler ekleyerek veya kaldırarak ya da ayrı ayrı öğelerin etkin veya işaretli
durumlarını güncelleyerek görüntüleme olayını kullanabilirsiniz.
Örnek: Pencere ve uygulama menüsü
Aşağıdaki örnek, “Menü yapısı” sayfa 78'nda gösterilen menüyü oluşturur.
Menü, hem yalnızca pencere menülerini destekleyen Windows'ta, hem de yalnızca uygulama menülerini destekleyen
Mac OS X'te çalışmak üzere tasarlanmıştır. MenuExample sınıfı yapıcısı, ayrım yapmak için NativeWindow ve
NativeApplication sınıflarının statik supportsMenu özelliğini kontrol eder. Yapıcı, NativeWindow.supportsMenu
öğesi true olduğunda pencere için bir NativeMenu nesnesi oluşturur, daha sonra Dosya ile Düzen alt menülerini
oluşturur ve ekler. NativeApplication.supportsMenu öğesi true, yapıcı Dosya ve Düzen menülerini oluştururarak
bunları Mac OS X işletim sisteminin sağladığı var olan menüye ekler.
Örnek ayrıca, menü olay işlemesini de gösterir. Select olayı öğe düzeyinin yanı sıra menü düzeyinde de işlenir.
Seçilen öğeyi içeren menüden kök menüye kadarki zincirde bulunan her bir menü select olayını yanıtlar.
displaying olayı “Son Kullanılanları Aç” menüsüyle birlikte kullanılır. Menü açılmadan hemen önce, menüdeki
öğeler en son kullanılan Belgeler dizisinden (bu örnekte aslında değişmeyen) yenilenir. Bu örnekte gösterilmese de,
displaying olaylarını ayrı ayrı öğelerde de dinleyebilirsiniz.
package {
import
import
import
import
import
import
import
flash.display.NativeMenu;
flash.display.NativeMenuItem;
flash.display.NativeWindow;
flash.events.Event;
flash.filesystem.File;
flash.desktop.NativeApplication;
public class MenuExample extends Sprite
{
private var recentDocuments:Array =
new Array(new File("app-storage:/GreatGatsby.pdf"),
new File("app-storage:/WarAndPeace.pdf"),
new File("app-storage:/Iliad.pdf"));
public function MenuExample()
{
var fileMenu:NativeMenuItem;
var editMenu:NativeMenuItem;
if (NativeWindow.supportsMenu){
stage.nativeWindow.menu = new NativeMenu();
stage.nativeWindow.menu.addEventListener(Event.SELECT, selectCommandMenu);
fileMenu = stage.nativeWindow.menu.addItem(new NativeMenuItem("File"));
fileMenu.submenu = createFileMenu();
editMenu = stage.nativeWindow.menu.addItem(new NativeMenuItem("Edit"));
editMenu.submenu = createEditMenu();
}
if (NativeApplication.supportsMenu){
NativeApplication.nativeApplication.menu.addEventListener(Event.SELECT,
selectCommandMenu);
fileMenu = NativeApplication.nativeApplication.menu.addItem(new
NativeMenuItem("File"));
fileMenu.submenu = createFileMenu();
editMenu = NativeApplication.nativeApplication.menu.addItem(new
NativeMenuItem("Edit"));
editMenu.submenu = createEditMenu();
}
}
public function createFileMenu():NativeMenu {
var fileMenu:NativeMenu = new NativeMenu();
fileMenu.addEventListener(Event.SELECT, selectCommandMenu);
var newCommand:NativeMenuItem = fileMenu.addItem(new NativeMenuItem("New"));
newCommand.addEventListener(Event.SELECT, selectCommand);
var saveCommand:NativeMenuItem = fileMenu.addItem(new NativeMenuItem("Save"));
saveCommand.addEventListener(Event.SELECT, selectCommand);
var openRecentMenu:NativeMenuItem =
fileMenu.addItem(new NativeMenuItem("Open Recent"));
openRecentMenu.submenu = new NativeMenu();
openRecentMenu.submenu.addEventListener(Event.DISPLAYING,
updateRecentDocumentMenu);
openRecentMenu.submenu.addEventListener(Event.SELECT, selectCommandMenu);
return fileMenu;
}
public function createEditMenu():NativeMenu {
var editMenu:NativeMenu = new NativeMenu();
editMenu.addEventListener(Event.SELECT, selectCommandMenu);
var copyCommand:NativeMenuItem = editMenu.addItem(new NativeMenuItem("Copy"));
copyCommand.addEventListener(Event.SELECT, selectCommand);
copyCommand.keyEquivalent = "c";
var pasteCommand:NativeMenuItem =
editMenu.addItem(new NativeMenuItem("Paste"));
pasteCommand.addEventListener(Event.SELECT, selectCommand);
pasteCommand.keyEquivalent = "v";
editMenu.addItem(new NativeMenuItem("", true));
var preferencesCommand:NativeMenuItem =
editMenu.addItem(new NativeMenuItem("Preferences"));
preferencesCommand.addEventListener(Event.SELECT, selectCommand);
return editMenu;
}
private function updateRecentDocumentMenu(event:Event):void {
trace("Updating recent document menu.");
var docMenu:NativeMenu = NativeMenu(event.target);
for each (var item:NativeMenuItem in docMenu.items) {
docMenu.removeItem(item);
}
for each (var file:File in recentDocuments) {
var menuItem:NativeMenuItem =
docMenu.addItem(new NativeMenuItem(file.name));
menuItem.data = file;
menuItem.addEventListener(Event.SELECT, selectRecentDocument);
}
}
private function selectRecentDocument(event:Event):void {
trace("Selected recent document: " + event.target.data.name);
}
private function selectCommand(event:Event):void {
trace("Selected command: " + event.target.label);
}
private function selectCommandMenu(event:Event):void {
if (event.currentTarget.parent != null) {
var menuItem:NativeMenuItem =
findItemForMenu(NativeMenu(event.currentTarget));
if (menuItem != null) {
trace("Select event for \"" +
event.target.label +
"\" command handled by menu: " +
menuItem.label);
}
} else {
trace("Select event for \"" +
event.target.label +
"\" command handled by root menu.");
}
}
private function findItemForMenu(menu:NativeMenu):NativeMenuItem {
for each (var item:NativeMenuItem in menu.parent.items) {
if (item != null) {
if (item.submenu == menu) {
return item;
}
}
}
return null;
}
}
}
92
Bölüm 13: Görev çubuğu simgeleri
Çoğu işletim sistemi, Mac OS X dock'u gibi uygulamayı temsil edecek bir simge içeren bir görev çubuğu sağlar. Adobe®
AIR® NativeApplication.nativeApplication.icon özelliği aracılığıyla uygulama görev çubuğu simgesiyle
etkileşik kurmak için bir arabirim sağlar.
Görev çubuğu simgeleri hakkında ek çevrimiçi bilgi
Görev çubuklarıyla çalışma hakkında daha fazla bilgiyi şu kaynaklardan bulabilirsiniz:
• Sistem tepsisi ve dock simgelerini kullanma
Dil Başvurusu
• DockIcon
• SystemTrayIcon
• Flash için Adobe AIR Geliştirici Bağlantısı (ara: 'AIR görev çubuğu simgeleri')
Görev çubuğu simgeleri hakkında
AIR, NativeApplication.nativeApplication.icon nesnesini otomatik olarak oluşturur. Nesne türü işletim
sistemine bağlı olarak DockIcon veya SystemTrayIcon olur. NativeApplication.supportsDockIcon ve
NativeApplication.supportsSystemTrayIcon özelliklerini kullanarak, AIR'in geçerli işletim sisteminde bu
InteractiveIcon alt sınıflarından hangisini desteklediğini belirleyebilirsiniz. InteractiveIcon temel sınıfı, simge için
kullanılan görüntüyü değiştirmek için kullanabileceğiniz width, height ve bitmaps özelliklerini sağlar. Ancak,
DockIcon veya SystemTrayIcon öğelerine özgü özelliklere yanlış işletim sisteminde erişilmesi, bir çalışma zamanı
hatası oluşturur.
Bir simge için kullanılan görüntüyü ayarlamak veya değiştirmek için, bir veya daha çok görüntü içeren bir dizi
oluşturun ve bu diziyi NativeApplication.nativeApplication.icon.bitmaps özelliğine atayın. Görev çubuğu
simgelerinin boyutu farklı işletim sistemlerinde farklı olabilir. Ölçeklemeye bağlı görüntü bozulmasını önlemek için
bitmaps dizisine görüntülerin birden çok boyutunu ekleyebilirsiniz. Birden çok görüntü sağladığınızda, AIR
gerektiğinde görüntüyü ölçekleyerek görev çubuğu simgesinin geçerli görüntü boyutuna en yakın boyutu seçer.
Aşağıdaki örnek, iki görüntüyü kullanarak görev çubuğu simgesine ilişkin görüntüyü ayarlar:
NativeApplication.nativeApplication.icon.bitmaps =
[bmp16x16.bitmapData, bmp128x128.bitmapData];
Simge görüntüsünü değiştirmek için bitmaps özelliğine yeni görüntüyü veya görüntüleri içeren bir dizi atayın.
Simgeyi, bir enterFrame or timer olayına yanıt olarak görüntüyü değiştirerek hareketlendirebilirsiniz.
Simgeyi Windows'taki bildirim alanından kaldırmak veya Mac OS X'teki varsayılan simge görünümünü geri yüklemek
için bitmaps öğesini boş bir diziye ayarlayın:
Görev çubuğu simgeleri
NativeApplication.nativeApplication.icon.bitmaps = [];
Dock simgeleri
AIR, NativeApplication.supportsDockIcontrue olduğunda dock simgelerini destekler.
NativeApplication.nativeApplication.icon özelliği, dock üzerindeki uygulama simgesini temsil eder (pencere
dock simgesini değil).
Not: AIR, Mac OS X altındaki dock üzerinde pencere simgelerini değiştirmeyi desteklemez. Ayrıca, uygulama dock
simgesindeki değişiklikler yalnızca uygulama çalışırken uygulanır — uygulama iptal edildiğinde simge normal
görünümüne geri döner.
Dock simgesi menüleri
Komutlar içeren bir NativeMenu nesnesi oluşturarak ve bu nesneyi
NativeApplication.nativeApplication.icon.menu özelliğine atayarak standart dock menüsüne komutlar
ekleyebilirsiniz. Menüdeki öğeler, standart dock simgesi menü öğelerinin üzerinde görüntülenir.
Dock'u zıplatma
NativeApplication.nativeApplication.icon.bounce() yöntemini çağırarak dock simgesini zıplatabilirsiniz.
bounce() priority parametresini bilgi amaçlı olarak ayarlarsanız, simge bir kez zıplar. Parametreyi kritik olarak
belirlerseniz, simge kullanıcı uygulamayı etkinleştirene kadar zıplar. Priority parametresine ilişkin sabitler
NotificationType sınıfında tanımlanır.
Not: Uygulama zaten etkinse, simge zıplamaz.
Dock simgesi olayları
Dock simgesi tıklatıldığında, NativeApplication nesnesi bir invoke olayı gönderir. Uygulama çalışmıyorsa, sistem
uygulamayı başlatır. Aksi halde, invoke olayı çalışan uygulama örneğine iletilir.
Sistem Tepsisi simgeleri
NativeApplication.supportsSystemTrayIcon, şu anda yalnızca Windows'ta olduğu gibi true olduğunda, AIR
sistem tepsisi simgelerini destekler. Windows'ta, sistem tepsisi simgeleri görev çubuğunun bildirim alanında
görüntülenir. Simge, varsayılan olarak görüntülenir. Simgeyi görüntülemek için, simgenin bitmaps özelliğine
BitmapData nesneleri içeren bir dizi atayın. Simge görüntüsünü değiştirmek için bitmaps öğesine yeni görüntüleri
içeren bir dizi atayın. Simgeyi kaldırmak için bitmaps öğesini null değerine ayarlayın.
Sistem tepsisi simge menüleri
Bir NativeMenu nesnesi oluşturup bu nesneyi NativeApplication.nativeApplication.icon.menu özelliğine
atayarak menüye sistem tepsisi simgesi ekleyebilirsiniz (işletim sistemi, varsayılan menü sağlamaz). Sistem tepsisi
simge menülerine simgeyi sağ tıklatarak erişin.
Sistem tepsisi simge araç ipuçları
Araç ipucu özelliğini ayarlayarak simgeye araç ipucu ekleyebilirsiniz:
NativeApplication.nativeApplication.icon.tooltip = "Application name";
Sistem tepsisi simge olayları
NativeApplication.nativeApplication.icon özelliği tarafından başvurulan SystemTrayIcon nesnesi, click, mouseDown,
mouseUp, rightClick, rightMouseDown ve rightMouseUp olayları için bir ScreenMouseEvent gönderir. Bu olayları
simge menüsüyle birlikte, görünür pencere olmadığında kullanıcıların uygulamanızla etkileşim kurmasına izin
vermek için kullanabilirsiniz.
Örnek: Pencere içermeyen bir uygulama oluşturma
Aşağıdaki örnek, bir sistem tepsisi simgesi içeren, ancak görünür pencere içermeyen bir AIR uygulaması oluşturur.
Sistem tepsisi simgesi, uygulamadan çıkmak için tek bir komut içeren bir menüye sahiptir.
package
{
import
import
import
import
import
import
import
import
import
import
flash.display.Loader;
flash.display.NativeMenu;
flash.display.NativeMenuItem;
flash.desktop.DockIcon;
flash.desktop.SystemTrayIcon;
flash.events.Event;
public class SysTrayApp extends Sprite
{
public function SysTrayApp():void{
NativeApplication.nativeApplication.autoExit = false;
var icon:Loader = new Loader();
var iconMenu:NativeMenu = new NativeMenu();
var exitCommand:NativeMenuItem = iconMenu.addItem(new NativeMenuItem("Exit"));
exitCommand.addEventListener(Event.SELECT, function(event:Event):void {
NativeApplication.nativeApplication.icon.bitmaps = [];
NativeApplication.nativeApplication.exit();
});
if (NativeApplication.supportsSystemTrayIcon) {
NativeApplication.nativeApplication.autoExit = false;
icon.contentLoaderInfo.addEventListener(Event.COMPLETE, iconLoadComplete);
icon.load(new URLRequest("icons/AIRApp_16.png"));
var systray:SystemTrayIcon =
NativeApplication.nativeApplication.icon as SystemTrayIcon;
systray.tooltip = "AIR application";
systray.menu = iconMenu;
}
if (NativeApplication.supportsDockIcon){
icon.contentLoaderInfo.addEventListener(Event.COMPLETE,iconLoadComplete);
icon.load(new URLRequest("icons/AIRApp_128.png"));
var dock:DockIcon = NativeApplication.nativeApplication.icon as DockIcon;
dock.menu = iconMenu;
}
stage.nativeWindow.close();
}
private function iconLoadComplete(event:Event):void
{
NativeApplication.nativeApplication.icon.bitmaps =
[event.target.content.bitmapData];
}
}
}
Not: Örnek, uygulamanın icons alt dizininde AIRApp_16.png ve AIRApp_128.png adlı görüntü dosyaları olduğunu
varsayar. (Proje klasörünüze kopyalayabileceğiniz örnek simge dosyaları AIR SDK'da mevcuttur.)
Pencere görev çubuğu simge ve düğmeleri
Pencerelerin simgelenmiş temsilleri, kullanıcıların arka plandaki veya simge durumuna küçültülmüş pencerelere
kolayca erişebilmeleri için, genellikle dock veya görev çubuğunun pencere alanında görüntülenir. Mac OS X dock'u,
simge durumuna küçültülen her pencerenin yanı sıra, uygulamanız için de bir simge görüntüler. Microsoft Windows
görev çubuğu, uygulamanızda bulunan normal türdeki her pencereye ilişkin başlık ve program simgesini içeren bir
düğme görüntüler.
Görev çubuğu pencere düğmesini vurgulama
Bir pencere arka planda olduğunda, pencereyle ilişkin ilgilendiği bir olayın gerçekleştiğini kullanıcıya bildirebilirsiniz.
Mac OS X'te, kullanıcıyı uygulama dock simgesini zıplatarak bilgilendirebilirsiniz (“Dock'u zıplatma” sayfa 93
bölümünde açıklandığı gibi). Windows'ta, NativeWindow örneğinin notifyUser() yöntemini çağırarak pencere
görev çubuğu düğmesini vurgulayabilirsiniz. Yönteme iletilen type parametresi, bildirimin aciliyetini belirler.
•
NotificationType.CRITICAL: kullanıcı pencereyi ön plana getirene kadar, pencere simgesi yanıp söner.
•
NotificationType.INFORMATIONAL: pencere simgesi renk değiştirerek vurgulanır.
Aşağıdaki ifade, bir pencerenin görev çubuğu düğmesini vurgular:
stage.nativeWindow.notifyUser(NotificationType.CRITICAL);
İşletim sisteminde pencere düzeyinde bildirimi desteklemeyenNativeWindow.notifyUser() yönteminin
çağrılması etkisizdir. Pencere bildiriminin desteklenip desteklenmediğini belirlemek için
NativeWindow.supportsNotification özelliğini kullanın.
Görev çubuğu düğmeleri veya simgeleri içermeyen pencereler oluşturma
Windows işletim sisteminde, utility veya lightweight türüyle oluşturulan pencereler görev çubuğunda görünmez.
Görünür olmayan pencereler görev çubuğunda da görüntülenmez.
İlk pencerenin normal türünde olması gerektiğinden, görev çubuğunda görünen herhangi bir pencere içermeyen bir
uygulama oluşturmak için ilk pencereyi kapatmalı veya görünmez olarak bırakmalısınız. Uygulamayı iptal etmeden
uygulamanızdaki tüm pencereleri kpatmak için, son pencereyi kapatmadan önce NativeApplication nesnesinin
autoExit özelliğini false olarak ayarlayın. İlk pencerenin görünür olmasını engellemek için, uygulama tanımlayıcı
dosyasının <initalWindow> öğesine <visible>false</visible> özelliğini ekleyin (ve visible özelliğini true
olarak ayarlamayın veya pencerenin activate() yöntemini çağırmayın).
Uygulama tarafından açılan yeni pencerelerde, pencere yapıcısına iletilen NativeWindowInitOption nesnesinin type
özelliğini NativeWindowType.UTILITY veya NativeWindowType.LIGHTWEIGHT olarak ayarlayın.
Mac OS X'te, simge durumuna küçültülen pencereler dock görev çubuğunda görüntülenir. Pencereyi simge durumuna
küçültmek yerine gizlediğinizde, küçültülen simgenin görüntülenmesini engelleyebilirsiniz. Aşağıdaki örnek bir
nativeWindowDisplayState değişiklik olayını dinler ve pencere simge durumuna küçültüldüğünde bu olayı iptal
eder. Bunun yerine işleyici, pencerenin visible özelliğini false olarak ayarlar:
private function preventMinimize(event:NativeWindowDisplayStateEvent):void{
if(event.afterDisplayState == NativeWindowDisplayState.MINIMIZED){
event.target.visible = false;
}
}
Mac OS X dock'unda bir pencere simge durumuna küçültülmüşse, visible özelliğini false olarak ayarladığınızda
dock simgesi kaldırılmaz. Kullanıcı yine de, pencerenin yeniden görünmesi için simgeyi tıklatabilir.
97
Bölüm 14: Dosya sistemiyle çalışma
Ana bilgisayarın dosya sistemine erişmek için, Adobe® AIR™ dosya sistemi API'si tarafından sağlanan sınıfları
kullanırsınız. Bu sınıfları kullanarak dizinlere ve dosyalara erişebilir ve bunları yönetebilir, oluşturabilir, dosyalara veri
yazabilir, vb. işlemler gerçekleştirebilirsiniz.
AIR Dosya API'si hakkında ek çevrimiçi bilgiler
Dosya API sınıflarını kullanma hakkında daha fazla bilgiye şu kaynaklardan ulaşabilirsiniz:
• Metin dosyası düzenleyicisi oluşturma
Dil Başvurusu
• File
• FileStream
• FileMode
Adobe Geliştirici Bağlantısı Makaleler ve Örnekler
• Flash için Adobe AIR Geliştirici Bağlantısı ('AIR filesystem'ı arayın)
AIR dosyası temel bilgileri
Adobe AIR hem dosyalara hem de klasörlere erişmek, bunları oluşturmak ve yönetmek için kullanabileceğiniz sınıflar
sağlar. flash.filesystem paketinde bulunan bu sınıflar şu şekilde kullanılır:
Dosya sınıfları
Açıklama
File
File nesnesi bir dosya veya dizin yolunu temsil eder. Bir file nesnesini, dosya veya klasörle etkileşim başlatan bir
dosyaya veya klasöre işaretçi oluşturmak için kullanırsınız.
FileMode
FileMode sınıfı, FileStream sınıfının open() ve openAsync() yöntemlerinin fileMode parametresinde kullanılan
dize sabitlerini tanımlar. Bu yöntemlerin fileMode parametresi, dosya açıldıktan sonra FileStream nesnesi
tarafından kullanılabilen, aralarında yazma, okuma, ekleme ve güncelleme bulunan özellikleri belirler.
FileStream
FileStream nesnesi dosyaları okuma ve yazma için açmada kullanılır. Yeni veya var olan bir dosyaya işaret eden bir
File nesnesi oluşturduktan sonra o işaretçiyi FileStream nesnesine iletirsiniz, böylece dosyanın içindeki verileri açıp
işleyebilirsiniz.
File sınıfındaki bazı yöntemlerin hem senkronize hem de senkronize olmayan sürümleri vardır:
•
File.copyTo() veFile.copyToAsync()
•
File.deleteDirectory() ve File.deleteDirectoryAsync()
•
File.deleteFile() ve File.deleteFileAsync()
•
File.getDirectoryListing() ve File.getDirectoryListingAsync()
Dosya sistemiyle çalışma
•
File.moveTo() ve File.moveToAsync()
•
File.moveToTrash() ve File.moveToTrashAsync()
Ayrıca FileStream işlemlerinin senkronize veya senkronize olmayan şekilde çalışmasını FileStream nesnesinin dosyayı
açma şekli belirler: open() yöntemini çağırarak veya openAsync() yöntemini çağırarak.
Senkronize olmayan sürümler arka planda çalışan işlemleri başlatmanızı ve tamamlandığında (veya hata olayı
oluştuğunda) olayları göndermenizi sağlar. Bu senkronize olmayan işlemler arka planda sürerken, başka kod
çalışabilir. İşlemlerin senkronize olmayan sürümleriyle, işlevi çağıran File veya FileStream nesnesinin
addEventListener() yöntemini kullanarak olay dinleyicisi işlevleri oluşturmalısınız.
Senkronize sürümler sayesinde, olay dinleyicileri ayarlamaya dayanmayan daha basit kod yazabilirsiniz. Ancak,
senkronize bir yöntem çalışırken başka kod çalışamadığı için, görüntüleme nesnesi oluşturma ve animasyon gibi
önemli işlemler duraklatılabilir.
File nesneleriyle çalışma
File nesnesi dosya sistemindeki bir dosyaya veya dizine işaretçidir.
File sınıfı FileReference sınıfını genişletir. AIR'in yanı sıra Adobe® Flash® Player'da da mevcut olan FileReference sınıfı
bir dosyaya işaretçiyi temsil eder, ancak File sınıfı güvenlik nedenleriyle Flash Player'da açık olmayan özellikleri ve
yöntemleri ekler (tarayıcıda çalışan bir SWF dosyasında).
File sınıfı hakkında
File sınıfını aşağıdaki işlemler için kullanabilirsiniz:
• Kullanıcı dizini, kullanıcının documents dizini, uygulamanın başlatıldığı dizin ve uygulama dizini de dahil olmak
üzere özel dizinlerin yolunu alma
• Dosyaları ve dizinleri kopyalama
• Dosyaları ve dizinleri taşıma
• Dosyaları ve dizinleri silme (veya çöp kutusuna taşıma)
• Bir dizinde bulunan dosyaları ve dizinleri listeleme
• Geçici dosyalar ve klasörler oluşturma
Bir File nesnesi dosya yoluna işaret ettikten sonra, FileStream sınıfını kullanarak dosya verilerini okumak ve yazmak
için dosya yolunu kullanabilirsiniz.
File nesnesi henüz var olmayan bir dosyanın veya dizinin yoluna işaret edebilir. Böyle bir File nesnesini dosya veya
dizin oluştururken kullanabilirsiniz.
File nesnelerinin Yolları
Her File nesnesi, yolunu tanımlayan iki özelliğe sahiptir:
Özellik
Açıklama
nativePath
Bir dosyanın platforma özgü yolunu belirtir. Örneğin Windows'ta bir yol "c:\Sample directory\test.txt" olurken
Mac OS'de "/Sample directory/test.txt" olabilir. nativePath özelliği dizin ayırıcı karakteri olarak Windows'ta
ters eğik çizgi (\) karakterini, Mac OS'de eğik çizgi (/) karakterini kullanır.
url
Bir dosyaya işaret etmek için, dosya URL şemasını kullanabilir. Örneğin Windows'ta bir yol
"file:///c:/Sample%20directory/test.txt" olurken Mac OS'de "file:///Sample%20directory/test.txt" olabilir.
Çalışma zamanı file öğesinin yanında başka özel URL şemaları da içerir ve bunlar “Desteklenen URL şemaları”
sayfa 103 bölümünde anlatılmaktadır
File sınıfı hem Mac hem de Windows'ta standart dizinlere işaret etmek için özellikler içerir.
File nesnesini bir dizine işaret etme
Bir File nesnesini bir dizine işaret etmesi için ayarlamanın farklı yolları vardır.
Kullanıcının ana dizinine işaret etme
Bir File nesnesini kullanıcının ana dizinine yönlendirebilirsiniz. Windows'ta ana dizin "Belgelerim" dizininin üst
öğesidir (örneğin "C:\Documents and Settings\userName\Belgelerim"). Mac OS'de bu Users/userName dizinidir.
Aşağıdaki kod bir File nesnesini ana dizinin AIR Test alt dizinine işaret etmesi için ayarlar:
var file:File = File.userDirectory.resolvePath("AIR Test");
Kullanıcının documents dizinine işaret etme
Bir File nesnesini kullanıcının documents dizinine yönlendirebilirsiniz. Windows'ta bu genellikle "Belgelerim"
dizinidir (örneğin "C:\Documents and Settings\userName\Belgelerim"). Mac OS'de Users/userName/Documents
dizinidir. Aşağıdaki kod bir File nesnesini documents dizininin AIR Test alt dizinine işaret etmesi için ayarlar:
var file:File = File.documentsDirectory.resolvePath("AIR Test");
Masaüstü dizinine işaret etme
Bir File nesnesini masaüstüne işaret edebilirsiniz. Aşağıdaki kod bir File nesnesini masaüstünün AIR Test alt dizinine
işaret etmesi için ayarlar:
var file:File = File.desktopDirectory.resolvePath("AIR Test");
Uygulama depolama dizinine işaret etme
Bir File nesnesini uygulama depolama dizinine işaret edebilirsiniz. Her AIR uygulaması için, uygulama depolama
dizinini tanımlayan ilişkilendirilmiş, benzersiz bir yol vardır. Bu dizin her uygulama ve kullanıcı için benzersizdir. Bu
dizini kullanıcıya özgü, uygulamaya özgü verileri saklamak için kullanmak isteyebilirsiniz (kullanıcı verileri ve
tercihler dosyaları gibi). Örneğin aşağıdaki kod bir File nesnesini uygulama depolama dizininde bulunan bir tercihler
dosyası olan prefs.xml dosyasına işaret eder:
var file:File = File.applicationStorageDirectory;
file = file.resolvePath("prefs.xml";
Uygulama depolama dizininin konumu kullanıcı adına, uygulama kimliğine ve yayıncı kimliğine bağlıdır:
• Mac OS'de—Şu dizinde:
/Users/user name/Library/Preferences/applicationID.publisherID/Local Store/
Örneğin:
/Users/babbage/Library/Preferences/com.example.TestApp.02D88EEED35F84C264A183921344EEA353
A629FD.1/Local Store
• Windows'ta—Belgeler ve ayarlar dizininde, şu konumda:
user name/Application Data/applicationID.publisherID/Local Store/
Örneğin:
C:\Documents and Settings\babbage\Application
Data\com.example.TestApp.02D88EEED35F84C264A183921344EEA353A629FD.1\Local Store
File.applicationStorageDirectory ile oluşturulan bir File nesnesinin URL'si (ve url özelliği), aşağıda
gösterildiği gibi app-storage URL şemasını kullanır (bkz. “Desteklenen URL şemaları” sayfa 103):
var dir:File = File.applicationStorageDirectory;
dir = dir.resolvePath("preferences");
trace(dir.url); // app-storage:/preferences
Uygulama dizinine işaret etme
Bir File nesnesini uygulamanın yüklendiği, uygulama dizini olarak bilinen dizine işaret edebilirsiniz. Bu dizine
File.applicationDirectory özelliğini kullanarak başvurabilirsiniz. Bu dizini uygulama tanımlayıcı dosyasını veya
uygulamayla yüklenen başka kaynakları incelemek için kullanabilirsiniz. Örneğin aşağıdaki kod bir File nesnesini
uygulama dizinindeki images adlı bir dizine işaret eder:
var dir:File = File.applicationDirectory;
dir = dir.resolvePath("images");
File.applicationDirectory ile oluşturulan bir File nesnesinin URL'si (ve url özelliği), aşağıda gösterildiği gibi app
URL şemasını kullanır (bkz. “Desteklenen URL şemaları” sayfa 103):
var dir:File = File.applicationDirectory;
dir = dir.resolvePath("images");
trace(dir.url); // app:/images
Dosya sistemi köküne işaret etme
File.getRootDirectories() yöntemi bir Windows bilgisayarındaki C: ve bağlanmış birimler gibi tüm kök
birimleri listeler. Mac'te bu yöntem her zaman bilgisayarın benzersiz kök dizinini ("/" dizini) döndürür.
Açık bir dizine işaret etme
Aşağıdaki örnekte olduğu gibi, File nesnesinin nativePath özelliğini ayarlayarak File nesnesini açık bir dizine işaret
edebilirsiniz (Windows'ta):
var file:File = new File();
file.nativePath = "C:\\AIR Test\";
Göreceli yollara gitme
Belirli bir yola göreceli olan bir yol edinmek için resolvePath() yöntemini kullanabilirsiniz. Aşağıdaki kod bir File
nesnesini kullanıcının ana dizininin "AIR Test" alt dizinine işaret etmesi için ayarlar:
var file:File = File.userDirectory;
file = file.resolvePath("AIR Test");
Ayrıca, aşağıda gösterildiği gibi File nesnesini URL dizesine bağlı bir dizine işaret etmek için de nesnenin url özelliğini
kullanabilirsiniz:
var urlStr:String = "file:///C:/AIR Test/";
var file:File = new File()
file.url = urlStr;
Daha fazla bilgi için bkz. “Dosya yollarını değiştirme” sayfa 103.
Kullanıcının bir dizin seçmek için gözatmasını sağlama
File sınıfı, kullanıcının nesneye atamak için bir dizin seçebileceği sistem iletişim kutusu sağlayan
browseForDirectory() yöntemini içerir. browseForDirectory() yöntemi senkronize değildir. Kullanıcı bir dizin
seçip Aç düğmesini tıklatırsa bir select olayı veya kullanıcı İptal düğmesini tıklatırsa bir cancel olayı gönderir.
Örneğin aşağıdaki kod kullanıcının bir dizin seçmesine olanak tanır ve seçilirse dizin yolunu çıkarır:
file.addEventListener(Event.SELECT, dirSelected);
file.browseForDirectory("Select a directory");
function dirSelected(e:Event):void {
trace(file.nativePath);
}
Uygulamanın çağrıldığı dizine işaret etme
Uygulama çağrıldığında gönderilen InvokeEvent nesnesinin currentDirectory özelliğini işaretleyerek bir
uygulamanın çağrıldığı dizin konumunu alabilirsiniz. Ayrıntılar için bkz. “Komut satırı argümanlarını yakalama”
sayfa 258.
File nesnesini bir dosyaya işaret etme
Bir File nesnesinin işaret ettiği dosyayı ayarlamanın farklı yolları vardır.
Açık dosya yoluna işaret etme
Belirli bir yola göreceli olan bir yol edinmek için resolvePath() yöntemini kullanabilirsiniz. Örneğin aşağıdaki kod
bir File nesnesini uygulama depolama dizininin içindeki bir log.txt dosyasına işaret etmek üzere ayarlar:
var file:File = File.applicationStorageDirectory;
file = file.resolvePath("log.txt");
Aşağıda gösterildiği gibi File nesnesini URL dizesine bağlı bir dosyaya veya dizine işaret etmek için de nesnenin url
özelliğini kullanabilirsiniz:
var urlStr:String = "file:///C:/AIR Test/test.txt";
var file:File = new File()
file.url = urlStr;
Ayrıca URL'yi aşağıda olduğu gibi File() yapıcı işlevine de iletebilirsiniz:
var urlStr:String = "file:///C:/AIR Test/test.txt";
var file:File = new File(urlStr);
url özelliği her zaman URL'nin URI kodlu sürümünü döndürür (örneğin boşluklar "%20 ile değiştirilir):
file.url = "file:///c:/AIR Test";
trace(file.url); // file:///c:/AIR%20Test
Ayrıca açık bir yol ayarlamak için File nesnesinin nativePath özelliğini de kullanabilirsiniz. Örneğin aşağıdaki kod
Windows yüklü bir bilgisayarda çalıştırıldığında, File nesnesini, C: sürücüsünün AIR Test alt dizinindeki test.txt
dosyasına ayarlar:
file.nativePath = "C:/AIR Test/test.txt";
Ayrıca bu yolu aşağıda olduğu gibi File() yapıcı işlevine de iletebilirsiniz:
var file:File = new File("C:/AIR Test/test.txt");
Windows'ta eğik çizgi (/) veya ters eğik çizgi (\) karakterini nativePath özelliği için yol sınırlayıcı olarak
kullanabilirsiniz. Mac OS'de nativePath için yol sınırlayıcı olarak eğik çizgi (/) karakterini kullanın:
var file:File = new File(/Users/dijkstra/AIR Test/test.txt");
Daha fazla bilgi için bkz. “Dosya yollarını değiştirme” sayfa 103.
Bir dizindeki dosyaları numaralandırma
Bir dizinin kök düzeyinde dosyalara ve alt dizinlere işaret eden File nesnelerinin bir dizisini almak için File nesnesinin
getDirectoryListing() yöntemini kullanabilirsiniz. Daha fazla bilgi için bkz. “Dizinleri numaralandırma”
sayfa 107.
Kullanıcının bir dosya seçmek için gözatmasını sağlama
File sınıfı, kullanıcının nesneye atamak için bir dosya seçebileceği sistem iletişim kutusu sağlayan aşağıdaki yöntemleri
içerir.
•
browseForOpen()
•
browseForSave()
•
browseForOpenMultiple()
Bu yöntemlerin tümü senkronize olmayan yöntemlerdir. Kullanıcı bir dosya seçtiğinde (veya browseForSave()
durumunda hedef yol) browseForOpen() ve browseForSave() yöntemleri select olayını gönderir.
browseForOpen() ve browseForSave() yöntemleriyle, seçimden sonra hedef File nesnesi seçili dosyalara işaret eder.
Kullanıcı dosyaları seçtiğinde, browseForOpenMultiple() yöntemi bir selectMultiple olayı gönderir.
selectMultiple olayı, File nesneleri dizisi olan bir files özelliğine sahip olan (seçili dosyalara işaret eden)
FileListEvent türüdür.
Örneğin aşağıdaki kod kullanıcıya, kullanıcının bir dosya seçebileceği “Aç” iletişim kutusunu sunar:
var fileToOpen:File = File.documentsDirectory;
selectTextFile(fileToOpen);
function selectTextFile(root:File):void
{
var txtFilter:FileFilter = new FileFilter("Text", "*.as;*.css;*.html;*.txt;*.xml");
root.browseForOpen("Open", [txtFilter]);
root.addEventListener(Event.SELECT, fileSelected);
}
function fileSelected(event:Event):void
{
trace(fileToOpen.nativePath);
}
Bir browse yöntemini çağırdığınızda uygulamada başka bir tarayıcı iletişim kutusu açıksa, çalışma zamanı bir Hata
istisnası atar.
Dosya yollarını değiştirme
Ayrıca aşağıdaki örneklerde olduğu gibi, var olan bir File nesnesinin yolunu resolvePath() yöntemini çağırarak veya
nesnenin nativePath ya da url özelliğini değiştirerek de değiştirebilirsiniz:
var file1:File = File.documentsDirectory;
file1 = file1.resolvePath("AIR Test");
trace(file1.nativePath); // C:\Documents and Settings\userName\My Documents\AIR Test
file2 = file2.resolvePath("..");
trace(file2.nativePath); // C:\Documents and Settings\userName
file3.nativePath += "/subdirectory";
trace(file3.nativePath); // C:\Documents and Settings\userName\My Documents\subdirectory
var file4:File = new File();
file4.url = "file:///c:/AIR Test/test.txt";
trace(file4.nativePath); // C:\AIR Test\test.txt
nativePath özelliğini kullanırken, Windows'ta dizin ayırıcı karakteri olarak eğik çizgi (/) veya ters eğik çizgi (\)
karakterini; Mac OS'de ise eğik çizgi (/) karakterini kullanırsınız. Windows'ta bir dize değişmezinde eğik çizgi
karakterini iki kere yazmayı unutmayın.
Desteklenen URL şemaları
Bir File nesnesinin url özelliğini tanımlarken, aşağıdaki URL şemalarından herhangi birini kullanabilirsiniz:
URL şeması
Açıklama
file
Dosya sisteminin köküne göreceli olan bir yol belirtmek için kullanın. Örneğin:
file:///c:/AIR Test/test.txt
URL standardı bir dosya URL'sinin file://<host>/<path> formunu alacağını belirtir. Özel bir durum olarak
<host>, "URL'nin yorumlandığı bilgisayar" olarak yorumlanan boş dize olabilir. Bu nedenle dosya URL'leri genellikle
üç eğik çizgiye (///) sahiptir.
app
Yüklü uygulamanın kök dizinine göreceli bir yol belirtmek için kullanın (yüklü uygulama için application.xml
dosyasını içeren dizin). Örneğin aşağıdaki yol, yüklü uygulamanın dizininin görüntüler alt dizinine işaret eder:
app:/images
app-storage
Uygulama depolama dizinine göreceli bir yol belirtmek için kullanın. AIR her yüklenen uygulama için, o uygulamaya
özgü verilerin saklanmasına yönelik kullanışlı bir yer olan benzersiz bir uygulama depolama dizini tanımlar. Örneğin
aşağıdaki yol, uygulama depolama dizininin ayarlar alt dizininde bulunan bir prefs.xml dosyasını işaret eder:
app-storage:/settings/prefs.xml
İki dosya arasındaki göreceli yolu bulma
İki dosya arasındaki göreceli yolu bulmak için getRelativePath() yöntemini kullanabilirsiniz:
var file1:File = File.documentsDirectory.resolvePath("AIR Test");
var file2:File = File.documentsDirectory
file2 = file2.resolvePath("AIR Test/bob/test.txt");
trace(file1.getRelativePath(file2)); // bob/test.txt
getRelativePath() yönteminin ikinci parametresi olan useDotDot parametresi, .. sözdiziminin üst dizinleri
göstermek için sonuçlarda döndürülmesine izin verir:
file1 = file1.resolvePath("AIR Test");
file2 = file2.resolvePath("AIR Test/bob/test.txt");
file3 = file3.resolvePath("AIR Test/susan/test.txt");
trace(file2.getRelativePath(file1, true)); // ../..
trace(file3.getRelativePath(file2, true)); // ../../bob/test.txt
Dosya adlarının kurallı sürümlerini alma
Dosya ve yol adları genellikle büyük/küçük harf duyarlı değildir. Aşağıdaki örnekte iki File nesnesi aynı dosyaya işaret
etmektedir:
File.documentsDirectory.resolvePath("test.txt");
File.documentsDirectory.resolvePath("TeSt.TxT");
Ancak belgeler ve dizin adları büyük harf içerir. Örneğin aşağıda, aşağıdaki örneklerde olduğu gibi documents
dizininde AIR Test adlı bir klasör olduğunu varsayılmıştır:
var file:File = File.documentsDirectory.resolvePath("AIR test");
trace(file.nativePath); // ... AIR test
file.canonicalize();
trace(file.nativePath); // ... AIR Test
canonicalize yöntemi nativePath nesnesini, dosya veya dizin adı için doğru şekilde büyük harf kullanmak üzere
dönüştürür.
Aşağıdaki örneklerde gösterildiği gibi Windows'ta kısa dosya adlarını ("8.3" adlar) uzun dosya adlarına dönüştürmek
için canonicalize() yöntemini de kullanabilirsiniz:
var path:File = new File();
path.nativePath = "C:\\AIR~1";
path.canonicalize();
trace(path.nativePath); // C:\AIR Test
Paketlerle ve sembolik linklerle çalışma
Birçok işletim sistemi paket dosyalarını ve sembolik link dosyalarını destekler:
PaketlerMac OS'de dizinler paketler olarak belirlenebilir ve Mac OS Finder'da bir dizin olarak değil tek bir dosya
olarak görünür.
Sembolik linklerSembolik linkler bir dosyanın diskteki başka bir dosyaya veya dizine işaret etmesini sağlar. Sembolik
linkler başka adlara benzer olsa da, aynı değildir. Başka ad her zaman bir dosya olarak bildirilir (dizin olarak değil) ve
başka ada veya kısayola okuma ya da yazma işlemi hiçbir zaman işaret ettiği orijinal dosyayı veya dizini etkilemez.
Diğer yandan sembolik link tam olarak işaret ettiği dosya veya dizin gibi davranır. Bir dosya veya dizin olarak
bildirilebilir ve sembolik linke okuma veya yazma işlemi sembolik linkin kendisini değil, işaret ettiği dosyayı veya
dizini etkiler.
File sınıfı, bir File nesnesinin bir pakete veya sembolik linke başvurup başvurmadığını kontrol etmek için isPackage
ve isSymbolicLink özelliklerini içerir.
Aşağıdaki kod kullanıcının masaüstü dizini üzerinden, paket olmayan alt dizinleri listeleyerek yinelenir:
var desktopNodes:File = File.desktopDirectory.getDirectoryListing();
for (var i:uint = 0; i < desktopNodes.length; i++)
{
if (desktopNodes[i].isDirectory && !!desktopNodes[i].isPackage)
{
trace(desktopNodes[i].name);
}
}
Aşağıdaki kod kullanıcının masaüstü dizini üzerinden, sembolik linkler olmayan dosyaları ve dizinleri listeleyerek
yinelenir:
{
if (!desktopNodes[i].isSymbolicLink)
{
trace(desktopNodes[i].name);
}
}
canonicalize() yöntemi, linkin başvurduğu dosyaya veya dizine işaret etmek için sembolik bir linkin yolunu
değiştirir. Aşağıdaki kod kullanıcının masaüstü dizini üzerinden yinelenir ve sembolik linkler olan dosyalar tarafından
başvurulan yolları bildirir:
{
if (desktopNodes[i].isSymbolicLink)
{
var linkNode:File = desktopNodes[i] as File;
linkNode.canonicalize();
trace(linkNode.nativePath);
}
}
Bir birimdeki kullanılabilir alanı belirleme
Bir File nesnesinin spaceAvailable özelliği, Dosya konumunda bayt olarak kullanılabilir olan alandır. Örneğin
aşağıdaki kod uygulama depolama dizininde kullanılabilir olan alanı kontrol eder:
trace(File.applicationStorageDirectory.spaceAvailable);
File nesnesi bir dizine başvurursa, spaceAvailable özelliği, dizinde dosyaların kullanabileceği alanı gösterir. File
nesnesi bir dosyaya başvurursa, spaceAvailable özelliği dosyanın büyütülebileceği alanı gösterir. Dosya konumu
yoksa, spaceAvailable özelliği 0'a ayarlanır. File nesnesi sembolik bir linke başvurursa, spaceAvailable özelliği
sembolik linkin işaret ettiği konumdaki kullanılabilir alana ayarlanır.
Genellikle bir dizin veya dosya için kullanılabilir olan alan, dizini veya dosyayı içeren birimdeki kullanılabilir alanla
aynıdır. Ancak kullanılabilir alan, kotaları ve dizin başına sınırlamaları hesaba katabilir.
Bir dosyayı veya dizini bir birime eklemek genellikle dosyanın gerçek boyutundan veya dizin içeriğinin boyutundan
daha fazla alan gerektirir. Örneğin işletim sistemi dizin bilgilerini saklamak için daha fazla alan gerektirebilir. Veya
gerekli disk kesimleri ek alan kullanabilir. Ayrıca kullanılabilir alanlar dinamik olarak değişir. Dolayısıyla bildirilen
alanın tamamını dosya depolama için ayıramazsınız. Dosya sistemine yazma hakkında bilgi için bkz. “Dosyaları
okuma ve dosyalara yazma” sayfa 111.
Dosya sistemi bilgilerini alma
File sınıfı, dosya sistemi hakkında bazı yararlı bilgiler sağlayan aşağıdaki statik özellikleri içerir:
Özellik
Açıklama
File.lineEnding
Ana bilgisayar işletim sistemi tarafından kullanılan satır sonlandırıcı karakter dizisi. Bu, Mac OS'de satır besleme
karakteridir. Bu, Windows'ta arkasından satır besleme karakteri gelen satır başı karakteridir.
File.separator
Ana bilgisayar işletim sisteminin yol bileşeni ayırıcı karakteri. Bu, Mac OS'de eğik çizgi (/) karakteridir. Bu,
Windows'ta ters eğik çizgi (\) karakteridir.
File.systemCharset
Ana bilgisayar işletim sistemi tarafından dosyalar için kullanılan varsayılan kodlama. Bu, işletim sistemi
tarafından kullanılan diline karşılık gelen karakter kümesiyle de ilgilidir.
Capabilities sınıfı da dosyalarla çalışırken yararlı olabilecek sistem bilgileri içerir:
Özellik
Açıklama
Capabilities.hasIME
Oynatıcının bir giriş yöntemi düzenleyicisi (IME) yüklü (true) bir sistem üzerinde mi, yüklü olmayan (false) bir
sistem üzerinde mi çalıştığını belirtir.
Capabilities.language
Oynatıcının üzerinde çalıştığı sistemin dil kodunu belirtir.
Capabilities.os
Geçerli işletim sistemini belirtir.
Dizinlerle çalışma
Çalışma zamanı size yerel dosya sistemindeki dizinlerle çalışmaya yönelik özellikler sağlar.
Dizinlere işaret eden File nesneleri oluşturma hakkında bilgi için bkz. “File nesnesini bir dizine işaret etme” sayfa 99.
Dizin oluşturma
File.createDirectory() yöntemi bir dizin oluşturmanızı sağlar. Örneğin aşağıdaki kod, kullanıcının ana dizininin
alt dizini olarak AIR Test adlı bir dosya oluşturur.
var dir:File = File.userDirectory.resolvePath("AIR Test");
dir.createDirectory();
Dizin varsa, createDirectory() yöntemi bir işlem gerçekleştirmez.
Ayrıca bazı modlarda FileStream nesnesi dosyaları açarken dizin oluşturur. Bir FileStream örneğini
FileMode.APPEND veya FileMode.WRITE olarak ayarlı FileStream() yapıcı kümesinin fileMode parametresiyle
başlattığınızda, eksik dizinler oluşturulur. Daha fazla bilgi için bkz. “Dosyaları okuma ve dosyalara yazma için iş akışı”
sayfa 111.
Geçici bir dizin oluşturma
File sınıfı, aşağıdaki örnekte olduğu gibi Sistem için geçici bir dizin klasöründe bir dizin oluşturan
createTempDirectory() yöntemini içerir.
var temp:File = File.createTempDirectory();
createTempDirectory() yöntemi otomatik olarak benzersiz bir geçici dizin oluşturur (yeni bir benzersiz konum
belirlemekle uğraşmamış olursunuz).
Geçici bir dizini, bir uygulama oturumu için kullanılan geçici dosyaları saklamak için kullanabilirsiniz. Sistem geçici
dizininde yeni, benzersiz geçici dosyalar oluşturmak için bir createTempFile() yöntemi bulunduğunu unutmayın.
Otomatik olarak silinmediği için, uygulamayı kapamadan önce geçici dizini silmek isteyebilirsiniz.
Dizinleri numaralandırma
Bir dizindeki dosyalara ve alt klasörlere işaret eden bir File nesneleri dizisini almak için, File nesnesinin
getDirectoryListing() veya getDirectoryListingAsync() yöntemini kullanabilirsiniz.
Örneğin aşağıdaki kod kullanıcının documents dizininin (alt dizinleri incelemeden) içeriğini listeler.
var directory:File = File.documentsDirectory;
var contents:Array = directory.getDirectoryListing();
for (var i:uint = 0; i < contents.length; i++)
{
trace(contents[i].name, contents[i].size);
}
Yöntemin senkronize olmayan sürümünü kullanırken, directoryListing olay nesnesi, dizinlerle ilgili File
nesnelerinin dizisi olan bir files özelliğine sahiptir:
var directory:File = File.documentsDirectory;
directory.getDirectoryListingAsync();
directory.addEventListener(FileListEvent.DIRECTORY_LISTING, dirListHandler);
function dirListHandler(event:FileListEvent):void
{
var contents:Array = event.files;
for (var i:uint = 0; i < contents.length; i++)
{
trace(contents[i].name, contents[i].size);
}
}
Dizinleri kopyalama ve taşıma
Bir dizini, bir dosyayı kopyalamak veya taşımak için kullanacağınız yöntemlerin aynılarını kullanarak kopyalayabilir
veya taşıyabilirsiniz. Örneğin aşağıdaki kod bir dizini senkronize olarak kopyalar:
var sourceDir:File = File.documentsDirectory.resolvePath("AIR Test");
var resultDir:File = File.documentsDirectory.resolvePath("AIR Test Copy");
sourceDir.copyTo(resultDir);
copyTo() yönteminin overwrite parametresi için true değerini belirttiğinizde, mevcut bir hedef dizindeki tüm
dosyalar ve klasörler silinir ve yerine kaynak dizindeki dosyalar ve klasörler konur (hedef dosya kaynak dizinde olmasa
bile).
copyTo() yönteminin newLocation parametresi olarak belirttiğiniz dizin, sonuçta oluşan dizinin yolunu belirtir;
sonuçta oluşan dizini içerecek olan üst dizini belirtmez.
Ayrıntılar için bkz. “Dosyaları kopyalama ve taşıma” sayfa 109.
Dizin içeriğini silme
File sınıfı bir deleteDirectory() ve bir deleteDirectoryAsync() yöntemi içerir. İlki senkronize, ikincisi
senkronize olmayan bir şekilde çalışan bu yöntemler dizinleri siler (bkz. “AIR dosyası temel bilgileri” sayfa 97). Her iki
yöntem de deleteDirectoryContents parametresini içerir (Boolean değeri alır); bu parametre true olarak
ayarlıyken (varsayılan değer false değeridir) yönteme yapılan çağrı boş olmayan dizinleri siler; aksi takdirde yalnızca
boş dizinler silinir.
Örneğin aşağıdaki kod kullanıcının documents dizininin AIR Test alt dizinini senkronize olarak siler:
var directory:File = File.documentsDirectory.resolvePath("AIR Test");
directory.deleteDirectory(true);
Aşağıdaki kod kullanıcının documents dizininin AIR Test alt dizinini senkronize olmayan bir şekilde siler:
var directory:File = File.documentsDirectory.resolvePath("AIR Test");
directory.addEventListener(Event.COMPLETE, completeHandler)
directory.deleteDirectoryAsync(true);
function completeHandler(event:Event):void {
trace("Deleted.")
}
Ayrıca, bir dizini Sistem çöp kutusuna taşımak için kullanabileceğiniz moveToTrash() ve moveToTrashAsync()
yöntemleri de bulunmaktadır. Ayrıntılar için bkz. “Bir dosyayı çöp kutusuna taşıma” sayfa 110.
Dosyalarla çalışma
AIR dosya API'sini kullanarak uygulamalarınıza temel dosya etkileşim özellikleri ekleyebilirsiniz. Örneğin dosyaları
okuyabilir, yazabilir, kopyalayabilir ve silebilir, vb. işlemler gerçekleştirebilirsiniz. Uygulamalarınız yerel dosya
sistemine erişebileceği için, önceden yapmadıysanız “AIR güvenliği” sayfa 23 bölümüne bakın.
Not: Bir dosya türünü AIR uygulamasıyla ilişkilendirebilirsiniz (böylece uygulama çift tıklatılarak açılabilir). Ayrıntılar
için bkz. “Dosya ilişkilendirmelerini yönetme” sayfa 265.
Dosya bilgilerini alma
File sınıfı, bir File nesnesinin işaret ettiği dosya veya dizin hakkında bilgi sağlayan aşağıdaki özellikleri içerir:
Dosya özelliği
Açıklama
creationDate
Yerel diskteki dosyanın oluşturulma tarihi.
creator
Geçersiz—extension özelliğini kullanın. (Bu özellik dosyanın Macintosh oluşturucu türünü bildirir, bu yalnızca
Mac OS X'ten önceki Mac OS sürümlerinde kullanılır.)
exists
Başvurulan dosyanın veya dizinin var olup olmadığı.
Dosya özelliği
Açıklama
extension
Son noktanın (".") arkasından gelen (noktayı içermeyen) adın bir parçası olan dosya uzantısı. Dosya adında nokta
yoksa, uzantı null değerine sahiptir.
icon
Dosya için tanımlanan simgeleri içeren bir Icon nesnesi.
isDirectory
File nesnesi başvurusunun bir dizine yönelik olup olmadığı.
modificationDate
Yerel diskteki dosyanın veya dizinin son değiştirilme tarihi.
name
Yerel diskteki dosyanın veya dizinin adı (varsa dosya uzantısını da içeren).
nativePath
Ana bilgisayar işletim sistemi temsilcisindeki tam yol. Bkz. “File nesnelerinin Yolları” sayfa 98.
parent
File nesnesi tarafından temsil edilen klasörü veya dosyayı içeren klasör. File nesnesi dosya sisteminin kökündeki bir
dosyaya veya dizine başvuruyorsa, bu özellik null değerindedir.
size
Yerel diskteki dosyanın bayt olarak boyutu.
type
Geçersiz—extension özelliğini kullanın. (Macintosh'ta bu özellik dört karakterli dosya türüdür, bu tür yalnızca
Mac OS X'ten önceki Mac OS sürümlerinde kullanılır.)
url
Dosyanın veya dizinin URL'si. Bkz. “File nesnelerinin Yolları” sayfa 98.
Bu özellikler hakkında ayrıntılı bilgi için ActionScript 3.0 Dil ve Bileşen Başvurusu
(http://www.adobe.com/go/learn_air_aslr_tr) bölümündeki File sınıfı girişine bakın.
Dosyaları kopyalama ve taşıma
File sınıfı dosyaları veya dizinleri kopyalamak için iki yöntem içerir: copyTo() ve copyToAsync(). File sınıfı dosyaları
veya dizinleri taşımak için iki yöntem içerir: moveTo() ve moveToAsync(). copyTo() ve moveTo() yöntemleri
senkronize çalışır; copyToAsync() ve moveToAsync() yöntemleri senkronize olmayan bir şekilde çalışır (bkz. “AIR
dosyası temel bilgileri” sayfa 97).
Bir dosyayı kopyalamak veya taşımak için iki File nesnesi ayarlarsınız. Biri kopyalanacak veya taşınacak olan dosyaya
işaret eder, bu copy veya move yöntemini çağıran nesnedir; diğeri hedef (sonuç) yoluna işaret eder.
Aşağıdaki örnek bir test.txt dosyasını kullanıcı documents dizininin AIR Test alt dizininden aynı dizindeki copy.txt
adlı dosyaya taşır:
var original:File = File.documentsDirectory.resolvePath("AIR Test/test.txt");
var newFile:File = File.resolvePath("AIR Test/copy.txt");
original.copyTo(newFile, true);
Bu örnekte copyTo() yönteminin overwrite parametresinin (ikinci parametre) değeri true olarak ayarlıdır. Bu
değeri true olarak ayarlayarak var olan bir hedef dosyanın üzerine yazılır. Bu parametre isteğe bağlıdır. Bu değeri
false (varsayılan değer) olarak ayarlarsanız, hedef dosya mevcutsa işlem bir IOErrorEvent olayı gönderir (ve dosya
kopyalanmaz).
copy ve move yöntemlerinin “Senkronize olmayan” sürümleri senkronize olmayan bir şekilde çalışır. Aşağıdaki kodda
olduğu gibi, görev veya hata durumlarının tamamlanmasını izlemek için addEventListener() yöntemini kullanın:
var original = File.documentsDirectory;
original = original.resolvePath("AIR Test/test.txt");
var destination:File = File.documentsDirectory;
destination = destination.resolvePath("AIR Test 2/copy.txt");
original.addEventListener(Event.COMPLETE, fileMoveCompleteHandler);
original.addEventListener(IOErrorEvent.IO_ERROR, fileMoveIOErrorEventHandler);
original.moveToAsync(destination);
function fileMoveCompleteHandler(event:Event):void {
trace(event.target); // [object File]
}
function fileMoveIOErrorEventHandler(event:IOErrorEvent):void {
trace("I/O Error.");
}
File sınıfı ayrıca File.moveToTrash() ve File.moveToTrashAsync() yöntemlerini de içerir, bu yöntemler bir
dosyayı veya dizini sistem çöp kutusuna taşır.
Bir dosyayı silme
File sınıfı bir deleteFile() ve bir deleteFileAsync() yöntemi içerir. İlki senkronize, ikincisi senkronize olmayan
bir şekilde çalışan bu yöntemler dosyaları siler (bkz. “AIR dosyası temel bilgileri” sayfa 97).
Örneğin aşağıdaki kod kullanıcının documents dizinindeki test.txt dosyasını senkronize olarak siler:
var file:File = File.documentsDirectory.resolvePath("test.txt");
file.deleteFile();
Aşağıdaki kod kullanıcının documents dizininin test.txt dosyasını senkronize olmayan bir şekilde siler:
file.addEventListener(Event.COMPLETE, completeHandler)
file.deleteFileAsync();
trace("Deleted.")
}
Ayrıca, bir dosyayı veya dizini Sistem çöp kutusuna taşımak için kullanabileceğiniz moveToTrash() ve
moveToTrashAsync() yöntemleri de bulunmaktadır. Ayrıntılar için bkz. “Bir dosyayı çöp kutusuna taşıma” sayfa 110.
Bir dosyayı çöp kutusuna taşıma
File sınıfı bir moveToTrash() ve bir moveToTrashAsync() yöntemi içerir. Bu yöntemler bir dosyayı veya dizini Sistem
çöp kutusuna gönderir, ilki senkronize, ikincisi senkronize olmayan bir şekilde çalışır (bkz. “AIR dosyası temel
bilgileri” sayfa 97).
Örneğin aşağıdaki kod kullanıcının documents dizinindeki test.txt dosyasını senkronize olarak Sistem çöp kutusuna
gönderir:
file.moveToTrash();
Geçici bir dosya oluşturma
File sınıfı, aşağıdaki örnekte olduğu gibi Sistem için geçici bir dizin klasöründe bir dosya oluşturan
createTempFile() yöntemini içerir.
var temp:File = File.createTempFile();
createTempFile() yöntemi otomatik olarak benzersiz bir geçici dosya oluşturur (yeni bir benzersiz konum
belirlemekle uğraşmamış olursunuz).
Geçici bir dosyayı, bir uygulama oturumu için kullanılan bilgileri geçici olarak saklamak için kullanabilirsiniz. Ayrıca
Sistem geçici dizininde benzersiz geçici bir dizin oluşturmak için createTempDirectory() yönteminin
bulunduğunu unutmayın.
Otomatik olarak silinmediği için, uygulamayı kapamadan önce geçici dosyayı silmek isteyebilirsiniz.
Dosyaları okuma ve dosyalara yazma
FileStream sınıfı sayesinde AIR uygulamaları dosya sistemine okuyabilir ve yazabilir.
Dosyaları okuma ve dosyalara yazma için iş akışı
Dosyaları okuma ve dosyalara yazma için iş akışı şu şekildedir.
Yola işaret eden bir File nesnesini başlatın.
Bu, birlikte çalışmak istediğiniz dosyanın (veya daha sonra oluşturacağınız dosyanın) yoludur.
var file:File = File.documentsDirectory;
file = file.resolvePath("AIR Test/testFile.txt");
Bu örnek File nesnesini başlatmak için File nesnesinin File.documentsDirectory özelliğini ve resolvePath()
yöntemini kullanır. Ancak bir File nesnesini bir dosyaya işaret etmenin başka birçok yolu vardır. Daha fazla bilgi için
bkz. “File nesnesini bir dosyaya işaret etme” sayfa 101.
Bir FileStream nesnesini başlatın.
FileStream nesnesinin open() veya openAsync() yöntemini çağırın.
Çağırdığınız yöntem, dosyayı senkronize işlemler için mi, senkronize olmayan işlemler için mi açmak istediğinize
bağlı olarak değişir. File nesnesini open yönteminin file parametresi olarak kullanın. fileMode parametresi için,
FileMode sınıfından dosyayı kullanma şeklinizi belirten bir sabit belirtin.
Örneğin aşağıdaki kod bir dosya oluşturmak ve var olan verilerin üzerine yazmak için kullanılan bir FileStream nesnesi
başlatır:
var fileStream:FileStream = new FileStream();
fileStream.open(file, FileMode.WRITE);
Daha fazla bilgi için bkz. “Bir FileStream nesnesi başlatma ve dosyaları açma ve kapama” sayfa 113 ve “FileStream açma
modları” sayfa 112.
Dosyayı senkronize olmayan bir şekilde açtıysanız (openAsync() yöntemini kullanarak), FileStream nesnesi için
olay dinleyicileri oluşturun ve ekleyin.
Bu olay dinleyicisi yöntemleri FileStream nesnesi tarafından, verilerin dosyadan okunması, G/Ç hatalarıyla
karşılaşılması veya yazılacak verilerin tamamının yazılması gibi çeşitli durumlarda gönderilen olaylara yanıt verir.
Ayrıntılar için bkz. “Senkronize olmayan bir şekilde açılan FileStream nesnesi tarafından oluşturulan olaylar ve
senkronize olmayan programlama” sayfa 117.
Verileri okuma ve yazma için kodu gerektiği şekilde dahil etme
FileStream sınıfının okuma ve yazmayla ilgili birçok yöntemi vardır. (Her biri "read" veya "write" ifadesiyle başlar.)
Veri okumak veya yazmak için kullanmayı seçtiğiniz yöntem, hedef dosyadaki verilerin formatına bağlıdır.
Örneğin hedef dosyadaki veriler UTF kodlu metinse, readUTFBytes() ve writeUTFBytes() yöntemlerini
kullanabilirsiniz. Verileri bayt dizileri olarak işlemek istiyorsanız, readByte(), readBytes(), writeByte() ve
writeBytes() yöntemlerini kullanabilirsiniz. Ayrıntılar için bkz. “Veri formatları ve kullanılacak okuma ve yazma
yöntemlerini seçme” sayfa 117.
Dosyayı senkronize olmayan bir şekilde açtıysanız, bir read yöntemini çağırmadan önce yeterli verinin kullanılabilir
olduğundan emin olun. Ayrıntılar için bkz. “FileStream nesnesinin okuma arabelleği ve bytesAvailable özelliği”
sayfa 115.
Bir dosyaya yazmadan önce kullanılabilir disk alanını kontrol etmek istiyorsanız, File nesnesinin spaceAvailable
özelliğini kontrol edebilirsiniz. Daha fazla bilgi için bkz. “Bir birimdeki kullanılabilir alanı belirleme” sayfa 105.
Dosyayla çalışmanız bittiğinde FileStream nesnesinin close() yöntemini çağırın.
Böylece dosya diğer uygulamalar tarafından kullanılabilir hale gelir.
Ayrıntılar için bkz. “Bir FileStream nesnesi başlatma ve dosyaları açma ve kapama” sayfa 113.
Dosyaları okumak ve yazmak için FileStream sınıfı kullanan örnek bir uygulama görmek için, Adobe AIR Geliştirici
Merkezi'ndeki şu makalelere bakın:
• Metin dosyası düzenleyicisi oluşturma
FileStream nesneleriyle çalışma
FileStream sınıfı dosyaları açmak, okumak ve yazmak için yöntemler tanımlar.
FileStream açma modları
FileStream nesnesinin open() ve openAsync() yöntemlerinin her biri bir fileMode parametresi içerir, bu parametre
bir dosya akışı için, aşağıdakiler de dahil olmak üzere bazı özellikler tanımlar:
• Dosyadan okuma özelliği
• Dosyaya yazma özelliği
• Verilerin her zaman dosyanın sonuna eklenip eklenmeyeceği (yazarken)
• Dosya yoksa ne yapılacağı (üst dizinleri de olmadığında)
Aşağıda çeşitli dosya modları verilmiştir (open() ve openAsync() yöntemlerinin fileMode parametresi olarak
belirtebileceğiniz):
Dosya modu
Açıklama
FileMode.READ
Dosyanın yalnızca okuma için açık olduğunu belirtir.
FileMode.WRITE
Dosyanın yalnızca yazma için açık olduğunu belirtir. Dosya yoksa, FileStream nesnesi açıldığında oluşturulur. Dosya
varsa, var olan tüm veriler silinir.
FileMode.APPEND
Dosyanın yalnızca ekleme için açık olduğunu belirtir. Dosya yoksa oluşturulur. Dosya varsa, var olan verilerin üzerine
yazılmaz ve tüm yazma işlemleri dosyanın sonundan başlar.
FileMode.UPDATE
Dosyanın yalnızca okuma ve yazma için açık olduğunu belirtir. Dosya yoksa oluşturulur. Dosyaya rastgele
okuma/yazma erişimi için bu modu belirtin. Dosyadaki herhangi bir konumdan okuma işlemi gerçekleştirebilirsiniz
ve dosyaya yazarken, yalnızca yazılan baytlar var olan baytların üzerine yazar (diğer baytlar değişmeden kalır).
Bir FileStream nesnesi başlatma ve dosyaları açma ve kapama
Bir FileStream nesnesini açtığınızda, nesneyi bir dosyaya veri okumak ve yazmak için kullanılabilir hale getirirsiniz.
FileStream nesnesini, FileStream nesnesinin open() veya openAsync() yöntemine File nesnesini ileterek açarsınız:
var myFile:File = File.documentsDirectory.resolvePath("AIR Test/test.txt");
var myFileStream:FileStream = new FileStream();
myFileStream.open(myFile, FileMode.READ);
fileMode parametresi (open() ve openAsync() yöntemlerinin ikinci parametresi), dosyanın açılacağı modu belirtir:
okuma, yazma, ekleme veya güncelleme için. Ayrıntılar için önceki bölümlerden “FileStream açma modları” sayfa 112
bölümüne bakın.
openAsync() yöntemini dosyayı senkronize olmayan dosya işlemleri için açmak üzere kullanırsanız, senkronize
olmayan olayları işlemek için olay dinleyicileri ayarlayın:
myFileStream.addEventListener(Event.COMPLETE, completeHandler);
myFileStream.addEventListener(ProgressEvent.PROGRESS, progressHandler);
myFileStream.addEventListener(IOErrorEvent.IOError, errorHandler);
// ...
}
function progressHandler(event:ProgressEvent):void {
// ...
}
function errorHandler(event:IOErrorEvent):void {
// ...
}
Dosya, open() veya openAsync() yöntemlerinden hangisini kullandığınıza bağlı olarak senkronize veya senkronize
olmayan işlemler için açılır. Ayrıntılar için bkz. “AIR dosyası temel bilgileri” sayfa 97.
fileMode parametresini FileStream nesnesinin open yönteminde FileMode.READ veya FileMode.UPDATE olarak
ayarlarsanız, siz FileStream nesnesini açar açmaz veriler okuma arabelleğine okunur. Ayrıntılar için bkz. “FileStream
nesnesinin okuma arabelleği ve bytesAvailable özelliği” sayfa 115.
İlişkilendirilen dosyayı kapatmak için FileStream nesnesinin close() yöntemini çağırabilirsiniz, böylece dosyayı
diğer uygulamalar tarafından kullanılabilir hale getirirsiniz.
FileStream nesnesinin position özelliği
FileStream nesnesinin position özelliği, sonraki read veya write yönteminde verilerin nereye okunduğunu veya
yazıldığını belirler.
Bir okuma veya yazma işleminden önce, position özelliğini dosyada geçerli bir konuma ayarlayın.
Örneğin aşağıdaki kod "hello" dizesini (UTF kodlamada) dosyada konum 8'de yazar:
myFileStream.open(myFile, FileMode.UPDATE);
myFileStream.position = 8;
myFileStream.writeUTFBytes("hello");
Bir FileStream nesnesini ilk açtığınızda, position özelliği 0'a ayarlıdır.
Bir okuma işleminden önce position değeri en az 0 ve dosyadaki bayt sayısından (dosyadaki var olan konumlar) az
olmalıdır.
position özelliğinin değeri yalnızca aşağıdaki durumlarda değiştirilir:
•
position özelliğini açık olarak ayarladığınızda.
• Bir read yöntemini çağırdığınızda.
• Bir write yöntemini çağırdığınızda.
FileStream nesnesinin read veya write yöntemini çağırdığınızda, position özelliği hemen okuduğunuz veya
yazdığınız bayt sayısı kadar artırılır. Kullandığınız read yöntemine bağlı olarak, position özelliği okumak için
belirttiğiniz bayt sayısı kadar veya kullanılabilir bayt sayısı kadar artırılır. Bir read veya write yöntemini sonradan
çağırdığınızda, yeni konumdan başlayarak okur veya yazar.
myFileStream.open(myFile, FileMode.UPDATE);
trace(myFileStream.position); // 4000
myFileStream.writeBytes(myByteArray, 0, 200);
Ancak bir istisna söz konusudur: Ekleme modunda açılmış bir FileStream için, write yöntemine yapılan bir çağrıdan
sonra position özelliği değişmez. (Ekleme modunda veriler, position özelliğinin değerinden bağımsız olarak her
zaman dosyanın sonuna yazılır.)
Senkronize olmayan işlemler için açılan bir dosyada, kodun bir sonraki satırı çalıştırılmadan yazma işlemi
tamamlanmaz. Ancak birden çok senkronize olmayan yöntemi sıralı olarak çağırabilirsiniz ve çalışma zamanı onları
sırayla çalıştırır:
myFileStream.openAsync(myFile, FileMode.WRITE);
myFileStream.writeUTFBytes("hello");
myFileStream.writeUTFBytes("world");
myFileStream.addEventListener(Event.CLOSE, closeHandler);
myFileStream.close();
trace("started.");
closeHandler(event:Event):void
{
trace("finished.");
}
Bu kod için izleme çıktısı şöyledir:
started.
finished.
position değerini bir read veya write yöntemini çağırdıktan hemen sonra (veya istediğiniz zaman) belirtebilirsiniz,
böylece bir sonraki okuma veya yazma işlemi o konumdan başlar. Örneğin, aşağıdaki kod position özelliğini
writeBytes() işlemine bir çağrı yapıldıktan hemen sonra ayarlar ve yazma işlemi tamamlandıktan sonra bile
position o değere ayarlanır (300):
myFileStream.openAsync(myFile, FileMode.UPDATE);
myFileStream.writeBytes(myByteArray, 0, 200);
FileStream nesnesinin okuma arabelleği ve bytesAvailable özelliği
Okuma özelliklerine sahip bir FileStream nesnesi (open() veya openAsync() yönteminin fileMode parametresinin
READ veya UPDATE olarak ayarlı olduğu) açıldığında çalışma zamanı, verileri dahili bir arabellekte saklar. FileStream
nesnesi, siz dosyayı açar açmaz (FileStream nesnesinin open() veya openAsync() yöntemini çağırarak) verileri
arabelleğe okumaya başlar.
Aşağıdaki kodda gösterildiği gibi (dosyanın en az 100 bayttan oluştuğunu varsayar), senkronize işlemler için açılan bir
dosyada (open() yöntemi kullanılarak), position işaretçisini herhangi bir geçerli konuma ayarlayabilirsiniz
(dosyanın sınırları içinde) ve herhangi bir miktardaki veriyi okumaya başlayabilirsiniz (dosyanın sınırları içinde):
myFileStream.readBytes(myByteArray, 0, 20);
myFileStream.readBytes(myByteArray, 0, 10);
Read yöntemleri, bir dosyanın senkronize veya senkronize olmayan işlemler için açıldığına bakılmaksızın, okuma
işlemini her zaman bytesAvalable özelliği tarafından temsil edilen "kullanılabilir" baytlardan gerçekleştirir.
Senkronize olarak okurken, dosyadaki tüm baytlar her zaman kullanılabilirdir. Senkronize olmayan bir şekilde okuma
yaparken, progress olayları tarafından bildirilen senkronize olmayan arabellek dolumları dizisinde, baytlar,
position özelliği tarafından belirtilen konumdan başlayarak kullanılabilir olur.
Senkronize işlemler için açılan dosyalarda, bytesAvailable özelliği her zaman position özelliğinden dosyanın
sonuna kadar olan bayt sayısını temsil edecek şekilde ayarlıdır (dosyadaki tüm baytlar her zaman okunabilir).
Senkronize olmayan işlemler için açılan dosyalarda, okuma arabelleğinin bir read yöntemini çağırmadan önce yeterli
veri tüketmiş olduğundan emin olmanız gerekir. Senkronize olmayan bir şekilde açılmış bir dosyada, okuma işlemi
ilerledikçe, dosyadaki veriler okuma işlemi başlatıldığında belirtilen position öğesinden başlayarak arabelleğe eklenir
ve okunan her baytla bytesAvailable özelliği artar. bytesAvailable özelliği, position özelliği tarafından belirtilen
konumdaki baytla başlayarak arabelleğin sonuna kadar kullanılabilir olan baytların sayısını gösterir. FileStream
nesnesi düzenli aralıklarla bir progress olayı gönderir.
Senkronize olmayan bir şekilde açılan dosyada, veriler okuma arabelleğinde kullanılabilir oldukça, FileStream nesnesi
düzenli aralıklarla progress olayını gönderir. Örneğin aşağıdaki kod, arabelleğe okundukça verileri bytes adlı bir
ByteArray nesnesine okur:
var bytes:ByteArray = new ByteArray();
myFileStream.openAsync(myFile, FileMode.READ);
function progressHandler(event:ProgressEvent):void
{
myFileStream.readBytes(bytes, myFileStream.position, myFileStream.bytesAvailable);
}
Senkronize olmayan bir şekilde açılan dosyada, yalnızca okuma arabelleğindeki veriler okunabilir. Ayrıca siz verileri
okudukça, veriler okuma arabelleğinden kaldırılır. Okuma işlemleri için, okuma işlemini çağırmadan önce verilerin
okuma arabelleğinde bulunduğundan emin olmanız gerekir. Örneğin aşağıdaki kod, dosyada konum 4000'den
başlayarak 8000 bayt veri okur:
myFileStream.addEventListener(Event.COMPLETE, completed);
var str:String = "";
function progressHandler(event:Event):void
{
if (myFileStream.bytesAvailable > 8000 )
{
str += myFileStream.readMultiByte(8000, "iso-8859-1");
}
}
FileStream nesnesi bir yazma işlemi boyunca verileri okuma arabelleğine okumaz. Bir yazma işlemi tamamlandığında
(yazma arabelleğindeki tüm veriler dosyaya yazılır), FileStream nesnesi yeni bir okuma arabelleğine başlar
(ilişkilendirilen FileStream nesnesinin okuma özellikleriyle açıldığı varsayılarak) ve position özelliği tarafından
belirtilen konumdan başlayarak okuma arabelleğine veri okumaya başlar. position özelliği yazılan son baytın
konumu veya kullanıcı yazma işleminden sonra position nesnesi için farklı bir değer belirtirse farklı bir konum
olabilir.
Senkronize olmayan bir şekilde açılan FileStream nesnesi tarafından oluşturulan olaylar ve
senkronize olmayan programlama
Bir dosya senkronize olmayan bir şekilde açıldığında (openAsync() yöntemi kullanılarak), dosyaları okuma ve yazma
işlemi senkronize olmayan bir şekilde gerçekleştirilir. Veriler okuma arabelleğine okunduğu ve çıktı verileri yazıldığı
için, diğer ActionScript kodu çalıştırılabilir.
Bu, FileStream nesnesi tarafından oluşturulan senkronize olmayan bir şekilde açılan olaylar için kaydolmanız gerektiği
anlamına gelir.
Aşağıdaki kodda olduğu gibi, progress olayı için kaydolduğunuzda yeni veriler okuma işlemi için kullanılabilir
olduğunda size bilgi verilebilir:
function progressHandler(event:ProgressEvent):void
{
str += myFileStream.readMultiByte(myFileStream.bytesAvailable, "iso-8859-1");
}
Aşağıdaki kodda olduğu gibi complete olayı için kaydolarak tüm verileri okuyabilirsiniz:
function completeHandler(event:Event):void
{
str = myFileStream.readMultiByte(myFileStream.bytesAvailable, "iso-8859-1");
}
Senkronize olmayan okuma işleminin gerçekleşmesi için giriş verilerinin arabelleğe alınma şekline oldukça benzer bir
şekilde, senkronize olmayan bir akışa yazdığınız veriler arabelleğe alınır ve dosyaya senkronize olmayan bir şekilde
yazılır. Veriler bir dosyaya yazıldıkça, FileStream nesnesi düzenli aralıklarla bir OutputProgressEvent nesnesi
gönderir. OutputProgressEvent nesnesi, yazılmak için kalan bayt sayısına ayarlı bir bytesPending özelliği içerir.
Belki de bir ilerleme iletişim kutusu görüntülemek için bu arabellek gerçekten bir dosyaya yazıldığı için,
outputProgress olayı için bilgi almak üzere kaydolabilirsiniz. Ancak genelde bunu yapmanıza gerek yoktur.
Özellikle, yazılmamış baytları dikkate almadan close() yöntemini çağırabilirsiniz. FileStream nesnesi veri yazmaya
devam eder ve son bayt dosyaya yazıldıktan ve alttaki dosya kapatıldıktan sonra close olayı iletilir.
Veri formatları ve kullanılacak okuma ve yazma yöntemlerini seçme
Her dosya diskteki bir bayt kümesidir. ActionScript'te bir dosyadan gelen veriler her zaman bir ByteArray olarak
temsil edilebilir. Örneğin aşağıdaki kod verileri bir dosyadan bytes adlı bir ByteArray nesnesine okur:
myFileStream.addEventListener(Event.COMPLETE, completeHandler);
{
myFileStream.readBytes(bytes, 0, myFileStream.bytesAvailable);
}
Benzer şekilde aşağıdaki kod verileri bytes adlı bir ByteArray nesnesinden bir dosyaya yazar:
myFileStream.open(myFile, FileMode.WRITE);
myFileStream.writeBytes(bytes, 0, bytes.length);
Ancak genellikle verileri bir ActionScript ByteArray nesnesinde saklamak istemezsiniz. Genellikle veri dosyası
belirtilen dosya formatındadır.
Örneğin dosyadaki veriler metin dosyası formatında olabilir ve bu tür verileri bir String nesnesinde temsil etmek
isteyebilirsiniz.
Bu nedenle FileStream sınıfı, ByteArray nesnelerinin dışındaki türlere ve türlerden yapılacak veri okuma ve yazma
işlemleri için read ve write yöntemleri içerir. Örneğin readMultiByte() yöntemi sayesinde, aşağıdaki kodda olduğu
gibi verileri bir dosyadan okuyup bir dizede saklayabilirsiniz:
{
str = myFileStream.readMultiByte(myFileStream.bytesAvailable, "iso-8859-1");
}
readMultiByte() yönteminin ikinci parametresi, ActionScript'in verileri yorumlamak için kullandığı metin
formatını belirtir (örnekte "iso-8859-1"). ActionScript ortak karakter kümesi kodlamalarını destekler ve bunlar
ActionScript 3.0 Dil Başvurusu bölümünde listelenmiştir (bkz.
http://livedocs.macromedia.com/flex/2/langref/charset-codes.html adresinde Supported character setsupported
character sets (Desteklenen Karakter Setleri)).
FileStream sınıfı ayrıca readUTFBytes() yöntemini de içerir, bu yöntem UTF-8 karakter kümesini kullanarak okuma
arabelleğinden verileri bir dizeye okur. UTF-8 karakter kümesindeki karakterler çeşitli uzunluklarda olduğu için,
readUTFBytes() öğesini progress olayına yanıt veren bir yöntemde kullanmayın, okuma arabelleğinin sonundaki
veriler eksik bir karakteri temsil edebilir. (Bu ayrıca readMultiByte() yöntemini çeşitli uzunluklardaki karakter
kodlamasıyla kullanırken de geçerlidir.) Bu nedenle FileStream nesnesi complete olayını gönderdiğinde veri
kümesinin tamamını okuyun.
Ayrıca String nesneleriyle ve metin dosyalarıyla çalışmak için, writeMultiByte() ve writeUTFBytes() gibi benzer
write yöntemleri de vardır.
readUTF() ve writeUTF() yöntemleri de (readUTFBytes() ve writeUTFBytes() yöntemleriyle karıştırılmamalıdır)
metin verilerini bir dosyaya okur ve yazar, ancak onlar metin verilerinden önce, metin verilerinin uzunluğunu belirten
verilerin geldiğini varsayar, bu da standart metin dosyaları için yaygın bir uygulama değildir.
Bazı UTF kodlu metin dosyaları "UTF-BOM" (bayt sırası işareti) karakteriyle başlar, bu karakter kodlama formatının
yanı sıra endian olduğunu belirtir ( UTF-16 veya UTF-32 gibi).
Bir dosyaya okuma ve yazma örneği için bkz. “Örnek: Bir XML dosyasını XML nesnesine okuma” sayfa 119.
readObject() ve writeObject(), karmaşık ActionScript nesneleri için veri saklamak ve almak için pratik yollardır.
Veriler AMF'de kodlanmıştır (ActionScript Message Format). Bu format ActionScript'e aittir. AIR, Flash Player, Flash
Media Server ve Flex Data Services dışındaki uygulamalarda, bu formattaki verilerle çalışmayı sağlayacak dahili API'ler
bulunmamaktadır.
Başka read ve write yöntemleri (readDouble() ve writeDouble() gibi) vardır. Ancak bunları kullanırsanız, dosya
formatının bu yöntemler tarafından tanımlanan verilerin formatlarıyla eşleştiğinden emin olun.
Dosya formatları genellikle basit metin formatlarından daha karmaşıktır. Örneğin bir MP3 dosyası, yalnızca belirli
MP3 dosyalarına özgü olan açma ve kod çözme algoritmalarıyla yorumlanabilen sıkıştırılmış veriler içerir. MP3
dosyaları ayrıca dosya hakkında meta etiket bilgileri içeren ID3 etiketleri içerebilir (şarkının ve sanatçının adı gibi).
ID3 formatının birden çok sürümü vardır, ancak bunlardan en basiti (ID3 sürüm 1) “Örnek: Rastgele erişimle veri
okuma ve yazma” sayfa 120 bölümünde anlatılmaktadır.
Diğer dosya formatları (görüntüler, veri tabanları, uygulama belgeleri, vb.) farklı yapılara sahiptir ve ActionScript'te
onların verileriyle çalışmak için, verilerin nasıl yapılandırıldığını anlamanız gerekir.
Örnek: Bir XML dosyasını XML nesnesine okuma
Aşağıdaki örnekler, XML verileri içeren bir metin dosyasına okuma ve yazma işlemlerinin nasıl yapılacağını gösterir.
Dosyadan okumak için, File ve FileStream nesnelerini başlatın, FileStream nesnesinin readUTFBytes() yöntemini
çağırın ve dizeyi bir XML nesnesine dönüştürün:
var file:File = File.documentsDirectory.resolvePath("AIR Test/preferences.xml");
fileStream.open(file, FileMode.READ);
var prefsXML:XML = XML(fileStream.readUTFBytes(fileStream.bytesAvailable));
fileStream.close();
Benzer şekilde dosyaya veri yazmak da, uygun File ve FileStream nesnelerini ayarlayıp FileStream nesnesinin write
yöntemini çağırmak kadar kolaydır. XML verilerinin dize sürümünü write yöntemine aşağıdaki kodda olduğu gibi
iletin:
var prefsXML:XML = <prefs><autoSave>true</autoSave></prefs>;
fileStream = new FileStream();
var outputString:String = '<?xml version="1.0" encoding="utf-8"?>\n';
outputString += prefsXML.toXMLString();
fileStream.writeUTFBytes(outputString);
fileStream.close();
Bu örnekler readUTFBytes() ve writeUTFBytes() yöntemlerini kullanır, çünkü dosyaların UTF-8 formatında
olduğunu varsayar. Değilse, farklı bir yöntem kullanmanız gerekebilir (bkz. “Veri formatları ve kullanılacak okuma ve
yazma yöntemlerini seçme” sayfa 117).
Önceki örnekler senkronize işlem için açılmış FileStream nesnelerini kullanır. Senkronize olmayan işlemler (olaylara
yanıt vermek için olay dinleyicisi işlevlerine dayanan) için de dosyalar açabilirsiniz. Örneğin aşağıdaki kod, bir XML
dosyasının senkronize olmayan şekilde nasıl okunacağını gösterir:
fileStream.addEventListener(Event.COMPLETE, processXMLData);
fileStream.openAsync(file, FileMode.READ);
var prefsXML:XML;
function processXMLData(event:Event):void
{
prefsXML = XML(fileStream.readUTFBytes(fileStream.bytesAvailable));
fileStream.close();
}
processXMLData() yöntemi, dosyanın tamamı okuma arabelleğine okunduğu zaman çağrılır (FileStream nesnesi
complete olayını gönderdiğinde). Okunan verilerin dize sürümünü alması için readUTFBytes() yöntemini çağırır
ve o dizeye dayalı olarak prefsXML adlı bir XML nesnesi oluşturur.
Örnek: Rastgele erişimle veri okuma ve yazma
MP3 dosyaları, kaydı tanımlayan meta verileri içeren dosyanın başındaki veya sonundaki bölümler olan ID3
etiketlerini içerebilir. ID3 etiket formatının farklı sürümleri vardır. Bu örnek, en basit ID3 formatını içeren (ID3 sürüm
1.0) MP3 dosyasından, dosyadaki rastgele konumlara okuma ve yazma işleminin gerçekleştirildiği anlamına gelen
"dosya verilerine rastgele erişim" kullanılarak nasıl veri okunacağını ve yazılacağını gösterir.
ID3 sürüm 1 etiketini içeren bir MP3 dosyası, ID3 verilerini dosyanın sonunda, son 128 baytta içerir.
Bir dosyaya rastgele okuma/yazma erişimi için erişirken, open() veya openAsync() yönteminin fileMode
parametresi olarak FileMode.UPDATE öğesini belirtmek gerekir:
var file:File = File.documentsDirectory.resolvePath("My Music/Sample ID3 v1.mp3");
var fileStr:FileStream = new FileStream();
fileStr.open(file, FileMode.UPDATE);
Böylece dosyaya hem okur hem de yazarsınız.
Dosyayı açtıktan sonra, position işaretçisini, dosyanın sonundan 128 bayt önce konumuna getirebilirsiniz:
fileStr.position = file.size - 128;
Bu kod position özelliğini dosyada bu konuma ayarlar, çünkü ID3 v1.0 formatı, ID3 etiket verilerinin dosyanın son
128 baytında saklandığını belirtir. Bu belirtim ayrıca şunu da gösterir:
• Etiketin ilk 3 baytı "TAG" dizesini içerir.
• Sonraki 30 karakter, bir dize olarak MP3 parçasının başlığını içerir.
• Sonraki 30 karakter, bir dize olarak sanatçının adını içerir.
• Sonraki 30 karakter, bir dize olarak albümün adını içerir.
• Sonraki 4 karakter, bir dize olarak yılı içerir.
• Sonraki 30 karakter, bir dize olarak yorumu içerir.
• Sonraki bayt, parçanın türünü belirten bir kod içerir.
• Tüm metin verileri ISO 8859-1 formatındadır.
id3TagRead() yöntemi, okunduktan sonra verileri kontrol eder (complete olayından sonra):
function id3TagRead():void
{
if (fileStr.readMultiByte(3, "iso-8859-1").match(/tag/i))
{
var id3Title:String = fileStr.readMultiByte(30, "iso-8859-1");
var id3Artist:String = fileStr.readMultiByte(30, "iso-8859-1");
var id3Album:String = fileStr.readMultiByte(30, "iso-8859-1");
var id3Year:String = fileStr.readMultiByte(4, "iso-8859-1");
var id3Comment:String = fileStr.readMultiByte(30, "iso-8859-1");
var id3GenreCode:String = fileStr.readByte().toString(10);
}
}
Ayrıca dosyada rastgele erişimli yazma işlemi de gerçekleştirebilirsiniz. Örneğin id3Title değişkenini baş harfinin
doğru şekilde büyütüldüğünden emin olmak için ayrıştırabilirsiniz (String sınıfının yöntemlerini kullanarak) ve
ardından aşağıdaki gibi, dosyaya newTitle adlı değiştirilmiş bir dize yazabilirsiniz:
fileStr.position = file.length - 125;
// 128 - 3
fileStr.writeMultiByte(newTitle, "iso-8859-1");
ID3 sürüm 1 standardına uymak için, newTitle dizesinin uzunluğu, sonunda karakter kodu 0 ile tamponlu 30
karakter olmalıdır (String.fromCharCode(0)).
122
Bölüm 15: Sürükle ve bırak
Kullanıcı arabirimi sürükle ve bırak hareketlerini desteklemek için, sürükle ve bırak API'sindeki sınıfları kullanın. Bu
anlamda hareket kullanıcı tarafından gerçekleştirilen, hem işletim sistemi hem de uygulamanız tarafından aracı
olunan, bilgi kopyalamak, taşımak veya link vermek için bir amaç ifade eden bir eylemdir. Dışarı sürükleme hareketi,
kullanıcı bir nesneyi bileşenin veya uygulamanın dışına sürüklediğinde oluşur. Dışarı sürükleme hareketi, kullanıcı bir
nesneyi bileşenin veya uygulamanın dışından içeri sürüklediğinde oluşur.
Sürükle ve bırak API'siyle kullanıcının uygulamalar arasında ve bir uygulama içerisindeki bileşenler arasında veri
sürüklemesini sağlayabilirsiniz. Desteklenen aktarım formatları şunlardır:
• Bitmapler
• Dosyalar
• HTML formatlı metin
• Metin
• Zengin Metin Formatlı veriler
• URL'ler
• Serileştirilmiş nesneler
• Nesne başvuruları (yalnızca kaynak uygulama içinde geçerli)
Sürükleme ve bırakma hakkında ek çevrimiçi bilgiler
Sürükle ve bırak API'siyle çalışma hakkında daha fazla bilgi için şu kaynaklardan yararlanabilirsiniz:
• Sürükle ve bırak ve kopyala ve yapıştır işlemlerini destekleme
Dil Başvurusu
• NativeDragManager
• NativeDragOptions
• Clipboard
• NativeDragEvent
• Flash için Adobe AIR Geliştirici Bağlantısı ('AIR sürükleme ve bırakma'yı arayın)
Sürükleme ve bırakma temel bilgileri
Sürükle ve bırak API'si aşağıdaki sınıfları içerir.
Sürükle ve bırak
Paket
Sınıflar
flash.desktop
•
NativeDragManager
•
NativeDragOptions
•
Clipboard
•
NativeDragActions
•
ClipboardFormat
•
ClipboardTransferModes
Sürükle ve bırak API'siyle kullanılan sabitler aşağıdaki sınıflarda tanımlanır:
flash.events
•
NativeDragActions
•
ClipboardFormat
•
ClipboardTransferModes
NativeDragEvent
Sürükle ve bırak hareket sahneleri
Sürükle ve bırak hareketinin üç sahnesi vardır:
Başlatma Kullanıcı, fare düğmesini basılı tutarak bir bileşeni veya bileşendeki öğeyi sürükleyerek sürükle ve bırak
işlemini başlatır. Sürüklenen öğenin kaynağı olan bileşen genellikle sürükleme başlatıcısı olarak belirlenir ve
nativeDragStart ve nativeDragComplete olaylarını gönderir. Adobe® AIR™ uygulaması, mouseDown veya
mouseMove olayına yanıt olarak NativeDragManager.doDrag() yöntemini çağırarak bir sürükleme işlemi başlatır.
Sürükleme Fare düğmesini basılı tutarken kullanıcı fare imlecini başka bir bileşene, uygulamaya veya masaüstüne taşır.
AIR isteğe bağlı olarak sürükleme sırasında bir proxy görüntüsü görüntüler. Sürükleme işlemi devam ederken,
başlatıcı nesne nativeDragUpdate olaylarını gönderir. Kullanıcı fareyi AIR uygulamasındaki olası bir bırakma
hedefinin üzerine taşıdığında, bırakma hedefi bir nativeDragEnter olayı gönderir. Olay işleyicisi, sürüklenen
verilerin hedef tarafından kabul edilecek bir formatta mevcut olup olmadığını belirlemek için olay nesnesini
denetleyebilir, mevcutsa NativeDragManager.acceptDragDrop() yöntemini çağırarak kullanıcının verileri
bırakmasını sağlar.
Sürükleme hareketi etkileşimli bir nesnenin üzerinde kaldığı sürece, bu nesne nativeDragOver olaylarını gönderir.
Sürükleme hareketi etkileşimli nesneyi bıraktığında, bir nativeDragExit olayı gönderir.
Bırakma Kullanıcı fare düğmesini uygun bir bırakma hedefinin üzerinde serbest bırakır.Hedef bir AIR uygulaması veya
bileşeniyse, bileşen bir nativeDragDrop olayı gönderir. Olay işleyicisi olay nesnesinden aktarılan verilere erişebilir.
Hedef, AIR'in dışındaysa, bırakma işlemini işletim sistemi veya başka bir uygulama yapar. Her iki durumda da,
başlatan nesne bir nativeDragComplete olayı gönderir (sürükleme AIR'in içinden başlatıldıysa).
NativeDragManager sınıfı hem içeri hem de dışarı sürükleme hareketlerini kontrol eder. NativeDragManager sınıfının
tüm üyeleri statiktir, bu sınıfın bir örneğini oluşturmayın.
Clipboard nesnesi
Bir uygulamanın veya bileşenin içine ya da dışına sürüklenen veriler bir Clipboard nesnesinde bulunmaktadır. Tek bir
Clipboard nesnesi, başka bir uygulamanın verileri anlayıp kullanabilmesi olasılığını arttırmak için aynı bilgilerin farklı
temsillerini kullanılabilir hale getirebilir. Örneğin bir görüntü, görüntü verisi, serileştirilmiş Bitmap nesnesi veya bir
dosya olarak dahil edilebilir. Bir formatta veri oluşturma işlemi, veriler okunana kadar çağrılmayan bir oluşturma
işlevine ertelenebilir.
Sürükle ve bırak
Bir sürükleme hareketi başladıktan sonra Clipboard nesnesine yalnızca nativeDragEnter, nativeDragOver ve
nativeDragDrop olayları için olay işleyicisinin içinden erişilebilir. Sürükleme hareketi bittikten sonra Clipboard
nesnesi okunamaz veya yeniden kullanılamaz.
Bir uygulama nesnesi başvuru olarak ve serileştirilmiş bir nesne olarak aktarılabilir. Başvurular yalnızca kaynak
uygulama içinde geçerlidir. Serileştirilmiş nesne aktarımları AIR uygulamaları arasında geçerlidir, ancak yalnızca
serileştirildiğinde ve serileştirmesi kaldırıldığında geçerliliği devam eden nesnelerle kullanılabilir. Serileştirilen
nesneler dize tabanlı veri aktarım formatı olan ActionScript 3 (AMF3) için Action Message Format'e dönüştürülür.
Flex çerçevesiyle çalışma
Çoğu durumda, Flex uygulamaları oluştururken Adobe® Flex™ sürükle ve bırak API'sini kullanmak daha yararlıdır.
AIR'de bir Flex uygulaması çalıştırıldığında (AIR NativeDragManager öğesini dahili şekilde kullanır), Flex çerçevesi
eşdeğer bir özellik kümesi sağlar. Flex ayrıca, bir uygulama veya bileşen daha kısıtlayıcı bir tarayıcı ortamında
çalışırken, daha sınırlı bir özellik setini korur. AIR sınıfları, AIR çalışma zamanı ortamının dışında çalışan bileşenlerde
veya uygulamalarda kullanılamaz.
Dışarı sürükleme hareketini destekleme
Dışarı sürükleme hareketini desteklemek için, mouseDown olayına yanıt olarak bir Clipboard nesnesi oluşturmalı ve
NativeDragManager.doDrag() yöntemine göndermelisiniz. Ardından uygulamanız, kullanıcı hareketi
tamamladığında veya iptal ettiğinde ne yapacağını belirlemek için başlatan nesnedeki nativeDragComplete olayını
dinleyebilir.
Verileri aktarım için hazırlama
Verileri veya bir nesneyi sürüklemeye hazırlamak için, bir Clipboard nesnesi oluşturun ve bir veya birden fazla
formatta aktarılacak bilgileri ekleyin. Otomatik olarak yerel pano formatlarına çevrilebilecek verileri iletmek için
standart veri formatlarını ve nesneleri iletmek için uygulama tanımlı formatları kullanabilirsiniz. Belirli bir formata
aktarılacak bilgileri dönüştürmek hesaplama yönünden pahalıysa, dönüştürmeyi gerçekleştirmesi için bir işleyici
işlevinin adını verebilirsiniz. Yalnızca alıcı bileşen veya uygulama ilişkilendirilen formatı okursa işlev çağrılır. Daha
fazla bilgi için bkz. “Pano veri formatları” sayfa 143.
Aşağıdaki örnek birçok formatta bitmap içeren bir Clipboard nesnesinin nasıl oluşturulacağını gösterir: bir Bitmap
nesnesi, bir yerel bitmap formatı ve bitmapin ilk yüklendiği dosyayı içeren bir dosya listesi formatı:
import flash.desktop.Clipboard;
import flash.display.Bitmap;
import flash.filesystem.File;
public function createClipboard(image:Bitmap, sourceFile:File):Clipboard{
var transfer:Clipboard = new Clipboard();
transfer.setData("CUSTOM_BITMAP", image, true); //Flash object by value and by reference
transfer.setData(ClipboardFormats.BITMAP_FORMAT, image.bitmapData, false);
transfer.setData(ClipboardFormats.FILE_LIST_FORMAT, new Array(sourceFile), false);
return transfer;
}
Dışarı sürükleme işlemi başlatma
Bir sürükleme işlemi başlatmak için, mouse down olayına yanıt olarak NativeDragManager.doDrag() yöntemini
çağırın. doDrag() yöntemi, aşağıdaki parametreleri alan statik bir yöntemdir:
Sürükle ve bırak
Parametre
Açıklama
initiator
Sürükleme işleminin kaynaklandığı ve dragStart ve dragComplete olaylarını gönderen nesne. Başlatıcı
etkileşimli bir nesne olmalıdır.
clipboard
Aktarılacak verileri içeren Clipboard nesnesi. Clipboard nesnesine, sürükleme ve bırakma sırası boyunca
gönderilen NativeDragEvent nesnelerinde başvurulur.
dragImage
(İsteğe bağlı) Sürükleme sırasında görüntülenecek bir BitmapData nesnesi. Görüntü bir alpha değeri
belirtebilir. (Not: Microsoft Windows görüntüleri sürüklemek için her zaman sabit alfa soldurma uygular).
offset
(İsteğe bağlı) Sürükleme görüntüsünün fare etkin noktasından uzaklığını belirten Point nesnesi. Sürükleme
görüntüsünü fare imlecine göre yukarı ve sola taşımak için negatif koordinatlar kullanın. Uzaklık
sağlanmamışsa, sürükleme görüntüsünün sol üst köşesi farenin etkin noktasında konumlandırılmıştır.
actionsAllowed
(İsteğe bağlı) Sürükleme işlemi için hangi eylemlerin (kopyala, taşı veya bağla) geçerli olduğunu belirten bir
NativeDragOptions nesnesi. Hiç argüman sağlanmamışsa, tüm eylemlere izin verilir. Olası bir sürükleme
hedefinin izin verilen eylemlerin hedef bileşenin amacına uygun olup olmadığını kontrol etmesini sağlamak
için NativeDragEvent nesnelerinde DragOptions nesnesine başvurulur. Örneğin “trash” bileşeni yalnızca
taşıma eylemine izin veren sürükleme hareketlerini kabul edebilir.
Aşağıdaki örnek bir dosyadan yüklenen bitmap nesnesi için sürükleme işleminin nasıl başlatılacağını anlatır. Örnek,
bir görüntü yükler ve bir mouseDown olayında sürükleme işlemini başlatır.
package
{
import flash.desktop.NativeDragManager;
import mx.core.UIComponent;
import flash.display.Loader;
import flash.system.LoaderContext;
import flash.geom.Point;
import flash.display.Bitmap;
public class DragOutExample extends UIComponent Sprite {
protected var fileURL:String = "app:/image.jpg";
protected var display:Bitmap;
private function init():void {
loadImage();
}
private function onMouseDown(event:MouseEvent):void {
var bitmapFile:File = new File(fileURL);
var transferObject:Clipboard = createClipboard(display, bitmapFile);
NativeDragManager.doDrag(this,
transferObject,
display.bitmapData,
new Point(-mouseX,-mouseY));
}
public function createClipboard(image:Bitmap, sourceFile:File):Clipboard {
transfer.setData("bitmap",
image,
true);
Sürükle ve bırak
// ActionScript 3 Bitmap object by value and by reference
transfer.setData(ClipboardFormats.BITMAP_FORMAT,
image.bitmapData,
false);
// Standard BitmapData format
transfer.setData(ClipboardFormats.FILE_LIST_FORMAT,
new Array(sourceFile),
false);
// Standard file list format
return transfer;
}
private function loadImage():void {
var url:URLRequest = new URLRequest(fileURL);
loader.load(url,new LoaderContext());
loader.contentLoaderInfo.addEventListener(Event.COMPLETE, onLoadComplete);
}
private function onLoadComplete(event:Event):void {
display = event.target.loader.content;
var flexWrapper:UIComponent = new UIComponent();
flexWrapper.addChild(event.target.loader.content);
addChild(flexWrapper);
flexWrapper.addEventListener(MouseEvent.MOUSE_DOWN, onMouseDown);
}
}
}
Dışarı sürükleme aktarımını tamamlama
Kullanıcı sürüklenen öğeyi fare düğmesini serbest bırakarak bıraktığında, başlatıcı nesne bir nativeDragComplete
olayı gönderir. Olay nesnesinin dropAction özelliğini kontrol edip uygun eylemi gerçekleştirebilirsiniz. Örneğin
eylem NativeDragAction.MOVE, olduğunda, kaynak öğeyi orijinal konumundan kaldırabilirsiniz. Kullanıcı, imleç
uygun bir bırakma hedefinin dışındayken, fare düğmesini serbest bırakarak sürükleme hareketini iptal edebilir.
Sürükleme yöneticisi iptal edilmiş bir hareket için dropAction özelliğini NativeDragAction.NONE olarak ayarlar.
İçeri sürükleme hareketini destekleme
İçeri sürükleme hareketini desteklemek için, uygulamanız (genelde uygulamanızın görsel bir bileşeni)
nativeDragEnter veya nativeDragOver olaylarına yanıt vermelidir.
Genel bir bırakma işleminin adımları
Bırakma işlemi için tipik olay sırası aşağıdaki gibidir:
1 Kullanıcı clipboard nesnesini bir bileşenin üzerine sürükler.
2 Bileşen bir nativeDragEnter olayı gönderir.
3 nativeDragEnter olay işleyici, kullanılabilir veri formatlarını ve izin verilen eylemleri kontrol etmek için olay
nesnesini inceler. Bileşen bırakmayı işleyebilirse, NativeDragManager.acceptDragDrop() öğesini çağırır.
4 NativeDragManager fare imlecini, nesnenin bırakıldığını gösterecek şekilde değiştirir.
5 Kullanıcı nesneyi bileşenin üzerine bırakır.
Sürükle ve bırak
6 Alıcı bileşen bir nativeDragDrop olayı gönderir.
7 Alıcı bileşen, istenen formattaki verileri olay nesnesinin içindeki Clipboard nesnesinden okur.
8 Sürükleme hareketi bir AIR uygulamasının içinden kaynaklandıysa, başlatan etkileşimli nesne bir
nativeDragComplete olayı gönderir. Hareket AIR uygulamasının dışından kaynaklandıysa, geribildirim
gönderilmez.
Bir içeri sürükleme hareketini onaylama
Kullanıcı bir pano öğesini görsel bir bileşenin sınırlarının içine sürüklediğinde, bileşen nativeDragEnter ve
nativeDragOver olaylarını gönderir. Bileşenin pano öğesini kabul edip edemeyeceğini belirlemek için, bu olayların
işleyicileri, olay nesnesinin clipboard ve allowedActions özelliklerini kontrol edebilir. Olay işleyici, bileşenin
bırakma işlemini kabul edebileceğini bildirmek için alıcı bileşene bir başvuru ileterek
NativeDragManager.acceptDragDrop() yöntemini çağırmalıdır. Birden fazla kayıtlı olay dinleyicisi
acceptDragDrop() yöntemini çağırırsa, listedeki son işleyici önceliğe sahiptir. Fare kabul eden nesnenin
sınırlarından çıkıp nativeDragExit olayını tetikleyene kadar, acceptDragDrop() çağrısı geçerliliğini korur.
doDrag() öğesine iletilen allowedActions parametresinde birden fazla eyleme izin veriliyorsa, kullanıcı bir
değiştirici tuşunu basılı tutarak izin verilen eylemlerden hangilerini gerçekleştirmeyi düşündüğünü belirtebilir.
Sürükleme yöneticisi, kullanıcıya, bırakma işlemini tamamlasaydı hangi eylemin gerçekleşeceğini göstermek üzere
imleç görüntüsünü değiştirir. İstenen eylem, NativeDragEvent nesnesinin dropAction özelliği tarafından bildirilir.
Sürükleme hareketi için eylem kümesi yalnızca tavsiye amaçlıdır. Aktarımda yer alan bileşenlerin uygun davranışı
uygulaması gereklidir. Örneğin bir taşıma eylemini tamamlamak için, sürükleme başlatıcısı sürüklenen öğeyi
sürükleyebilir ve bırakma hedefi bunu ekleyebilir.
Sürükleme hedefiniz NativeDragManager sınıfının dropAction özelliğini ayarlayarak, sürükleme eylemini üç olası
eylemden biriyle sınırlayabilir. Kullanıcı klavyeyi kullanarak farklı bir eylem seçmeyi denerse, NativeDragManager
unavailable imleci görüntüler. Hem nativeDragEnter hem de nativeDragOver olayları için, işleyicilerdeki
dropAction özelliğini ayarlayın.
Aşağıdaki örnek, bir nativeDragEnter veya nativeDragOver olayı için olay işleyicisini gösterir. Sürüklenen pano
metin formatlı veriler içeriyorsa, bu işleyici yalnızca içeri sürükleme hareketini kabul eder.
import flash.desktop.NativeDragManager;
import flash.events.NativeDragEvent;
public function onDragIn(event:NativeDragEvent):void{
NativeDragManager.dropAction = NativeDragActions.MOVE;
if(event.clipboard.hasFormat(ClipboardFormats.TEXT_FORMAT)){
NativeDragManager.acceptDragDrop(this); //'this' is the receiving component
}
}
Bırakmayı tamamlama
Kullanıcı sürüklenen öğeyi hareketi kabul eden etkileşimli bir nesnenin üzerine bıraktığında, etkileşimli nesne bir
nativeDragDrop olayı gönderir. Bu olayın işleyicisi verileri olay nesnesinin clipboard özelliğinden ayıklayabilir.
Pano uygulama tanımlı bir format içerdiğinde, Clipboard nesnesinin getData() yöntemine iletilen transferMode
parametresi sürükleme yöneticisinin bir başvuruyu mu, yoksa nesnenin serileştirilmiş bir sürümünü mü
döndürdüğünü belirler.
Aşağıdaki örnek nativeDragDrop olayı için bir olay işleyicisini gösterir:
Sürükle ve bırak
import flash.events.NativeDragEvent;
public function onDrop(event:NativeDragEvent):void {
if (event.clipboard.hasFormat(ClipboardFormats.TEXT_FORMAT)) {
var text:String =
String(event.clipboard.getData(ClipboardFormats.TEXT_FORMAT,
ClipboardTransferMode.ORIGINAL_PREFERRED));
}
Olay işleyicisinden çıkıldıktan sonra, Clipboard nesnesi geçerliliğini kaybeder. Nesneye veya verilerine erişme girişimi,
hata oluşmasına neden olur.
Bir bileşenin görünümünü güncelleme
Bir bileşen görünümünü NativeDragEvent olaylarına dayalı olarak güncelleyebilir. Aşağıdaki tablo tipik bir bileşenin
farklı olaylara yanıt olarak yapacağı değişiklikleri açıklar:
Olay
Açıklama
nativeDragStart
Başlatan etkileşimli nesne nativeDragStart olayını, sürükleme hareketinin bu etkileşimli nesneden
kaynaklandığına dair görsel geribildirim sağlamak için kullanabilir.
nativeDragUpdate
Başlatan etkileşimli nesne, nativeDragUpdate olayını, hareket sırasında durumunu güncellemek için
kullanabilir.
nativeDragEnter
Olası alıcı etkileşimli nesne bu olayı odağı kendine çekmek veya bırakma işlemini kabul edip edemeyeceğini
görsel olarak belirtmek için kullanabilir.
nativeDragOver
Olası alıcı etkileşimli nesne bu olayı, farenin sokak haritası görüntüsü gibi karmaşık bir bileşenin "sıcak"
bölgesine girmesi gibi farenin etkileşimli nesne içerisindeki hareketine yanıt vermek için kullanabilir.
nativeDragExit
Olası alıcı etkileşimli nesne bu olayı, bir sürükleme hareketi sınırlarının dışına taşındığında durumunu geri
yüklemek için kullanabilir.
nativeDragComplete
Alıcı etkileşimli nesne bu olayı, listeden bir öğeyi kaldırmak gibi ilişkilendirilen veri modelini güncellemek veya
görsel durumunu geri yüklemek için kullanabilir.
İçeri sürükleme hareketi sırasında fare konumunu izleme
Sürükleme hareketi bir bileşenin üzerinde kaldığında, bu bileşen nativeDragOver olaylarını gönderir. Bu olaylar her
birkaç milisaniyede bir ve farenin her hareketinde gönderilir. nativeDragOver olay nesnesi, farenin bileşen
üzerindeki konumunu belirlemek için kullanılabilir. Fare konumuna erişimi olmak, alıcı bileşenin karmaşık olduğu,
ancak alt bileşenlerden oluşmadığı durumlarda yararlı olabilir. Örneğin, uygulamanız bir sokak haritası içeren bir
bitmap görüntülediyse ve kullanıcı içlerine bilgi sürüklediğinde haritadaki bölgelerin vurgulanmasını istediyseniz,
harita içinde fare konumunu izlemek için nativeDragOver olayında bildirilen fare koordinatlarını kullanabilirsiniz.
HTML Sürükle ve bırak
HTML tabanlı bir uygulamaya veya uygulamadan (veya bir HTMLLoader öğesinde görüntülenen HTML'e veya
HTML'den) veri sürüklemek için, HTML drag ve drop olaylarını kullanabilirsiniz. HTML sürükle ve bırak API'si
sayesinde HTML içeriğindeki DOM öğelerine ve bu öğelerden veri sürükleyebilirsiniz.
Sürükle ve bırak
Not: Ayrıca, HTML içeriğine sahip HTMLLoader nesnesindeki olayları dinleyerek de AIR NativeDragEvent ve
NativeDragManager API'lerini kullanabilirsiniz. Ancak HTML API'si HTML DOM ile daha başarılı bir şekilde
entegredir ve size, varsayılan davranışın kontrolünü sağlar.
Varsayılan sürükle ve bırak davranışı
HTML ortamı metin, görüntüler ve URL'leri de içeren sürükle ve bırak hareketleri için varsayılan davranış sağlar.
Varsayılan davranışı kullanarak her zaman bu tür verileri bir öğenin dışına sürükleyebilirsiniz. Ancak, bir öğeye
yalnızca metin sürükleyebilirsiniz ve yalnızca sayfanın düzenlenebilir bir bölgesinde bulunan öğelere
sürükleyebilirsiniz. Bir sayfanın düzenlenebilir bölgeleri arasında veya içinde metni sürüklediğinizde, varsayılan
davranış bir taşıma eylemi gerçekleştirir. Düzenlenemeyen bir bölgeden veya uygulamanın dışından düzenlenebilir
bölgeye metin sürüklediğinizde, varsayılan davranış bir kopyalama eylemi gerçekleştirir.
drag-and-drop olaylarını kendiniz işleyerek varsayılan davranışı geçersiz kılabilirsiniz. Varsayılan davranışı iptal
etmek için, drag-and-drop olayları için gönderilen nesnelerin preventDefault() yöntemlerini çağırmalısınız.
Seçilen eylemi gerçekleştirmek için gerekli olduğundan, verileri bırakma hedefine ekleyebilir ve sürükleme
kaynağından kaldırabilirsiniz.
Varsayılan olarak kullanıcı istediği metni seçip sürükleyebilir ve görüntüleri ve linkleri sürükleyebilir. -webkit-userselect WebKit CSS özelliğini, bir HTML öğesinin nasıl seçilebileceğini kontrol etmek için kullanabilirsiniz. Örneğin
-webkit-user-select öğesini none olarak ayarlarsanız, öğe içerikleri seçilebilir olmaz ve sürüklenemez. -webkituser-drag CSS özelliğini, bir öğenin bütün olarak sürüklenip sürüklenemeyeceğini kontrol etmek için de
kullanabilirsiniz. Ancak öğenin içerikleri ayrı öğeler olarak kabul edilir. Kullanıcı hala metnin seçili bir kısmını
sürükleyebilir. Daha fazla bilgi için bkz. “CSS Uzantıları” sayfa 204.
HTML'de sürükleme ve bırakma olayları
Bir sürükleme işleminin kaynaklandığı başlatıcı öğe tarafından gönderilen olaylar şunlardır:
Olay
Açıklama
dragstart
Kullanıcı sürükleme hareketini başlattığında gönderilir. Bu olayın işleyicisi gerekirse olay nesnesinin
preventDefault() yöntemini çağırarak sürüklemeyi engelleyebilir. Sürüklenen verilerin kopyalanabildiğini,
verilere link verilebildiğini veya taşınabildiğini kontrol etmek için, effectAllowed özelliğini ayarlayın. Seçilen
metin, görüntüler ve bağlantılar varsayılan davranış tarafından panoya konur, ancak olay nesnesinin
dataTransfer özelliğini kullanarak sürükleme hareketi için farklı veriler ayarlayabilirsiniz.
drag
Sürükleme hareketi boyunca kesintisiz gönderilir.
dragend
Kullanıcı sürükleme hareketini bitirmek için fare düğmesini serbest bıraktığında gönderilir.
Sürükleme hedefi tarafından gönderilen olaylar şunlardır:
Olay
Açıklama
dragover
Sürükleme hareketi öğenin sınırları içerisinde kaldığı sürece kesintisiz gönderilir. Bu olayın işleyicisi
dataTransfer.dropEffect özelliğini, kullanıcı fare düğmesini serbest bırakırsa bırakmanın kopyalama, taşıma
veya link verme eylemlerinden hangisiyle sonuçlanacağını göstermek için ayarlamalıdır.
Sürükle ve bırak
Olay
dragenter
Açıklama
Sürükleme hareketi öğenin sınırlarına girdiğinde gönderilir.
Bir dragenter olay işleyicisindeki dataTransfer nesnesinin herhangi bir özelliğini değiştirirseniz, bu
değişiklikler bir sonraki dragover olayı tarafından hızla geçersiz kılınır. Diğer yandan, bir dragenter ve ilk
dragover olayı arasında, farklı özellikler ayarlanmışsa imlecin yanıp sönmesine neden olabilecek kısa bir
gecikme yaşanır. Birçok durumda, her iki olay için de aynı olay işleyicisini kullanabilirsiniz.
dragleave
Sürükleme hareketi öğenin sınırlarından çıktığında gönderilir.
drop
Kullanıcı verileri öğeye bıraktığında gönderilir. Sürüklenen verilere yalnızca bu olayın işleyicisinde erişilebilir.
Bu olaylara yanıt olarak gönderilen olay nesnesi, mouse olayına benzerdir. (clientX, clientY) ve (screenX,
screenY) gibi mouse olayı özelliklerini, fare konumunu belirlemek için kullanabilirsiniz.
Bir drag olayı nesnesinin en önemli özelliği, sürüklenen verileri içeren dataTransfer öğesidir. dataTransfer nesnesi
aşağıdaki özelliklere ve yöntemlere sahiptir:
Açıklama
effectAllowed
Sürüklemenin kaynağı tarafından izin verilen efekt. Genellikle dragstart olayının işleyicisi bu değeri ayarlar. Bkz.
“HTML'de sürükleme efektleri” sayfa 131.
dropEffect
Hedef veya kullanıcı tarafından seçilen efekt. dragover veya dragenter olay işleyicisinde dropEffect
öğesini ayarlarsanız, AIR, fare imlecini, kullanıcı fare düğmesini serbest bıraktığında oluşacak efekti gösterecek
şekilde günceller. dropEffect kümesi izin verilen efektlerden biriyle eşleşmezse, bırakmaya izin verilmez ve
unavailable imleci görüntülenir. En son dragover veya dragenter olayına yanıt olarak bir dropEffect
ayarlamadıysanız, kullanıcı standart işletim sistemi değiştirici tuşlarını kullanarak izin verilen efektler arasından
seçim yapabilir.
Son efekt, dragend için gönderilen nesnenin dropEffect özelliği tarafından bildirilir. Kullanıcı fare
düğmesini uygun hedefin dışında serbest bırakarak bırakma işlemini iptal ederse, dropEffectnone olarak
ayarlanır.
türler
dataTransfer nesnesinde mevcut olan her veri formatı için MIME türü dizeleri içeren bir dizi.
getData(mimeType)
mimeType parametresi tarafından belirtilen formattaki verileri alır.
getData() yöntemi yalnızca drop olayına yanıt olarak çağrılabilir.
setData(mimeType)
dataTransfer öğesine mimeType parametresi tarafından belirtilen formattaki verileri ekler. Her MIME türü
için setData() öğesini çağırarak birden çok formatta veri ekleyebilirsiniz. Varsayılan sürükleme davranışı
tarafından dataTransfer nesnesine yerleştirilen tüm veriler temizlenir.
setData() yöntemi yalnızca dragstart olayına yanıt olarak çağrılabilir.
clearData(mimeType)
mimeType parametresi tarafından belirtilen formattaki tüm verileri temizler.
setDragImage(image,
offsetX, offsetY)
Özel bir sürükleme görüntüsü ayarlar. setDragImage() yöntemi yalnızca dragstart olayına yanıt olarak
çağrılabilir.
HTML sürükle ve bırak için MIME türleri
Bir HTML drag-and-drop olayının dataTransfer nesnesiyle kullanılacak MIME türleri şunlardır:
Veri formatı
MIME türü
Metin
"text/plain"
HTML
"text/html"
Sürükle ve bırak
Veri formatı
MIME türü
URL
"text/uri-list"
Bitmap
"image/x-vnd.adobe.air.bitmap"
Dosya listesi
"application/x-vnd.adobe.air.file-list"
Uygulama tanımlı dizeler de dahil olmak üzere diğer MIME dizelerini de kullanabilirsiniz. Ancak diğer uygulamalar
aktarılan verileri tanımayabilir veya kullanmayabilir. dataTransfer nesnesine beklenen formatta veriler eklemek
sizin sorumluluğunuzdadır.
Önemli: Yalnızca uygulama sanal alanında kod çalıştırma, bırakılan dosyalara erişebilir. Uygulama dışı sanal alanda
bir File nesnesinin herhangi bir özelliğini okuma veya ayarlama girişiminde bulunmak bir güvenlik hatasına neden olur.
Daha fazla bilgi için bkz. “Uygulama dışı HTML sanal alanlarındaki dosya bırakmaları işleme” sayfa 135.
HTML'de sürükleme efektleri
Sürükleme hareketinin başlatıcısı, dragstart olayının işleyicisindeki dataTransfer.effectAllowed özelliğini
ayarlayarak izin verilen sürükleme efektlerini sınırlandırabilir. Aşağıdaki dize değerleri kullanılabilir:
Dize değeri
Açıklama
"none"
Hiçbir sürükleme hareketine izin verilmez.
"copy"
Orijinali yerinde kalarak veriler hedefe kopyalanır.
"link"
Orijinaline giden bir link kullanılarak veriler bırakma hedefiyle paylaşılır.
"move”
Veriler hedefe kopyalanır ve orijinal konumundan kaldırılır.
"copyLink"
Veriler kopyalanabilir veya verilere link verilebilir.
"copyMove"
Veriler kopyalanabilir veya taşınabilir.
"linkMove"
Verilere link verilebilir veya veriler taşınabilir.
"all"
Veriler kopyalanabilir, taşınabilir veya verilere link verilebilir. All (Tümü), varsayılan davranışı engellediğinizde
kullanılan varsayılan efekttir.
Sürükleme hareketinin hedefi, kullanıcı bırakmayı tamamlarsa gerçekleştirilen eylemi göstermek için
dataTransfer.dropEffect özelliğini ayarlayabilir. Bırakma efekti izin verilen efektlerden biriyse, sistem uygun
kopyala, taşı veya link ver imlecini görüntüler. Değilse, sistem unavailable imlecini görüntüler. Hedef tarafından
bırakma efekti ayarlanmamışsa, kullanıcı değiştirici tuşlarını kullanarak izin verilen eylemler arasından seçim
yapılabilir.
Hem dragover hem de dragenter olaylarının işleyicilerindeki dropEffect değerini ayarlayın:
function doDragStart(event) {
event.dataTransfer.setData("text/plain","Text to drag");
event.dataTransfer.effectAllowed = "copyMove";
}
function doDragOver(event) {
event.dataTransfer.dropEffect = "copy";
}
function doDragEnter(event) {
event.dataTransfer.dropEffect = "copy";
}
Sürükle ve bırak
Not: dragenter için işleyicideki dropEffect özelliğini her zaman ayarlamanız gerekse de, sonraki dragover olayının
özelliği varsayılan değere sıfırladığını unutmayın. Her iki olaya yanıt olarak da dropEffect öğesini ayarlayın.
Bir HTML öğesinden veri sürüklemek
Varsayılan davranış, bir HTML sayfasındaki içeriğin çoğunun sürüklenerek kopyalanmasına izin verir.
Sürüklenmesine izin verilen içeriği, -webkit-user-select ve -webkit-user-drag CSS özelliklerini kullanarak
kontrol edebilirsiniz.
dragstart olayı için işleyicideki varsayılan dışarı sürükleme davranışını geçersiz kılın. Sürükleme hareketine kendi
verilerinizi koymak için, olay nesnesinin dataTransfer özelliğinin setData() yöntemini çağırın.
Varsayılan davranışa bağlı olmadığınızda bir source nesnesinin hangi sürükleme efektlerini desteklediğini belirtmek
için, dragstart olayı için gönderilen olay nesnesinin dataTransfer.effectAllowed özelliğini ayarlayın.
İstediğiniz efekt kombinasyonunu seçebilirsiniz. Örneğin bir kaynak öğesi hem kopyalama hem de link verme
efektlerini destekliyorsa, özelliği "copyLink" olarak ayarlayın.
Sürüklenen verileri ayarlama
dataTransfer özelliğini kullanarak sürükleme hareketi için verileri dragstart olayının işleyicisine ekleyin. Panoya
veri koymak için, aktarılacak MIME türünü ve verileri ileterek dataTransfer.setData() yöntemini kullanın.
Örneğin uygulamanızda imageOfGeorge kimliğine sahip bir görüntü öğesi varsa, aşağıdaki dragstart olay işleyicisini
kullanabilirsiniz. Bu örnek George'un bir resminin birçok veri formatındaki temsillerini ekler, bu da diğer
uygulamaların sürüklenen verileri kullanabilme olasılığını artırır.
function dragStartHandler(event){
event.dataTransfer.effectAllowed = "copy";
var dragImage = document.getElementById("imageOfGeorge");
var dragFile = new air.File(dragImage.src);
event.dataTransfer.setData("text/plain","A picture of George");
event.dataTransfer.setData("image/x-vnd.adobe.air.bitmap", dragImage);
event.dataTransfer.setData("application/x-vnd.adobe.air.file-list",
new Array(dragFile));
}
Not: dataTransfer nesnesinin setData() yöntemini çağırdığınızda, varsayılan sürükle ve bırak davranışı tarafından
hiç veri eklenmez.
Bir HTML öğesine veri sürükleme
Varsayılan davranış metnin yalnızca sayfanın düzenlenebilir bölgelerine sürüklenmesine izin verir. Öğenin açılış
etiketine contenteditable niteliği eklenerek bir öğenin ve alt öğelerinin düzenlenebilir hale getirilebileceğini
belirtebilirsiniz. Ayrıca, belge nesnesi designMode özelliğini "on" yaparak bir belgenin tamamını düzenlenebilir hale
getirebilirsiniz.
Sürüklenen verileri kabul edebilen herhangi bir öğe için dragenter, dragover ve drop olaylarını işleyerek, bir sayfada
alternatif içeri sürükleme davranışını destekleyebilirsiniz.
İçeri sürüklemeyi etkinleştirme
İçeri sürükleme hareketini işlemek için, öncelikle varsayılan davranışı iptal etmeniz gerekir. Bırakma hedefleri olarak
kullanmak istediğiniz herhangi bir HTML öğesindeki dragenter ve dragover olaylarını dinleyin. Bu olayların
işleyicilerinde, gönderilen olay nesnesinin preventDefault() yöntemini çağırın. Varsayılan davranışın iptal edilmesi
sayesinde, düzenlenemeyen bölgeler de bırakma işlemi alabilir.
Sürükle ve bırak
Bırakılan verileri alma
ondrop olayı için işleyicideki bırakılan verilere erişebilirsiniz:
function doDrop(event){
droppedText = event.dataTransfer.getData("text/plain");
}
Panoya verileri okumak için, okunacak veri formatının MIME türünü ileterek dataTransfer.getData() yöntemini
kullanın. Hangi veri formatlarının kullanılabilir olduğunu, dataTransfer nesnesinin types özelliğini kullanarak
bulabilirsiniz. types dizisi, kullanılabilir her formatın MIME türü dizesini içerir.
dragenter veya dragover olaylarında varsayılan davranışı iptal etiğinizde, bırakılan tüm verileri belgede uygun yere
koymaktan siz sorumlu olursunuz. Bir fare konumunu bir öğenin içindeki ekleme noktasına dönüştürebilecek API
mevcut değildir. Bu sınırlama, ekleme türü sürükleme hareketlerinin uygulanmasını zorlaştırabilir.
Örnek: Varsayılan HTML içeri sürükleme davranışını geçersiz kılma
Bu örnek, bırakılan öğede mevcut olan her veri formatını gösteren bir tablo görüntüleyen bir bırakma hedefi uygular.
Varsayılan davranış metnin, linklerin ve görüntülerin uygulama içerisinde sürüklenmesini sağlamak için kullanılır.
Örnek, bırakma hedefi olarak işlev gören div öğesi için varsayılan içeri sürükleme davranışını geçersiz kılar.
Düzenlenemeyen içeriğin içeri sürükleme hareketini kabul etmesini sağlamada anahtar adım, hem dragenter hem de
dragover olayları için gönderilen olay nesnesinin preventDefault() yöntemini çağırmaktır. İşleyici, drop olayına
yanıt olarak, aktarılan verileri HTML satır öğesine dönüştürür ve satırı görüntüleme için bir tabloya ekler.
<html>
<head>
<title>Drag-and-drop</title>
<script language="javascript" type="text/javascript" src="AIRAliases.js"></script>
<script language="javascript">
function init(){
var target = document.getElementById('target');
target.addEventListener("dragenter", dragEnterOverHandler);
target.addEventListener("dragover", dragEnterOverHandler);
target.addEventListener("drop", dropHandler);
var source = document.getElementById('source');
source.addEventListener("dragstart", dragStartHandler);
source.addEventListener("dragend", dragEndHandler);
emptyRow = document.getElementById("emptyTargetRow");
}
function dragStartHandler(event){
event.dataTransfer.effectAllowed = "copy";
}
function dragEndHandler(event){
air.trace(event.type + ": " + event.dataTransfer.dropEffect);
}
function dragEnterOverHandler(event){
}
var emptyRow;
Sürükle ve bırak
function dropHandler(event){
for(var prop in event){
air.trace(prop + " = " + event[prop]);
}
var row = document.createElement('tr');
row.innerHTML = "<td>" + event.dataTransfer.getData("text/plain") + "</td>" +
"<td>" + event.dataTransfer.getData("text/html") + "</td>" +
"<td>" + event.dataTransfer.getData("text/uri-list") + "</td>" +
"<td>" + event.dataTransfer.getData("application/x-vnd.adobe.air.file-list") +
"</td>";
var imageCell = document.createElement('td');
if((event.dataTransfer.types.toString()).search("image/x-vnd.adobe.air.bitmap") > 1){
imageCell.appendChild(event.dataTransfer.getData("image/xvnd.adobe.air.bitmap"));
}
row.appendChild(imageCell);
var parent = emptyRow.parentNode;
parent.insertBefore(row, emptyRow);
}
</script>
</head>
<body onLoad="init()" style="padding:5px">
<div>
<h1>Source</h1>
<p>Items to drag:</p>
<ul id="source">
<li>Plain text.</li>
<li>HTML <b>formatted</b> text.</li>
<li>A <a href="http://www.adobe.com">URL.</a></li>
<li><img src="icons/AIRApp_16.png" alt="An image"/></li>
<li style="-webkit-user-drag:none;">
Uses "-webkit-user-drag:none" style.
</li>
<li style="-webkit-user-select:none;">
Uses "-webkit-user-select:none" style.
</li>
</ul>
</div>
<div id="target" style="border-style:dashed;">
<h1 >Target</h1>
<p>Drag items from the source list (or elsewhere).</p>
<table id="displayTable" border="1">
<tr><th>Plain text</th><th>Html text</th><th>URL</th><th>File list</th><th>Bitmap
Data</th></tr>
<tr
id="emptyTargetRow"><td> </td><td> </td><td> </td><td> </td><td> </
td></tr>
</table>
</div>
</div>
</body>
</html>
Sürükle ve bırak
Uygulama dışı HTML sanal alanlarındaki dosya bırakmaları işleme
Uygulama dışı içerik, dosyalar bir AIR uygulamasına sürüklendiğinde ortaya çıkan File nesnelerine erişemez. Bu File
nesnelerinden birini sanal alan köprüsü kullanarak uygulama içeriğine göndermek de mümkün değildir. (Nesne
özelliklerine serileştirme sırasında erişilmelidir.) Ancak yine de HTMLLoader nesnesinde AIR nativeDragDrop
olaylarını dinleyerek uygulamanızdaki dosyaları bırakabilirsiniz.
Normalde bir kullanıcı uygulama dışı içerik barındıran bir çerçeveye dosya bırakırsa, drop olayı alt öğeden üst öğeye
yayılmaz. Ancak HTMLLoader (bir AIR uygulamasındaki tüm HTML içeriğinin konteyneri) tarafından gönderilen
olaylar HTML olay akışının bir parçası olmadığı için, hala uygulama içeriğindeki drop olayını alabilirsiniz.
Bir dosya bırakma için olayı almak üzere, üst belge, window.htmlLoader tarafından sağlanan başvuruyu kullanarak
HTMLLoader nesnesine bir olay dinleyicisi ekler:
window.htmlLoader.addEventListener("nativeDragDrop",function(event){
var filelist = event.clipboard.getData(air.ClipboardFormats.FILE_LIST_FORMAT);
air.trace(filelist[0].url);
});
Aşağıdaki örnek, uzak sanal alana alt sayfa yükleyen bir üst belge kullanır (http://localhost/). Üst öğe HTMLLoader
nesnesindeki nativeDragDrop olayını dinler ve dosya url'sini izler.
<html>
<head>
<title>Drag-and-drop in a remote sandbox</title>
<script language="javascript">
window.htmlLoader.addEventListener("nativeDragDrop",function(event){
var filelist = event.clipboard.getData(air.ClipboardFormats.FILE_LIST_FORMAT);
air.trace(filelist[0].url);
});
</script>
</head>
<body>
<iframe src="child.html"
sandboxRoot="http://localhost/"
documentRoot="app:/"
frameBorder="0" width="100%" height="100%">
</iframe>
</body>
</html>
Alt belge, HTML dragenter ve dragover olay işleyicilerindeki Event nesnesi preventDefault() yöntemini
engelleyerek geçerli bir bırakma hedefi sunmalıdır, yoksa drop olayı gerçekleşemez.
Sürükle ve bırak
<html>
<head>
<title>Drag and drop target</title>
function preventDefault(event){
}
</script>
</head>
<body ondragenter="preventDefault(event)" ondragover="preventDefault(event)">
<div>
<h1>Drop Files Here</h1>
</div>
</body>
</html>
Daha fazla bilgi için bkz. “HTML ve JavaScript'te programlama” sayfa 206.
137
Bölüm 16: Kopyalama ve yapıştırma
Sistem panosundan ve sistem panosuna bilgi yapıştırmak için pano API'sindeki sınıfları kullanın. Adobe® AIR™
uygulamasına veya Adobe® AIR™ uygulamasından aktarılabilecek veri formatları şunlardır:
• Bitmapler
• Dosyalar
• Metin
• HTML formatlı metin
• Zengin Metin Formatlı veriler
• URL dizeleri
• Serileştirilmiş nesneler
• Nesne başvuruları (yalnızca kaynak uygulama içinde geçerli)
Kopyalama ve yapıştırma hakkında ek çevrimiçi bilgiler
Bu kaynaklardan kopyalama ve yapıştırma hakkında daha fazla bilgi edinebilirsiniz:
• Sürükle ve bırak ve kopyala ve yapıştır işlevlerini destekleme
Dil Başvurusu
• Clipboard
• ClipboardFormats
• ClipboardTransferMode
Daha Fazla Bilgi
• Flash için Adobe AIR Geliştirici Bağlantısı ('AIR kopyalama ve yapıştırma'yı arayın)
Kopyalama ve yapıştırma temel bilgileri
Kopyala ve yapıştır API'si aşağıdaki sınıfları içerir.
Kopyalama ve yapıştırma
Paket
Sınıflar
flash.desktop
•
Clipboard
•
ClipboardFormats
•
Kopyala ve yapıştır API'siyle kullanılan sabitler aşağıdaki sınıflarda tanımlanır:
•
ClipboardFormats
•
Statik Clipboard.generalClipboard özelliği, işletim sistemi panosunu temsil eder. Clipboard sınıfı, clipboard
nesnelerinden veri okuma ve bu nesnelere veri yazmaya yönelik yöntemler sağlar. Sürükleme ve bırakma API'sini
kullanarak verileri aktarmak için yeni Clipboard nesneleri de oluşturulabilir.
HTML ortamı, kopyalama ve yapıştırma için alternatif bir API sağlar. Her iki API de uygulama sanal alanı içinde kod
çalıştırma tarafından kullanılabilir, ancak uygulama dışı içerikte yalnızca HTML API'si kullanılabilir. (Bkz. “HTML
kopyala ve yapıştır” sayfa 139.)
HTMLLoader ve TextField sınıfları, normal kopyalama ve yapıştırma klavye kısayolları için varsayılan davranışı
uygular. Özel bileşenler için kopyalama ve yapıştırma kısayolu davranışını uygulamak üzere doğrudan bu tuş
girişlerini dinleyebilirsiniz. Ayrıca tuş girişlerine dolaylı olarak yanıt vermek için, tuş eşdeğerleriyle beraber yerel
menü komutlarını da kullanabilirsiniz.
Diğer uygulamaların verileri anlama ve kullanma kapasitesini artırmak için, aynı bilgilerin farklı temsilleri tek bir
Clipboard nesnesinde kullanılabilir hale getirilebilir. Örneğin bir görüntü, görüntü verisi, serileştirilmiş Bitmap
nesnesi veya bir dosya olarak dahil edilebilir. Bir formattaki verilerin oluşturulması ertelenebilir, böylece bu formattaki
veriler okunana kadar format gerçekten oluşturulmaz.
Not: AIR uygulamasından çıkıldıktan sonra panoya yazılmış olan verilere erişileceğinin garantisi yoktur.
Sistem panosundan okuma ve sistem panosuna yazma
İşletim sistemi panosunu okumak için, okunacak formatın adını ileten Clipboard.generalClipbooard nesnesinin
getData() yöntemini çağırın:
import flash.desktop.ClipboardFormats;
if(Clipboard.generalClipboard.hasFormat(ClipboardFormats.TEXT_FORMAT)){
var text:String = Clipboard.generalClipboard.getData(ClipboardFormats.TEXT_FORMAT);
}
Panoya yazmak için, verileri Clipboard.generalClipboard nesnesine bir veya daha fazla formatta ekleyin. Aynı
formattaki verilerin otomatik olarak üzerine yazılır. Ancak, diğer formatlardaki ilişkili olmayan verilerin silindiğinden
de emin olmak için yeni veri yazmadan önce sistem panosunu temizlemek yararlı olur.
import flash.desktop.ClipboardFormats;
var textToCopy:String = "Copy to clipboard.";
Clipboard.generalClipboard.clear();
Clipboard.generalClipboard.setData(ClipboardFormats.TEXT_FORMAT, textToCopy, false);
Not: Yalnızca uygulama sanal alanındaki kod çalıştırma, sistem panosuna doğrudan erişebilir. Uygulama dışı HTML
içeriğinde panoya yalnızca HTML copy veya paste olaylarından biri tarafından gönderilen olay nesnesinin
clipboardData özelliğini kullanarak erişebilirsiniz.
HTML kopyala ve yapıştır
HTML ortamı kopyalama ve yapıştırma için kendi olay kümesini ve varsayılan davranışı sağlar. Yalnızca uygulama
sanal alanındaki kod çalıştırma, AIR Clipboard.generalClipboard nesnesini kullanarak sistem panosuna
doğrudan erişebilir. Uygulama dışı bir sanal alandaki JavaScript kodu, HTML belgesindeki bir öğe tarafından
gönderilen copy veya paste olaylarından birine yanıt olarak gönderilen olay nesnesini kullanarak panoya erişebilir.
Copy ve paste olayları şunları içerir: copy, cut ve paste. Bu olaylar için gönderilen nesne clipboardData özelliğiyle
panoya erişim sağlar.
Varsayılan Davranış
Varsayılan olarak AIR, klavye kısayolu veya bağlam menüsü tarafından oluşturulabilen kopyala komutuna yanıt
olarak seçili öğeleri kopyalar. Düzenlenebilir bölgeler içerisinde, AIR, kes komutuna yanıt olarak metni keser veya
yapıştır komutuna yanıt olarak metni imlecin bulunduğu yere veya seçime yapıştırır.
Varsayılan davranışı engellemek için, olay işleyiciniz gönderilen olay nesnesinin preventDefault() yöntemini
çağırabilir.
olay nesnesinin clipboardData özelliğini kullanma
Copy veya paste olaylarından birinin sonucu olarak gönderilen olay nesnesinin clipboardData özelliği sayesinde,
pano verilerini okuyabilir ve yazabilirsiniz.
Bir copy veya cut olayını işlerken panoya yazmak için, kopyalanacak verileri ve MIME türünü ileten clipboardData
nesnesinin setData() yöntemini kullanın:
function customCopy(event){
event.clipboardData.setData("text/plain", "A copied string.");
}
Yapıştırılan verilere erişmek için, veri formatının MIME türünü ileten clipboardData nesnesinin getData()
yöntemini kullanabilirsiniz. Kullanılabilir formatlar types özelliği tarafından bildirilir.
function customPaste(event){
var pastedData = event.clipboardData("text/plain");
}
getData() yöntemine ve types özelliğine yalnızca paste olayı tarafından gönderilen olay nesnesinde erişilebilir.
Aşağıdaki örnek bir HTML sayfasında varsayılan kopyalama ve yapıştırma davranışının nasıl geçersiz kılınacağını
gösterir. copy olay işleyicisi, kopyalanan metni italik yapar ve HTML metni olarak panoya yapıştırır. cut olay işleyicisi
seçili verileri panoya kopyalar ve belgeden kaldırır. paste işleyicisi pano içeriklerini HTML olarak ekler ve eklemeyi
kalın metin olarak biçimlendirir.
<html>
<head>
<title>Copy and Paste</title>
function onCopy(event){
var selection = window.getSelection();
event.clipboardData.setData("text/html","<i>" + selection + "</i>");
}
function onCut(event){
event.clipboardData.setData("text/html","<i>" + selection + "</i>");
var range = selection.getRangeAt(0);
range.extractContents();
}
function onPaste(event){
var insertion = document.createElement("b");
insertion.innerHTML = event.clipboardData.getData("text/html");
var range = selection.getRangeAt(0);
range.insertNode(insertion);
}
</script>
</head>
<body onCopy="onCopy(event)"
onPaste="onPaste(event)"
onCut="onCut(event)">
<p>Sed ut perspiciatis unde omnis iste natus error sit voluptatem accusantium
doloremque laudantium, totam rem aperiam, eaque ipsa quae ab illo inventore
veritatis et quasi architecto beatae vitae dicta sunt explicabo. Nemo enim ipsam
voluptatem quia voluptas sit aspernatur aut odit aut fugit, sed quia consequuntur
magni dolores eos qui ratione voluptatem sequi nesciunt.</p>
</body>
</html>
Kopyalama ve yapıştırma için menü komutları ve tuş
girişleri
Kopyalama ve yapıştırma işlevleri genellikle menü işlevleri ve klavye kısayollarıyla tetiklenir. OS X'te, kopyala ve
yapıştır komutlarına sahip bir düzenleme menüsü işletim sistemi tarafından otomatik olarak oluşturulur, ancak kendi
kopyalama ve yapıştırma işlevlerinizi eklemek için bu menü komutlarına dinleyici eklemeniz gerekir. Windows'ta,
sistem kenarlığını kullanan herhangi bir pencereye yerel bir düzenleme menüsü ekleyebilirsiniz. (Ayrıca Flex ve
ActionScript ile yerel olmayan menüler oluşturabilirsiniz veya HTML içeriğinde DHTML kullanabilirsiniz, ancak bu
konu, bu açıklamanın kapsamına girmemektedir.)
Kopyalama ve yapıştırma işlevleri genellikle menü işlevleri ve klavye kısayollarıyla tetiklenir. OS X'te, kopyala ve
yapıştır komutlarına sahip bir düzenleme menüsü işletim sistemi tarafından otomatik olarak oluşturulur, ancak kendi
kopyalama ve yapıştırma işlevlerinizi eklemek için bu menü komutlarına dinleyici eklemeniz gerekir. Windows'ta,
sistem kenarlığını kullanan herhangi bir pencereye yerel bir düzenleme menüsü ekleyebilirsiniz. (Ayrıca ActionScript
ile yerel olmayan menüler oluşturabilirsiniz veya HTML içeriğinde DHTML kullanabilirsiniz, ancak bu konu, bu
açıklamanın kapsamına girmemektedir.)
Klavye kısayollarına yanıt olarak kopyala ve yapıştır komutlarını tetiklemek için, yerel bir uygulamada veya pencere
menüsünde ilgili komut öğelerine tuş eşdeğerleri atayabilir veya doğrudan tuş girişlerini dinleyebilirsiniz.
Bir menü komutuyla kopyalama veya yapıştırma işlemi başlatma
Kopyalama veya yapıştırma işlemini bir menü komutuyla tetiklemek için, işleyici işlevlerinizi çağıran menü öğelerinde
select olayı için dinleyiciler eklemeniz gerekir.
İşleyici işleviniz çağrıldığında, sahnenin focus özelliği kullanılarak kopyalanacak veya yapıştırılacak nesneyi
bulabilirsiniz. Ardından, kopyalama, kesme veya yapıştırma mantığını yürütmek için odaklanılan nesnenin ilgili
yöntemini (veya hiçbir nesnenin odağı yoksa genel bir geri dönme yöntemini) çağırabilirsiniz. Örneğin aşağıdaki copy
olay işleyicisi, odaklanılan nesnenin doğru türde olup olmadığını, bu durumda Scrap adlı bir sınıfı kontrol eder ve daha
sonra nesnenin doCopy() yöntemini çağırır.
function copyCommand(event:Event):void{
if(NativeApplication.nativeApplication.activeWindow.stage.focus is Scrap){
Scrap(NativeApplication.nativeApplication.activeWindow.stage.focus).doCopy();
} else {
NativeApplication.nativeApplication.copy();
}
}
Örnekteki copyCommand() odaklanılan nesnenin sınıfını tanımazsa, NativeApplication copy() yöntemini çağırır.
NativeApplication copy() yöntemi odaklanılan nesneye dahili bir kopyala komutu gönderir. Dahili komut yalnızca
TextArea ve HTMLLoader nesneleri tarafından tanınır. Kesme, yapıştırma, tümünü seçme ve yalnızca TextArea için
temizleme, geri alma ve yineleme için benzer komutlar kullanılabilir.
Not: Özel bir bileşende bu dahili komutlara yanıt vermek için sağlanmış bir API yoktur. TextArea veya HTMLLoader
sınıflarını genişletmelisiniz veya bu nesnelerden birini özel bileşeninize dahil etmelisiniz. Bir TextArea veya
HTMLLoader sınıfı dahil ederseniz bileşeniniz, odağı, odak bileşenin kendisinde olduğunda TextArea veya
HTMLLoader nesnesi her zaman odağı koruyacak şekilde yönetmelidir.
HTML içeriğinde varsayılan kopyalama ve yapıştırma davranışı, NativeApplication düzenleme komutları kullanılarak
tetiklenebilir. Aşağıdaki örnek düzenlenebilir bir HTML belgesi için bir düzenleme menüsü oluşturur:
Bir önceki örnek Mac OS X'te uygulama menüsünü değiştirir, ancak var olan öğeleri bularak ve onlara olay
dinleyicileri ekleyerek de varsayılan Düzen menüsünü kullanabilirsiniz.
Kopyala veya yapıştır komutunu çağırmak için bir bağlam menüsü kullanırsanız, hangi nesnenin kopyala veya yapıştır
komutu için uygun hedef olduğunu belirlemek için menü açıldığında veya bir öğe seçildiğinde gönderilen
ContextMenuEvent nesnesinin contextMenuOwner özelliğini kullanabilirsiniz.
Mac OS X'te varsayılan menü öğelerini bulma
Mac OS X'teki uygulama menüsünde varsayılan düzen menüsünü ve belirli kopyala, kes ve yapıştır komut öğelerini
bulmak için, NativeMenuItem nesnelerinin label özelliğini kullanarak menü hiyerarşisi içinde arama yapabilirsiniz.
Örneğin aşağıdaki işlev bir adı alır ve menüde eşleşen etikete sahip öğeyi bulur.
private function findItemByName(menu:NativeMenu,
name:String,
recurse:Boolean = false):NativeMenuItem{
var searchItem:NativeMenuItem = null;
for each (var item:NativeMenuItem in menu.items){
if(item.label == name){
searchItem = item;
break;
}
if((item.submenu != null) && recurse){
searchItem = findItemByName(item.submenu, name, recurse);
}
if(searchItem != null){ break; }
}
return searchItem;
}
Aramaya alt menüleri de dahil etmek için recurse parametresini true olarak veya yalnızca iletilen menüyü dahil
etmek için false olarak ayarlayabilirsiniz.
Tuş girişiyle kopyala veya yapıştır komutu başlatma
Uygulamanız kopyalama ve yapıştırma için yerel pencere veya uygulama menüleri kullanıyorsa, klavye kısayollarını
uygulamak için menü öğelerine tuş eşdeğerleri ekleyebilirsiniz. Aksi takdirde, aşağıdaki örnekte gösterildiği gibi
kendiniz ilgili tuş girişlerini dinleyebilirsiniz.
private function init():void{
stage.addEventListener(KeyboardEvent.KEY_DOWN, keyListener);
}
private function keyListener(event:KeyboardEvent):void{
if(event.ctrlKey){
switch(String.fromCharCode(event.charCode)){
case "c":
NativeApplication.nativeApplication.copy();
break;
case "x":
NativeApplication.nativeApplication.cut();
break;
case "v":
NativeApplication.nativeApplication.paste();
break;
case "a":
NativeApplication.nativeApplication.selectAll();
break;
case "z":
NativeApplication.nativeApplication.undo();
break;
case "y":
NativeApplication.nativeApplication.redo();
break;
}
}
}
HTML içeriğinde kopyalama ve yapıştırma için klavye kısayolları varsayılan olarak uygulanır. Kopyalama ve
yapıştırma için sıklıkla kullanılan tüm tuş girişlerini, anahtar olay dinleyicisi kullanarak bindirmek mümkün değildir.
Varsayılan davranışı geçersiz kılmanız gerekiyorsa, copy ve paste olaylarının kendilerini dinlemek daha başarılı bir
strateji olur.
Pano veri formatları
Pano formatları bir Clipboard nesnesinde bulunan verileri açıklar. AIR, ActionScript veri türleri ve sistem panosu
formatları arasında standart veri formatlarını otomatik olarak çevirir. Buna ek olarak, uygulama tanımlı formatlar
kullanılarak AIR uygulamalarının içerisinde veya arasında uygulama nesneleri aktarılabilir.
Bir Clipboard nesnesi aynı bilginin farklı formatlardaki temsillerini içerebilir. Örneğin Sprite'ı temsil eden bir
Clipboard nesnesi aynı uygulama içinde kullanmak üzere bir başvuru formatı, başka bir AIR uygulaması tarafından
kullanılmak üzere bir serileştirilmiş format, bir görüntü düzenleyicisi tarafından kullanılmak üzere bir bitmap formatı
ve Sprite'ın bir temsilini dosya sistemine kopyalamak veya sürüklemek üzere, PNG dosyasını kodlamak için gecikmeli
oluşturmaya sahip olma ihtimali olan bir dosya liste formatı içerebilir.
Standart veri formatları
Standart format adlarını tanımlayan sabitler ClipboardFormats sınıfında sağlanır:
Sabit
Açıklama
TEXT_FORMAT
Text-format verileri, ActionScript String sınıfına çevrilir ve bu sınıftan geri çevrilir.
HTML_FORMAT
HTML işaretlemeli metin.
RICH_TEXT_FORMAT
Rich-text-format verileri, ActionScript ByteArray sınıfına çevrilir ve bu sınıftan geri çevrilir. RTF işaretlemesi,
herhangi bir şekilde yorumlanmaz veya çevrilmez.
BITMAP_FORMAT
Bitmap-format verileri, ActionScript BitmapData sınıfına çevrilir ve bu sınıftan geri çevrilir.
FILE_LIST_FORMAT
File-list-format verileri, ActionScript File nesneleri dizisine çevrilir ve bu diziden geri çevrilir.
URL_FORMAT
URL formatlı veriler, ActionScript String sınıfına ve bu sınıftan başka formata çevrilir.
Not: Şu anda Zengin Metin Formatlı verileri destekleyen Flash metin kontrolü veya bileşeni yoktur. RTF verilerini bir
kontrole yapıştırmak için, öncelikle RTF işaretlemesini HTML işaretlemesine (veya düz metne) çevirin. Benzer şekilde,
RTF verilerini panoya kopyalamak için, bir metni veya HTML dizesini uygun RTF işaretlemesiyle tamamlanan
ByteArray nesnesine dönüştürün. Flash, RTF verilerinin başka bir formata dönüştürülmesi için bir utility sınıfı
sağlamaz.
HTML içeriğindeki bir copy, cut veya paste olayına yanıt olarak veri kopyalayıp yapıştırırken, ClipboardFormat
dizeleri yerine MIME türleri kullanılmalıdır. Geçerli veri MIME türleri şunlardır:
MIME türü
Açıklama
Metin
"text/plain"
URL
"text/uri-list"
Bitmap
Dosya listesi
Not: Zengin metin formatlı veriler, HTML içeriğindeki paste olayının sonucu olarak gönderilen olay nesnesinin
clipboardData özelliğinden kullanılamaz.
Özel veri formatları
Nesneleri başvurular veya serileştirilmiş kopyalar olarak aktarmak için, uygulama tanımlı özel formatlar
kullanabilirsiniz. Başvurular yalnızca aynı AIR uygulaması içinde geçerlidir. Serileştirilmiş nesneler Adobe AIR
uygulamaları arasında aktarılabilir, ancak yalnızca serileştirildiğinde ve serileştirmesi kaldırıldığında geçerliliği devam
eden nesnelerle kullanılabilir. Özellikleri basit türler veya serileştirilmiş nesneler olduğunda nesneler genellikle
serileştirilebilir.
Serileştirilmiş bir nesneyi Clipboard nesnesine eklemek için, Clipboard.setData() yöntemini çağırırken
serileştirilebilen parametreyi true olarak ayarlayın. Format adı standart formatlardan biri veya uygulamanız
tarafından tanımlanan rastgele bir dize olabilir.
Aktarım modları
Bir nesne panoya özel veri formatı kullanılarak yazıldığında, nesne verileri panodan başvuru olarak veya orijinal
nesnenin serileştirilmiş kopyası olarak okunabilir. AIR, nesnelerin başvuru olarak mı serileştirilmiş kopyalar olarak mı
aktarılacağını belirleyen dört aktarım modu tanımlamaktadır:
Aktarım modu
Açıklama
ClipboardTransferModes.ORIGINAL_ONLY
Yalnızca bir başvuru döndürülür. Bir başvuru varsa, boş bir değer döndürülür.
ClipboardTransferModes.ORIGINAL_PREFFERED
Varsa bir başvuru döndürülür. Aksi takdirde serileştirilmiş bir kopya döndürülür.
ClipboardTransferModes.CLONE_ONLY
Yalnızca serileştirilmiş bir kopya döndürülür. Serileştirilmiş kopya yoksa, boş bir değer
döndürülür.
ClipboardTransferModes.CLONE_PREFFERED
Varsa serileştirilmiş bir kopya döndürülür. Aksi takdirde bir başvuru döndürülür.
Özel veri formatlarını okuma ve yazma
Panoya bir nesne yazarken format parametresi için, ayrılmış önek air: ile başlamayan herhangi bir dizeyi
kullanabilirsiniz. Nesneyi okumak için format olarak aynı dizeyi kullanın. Aşağıdaki örnek nesnelerin panoya nasıl
okunacağını ve yazılacağını gösterir:
public function createClipboardObject(object:Object):Clipboard{
transfer.setData("object", object, true);
}
Clipboard nesnesinden serileştirilmiş bir nesneyi ayıklamak için (bırakma veya yapıştırma işleminden sonra), aynı
format adını ve cloneOnly veya clonePreferred aktarım modlarını kullanın.
var transfer:Object = clipboard.getData("object", ClipboardTransferMode.CLONE_ONLY);
Başvuru her zaman Clipboard nesnesine eklenir. Clipboard nesnesinden serileştirilmiş kopya yerine başvuruyu
ayıklamak için (bırakma veya yapıştırma işleminden sonra), originalOnly veya originalPreferred aktarım
modlarını kullanın:
var transferredObject:Object =
clipboard.getData("object", ClipboardTransferMode.ORIGINAL_ONLY);
Başvurular yalnızca Clipboard nesnesi geçerli AIR uygulaması kaynaklıysa geçerlidir. Başvuru varsa başvuruya
erişmek için originalPreferred aktarım modunu, başvuru yoksa serileştirilmiş klonu kullanın.
Gecikmeli oluşturma
Bir veri formatını oluşturma hesaplama yönünden pahalıysa, istenilen verileri sağlayan bir işlev sağlayarak gecikmeli
oluşturmayı kullanabilirsiniz. İşlev yalnızca, bırakma veya yapıştırma işleminin alıcısı gecikmeli formattaki verileri
isterse çağrılır.
Oluşturma işlevi bir Clipboard nesnesine setDataHandler() yöntemi kullanılarak eklenir. İşlevin verileri uygun
formatta döndürmesi gerekir. Örneğin, setDataHandler(ClipboardFormat.TEXT_FORMAT, writeText) öğesini
çağırdıysanız, writeText() işlevi bir dize döndürmelidir.
Aynı türdeki veri formatı bir Clipboard nesnesine setData() yöntemiyle eklenirse, bu veriler gecikmeli sürüme göre
önceliğe sahip olacaktır (oluşturma işlevi hiçbir zaman çağrılmaz). Aynı clipboard verilerine ikinci kez erişilirse,
oluşturma işlevi çağırılabilir veya çağrılmayabilir.
Not: Mac OS X'te, standart AIR pano formatları kullanılırken gecikmeli oluşturma gerçekleşmez. Oluşturma işlevi
hemen çağrılır.
Gecikmeli oluşturma işlevi kullanarak metin yapıştırma
Aşağıdaki örnek gecikmeli oluşturma işlevinin nasıl uygulanacağını gösterir.
Örnekteki Kopyala düğmesine basıldığında uygulama, önceki pano işlemlerinden geriye hiç veri kalmamasını
sağlamak için sistem panosunu temizler, ardından pano setDataHandler() yöntemini kullanarak renderData()
işlevini panoya koyar.
Yapıştır düğmesine basıldığında, uygulama panoya erişir ve hedef metni ayarlar. Panodaki metin veri formatı bir
dizeyle değil işlevle ayarlandığından pano, renderData() işlevini çağırır. renderData() işlevi metni kaynak metinde
döndürür, ardından bu metin hedef metne atanır.
Kaynak metni Yapıştır düğmesine basmadan önce düzenlerseniz, düzenleme kopyala düğmesine basıldıktan sonra
gerçekleşmiş bile olsa, düzenlemenin yapıştırılan metne yansıtılacağını göz önünde bulundurun. Bunun nedeni,
yapıştır düğmesine basılana kadar oluşturma işlevinin kaynak metni kopyalamamasıdır. (Gecikmeli oluşturmayı
gerçek bir uygulamada kullanırken, bu sorunun önüne geçmek için kaynak verileri bir şekilde saklamak veya korumak
isteyebilirsiniz.)
package
{
import
import
import
import
import
flash.desktop.Clipboard;
flash.desktop.ClipboardFormats;
flash.events.MouseEvent;
public class DeferredRenderingExample extends Sprite
{
var sourceTxt:TextField;
var destinationTxt:TextField;
public function DeferredRenderingExample():void
{
sourceTxt = createTextField(10, 10, 210, 380, false);
addChild(sourceTxt);
sourceTxt.text = "Neque porro quisquam est qui dolorem "
+ "ipsum quia dolor sit amet, consectetur, adipisci velit."
destinationTxt = createTextField(330, 10, 210, 380, false);
addChild(destinationTxt);
var copyBtn:TextField = createTextField(230, 50, 90, 20, true);
copyBtn.text = "Copy";
addChild(copyBtn);
copyBtn.addEventListener(MouseEvent.CLICK, onCopy);
var pasteBtn:TextField = createTextField(230, 80, 90, 20, true);
pasteBtn.text = "Paste";
addChild(pasteBtn);
pasteBtn.addEventListener(MouseEvent.CLICK, onPaste);
}
private function createTextField(x:Number, y:Number,
width:Number, height:Number, isBtn:Boolean = false):TextField
{
var newTxt:TextField = new TextField();
newTxt.x = x;
newTxt.y = y;
newTxt.height = height;
newTxt.width = width;
newTxt.border = true;
newTxt.background = true;
if (isBtn)
{
newTxt.backgroundColor = 0xDDDDDDEE;
newTxt.selectable = false;
}
else
{
newTxt.multiline = true;
newTxt.wordWrap = true;
newTxt.backgroundColor = 0xEEEEEEEE;
}
return newTxt;
}
public function onCopy(event:MouseEvent):void
{
Clipboard.generalClipboard.clear();
Clipboard.generalClipboard.setDataHandler(ClipboardFormats.TEXT_FORMAT,
renderData);
}
public function onPaste(event:MouseEvent):void
{
destinationTxt.text =
Clipboard.generalClipboard.getData(ClipboardFormats.TEXT_FORMAT) as String;
}
public function renderData():String
{
trace("Rendering data");
var sourceStr:String = sourceTxt.text;
if (sourceTxt.selectionEndIndex > sourceTxt.selectionBeginIndex)
{
// something is selected
return sourceStr.substring(sourceTxt.selectionBeginIndex,
sourceTxt.selectionEndIndex);
}
else
{
return sourceStr;
}
}
}
}
148
Bölüm 17: Bayt dizileriyle çalışma
ByteArray sınıfı, esasında bayt dizisi olan ikili veri akışını okumanızı veya ikili veri akışına yazmanızı sağlar. Bu sınıf
verilere en basit şekilde erişmek için bir yol sağlar. Bilgisayar verileri baytlardan veya 8 bitlik gruplardan oluştuğu için,
verilerin bayt olarak okunabilmesi, sınıf ve erişim yöntemi olmayan verilere erişebildiğiniz anlamına gelir. ByteArray
sınıfı, bir bitmapten ağda dolaşan veri akışına kadar bayt düzeyinde herhangi bir veri akışını ayrıştırmanızı sağlar.
writeObject() yöntemi, bir nesneyi serileştirilmiş Action Message Format (AMF) olarak ByteArray öğesine
yazmanızı sağlar; readObject() yöntemi ise ByteArray öğesinden orijinal veri türü değişkenine kadar, serileştirilmiş
bir nesneyi okumanızı sağlar. Görüntüleme listesine yerleştirilebilen nesneler olan görüntüleme nesneleri dışındaki
tüm nesneleri serileştirebilirsiniz. Ayrıca custom sınıfı çalışma zamanı için kullanılabilirse, serileştirilmiş nesneleri
tekrar custom sınıfı örneklerine atayabilirsiniz. Bir nesneyi AMF'ye dönüştürdükten sonra, bir ağ bağlantısı üzerinden
etkili bir şekilde aktarabilir veya bir dosyaya kaydedebilirsiniz.
Burada anlatılan örnek Adobe® AIR™ uygulaması bir .zip dosyasını, .zip dosyasının içerdiği dosya listesini çıkartarak
ve onları masaüstüne yazarak bayt akışını işleme örneği olarak okur.
ByteArray okuma ve yazma
ByteArray sınıfı, flash.utils paketinin bir parçasıdır. ActionScript 3.0'da ByteArray nesnesi oluşturmak için, aşağıdaki
örnekte gösterildiği gibi ByteArray sınıfını içe aktarın ve yapıcıyı çağırın:
import flash.utils.ByteArray;
var stream:ByteArray = new ByteArray();
ByteArray yöntemleri
Anlamlı bir veri akışı, istediğiniz bilgiyi bulmak için analiz edebileceğiniz bir format olarak organize edilir. Örneğin
basit bir çalışan dizisindeki kayıt büyük olasılıkla kimlik numarası, ad, adres, telefon numarası vb. içerir. MP3 ses
dosyası, indirilmekte olan dosyanın başlığını, yazarını, albümü, yayınlanma tarihini ve türünü belirten bir Kimlik3
etiketi içerir. Format sayesinde, veri akışındaki verileri hangi sırada bekleyeceğinizi bilirsiniz. Bayt akışını mantıklı bir
şekilde okuyabilirsiniz.
ByteArray sınıfı bir veri akışından okumayı ve veri akışına yazmayı kolaylaştıran birçok yöntem içerir. Bunlardan
bazıları readBytes() ve writeBytes(), readInt() ve writeInt(), readFloat() ve writeFloat(),
readObject() ve writeObject() ve readUTFBytes() ve writeUTFBytes() yöntemleridir. Bu yöntemler sayesinde
veri akışından verileri belirli veri türleri değişkenlerinde okuyabilir ve belirli veri türlerini doğrudan ikili veri akışına
yazabilirsiniz.
Örneğin aşağıdaki kod basit bir dize dizisini ve kayar nokta sayısını okur ve her öğeyi ByteArray öğesine yazar. Dizinin
organizasyonu sayesinde kod, verileri yazmak için uygun ByteArray yöntemlerini (writeUTFBytes() ve
writeFloat()) çağırabilir. Yinelenen veri modeli sayesinde diziyi bir döngüyle okuyabilirsiniz.
Bayt dizileriyle çalışma
// The following example reads a simple Array (groceries), made up of strings
// and floating-point numbers, and writes it to a ByteArray.
// define the grocery list Array
var groceries:Array = ["milk", 4.50, "soup", 1.79, "eggs", 3.19, "bread" , 2.35]
// define the ByteArray
// for each item in the array
for (var i:int = 0; i < groceries.length; i++) {
bytes.writeUTFBytes(groceries[i++]); //write the string and position to the next item
bytes.writeFloat(groceries[i]);// write the float
trace("bytes.position is: " + bytes.position);//display the position in ByteArray
}
trace("bytes length is: " + bytes.length);// display the length
position özelliği
position özelliği, okuma veya yazma sırasında ByteArray öğesini dizine alan işaretçinin geçerli konumunu saklar.
position özelliğinin başlangıç değeri, aşağıdaki kodda da gösterildiği gibi 0'dır (sıfır):
trace("bytes.position is initially: " + bytes.position); // 0
Bir ByteArray öğesinden okuma veya ByteArray öğesine yazma işlemi gerçekleştirdiğinizde, kullandığınız yöntem,
position özelliğini okunan veya yazılan son baytın hemen ardından konuma işaret edecek şekilde güncelleştirir.
Örneğin aşağıdaki kod ByteArray öğesine bir dize yazar ve sonrasında position özelliği, ByteArray öğesindeki dizenin
hemen ardından bayta işaret eder.
bytes.writeUTFBytes("Hello World!");
trace("bytes.position is now: " + bytes.position);// 12
Benzer şekilde, bir okuma işlemi de okunan bayt sayısını position özelliğine göre artırır.
bytes.writeUTFBytes("Hello World!");
trace("bytes.position is now: " + bytes.position);// 12
bytes.position = 0;
trace("The first 6 bytes are: " + (bytes.readUTFBytes(6)));//Hello
trace("And the next 6 bytes are: " + (bytes.readUTFBytes(6)));// World!
Söz konusu uzaklıkta okumak veya yazmak için position özelliğini ByteArray öğesinde belirli bir konuma
ayarlayabilirsiniz.
bytesAvailable ve length özellikleri
length ve bytesAvailable özellikleri, ByteArray öğesinin ne kadar süreceğini ve geçerli konumdan sonuna kadar
kaç baytı kaldığını gösterir. Aşağıdaki örnek bu özellikleri nasıl kullanabileceğinizi gösterir. Örnek, metnin bir Dizesini
ByteArray öğesine yazar ve ardından, “a” ile veya son ile karşılaşana kadar (bytesAvailable <= 0) bir kerede bir bayt
olacak şekilde ByteArray öğesini okur.
var text:String = "Lorem ipsum dolor sit amet, consectetuer adipiscing elit. Vivamus etc.";
bytes.writeUTFBytes(text); // write the text to the ByteArray
trace("The length of the ByteArray is: " + bytes.length);// 70
bytes.position = 0; // reset position
while (bytes.bytesAvailable > 0 && (bytes.readUTFBytes(1) != 'a')) {
//read to letter a or end of bytes
}
if (bytes.position < bytes.bytesAvailable) {
trace("Found the letter a; position is: " + bytes.position); // 23
trace("and the number of bytes available is: " + bytes.bytesAvailable);// 47
}
endian özelliği
Bilgisayarlar çok baytlı, yani saklanması için 1 bayttan fazla bellek gereken sayıları saklama yöntemlerine göre farklılık
gösterebilir. Örneğin bir tam sayı belleğin 4 baytını veya 32 bitini kaplayabilir. Bazı bilgisayarlar öncelikle sayının en
yüksek değerli baytını en düşük bellek adresinde saklar, diğer bilgisayarlar ise öncelikle en düşük değerli baytı saklar.
Bilgisayarın veya bayt sıralamasının bu niteliği, big endian (önce en yüksek değerli bayt) veya little endian (önce en
düşük değerli bayt) olarak adlandırılır. Örneğin 0x31323334 sayısı big endian ve little endian bayt sıralaması için
aşağıdaki gibi saklanır, a0, 4 bayt arasında en düşük bellek adresini ve a3 en yüksek olanı temsil eder:
Big Endian
Big Endian
Big Endian
Big Endian
a0
a1
a2
a3
31
32
33
34
Little Endian
Little Endian
Little Endian
Little Endian
a0
a1
a2
a3
34
33
32
31
ByteArray sınıfının endian özelliği, işlediğiniz çok baytı sayılar için bu bayt sırasını belirtmenizi sağlar. Bu özellik için
kabul edilebilir değerler "bigEndian" veya "littleEndian" değerleridir ve Endian sınıfı, endian özelliğini bu
dizelerle ayarlamak için BIG_ENDIAN ve LITTLE_ENDIAN sabitlerini tanımlar.
compress() ve uncompress() yöntemleri
compress() yöntemi sayesinde bir ByteArray öğesini, parametre olarak belirttiğiniz bir sıkıştırma algoritmasına göre
sıkıştırabilirsiniz. uncompress() yöntemi sayesinde, sıkıştırılmış bir ByteArray öğesini sıkıştırma algoritmasına göre
genişletebilirsiniz. compress() ve uncompress() yöntemlerini çağırdıktan sonra, bayt dizisinin uzunluğu yeni
uzunluğa ve position özelliği sona ayarlanır.
CompressionAlgorithm sınıfı, sıkıştırma algoritmasını belirtmek için kullanabileceğiniz sabitleri tanımlar. AIR, hem
deflate hem de zlib algoritmalarını destekler. deflate sıkıştırma algoritması, zlib, gzip ve bazı zip uygulamaları gibi
birçok sıkıştırma formatında kullanılır. zlib sıkıştırılmış veri formatı http://www.ietf.org/rfc/rfc1950.txt adresinde ve
deflate sıkıştırma algoritması http://www.ietf.org/rfc/rfc1951.txt adresinde anlatılmaktadır.
Aşağıdaki örnek, bytes adındaki ByteArray öğesini deflate algoritması kullanarak sıkıştırır:
bytes.compress(CompressionAlgorithm.DEFLATE);
Aşağıdaki örnek sıkıştırılmış bir ByteArray öğesini deflate algoritması kullanarak genişletir:
bytes.uncompress(CompressionAlgorithm.DEFLATE);
Nesneleri okuma ve nesnelere yazma
readObject() ve writeObject() yöntemleri, serileştirilmiş Action Message Format (AMF) olarak kodlanmış
şekilde ByteArray öğesinden bir nesne okur ve ByteArray öğesine bir nesne yazar. AMF, Adobe tarafından oluşturulan
ve Netstream, NetConnection, NetStream, LocalConnection ve Paylaşılan Nesneleri de içeren çeşitli ActionScript 3.0
sınıfları tarafından kullanılan özel bir mesaj protokolüdür.
Tek baytlı tür işaretleyicisi, ardından gelen kodlanmış verilerin türünü açıklar. AMF aşağıdaki 13 veri türünü kullanır:
value-type = undefined-marker | null-marker | false-marker | true-marker | integer-type |
double-type | string-type | xml-doc-type | date-type | array-type | object-type |
xml-type | byte-array-type
Kodlanmış veriler, işaretleyici null veya true ya da false gibi, hiçbir verinin kodlanmadığı tek bir olası değer temsil
edene kadar tür işaretleyicisini izler.
AMF'nin iki sürümü vardır: AMF0 ve AMF3. AMF 0, karmaşık nesneleri başvuruya göre göndermeyi destekler ve uç
noktaların nesne ilişkilerini geri yüklemesini sağlar. AMF 3, nesne özelliklerini ve dizeleri nesne başvurularına ek
olarak başvuruya göre göndererek ve ActionScript 3.0 uygulamasında tanıtılan yeni veri türlerini destekleyerek AMF
0'ı iyileştirir. ByteArray.objectEcoding özelliği, nesne verilerinin kodlanmasında kullanılan AMF sürümünü
belirtir. flash.net.ObjectEncoding sınıfı, AMF sürümünü belirtmeye yönelik sabitleri tanımlar:
ObjectEncoding.AMF0 ve ObjectEncoding.AMF3.
import flash.filesystem.*;
// Label component must be in Library
import fl.controls.Label;
var myLabel:Label = new Label();
myLabel.move(150, 150);
myLabel.width = 200;
addChild(myLabel);
var myXML:XML =
<order>
<item id='1'>
<menuName>burger</menuName>
<price>3.95</price>
</item>
<item id='2'>
<menuName>fries</menuName>
<price>1.45</price>
</item>
</order>
// Write XML object to ByteArray
bytes.writeObject(myXML);
bytes.position = 0;//reset position to beginning
bytes.compress(CompressionAlgorithm.DEFLATE);// compress ByteArray
outFile("order", bytes);
myLabel.text = "Wrote order file to desktop!";
function outFile(fileName:String, data:ByteArray):void {
var outFile:File = File.desktopDirectory; // dest folder is desktop
outFile = outFile.resolvePath(fileName); // name of file to write
var outStream:FileStream = new FileStream();
// open output file stream in WRITE mode
outStream.open(outFile, FileMode.WRITE);
// write out the file
outStream.writeBytes(data, 0, data.length);
// close it
outStream.close();
}
readObject() yöntemi, serileştirilmiş AMF'deki bir nesneyi ByteArray öğesinden okur ve belirtilen türde bir nesnede
saklar. Aşağıdaki örnek order dosyasını masaüstünden ByteArray öğesine (inBytes) okur, genişletir ve orderXML
XML nesnesinde saklamak için readObject() öğesini çağırır. Örnek, her düğümü görüntüleme için bir metin alanına
eklemek üzere for each() döngü yapısı kullanır. Örnek ayrıca objectEncoding özelliğinin değerini de, order
dosyasının içeriğine yönelik bir üstbilgiyle birlikte görüntüler.
// TextArea component must be in Library
import fl.controls.TextArea;
var inBytes:ByteArray = new ByteArray();
// define text area for displaying XML content
var myTxt:TextArea = new TextArea();
myTxt.width = 550;
myTxt.height = 400;
addChild(myTxt);
//display objectEncoding and file heading
myTxt.text = "Object encoding is: " + inBytes.objectEncoding + "\n\n" + "order file: \n\n";
readFile("order", inBytes);
inBytes.position = 0; // reset position to beginning
inBytes.uncompress(CompressionAlgorithm.DEFLATE);
inBytes.position = 0;//reset position to beginning
// read XML Object
var orderXML:XML = inBytes.readObject();
//for each node in orderXML
for each(var child:XML in orderXML) {
// append child node to text area
myTxt.text += child + "\n";
}
// read specified file into byte array
function readFile(fileName:String, data:ByteArray) {
var inFile:File = File.desktopDirectory; // source folder is desktop
inFile = inFile.resolvePath(fileName); // name of file to read
var inStream:FileStream = new FileStream();
inStream.open(inFile, FileMode.READ);
inStream.readBytes(data, 0, data.length);
inStream.close();
}
ByteArray örneği: Bir .zip dosyasını okuma
Bu örnek, farklı türlerde birçok dosya içeren basit bir .zip dosyasının nasıl okunacağını gösterir. Bu işlemi her dosyanın
meta verilerinden ilgili verileri ayıklayarak, her dosyayı bir ByteArray öğesine genişleterek ve dosyayı masaüstüne
yazarak yapar.
Bir .zip dosyasının genel yapısı PKWARE Inc.in belirtimine dayalıdır, bu belirtim
http://www.pkware.com/documents/casestudies/APPNOTE.TXT adresinde bulunmaktadır. İlki, .zip arşivindeki ilk
dosyanın dosya üstbilgisi ve dosya verileridir, ardından her ek dosyanın dosya üstbilgisi ve dosya veri çifti gelir. (Dosya
üstbilgisinin yapısı daha ileride anlatılmaktadır.) İkincisi, .zip dosyası isteğe bağlı olarak bir veri tanımlayıcı kaydı
içerir (genellikle çıktı zip dosyası diske kaydedilmek yerine bellekte oluşturulduğunda). Üçüncü olarak, birçok ilave
isteğe bağlı öğe bulunmaktadır: arşiv şifre çözme üstbilgisi, arşiv ek veri kaydı, merkezi dizin yapısı, Zip64 merkezi
dizin kaydının sonu, Zip64 merkezi dizin bulucunun sonu ve merkezi dizin kaydının sonu.
Bu örnekteki kod yalnızca klasör içermeyen zip dosyalarının ayrıştırılması için yazılmıştır ve veri tanımlayıcı kayıtları
beklemez. Son veri dosyasını izleyen tüm bilgileri yoksayar.
Her dosya için dosya üstbilgi formatı şöyledir:
dosya üstbilgisi imzası
4 bayt
gerekli sürüm
2 bayt
genel amaçlı bit bayrağı
2 bayt
sıkıştırma yöntemi
2 bayt (8=DEFLATE; 0=SIKIŞTIRILMAMIŞ)
dosyanın son değiştirilme zamanı
2 bayt
dosyanın son değiştirilme tarihi
2 bayt
crc-32
4 bayt
sıkıştırılmış boyut
4 bayt
sıkıştırılmamış boyut
4 bayt
dosya adı uzunluğu
2 bayt
ek alan uzunluğu
2 bayt
dosya adı
değişken
ek alan
değişken
Dosya üstbilgisinin ardından gerçek dosya verileri gelir, bu veriler sıkıştırma yöntemi bayrağına bağlı olarak
sıkıştırılmış veya sıkıştırılmamış olabilir. Dosya verileri sıkıştırılmamışsa bayrak 0'dır (sıfır), DEFLATE algoritması
kullanılarak sıkıştırılmışsa 8'dir veya diğer sıkıştırma algoritmaları kullanılmışsa başka bir değerdir.
Bu örneğin kullanıcı arabirimi bir etiket ve bir metin alanından oluşur (taFiles). Uygulama aşağıdaki bilgileri .zip
dosyasında karşılaştığı her dosyanın metin alanına yazar: dosya adı, sıkıştırılmış boyut ve sıkıştırılmamış boyut.
Programın başlangıcı aşağıdaki görevleri gerçekleştirir:
• Gerekli sınıfları içeri aktarır
• Kullanıcı arabirimini tanımlar
import fl.controls.*;
//requires TextArea and Label components in the Library
var taFiles = new TextArea();
var output = new Label();
taFiles.setSize(320, 150);
taFiles.move(10, 30);
output.move(10, 10);
output.width = 150;
output.text = "Contents of HelloAir.zip";
addChild(taFiles);
addChild(output);
•
bytes ByteArray öğesini tanımlar
• Dosya üstbilgisinden meta verileri saklamak için değişkenleri tanımlar
//
var
var
var
var
var
var
var
var
variables for reading fixed portion of file header
fileName:String = new String();
flNameLength:uint;
xfldLength:uint;
offset:uint;
compSize:uint;
uncompSize:uint;
compMethod:int;
signature:int;
• .zip dosyasını temsil etmek için File (zfile) ve FileStream (zStream) nesnelerini tanımlar ve dosyaların
ayıklandığı .zip dosyasının konumunu belirtir—masaüstü dizininde “HelloAIR.zip” adlı bir dosya.
// File variables for accessing .zip file
var zfile:File = File.desktopDirectory.resolvePath("HelloAIR.zip");
var zStream:FileStream = new FileStream();
Program .zip dosyasını OKUMA modunda açarak başlar.
zStream.open(zfile, FileMode.READ);
Ardından, sayısal alanların bayt sıralamasında en düşük değerli baytın önce geldiğini göstermek için bytes öğesinin
endian özelliğini LITTLE_ENDIAN olarak ayarlar.
bytes.endian = Endian.LITTLE_ENDIAN;
Sonra while() ifadesi, dosya akışındaki geçerli konum dosya boyutundan büyük veya dosya boyutuna eşit olana kadar
devam eden bir döngü başlatır.
while (zStream.position < zfile.size)
{
Döngüdeki ilk ifade dosya akışının ilk 30 baytını ByteArray bytes öğesine okur. İlk 30 bayt, ilk dosya üstbilgisinin
sabit boyutlu parçasını oluşturur.
// read fixed metadata portion of local file header
zStream.readBytes(bytes, 0, 30);
Sonra kod, 30 baytlık üstbilginin ilk baytlarından bir tam sayı ( mza) okur. ZIP formatı tanımı, her dosya üstbilgi
imzasının onaltılık değer 0x04034b50 olduğunu belirtir; imza farklıysa bu, kodun, .zip dosyasının dosya kısmının
ötesine taşındığı ve ayıklanacak dosya olmadığı anlamına gelir. Bu durumda kod, bayt sırasının sonunu beklemek
yerine hemen while döngüsünden çıkar.
bytes.position = 0;
signature = bytes.readInt();
// if no longer reading data files, quit
if (signature != 0x04034b50)
{
break;
}
Kodun sonraki kısmı üstbilgi baytını uzaklık konumu 8'de okur ve değeri compMethod değişkeninde saklar. Bu bayt,
bu dosyayı sıkıştırmak için kullanılan sıkıştırma yöntemini gösteren bir değer içerir. Birçok sıkıştırma yöntemi
kullanılabilir, ancak uygulamada neredeyse tüm .zip dosyaları DEFLATE sıkıştırma algoritmasını kullanmaktadır.
Geçerli dosya DEFLATE sıkıştırmayla sıkıştırıldıysa compMethod 8'dir; dosya sıkıştırılmamışsa, compMethod 0'dır.
bytes.position = 8;
compMethod = bytes.readByte();
// store compression method (8 == Deflate)
İlk 30 baytın ardından, üstbilginin dosya adını ve büyük olasılıkla ek bir alan içeren üstbilginin değişken uzunluklu
kısmı gelir. Değişken offset bu kısmın boyutunu saklar. Boyut, uzaklık 26 ve 28'deki üstbilgilerden okunan dosya adı
uzunluğu ve ek alan uzunluğu toplanarak hesaplanır.
offset = 0;// stores length of variable portion of metadata
bytes.position = 26; // offset to file name length
flNameLength = bytes.readShort();// store file name
offset += flNameLength; // add length of file name
bytes.position = 28;// offset to extra field length
xfldLength = bytes.readShort();
offset += xfldLength;// add length of extra field
Sonra program offset değişkeninde saklanan bayt sayısı için dosya üstbilgisinin değişken uzunluklu kısmını okur.
// read variable length bytes between fixed-length header and compressed file data
zStream.readBytes(bytes, 30, offset);
Program, dosya adını üstbilginin değişken uzunluk kısmından okur ve dosyanın sıkıştırılmış (zip) ve sıkıştırılmamış
(orijinal) boyutlarıyla birlikte metin alanında görüntüler.
bytes.position = 30;
fileName = bytes.readUTFBytes(flNameLength); // read file name
taFiles.appendText(fileName + "\n"); // write file name to text area
bytes.position = 18;
compSize = bytes.readUnsignedInt(); // store size of compressed portion
taFiles.appendText("\tCompressed size is: " + compSize + '\n');
bytes.position = 22; // offset to uncompressed size
uncompSize = bytes.readUnsignedInt(); // store uncompressed size
taFiles.appendText("\tUncompressed size is: " + uncompSize + '\n');
Örnek, dosyanın geri kalanını sıkıştırılmış boyut tarafından belirtilen uzunluk için dosya akışından bytes öğesine
okur ve ilk 30 bayttaki dosya üstbilgisinin üzerine yazar. Dosya sıkıştırılmış olmasa bile sıkıştırılmış boyut doğrudur,
çünkü bu durumda sıkıştırılmış boyut dosyanın sıkıştırılmamış boyutuna eşittir.
// read compressed file to offset 0 of bytes; for uncompressed files
// the compressed and uncompressed size is the same
zStream.readBytes(bytes, 0, compSize);
Sonra örnek, sıkıştırılmış dosyayı genişletir ve çıktı dosyası akışına yazmak için outfile() işlevini çağırır. outfile()
öğesine dosya verilerini içeren dosya adını ve bayt sırasını iletir.
if (compMethod == 8) // if file is compressed, uncompress
{
bytes.uncompress(CompressionAlgorithm.DEFLATE);
}
outFile(fileName, bytes);
// call outFile() to write out the file
Kapatma ayracı, outFile() yöntemi haricinde while döngüsünün ve uygulama kodunun sonunu gösterir. Çalıştırma
while döngüsünün başlangıcına kadar geriye doğru ilerler ve başka bir dosyayı ayıklayarak veya son dosya işlenmişse
.zip dosyasını işlemeyi sonlandırarak .zip dosyasında bulunan sonraki baytları işlemeye devam eder.
} // end of while loop
outfile() işlevi bir çıktı dosyasını, dosyaya filename parametresi tarafından sağlanan ismi vererek masaüstünde
YAZMA modunda açar. Ardından data parametresindeki dosya verilerini çıktı dosyası akışına (outStream) yazar ve
dosyayı kapatır.
function outFile(fileName:String, data:ByteArray):void
{
var outFile:File = File.desktopDirectory; // destination folder is desktop
outFile = outFile.resolvePath(fileName); // name of file to write
var outStream:FileStream = new FileStream();
// open output file stream in WRITE mode
outStream.open(outFile, FileMode.WRITE);
// write out the file
outStream.writeBytes(data, 0, data.length);
// close it
outStream.close();
}
157
Bölüm 18: Yerel SQL veritabanlarıyla
çalışma
Adobe AIR, yerel SQL veritabanları oluşturma ve bu veritabanlarıyla çalışma özelliğini içerir. Çalışma zamanı, açık
kaynak SQLite veritabanı sistemini kullanarak birçok standart SQL özelliğini destekleyen bir SQL veritabanı motoru
içerir. Yerel bir SQL veritabanı, yerel, kalıcı verileri saklamak için kullanılabilir. Örneğin, uygulamanızın yerel olarak
saklamasını isteyebileceğiniz uygulama verileri, uygulama kullanıcı ayarları, belgeler veya diğer türlerdeki veriler için
kullanılabilir.
Yerel SQL veritabanları hakkında ek çevrimiçi bilgi
Yerel SQL veritabanlarıyla çalışma hakkında daha fazla bilgiyi şu kaynaklardan bulabilirsiniz:
Dil Başvurusu
• SQLCollationType
• SQLColumnNameStyle
• SQLColumnSchema
• SQLConnection
• SQLError
• SQLErrorEvent
• SQLErrorOperation
• SQLEvent
• SQLIndexSchema
• SQLMode
• SQLResult
• SQLSchema
• SQLSchemaResult
• SQLStatement
• SQLTableSchema
• SQLTransactionLockType
• SQLTriggerSchema
• SQLUpdateEvent
• SQLViewSchema
• Flash için Adobe AIR Geliştirici Bağlantısı (ara: ‘AIR SQL’)
Yerel SQL veritabanlarıyla çalışma
Yerel SQL veritabanları hakkında
Adobe AIR, AIR uygulamasının çalıştığı bilgisayardaki veritabanı dosyalarında yerel olarak saklanan verileri içeren
çalışma zamanında çalışan SQL tabanlı ilişkisel bir veritabanı motoru içerir (örneğin, bilgisayarın sabit sürücüsünde).
Veritabanı yerel olarak çalıştığı ve veri dosyaları yerel olarak saklandığı için, bir veritabanı AIR uygulaması tarafından
ağ bağlantısının kullanılabilir olup olmadığına bakılmaksızın kullanılabilir. Bu nedenle, çalışma zamanının yerel SQL
veritabanı motoru, özellikle SQL ve ilişkisel veritabanlarlarına ilişkin deneyiminiz varsa, kalıcı, yerel uygulama
verilerinin saklanması için uygun bir mekanizma sağlar
Yerel SQL veritabanları için kullanımlar
AIR yerel SQL veritabanı işlevi, uygulama verilerini kullanıcının yerel bilgisayarında saklamak isteyebileceğiniz tüm
amaçlar için kullanılabilir. Adobe AIR, verilerin yerel olarak saklanması için, her biri farklı avantajlara sahip çeşitli
mekanizmalar içerir. AIR uygulamanızdaki yerel SQL veritabanı için bazı olası kullanımlar şunlardır:
• Veritabanı, veri odaklı bir uygulama (örneğin bir adres defteri) için ana uygulama verilerini saklamak amacıyla
kullanılabilir.
• Kullanıcıların kaydetmek ve belki de paylaşmak için belgeler oluşturduğu belge odaklı uygulamalar için, belgeler
kullanıcının belirlediği konumda bir veritabanı dosyası olarak kaydedilebilir. (Ancak, herhangi bir AIR
uygulamasının veritabanı dosyasını açabileceğini göz önünde bulundurun. Bu nedenle, önemli olabilecek belgeler
için şifreleme mekanizması önerilir.)
• Veritabanı, ağ kullanan bir uygulama için uygulama verilerinin yerel önbelleğini saklamak veya ağ bağlantısı
kullanılabilir olmadığında verileri geçici olarak saklamak üzere kullanılabilir. Yerel veritabanını ağ veri deposuyla
senkronize etmek için bir mekanizma oluşturabilirsiniz.
• Veritabanı, herhangi bir uygulama için tek bir kullanıcının uygulama ayarlarını, örneğin pencere boyutu ve
konumu gibi kullanıcı seçenekleri ve uygulama bilgisini saklamak üzere kullanılabilir.
AIR veritabanları ve veritabanı dosyaları hakkında
Tek bir Adobe AIR yerel SQL veritabanı, bilgisayarın dosya sisteminde tek bir dosya olarak saklanır. Çalışma zamanı,
veritabanı dosyalarının oluşturulup yapılandırılmasını, verilerin bir veritabanı dosyasından alınması ve
değiştirilmesini yöneten bir SQL veritabanı motoru içerir. Çalışma zamanı, veritabanı verilerinin dosya sisteminin
neresinde ve nasıl saklandığını belirtmez; bunun yerine, her veritabanının tamamı tek bir dosyada saklanır. Veritabanı
dosyasının saklandığı dosya ssitemindeki konumu siz belirlersinz. Tek bir AIR uygulaması bir veya daha çok ayrı
veritabanına erişebilir (bunlar, ayrı veritabanı dosyalarıdır). Çalışma zamanı her veritabanını dosya sisteminde tek bir
dosya olarak sakladığından, veritabanınızı uygulamanızın tasarımının ve işletim sistemi dosya erişim sınırlamalarının
gerektirdiği şekilde konumlandırabilirsiniz. Her kullanıcı, özel verileri için ayrı bir veritabanı dosyasına sahiptir veya
paylaşılan veriler için tek bir bilgisayardaki tüm uygulama kullanıcıları veritabanı dosyasına erişebilir. Veriler tek bir
bilgisayar için yerel olduğundan, farklı bilgisayarlardaki kullanıcılar tarafından otomatik olarak paylaşılmaz. Yerel
SQL veritabanı motoru, uzak veya sunucu tabanlı bir veritabanına karşı SQL ifadelerinin yürütülmesi için herhangi bir
özellik sağlamaz.
İlişkisel veritabanları hakkında
İlişkisel veritabanı, verilerin bir bilgisayarda saklanmasına (ve geri alınmasına) yönelik bir mekanizmadır. Veriler,
tablolar halinde düzenlenir: satırlar kayıtları veya öğeleri temsil eder ve sütunlar (bazen “alanlar” da denir) her kaydı
ayrı ayrı değerlere böler. Örneğin, adres defteri uygulaması bir “arkadaşlar” tablosu içerebilir. Tablodaki her satır,
veritabanında saklanan tek bir arkadaşı temsil edecektir. Tablonun sütunları, ad, soyad, doğum tarihi vb. gibi verileri
temsil eder. Veritabanı, tablodaki her arkadaş satırına ilişkin her sütun için ayrı bir değer saklar.
İlişkisel veritabanları, bir öğenin başka türden öğelerle ilişkilendirilmiş veya başka türden öğelerle olduğu karmaşık
verilerin saklanması için tasarlanmıştır. İlişkisel bir veritabanında, bire çok ilişkiye sahip —tek bir kaydın farklı türdeki
birden çok kayıtla ilişkilendirilebildiği —veriler farklı tablolar halinde bölümlenmelidir. Örneğin, adres defteri
uygulamanızın her arkadaş için birden çok telefon numarası saklamasını istediğinizi varsayın; bu, bire çok ilişkidir.
“Arkadaşlar” tablosu, her arkadaş için tüm kişisel bilgileri içerecektir. Ayrı bir “telefon numaraları” tablosu, tüm
arkadaşlara ilişkin tüm telefon numaralarını içerir.
Arkadaşlara ve telefon numaralarına ilişkin verileri saklamanın yanı sıra, her tablo, iki tablo arasındaki ilişkiyi izlemek
için—ayrı ayrı arkadaş kayıtlarını telefon numaralarıyla eşlemek için bir veri parçasına ihtiyaç duyacaktır. Bu veri, ana
anahtar—tablodaki her satırı bu tablodaki diğer satırlardan ayırt eden benzersiz bir kimlik olarak bilinir. Ana anahtar,
tablodaki her kaydı doğal olarak ayırt eden veri öğelerinden biri olduğu anlamına gelen “doğal anahtar” olabilir. Hiçbir
arkadaşınızın aynı doğum tarihini paylaşmadığını biliyorsanız, “arkadaşlar” tablosunda doğum tarihi sütununu ana
anahtar (doğal anahtar) olarak kullanabilirsiniz. Doğal anahtar yoksa, “arkadaş kimliği”—uygulamanın satırları ayırt
etmek için kullanacağı yapay bir değer gibi ayrı bir ana anahtar sütunu oluşturabilirsiniz.
Ana anahtarı kullanarak birden çok tablo arasında ilişkiler kurabilirsiniz. Örneğin, “arkadaşlar” tablosunun her satır
(her arkadaş) için benzersiz bir numara içeren bir “arkadaş kimliği” sütununa sahip olduğunu düşünün. İlgili “telefon
numaraları” tablosu, iki sütunla yapılandırılabilir: telefon numarasının ait olduğu arkadaşın “arkadaş kimliği” bilgisini
içeren sütun ve geçerli telefon numarasını içeren sütun. Bu şekilde, tek bir arkadaş kaç telefon numarasına sahip olursa
olsun, bunların tümü “telefon numaraları tablosunda saklanabilir ve “arkadaş kimliği” ana anahtarı kullanılarak ilgili
arkadaşa bağlanabilir. Bir tablodaki ana anahtar, ilgili bir tabloda kayıtlar arasındaki bağlantıyı belirtmek üzere
kullanıldığında, ilgili tablodaki değer yabancı anahtar olarak bilinir. Birçok veritabanıın aksine, AIR yerel veritabanı
motoru, eklenen veya güncellenen yabancı anahtara ana anahtar tablosunda karşılık gelen bir satırın bululup
bulunmadığını otomatik olarak kontrol eden sınırlamalar olan yabancı anahtar sınırlamaları oluşturmanıza olanak
vermez. Yine de, yabancı anahtar ilişkileri ilişkisel veritabanı yapısının önemli bir parçasıdır ve veritabanınızdaki
tablolar arasında ilişki oluştururken yabancı anahtarlar kullanılmalıdır.
SQL hakkında
Yapılandırılmış Sorgu Dili (Structured Query Language - SQL) verileri değiştirmek ve getirmek için ilişkisel
veritabanlarıyla kullanılır. SQL, yordam temelli bir dilden çok, tanımlayıcı bir dildir. Bir SQL ifadesi, verilerin nasıl
getirileceğine ilişkin bilgisayar talimatları vermek yerine, istediğiniz veri kümesini açıklar. Veritabanı motoru,
verilerin nasıl getirileceğini belirler.
SQL dili, American National Standards Institute (ANSI) tarafından standartlaştırılmıştır. Adobe AIR yerel SQL
veritabanı SQL-92 standardının büyük bölümünü destekler. Adobe AIR'de desteklenen SQL dilinin özel açıklamaları
için bkz. ActionScript 3.0 Dil ve Bileşenler Başvurusu linkindeki “Yerel veritabanlarında SQL desteği“ eki.
SQL veritabanları sınıfları hakkında
ActionScript 3.0'da yerel SQL veritabanlarıyla çalışmak için bu sınıfların flash.data paketindeki örneklerini
kullanırsınız:
Sınıf
Açıklama
flash.data.SQLConnection
Veritabanları (veritabanı dosyaları) oluşturma ve açmaya yönelik yolların yanı sıra, veritabanı düzeyinde
işlemler gerçekleştirmek ve veritabanı işlemlerini denetlemek için yöntemler sağlar.
flash.data.SQLStatement
İfade metninin tanımlanması ve parametre değerlerinin ayarlanması dahil, veritabanında yürütülen tek bir
SQL ifadesini (tek bir sorgu veya komut) temsil eder.
flash.data.SQLResult
SELECT ifadesinden sonuç satırları, UPDATE veya DELETE ifadesinden etkilenen bir dizi satır vb. ifadelerin
yürütülmesinden doğan sonuçların ve bu yürütmelere ilişkin bilgilerin getirilmesi için bir yol sağlar
Veritabanı yapısını açıklayan şema bilgilerini elde etmek için flash.data paketindeki şu sınıfları kullanırsınız:
Sınıf
Açıklama
flash.data.SQLSchemaResult
SQLConnection.loadSchema() yönteminin çağrılmasıyla oluşan veritabanı şeması sonuçları için
konteyner görevi yapar.
flash.data.SQLTableSchema
Veritabanındaki tek bir tabloyu açıklayan bilgiyi sağlar.
flash.data.SQLViewSchema
Veritabanındaki tek bir görünümü açıklayan bilgiyi sağlar.
flash.data.SQLIndexSchema
Veritabanındaki tek bir tablo veya görünüm sütununu açıklayan bilgiyi sağlar.
flash.data.SQLTriggerSchema Veritabanındaki tek bir tetikleyiciyi açıklayan bilgiyi sağlar.
flash.data paketindeki diğer sınıflar, SQLConnection sınıfı ve SQLColumnSchema sınıfıyla kullanılan sabitleri sağlar:
Sınıf
Açıklama
flash.data.SQLMode
SQLConnection.open() ve SQLConnection.openAsync() yöntemlerinin openMode
parametresi için olası değerleri temsil eden bir dizi sabiti tanımlar.
flash.data.SQLColumnNameStyle
SQLConnection.columnNameStyle özelliği için olası değerleri temsil eden bir dizi sabiti tanımlar.
flash.data.SQLTransactionLockType
SQLConnection.begin() yönteminin seçenek parametresi için olası değerleri temsil eden bir dizi
sabiti tanımlar.
flash.data.SQLCollationType
SQLColumnSchema() yapıcısının SQLColumnSchema.defaultCollationType özelliği ve
defaultCollationType parametresi için olası değerleri temsil eden bir dizi sabiti tanımlar.
Ayrıca, flash.events paketinde bulunan aşağıdaki sınıflar kullandığınız olayları (ve desteklenen sabitleri) temsil eder:
Sınıf
Açıklama
flash.data.SQLEvent
İşlemlerinden herhangi biri başarıyla yürütüldüğünde SQLConnection veya SQLStatement örneklerinin
gönderdiği olayları tanımlar. Her işlem, SQLEvent sınıfında tanımlanmış, ilişkili bir olay türüne sahiptir.
flash.data.SQLErrorEvent
İşlemlerinden herhangi biri hatayla sonuçlandığında, SQLConnection veya SQLStatement örneklerinin
gönderdiği olayı tanımlar.
flash.data.SQLUpdateEvent
Bağlı veritabanlarından birinde yer alan tablo verileri, yürütülen bir INSERT, UPDATE veya DELETE SQL
ifadesinin sonucu olarak değiştiğinde SQLConnection örneğinin gönderdiği olayı tanımlar.
Son olarak, flash.errors paketinde yer alan aşağıdaki sınıflar, veritabanı işlem hataları hakkında bilgi sağlar:
Sınıf
Açıklama
flash.data.SQLError
Gerçekleştirilmeye çalışıklan işlem ve hatanın nedeni dahil, veritabanı işlem hatası hakkında bilgi sağlar.
flash.data.SQLErrorEvent
Hatayla sonuçlanan veritabanı işlemini gösteren SQLError sınıfının operation özelliği için olası değerleri
temsil eden bir dizi sabiti tanımlar.
Senkronize ve senkronize olmayan yürütme modları hakkında
Yerel SQL veritabanıyla çalışmak üzere bir kod yazdığınızda, bu veritabanı işlem yürütmesini iki yürütme modundan
birinde belirlersiniz: senkronize olmayan veya senkronize yürütme modu. Kod örnekleri genellikle ihtiyaçlarınıza en
uygun olan örneği kullanabilmeniz için, her bir işlemin her iki yolla da nasıl gerçekleştirileceğini gösterir.
Senkronize olmayan yürütme modunda, çalışma zamanına bir talimat verirsiniz ve istediğiniz işlem tamamlandığında
veya başarısız olduğunda çalışma zamanı bir olay gönderir. Önce veritabanı motoruna bir işlem gerçekleştirmesini
söylersiniz. Uygulama çalışmaya devam ederken, veritabanı motoru işini arka planda yapar. Son olarak, veritabanı
motoru işlem tamamlandığında (veya başarısız olduğunda) bir olay gönderir. Olay tarafından tetiklenen kodunuz,
sonraki işlemleri gerçekleştirir. Bu yaklaşımın önemli bir faydası vardır: ana uygulama kodu çalışmaya devam ederken,
çalışma zamanı veritabanı işlemlerini arka planda gerçekleştirir. Veritabanı işlemi büyük ölçüde zaman alırsa,
uygulama çalışmaya devam eder. En önemlisi, kullanıcı ekranı dondurmadan uygulamayla etkileşim kurmaya devam
edebilir. Yine de, senkronize olmayan işlem kodunun yazılması diğer kodlara göre daha karmaşık olabilir. Bu
karmaşıklık, genellikle çoklu bağımlı işlemlerin çeşitli olay dinleyici yöntemlerine bölümlenmesi gerektiği durumlarda
mevcuttur.
Kavramsal olarak, işlemleri birkaç olay dinleyici yöntemine bölünmüş bir işlem kümesi yerine, tek bir adım sırası—bir
senkronize işlemler kümesi—olarak kodlamak daha kolaydır. Senkronize olmayan veritabanı işlemlerine ek olarak,
Adobe AIR veritabanı işlemlerini senkronize olarak yürütmenize de olanak verir. Senkronize yürütme modunda,
işlemler arka planda çalışmaz. Bunun yerine, diğer tüm uygulama kodları gibi aynı yürütme sırasında çalışır.
Veritabanı motoruna bir işlem gerçekleştirmesini söylersiniz. Daha sonra, veritabanı motoru işini yaparken, kod bu
noktada duraklar. İşlem tamamlandığında, yürütme sonraki kod satırıyla devam eder.
İşlemlerin senkronize olmayan veya senkronize biçimde yürütüleceği, SQLConnection düzeyinde ayarlanır. Tek bir
veritabanı bağlantısı kullanarak bazı işlemler ve ifadeleri senkronize, diğerlerini senkronize olmayan biçimde
yürütemezsiniz. Veritabanını açmak için SQLConnection yöntemini çağırarak, SQLConnection öğesinin senkronize
veya senkronize olmayan yürütme modunda çalışacağını belirlersiniz. SQLConnection.open() yöntemini
çağırırsanız, bağlantı senkronize yürütme modunda, SQLConnection.openAsync() yöntemini çağırırsanız
senkronize olmayan yürütme modunda çalışır. SQLConnection örneği, open() veya openAsync() kullanılarak bir
veritabanına bağlandığında, veritabanı bağlantısını kapatıp açmadığınız sürece, senkronize veya senkronize olmayan
yürütme moduna sabitlenir.
Her yürütme modunun kendi faydaları vardır. Modların çoğu yönü birbirine benzese de, her bir modda çalışırken
aklınızda bulundurmak isteyeceğiniz bazı farklar vardır. Bu başlıklar hakkında daha fazla bilgi ve her bir modda
çalışmaya ilişkin öneriler için bkz. “Senkronize ve senkronize olmayan veritabanı işlemlerini kullanma” sayfa 181.
Veritabanı oluşturma ve değiştirme
Uygulamanızın verileri ekleyebilmesi ve getirebilmesi için, uygulamanızın erişebileceği, içinde tanımlanmış tablolar
bulunan bir veritabanı gereklidir. Burada, bir veritabanı oluşturma ve bir veritabanı içindeki veri yapısını oluşturmaya
ilişkin görevler tanımlanmıştır. Bu görevler veri ekleme ve veri getirmeden daha az kullanılsa da, çoğu uygulama için
gereklidir.
Veritabanı oluşturma
Bir veritabanı dosyası oluşturmak için, önce bir SQLConnection örneği oluşturursunuz. Bunu senkronize yürütme
modunda açmak için open() yöntemini veya senkronize olmayan yürütme modunda açmak için openAsync()
yöntemini çağırırsınız. open() ve openAsync() yöntemleri, bir veritabanı bağlantısını açmak için kullanılır.
reference parametresine (ilk parametre) ilişkin var olmayan bir dosyaya başvuran bir File örneği ilettiğinizde,
open() veya openAsync() yöntemi bu dosya konumunda bir veritasbanı dosyası oluşturur ve yeni oluşturulan
veritabanına bağlantı kurar.
Veritabanı oluşturmak için open() veya openAsync() yöntemlerinden hangisini çağırırsanız çağırın, veritabanı
dosyasının adı herhangi bir dosya uzantısına sahip herhangi bir geçerli ad olabilir. Ba vuru parametresi için null
değeriyle open() veya openAsync() yöntemini çağırdığınızda, diskteki bir veritabanı dosyası yerine yeni bir bellek içi
veritabanı oluşturulur.
Aşağıdaki kod listesi, senkronize yürütme modu yoluyla bir veritabanı dosyası (yeni bir veritabanı) oluşturma işlemini
gösterir. Bu durumda, veritabanı dosyası uygulamanın depo dizinine “DBSample.db” dosya adıyla kaydedilir:
import flash.data.SQLConnection;
import flash.events.SQLErrorEvent;
import flash.events.SQLEvent;
var conn:SQLConnection = new SQLConnection();
conn.addEventListener(SQLEvent.OPEN, openHandler);
conn.addEventListener(SQLErrorEvent.ERROR, errorHandler);
var dbFile:File = File.applicationStorageDirectory.resolvePath("DBSample.db");
conn.openAsync(dbFile);
function openHandler(event:SQLEvent):void
{
trace("the database was created successfully");
}
function errorHandler(event:SQLErrorEvent):void
{
trace("Error message:", event.error.message);
trace("Details:", event.error.details);
}
SQLConnection örneğiyle bir veritabanı bağlantısını açtığınızda, işlemleri senkronize olarak yürütmek için open()
yöntemini çağırın. Aşağıdaki örnek, işlemlerini senkronize olarak yürüten bir SQLConnection örneğinin nasıl
oluşturulacağını ve açılacağını gösterir:
try
{
conn.open(dbFile);
trace("the database was created successfully");
}
catch (error:SQLError)
{
trace("Error message:", error.message);
trace("Details:", error.details);
}
Veritabanı tabloları oluşturma
Veritabanında bir tablo oluşturma, bir SQL ifadesini yürütmek için kullandığınız SELECT, INSERT vb. gibi bir işlemin
aynısını kullanarak bu veritabanında bir SQL ifadesi yürütmeyi içerir. Tablo oluşturmak için, sütun tanımlarını ve yeni
tabloya ilişkin sınırlamaları içeren CREATE TABLE ifadesini kullanırsınız. SQL ifadelerini yürütme hakkında daha fazla
bilgi için bkz. “SQL ifadeleriyle çalışma” sayfa 166.
Aşağıdaki örnek, var olan bir veritabanı dosyasında senkronize olmayan yürütme modunu kullanarak “çalışanlar” adlı
bir tablo oluşturmayı gösterir. Bu kodun önceden başlatılmış ve bir veritabanına bağlanmış conn adlı bir
SQLConnection örneğinin var olduğunu varsaydığını unutmayın.
import flash.data.SQLStatement;
// ... create and open the SQLConnection instance named conn ...
var createStmt:SQLStatement = new SQLStatement();
createStmt.sqlConnection = conn;
var sql:String =
"CREATE TABLE IF NOT EXISTS employees (" +
"
empId INTEGER PRIMARY KEY AUTOINCREMENT, " +
"
firstName TEXT, " +
"
lastName TEXT, " +
"
salary NUMERIC CHECK (salary > 0)" +
")";
createStmt.text = sql;
createStmt.addEventListener(SQLEvent.RESULT, createResult);
createStmt.addEventListener(SQLErrorEvent.ERROR, createError);
createStmt.execute();
function createResult(event:SQLEvent):void
{
trace("Table created");
}
function createError(event:SQLErrorEvent):void
{
}
Aşağıdaki örnek, var olan bir veritabanı dosyasında senkronize yürütme modunu kullanarak “çalışanlar” adlı bir
tablonun nasıl oluşturulacağını gösterir. Bu kodun önceden başlatılmış ve bir veritabanına bağlanmış conn adlı bir
SQLConnection örneğinin var olduğunu varsaydığını unutmayın.
var createStmt:SQLStatement = new SQLStatement();
createStmt.sqlConnection = conn;
var sql:String =
"CREATE TABLE IF NOT EXISTS employees (" +
"
empId INTEGER PRIMARY KEY AUTOINCREMENT, " +
"
firstName TEXT, " +
"
lastName TEXT, " +
"
salary NUMERIC CHECK (salary > 0)" +
")";
createStmt.text = sql;
try
{
createStmt.execute();
trace("Table created");
}
{
}
SQL veritabanı verilerini değiştirme
Yerel SQL veritabanlarıyla çalışırken gerçekleştirmeniz gereken bazı genel görevler vardır. Bu görevler, veritabanına
bağlanma, veritabanındaki tablolara veri ekleme ve bu tablolardan veri almayı içerir. Ayrıca, veri türleriyle çalışma ve
hataları işleme gibi, bu görevleri gerçekleştirirken aklınızda bulundurmak isteyeceğiniz birkaç konu mevcuttur.
Bunun yanı sıra, daha az ilgileneceğiniz, ancak bu yaygın görevleri gerçekleştirmeden önce ilgilenmeniz gereken birkaç
veritabanı görevi vardır. Örneğin, veritabanına bağlanmadan ve bir tablodan veri almadan önce, veritabanı
oluşturmanız ve bu veritabanında veri yapısı oluşturmanız gerekecektir. Bu daha nadir başlangıç kurulum görevleri
“Veritabanı oluşturma ve değiştirme” sayfa 161 bölümünde tartışılır.
Veritabanı işlemlerini senkronize olmayan biçimde gerçekleştirmeyi, yani veritabanı motorunun arka planda
çalışmasını ve işlem başarıyla tamamlandığında veya başarısız olduğunda bir olay göndererek sizi bilgilendirmesini
seçebilirsiniz. Bu işlemleri senkronize olarak da gerçekleştirebilirsiniz. Bu durumda veritabanı işlemleri ardarda
gerçekleştirilir ve tüm uygulama (ekrana güncellemeler dahil) diğer kodun yürütülmesinden önce işlemlerin
tamamlanmasını bekler. Bu bölümdeki örnekler, işlemlerin senkronize olmayan ve senkronize biçimde nasıl
gerçekleştirileceğini gösterir. Senkronize olmayan ve senkronize yürütme modunda çalışma hakkında daha fazla bilgi
için bkz. “Senkronize ve senkronize olmayan veritabanı işlemlerini kullanma” sayfa 181.
Veritabanına bağlanma
Herhangi bir veritabanı işlemini gerçekleştirmeden önce, bir veritabanı dosyası bağlantısı açın. SQLConnection
örneği, bir veya daha çok veritabanına bağlantıyı temsil etmek üzere kullanılır. SQLConnection örneği kullanılarak
bağlanılan ilk veritabanı, “ana” veritabanı olarak bilinir. Bu veritabanına open() yöntemi (senkronize yürütme modu
için) veya openAsync() yöntemi (senkronize olmayan yürütme modu için) kullanılarak bağlanılır.
Senkronize olmayan openAsync() işlemini kullanarak bir veritabanına bağlandığınızda, openAsync() işleminin ne
zaman tamamlandığını bilmek için SQLConnection örneğinin open olayına kaydolun. İşlemin başarısız olup
olmadığını belirlemek için SQLConnection örneğinin error olayına kaydolun.
Aşağıdaki örnek, senkronize olmayan yürütme için var olan bir veritabanı dosyasının nasıl açılacağını gösterir.
Veritabanı dosyası “DBSample.db” adındadır ve kullanıcının uygulama depo dizininde bulunur.
import flash.data.SQLMode;
conn.addEventListener(SQLEvent.OPEN, openHandler);
conn.addEventListener(SQLErrorEvent.ERROR, errorHandler);
conn.openAsync(dbFile, SQLMode.UPDATE);
function openHandler(event:SQLEvent):void
{
trace("the database opened successfully");
}
{
}
Aşağıdaki örnek, senkronize yürütme için var olan bir veritabanı dosyasının nasıl açılacağını gösterir. Veritabanı
dosyası “DBSample.db” adındadır ve kullanıcının uygulama depo dizininde bulunur.
import flash.data.SQLMode;
try
{
conn.open(dbFile, SQLMode.UPDATE);
trace("the database opened successfully");
}
{
}
Senkronize olmayan örnekteki openAsync() yöntemi çağrısı ve senkronize örnekteki open() yöntemi çağrısında
ikinci argümanın SQLMode.UPDATE sabiti olduğunu unutmayın. İkinci parametre (openMode) için SQLMode.UPDATE
öğesinin belirlenmesi, belirtilen dosya mevcut değilse çalışma zamanının bir hata göndermesine neden olur. openMode
parametresi için SQLMode.CREATE iletirseniz (veya openMode parametresini bırakırsanız), belirtilen dosya mevcut
değilse çalışma zamanı bir veritabanı dosyası oluşturmaya çalışır. Var olan bir veritabanını salt okunur modda açmak
üzere, openMode parametresi için SQLMode.READ de belirleyebilirsiniz. Bu durumda veriler veritabanından alınabilir,
ancak veriler eklenemez, silinemez veya değiştirilemez.
SQL ifadeleriyle çalışma
Tek bir SQL ifadesi (sorgu veya komut) çalışma zamanında bir SQLStatement nesnesi olarak temsil edilir. Bir SQL
ifadesi oluşturmak ve yürütmek için şu adımları takip edin:
SQLStatement örneği oluşturur.
SQLStatement nesnesi, uygulamanızdaki SQL ifadesini temsil eder.
var selectData:SQLStatement = new SQLStatement();
Veritabanının hangi sorguya karşı çalıştığını belirtin.
Bunu yapmak için, SQLStatement nesnesinin sqlConnection özelliğini istenen veritabanıyla bağlantışı olan
SQLConnection örneğine ayarlayın.
// A SQLConnection named "conn" has been created previously
selectData.sqlConnection = conn;
Geçerli SQL ifadesini belirtin.
İfade metnini bir Dize olarak oluşturun ve SQLStatement örneğinin text özelliğine atayın.
selectData.text = "SELECT col1, col2 FROM my_table WHERE col1 = :param1";
Yürütme işleminin sonucunu işlemek için işlevleri tanımlayın (yalnızca senkronize olmayan yürütme modu).
İşlevleri SQLStatement örneğinin result ve error olayları olarak kaydetmek için addEventListener() yöntemini
kullanın.
// using listener methods and addEventListener();
selectData.addEventListener(SQLEvent.RESULT, resultHandler);
selectData.addEventListener(SQLErrorEvent.ERROR, errorHandler);
function resultHandler(event:SQLEvent):void
{
// do something after the statement execution succeeds
}
{
// do something after the statement execution fails
}
Alternatif olarak, Responder nesnesini kullanarak dinleyici yöntemleri belirleyebilirsiniz. Bu durumda Responder
örneğini oluşturur ve dinleyici yöntemlerini bu örneğe bağlarsınız.
// using a Responder (flash.net.Responder)
var selectResponder = new Responder(onResult, onError);
function onResult(result:SQLResult):void
{
// do something after the statement execution succeeds
}
function onError(error:SQLError):void
{
// do something after the statement execution fails
}
İfade metni parametre tanımları içeriyorsa, bu parametreler için değer atayın.
Parametre değerleri atamak için, SQLStatement örneğinin parameters ilişkilendirici dizi özelliğini kullanın.
selectData.parameters[":param1"] = 25;
SQL ifadesini yürütün.
SQLStatement örneğinin execute() yöntemini çağırın.
// using synchronous execution mode
// or listener methods in asynchronous execution mode
selectData.execute();
Ayrıca, senkronize olmayan yürütme modunda olay dinleyicileri yerine Responder kullanıyorsanız, Responder
örneğini execute() yöntemine iletin.
// using a Responder in asynchronous execution mode
selectData.execute(-1, selectResponder);
Bu adımları gösteren belirli örnekler için şu başlıklara bakın:
“Bir veritabanından veri alma” sayfa 169
“Veri ekleme” sayfa 174
“Verileri değiştirme veya silme” sayfa 177
İfadelerde parametreler kullanma
Bir SQL ifade parametresi, yeniden kullanılabilir bir SQL ifadesi oluşturmanıza olanak verir. İfade parametreleri
kullandığınızda, ifadenin içindeki değerler değişebilir (bir INSERT ifadesine eklenen değerler gibi), ancak temel ifade
metni aynı kalır. Bu, uygulamanın kodlanmasını kolaylaştırdığı gibi, performansa ilişkin faydalar da sağlar.
İfade parametrelerini anlama
Bir uygulama genellikle tek bir SQL ifadesini bir uygulamada küçük değişimlerle birçok kez kullanır. Örneğin,
kullanıcının veritabanına yeni stok kalemleri ekleyebildiği bir stok izleme uygulaması düşünün. Veritabanına yeni bir
stok kalemi ekleyen uygulama kodu, veriyi veritabanına gerçekten ekleyen bir SQL INSERT ifadesini yürütür. Ancak,
ifade her yürütüldüğünde, küçük bir değişime uğrar. Özellikle, tabloya eklenen gerçek değerler farklıdır, çünkü bu
değerler eklenen stok kalemine özgüdür.
İfadede farklı değerlerle birçok kez kullanılan bir SQL ifadenizin olduğu durumlarda en iyi yaklaşım, SQL metninde
değişmez değerler yerine parametreler içeren bir SQL ifadesi kullanmaktır. Bir parametre, ifade her yürütüldüğünde
geçerli bir değerle değiştirilen ifade metnindeki yer tutucudur. SQL ifadesinde parametreler kullanmak için, normal
şekilde bir SQLStatement örneği oluşturursunuz. Text özelliğine atanan geçerli SQL ifadesi için değişmez değerler
yerine parametre yer tutucuları kullanın. SQLStatement örneğinin parameters özelliğindeki öğenin değerini
ayarlayarak, her parametreye ilişkin değeri tanımlayabilirsiniz. Parameters özelliği ilişkilendirici bir dizidir, bu
nedenle aşağıdaki sözdizimini kullanarak belirli bir değer ayarlarsınız:
statement.parameters[parameter_identifier] = value;
Parameter_identifier, adlandırılmış bir parametre kullanıyorsanız bir dize, adlandırılmamış bir parametre
kullanıyorsanız bir tam sayı dizinidir.
Adlandırılmış parametreleri kullanma
Parametre, adlandırılmış bir parametre olabilir. Adlandırılmış bir parametre, veritabanının parametre değerini ifade
metnindeki yer tutucu konumuna eşlemek için kullandığı belirli bir ada sahiptir. Bir parametre adı, aşağıdaki
örneklerdeki gibi arkasından bir ad gelen “:” veya “@” karakterinden oluşur:
:itemName
@firstName
Aşağıdaki kod listelemesi, adlandırılmış parametrelerin kullanımını gösterir:
var sql:String =
"INSERT INTO inventoryItems (name, productCode)" +
"VALUES (:name, :productCode)";
var addItemStmt:SQLStatement = new SQLStatement();
addItemStmt.sqlConnection = conn;
addItemStmt.text = sql;
// set parameter values
addItemStmt.parameters[":name"] = "Item name";
addItemStmt.parameters[":productCode"] = "12345";
addItemStmt.execute();
Adlandırılmamış parametreleri kullanma
Adlandırılmış parametre kullanmaya alternatif olarak, adlandırılmamış parametreler de kullanabilirsiniz.
Adlandırılmamış bir parametre kullanmak için, bir SQL ifadesindeki parametreyi “?” kullanarak belirtirsiniz karakter.
İfadedeki parametrelerin sırasına göre, ilk parametrenin dizin 0'la başlayacağı şekilde her parametreye sayısal bir dizin
atanmıştır. Aşağıdaki örnek, önceki örneğin adlandırılmamış parametre kullanılan versiyonunu gösterir:
var sql:String =
"INSERT INTO inventoryItems (name, productCode)" +
"VALUES (?, ?)";
var addItemStmt:SQLStatement = new SQLStatement();
addItemStmt.sqlConnection = conn;
addItemStmt.text = sql;
addItemStmt.parameters[0] = "Item name";
addItemStmt.parameters[1] = "12345";
addItemStmt.execute();
Parametre kullanmanın faydaları
Bir SQL ifadesinde parametreler kullanmak, çeşitli faydalar sağlar:
Daha iyi performans Parametreler kullanan bir SQLStatement örneği, her yürütüldüğünde dinamik olarak SQL metni
oluşturan bir örneğe göre daha verimli çalışır. Performans iyileştirmesi, ifadenin tek bir kez hazırlanmış ve SQL
ifadesinin yeniden derlenmesine ihtiyaç duymadan farklı parametre değerleri kullanarak birçok kez yürütülebiliyor
olmasından kaynaklanmaktadır.
Açık veri türleme Parametreler, SQL ifadesi oluşturulduğunda bilinmeyen değerlerin türlenmiş değişikliğine izin
vermek için kullanılır. Parametre kullanımı, veritabanına iletilen bir değer için depo sınıfını garanti etmenin tek
yoludur. Parametreler kullanılmadığında, çalışma zamanı tüm değerleri metin temsillerinden ilişkili sütunun tür
yakınlığına dayanan bir depo sınıfına dönüştürmeye çalışır. Depo sınıfları ve sütun yakınlığı hakkında daha fazla bilgi
için, bkz. “Veri türü desteği“ bölümü, ek: ”Yerel veritabanlarında SQL desteği“, konum: ActionScript 3.0 Dil ve
Bileşenler Başvurusu.
Daha fazla güvenlik Parametrelerin kullanılması, SQL yerleştirme saldırısı olarak bilinen kötü amaçlı bir tekniğin
engellenmesine yardımcı olur. Kullanıcı, SQL yerleştirme saldırısında kullanıcı tarafından erişilebilir bir konuma SQL
kodu girer (örneğin, veri giriş alanı). Uygulama kodu SQL ifadesini doğrudan kullanıcı girdisini SQL metnine
bitiştirerek oluşturuyorsa, kullanıcı taradından girilen SQL kodu veritabanına karşı yürütülür. Aşağıdaki listeleme,
kullanıcı girdisinin SQL metnine bitiştirilmesinin bir örneğini gösterir. Bu tekniği kullanmayın:
// assume the variables "username" and "password"
// contain user-entered data
var sql:String =
"SELECT userId " +
"FROM users " +
"WHERE username = '" + username + "' " +
"
AND password = '" + password + "'";
var statement:SQLStatement = new SQLStatement();
statement.text = sql;
Kullanıcı tarafından girilen değerleri ifade metnine bitiştirmek yerine ifade parametrelerinin kullanılması, SQL
yerleştirme saldırısını engeller. Parametre değerleri değişmez ifade metninin bir parçası olmaktansa, açıkça
değiştirilmiş değerler olarak değerlendirildiğinden, SQL yerleştirme gerçekleşemez. Aşağıdaki, bir önceki listelemenin
önerilen bir alternatifidir:
// assume the variables "username" and "password"
// contain user-entered data
var sql:String =
"SELECT userId " +
"FROM users " +
"WHERE username = :username " +
"
AND password = :password";
var statement:SQLStatement = new SQLStatement();
statement.text = sql;
statement.parameters[":username"] = username;
statement.parameters[":password"] = password;
Bir veritabanından veri alma
Bir veritabanından veri alma, iki adım içerir. Önce veritabanından almak istediğiniz veri kümesini açıklayan bir SQL
SELECT ifadesi yürütürsünüz. Daha sonra, alınan verilere erişerek bunları görüntüler ve uygulamanız için gerektirdiği
biçimde değiştirirsiniz.
Bir SELECT ifadesi yürütme
Var olan verileri veritabanından almak için bir SQLStatement örneği kullanırsınız. Uygun SQL SELECT ifadesini
örneğin text özelliğine atayın, daha sonra execute() yöntemini çağırın.
SELECT ifadesinin sözdizimine ilişkin ayrıntılar için bkz. ActionScript 3.0 Dil ve Bileşenler Başvurusu bölümündeki
”Yerel veritabanlarında SQL desteği“ eki.
Aşağıdaki örnek, senkronize olmayan yürütme modunu kullanan "ürünler" adlı tablodan veri almak için SELECT
ifadesinin yürütülmesini gösterir:
var selectStmt:SQLStatement = new SQLStatement();
selectStmt.sqlConnection = conn;
selectStmt.text = "SELECT itemId, itemName, price FROM products";
// The resultHandler and errorHandler are listener methods are
// described in a subsequent code listing
selectStmt.addEventListener(SQLEvent.RESULT, resultHandler);
selectStmt.addEventListener(SQLErrorEvent.ERROR, errorHandler);
selectStmt.execute();
Aşağıdaki örnek, senkronize olmayan yürütme modunu kullanan "ürünler" adlı tablodan veri almak için SELECT
ifadesinin yürütülmesini gösterir:
selectStmt.text = "SELECT itemId, itemName, price FROM products";
// This try..catch block is fleshed out in
// a subsequent code listing
try
{
// accessing the data is shown in a subsequent code listing
}
{
// error handling is shown in a subsequent code listing
}
Senkronize olmayan yürütme modunda ifadenin yürütülmesi tamamlandığında, SQLStatement örneği ifadenin başarıyla
çalıştığını gösteren bir result olayı (SQLEvent.RESULT) gönderir. Alternatif olarak, Responder nesnesi bir argüman
olarak execute() çağrısına iletildiyse, Responder nesnesinin sonuç işleyici özelliği çağrılır. Senkronize yürütme
modunda, execute() işlemi tamamlanana kadar yürütme duraklar, daha sonra, sonraki kod satırında devam eder.
SELECT ifadesi sonuç verilerine erişme
SELECT ifadesinin yürütülmesi tamamlandığında, sonraki adım alınan verilere erişmektir. SELECT sonuç kümesindeki
her veri satırı bir Object örneği olur. Bu nesne, adları sonuç kümesindeki sütun adlarıyla eşleşen özellikler içerir.
Özellikler, sonuç kümesinin sütunlarından değerler içerir. Örneğin, bir SELECT ifadesinin “öğeKimliği”, “öğeAdı” ve
“fiyat” adlı üç sütun içeren bir sonuç kümesi belirttiğini düşünün. Sonuç kümesindeki her satır için itemId, itemName,
and price adlı özellikleri içeren bir Object örneği oluşturulur. Bu özellikler, ilgili sütunlarından değerler içerir.
Aşağıdaki kod listelemesi, senkronize olmayan yürütme kipinde veri alma için önceki kod listelemesini devam ettirir.
Sonuç olay dinleyicisi yönteminde alınan verilere nasıl erişileceğini gösterir.
function resultHandler(event:SQLEvent):void
{
var result:SQLResult = selectStmt.getResult();
var numResults:int = result.data.length;
for (var i:int = 0; i < numResults; i++)
{
var row:Object = result.data[i];
var output:String = "itemId: " + row.itemId;
output += "; itemName: " + row.itemName;
output += "; price: " + row.price;
trace(output);
}
}
{
// Information about the error is available in the
// event.error property, which is an instance of
// the SQLError class.
}
Aşağıdaki kod listelemesi, senkronize yürütme kipinde veri alma için önceki kod listelemesini genişletir. Önceki
senkronize yürütme örneğinde yer alan try..catch blokunu, alınan verilere nasıl erişileceğini göstererek genişletir.
try
{
var numResults:int = result.data.length;
for (var i:int = 0; i < numResults; i++)
{
var row:Object = result.data[i];
var output:String = "itemId: " + row.itemId;
output += "; itemName: " + row.itemName;
output += "; price: " + row.price;
trace(output);
}
}
{
// Information about the error is available in the
// error variable, which is an instance of
// the SQLError class.
}
Önceki kod listelemesinin gösterdiği gibi, sonuç nesneleri bir SQLResult örneğinin data örneği olarak kullanılabilen
bir dizide bulunur. Bir olay dinleyicisiyle senkronize olmayan yürütmeyi kullanıyosanız, SQLResult örneğini getirmek
için SQLStatement örneğinin getResult() yöntemini çağırırsınız. execute() çağrısında bir Responder argümanı
belirtirseniz, SQLResult örneği sonuç işleyici işlevine bir argüman olarak gönderilir. Senkronize yürütme modunda
SQLStatement örneğinin getResult() yöntemini execute() yöntem çağrısınndan sonra istediğiniz zaman
çağırabilirsiniz. Her durumda, SQLResult nesnesine sahip olduğunuzda data dizi özelliğini kullanarak sonuç
satırlarına erişebilirsiniz.
Aşağıdaki kod listelemesi, metni bir SELECT ifadesi olan SQLStatement örneğini tanımlar. İfade, çalı anlar adlı
tablonun tüm satırlarının firstName velastName sütun değerlerini içeren satırlarını getirir. Bu örnek senkronize
olmayan yürütme modunu kullanır. Yürütme tamamlandığında selectResult() yöntemi çağrılır, sonuçlanan veri
satırlarına SQLStatement.getResult() kullanılarak erişilir ve bu satırlar trace() yöntemi kullanılarak
görüntülenir. Bu listelemenin önceden başlatılmış ve bir veritabanına bağlanmış conn adlı bir SQLConnection
örneğinin var olduğunu varsaydığını unutmayın. Ayrıca, “çalışanlar” tablosunun önceden oluşturulduğunu ve veriyle
doldurulduğunu varsayar.
import flash.data.SQLResult;
// create the SQL statement
// define the SQL text
var sql:String =
"SELECT firstName, lastName " +
"FROM employees";
selectStmt.text = sql;
// register listeners for the result and error events
selectStmt.addEventListener(SQLEvent.RESULT, selectResult);
selectStmt.addEventListener(SQLErrorEvent.ERROR, selectError);
// execute the statement
function selectResult(event:SQLEvent):void
{
// access the result data
var numRows:int = result.data.length;
for (var i:int = 0; i < numRows; i++)
{
var output:String = "";
for (var columnName:String in result.data[i])
{
output += columnName + ": " + result.data[i][columnName] + "; ";
}
trace("row[" + i.toString() + "]\t", output);
}
}
function selectError(event:SQLErrorEvent):void
{
}
Aşağıdaki kod listelemesi, önceki örnekteki tekniklerin aynısını senkronize yürütme modunda gösterir. Örnek, metni
bir SELECT ifadesi olan SQLStatement örneğini tanımlar. İfade, çalı anlar adlı tablonun tüm satırlarının firstName
velastName sütun değerlerini içeren satırlarını getirir. Sonuçlanan veri satırlarına SQLStatement.getResult()
kullanılarak erişilir ve bu satırlar trace() yöntemi kullanılarak görüntülenir. Bu listelemenin önceden başlatılmış ve
bir veritabanına bağlanmış conn adlı bir SQLConnection örneğinin var olduğunu varsaydığını unutmayın. Ayrıca,
“çalışanlar” tablosunun önceden oluşturulduğunu ve veriyle doldurulduğunu varsayar.
var sql:String =
"SELECT firstName, lastName " +
"FROM employees";
selectStmt.text = sql;
try
{
// access the result data
var numRows:int = result.data.length;
for (var i:int = 0; i < numRows; i++)
{
var output:String = "";
for (var columnName:String in result.data[i])
{
output += columnName + ": " + result.data[i][columnName] + "; ";
}
trace("row[" + i.toString() + "]\t", output);
}
}
{
}
SELECT sonuç verilerinin veri türünü tanımlama
Varsayılan olarak, SELECT ifadesinin döndürdüğü her satır, sonuç kümesinin sütun adlarıyla adlandırılan özellikler ve
her biri ilgili özelliğinin değerine sahip sütun değerini içeren bir Object örneği olarak oluşturulur. Ancal, bir SQL
SELECT ifadesini yürütmeden önce SQLStatement örneğinin itemClass özelliğini bir sınıfa ayarlayabilirsiniz.
itemClass özelliğinin ayarlanmasıyla, SELECT ifadesinin döndürdüğü her satır, belirlenen sınıfın bir örneği olarak
oluşturulur. Çalışma zamanı, SELECT sonuç kümesindeki sütun adlarını itemClass sınıfındaki özellik adlarına
eşleyerek özellik değerlerine sonuç sütunu değerleri atar.
itemClass özellik değeri olarak atanan her sınıf, herhangi bir parametre gerektirmeyen bir yapıcı içermelidir. Sınıf
ayrıca, SELECT ifadesinin döndürdüğü her sütun için tek bir özellik içermelidir. SELECT listesindeki bir sütun
itemClass sınıfında kendisiyle eşleşen bir özellik adına sahip değilse, bu bir hata olarak değerlendirilir.
SELECT sonuçlarını bölümler halinde alma
Varsayılan olarak, bir SELECT ifade yürütmesi sonuç kümesinin tüm satırlarını bir seferde alır. İfade tamamlandığında,
alınan verileri genellikle nesneler oluşturma veya verileri ekranda görüntüleme gibi bir yolla işlersiniz. İfade çok sayıda
satır döndürürse, tüm verilerin bir defada işlenmesi, kullanıcı arabiriminin kendisini yeniden düzenlememesine
neden olacak biçimde bilgisayar için zorlayıcı olabilir.
Çalışma zamanına bir defada belirli sayıda sonuç satırı döndürmesini söyleyerek uygulamanızın algılanan
performansını iyileştirebilirsiniz. Bu, ilk sonuç verilerinin daha çabuk dönmesini sağlar. Ayrıca sonuç satırlarını
kümeler halinde bölümlemenizi ve böylece kullanıcı arabiriminin işlenen her satır kümesinden sonra güncellenmesini
sağlar. Bu tekniği kullanmanın yalnızca senkronize olmayan modda kullanışlı olduğunu unutmayın.
SELECT sonuçlarını bölümler halinde almak için SQLStatement.execute() yönteminin ilk parametresi için bir değer
belirleyin (prefetch parametresi). prefetch parametresi, ifade ilk yürütüldüğünde getirilecek satır sayısını gösterir.
SQLStatement örneğinin execute() yöntemini çağırdığınızda, bir prefetch parametre değeri belirtin. Yalnızca bu
sayıda satır getirilecektir:
var stmt:SQLStatement = new SQLStatement();
stmt.sqlConnection = conn;
stmt.text = "SELECT ...";
stmt.addEventListener(SQLEvent.RESULT, selectResult);
stmt.execute(20); // only the first 20 rows (or fewer) are returned
İfade, ilk sonuç satırı kümesinin kullanılabilir olduğunu gösteren result olayını gönderir. Sonuçlanan SQLResult
örneğinin data özelliği, veri satırlarını ve getirilecek ek sonuç satırları olup olmadığını gösteren complete özelliğini
içerir. Ek sonuç satırlarını almak için SQLStatement örneğinin next() yöntemini çağırın. execute() yöntemi gibi,
next() yönteminin ilk parametresi, sonuç olayının sonraki gönderilişinde kaç satır alınacağını göstermek için
kullanılır.
function selectResult(event:SQLEvent):void
{
var result:SQLResult = stmt.getResult();
if (result.data != null)
{
// ... loop through the rows or perform other processing ...
if (!result.complete)
{
stmt.next(20); // retrieve the next 20 rows
}
else
{
stmt.removeEventListener(SQLEvent.RESULT, selectResult);
}
}
}
next() yöntemi sonraki sonuç satırlarını her döndürdüğünde, SQLStatement bir result olayı gönderir. Sonuç
olarak, tüm satırlar alınana kadar sonuçları (next() çağrılarından) işlemeye devam etmek için aynı dinleyici işlevi
kullanılabilir.
Daha fazla bilgi için SQLStatement.execute() yöntemi (prefetch parametre açıklaması) ve
SQLStatement.next() yöntemi için dil başvurusu açıklamalarına bakın.
Veri ekleme
Bir veritabanından veri alma, SQL INSERT ifadesinin yürütülmesini içerir. İfadenin yürütülmesi tamamlandığında,
veritabanı tarafından oluşturulduysa, yeni eklenen satıra ilişkin ana anahtara erişebilirsiniz.
Bir INSERT ifadesini yürütme
Veritabanındaki bir tabloya veri eklemek için, metni SQL INSERT ifadesi olan bir SQLStatement örneği oluşturur ve
bu örneği yürütürsünüz.
Aşağıdaki örnek, önceden var olan çalışanlar tablosuna bir veri satırı eklemek için SQLStatement örneğini kullanır. Bu
örnek, senkronize olmayan yürütme modunu kullanarak veri eklemeyi gösterir. Bu listelemenin önceden başlatılmış
ve bir veritabanına bağlanmış conn adlı bir SQLConnection örneğinin var olduğunu varsaydığını unutmayın. Ayrıca
“çalışanlar” tablosunun önceden oluşturulduğunu varsayar.
var insertStmt:SQLStatement = new SQLStatement();
insertStmt.sqlConnection = conn;
var sql:String =
"INSERT INTO employees (firstName, lastName, salary) " +
"VALUES ('Bob', 'Smith', 8000)";
insertStmt.text = sql;
// register listeners for the result and failure (status) events
insertStmt.addEventListener(SQLEvent.RESULT, insertResult);
insertStmt.addEventListener(SQLErrorEvent.ERROR, insertError);
insertStmt.execute();
function insertResult(event:SQLEvent):void
{
trace("INSERT statement succeeded");
}
function insertError(event:SQLErrorEvent):void
{
}
Aşağıdaki örnek, senkronize yürütme modunu kullanarak önceden var olan çalışanlar tablosuna bir veri satırı ekler.
Bu listelemenin önceden başlatılmış ve bir veritabanına bağlanmış conn adlı bir SQLConnection örneğinin var
olduğunu varsaydığını unutmayın. Ayrıca “çalışanlar” tablosunun önceden oluşturulduğunu varsayar.
var insertStmt:SQLStatement = new SQLStatement();
insertStmt.sqlConnection = conn;
var sql:String =
"INSERT INTO employees (firstName, lastName, salary) " +
"VALUES ('Bob', 'Smith', 8000)";
insertStmt.text = sql;
try
{
trace("INSERT statement succeeded");
}
{
}
Eklenen bir satırın veritabanı tarafından oluşturulan ana anahtarını alma
Bir tabloya veri satırı eklendikten sonra kodunuz genellikle yeni eklenen satıra ilişkin veritabanı tarafından oluşturulan
ana anahtarı veya satır kimlik değerini bilmek ister. Örneğin, bir tabloya satır eklediğinizde, ilgili bir tabloya satır
eklemek isteyebilirsiniz. Bu durumda, ana anahtar değerini ilişkili tabloya yabancı anahtar olarak girmek istersiniz.
Yeni eklenen satırın ana anahtarı, ifade yürütme tarafından oluşturulan SQLResult nesnesi kullanılarak alınabilir. Bu,
SELECT ifadesinin yürütülmesinden sonra sonuç verilerine erişmek için kullanılan nesnenin aynısıdır. Tüm SQL
ifadelerinde olduğu gibi, INSERT ifadesinin yürütülmesi tamamlandığında, çalışma zamanı bir SQLResult örneği
oluşturur. Bir olay dinleyicisi veya senkronize yürütme modunu kullanıyorsanız SQLStatement nesnesinin
getResult() yöntemini çağırarak SQLResult örneğine erişebilirsiniz. Alternatif olarak, senkronize olmayan yürütme
modunu kullanıyorsanız ve execute() çağrısına bir Responder örneği iletirseniz, SQLResult örneği bir argüman olarak
sonuç işleyici işlevine iletilir. Her durumda, yürütülen SQL ifadesi bir INSERT ifadesiyse, SQLResult örneği, en son
eklenen satırın satır kimliğini içeren bir lastInsertRowID özelliğine sahiptir.
Aşağıdaki örnek, senkronize olmayan yürütme modunda eklenen bir satırın ana anahtarına erişmeyi gösterir:
insertStmt.text = "INSERT INTO ...";
insertStmt.addEventListener(SQLEvent.RESULT, resultHandler);
private function resultHandler(event:SQLEvent):void
{
// get the primary key
var result:SQLResult = insertStmt.getResult();
var primaryKey:Number = result.lastInsertRowID;
// do something with the primary key
}
Aşağıdaki örnek, senkronize yürütme modunda eklenen bir satırın ana anahtarına erişmeyi gösterir:
insertStmt.text = "INSERT INTO ...";
insertStmt.addEventListener(SQLEvent.RESULT, resultHandler);
try
{
// get the primary key
var result:SQLResult = insertStmt.getResult();
var primaryKey:Number = result.lastInsertRowID;
// do something with the primary key
}
{
// respond to the error
}
Aşağıdaki kurala göre, satır kimliğinin tablo tanımında ana anahtar sütunu olarak belirlenen sütunun değeri
olabileceğini veya olmayabileceğini unutmayın:
• Tablo, yakınlığı (sütun veri türü) INTEGER olan bir ana anahtar sütunuyla tanımlandıysa, lastInsertRowID
özelliği, bu satıra eklenen değeri (veya AUTOINCREMENT sütunuysa, çalışma zamanı tarafından oluşturulan değeri)
içerir.
• Tablo birden çok ana anahtar sütunuyla (bileşik anahtar) veya yakınlığı INTEGER olan tek bir ana anahtar sütunuyla
tanımlandıysa, veritabanı perde arkasında satıra ilişkin bir satır kimlik değeri oluşturur. Oluşturulan bu değer,
lastInsertRowID özelliğinin değeridir.
• Değer, her zaman en son eklenen satırın satır kimliğidir. Bir INSERT ifadesi satır ekleyen bir tetikleyicinin
çalışmasına neden olursa, lastInsertRowID özelliği, INSERT ifadesinin oluşturduğu satırın değil, tetikleyicinin
eklediği son satırın satır kimliğini içerir. Sonuç olarak, değeri INSERT komutundan sonra
SQLResult.lastInsertRowID özelliği aracılığıyla kullanılabilen, açıkça tanımlanmış bir ana anahtar sütununa
sahip olmak istiyorsanır, sütun bir INTEGER PRIMARY KEY sütunu olarak tanımlanmalıdır. Ancak, tablonuz bir
INTEGER PRIMARY KEY sütunu içermese bile, ilgili tablolarla ilişkilerin tanımlanması bakımından, tablonuz için
ana anahtar olarak veritabanı tarafından oluşturulmuş bir satır kimliği kullanmanın eşit derecede kabul edilebilir
olduğunu unutmayın. Satır kimliği sütun değeri tüm SQL ifadelerinde ROWID, _ROWID_ veya OID adındaki özel
sütun adlarından biri aracılığıyla kullanılabilir. İlgili bir tabloda yabancı bir anahtar oluşturabilir ve satır kimlik
değerini, açıkça bildirilen INTEGER PRIMARY KEY sütunu için yapacağınız gibi yabancı anahtar sütun değeri olarak
kullanabilirsiniz. Bu anlamda, doğan anahtar yerine rasgele bir ana anahtar kullanıyorsanız, çalışma zamanının
sizin için ana anahtar değeri oluşturmasını önemsemediğiniz sürece, iki tablo arasındaki yabancı anahtar ilişkisini
tanımlamak için tablonun ana anahtarı olarak INTEGER PRIMARY KEY sütunu veya sistem tarafından oluşturulmuş
bir satır kimliği kullanmanız arasında çok az fark vardır.
Ana anahtarlar be oluşturulan satır kimlikleri hakkında daha fazla bilgi için ActionScript 3.0 Dil ve Bileşenler
Başvurusu adresinde yer alan “Yerel veritabanlarında SQL desteği” ekindeki “TABLO OLUŞTURMA” ve “İfadeler”
bölümlerine bakın.
Verileri değiştirme veya silme
Diğer veri değiştirme işlemlerinin yürütülmesi işlemi, SQL SELECT veya INSERT ifadelerinin yürütülmesi işlemiyle
aynıdır. Yalnızca SQLStatement örneğinin text özelliğini farklı bir SQL ifadesiyle değiştirin:
• Bir tabloda var olan verileri değiştirmek için UPDATE ifadesini kullanın.
• Tablodan bir veya daha çok satırı silmek için DELETE ifadesini kullanın.
Bu ifadelerin açıklamaları için ActionScript 3.0 Dil ve Bileşenler Başvurusu adresindeki “Yerel veritabanlarında SQL
desteği” ekine bakın.
Birden çok veritabanıyla çalışma
Önceden açık bir veritabanı içeren SQLConnection örneğinde ek bir veritabanı bağlantısı açmak için
SQLConnection.attach() yöntemini kullanın. Attach() yöntem çağrısındaki ad parametresini kullanarak, eklenen
veritabanına bir ad verirsiniz. Bu veritabanını değiştirmek için ifadeler yazarken, SQL ifadenizde tablonun
adlandırılmış veritabanında bulunabileceği çalışma zamanını gösteren tablo adlarını nitelemek için önekte bulunan bu
adı (veritabanı-ad.tablo-ad biçimini kullanan) kullanabilirsiniz.
Aynı SQLConnection örneğine bağlı olan birden çok veritabanından tablolar içeren tek bir SQL ifadesi yürütebilirsiniz.
Bir işlem SQLConnection örneğinde oluşturulduysa, bu işlem SQLConnection örneği kullanılarak yürütülen tüm SQL
ifadelerine uygulanır. Bu, ifadenin hangi eklenmiş veritabanında çalıştığına bakılmaksızın geçerli olur.
Alternatif olarak, bir uygulamada her biri bir veya daha çok veritabanına bağlı olan birden çok SQLConnection örneği
oluşturabilirsiniz. Ancak, aynı veritabanı için birden çok bağlantı kullanırsanız, veritabanı işlemlerinin
SQLConnection örnekleri tarafından paylaşılmadığını aklınızda bulundurmanız gerekir. Sonuç olarak, birden çok
SQLConnection örneği kullanarak aynı veritabanı dosyasına bağlanırsanız, tüm bağlantılardaki veri değişikliklerinin
beklenen biçimde uygulanacağından emin olamazsınız. Örneğin, iki UPDATE veya DELETE farklı SQLConnection
örnekleri aracılığıyla aynı veritabanına karşı çalışır ve işlem gerçekleştikten sonra uygulama hatası oluşursa, veritabanı
verileri geri alınamayacak bir biçimde ara durumda bırakılabilir ve bu durum veritabanının bütünlüğünü (ve sonuç
olarak uygulamayı) etkileyebilir.
Veritabanı hatalarını işleme
Veritabanı hatalarının işlenmesi genellikle diğer çalışma zamanı hatalarının işlenmesine benzer. Oluşabilecek hatalar
için hazırlanmış bir kod yazmalı ve bunu yapmayı çalışma zamanına bırakmak yerine hatalara yanıt vermelisiniz. Olası
veritabanı hataları genel anlamda üç kategoriye ayrılabilir: bağlantı hataları, SQL sözdizim hataları ve sınırlama
hataları.
Bağlantı hataları
Veritabanı hatalarının çoğu bağlantı hatalarıdır ve bunlar herhangi bir işlem sırasında oluşabilir. Bunlar bağlantı
hatalarını engellemeye yönelik stratejiler olsa da, veritabanı uygulamanızın çok önemli bir parçasıysa, bazen bir
bağlantı hatasını düzgün biçimde gidemenin kolay bir yolu vardır.
Çoğu bağlantı hatası, çalışma zamanının işletim sistemiyle, dosya sistemiyle ve veritabanı dosyasıyla iletişim kurma
biçimiyle ilgilidir. Örneğin, kullanıcının dosya sistemindeki belirli bir konumda veritabanı dosyası oluşturmak için
izni yoksa, bir bağlantı hatası oluşur. Aşağıdaki stratejiler, bağlantı hatalarını engellemeye yardımcı olur:
Kullanıcıya özgü veritabanı dosyaları kullanın Tek bir bilgisayardaki uygulamayı kullanan tüm kullanıcılar için tek bir
veritabanı dosyası kullanmak yerine, her kullanıcıya kendi veritabanı dosyasını verin. Dosya, kullanıcının hesabıyla
ilişkilendirilmiş bir dizinde konumlandırılmalıdır. Bu örneğin, uygulama depo dizini, kullanıcının belgeler klasörü,
kullanıcının masaüstü, vb. olabilir.
Farklı kullanıcı türlerini dikkate alın Uyulamanızı farklı işletim sistemlerinde farklı kullanıcı hesabı türleriyle test edin.
Kullanıcının bilgisayarda yönetici iznine sahip olduğunu varsaymayın. Ayrıca, uygulamayı yükleyen kişinin,
uygulamayı çalıştıran kullanıcı olduğunu varsaymayın.
Farklı dosya konumlarını dikkate alın Kullanıcının bir veritabanı dosyasını nereye kaydedeceğini veya açacağı
dosyanın yerini belirlemesine izin verirseniz, kullanıcının kullanabileceği olası farklı dosya konumlarını dikkate alın.
Ayrıca, kullanıcının veritabanı dosyalarını saklayacağı (veya açacağı) konumlara ilişkin sınırlar tanımlamayı düşünün.
Örneğin, kullanıcıların yalnızca kullanıcı hesabının depo konumunda yer alan dosyaları açmasına izin verebilirsiniz.
Bağlantı hatası oluşursa, büyük olasılıkla ilk veritabanı oluşturma veya açma girişimi sırasında gerçekleşir. Bu,
kullanıcının uygulamadaki herhangi bir veritabanı ilişkili işlemi yapamadığı anlamına gelir. Salt okunur veya izin
hataları gibi belirli hata türleri için, olası kurtarma tekniklerinden biri veritabanı dosyasını farklı bir konuma
kopyalamaktır. Uygulama veritabanı dosyasını kullanıcının dosya oluşturma ve yazma izninin olmadığı farklı bir
konuma kopyalayabilir ve bu konumu kullanabilir.
Sözdizim hataları
Bir SQL ifadesi yanlış biçimde oluşturulduğunda ve uygulama ifadeyi yürütmeye çalıştığında bir sözdizim hatası
oluşur. Yerel veritabanı SQL ifadeleri dizeler halinde oluşturulduğundan, derleme zamanı SQL sözdiziminin kontrol
edilmesi mümkün değildir. Sözdizimlerini kontrol etmek için, tüm SQL ifadeleri yürütülmelidir. SQL sözdizim
hatalarını önlemek için aşağıdaki stratejileri kullanın:
Tüm SQL ifadelerini test edin Uygulamanızı geliştirirken mümkünse SQL ifadelerinizi uygulama kodunda ifade metni
olarak kodlamadan önce ayrıca test edin. Ayrıca, tüm olası seçenekleri ve koddaki değişimi deneyen bir dizi test
oluşturmak için birim testi gibi bir kod testi yaklaşımını kullanın.
İfade parametrelerini kullanın ve SQL'i bitiştirmekten (dinamik olarak oluşturmaktan) kaçının Parametre kullanmak
ve dinamik olarak oluşturulan SQL ifadelerinden kaçınmak, bir ifade her yürütüldüğünde aynı SQL ifade metninin
kullanılması anlamına gelir. Sonuç olarak, ifadelerinizi test etmeniz ve olası değişimleri sınırlamanız çok daha
kolaydır. Bir SQL ifadesini dinamik olarak oluşturmanız gerekiyorsa, ifadenin dinamik bölümlerini minimum
düzeyde tutun. Ayrıca, sözdizim hatalarına neden olmayacağından emin olmak için, her kullanıcı girdisini dikkatlice
doğrulayın.
Uygulamanın, bir sözdizim hatasını kurtarmak için bir SQL ifadesini incelemek ve sözdizimini düzeltmek üzere
karmaşık mantığa ihtiyacı olacaktır. Kodunuz, sözdizim hatalarını önlemek için yukarıda belirtilen yönergeleri takip
ederek herhangi bir olası SQL sözdizim hatası çalışma zamanı kaynağını tanımlayabilir (bir ifadede kullanılan
kullanıcı girişi gibi). Sözdizim hatalarının kurtarılması için kullanıcıya yol gösterin. İfadenin düzgün biçimde
yürütülmesi için neyin düzeltilmesi gerektiğini gösterin
Sınırlama hataları
Bir INSERT veya UPDATE ifadesi bir sütuna veri eklemeye çalıştığında sınırlama hataları oluşur. Yeni veriler tablo veya
sütun için tanımlanan sınırlamalardan birini ihlal ediyorsa hata oluşur. Olası sınırlamalar kümesi şunları içerir:
Benzersiz sınırlama Bir tablodaki satırlar arasında, bir sütunda çift değer olamayacağını gösterir. Alternatif olarak,
birden çok sütun benzersiz bir sınırlamada birleştirildiğinde, bu sütunlardaki değerlerin bileşimi çift olamaz. Diğer bir
deyişle, belirtilen benzersiz sütun veya sütunlar bakımından, her satır farklı olmalıdır.
Ana anahtar sınırlaması Bir sınırlamanın izin verdiği ve vermediği veriler bakımından, ana anahtar sınırlaması
benzersiz sınırlamayla aynıdır.
Null sınırlaması Tek bir sütunun NULL değerini saklayamayacağını ve sonuç olarak her satırda bu sütunun bir değere
sahip olması gerektiğini belirtir.
Denetim sınırlaması Bir veya birden çok tablo için rasgele bir sınırlama belirtmenize olanak verir. Yaygın bir denetim
sınırlaması, bir sütunun değerinin belirli sınırlar içinde olması gerektiğini tanımlayan bir kuraldır (örneğin, sayısal bir
sütunun değeri 0'dan büyük olmalıdır). Diğer bir yaygın denetim sınırlaması türü, sütun değerleri arasındaki ilişkileri
belirtir (örneğin, bir sütunun değeri aynı satırdaki diğer sütunların değerinden farklı olmalıdır).
Veri türü (sütun yakınlığı) sınırlaması Çalışma zamanı, sütun değerleri için bir veri türü belirler ve bir sütunda yanlış
türde bir değeri saklama girişiminde bulunulduğunda hata oluşur. Ancak, çoğu durumda değerler sütunun belirtilen
veri türüyle eşleşecek biçimde dönüştürülür. Daha fazla bilgi için bkz. “Veritabanı veri türleriyle çalışma” sayfa 181
Çalışma zamanı, yabancı anahtar değerleri üzerinde sınırlama uygulamaz. Başka bir deyişle, yabancı anahtar
değerlerinin var olan bir ana anahtar değeriyle eşleşmesi gerekmez.
Önceden tanımlı sınırlama türlerinin yanı sıra, çalışma zamanı SQL motoru, tetikleyicilerin kullanımını destekler. Bir
tetikleyici, bir olay işleyiciye benzer. Belirli bir eylem gerçekleştiğinde yürütülen, önceden tanımlı bir talimatlar
kümesidir. Örneğin, bir tetikleyici belirli bir tabloya veri eklendiğinde veya bu tablodan veri silindiğinde çalışacak
biçimde tanımlanabilir. Olası bir tetikleyici kullanımı, tetikleyicinin veri değişikliklerini incelemesi ve belirlenen
koşullar karşılanmıyorsa bir hataya neden olmasıdır. Sonuç olarak tetikleyici, sınırlamayla aynı amaca hizmet edebilir
ve sınırlama hatalarının önlenmesi ve kurtarılmasına ilişkin stratejiler tetikletici tarafından oluşturulan hatalar için de
geçerlidir. Ancak, tetikleyici tarafından oluşturulan hatalara ilişkin hata kimliği, sınırlama hatalarına ilişkin hata
kimliğinden farklıdır.
Belirli bir tabloya uygulanan sınırlama kimesi, uygulamanızı tasarladığınız sırada belirlenir. Sınırlamaların bilinçli
şekilde tasarlanması, uygulamanızı sınırlama hatalarının önlenmesi ve kurtarılmasına yönelik tasarlamanızı
kolaylaştırır. Ancak, sınırlama hatalarının sistematik olarak tahmin edilmesi ve önlenmesi zordur. Sınırlama hataları
uygulama verileri eklenene kadar görünmediğinden, tahmin etmek zordur. Sınırlama hataları, oluşturulduktan sonra
veritabanına eklenen verilerle oluşur. Bu hatalar genellikle yeni veriler ve veritabanında önceden bulunan veriler
arasındaki ilişkinin bir sonucudur. Aşağıdaki stratejiler, birçok sınırlama hatasının önlenmesine yardımcı olur:
Veritabanı yapısını ve sınırlamaları dikkatlice planlayın Sınırlamaların amacı uygulama kuralları koymak ve
veritabanı verilerinin bütünlüğünü korumaya yardımcı olmaktır. Uygulamanızı planlarken, veritabanınızı
uygulamanızı desteklemesi açısından nasıl yapılandırmanız gerektiğini düşünün. Bu işlemin bir parçası olarak,
verilerinize ilişkin belirli değerlerin gerekli olup olmadığı, bir değerin varsayılanı olup olmadığı, çift değerlerin izinli
olup olmadığı, vb. kuralları tanımlayın. Bu kurallar, veritabanı sınırlamalarını tanımlamanızda size rehberlik eder.
Sütun adlarını açıkça belirtin INSERT ifadesi, değerlerin ekleneceği sütunları açık biçimde belirtmeden yazılabilir,
ancak böyle yapmak, gerekli olmayan bir risktir. Değerlerin ekleneceği sütunları açık biçimde adlandırarak otomatik
olarak oluşturulan değerlere, varsayılan değerler içeren sütunlara ve NULL değerlerine izin veren sütunlara olanak
tanıyabilirsiniz. Ayrıca, bunu yaparak tüm NOT NULL sütunlarına açık biçimde bir değerin eklenmesini garanti
edebilirsiniz.
Varsayılan değerler kullanın Bir sütun için NOT NULL sınırlamasını belirlediğinizde, mümkünse sütun tanımında
varsayılan bir değer belirleyin. Uygulama kodu da varsayılan değerler sağlayabilir. Örneğin, kodunuz bir String
değişkeninin null olup olmadığını kontrol edebilir ve bir ifade parametre değeri ayarlamak için kullanmadan önce bu
değişkene bir değer atayabilir.
Kullanıcı tarafından girilen verileri doğrulayın Özellikle NOT NULL ve CHECK sınırlamalarının olduğu durumlarda
kullanıcı tarafından girilen verilerin sınırlamalar tarafından belirtilen sınırlara uyduğundan emin olmak için bu
verileri önceden kontrol edin. Doğal olarak, bir UNIQUE sabitinin kontrol edilmesi daha zordur, çünkü bu kontrol
verilerin benzersiz olup olmadığını belirlemek için bir SELECT sorgusunun yürütülmesini gerektirir.
Tetikleyiciler kullanın Eklenen verileri doğrulayan (ve değiştirebilen) veya geçersiz verileri düzeltmek için diğer
eylemleri gerçekleştiren bir tetikleyici yazabilirsiniz. Bu doğrulama ve düzeltme, bir sınırlama hatasının oluşmasını
önleyebilir.
Sınırlama hatalarının engellenmesi, birçok bakımdan diğer türdeki hataların engellenmesinden daha zordur. Yine de,
uygulamayı istikrarsız ve kullanılamaz bir duruma getirmeden bu hataları kurtarmaya yönelik birkaç strateji vardır:
Çakışma algoritmaları kullanın Bir sütunda sınırlama tanımladığınızda ve bir INSERT veya UPDATE ifadesi
oluşturduğunuzda, bir çakışma algoritması belirleme seçeneğine sahip olursunuz. Çakışma algoritması, bir sınırlama
ihlali gerçekleştiğinde veritabanının yapacağı eylemi tanımlar. Veritabanı motorunun gerçekleştirebileceği birkaç olası
eylem vardır. Veritabanı motoru tek bir ifadeyi veya tüm işlemi sonlandırabilir. Hatayı yoksayabilir. Eski verileri
kaldırıp bunları kodun saklamaya çalıştığı verilerle değiştirebilir.
Daha fazla bilgi için ActionScript 3.0 Dil ve Bileşenler Başvurusu adresinde yer alan “Yerel veritabanlarında SQL
desteği” ekindeki “ON CONFLICT (çakışma algoritmaları)” bölümüne bakın.
Düzeltici geribildirim sağlayın Belirli bir SQL komutunu etkileyebilecek sınırlamalar kümesi önceden tanımlanabilir.
Sonuç olarak, bir ifadenin neden olabileceği sınırlama hatalarını tahmin edebilirsiniz. Bu bilgiyle, bir sınırlama
hatasına yanıt vermek için uygulama mantığı oluşturabilirsiniz. Örneğin, bir uygulamanın yeni ürünlerin girişi için bir
veri giriş formu içerdiğini varsayın. Veritabanındaki ürün adı sütunu UNIQUE sınırlamasıyla tanımlanıyorsa,
veritabanına yeni bir ürün satırı ekleme eylemi bir sınırlama hatasına neden olabilir. Sonuç olarak, uygulama bir
sınırlama hatasını tahmin edecek biçimde tasarlanmıştır. Hata gerçekleştiğinde, uygulama kullanıcıyı belirtilen ürün
adının zaten kullanılmakta olduğunu göstererek ve farklı bir ürün adı seçmesini isteyerek kullanıcıyı uyarır. Olası
başka bir yanıt, kullanıcının aynı ada sahip diğer ürün hakkındaki bilgileri görüntülemesine izin vermektir.
Veritabanı veri türleriyle çalışma
Bir veritabanında tablo oluşturulduğunda, tablo oluşturmaya ilişkin SQL ifadesi tablodaki her sütun için yakınlığı veya
veri türünü tanımlar. Yakınlık bildirimleri göz ardı edilebilse de, sütun yakınlığını CREATE TABLE SQL ifadenizde açık
biçimde belirtmek iyi bir fikirdir.
Genel bir kural olarak, INSERT ifadesini kullanarak veritabanında sakladığınız her nesne, SELECT ifadesini
yürüttüğünüzde aynı veri türünün bir örneği olarak döndürülür. Ancak, alınan değerin veri türü, verinin saklandığı
veritabanı sütununun yakınlığına bağlı olarak değişik olabilir. Değer bir sütunda saklandığında, veri türü sütunun
yakınlığıyla eşleşmiyorsa, veritabanı değeri sütunun yakınlığıyla eşleşecek biçimde dönüştürmeye çalışır. Örneğin, bir
veritabanı sütunu için NUMERIC yakınlığı bildirildiyse, veritabanı verileri saklamadan önce girilen veriyi sayısal
saklama sınıfına (INTEGER veya REAL) dönüştürmeye çalışır. Veri dönüştürülemezse, veritabanı bir hata verir. Bu
kurala göre, “12345” Dizesi bir NUMERIC sütununa eklendiğinde, veritabanı bu dizeyi saklamadan önce otomatik
olarak 12345 tam sayı değerine dönüştürür. Veri bir SELECT ifadesi kullanılarak alındığında, değer bir Dize örneği
olarak değil, bir sayısal veri türü (örneğin Numara) örneği olarak döndürülür.
İstenmeyen veri türü dönüştürmesini önlemenin en iyi yolu iki kuralı takip etmektir. Öncelikle, her sütunu saklanması
hedeflenen veri türüyle eşleşecek yakınlıkla tanımlayın. Daha sonra, yalnızca veri türü tanımlanan yakınlıkla eşleşen
değerleri ekleyin. Bu kuralların takip edilmesi, iki fayda sağlar. Veri eklediğinizde, veriler beklenmedik şekilde (büyük
olasılıkla sonuç olarak hedeflenen anlamını kaybedecek biçimde) dönüştürülmez. Ayrıca, verileri almak istediğinizde,
veriler orijinal veri türünde döndürülür.
Kullanılabilir sütun yakınlığı türleri ve SQL ifadelerinde veri türlerini kullanma hakkında daha fazla bilgi için
ActionScript 3.0 Dil ve Bileşenler Başvurusu adresindeki “Yerel veritabanlarında SQL desteği” ekinde yer alan “Veri
türü desteği” bölümüne bakın.
Senkronize ve senkronize olmayan veritabanı
işlemlerini kullanma
Önceki bölümler verilerin alınması, eklenmesi, güncellenmesi ve silinmesi gibi yaygın veritabanı işlemlerinin yanı sıra,
bir veritabanı içinde veritabanı dosyası, tablolar ve diğer nesnelerin oluşturulmasını açıkladı. Örnekler bu işlemlerin
senkronize olmayan ve senkronize biçimlerde nasıl gerçekleştirileceğini gösterdi.
Anımsatıcı olarak, senkronize olmayan yürütme modunda veritabanı motoruna bir işlem gerçekleştirmesini
bildirirsiniz. Daha sonra, uygulama çalışmaya devam ederken veritabanı motoru arka planda çalışır. İşlem
tamamlandığında, veritabanı motoru sizi bu konuda uyarmak için bir olay gönderir. Senkronize olmayan yürütmenin
temel faydası, ana uygulama kodu yürütülmeye devam ederken çalışma zamanının veritabanı işlemlerini arka planda
gerçekleştirmesidir. Bu özellikle, bir işlem önemli ölçüde zaman alıyorsa değerli bir faydadır.
Diğer taraftan, senkronize yürütme modu işlemleri arka planda çalışmaz. Veritabanı motoruna bir işlem
gerçekleştirmesini söylersiniz. Veritabanı motoru işini yaparken, kod bu noktada duraklar. İşlem tamamlandığında,
yürütme sonraki kod satırıyla devam eder.
Tek bir veritabanı bağlantısı, bazı işlemler ve ifadeleri senkronize, diğerlerini senkronize olmayan biçimde yürütemez.
Veritabanı bağlantısını açtığınızda, bir SQLConnection bağlantısının senkronize veya senkronize olmayan modda
çalıştığını belirtmelisiniz SQLConnection.open() yöntemini çağırırsanız, bağlantı senkronize yürütme modunda,
SQLConnection.openAsync() yöntemini çağırırsanız senkronize olmayan yürütme modunda çalışır.
SQLConnection örneği open() veya openAsync() kullanarak bir veritabanına bağlandığında, senkronize veya
senkronize olmayan yürütmeye sabitlenir.
Senkronize veritabanı işlemlerini kullanma
Senkronize yürütmeyi kullanırken işlemleri yürütmek ve yanıtlamak için kullandığınız geçerli kodla, senkronize
olmayan yürütme modunda kullandığınız kod arasında çok az fark vardır. İki yaklaşım arasındaki temel farklar iki
alanda incelenebilir. Birincisi, başka bir işleme bağlı olan bir işlem yürütmektir (SELECT sonuç satırları veya bir
INSERT ifadesi tarafından eklenen satırın ana anahtarı gibi). İkinci fark alanı, hataların işlenmesidir.
Senkronize işlemler için kod yazma
Senkronize ve senkronize olmayan işlemler arasındaki temel fark, senkronize modda kodun tek bir adım serisi olarak
yazılmasıdır. Senkronize olmayan kodda ise, olay dinleyicileri kaydeder ve işlemleri genellikle dinleyici yöntemleri
arasında bölümlersiniz. Senkronize yürütme modunda bir veritabanına bağlı olduğunuzda, tek bir kod bloku içinde
ardarda bir veritabanı işlemleri serisi yürütebilirsiniz. Aşağıdaki örnek bu tekniği gösterir:
// open the database
conn.open(dbFile, OpenMode.UPDATE);
// start a transaction
conn.begin();
// add the customer record to the database
var insertCustomer:SQLStatement = new SQLStatement();
insertCustomer.sqlConnection = conn;
insertCustomer.text =
"INSERT INTO customers (firstName, lastName) " +
"VALUES ('Bob', 'Jones')";
insertCustomer.execute();
var customerId:Number = insertCustomer.getResult().lastInsertRowID;
// add a related phone number record for the customer
var insertPhoneNumber:SQLStatement = new SQLStatement();
insertPhoneNumber.sqlConnection = conn;
insertPhoneNumber.text =
"INSERT INTO customerPhoneNumbers (customerId, number) " +
"VALUES (:customerId, '800-555-1234')";
insertPhoneNumber.parameters[":customerId"] = customerId;
insertPhoneNumber.execute();
// commit the transaction
conn.commit();
Gördüğünüz gibi, senkronize veya senkronize olmayan yürütme kullandığınızda veritabanı işlemlerini
gerçekleştirmek için aynı yöntemleri çağırırsınız. İki yaklaşım arasındaki temel fark, başka bir işleme bağlı olan bir
işlem yürütmek ve hataların işlenmesidir.
Başka bir işleme bağlı olan bir işlem yürütme
Senkronize yürütme modunu kullandığınızda, işlemin tamamlandığını belirlemek için bir olayı dinleyen kod
yazmanız gerekmez. Bunun yerine, bir kod satırındaki işlem başarıyla tamamlandığında yürütmenün bir sonraki kod
satırıyla devam ettiğini varsayabilirsiniz. Sonuç olarak, başka bir işlemin başarısına bağlı olan bir işlemi
gerçekleştirmek için, yalnızca bağlı olduğu işlemin hemen arkasından gelen bağımlı kodu yazmalısınız. Örneğin, bir
uygulamayı bir işlem başlatmak üzere kodlamak için INSERT ifadesini yürütün, eklenen satırın ana anahtarını alın, bu
ana anahtarı farklı bir tablodaki başla bir satıra ekleyin ve son olarak işlemi tamamlayın, kod bir ifadeler serisi olarak
yazılabilir. Aşağıdaki örnek bu işlemleri gösterir:
conn.begin();
"INSERT INTO customers (firstName, lastName) " +
"INSERT INTO customerPhoneNumbers (customerId, number) " +
// commit the transaction
conn.commit();
Hataları senkronize yürütme ile işleme
Senkronize yürütme modunda, bir işlemin başarısız olduğunu belirlemeniz için herhangi bir hata olayını dinlemeniz
gerekmez. Bunun yerine, bir try..catch.. finally kod blokları serisinde hataları tetikleyebilecek olan herhangi bir
kodu sararsınız. Try blokunda hata veren kodu sararsınız. Ayrı catch bloklarındaki her hata türüne yanıt olarak
gerçekleştirilecek eylemleri yazın. Başarı veya hatadan bağımsız olarak her zaman yürütülmesini istediğiniz herhangi
bir kodu (örneğin, artık gerek duyulmayan bir veritabanı bağlantısını kapatma) bir finally blokuna yerleştirin.
Aşağıdaki örnek hata işleme için try..catch.. finally bloklarının kullanımını gösterir. Önceki örneği hata işleme
kodu ekleyerek devam ettirir:
conn.begin();
try
{
"INSERT INTO customers (firstName, lastName)" +
"INSERT INTO customerPhoneNumbers (customerId, number)" +
// if we've gotten to this point without errors, commit the transaction
conn.commit();
}
{
// rollback the transaction
conn.rollback();
}
Senkronize olmayan yürütme modelini anlama
Senkronize olmayan yürütme modunun kullanımına ilişkin yaygın bir kaygı, aynı veritabanı bağlantısına karşı başka
bir SQLStatement yürütülmekteyse, bir SQLStatement örneğini başlatamayacak olmanıza dair varsayımdır. Gerçekte,
bu varsayım doğru değildir. SQLStatement örneği yürütülürken ifadenin text özelliğini değiştiremezsiniz. Ancak,
yürütmek istediğiniz her farklı SQLStatement örneği için ayrı bir SQLStatement örneği kullanırsanız, başka bir
SQLStatement örneği hala yürütülüyorken hataya neden olmadan execute() yöntemini çağırabilirsiniz.
Dahili olarak senkronize olmayan yürütme modunu kullanarak veritabanı işlemleri yürüttüğünüzde, her veritabanı
bağlantısı (her SQLConnection örneği) gerçekleştirmesini söylediğiniz kendi işlem kuyruğu veya listesine sahiptir.
Çalışma zamanı her işlemi kuyruğa eklendikleri sırayla yürütür. Bir SQLStatement örneği oluşturduğunuzda ve bu
örneğin execute() yöntemini çağırdığınızda, ifade yürütme işlemi bağlantı için kuyruğa eklenir. Bu SQLConnection
örneğinde o anda yürütülen bir işlem yoksa, ifade arka planda yürütülmeye başlar. Kodla aynı blok içinde başka bir
SQLStatement örneği oluşturduğunuzu ve bu yöntemin execute() yöntemini de çağırdığınızı varsayın. Bu ikinci
ifade yürütme işlemi, kuyrukta ilk ifadenin arkasına eklenir. İlk ifadenin yürütülmesi tamamlanır tamamlanmaz,
çalışma zamanı kuyruktaki bir sonraki işleme geçer. Ana uygulama kodunda ilk işleme ilişkin result olayının
gönderildiği sırada bile, kuyrukta yer alan sonraki işlemlerin yürütülmesi arka planda devam eder. Aşağıdaki kod bu
tekniği gösterir:
// Using asynchronous execution mode
var stmt1:SQLStatement = new SQLStatement();
stmt1.sqlConnection = conn;
// ... Set statement text and parameters, and register event listeners ...
stmt1.execute();
// At this point stmt1's execute() operation is added to conn's execution queue.
var stmt2:SQLStatement = new SQLStatement();
stmt2.sqlConnection = conn;
// ... Set statement text and parameters, and register event listeners ...
stmt2.execute();
// At this point stmt2's execute() operation is added to conn's execution queue.
// When stmt1 finishes executing, stmt2 will immediately begin executing
// in the background.
Ardarda kuyruğa alınan ifadeleri otomatik olarak yürüten veritabanının önemli bir yan etkisi vardır. Bir ifade başka
bir işlemin sonucuna bağlıysa, ilk işlem tamamlanana kadar bu ifadeyi kuyruğa ekleyemezsiniz (başka bir deyişle, bu
ifadenin execute() yöntemini çağıramazsınız). Çünkü ikinci ifadenin execute() yöntemini bir kez çağırdığınızda,
ifadenin text veya parameters özelliklerini değiştiremezsiniz. Bu durumda sonraki işlemi başlatmak için, ilk işlemin
tamamlandığını gösteren olayı beklemeniz gerekir. Örneğin, bir işlem bağlamında bir ifade yürütmek istiyorsanız,
ifadenin yürütülmesi bu işlemi açmaya ilişkin işleme bağlıdır. İşlemi açmak için SQLConnection.begin() yöntemini
çağırdıktan sonra SQLConnection örneğinin begin olayını göndermesini beklemeniz gerekir. Daha sonra
SQLStatement örneğinin execute() yöntemini çağırabilirsiniz. Bu örnekte uygulamayı işlemlerin düzgün biçimde
yürütülmesini sağlayacak biçimde düzenlemenin en basit yolu, begin olayı için dinleyici olarak kaydedilen bir yöntem
oluşturmaktır. SQLStatement.execute() yöntemini çağıracak kod, bu dinleyici yönteminin içine yerleştirilir.
SQL veritabanlarıyla çalışmak için stratejiler
Bir uygulamanın yerel SQL veritabanlarına erişmesi ve bu veritabanlarıyla çalışmasının çeşitli yolları vardır. Uygulama
tasarımı, uygulama kodunun düzenlenme biçimi, işlemlerin gerçekleştirilme sırası ve zamanlaması, vb. gibi konularda
farklılaşır. Seçtiğiniz teknikler, uygulamanızı geliştirmenin kolaylığı üzerinde etkili olabilir. Bu teknikler, uygulamayı
gelecekteki güncellemelerde değiştirmenin kolaylığını etkileyebilir. Uygulamanın kullanıcının bakış açısına göre ne
kadar iyi çalıştığı da bu tekniklere göre değişebilir.
Önceden doldurulmuş bir veritabanını dağıtma
Uygulamanızda bir AIR yerel SQL veritabanı kullandığınızda, uygulama tablolar, sütunlar, vb. içeren belirli bir yapıya
sahip bir veritabanı bekler. Bazı uygulamalar veritabanı dosyasının önceden veriyle doldurulmuş olmasını da bekler.
Veritabanının uygun bir yapıya sahip olmasını sağlamanın bir yolu veritabanını uygulama kodunda oluşturmaktır.
Uygulama yüklendiğinde, belirli bir konumdaki veritabanı dosyasının varlığını kontrol eder. Dosya mevcut değilse,
uygulama veritabanı dosyasını ve veritabanı yapısını oluşturmak, tabloları başlangıç verileriyle doldurmak için bir dizi
komut yürütür.
Veritabanını ve veritabanı tablolarını oluşturan kod genellikle karmaşıktır. Bu kod, uygulamanın yüklenen kullanım
ömründe genellikle yalnızca bir defa kullanılır, ancak yine de uygulamanın boyutuna ve karmaşıklığına katkıda
bulunur. Veritabanını, yapıyı ve verileri programlama yoluyla oluşturmaya alternatif olarak, uygulamanızla birlikte
önceden doldurulmuş bir veritabanını dağıtabilirsiniz. Önceden doldurulmuş bir veritabanı dağıtmak için, veritabanı
dosyasını uygulamanın AIR paketine dahil edin.
AIR paketinde bulunan tüm dosyalar gibi, paketlenmiş bir veritabanı dosyası uygulama dizinine yüklenir
(File.applicationDirectory özelliğiyle temsil edilen dizin). Ancak, bu dizindeki dosyalar salt okunur dosyalardır.
AIR paketindeki dosyayı bir “şablon” veritabanı olarak kullanın. Kullanıcı uygulamayı ilk kez çalıştırdığında, orijinal
veritabanı dosyasını kullanıcının depo dizinine (veya başka bir konuma) kopyalayın ve uygulamada bu veritabanını
kullanın.
Veritabanı performansını iyileştirme
Adobe AIR'de yerleşik olan çeşitli teknikler, uygulamanızda veritabanı işlemlerinin performansını iyileştirmenize
olanak verir.
Burada açıklanan tekniklerin yanı sıra, bir SQL ifadesinin yazılış biçimi de veritabanı performansını etkileyebilir.
Belirli bir sonuç kümesi elde etmek amacıyla bir SQL SELECT ifadesi yazmanın genellikle birden çok yolu vardır. Bazı
durumlarda, farklı yaklaşımlar veritabanı motorunun daha çok veya daha az çalışmasını gerektirir. Veritabanı
performansını iyileştirmenin bu yönüne—daha iyi veritabanı performansına yönelik SQL ifadeleri tasarlama—Adobe
AIR belgelerinde değinilmemiştir.
Her SQL ifadesi için bir SQLStatement örneği kullanın
Bir SQL ifadesi yürütülmeden önce, çalışma zamanı ifadenin yürütülmesi için dahili olarak gerçekleştirilecek adımları
belirlemek üzere ifadeyi hazırlar (derler). Daha önce yürütülmemiş olan bir SQLStatement örneğinde
SQLStatement.execute() yöntemini çağırdığınızda, ifade yürütülmeden önce otomatik olarak hazırlanır. Daha
sonraki execute() yöntemi çağrılarında, SQLStatement.text özelliği değişmediği sürece, ifade hala hazır
durumdadır. Sonuç olarak, ifade daha hızlı yürütülür.
İfadelerin yeniden kullanılmasından maksimum fayda sağlamak için, ifade yürütmeleri arasında değerlerin değişmesi
gerekiyorsa, ifadenizi özelleştirmek için ifade parametrelerini kullanın. (İfade parametreleri,
SQLStatement.parameters ilişkilendirici dizi özelliği kullanılarak belirtilir.) SQLStatement örneğinin text
özelliğinin aksine, ifade parametrelerinin değerlerini değiştirdiğinizde, çalışma zamanının ifadeyi yeniden hazırlaması
gerekmez. İfadelerde parametre kullanma hakkında daha fazla bilgi için bkz. “İfadelerde parametreler kullanma”
sayfa 167.
Bir ifadenin hazırlanması ve yürütülmesi çaba gerektiren bir işlem olduğundan başlangıç verilerini önceden yüklemek
ve daha sonra diğer ifadeleri arka planda yürütmek, iyi bir stratejidir. Önce uygulamanın gerektirdiği verileri yükleyin.
Uygulamanızın ilk başlangıç işlemleri tamamlandığında veya uygulamadaki başka bir “boş” zamanda diğer ifadeleri
yürütün. Örneğin, uygulamanız ilk ekranı görüntülemek için veritabanına erişmiyorsa, bu ekran görüntülenene kadar
bekleyin, daha sonra veritabanı bağlantısını açın ve son olarak SQLStatement örneklerini oluşturup
yürütebildiklerinizi yürütün. Alternatif olarak, uygulamanızın başlar başlamaz belirli bir sorgunun sonucu gibi bazı
verileri görüntülediğini varsayın. Bu durumda, devam edin ve bu sorguya ilişkin SQLStatement örneğini yürütün.
Başlangıç verileri yüklendikten ve görüntülendikten sonra, diğer veritabanı işlemleri için SQLStatement örneklerini
oluşturun ve mümkünse diğer gerekli ifadeleri daha sonra yürütün.
Bir SQLStatement örneğini bir kez hazırlandıktan sonra yeniden kullandığınızda, uygulamanız bu SQLStatement
örneğibe bir başvuru tutmalıdır. Örneğe ilişkin bir başvuru tutmak için, değişkeni işlem kapsamlı değil, sınıf kapsamlı
bir değişken olarak belirtin. Bunu yapmanın iyi bir yolu, uygulamanızı SQL ifadesinin tek bir sınıfta sarılacağı biçimde
yapılandırmaktır. Bileşim halinde yürütülen bir ifade grubu da tek bir sınıfta sarılabilir. SQLStatement örneği veya
örnekleri bu sınıfın üye değişkenleri olarak tanımlandığında, sarma sınıfı örneği uygulamada bulunduğu sürece, bu
örnekler de kalıcı olur. Minimum düzeyde, örneğin bellekte kalması için işlevin dışında yer alan bir SQLStatement
örneği içeren bir değişken tanımlayabilirsiniz. Örneğin, SQLStatement örneğini ActionScript sınıfında yer alan bir üye
değişkeni veya bir JavaScript dosyasında yer alan, işlev olmayan bir değişken olarak belirleyin. Daha sonra, sorguyu
gerçekten yürütmek istediğinizde ifadenin parametre değerlerini ayarlayabilir ve execute() yöntemini
çağırabilirsiniz.
Birden çok işlemi bir işlemde gruplayın
Veri ekleme ve değiştirmeyi içeren çok sayıda SQL ifadesi yürüttüğünüzü varsayın (INSERT veya UPDATE ifadeleri).
Tüm ifadeleri açık bir işlem içinde yürüterek performansta önemli bir artış sağlayabilirsiniz. Açık olarak bir işlem
başlatmazsanız, ifadelerden her biri kendisine ait otomatik olarak oluşturulmuş işlemlerde çalışır. Her işlemin (her
ifadenin) yürütülmesi tamamlandığında, çalışma zamanı elde edilen verileri diskteki veritabanı dosyasına yazar. Diğer
taraftan, açık olarak bir işlem oluşturur ve ifadeleri bu işlem bağlamında yürütürseniz ne olacağını düşünün. Çalışma
zamanı bellekteki tüm değişiklikleri yapar, daha sonra işlem gerçekleştiğinde tüm değişiklikleri bir defada veritabanı
dosyasına yazar. Verilerin diske yazılması genellikle işlemin en zaman yoğunluklu bölümüdür. Sonuç olarak, her SQL
ifadesi için bir kez diske yazmak yerine bir defada yazmak, performansı önemli ölçüde artırabilir.
Çalışma zamanı işlemesini en aza indirin
Aşağıdaki tekniklerin kullanılması, veritabanı motoru tarafında gereksiz işlerin yapılmasını önler ve uygulamaların
daha yüksek performansla çalışmasını sağlar:
• İfadedeki tablo adlarının yanı sıra, veritabanı adlarını da her zaman açıkça belirtin. (Ana veritabanıysa “ana”
sözcüğünü kullanın). Örneğin, SELECT employeeId FROM main ifadesini kullanın.SELECT employeeId FROM
employees yerine employees. Veritabanı adının açıkça belirtilmesi, çalışma zamanının eşleşen tabloyu bulmak
için her veritabanını kontrol etmesini önler. Ayrıca çalışma zamanının yanlış veritabanını seçme olasılığını da
engeller. Bir SQLConnection yalnızca tek bir veritabanına bağlandığında bile bu kuralı uygulayın, çünkü
SQLConnection perde arkasında SQL ifadeleri aracılığıyla erişilebilen geçici bir veritabanına daha bağlıdır.
• Sütun adlarını her zaman SELECT or INSERT ifadesinde açıkça belirtin.
• Çok sayıda satır alan bir SELECT ifadesinin döndürdüğü satırları bölümleyin: bkz. “SELECT sonuçlarını bölümler
halinde alma” sayfa 173.
Şema değişikliklerinden kaçının
Veritabanı tablolarına veri ekledikten sonra mümkünse veritabanı şemasını (tablo yapısını) değiştirmekten kaçının.
Bir veritabanı dosyası, normalde dosya başlangıcında bulunan tablo tanımlarıyla yapılandırılır. Bir veritabanına
bağlantı açtığınızda, çalışma zamanı bu tanımları yükler. Veritabanı tablolarına veri eklediğinizde, bu veriler dosyaya
tablo tanım verilerinin ardından eklenir. Ancak, tabloya sütun eklemek veya yeni bir tablo eklemek gibi şema
değişiklikleri yaparsanız, yeni tablo tanım verileri veritabanı dosyasındaki tablo verileriyle karışır. Tablo tanım
verilerinin tümü veritabanı dosyasının başlangıcında değilse, çalışma zamanı tablo tanım verilerini dosyanın farklı
bölümlerinden okuduğu için bir veritabanı bağlantısı açmak çok uzun zaman alabilir.
Şema değişiklikleri yapmanız gerekiyorsa SQLConnection.compact() yöntemini değişiklikleri tamamladıktan sonra
çağırabilirsiniz. Bu işlem veritabanı dosyasını tablo tanım bilgilerinin bütün olarak dosyanın başlangıcında yer alacağı
biçimde yeniden yapılandırır. Ancak, compact() işlemi, veritabanı büyüdükçe daha çok zaman alabilir.
Yerel SQL veritabanlarıyla çalışmak için en iyi uygulamalar
Aşağıdaki liste, yerel SQL veritabanlarıyla çalışırken performansı, güvenliği ve uygulama bakımınızın kolaylığını
artırmak için kullanabileceğiniz, önerilen tekniklerin kümesidir. Veritabanı uygulamalarını iyileştirmeye yönelik ek
teknikler için bkz. “Veritabanı performansını iyileştirme” sayfa 186.
Veritabanı bağlantılarını önceden oluşturun
Uygulamanız ilk yüklendiğinde herhangi bir ifade yürütmese bile, bir SQLConnection nesnesini başlatın ve ifade
çalıştırma sırasında gecikmeleri önlemek için önceden (örneğin ilk uygulama başlangıcından sonra) bu nesnenin
open() veya openAsync() yöntemini çağırın. Bkz. “Veritabanına bağlanma” sayfa 164.
Veritabanı bağlantılarını yeniden kullanma
Uygulamanızın yürütülmesi sırasında belirli bir veritabanına erişiyorsanız, SQLConnection örneğine ilişkin bir
başvuru tutun ve bağlantıyı kapatıp yeniden açmak yerine uygulama boyunca bu başvuruyu yeniden kullanın. Bkz.
“Veritabanına bağlanma” sayfa 164.
Senkronize olmayan yürütme modunu tercih edin
Veri erişim kodunu yazma sırasında işlemleri senkronize olarak yürütmek uygun görünebilir, çünkü senkronize
işlemleri kullanmak genellikle daha kısa ve daha az karmaşık kodlar gerektirir. Ancak, “Senkronize ve senkronize
olmayan veritabanı işlemlerini kullanma” sayfa 181 bölümünde açıklandığı gibi, senkronize işlemlerin performans
üzerinde kullanıcıların açıkça görebildiği, uygulamayı yavaşlatan bir etkisi vardır. Tek bir işlemin aldığı süre işleme ve
özellikle işlemin içerdiği veri miktarına göre değişir. Örneğin, veritabanına yalnızca bir satır ekleyen bir SQL INSERT
ifadesi, binlerce veri satırı alan bir SELECT ifadesinden çok daha az zaman alır. Ancak, birden çok işlemi
gerçekleştirmek için senkronize yürütmeyi kullandığınızda, işlemler genellikle yanyana dizilir. Tek bir işlemin aldığı
zaman çok kısa olsa bile, tüm senkronize işlem tamamlanana kadar uygulama donar. Sonuç olarak, yanyana dizilen
birden çok işlemin gerektirdiği birikimli süre, uygulamanızı durdurmak için yeterli olabilir.
Özellikle çok sayıda satır içeren işlemler için standart bir yaklaşım olan senkronize olmayan işlemleri kullanın.
“SELECT sonuçlarını bölümler halinde alma” sayfa 173 bölümünde anlatıldığı gibi, SELECT ifadesi sonuçları
işlemesinin bölümlenmesi için bir teknik mevcuttur. Ancak, bu teknik yalnızca senkronize olmayan yürütme
modunda kullanılabilir. Uygulamanızın kullanıcılarının karşılaşacağı performans dengelemelerini göz önüne
aldığınızda ve uygulamanızın performansının nasıl etkilendiğini göreceğiniz şekilde uygulamanızı test ettiğinizde,
senkronize işlemleri yalnızca belirli işlevlere senkronize olmayan programlamayla ulaşamadığınızda kullanmalısınız.
Senkronize olmayan yürütmenin kullanılması daha karmaşık kodlama içerebilir. Ancak, kodu yalnızca bir defa
yazmanız gerektiğini, ancak uygulama kullanıcılarının bu kodu hızlı veya yavaş biçimde defalarca kullanmak zorunda
olduklarını unutmayın.
Çoğu durumda, yürütülecek her SQL ifadesi için ayrı bir SQLStatement örneği kullanılarak, senkronize olmayan
kodun yazılma biçimi bakımından senkronize koda benzemesini sağlayacak şekilde, birden çok SQL işlemi bir defada
kuyruğa alınabilir. Daha fazla bilgi için bkz. “Senkronize olmayan yürütme modelini anlama” sayfa 184.
Ayrı SQL ifadeleri kullanın ve SQLStatement'ın text özelliğini değiştirmeyin.
Bir uygulamada bir defadan çok yürütülen bir SQL ifadesi için, her SQL ifadesine ilişkin ayrı bir SQLStatement örneği
oluşturun. SQLStatement örneğini SQL komutu her yürütüldüğünde kullanın. Örneğin, birçok defa gerçekleştirilecek
dört farklı SQL işlemi içeren bir uygulama oluşturduğunuzu varsayın. Bu durumda, dört ayrı SQLStatement örneği
oluşturun ve her ifadeyi yürütmek için bu ifadenin execute() yöntemini çağırın. Tüm SQL ifadeleri için tek bir
SQLStatement örneği kullanarak ifadenin her yürütülmesinden önce text özelliğini yeniden tanımlama
alternatifinden kaçının. Daha fazla bilgi için bkz. “Her SQL ifadesi için bir SQLStatement örneği kullanın” sayfa 186.
İfade parametreleri kullanın
SQLStatement parametreleri kullanın—kullanıcı girişini hiçbir zaman ifade metnine bitiştirmeyin. SQL yerleştirme
saldırıları olasılığını engellediğinden, parametre kullanmak uygulamanız için her zaman daha güvenlidir. Sorgularda
nesneleri kullanmayı (yalnızca SQL değişmez değerleri yerine) olanaklı kılar. Ayrıca, her yürütüldüklerinde yeniden
derlenmeleri gerekmeden yeniden kullanılabildiklerinden, ifadelerin daha verimli biçimde çalışmasını sağlar. Daha
fazla bilgi için bkz. “İfadelerde parametreler kullanma” sayfa 167.
Sütun ve parametre adları için sabitler kullanın.
SQLStatement için bir itemClass belirtmediğinizde, yazım hatalarını önlemek için tablonun sütun adlarını içeren
String sabitleri tanımlayın. Bu sabitleri sonuç nesnelerinden değerleri alırken özellik adları için ve ifade metinlerinde
kullanın. Sabitleri parametre adları için de kullanın.
189
Bölüm 19: Şifreli verileri saklama
Adobe® AIR™ çalışma zamanı, kullanıcının bilgisayarında yüklü olan her AIR uygulaması için kalıcı şifreli yerel bir
depo sağlar. Bu sayede, kullanıcının yerel sabit sürücüsünde, şifresi başka kullanıcılar veya uygulamalar kullanılarak
kolay bir şekilde çözülemeyecek olan şifreli bir formatta saklanan verileri kaydedebilir ve alabilirsiniz. Her AIR
uygulaması için ayrı bir şifreli yerel depo kullanılır ve her AIR uygulaması, her bir kullanıcı için ayrı bir şifreli yerel
depo kullanır.
Web hizmetleri için oturum açma kimlik bilgileri gibi güvenceye alınması gereken bilgileri saklamak için şifreli yerel
depoyu kullanmak isteyebilirsiniz.
AIR, şifreli yerel depoyu her uygulamayla ve kullanıcıyla ilişkilendirmek için Windows'ta DPAPI ve Mac OS'de
KeyChain kullanır. Şifreli yerel depo AES-CBC 128-bit şifreleme kullanır.
Şifreli yerel depodaki bilgiler yalnızca uygulama güvenliği sanal alanındaki AIR uygulama içeriği tarafından
kullanılabilir.
Yerel depodan veri saklamak ve almak için, EncryptedLocalStore sınıfının setItem() ve removeItem() statik
yöntemlerini kullanın. Veriler, verileri bayt dizileri olarak saklayan ve dizeleri anahtar olarak kullanan karma bir
tabloda saklanır.
Örneğin aşağıdaki kod bir dizeyi şifreli yerel depoda saklar:
var str:String = "Bob";
bytes.writeUTFBytes(str);
EncryptedLocalStore.setItem("firstName", bytes);
var storedValue:ByteArray = EncryptedLocalStore.getItem("firstName");
trace(storedValue.readUTFBytes(storedValue.length)); // "Bob"
setItem() yönteminin üçüncü parametresi olan stronglyBound isteğe bağlıdır. Bu parametre true olarak ayarlı
olduğunda, şu durumlarda, saklanan öğeyi yayıncı kimliğinin yanı sıra saklayan AIR uygulamasının dijital imzasına
ve bitlerine ciltleyen şifreli yerel depo, daha yüksek bir güvenlik düzeyi sağlar:
var str:String = "Bob";
bytes.writeUTFBytes(str);
EncryptedLocalStore.setItem("firstName", bytes, true);
stronglyBoundtrue olarak ayarlıyken saklanan bir öğe için, getItem() öğesine yapılan sonraki çağrılar yalnızca
çağıran AIR uygulaması saklayan uygulamayla aynıysa başarılı olur (uygulama dizininde bulunan dosyalardaki hiçbir
veri değiştirilmemişse). Çağıran AIR uygulaması saklayan uygulamadan farklıysa, güçlü şekilde bağlı bir öğe için
getItem() öğesini çağırdığınızda uygulama bir Hata istisnası atar. Uygulamanızı güncellerseniz, şifreli yerel depoya
önceden yazılmış olan güçlü şekilde bağlı verileri okuyamaz.
AIR uygulaması varsayılan olarak başka bir uygulamanın şifreli yerel deposunu okuyamaz. stronglyBoundayarı
fazladan bağlama (uygulama bitlerindeki verilere) sağlar, bu da saldırgan bir uygulamanın, uygulamanızın yayıncı
kimliğini çalmaya çalışarak uygulamanızın şifreli yerel deposundan okuma girişiminde bulunmasını engeller.
Bir uygulamayı farklı bir imzalayıcı sertifikası kullanacak şekilde güncellerseniz (bir geçiş imzası kullanarak),
stronglyBound parametresi false olarak ayarlı olsa bile, güncellenen sürüm orijinal depodaki öğelerin hiçbirine
erişemeyecektir. Daha fazla bilgi için bkz. “Sertifikaları değiştirme” sayfa 287.
Şifreli verileri saklama
EncryptedLocalStore.removeItem() yöntemini kullanarak, aşağıdaki örnekte olduğu gibi şifreli yerel depodan bir
değer silebilirsiniz:
EncryptedLocalStore.removeItem("firstName");
EncryptedLocalStore.reset() yöntemini çağırarak, aşağıdaki örnekte olduğu gibi şifreli yerel depodan tüm
verileri temizleyebilirsiniz:
EncryptedLocalStore.reset();
AIR Hata Ayıklama Başlatıcısı'nda (ADL) bir uygulamanın hatalarını ayıklarken, uygulama, uygulamanın yüklü
sürümünde kullanılandan farklı bir şifreli yerel depo kullanır.
Saklanılan verilerin boyutu 10MB'ı geçerse şifreli yerel depo yavaş çalışabilir.
Bir AIR uygulamasını kaldırdığınızda, kaldırma uygulaması şifreli yerel depoda saklanan verileri silmez.
Şifreli yerel depo verileri kullanıcının uygulama verileri dizininin alt dizinine konur; alt dizin yolu arkasından
uygulama kimliği gelmek üzere Adobe/AIR/ELS/ şeklindedir.
191
Bölüm 20: HTML ortamı hakkında
Adobe®AIR™, aynı zamanda Safari web tarayıcısı tarafından da HTML ve JavaScript içeriğini ayrıştırmak, düzenlemek
ve oluşturmak için kullanılan WebKit'i (www.webkit.org) kullanır. AIR API'lerinin HTML içeriğinde kullanımı isteğe
bağlıdır. Yalnızca HTML ve JavaScript ile, HTMLLoader nesnesinin veya HTML penceresinin içeriğinde
programlama yapabilirsiniz. Var olan birçok HTML sayfası ve uygulaması birkaç değişiklikle çalışmalarını
sürdürmelidir (WebKit ile uyumlu HTML, CSS, DOM ve JavaScript özellikleri kullandıklarını varsayarak).
AIR uygulamaları dosya sistemine tam erişimle doğrudan masaüstünde çalıştığı için, HTML içeriğinin güvenlik
modeli, tipik bir web tarayıcısının güvenlik modelinden daha katıdır. AIR'de, yalnızca uygulama yükleme dizininden
yüklenen veriler uygulama sanal alanına yerleştirilir. Uygulama sanal alanı en yüksek düzeyde ayrıcalığa sahiptir ve
AIR API'lerine erişim sağlar. AIR, nereden geldiğini temel alarak diğer içeriği ayrı sanal alanlara yerleştirir. Dosya
sisteminden yüklenen dosyalar yerel bir sanal alana gider. Ağdan http: veya https: protokolleri kullanılarak yüklenen
dosyalar, uzak sunucunun etki alanını temel alarak bir sanal alana gider. Bu uygulama dışı sanal alanlardaki içeriğin
herhangi bir AIR API'sine erişmesi yasaktır ve tipik bir web tarayıcısında olduğu gibi çalışır.
AIR, aynı zamanda Safari web tarayıcısı tarafından da HTML ve JavaScript içeriğini ayrıştırmak, düzenlemek ve
oluşturmak için kullanılan WebKit'i (www.webkit.org) kullanır. AIR yerleşik ana bilgisayar sınıfları ve nesneleri,
masaüstü uygulamalarıyla genelde ilişkilendirilen özelliklere yönelik bir API sağlar. Bu özellikler dosyaları okuma,
dosyalara yazma ve pencereleri yönetmeyi içerir. Adobe AIR ayrıca aralarında ses soketleri ve ikili soketler de bulunan
Adobe® Flash® Player'ın API'lerini miras alır.
Alfa, ölçekleme veya saydamlık ayarları uygulanırsa, AIR'deki HTML içeriği SWF veya PDF içeriğini görüntülemez.
Daha fazla bilgi için bkz. HTML sayfasında SWF veya PDF içeriğini yüklerken dikkate alınacak noktalarve “Pencere
şeffaflığı” sayfa 57.
HTML ortamına genel bakış
Adobe AIR, HTML oluşturucu, belge nesnesi modeli ve JavaScript yorumlayıcısıyla beraber eksiksiz bir tarayıcı
benzeri JavaScript ortamı sağlar. JavaScript ortamı, AIR HTMLLoader sınıfı tarafından temsil edilir. HTML
pencerelerinde, HTMLLoader nesnesi tüm HTML içeriğini kapsar ve bunun karşılığında NativeWindow nesnesinde
de bulunur. SWF içeriğinde Sprite sınıfını genişleten HTMLLoader sınıfı, diğer görüntüleme nesneleri gibi, bir
sahnenin görüntüleme listesine eklenebilir. Sınıfın ActionScript™ özellikleri, “HTML Kabı için Komut Dosyası
Oluşturma” sayfa 230 ve ayrıca Flex 3 ActionScript Dil Başvurusu bölümlerinde anlatılmaktadır.
JavaScript ortamı ve AIR ile ilişkisi hakkında
Aşağıdaki diyagram JavaScript ortamı ve AIR çalışma zamanı ortamı arasındaki ilişkiyi anlatmaktadır. Yalnızca tek bir
yerel pencere gösterilmesine rağmen, AIR uygulaması birden çok pencereyi içerebilir. (Ve tek bir pencere birden çok
HTMLLoader nesnesi içerebilir.)
HTML ortamı hakkında
AIR Run-time Environment
NativeWindow
HTMLLoader
window
JavaScript
Environment
window
window
body
head
htmlLoader
native4Window
runtime
h1
div
table
p
JavaScript ortamı kendi Document ve Window nesnelerine sahiptir. JavaScript kodu AIR çalışma zamanı ortamıyla etkileşime çalışma
zamanını, nativeWindow ve htmlLoader özelliklerini kullanarak geçebilir. ActionScript kodu JavaScript ortamıyla etkileşime, JavaScript
Window nesnesine bir başvuru olan HTMLLoader nesnesinin pencere özelliğini kullanarak geçebilir. Ayrıca hem ActionScript hem de
JavaScript nesneleri, AIR ve JavaScript nesnelerinin her ikisi tarafından da gönderilen olayları dinleyebilir.
runtime özelliği, AIR API sınıflarına erişim sağlar ve access sınıfı (statik de denir) üyelerinin yanı sıra, yeni AIR
nesneleri oluşturmanızı da sağlar. Bir AIR API'sine erişmek için, sınıfın adını paketle beraber runtime özelliğine
eklersiniz. Örneğin bir File nesnesi oluşturmak için, şu ifadeyi kullanırsınız:
var file = new window.runtime.filesystem.File();
Not: AIR SDK bir JavaScript dosyası sağlar, AIRAliases.js, bu dosya en yaygın kullanılan AIR sınıfları için daha
uygun başka adlar tanımlar. Bu dosyayı içe aktardıktan sonra, window.runtime.package.Class yerine daha kısa bir
biçim olan air.Class'ı kullanabilirsiniz. Örneğin File nesnesini new air.File() ile oluşturabilirsiniz.
NativeWindow nesnesi, masaüstü penceresini kontrol etmeye yönelik özellikler sağlar. Bir HTML sayfasından,
window.nativeWindow özelliğine sahip NativeWindow nesnesine erişebilirsiniz.
HTMLLoader nesnesi içeriğin nasıl yüklendiğine ve oluşturulduğuna dair özellikler, yöntemler ve olaylar sağlar. Bir
HTML sayfasından, window.htmlLoader özelliğine sahip üst HTMLLoader nesnesine erişebilirsiniz.
Önemli: Yalnızca bir uygulamanın parçası olan sayfalar üst düzey belge olarak yüklendiklerinde, htmlLoader,
nativeWindow veya runtime özelliklerine sahip olur. Bu özellikler belge bir kareye veya iframe'e yüklendiğinde
eklenmez. (Alt belge, aynı güvenlik sanal alanında olduğu sürece üst belgedeki bu özelliklere erişebilir. Örneğin bir kareye
yüklenmiş olan belge, üst öğesinin runtime özelliğine parent.runtime ile erişebilir.)
Güvenlik hakkında
AIR, kaynağın etki alanına dayalı olarak bir güvenlik sanal alanındaki tüm kodu çalıştırır. Uygulama yükleme
dizininden yüklenen içerikle sınırlı olan uygulama içeriği, uygulama sanal alanına yerleştirilir. Çalışma zamanı
ortamına ve AIR API'lerine erişim yalnızca bu sanal alanın içinden HTML ve JavaScript'in çalıştırılmasıyla
mümkündür. Aynı zamanda, load olayı sayfası için tüm işleyiciler geri döndükten sonra, en dinamik JavaScript
değerlendirmesi ve çalışması uygulama sanal alanında engellenir.
Bir uygulama sayfasını, sayfayı bir kareye veya iframe'e yükleyerek ve karenin AIR'e özgü sandboxRoot ve
documentRoot niteliklerini ayarlayarak uygulama olmayan sanal alana eşleyebilirsiniz. sandboxRoot değerini gerçek
bir uzak etki alanına ayarlayarak, bu alandaki içeriği çapraz komut dosyasına yazmak üzere sanal alana sahip içeriği
etkinleştirebilirsiniz. Sayfaları bu şekilde eşlemek, içerik birleştirme uygulamasında olduğu gibi uzak içeriği yüklerken
ve komut dosyasına yazarken yararlı olabilir.
Uygulama içeriğinin ve uygulama olmayan içeriğin birbirlerinin çapraz dosyasını oluşturmasını sağlamanın bir başka
yolu ve aynı zamanda AIR API'lerine uygulama olmayan içerik erişimi vermenin tek yolu, sanal alan köprüsü
oluşturmaktır. Üst-alt köprüsü bir alt karedeki, iframe'deki veya penceredeki içeriğin, uygulama sanal alanında
tanımlanan belirli yöntemlere ve özelliklere erişmesini sağlar. Tersine, alt-üst köprüsü, uygulama içeriğinin alt öğenin
sanal alanında tanımlanan belirli yöntemlere ve özelliklere erişmesini sağlar. Sanal alan köprüleri, window nesnesinin
parentSandboxBridge ve childSandboxBridge özellikleri ayarlanarak kurulur. Daha fazla bilgi için bkz. “HTML
güvenliği” sayfa 29 ve “HTML kare ve iframe öğeleri” sayfa 201.
Eklentiler ve gömülü nesneler hakkında
AIR, Adobe® Acrobat® eklentisini destekler. Kullanıcıların PDF içeriğini görüntülemek için Acrobat veya Adobe®
Reader® 8.1 (veya daha üst) sürümüne sahip olmaları gerekmektedir. HTMLLoader nesnesi, kullanıcı sisteminin
PDF'leri görüntüleyip görüntülemediğini kontrol etmeye yarayan bir özellik sağlar. SWF dosya içeriği HTML
ortamında da görüntülenebilir, ancak bu özellik AIR'de yerleşiktir ve harici bir eklenti kullanmaz.
Diğer Webkit eklentileri AIR'de desteklenmez.
Ayrıca bkz.
“HTML güvenliği” sayfa 29
“HTML Sanal Alanları” sayfa 194
“HTML kare ve iframe öğeleri” sayfa 201
“JavaScript Window nesnesi” sayfa 199
“XMLHttpRequest nesnesi” sayfa 195
“PDF içeriği ekleme” sayfa 244
AIR ve Webkit uzantıları
Adobe AIR, Safari web tarayıcısında da kullanılan açık kaynak Webkit motorunu kullanır. AIR, güvenlik nedenlerinin
yanı sıra, runtime sınıflarına ve nesnelerine erişim sağlamak için birçok uzantı eklemesi yapar. Ayrıca Webkit de
HTML, CSS ve JavaScript için W3C standartlarında bulunmayan özellikler ekler.
Burada yalnızca AIR eklemeleri ve en önemli Webkit uzantıları ele alınmaktadır; standart olmayan HTML, CSS ve
JavaScript ile ilgili ek belgeler için bkz. www.webkit.org ve developer.apple.com. Standart bilgiler için bkz. W3C
website. Mozilla ayrıca HTML, CSS ve DOM konularında önemli bir genel başvuru sağlar (elbette Webkit ve Mozilla
motorları aynı değildir).
Not: AIR şu standart ve genişletilmiş WebKit özelliklerini desteklemez: JavaScript Window nesnesi print() yöntemi;
Acrobat ve Adobe Reader 8.1+ dışındaki eklentiler; Ölçeklenebilir Vektör Grafikleri (SVG), CSS opacity özelliği.
AIR'de JavaScript
AIR, ortak JavaScript nesnelerinin tipik davranışında birçok değişiklik yapar. Bu değişikliklerin birçoğu AIR'de
güvenli uygulamaların yazılmasını kolaylaştırmak için yapılır. Aynı zamanda, davranıştaki bu farklılıklar, bazı ortak
JavaScript kodlama desenlerinin ve bu desenleri kullanan mevcut web uygulamalarının her zaman AIR'de beklendiği
gibi çalıştırılamayabileceği anlamına gelir. Bu tür sorunların düzeltilmesiyle ilgili bilgi için bkz. “Güvenlik ilişkili
JavaScript hatalarını önleme” sayfa 207.
HTML Sanal Alanları
AIR içeriği kaynağına bağlı olarak, ayrı sanal alanlara yerleştirir. Sanal alan kuralları, Adobe Flash Player tarafından
uygulanan sanal alan kurallarının yanı sıra, çoğu web tarayıcısı tarafından uygulanan aynı kaynak ilkesiyle tutarlıdır.
Ayrıca AIR, uygulama içeriğini dahil etmek ve korumak için yeni bir uygulama sanal alan türü sağlar. AIR
uygulamaları geliştirirken karşılaşabileceğiniz sanal alan türleriyle ilgili daha fazla bilgi için bkz. “Sanal alanlar”
sayfa 26.
Çalışma zamanı ortamına ve AIR API'lerine erişim yalnızca uygulama sanal alanının içinden HTML ve JavaScript'in
çalıştırılmasıyla mümkündür. Ancak aynı zamanda çeşitli biçimlerdeki dinamik JavaScript değerlendirmesi ve
çalışması, güvenlik nedenleriyle büyük ölçüde uygulama sanal alanıyla sınırlıdır. Bu kısıtlamalar, uygulamanız
doğrudan bir sunucudan bilgi yüklese de yüklemese de geçerlidir. (Hatta dosya içeriği, yapıştırılan dizeler ve doğrudan
kullanıcı girişi güvenilmez olabilir.)
Bir sayfadaki içeriğin kaynağı, gönderildiği sanal alanı belirler. Yalnızca uygulama dizininden yüklenen içerik (uyg.:
URL şeması tarafından başvurulan yükleme dizini) uygulama sanal alanına yerleştirilir. Dosya sisteminden yüklenen
içerik local-with-filesystem veya local-trusted sanal alana yerleştirilir, böylece yerel dosya sistemindeki içeriğe erişimine
ve bu içerikle etkileşimine izin verilir, ancak uzak içeriğe erişimine veya uzak içerikle etkileşimine izin verilmez. Ağdan
yüklenen içerik, kaynak etki alanına karşılık gelen uzak bir sanal alana yerleştirilir.
Bir uygulama sayfasının uzak sanal alandaki içerikle serbestçe etkileşmesini sağlamak için, sayfa, uzak içerikle aynı etki
alanına eşlenebilir. Örneğin bir Internet hizmetinden eşleme verileri görüntüleyen bir uygulama yazarsanız,
uygulamanızın hizmetten içerik yükleyen ve görüntüleyen sayfası hizmet etki alanına eşlenebilir. Sayfaları uzak sanal
alana ve etki alanına eşleme nitelikleri, kare ve iframe HTML öğelerine eklenen yeni niteliklerdir.
Uygulama dışı bir sanal alandaki içeriğin AIR özelliklerini güvenli bir şekilde kullanmasını sağlamak için, üst sanal
alan köprüsü kurabilirsiniz. Uygulama içeriğinin yöntemleri güvenli bir şekilde çağırmasını ve diğer sanal alanlardaki
içeriğin özelliklerine erişmesini sağlamak için, alt sanal alan köprüsü kurabilirsiniz. Güvenli burada uzak içeriğin açık
olmayan nesnelere, özelliklere veya yöntemlere yanlışlıkla başvuru alamaması anlamına gelir. Yalnızca basit veri
türleri, işlevler ve adsız nesneler köprüden geçirilebilir. Ancak yine de tehlikeli olabilecek işlevleri açmaktan
kaçınmalısınız. Örneğin, bir kullanıcının sisteminde bulunan dosyaları okumayı ve dosyalara yazmayı sağlayan bir
arabirimi açtıysanız, uzak içeriğe, kullanıcılarınıza önemli zararlar verebileceği bir yöntem sağlıyor olabilirsiniz.
JavaScript eval() işlevi
Sayfa, yükleme işlemini bitirdiğinde, eval() işlevinin kullanımı uygulama sanal alanıyla sınırlanır. Bazı kullanımlara
izin verilir ve böylece JSON formatlı veriler güvenli bir şekilde ayrıştırılabilir, ancak çalıştırılabilir bir ifadeyle
sonuçlanan herhangi bir değerlendirme hatayla sonuçlanır. “Farklı sanal alanlardaki içerik için kod kısıtlamaları”
sayfa 31, eval() işlevinin izin verilen kullanımlarını açıklar.
İşlev yapıcıları
Uygulama sanal alanında, bir sayfa yükleme işlemini bitirmeden önce işlev yapıcıları kullanılabilir. Tüm sayfa load
olayı işleyicileri bittikten sonra, yeni işlevler oluşturulamaz.
Harici komut dosyalarını yükleme
Uygulama sanal alanındaki HTML sayfaları, JavaScript dosyalarını uygulama dizininin dışından yüklemek için komut
dosyası etiketini kullanamaz. Uygulamanızdaki bir sayfaya uygulama dizininin dışından bir komut dosyası
yüklenmesi için,, sayfa uygulama dışı bir sanal alana eşlenmelidir.
XMLHttpRequest nesnesi
AIR, uygulamaların veri istekleri gerçekleştirebilmek için kullanabileceği bir XMLHttpRequest (XHR) nesnesi sağlar.
Aşağıdaki örnek basit bir veri isteğini gösterir:
xmlhttp = new XMLHttpRequest();
xmlhttp.open("GET", "http:/www.example.com/file.data", true);
xmlhttp.onreadystatechange = function() {
if (xmlhttp.readyState == 4) {
//do something with data...
}
}
xmlhttp.send(null);
Bir tarayıcıya karşılık AIR, uygulama sanal alanında çalışan içeriğin herhangi bir etki alanından veri isteğinde
bulunmasına olanak tanır. Bir JSON dizesi içeren XHR'nin sonucu, sonuç çalıştırılabilir kod içermediği sürece veri
nesneleri olarak değerlendirilebilir. XHR sonucunda çalıştırılabilir ifadeler mevcutsa, bir hata verilir ve değerlendirme
denemesi başarısız olur.
Uzak kaynaklardaki kodun yanlışlıkla dahil edilmesini engellemek için bu işlem sayfa, yükleme işlemini bitirmeden
önce yapılırsa senkronize XHR'ler boş bir sonuç döndürür. Senkronize olmayan XHR'ler her zaman bir sayfa
yüklendikten sonra geri döner.
Varsayılan olarak AIR, uygulama dışı sanal alanlardaki etki alanları arası XMLHttpRequest öğelerini engeller.
Uygulama sanal alanındaki bir üst pencere, uygulama dışı sanal alanda içeriğe sahip olan bir alt karedeki etki alanları
arası isteklere, AIR tarafından eklenen bir nitelik olan allowCrossDomainXHR öğesini içeriğe sahip olan kare veya
iframe öğesini true olarak ayarlayarak izin vermeyi seçebilir:
<iframe id="mashup"
src="http://www.example.com/map.html"
allowCrossDomainXHR="true"
</iframe>
Not: Uygun olduğunda, AIR URLStream sınıfı da veri yüklemek için kullanılabilir.
Bir XMLHttpRequest öğesini uzak sanal alana eşlenmiş uygulama içeriğine sahip olan kareden veya iframe'den uzak
bir sunucuya gönderirseniz, eşleme URL'sinin XHR'de kullanılan sunucu adresini maskelemediğinden emin olun.
Örneğin example.com etki alanı için uygulama içeriğini uzak bir sanal alana eşleyen aşağıdaki iframe tanımını göz
önünde bulundurun:
<iframe id="mashup"
documentRoot="app:/sandbox/"
sandboxRoot="http://www.example.com/"
</iframe>
sandboxRoot niteliği www.example.com adresinin kök URL'sini yeniden eşlediği için, tüm istekler uzak sunucudan
değil, uygulama dizininden yüklenir. Sayfa gezinmesinden veya XMLHttpRequest öğesinden türetilen istekler yeniden
eşlenir.
Uzak sunucunuza yapılan veri isteklerini yanlışlıkla engellemeyi önlemek için, sandboxRoot öğesini köke değil, uzak
URL'nin alt dizinine eşleyin. Dizinin mevcut olması gerekmez. Örneğin, uygulama dizini yerine uzak sunucudan
yükleme yapabilmek için www.example.com adresine yapılan veri isteklerine izin vermek üzere, önceki iframe'i şu
şekilde değiştirin:
<iframe id="mashup"
sandboxRoot="http://www.example.com/air/"
</iframe>
Bu durumda yalnızca air alt dizinindeki içerik yerel olarak yüklenir.
Sanal alan eşlemesiyle ilgili daha fazla bilgi için bkz. “HTML kare ve iframe öğeleri” sayfa 201 ve “HTML güvenliği”
sayfa 29.
Canvas nesnesi
Canvas nesnesi çizgi, yay, elips, çokgen gibi geometrik şekilleri çizmeye yarayan bir API tanımlar. Tuval API'sini
kullanmak için öncelikle belgeye bir tuval öğesi ekler ve JavaScript Canvas API'sini kullanarak tuvalde çizim
yaparsınız. Diğer birçok yönüyle Canvas nesnesi bir görüntü gibi davranır.
Aşağıdaki örnek Canvas nesnesi kullanarak bir üçgen çizer:
<html>
<body>
<canvas id="triangleCanvas" style="width:40px; height:40px;"></canvas>
<script>
var canvas = document.getElementById("triangleCanvas");
var context = canvas.getContext("2d");
context.lineWidth = 3;
context.strokeStyle = "#457232";
context.beginPath();
context.moveTo(5,5);
context.lineTo(35,5);
context.stroke();
</script>
</body>
</html>
Tuval API'siyle ilgili daha fazla belge için bkz. Apple Safari JavaScript Reference (Safari JavaScript Başvurusu). Webkit
projesinin yakın bir zamanda, Web Hypertext Application Technology Working Group (WHATWG) (Web Köprü
Metni Uygulama Teknolojisi Çalışma Grubu) ve W3C tarafından önerilen HTML 5 Working Draft (HTML 5 Çalışma
Taslağı) üzerinde standartlaştırma amacıyla Canvas API'sini değiştirmeye başladığını göz önünde bulundurun. Bunun
bir sonucu olarak Safari JavaScript Başvurusu'ndaki bazı belgeler, AIR'de bulunan tuvalin sürümüyle tutarsız olabilir.
Tanımlama Bilgileri
AIR uygulamalarında yalnızca uzak sanal alanlardaki içerik (http: ve https: kaynaklarından yüklenen), tanımlama
bilgilerini kullanabilir (document.cookie özelliği). Uygulama sanal alanında AIR API'leri, kalıcı verilerin
(EncryptedLocalStore ve FileStream sınıfları gibi) depolanması için başka yöntemler sağlar.
Clipboard nesnesi
WebKit Clipboard API'si şu olaylarla yürütülür: copy, cut ve paste. Bu olaylarda geçen olay nesnesi clipboardData
özelliğiyle panoya erişim sağlar. Pano verilerini okumak veya bu verileri yazmak için aşağıdaki clipboardData
nesnesi yöntemlerini kullanın:
Yöntem
Açıklama
clearData(mimeType)
Pano verilerini temizler. mimeType parametresini temizlenecek verilerin MIME türüne ayarlayın.
getData(mimeType)
Pano verilerini alır. Bu yöntem yalnızca paste olayının işleyicisinde çağrılabilir. mimeType parametresini geri
döndürülecek verilerin MIME türüne ayarlayın.
setData(mimeType, data)
Verileri panoya kopyalar. mimeType parametresini verilerin MIME türüne ayarlayın.
Uygulama sanal alanının dışındaki JavaScript kodu panoya yalnızca bu olayları kullanarak erişebilir. Ancak uygulama
sanal alanındaki içerik, AIR Clipboard sınıfını kullanarak sistem panosuna doğrudan erişebilir. Örneğin panodaki
metin formatı verilerini almak için aşağıdaki ifadeyi kullanabilirsiniz:
var clipping = air.Clipboard.generalClipboard.getData("text/plain",
air.ClipboardTransferMode.ORIGINAL_ONLY);
Geçerli veri MIME türleri şunlardır:
MIME türü
Değer
Metin
"text/plain"
HTML
"text/html"
URL
"text/uri-list"
Bitmap
Dosya listesi
Önemli: Yalnızca uygulama sanal alanındaki içerik panoda bulunan dosya verilerine erişebilir. Uygulama dışı içerik
panodaki bir file nesnesine erişme girişiminde bulunursa, bir güvenlik hatası verilir.
Panoyu kullanmayla ilgili daha fazla bilgi için bkz. “Kopyalama ve yapıştırma” sayfa 137 ve Using the Pasteboard from
JavaScript (Apple Geliştirici Merkezi) (JavaScript'te Yapıştırma Alanı'nı Kullanma).
Sürükle ve Bırak
HTML'e doğru veya HTML'den sürükle ve bırak hareketleri şu DOM olaylarını üretir: dragstart, drag, dragend,
dragenter, dragover, dragleave ve drop. Bu olaylarda geçen olay nesnesi, dataTransfer özelliğiyle sürüklenen
verilere erişim sağlar. dataTransfer özelliği, bir clipboard olayıyla ilişkilendirilen clipboardData nesnesiyle aynı
yöntemleri sağlayan bir nesneye başvurur. Örneğin bir drop olayından metin formatı verileri almak için şu işlevi
kullanabilirsiniz:
function onDrop(dragEvent){
return dragEvent.dataTransfer.getData("text/plain",
air.ClipboardTransferMode.ORIGINAL_ONLY);
}
dataTransfer nesnesinin sahip olduğu önemli üyeler şunlardır:
Üye
Açıklama
clearData(mimeType)
Verileri temizler. mimeType parametresini temizlenecek veri temsilinin MIME türüne ayarlayın.
getData(mimeType)
Sürüklenen verileri alır. Bu yöntem yalnızca drop olayının işleyicisinde çağrılabilir. mimeType parametresini
alınacak verilerin MIME türüne ayarlayın.
setData(mimeType, data)
Sürüklenecek verileri ayarlayın. mimeType parametresini verilerin MIME türüne ayarlayın.
türler
Şu anda dataTransfer nesnesinde kullanılabilir olan tüm veri temsillerinin MIME türlerini içeren dizeler
dizisi.
effectsAllowed
Sürüklenen verilerin kopyalanabileceğini, taşınabileceğini, verilere link verilebileceğini veya bunların bir
kombinasyonunun uygulanabileceğini belirtir. effectsAllowed özelliğini, dragstart olayının
işleyicisinde ayarlayın.
dropEffect
İzin verilerin bırakma efektlerinden hangilerinin sürükleme hedefi tarafından desteklendiğini belirtir.
dropEffect özelliğini dragEnter olayının işleyicisinde ayarlayın. Sürükleme sırasında imleç, kullanıcının
fareyi bırakması durumunda hangi efektin oluşacağını göstermek için değişir. dropEffect belirtilmezse,
effectsAllowed özellik efekti seçilir. Kopyala efektinin taşı efektine göre önceliği, taşı efektinin de link ver
efektine göre önceliği vardır. Kullanıcı klavyeyi kullanarak varsayılan önceliği değiştirebilir.
AIR uygulamasına sürükle ve bırak eylemine yönelik destek eklemeyle ilgili daha fazla bilgi için bkz. “Sürükle ve bırak”
sayfa 122 ve Using the Drag-and-Drop from JavaScript (Apple Geliştirici Merkezi) (JavaScript'te Sürükleme ve
Bırakmayı Kullanma).
innerHTML ve outerHTML özellikleri
AIR, uygulama sanal alanında çalışan içerik için innerHTML ve outerHTML özelliklerinin kullanılmasına yönelik
güvenlik kısıtlamaları getirir. load olayı işleyicilerinin çalıştırılması sırasında ve sayfa load olayından önce, innerHTML
ve outerHTML özelliklerinin kullanımında hiçbir kısıtlama yoktur. Ancak sayfa yüklendikten sonra, innerHTML veya
outerHTML özelliklerini yalnızca belgeye statik içerik eklemek için kullanabilirsiniz. Çalıştırılabilir kod olarak
değerlendirilen innerHTML veya outerHTML özelliklerine atanan bir dizede bulunan herhangi bir ifade yoksayılır.
Örneğin bir olay geri çağırma niteliğini öğe tanımına dahil ederseniz, olay dinleyicisi eklenmez. Benzer şekilde,
gömülü <script> etiketleri de değerlendirilmez. Daha fazla bilgi için bkz. “HTML güvenliği” sayfa 29.
Document.write() ve Document.writeln() yöntemleri
Sayfanın load olayından önce uygulama sanal alanında write() ve writeln() yöntemlerinin kullanımı kısıtlı
değildir. Ancak sayfa yüklendikten sonra, bu yöntemlerden birini çağırmak sayfayı temizlemez veya yeni bir sayfa
oluşturmaz. Birçok web tarayıcısında olduğu gibi, bir sayfa yüklenmesini bitirdikten sonra uygulama dışı sanal alanda
document.write() veya writeln() yöntemini çağırmak geçerli sayfayı temizler ve yeni, boş bir sayfa açar.
Document.designMode özelliği
Belgedeki tüm öğelerin düzenlenebilir olması için document.designMode özelliğini on olan bir değere ayarlayın.
Yerleşik düzenleyici desteği metin düzenleme, kopyalama, yapıştırma ve sürükleyip bırakmayı içerir. designMode
özelliğinin on olarak ayarlanması, body öğesinin contentEditable özelliğinin true olarak ayarlanmasına eşdeğerdir.
Bir belgenin hangi bölümlerinin düzenlenebilir olacağını tanımlamak için çoğu HTML öğesinde contentEditable
özelliğini kullanabilirsiniz. Ek bilgi için bkz. “HTML contentEditable niteliği” sayfa 204.
unload olayları (body ve frameset nesneleri için)
Bir pencerenin üst düzey frameset veya body etiketinde (uygulamanın ana penceresi de dahil olmak üzere), kapanan
pencereye (veya uygulamaya) yanıt vermek için unload olayını kullanmayın. Bunun yerine NativeApplication
nesnesinin exiting olayını kullanın (uygulamanın ne zaman kapandığını saptamak için). Veya NativeWindow
nesnesinin closing olayını kullanın (pencerenin ne zaman kapandığını saptamak için). Örneğin aşağıdaki JavaScript
kodu, kullanıcı uygulamayı kapattığında ("Goodbye.") mesajını görüntüler:
var app = air.NativeApplication.nativeApplication;
app.addEventListener(air.Event.EXITING, closeHandler);
function closeHandler(event)
{
alert("Goodbye.");
}
Ancak komut dosyaları, bir karenin, iframe'in veya üst düzey pencere içeriğinin gezinmesi sonucu oluşan unload
olayına başarılı bir şekilde yanıt verebilir.
Not: Adobe AIR'in gelecek sürümlerinde bu sınırlamalar kaldırılabilir.
JavaScript Window nesnesi
Window nesnesi, JavaScript çalışma bağlamında global nesne olarak kalır. AIR, uygulama sanal alanında, önemli ana
bilgisayar nesnelerinin yanı sıra yerleşik AIR sınıflarına erişim sağlamak için JavaScript Window nesnesine yeni
özellikler ekler. Ayrıca, bazı yöntemler ve özellikler, uygulama sanal alanının içinde bulunup bulunmamalarına bağlı
olarak farklı davranışlar gösterir.
Window.runtime özelliği runtime özelliği, yerleşik runtime sınıflarını uygulama sanal alanının içinden başlatmanızı
ve kullanmanızı sağlar. Bu sınıflar AIR ve Flash Player API'lerini içerir (ancak örneğin Flex çerçevesini içermez).
Örneğin aşağıdaki ifade bir AIR file nesnesi oluşturur:
var preferencesFile = new window.runtime.flash.filesystem.File();
AIR SDK'de sağlanan AIRAliases.js dosyası, bu gibi başvuruları kısaltmanızı sağlayan başka ad tanımları içerir.
Örneğin AIRAliases.js bir sayfaya içe aktarıldığında, aşağıdaki ifade kullanılarak bir File nesnesi oluşturulabilir:
var preferencesFile = new air.File();
window.runtime özelliği, yalnızca uygulama sanal alanındaki içerik ve kareler veya iframe'ler içeren bir sayfanın üst
belgesi için tanımlanır.
Bkz. “AIRAliases.js dosyasını kullanma” sayfa 212.
Window.nativeWindow özelliği nativeWindow özelliği, alttaki yerel window nesnesine bir başvuru sağlar. Bu özellik
sayesinde ekran konumu, boyutu ve görünürlüğü gibi window işlevlerini ve özelliklerini komut dosyasına yazabilir ve
kapatma, yeniden boyutlandırma ve taşıma gibi window olaylarını işleyebilirsiniz. Örneğin aşağıdaki ifade pencereyi
kapatır:
window.nativeWindow.close();
Not: NativeWindow nesnesi tarafından sağlanan pencere kontrol özellikleri, JavaScript Window nesnesi tarafından
sağlanan özelliklerle örtüşür. Bu gibi durumlarda en uygun bulduğunuz yöntemi kullanabilirsiniz.
window.nativeWindow özelliği, yalnızca uygulama sanal alanındaki içerik ve kareler veya iframe'ler içeren bir
sayfanın üst belgesi için tanımlanır.
Window.htmlLoader özelliği htmlLoader özelliği, HTML içeriğine sahip olan AIR HTMLLoader nesnesine bir
başvuru sağlar. Bu özellik sayesinde, HTML ortamının görünümünü ve davranışını komut dosyasına yazabilirsiniz.
Örneğin kontrolün varsayılan, beyaz bir arka plan boyayıp boyamadığını belirlemek için
htmlLoader.paintsDefaultBackground özelliğini kullanabilirsiniz:
Not: HTMLLoader nesnesi window özelliğine sahiptir, bu özellik, sahip olduğu HTML içeriğinin JavaScript Window
nesnesine başvurur. Bu özelliği, içeriğe sahip olan HTMLLoader nesnesine bir başvuru yoluyla JavaScript ortamına
erişmek için kullanabilirsiniz.
window.htmlLoader özelliği, yalnızca uygulama sanal alanındaki içerik ve kareler veya iframe'ler içeren bir sayfanın
üst belgesi için tanımlanır.
Window.parentSandboxBridge ve Window.childSandboxBridge özellikleri parentSandboxBridge ve
childSandboxBridge özellikleri sayesinde, üst ve alt kareler arasında bir arabirim tanımlayabilirsiniz. Daha fazla bilgi
için bkz. “Farklı güvenlik sanal alanlarında çapraz komut dosyası içeriği” sayfa 220.
Window.setTimeout() ve Window.setInterval() işlevleri AIR, setTimeout() ve setInterval() işlevlerinin uygulama
sanal alanında kullanılmasına yönelik güvenlik kısıtlamaları getirir. setTimeout() veya setInterval() işlevlerini
çağırırken bir dize olarak çalıştırılacak kodu tanımlayamazsınız. Bir işlev başvurusu kullanmanız gerekir. Daha fazla
bilgi için bkz. “setTimeout() ve setInterval()” sayfa 209.
Window.open() işlevi open() yöntemi uygulama dışı bir sanal alanda çalışan bir kod tarafından çağrıldığında,
yalnızca kullanıcı etkileşiminin (fare tıklatma veya tuşbasma gibi) bir sonucu olarak çağrılırsa bir pencere açar. Ayrıca,
uygulama başlığı pencere başlığına önek olarak getirilir (pencerelerin uzak içerik tarafından açılmasını engellemek için
). Daha fazla bilgi için bkz.“JavaScript window.open() yönteminin çağrılmasına ilişkin kısıtlamalar” sayfa 33.
air.NativeApplication nesnesi
NativeApplication nesnesi uygulama durumu hakkında bilgi sağlar, uygulama düzeyi birçok önemli olayı gönderir ve
uygulama davranışının kontrol edilmesine yönelik faydalı işlevler sağlar. NativeApplication nesnesinin tek bir örneği
otomatik olarak oluşturulur ve bu özelliğe sınıf tanımlı NativeApplication.nativeApplication özelliği
yardımıyla erişilebilir.
Nesneye JavaScript kodundan erişmek için şunu kullanabilirsiniz:
var app = window.runtime.flash.desktop.NativeApplication.nativeApplication;
Veya AIRAliases.js komut dosyası içe aktarılmışsa, daha kısa biçimini kullanabilirsiniz:
var app = air.NativeApplication.nativeApplication;
NativeApplication nesnesine yalnızca uygulama sanal alanından erişilebilir. İşletim sistemiyle etkileşim“Çalışma
zamanı ve işletim sistemi bilgileriyle çalışma” sayfa 265, NativeApplication nesnesini ayrıntılı olarak anlatmaktadır.
JavaScript URL şeması
Bir JavaScript URL şemasında tanımlanan kodu çalıştırma, (href="javascript:alert('Test')" gibi) uygulama
sanal alanının içinde engellenmiştir. Hata verilmez.
HTML Uzantıları
AIR ve WebKit, aşağıdakiler de dahil olmak üzere, standart olmayan birkaç HTML öğesi ve niteliği tanımlar:
“HTML kare ve iframe öğeleri” sayfa 201
“HTML Tuval öğesi” sayfa 203
“HTML öğesi olay işleyicileri” sayfa 203
HTML kare ve iframe öğeleri
AIR, uygulama sanal alanındaki içeriğin kare ve iframe öğelerine yeni nitelikler ekler:
sandboxRoot niteliği sandboxRoot niteliği, kare src niteliği tarafından belirtilen dosya için alternatif, uygulama dışı
bir kaynak etki alanı belirtir. Dosya, belirtilen etki alanına karşılık gelen uygulama dışı sanal alana yüklenir. Dosyadaki
içerik ve belirtilen etki alanından yüklenen içerik, birbirlerinin çapraz dosyasını oluşturabilir.
Önemli: sandboxRoot değerini etki alanının temel URL'sine ayarlarsanız, bu etki alanından gelen tüm içeriğe yönelik
istekler uzak sunucu yerine uygulama dizininden yüklenir (isteğin sayfa gezinmesinden mi, XMLHttpRequest öğesinden
mi, yoksa başka içerik yükleme yollarından mı kaynaklandığına bakılmaksızın).
documentRoot niteliği documentRoot niteliği, sandboxRoot tarafından belirtilen konumdaki dosyalara çözülen
URL'lerin yükleneceği yerel dizini belirtir.
URL'leri çözerken, kare src niteliğinde veya kareye yüklenen içerikte, URL'nin sandboxRoot öğesinde belirtilen
değerle eşleşen bölümü documentRoot öğesinde belirtilen değerle değiştirilir. Bu nedenle aşağıdaki kare etiketinde:
<iframe
src="http://www.example.com/air/child.html"
sandboxRoot="http://www.example.com/air/"/>
child.html, uygulama yükleme klasörünün sandbox altdizininden yüklenir. child.html içerisindeki göreceli
URL'ler, sandbox dizini temel alınarak çözülür. AIR, dosyaları app:/sandbox/ dizininden yükleme girişiminde
bulunacağı için, www.example.com/air adresinde bulunan uzak sunucudaki tüm dosyalara kareden erişilemediğini
unutmayın.
allowCrossDomainXHR niteliği Karedeki içeriğin herhangi bir uzak etki alanına XMLHttpRequest'leri yapmasını
sağlamak için, allowCrossDomainXHR="allowCrossDomainXHR" öğesini açılış kare etiketine dahil edin. Varsayılan
olarak uygulama dışı içerik, yalnızca kendi kaynak etki alanından bu tür isteklerde bulunabilir. Bunlar etki alanları
arası XHR'lere izin vermekten doğan ciddi güvenlik sonuçlarıdır. Sayfadaki kod, herhangi bir etki alanıyla veri
alışverişi yapabilir. Kötü amaçlı içerik bir şekilde sayfaya dahil olursa, geçerli sanal alanda kodun erişimi olan tüm
veriler tehlikeye girebilir. Etki alanları arası XHR'leri yalnızca oluşturduğunuz ve kontrol ettiğiniz sayfalarda ve
yalnızca etki alanları arası veri yükleme gerçekten gerekli olduğunda etkinleştirin. Ayrıca, kod dahil etmeyi veya başka
yollarla yapılan saldırıları önlemek için, sayfa tarafından yüklenen tüm harici verileri dikkatli bir şekilde doğrulayın.
Önemli: allowCrossDomainXHR niteliği bir kare veya iframe öğesine dahil edilmişse, etki alanları arası XHR'ler
etkindir (atanan değer "0" olmadığı veya "f" ya da "n" harfleriyle başlamadığı sürece). Örneğin, allowCrossDomainXHR
değerini "deny" olarak ayarlamak da etki alanları arası XHR'leri etkinleştirir. Etki alanları arası istekleri etkinleştirmek
istemiyorsanız, niteliği tamamen öğe bildiriminin dışında bırakın.
ondominitialize niteliği Bir karenin dominitialize olayının olay işleyicisini belirtir. Bu olay, karenin pencere ve
belge nesneleri oluşturulduğunda ancak herhangi bir komut dosyası ayrıştırılmadan veya belge öğeleri
oluşturulmadan önce çalışan, AIR'e özgü bir olaydır.
Kare, dominitialize olayını yükleme dizisinde, alt sayfadaki komut dosyaları alt belgeye dominitialize işleyicisi
tarafından eklenen nesnelere, değişkenlere ve işlevlere başvurmadan önce, yeterince erken bir zamanda gönderir. Bir
alt belgeye doğrudan nesne eklemek veya alt belgedeki nesnelere doğrudan erişmek için üst sayfayla alt sayfa aynı sanal
alanda bulunmalıdır. Ancak uygulama sanal alanındaki bir üst öğe, uygulama dışı sanal alandaki içerikle iletişim
kurmak için sanal alan köprüsü kurabilir.
Aşağıdaki örnekler iframe etiketinin AIR'deki kullanımını gösterir:
child.html öğesini, uzak sunucudaki gerçek bir etki alanına eşlemeden uzak sanal alana yerleştirin:
<iframe
src="http://localhost/air/child.html"
sandboxRoot="http://localhost/air/"/>
child.html öğesini, XMLHttpRequest'lerinin yalnızca www.example.com adresine yapılmasına izin vererek uzak
sanal alana yerleştirin:
<iframe
sandboxRoot="http://www.example.com/air/"/>
child.html öğesini, XMLHttpRequest'lerinin herhangi bir uzak etki alanına yapılmasına izin vererek uzak sanal
alana yerleştirin:
<iframe
allowCrossDomainXHR="allowCrossDomainXHR"/>
child.html öğesini dosya sistemiyle yerel sanal alana yerleştirin:
<iframe
src="file:///templates/child.html"
sandboxRoot="app-storage:/templates/"/>
child.html öğesini, sanal alan köprüsü kurmak için dominitialize olayını kullanarak uzak sanal alana yerleştirin:
<html>
<head>
<script>
var bridgeInterface = {};
bridgeInterface.testProperty = "Bridge engaged";
function engageBridge(){
document.getElementById("sandbox").parentSandboxBridge = bridgeInterface;
}
</script>
</head>
<body>
<iframe id="sandbox"
ondominitialize="engageBridge()"/>
</body>
</html>
Aşağıdaki child.html belgesi, alt içeriğin üst sanal alan köprüsüne nasıl erişebildiğini gösterir:
<html>
<head>
<script>
document.write(window.parentSandboxBridge.testProperty);
</script>
</head>
<body></body>
</html>
Daha fazla bilgi için bkz. “Farklı güvenlik sanal alanlarında çapraz komut dosyası içeriği” sayfa 220 ve “HTML
güvenliği” sayfa 29.
HTML Tuval öğesi
Webkit Canvas API'siyle kullanmak için bir çizim alanı tanımlar. Grafik komutları etiketin kendisinde belirtilemez.
Tuvalde çizim yapmak için, JavaScript yardımıyla tuvale çizme yöntemlerini çağırın.
<canvas id="drawingAtrium" style="width:300px; height:300px;"></canvas>
Daha fazla bilgi için bkz. “Canvas nesnesi” sayfa 196.
HTML öğesi olay işleyicileri
AIR ve Webkit'teki DOM nesneleri, standart DOM olayı modelinde bulunmayan bazı olayları gönderir. Aşağıdaki
tablo, bu olaylara işleyici belirtmek için kullanabileceğiniz ilgili olay niteliklerini listeler.
Callback nitelik adı
Açıklama
oncontextmenu
Seçili metinde sağ tıklatılarak veya komut tuşuna basıp tıklatılarak bir bağlam menüsü
çağrıldığında çağrılır.
oncopy
Bir öğedeki seçim kopyalandığında çağrılır.
oncut
Bir öğedeki seçim kesildiğinde çağrılır.
ondominitialize
Bir kareye veya iframe'e yüklenen belgenin DOM'si oluşturulduğunda, ancak bir DOM öğesi
oluşturulmadan veya komut dosyaları ayrıştırılmadan çağrılır.
ondrag
Bir öğe sürüklendiğinde çağrılır.
ondragend
Sürükleme işlemi bırakıldığında çağrılır.
ondragenter
Sürükleme hareketi bir öğenin sınırlarına girdiğinde çağrılır.
ondragleave
Sürükleme hareketi bir öğenin sınırlarından çıktığında çağrılır.
ondragover
Sürükleme hareketi bir öğenin sınırları içerisindeyken sürekli çağrılır.
ondragstart
Sürükleme hareketi başladığında çağrılır.
ondrop
Bir öğenin üzerindeyken sürükleme hareketi bırakıldığında çağrılır.
onerror
Bir öğe yüklenirken hata oluştuğunda çağrılır.
oninput
Bir öğe biçimine metin girildiğinde çağrılır.
onpaste
Öğe, bir öğeye yapıştırıldığında çağrılır.
onscroll
Kaydırılabilir öğenin içeriği kaydırıldığında çağrılır.
onsearch
Bir öğe kopyalandığında çağrılır (? Apple belgeleri doğru mu?)
onselectstart
Bir seçim başladığında çağrılır.
HTML contentEditable niteliği
Kullanıcıların öğenin içeriğini düzenlemelerine olanak sağlamak için, contentEditable niteliğini herhangi bir
HTML öğesine ekleyebilirsiniz. Örneğin aşağıdaki örnek HTML kodu, ilk p öğe dışında belgenin tamamını
düzenlenebilir olarak ayarlar:
<html>
<head/>
<body contentEditable="true">
<h1>de Finibus Bonorum et Malorum</h1>
<p contentEditable="false">Sed ut perspiciatis unde omnis iste natus error.</p>
<p>At vero eos et accusamus et iusto odio dignissimos ducimus qui blanditiis.</p>
</body>
</html>
Not: document.designMode özelliğini on olarak ayarlarsanız, tek bir öğe için contentEditable ayarına
bakılmaksızın belgedeki tüm öğeler düzenlenebilir hale gelir. Ancak designMode özelliğini off olarak ayarlamak,
contentEditable değerinin true olduğu öğelerin düzenlenme özelliğini devre dışı bırakmaz. Ek bilgi için bkz.
“Document.designMode özelliği” sayfa 199.
CSS Uzantıları
WebKit birçok genişletilmiş CSS özelliğini destekler. Aşağıdaki tablo, destek sağlanan genişletilmiş özellikleri listeler.
Ek, standart olmayan özellikler WebKit'te mevcuttur, ancak AIR'de tamamen desteklenmez; bunun nedeni hala
WebKit'te geliştirilmekte olmaları veya gelecekte kaldırılabilecek deneysel özellikler olmalarıdır.
CSS özellik adı
Değerler
Açıklama
-webkit-border-horizontal-spacing
Negatif olmayan uzunluk birimi
Kenarlık boşluğunun yatay bileşenini belirtir.
-webkit-border-vertical-spacing
Negatif olmayan uzunluk birimi
Kenarlık boşluğunun dikey bileşenini belirtir.
-webkit-line-break
after-white-space, normal
Çince, Japonca ve Korece (CJK) metinler için
kullanılacak satır kesmesi kuralını belirtir.
-webkit-margin-bottom-collapse
collapse, discard, separate
Bir tablo hücresinin alt kenar boşluğunun
nasıl daraltıldığını tanımlar.
-webkit-margin-collapse
Bir tablo hücresinin üst ve alt kenar
boşluğunun nasıl daraltıldığını tanımlar.
-webkit-margin-start
Bir uzunluk birimi.
Başlangıç kenar boşluğunun genişliği. Bu
özellik soldan sağa metinlerde sol kenar
boşluğunu geçersiz kılar. Bu özellik sağdan
sola metinlerde sağ kenar boşluğunu geçersiz
kılar.
-webkit-margin-top-collapse
Bir tablo hücresinin üst kenar boşluğunun
nasıl daraltıldığını tanımlar.
-webkit-nbsp-mode
normal, space
İçerikte bulunan kesmeyen boşlukların
davranışını tanımlar.
-webkit-padding-start
Bir uzunluk birimi
Başlangıç dolgusunun genişliğini belirtir. Bu
özellik soldan sağa metinlerde sol dolgu
değerini geçersiz kılar. Bu özellik sağdan sola
metinlerde sağ dolgu değerini geçersiz kılar.
-webkit-rtl-ordering
logical, visual
Soldan sağa ve sağdan sola karışık metnin
varsayılan işlemesini geçersiz kılar.
-webkit-text-fill-color
Adlı bir renk veya sayısal renk değeri.
Metin dolgu rengini belirtir.
CSS özellik adı
Değerler
Açıklama
-webkit-text-security
circle, disc, none, square
Şifre girişi alanında kullanılacak değiştirme
şeklini belirtir.
-webkit-user-drag
•
auto — Varsayılan davranış
Otomatik sürükleme davranışını geçersiz kılar.
•
element — Öğenin tamamı sürüklenir
•
none — Öğe sürüklenemez
-webkit-user-modify
read-only, read-write, read-write-plaintextonly
Bir öğenin içeriğinin düzenlenip
düzenlenemeyeceğini belirtir.
-webkit-user-select
•
auto — Varsayılan davranış
Bir kullanıcının öğenin içeriğini seçip
seçemeyeceğini belirtir.
•
none — Öğe seçilemez
•
text — Yalnızca öğedeki metin seçilebilir
Daha fazla bilgi için bkz. Apple Safari CSS Başvurusu
(http://developer.apple.com/documentation/AppleApplications/Reference/SafariCSSRef/).
206
Bölüm 21: HTML ve JavaScript'te
programlama
Adobe® AIR™ uygulamalarını HTML ve JavaScript ile geliştirmeye özgü bir dizi programlama başlığı mevcuttur.
HTML tabanlı bir AIR uygulaması veya HTMLLoader sınıfını (veya mx:HTML Flex™ bileşenini) kullanarak HTML
veya JavaScript çalıştıran SWF tabanlı bir AIR uygulamasını programladığınızda, aşağıdaki bilgiler önemlidir.
HTMLLoader sınıfı hakkında
Adobe AIR HTMLLoader sınıfı, AIR uygulamasında HTML içeriğini görüntüleyebilen display nesnesini tanımlar.
SWF tabanlı uygulamalar, var olan bir pencereye HTMLLoader denetimi ekleyebilir veya
HTMLLoader.createRootWindow() öğesine sahip HTMLLoader nesnesini otomatik olarak içeren bir HTML
penceresi oluşturabilir. HTMLLoader nesnesine yüklenen HTML sayfasından JavaScript window.htmlLoader özelliği
aracılığıyla erişilebilir.
URL'den HTML içeriği yükleme
Aşağıdaki kod, bir HTMLLoader nesnesine URL yükler ve nesneyi Sprite nesnesinin alt nesnesi olarak ayarlar:
var container:Sprite;
var html:HTMLLoader = new HTMLLoader;
html.width = 400;
html.height = 600;
var urlReq:URLRequest = new URLRequest("http://www.adobe.com/");
html.load(urlReq);
container.addChild(html);
HTMLLoader nesnesinin width ve height özellikleri varsayılan olarak 0'a ayarlanmıştır. Sahneye HTMLLoader
nesnesi eklerken bu boyutları ayarlamak isteyeceksiniz. HTMLLoader öğesi, sayfa yüklenirken birçok olay gönderir.
Yüklenen sayfayla etkileşim kurmanın ne zaman güvenli olduğunu belirlemek için bu olauları kullanabilirsiniz. Bu
olaylar, “HTML ile ilgili olayları işleme” sayfa 224 bölümünde anlatılmıştır.
Ayrıca TextField sınıfını kullanarak HTML metni oluşturabilirsiniz, ancak bunun özellikleri sınırlıdır. Adobe® Flash®
Player’ın TextField sınıfı, HTML işaretleme alt kümesini destekler, ancak boyut sınırlamaları nedeniyle özellikleri
sınırlıdır. (Adobe AIR'de bulunan HTMLLoader sınıfı Flash Player'da mevcut değildir.)
Bir dizeden HTML içeriğini yükleme
HTMLLoader nesnesinin loadString() yöntemi, HTML içeriğinin bir dizesini HTMLLoader nesnesine yükler:
var htmlStr:String = "<html><body>Hello <b>world</b>.</body></html>";
html.loadString(htmlStr);
loadString() yöntemiyle yüklenen içeriğe AIR API'lerine tam erişim verilir ve bu içerik uygulama güvenlik sanal
alanına yerleştirilir.
HTML ve JavaScript'te programlama
HTML ve AIR uygulamalarının kullanımında önemli güvenlik kuralları
AIR uygulamasıyla kurduğunuz dosyalar AIR API'lerine erişime sahiptir. Güvenlik nedenleriyle, diğer kaynaklardan
gelen içerik bu erişime sahip değildir. Örneğin bu kısıtlama uzak bir etki alanından (http://ornek.com gibi) gelen
içeriğin kullanıcının masaüstü dizini içeriğini okumasını (veya daha kötüsünü) engeller.
Çünkü eval() işlevinin (ve ilgili API'lerin) çağrılması yoluyla yararlanılabilecek güvenlik boşlukları mevcuttur,
uygulamayla yüklenen içerik, varsayılan olarak bu yöntemleri kullanamaz. Ancak, bazı Ajax çerçeveleri eval()
işlevini ve ilgili API'leri çağırma yolunu kullanır.
İçeriği bir AIR uygulamasında çalışmak üzere düzgün biçimde yapılandırmak için farklı kaynaklardan gelen içerikteki
güvenlik kısıtlamalarına ilişkin kuralları dikkate almalısınız. Farklı kaynaklardan gelen içerik, sanal alan adı verilen
ayrı güvenlik sınıflandırmalarına yerleştirilir (bkz. “Sanal alanlar” sayfa 26). Varsayılan olarak, uygulamayla yüklenen
içerik uygulama sanal alanı olarak bilinen bir sanal alana yüklenir ve bu sayede AIR API'lerine erişebilir. Uygulama
sanal alanı güvenilmeyen kodların yürütülmesini engellemek üzere tasarlanmış kısıtlamalar içerdiğinden, genellikle en
güvenli sanal alandır.
Çalışma zamanı, uygulamanızla yüklenen içeriği uygulama sanal alanından farklı bir sanal alana yüklemenize olanak
verir. Uygulama dışı sanal alanlardaki içerik, tipik web tarayıcılarınınkine benzer bir güvenlik ortamında çalışır.
Örneğin, uygulama dışı sanal alanlardaki kod eval() yöntemini ve ilgili yöntemleri kullanabilir (ancak aynı zamanda
AIR API'lerine erişme izni yoktur). Çalışma zamanı, içeriğin farklı sanal alanlarda güvenli biçimde iletişim kurmasına
yönelik yollar içerir (örneğin, AIR API'lerini uygulama dışı içeriğe göstermeden) Ayrıntılar için bkz. “Farklı güvenlik
sanal alanlarında çapraz komut dosyası içeriği” sayfa 220.
Güvenlik nedenleriyle sanal alanda kullanımı kısıtlanmış olan kodu çağırdığınızda çalıştırma zamanı bir JavaScript
hatası gönderir: “Uygulama güvenlik sanal alanında JavaScript koduna ilişkin Adobe AIR çalıştırma zamanı güvenlik
ihlali.”
Bu hatayı önlemek için sonraki “Güvenlik ilişkili JavaScript hatalarını önleme” sayfa 207 bölümünde anlatılan
kodlama uygulamalarını takip edin.
Daha fazla bilgi için bkz. “HTML güvenliği” sayfa 29.
Güvenlik ilişkili JavaScript hatalarını önleme
Bu güvenlik kısıtlamaları nedeniyle sanal alanda kullanımı kısıtlanmış olan kodu çağırdığınızda çalıştırma zamanı bir
JavaScript hatası gönderir: “Uygulama güvenlik sanal alanında JavaScript koduna ilişkin Adobe AIR çalıştırma zamanı
güvenlik ihlali.” Bu hatayı önlemek için, bu kodlama uygulamalarını takip edin.
Güvenlik ilişkili JavaScript hatalarının nedenleri
Belge load olayı tetiklendiğinde ve herhangi bir load olay işleyicisinden çıkıldığında, uygulama sanal alanında
yürütülen kod, değerlendirme ve yürütme dizeleri içeren çoğu uygulamadan kısıtlanır. Güvenli olmayabilecek dizeleri
değerlendiren ve yürüten aşağıdaki JavaScript ifade türlerinin kullanılmaya çalışılması JavaScript hataları oluşturur:
• eval() işlevi
• setTimeout() ve setInterval()
• İşlev yapıcısı
Ayrıca, aşağıdaki JavaScript ifade türleri güvenli olmayan JavaScript hatası oluşturmadan başarısız olur:
• javascript: URL'ler
• innerHTML ve outerHTML ifadelerinde onevent nitelikleri aracılığıyla atanan olay geri çağrıları
• JavaScript dosyalarını uygulama yükleme dizini dışından yükleme
• document.write() ve document.writeln()
• load olayından önce veya load olay işleyicisi sırasında senkronize XMLHttpRequests
• Dinamik olarak oluşturulan komut dosyası öğeleri
Not: Bazı sınırlı durumlarda, dizelerin değerlendirilmesine izin verilir. Daha fazla bilgi için bkz. “Farklı sanal
alanlardaki içerik için kod kısıtlamaları” sayfa 31.
Adobe http://www.adobe.com/go/airappsandboxframeworks_tr adreslerinde uygulama güvenlik sanal alanını
desteklemek üzere bilinen bir dizi Ajax çerçevesi tutar.
Aşağıdaki bölümler, güvenli olmayan JavaScript hatalarını ve uygulama sanal alanında çalışan koda ilişkin sessiz
hataları önlemek için komut dosyalarının nasıl yeniden yazılacağını anlatır.
Uygulama içeriğini farklı bir sanal alana eşleme
Çoğu durumda, güvenlik ilişkili JavaScript hatalarını önlemek amacıyla bir uygulamayı yeniden yazabilir veya yeniden
yapılandırabilirsiniz. Ancak, yeniden yazma veya yeniden yapılandırma olanaklı olmadığında uygulama içeriğini
“Uygulama içeriğini uygulama dışı sanal alana yükleme” sayfa 220 bölümünde anlatılan tekniği kullanarak farklı bir
sanal alana yükleyebilirsiniz. Bu içeriğin AIR API'lerine de erişmesi gerekiyorsa, “Sanal alan köprü arabirimini kurma”
sayfa 221 bölümünde anlatıldığı biçimde bir sanal alan köprüsü oluşturabilirsiniz.
eval() işlevi
Uygulama sanal alanında, eval() işlevi yalnızca load olayı sayfasından önce veya load olay işleyicisi sırasında
kullanılabilir. Sayfa yüklendikten sonra, eval() işlevine yapılan çağrılar kodu yürütmez. Ancak, aşağıdaki
durumlarda eval() işlevinin kullanımını önlemek için kodunuzu yeniden yazabilirsiniz.
Nesneye özellikler atama
Özellik erişimcisi oluşturmak için dizeyi ayrıştırmak yerine:
eval("obj." + propName + " = " + val);
köşeli parantez açıklaması içeren access özellikleri:
obj[propName] = val;
Bağlamda var olan değişkenler içeren işlev oluşturma
İfadeleri aşağıdaki şekilde değiştirin:
function compile(var1, var2){
eval("var fn = function(){ this."+var1+"(var2) }");
return fn;
}
şununla:
function compile(var1, var2){
var self = this;
return function(){ self[var1](var2) };
}
Sınıf adını dize parametresi olarak kullanarak nesne oluşturma
Aşağıdaki kodla tanımlanan varsayımsal bir JavaScript sınıfı düşünün:
var CustomClass =
{
Utils:
{
Parser: function(){ alert('constructor') }
},
Data:
{
}
};
var constructorClassName = "CustomClass.Utils.Parser";
Örnek oluşturmanın en basit yolu eval() işlevini kullanmaktır:
var myObj;
eval('myObj=new ' + constructorClassName +'()')
Ancak, sınıf adının her bileşenini ayrıştırma ve köşeli parantez açıklaması kullanarak yeni nesne oluşturma yoluyla,
eval() işlevinin çağrılmasını önleyebilirsiniz:
function getter(str)
{
var obj = window;
var names = str.split('.');
for(var i=0;i<names.length;i++){
if(typeof obj[names[i]]=='undefined'){
var undefstring = names[0];
for(var j=1;j<=i;j++)
undefstring+="."+names[j];
throw new Error(undefstring+" is undefined");
}
obj = obj[names[i]];
}
return obj;
}
Örneği oluşturmak için şunu kullanın:
try{
var Parser = getter(constructorClassName);
var a = new Parser();
}catch(e){
alert(e);
}
setTimeout() ve setInterval()
İşleyici işlevi olarak onaylanan dizeyi bir işlev başvurusu veya nesneyle değiştirin. Örneğin, ifadeyi şu şekilde
değiştirin:
setTimeout("alert('Timeout')", 10);
şununla:
setTimeout(alert('Timeout'), 10);
Veya işlev bu nesnenin çağıran tarafından ayarlanmasını gerektirdiğinde ifadeyi şu şekilde değiştirin:
this.appTimer = setInterval("obj.customFunction();", 100);
şununla:
var _self = this;
this.appTimer = setInterval(function(){obj.customFunction.apply(_self);}, 100);
İşlev yapıcısı
new Function(param, body) çağrıları bir satır içi işlev bildirimiyle değiştirilebilir veya yalnızca sayfa load olayı
işlenmeden önce kullanılabilir.
javascript: URL'ler
javascript kullanılarak linkte tanımlanan kod: Uygulama sanal alanında URL şeması yoksayılır. Güvenli olmayan
JavaScript hatası oluşmadı. javascript aracılığıyla linkleri değiştirebilirsiniz: URL'ler, örneğin:
<a href="javascript:code()">Click Me</a>
şununla:
<a href="#" onclick="code()">Click Me</a>
innerHTML ve outerHTML ifadelerinde onevent nitelikleri aracılığıyla atanan
olay geri çağrıları
Belge DOM'una öğe eklemek için innerHTML veya outerHTML kullandığınızda, ifadede atanan onclick veya
onmouseover gibi olay geri çağrıları yoksayılır. Güvenlik hatası oluşmadı. Bunun yerine, addEventListener()
yöntemini kullanarak yeni öğelere id niteliği atayabilir ve olay işleyici geri çağrı işlevlerini ayarlayabilirsiniz.
Örneğin, belgede şu şekilde bir hedef öğe belirlendiğinde:
<div id="container"></div>
İfadeleri şu şekilde değiştirin:
document.getElementById('container').innerHTML =
'<a href="#" onclick="code()">Click Me.</a>';
şununla:
document.getElementById('container').innerHTML = '<a href="#" id="smith">Click Me.</a>';
document.getElementById('smith').addEventListener("click", function() { code(); });
JavaScript dosyalarını uygulama yükleme dizini dışından yükleme
Uygulama sanal alanının dışından komut dosyaları yüklemeye izin verilmez. Güvenlik hatası oluşmadı. Uygulama
sanal alanında çalışan tüm komut dosyaları uygulama dizinine yüklenmiş olmalıdır. Sayfada harici komut dosyaları
kullanmak için, sayfayı farklı bir sanal alana eşlemelisiniz. Bkz. “Uygulama içeriğini uygulama dışı sanal alana
yükleme” sayfa 220.
document.write() ve document.writeln()
Sayfa load olayı işlendikten sonra document.write() veya document.writeln() çağrıları yoksayılır. Güvenlik
hatası oluşmadı. Alternatif olarak yeni bir dosya yükleyebilir veya DOM işleme tekniklerini kullanarak belge gövdesini
değiştirebilirsiniz.
load olayından önce veya load olay işleyicisi sırasında senkronize
XMLHttpRequests
load olayından önce veya load olay işleyicisi sırasında başlatılan senkronize XMLHttpRequest'ler herhangi bir içerik
döndürmez. Senkronize olmayan XMLHttpRequest'ler başlatılabilir, ancak load olayının sonrasına kadar dönmez.
load olayı işlendikten sonra senkronize XMLHttpRequest'ler normal davranır.
Dinamik olarak oluşturulan komut dosyası öğeleri
Dinamik olarak oluşturulan komut dosyası öğeleri, örneğin innerHTML ile veyadocument.createElement()
yöntemiyle oluşturulduklarında yoksayılır.
AIR API sınıflarına JavaScript'ten erişme
Standart ve gelişmiş Webkit öğelerine ek olarak, HTML ve JavaScript kodu da çalışma zamanı tarafından sağlanan host
sınıflarına erişebilir. Bu sınıflar AIR'in sağladığı gelişmiş özelliklere erişmenizi sağlar, bu özellikler:
• Dosya sistemine erişim
• Yerel SQL veri tabanları kullanımı
• Uygulama ve pencere menülerinin denetimi
• Ağ iletişimi için soketlere erişim
• Kullanıcı tanımlı sınıfların ve nesnelerin kullanımı
• Ses özellikleri
Örneğin, AIR dosya API'si flash.filesystem paketinde bulunan bir File sınıfını içerir. JavaScript'te aşağıdaki şekilde
bir File nesnesi oluşturabilirsiniz:
var myFile = new window.runtime.flash.filesystem.File();
runtime nesnesi, uygulama sanal alanındaki AIR'de çalışan HTML içeriği tarafından kullanılabilen özel bir
JavaScript nesnesidir. JavaScript'ten runtime sınıflarına erişebilmenizi sağlar. runtime nesnesinin flash özelliği,
flash paketine erişim sağlar. Buna karşılık, runtime nesnesinin flash.filesystem özelliği flash.filesystem
paketine erişim sağlar (ve bu paket File sınıfını içerir). Paketler, ActionScript'te kullanılan sınıfları düzenlemenin
bir yoludur.
Not: runtime özelliği kareye veya iframe'e yüklenen sayfaların window nesnelerine otomatik olarak eklenmez.
Ancak, alt belge uygulama sanal alanında olduğu sürece, alt öğe üst öğenin runtime özelliğine erişebilir.
Runtime sınıflarının paket yapısı geliştiricilerin her sınıfa erişmek için uzun JavaScript kod dizelerini yazmasını
gerektirdiğinden (window.runtime.flash.desktop.NativeApplication içinde olduğu gibi), AIR SDK
runtime sınıflarına çok daha kolay erişmenizi sağlayan AIRAliases.js dosyasını içerir (örneğin yalnızca
air.NativeApplication yazarak).
Bu kılavuzda AIR API sınıfları tartışılmıştır. HTML geliştiricilerini ilgilendirebilecek Flash Player API dışındaki
sınıflar HTML Geliştiricileri için Adobe AIR Dil Başvurusu bölümünde anlatılmıştır. ActionScript, SWF (Flash
Player) içeriğinde kullanılan dildir. Ancak, JavaScript ve ActionScript sözdizimleri birbirine benzer. (ECMAScript
dilinin sürümlerini temel alır.) Tüm yerleşik sınıflar hem JavaScript'te (HTML içeriğinde) hem de ActionScript'te
(SWF içeriğinde) mevcuttur.
Not: JavaScript kodu ActionScript'te bulunan Dictionary, XML, and XMLList sınıflarını kullanamaz.
Not: Daha fazla bilgi için bkz. ActionScript 3.0 sınıfları, paketleri ve ad alanları ve JavaScript geliştiricileri için
ActionScript temelleri.
AIRAliases.js dosyasını kullanma
Runtime sınıfları, paket yapısında aşağıdaki şekilde düzenlenmiştir:
•
window.runtime.flash.desktop.NativeApplication
•
window.runtime.flash.desktop.ClipboardManager
•
window.runtime.flash.filesystem.FileStream
•
window.runtime.flash.data.SQLDatabase
AIR SDK içinde, runtime sınıflarına daha az yazı yazarak erişebilmenizi sağlayacak “başka ad” tanımlarını sunan
bir AIRAliases.js dosyası yer alır. Örneğin, yukarıda listelenen sınıflara yalnızca şunu yazarak erişebilirsiniz:
•
air.NativeApplication
•
air.Clipboard
•
air.FileStream
•
air.SQLDatabase
Bu liste, AIRAliases.js dosyasındaki sınıfların kısa bir alt kümesidir. Sınıfların ve paket düzeyindeki işlevlerin tam
listesi HTML Geliştiricileri için Adobe AIR Dil Başvurusu içinde bulunur.
AIRAliases.js dosyası, yaygın olarak kullanılan runtime sınıflarının yanı sıra, yaygın olarak kullanılan paket
düzeyindeki işlevlere işlevler için başka adları da içerir: air.trace(), air.navigateToURL() ve
air.sendToURL() olarak farklı adlandırılan window.runtime.trace(),
window.runtime.flash.net.navigateToURL() ve window.runtime.flash.net.sendToURL().
AIRAliases.js dosyasını kullanmak için aşağıdaki komut dosyası başvurusunu HTML sayfanıza ekleyin:
<script src="AIRAliases.js"></script>
Gerektiğinde src başvurusundaki yolu ayarlayın.
Önemli: Bu belgedeki JavaScript örnek kodu, aksi belirtilmediği sürece AIRAliases.js dosyasını HTML sayfanıza dahil
ettiğinizi varsayar.
AIR'deki URL'ler hakkında
AIR'den çalışan HTML içeriğinde, link etiketinin href niteliğinde veya URL girebileceğiniz herhangi bir yerde img,
frame, iframe ve script etiketlerine ilişkin src niteliklerini tanımlamak için aşağıdaki URL şemalarından birini
kullanabilirsiniz.
URL şeması
Açıklama
Örnek
dosya
Dosya sisteminin köküne ilişkin yol.
app
Yüklenen uygulamanın kök dizinine ilişkin yol.
app:/images
app depolama
Uygulama depolama dizinine ilişkin yol. AIR, yüklenen her
uygulama için bu uygulamaya ilişkin verileri depolamak üzere
kullanışlı bir yer olan benzersiz bir uygulama depolama dizini
tanımlar.
http
Standart bir HTTP isteği.
http://www.adobe.com
https
Standart bir HTTPS isteği.
https://secure.example.com
URL şemalarının AIR'de kullanımı hakkında daha fazla bilgi için bkz. “URL'lerde AIR URL şemalarını kullanma”
sayfa 271.
File, Loader, URLStream ve Sound sınıfları dahil çoğu AIR API'leri URL içeren bir dize yerine URLRequest nesnesini
kullanır. URLRequest nesnesi, aynı url şemalarından herhangi birini kullanabilen bir dizeyle başlatılır. Örneğin,
aşağıdaki ifade Adobe ana sayfasını istemek için kullanılabilecek bir URLRequest nesnesi oluşturur.
var urlReq = new air.URLRequest("http://www.adobe.com/");
URLRequest nesneleri hakkında bilgi için bkz. “URL istekleri ve ağ iletişimi” sayfa 270.
ActionScript nesnelerini JavaScript için kullanılabilir
duruma getirme
HTMLLoader nesnesi tarafından yüklenen HTML sayfasındaki JavaScript, ActionScript yürütme bağlamında HTML
sayfasının window.runtime, window.htmlLoader ve window.nativeWindow özellikleri kullanılarak tanımlanan
sınıfları, nesneleri ve işlevleri çağırabilir. Ayrıca JavaScript yürütme bağlamında ActionScript nesneleri ve işlevlerine
başvurular oluşturarak bunları JavaScript için kullanılabilir duruma getirebilirsiniz.
JavaScript nesnelerine ActionScript üzerinden erişmenin basit bir örneği
Aşağıdaki örnek, ActionScript nesnelerine başvuru yapan özelliklerin bir HTML'sayfasının global window nesnesine
nasıl eklendiğini gösterir:
var foo:String = "Hello from container SWF."
function helloFromJS(message:String):void {
trace("JavaScript says:", message);
}
var urlReq:URLRequest = new URLRequest("test.html");
html.addEventListener(Event.COMPLETE, loaded);
html.load(urlReq);
function loaded(e:Event):void{
html.window.foo = foo;
html.window.helloFromJS = helloFromJS;
}
Önceki örnekte HTMLLoader nesnesine yüklenen HTML içeriği (test.html adlı bir dosyada) üst SWF dosyasında
tanımlanan foo özelliği ve helloFromJS() yöntemine erişebilir:
<html>
<script>
function alertFoo() {
alert(foo);
}
</script>
<body>
<button onClick="alertFoo()">
What is foo?
</button>
<p><button onClick="helloFromJS('Hi.')">
Call helloFromJS() function.
</button></p>
</body>
</html>
Yüklenen bir belgenin JavaScript bağlamına erişirken, sayfa yapım sırasında nesneleri sayfada tanımlanan tüm komut
dosyalarının erişebileceği kadar erken oluşturmak için htmlDOMInitialize olayını kullanabilirsiniz. Complete
olayını beklerseniz, yalnızca sayfa load olayından sonra çalışan sayfadaki komut dosyaları eklenen nesnelere erişebilir.
Sınıf tanımlarını JavaScript için kullanılabilir duruma getirme
Uygulamanızın ActionScript sınıflarını JavaScript'te kullanılabilir duruma getirmek için, yüklenen HTML içeriğini
sınıf tanımlarını içeren uygulama etki alanına atayabilirsiniz. JavaScript yürütme bağlamının uygulama etki alanı,
HTMLLoader nesnesinin runtimeApplicationDomain özelliğiyle ayarlanabilir. Uygulama etki alanını birincil
uygulama etki alanı olarak ayarlamak için runtimeApplicationDomain öğesini aşağıdaki kodda gösterildiği şekilde
ApplicationDomain.currentDomain olarak ayarlayın:
html.runtimeApplicationDomain = ApplicationDomain.currentDomain;
runtimeApplicationDomain özelliği ayarlandığında, JavaScript bağlamı sınıf tanımlarını atanan etki alanıyla
paylaşır. JavaScript'teki özel bir sınıfın örneğini oluşturmak için window.runtime özelliği aracılığıyla sınıf tanımına
başvuru yapın ve yeni operatörü kullanın:
var customClassObject = new window.runtime.CustomClass();
HTML içeriği uyumlu bir güvenlik etki alanından geliyor olmalıdır. HTML içeriği atadığınız uygulama etki alanından
farklı bir güvenlik etki alaından geliyorsa, sayfa bunun yerine varsayılan uygulama etki alanını kullanır. Örneğin,
İnternet'ten uzak bir sayfa yüklediğinizde ApplicationDomain.currentDomain öğesini sayfanın uygulama etki alanı
olarak atayamazsınız.
Olay dinleyicilerini kaldırma
Runtime nesneleri, yüklenen SWF içeriğindeki nesneler ve hatta diğer sayfalarda çalışan JavaScript nesneleri de dahil
güncel sayfa dışındaki nesnelere JavaScript olay dinleyicileri eklediğinizde, sayfa boşaldığında her zaman bu olay
dinleyicilerini kaldırmalısınız. Aksi halde, olay dinleyicisi artık var olmayan bir işleyici işlevine olay gönderir. Bu
gerçekleşirse, şu hata mesajını görürsünüz: “Uygulama artık yüklenmeyen bir HTML sayfasındaki JavaScript
nesnesine başvuruda bulunmaya çalıştı." Gerekli olmayan olay dinleyicilerinin kaldırılması, AIR'in ilişkilendirilmiş
belleği geri istemesine olanak verir. Daha fazla bilgi için bkz. “Gezinilen HTML sayfalarındaki olay dinleyicilerini
kaldırma” sayfa 228.
HTML DOM ve JavaScript nesnelerine ActionScript'ten
erişme
HTMLLoader nesnesi complete olayını gönderdikten sonra, sayfaya ilişkin HTML DOM'daki (belge nesnesi modeli)
tüm nesnelere erişebilirsiniz. Erişilebilir nesneler görüntü öğelerininin (sayfadaki div ve p nesneleri gibi) yanı sıra
JavaScript değişkenleri ve işlevlerini kapsar. complete olayı, JavaScript sayfası load olayına karşılık gelir. complete
gönderilmeden önce DOM öğeleri, değişkenleri ve işlevleri ayrıştırılmamış veya oluşturulmamış olabilir. Mümkünse
HTML DOM'a erişmeden önce complete olayını bekleyin.
Örneğin, aşağıdaki HTML sayfasına bakın:
<html>
<script>
foo = 333;
function test() {
return "OK.";
}
</script>
<body>
<p id="p1">Hi.</p>
</body>
</html>
Bu basit HTML sayfası foo adlı bir JavaScript değişkeni ve test() adlı bir JavaScript işlevi tanımlar. Bunların her ikisi de
sayfanın genel window nesnesinin özellikleridir. Ayrıca, window.document nesnesi, getElementById() yöntemini
kullanarak erişebileceğiniz, (p1 kimliğiyle) adlandırılan P öğesini içerir. Sayfa yüklendiğinde (HTMLLoader nesnesi
complete olayını gönderdiğinde), bu nesnelerin her birine aşağıdaki ActionScript kodunda gösterildiği şekilde
ActionScript'ten erişebilirsiniz:
html.width = 300;
html.height = 300;
html.addEventListener(Event.COMPLETE, completeHandler);
var xhtml:XML =
<html>
<script>
foo = 333;
function test() {
return "OK.";
}
</script>
<body>
<p id="p1">Hi.</p>
</body>
</html>;
html.loadString(xhtml.toString());
function completeHandler(e:Event):void {
trace(html.window.foo); // 333
trace(html.window.document.getElementById("p1").innerHTML); // Hi.
trace(html.window.test()); // OK.
}
HTML öğesinin içeriğine erişmek için innerHTML özelliğini kullanın. Örneğin, önceki kod p1 adlı HTML öğesinin
içeriğini getirmek için html.window.document.getElementById("p1").innerHTML kullanır.
HTML sayfasının özelliklerini ActionScript'ten de ayarlayabilirsiniz. Örneğin, aşağıdaki örnek var olan HTMLLoader
nesnesine ilişkin başvuruyu kullanarak p1 öğesinin içeriğini ve sayfadaki foo JavaScript değişkeninin değerini ayarlar:
html.window.document.getElementById("p1").innerHTML = "Goodbye";
html.window.foo = 66;
SWF içeriğini HTML'e gömme
SWF içeriğini tarayıcıda olduğu gibi AIR uygulamasında da HTML içeriğine gömebilirsiniz. SWF içeriğini object
etiketini, embed etiketini veya her ikisini de kullanarak gömün.
Not: SWF içeriğini HTML sayfasında görüntülemek için object etiketi ve embed etiketinin her ikisini de kullanmak,
yaygın bir web geliştirme uygulamasıdır. Bu uygulamanın AIR'de hiçbir yararı yoktur. AIR'de görüntülenmesi için
içerikteki W3C standart object etiketinin kendisini kullanabilirsiniz. Aynı zamanda, tarayıcıda da görüntülenen
HTML içeriği için gerektiğinde object ve embed etiketlerinin ikisini birlikte kullanmaya devam edebilirsiniz.
Aşağıdaki örnek, bir SWF dosyasını HTML içeriğinde görüntülemek için HTML object etiketinin kullanımını
gösterir. SWF dosyası uygulama dizininden yüklenir, ancak AIR tarafından desteklenen herhangi bir URL şemasını
kullanabilirsiniz. (SWF dosyasının yüklendiği kaynak, AIR'in içeriği yerleştirdiği güvenlik sanal alanını belirler.)
<object type="application/x-shockwave-flash" width="100%" height="100%">
<param name="movie" value="app:/SWFFile.swf"></param>
</object>
İçeriği dinamik olarak yüklemek için bir komut dosyası da kullanabilirsiniz. Aşağıdaki örnek, urlString
parametresinde belirtilen SWF dosyasını görüntülemek üzere bir object düğümü oluşturur. Örnek, düğümü
elementID parametresiyle belirtilen kimliğe sahip sayfa öğesinin alt öğesi olarak ekler.
<script>
function showSWF(urlString, elementID){
var displayContainer = document.getElementById(elementID);
displayContainer.appendChild(createSWFObject(urlString,650,650));
}
function createSWFObject(urlString, width, height){
var SWFObject = document.createElement("object");
SWFObject.setAttribute("type","application/x-shockwave-flash");
SWFObject.setAttribute("width","100%");
SWFObject.setAttribute("height","100%");
var movieParam = document.createElement("param");
movieParam.setAttribute("name","movie");
movieParam.setAttribute("value",urlString);
SWFObject.appendChild(movieParam);
return SWFObject;
}
</script>
HTML sayfasında ActionScript kitaplıkları kullanma
AIR, sayfanın ActionScript sınıflarını derlenmiş bir SWF dosyasına yükleyebilmesi için HTML komut dosyası öğesini
genişletir. Kök uygulama klasörünün lib alt dizininde yer alan myClasses.swf adlı kitaplığı içe aktarmak için HTML
dosyasında yer alan aşağıdaki komut dosyasını dahil edin:
<script src="lib/myClasses.swf" type="application/x-shockwave-flash"></script>
Önemli: Kitaplığın düzgün biçimde yüklenmesi için tür niteliği type="application/x-shockwave-flash"
olmalıdır.
AIR dosyası paketlendiğinde lib dizini ve myClasses.swf dosyası da dahil edilmelidir.
İçe aktarılan sınıflara JavaScript Window nesnesinin runtime özelliği aracılığıyla erişin:
var libraryObject = new window.runtime.LibraryClass();
SWF dosyasındaki sınıflar paketler halinde düzenlenmişse, paket adını da eklemelisiniz. Örneğin, LibraryClass tanımı
utilities adlı paketteyse, aşağıdaki ifadeyi içeren sınıf örneğini oluşturursunuz:
var libraryObject = new window.runtime.utilities.LibraryClass();
Not: ActionScript SWF kitaplığını AIR'de yer alan bir HTML sayfasının parçası olarak kullanmak üzere derlemek için
acompc derleyicisini kullanın. Acompc yardımcı programı, Flex 3 SDK'nin parçasıdır ve Flex 3 SDK belgesinde açıklanır.
HTML DOM ve JavaScript nesnelerine içe aktarılan bir ActionScript
dosyasından erişme
<script> etiketi kullanılarak sayfaya aktarılmış bir SWF dosyasındaki ActionScript'ten HTML sayfasındaki nesnelere
erişmek için, window veya document gibi bir JavaScript nesnesine ilişkin başvuruyu ActionScript kodunda tanımlanan
bir işleve iletin. JavaScript nesnesine (veya iletilen başvuru aracılığıyla erişilebilen diğer nesnelere) erişmek için
işlevdeki başvuruyu kullanın.
Örneğin, aşağıdaki HTML sayfasına bakın:
<html>
<script src="ASLibrary.swf" type="application/x-shockwave-flash"></script>
<script>
num = 254;
function getStatus() {
return "OK.";
}
function runASFunction(window){
var obj = new runtime.ASClass();
obj.accessDOM(window);
}
</script>
<body onload="runASFunction">
<p id="p1">Body text.</p>
</body>
</html>
Bu basit HTML sayfası num adlı bir JavaScript değişkeni ve getStatus() adlı bir JavaScript işlevi içerir. Bunların her ikisi
de sayfanın window nesnesinin özellikleridir. Ayrıca, window.document nesnesi (p1 kimliğiyle) adlandırılan bir P
öğesi içerir.
Sayfa, ASClass sınıfını içeren “ASLibrary.swf” adlı ActionScript dosyasını yükler. ASClass, bu JavaScript nesnelerinin
değerlerini izleyen accessDOM() adlı bir işlev tanımlar. accessDOM() yöntemi JavaScript Window nesnesini
argüman olarak alır. Window başvurusunu kullanarak, aşağıdaki tanımda gösterildiği şekilde değişkenler, işlevler ve
DOM öğeleri dahil sayfadaki diğer nesnelere erişebilir:
public class ASClass{
public function accessDOM(window:*):void {
trace(window.num); // 254
trace(window.document.getElementById("p1").innerHTML); // Body text..
trace(window.getStatus()); // OK.
}
}
İçe aktarılan ActionScript sınıfından HTML sayfasının özelliklerini getirebilir ve ayarlayabilirsiniz. Örneğin, aşağıdaki
işlev sayfadaki p1 öğesinin içeriğini ayarlar ve foo JavaScript değişkeninin değerini belirler:
public function modifyDOM(window:*):void {
window.document.getElementById("p1").innerHTML = "Bye";
window.foo = 66;
Date ve RegExp nesnelerini dönüştürme
JavaScript ve ActionScript dillerinin her ikisi de Date ve RegExp sınıflarını tanımlar, ancak bu türdeki nesneler iki
yürütme bağlamı arasında otomatik olarak dönüştürülmez. Date ve RegExp nesnelerini farklı yürütme
bağlamlarındaki özellikleri ve işlev parametrelerini ayarlamak için kullanmadan önce eşdeğer türe dönüştürmelisiniz.
Örneğin, aşağıdaki ActionScript kodu, jsDate adlı JavaScript Date nesnesini ActionScript Date nesnesine
dönüştürür:
var asDate:Date = new Date(jsDate.getMilliseconds());
Aşağıdaki ActionScript kodu, jsRegExp adlı JavaScript RegExp nesnesini ActionScript RegExp nesnesine
dönüştürür:
var flags:String = "";
if (jsRegExp.dotAll) flags += "s";
if (jsRegExp.extended) flags += "x";
if (jsRegExp.global) flags += "g";
if (jsRegExp.ignoreCase) flags += "i";
if (jsRegExp.multiline) flags += "m";
var asRegExp:RegExp = new RegExp(jsRegExp.source, flags);
HTML stil sayfasını ActionScript'ten değiştirme
HTMLLoader nesnesi complete olayını gönderdiğinde, sayfadaki CSS stillerini inceleyebilir ve değiştirebilirsiniz.
Örneğin, aşağıdaki basit HTML belgesine bakın:
<html>
<style>
.style1A { font-family:Arial; font-size:12px }
.style1B { font-family:Arial; font-size:24px }
</style>
<style>
.style2 { font-family:Arial; font-size:12px }
</style>
<body>
<p class="style1A">
Style 1A
</p>
<p class="style1B">
Style 1B
</p>
<p class="style2">
Style 2
</p>
</body>
</html>
HTMLLoader nesnesi bu içeriği yükledikten sonra sayfadaki CSS stillerini burada gösterildiği şekilde
window.document.styleSheets dizisinin cssRules dizisi yoluyla değiştirebilirsiniz:
var html:HTMLLoader = new HTMLLoader( );
html.load(urlReq);
var styleSheet0:Object = html.window.document.styleSheets[0];
styleSheet0.cssRules[0].style.fontSize = "32px";
styleSheet0.cssRules[1].style.color = "#FF0000";
var styleSheet1:Object = html.window.document.styleSheets[1];
styleSheet1.cssRules[0].style.color = "blue";
styleSheet1.cssRules[0].style.font-family = "Monaco";
}
Bu kod CSS stillerini, elde edilen HTML belgesinin aşağıdaki gibi görüneceği biçimde ayarlar:
HTMLLoader nesnesi complete olayını gönderdikten sonra kodun sayfaya stiller ekleyebileceğini göz önünde
bulundurun.
Farklı güvenlik sanal alanlarında çapraz komut dosyası
içeriği
Çalıştırma zamanı güvenlik modeli kodu farklı kaynaklardan ayırır. Farklı güvenlik sanal alanlarında içerik için komut
dosyası oluşturarak bir güvenlik sanal alanındaki içeriğin diğer sanal alandaki seçilen özellikler ve yöntemlere
erişmesini sağlayabilirsiniz.
AIR güvenlik sanal alanları ve JavaScript kodu
AIR, bir etki alanındaki kodun diğer etki alanındaki içerikle etkileşime girmesini engelleyen bir aynı kaynak politikası
uygular. Tüm dosyalar, kaynakları temel alınarak bir sanal alana yerleştirilir. Genellikle uygulama sanal alanındaki
içerik aynı kaynak ilkesini ihlal edemez ve uygulama yükleme dizininin dışından yüklenen içerik için çapraz komut
dosyası oluşturur. Ancak, AIR uygulama dışı içeriğe ilişkin çapraz komut dosyası oluşturmanızı sağlayan birkaç teknik
sunar.
Bir teknik, uygulama içeriğini farklı bir güvenlik sanal alanına eşlemek için çerçeveleri veya iframe'leri kullanır.
Uygulamanın sanal alanlı bölümünden yüklenen tüm sayfalar, uzak etki alanından yüklenmiş gibi davranır. Örneğin,
bu içerik uygulama içeriğini example.com etki alanına yükleyerek example.com'dan yüklenen sayfalar için çapraz
komut dosyası oluşturabilir.
Teknik uygulama içeriğini farklı bir sanal alana yerleştirdiğinden, bu içerikte bulunan kod artık değerlendirilen
dizelerdeki kod yürütmesine ilişkin kısıtlamalara tabi değildir. Bu sanal alan eşleme tekniğini, uzak içerik için çapraz
komut dosyası oluşturmanız gerekmese bile, bu kısıtlamaları kolaylaştırmak için kullanabilirsiniz. İçeriği bu şekilde
eşlemek özellikle birden çok JavaScript çerçevesinden biriyle veya dizelerin değerlendirilmesine dayanan mevcut kodla
çalışırken kullanışlıdır. Ancak, güvenli olmayan içeriğin uygulama sanal alanı dışında çalışırken yerleştirilip ve
yürütülebiliyor olması riskini göz önünde bulundurun ve buna karşı önlem alın.
Aynı zamanda, başka bir sanal alana eşlenen uygulama içeriği AIR API'lerine erişimini kaybeder, bu nedenle sanal alan
eşleme tekniği AIR işlevlerini uygulama sanal alanının dışında yürütülen koda göstermek için kullanılamaz.
Diğer bir çapraz komut dosyası oluşturma tekniği, uygulama dışı sanal alandaki içerikle bunun uygulama sanal
alanında bulunan üst belgesindeki içerik arasında sanal alan köprüsü adı verilen bir arabirim oluşturmanıza olanak
verir. Köprü, alt içeriğin üst içerik tarafından tanımlanan özellikler ve yöntemlere erişmesini, üst içeriğin alt içerik
tarafından tanımlanan özellikler ve yöntemlere erişmesini, veya bunların her ikisini sağlar.
Son olarak, uygulama sanal alanından ve isteğe bağlı olarak diğer sanal alanlardan etki alanları arası XMLHttpRequests
de gerçekleştirebilirsiniz.
Daha fazla bilgi için bkz. “HTML kare ve iframe öğeleri” sayfa 201, “HTML güvenliği” sayfa 29, ve “XMLHttpRequest
nesnesi” sayfa 195.
Uygulama içeriğini uygulama dışı sanal alana yükleme
Uygulama içeriğinin uygulama yükleme dizininin dışından yüklenen içerik için güvenli biçimde çapraz komut dosyası
oluşturmasını sağlamak amacıyla, uygulama içeriğini harici içerikle aynı güvenlik sanal alanına yüklemek için kare
veya iframe öğelerini kullanın. Uzak içerik için çapraz komut dosyası oluşturmanız gerekmiyorsa, ancak yine de
uygulamanızın bir sayfasını uygulama sanal alanının dışından yüklemek istiyorsanız kaynak etki alanı olarak
http://localhost/ veya başka bir zararsız değer kullanın.
AIR, çerçeveye yüklenen uygulama dosyasının uygulama dışı bir sanal alana eşlenmesi gerekip gerekmediğini
belirlemenizi sağlayan kare öğesine yeni sandboxRoot ve documentRoot niteliklerini ekler. sandboxRoot URL'sinin
altındaki bir yola çözümlenen dosyalar bunun yerine documentRoot dizininden yüklenir. Güvenlik nedenleriyle, bu
şekilde yüklenen uygulama içeriği, sandboxRoot URL'sinden yüklenmiş gibi ele alınır.
sandboxRoot özelliği, kare içeriğinin yerleştirileceği sanal alan ve etki alanını belirlemek için kullanılacak URL'yi
belirtir. URL şemasının kullanması gereken file:, http: veya https:. İlişkili bir URL belirtirseniz, içerik uygulama
sanal alanında kalır.
documentRoot özelliği, çerçeve içeriğinin yükleneceği kaynak dizini belirtir. URL şemasının kullanması gereken
file:, app: veya app-storage:.
Aşağıdaki örnek, uygulamanın sanal alan alt dizinine yüklenen içeriği uzak sanal alanda ve www.example.com etki
alanında çalışacak biçimde eşler:
<iframe
src="http://www.example.com/local/ui.html"
sandboxRoot="http://www.example.com/local/"
documentRoot="app:/sandbox/">
</iframe>
ui.html sayfası aşağıdaki komut dosyası etiketini kullanarak yerel sanal alan klasöründen bir javascript dosyası
yükleyebilir:
<script src="http://www.example.com/local/ui.js"></script>
Ayrıca, aşağıdaki gibi komut dosyası etiketini kullanarak uzak sunucudaki bir dizinden de içerik yükleyebilir:
<script src="http://www.example.com/remote/remote.js"></script>
sandboxRoot URL'si, uzak sunucuda bulunan aynı URL'deki tüm içeriği maskeler. Yukarıdaki örnekte, AIR, isteği
yerel uygulama dizinine yeniden eşlediğinden www.example.com/local/ linkindeki (veya onun alt dizinlerinden
birindeki) uzak içeriğe erişemezsiniz. İstekler, sayfada gezinmesinden, XMLHttpRequest'ten veya tüm diğer içerik
yükleme yöntemlerinden türetilseler de yeniden eşlenirler.
Sanal alan köprü arabirimini kurma
Uygulama sanal alanındaki içeriğin uygulama dışı bir sanal alandaki içerik tarafından tanımlanan özellikler ve
yöntemlere erişmesi veya uygulama dışı içeriğin uygulama sanal alanındaki içerik tarafından tanımlanan özellikler
veya yöntemlere erişmesi gerektiğinde sanal alan köprüsü kullanmalısınız. Herhangi bir alt belgenin window nesnesine
ait childSandboxBridge ve parentSandboxBridge özellikleriyle bir köprü oluşturun.
Alt sanal alan köprüsü oluşturma
childSandboxBridge özelliği, alt belgenin üst belgedeki içeriğe bir arabirim göstermesine olanak verir. Arabirim
göstermek için childSandbox özelliğini alt belgedeki bir işleme veya nesneye ayarlarsınız. Böylece nesneye veya işleve
üst belgedeki içerikten erişebilirsiniz. Aşağıdaki örnek, alt belgede çalışan bir komut dosyasının bir işlev ve bir özellik
içeren nesneyi üst öğesine nasıl gösterdiğini açıklar:
var interface = {};
interface.calculatePrice = function(){
return ".45 cents";
}
interface.storeID = "abc"
window.childSandboxBridge = interface;
Bu alt içerik, “alt” kimliği atanmış bir iframe'e yüklendiyse, karenin childSandboxBridge özelliğini okuyarak üst
içerikten arabirime erişebilirsiniz.
var childInterface = document.getElementById("child").contentWindow.childSandboxBridge;
air.trace(childInterface.calculatePrice()); //traces ".45 cents"
air.trace(childInterface.storeID)); //traces "abc"
Üst sanal alan köprüsü oluşturma
parentSandboxBridge özelliği, üst belgenin alt belgedeki içeriğe bir arabirim göstermesine olanak verir. Üst belge,
arabirim göstermek için alt belgenin parentSandbox özelliğini üst belgede tanımlanmış bir işleve veya nesneye
ayarlar. Böylece nesneye veya işleve alt belgedeki içerikten erişebilirsiniz. Aşağıdaki örnek, üst karede çalışan bir komut
dosyasının işlev içeren bir nesneyi alt belgeye nasıl gösterdiğini açıklar:
var interface = {};
interface.save = function(text){
var saveFile = air.File("app-storage:/save.txt");
//write text to file
}
document.getElementById("child").contentWindow.parentSandboxBridge = interface;
Alt karedeki içerik, bu arabirimi kullanarak metni save.txt adlı bir dosyaya kaydedebilir, ancak dosya sistemine
bunun dışında herhangi bir erişimi olmayacaktır. Alt içerik saklama işlevini aşağıdaki şekilde çağırabilir:
var textToSave = "A string.";
window.parentSandboxBridge.save(textToSave);
Uygulama içeriği, diğer sanal alanlara mümkün olan en dar arabirimi göstermelidir. Uygulama dışı içerik, yanlışlıkla
veya kötü amaçla kod yerleştirmesine maruz kalabileceğinden yapısı gereği güvenilmez olarak ele alınmalıdır. Üst
sanal alan köprüsü aracılığıyla gösterdiğiniz arabirimin hatalı kullanımını engellemek için uygun korumaları yerine
koymalısınız.
Sayfa yükleme sırasında üst sanal alan köprüsüne erişme
Alt belgedeki komut dosyasının bir üst sanal alan köprüsüne erişmesi için, köprü komut dosyası çalıştırılmadan
kurulmalıdır. Yeni bir sayfa DOM'u oluşturulduğunda, ancak herhangi bir komut dosyası ayrıştırılmadan veya DOM
öğeleri eklenmeden pencere, kare ve iframe bir dominitialize olayı gönderir. Sayfa yapım sırasında, köprüyü alt
belgedeki tüm komut dosyalarının erişebileceği kadar erken oluşturmak için dominitialize olayını kullanabilirsiniz.
Aşağıdaki örnek, alt kareden gönderilen dominitialize olayına karşılık olarak üst sanal alan köprüsünün nasıl
oluşturulacağını gösterir:
<html>
<head>
<script>
var bridgeInterface = {};
bridgeInterface.testProperty = "Bridge engaged";
function engageBridge(){
document.getElementById("sandbox").contentWindow.parentSandboxBridge = bridgeInterface;
}
</script>
</head>
<body>
<iframe id="sandbox"
ondominitialize="engageBridge()"/>
</body>
</html>
Aşağıdaki child.html belgesi, alt içeriğin üst sanal alan köprüsüne nasıl erişebileceğini gösterir:
<html>
<head>
<script>
document.write(window.parentSandboxBridge.testProperty);
</script>
</head>
<body></body>
</html>
Kare yerine alt penceredeki dominitialize olayını dinlemek için dinleyiciyi window.open() işleviyle oluşturulan
yeni alt window nesnesine eklemelisiniz:
var childWindow = window.open();
childWindow.addEventListener("dominitialize", engageBridge());
childWindow.document.location = "http://www.example.com/air/child.html";
Bu durumda, uygulama içeriğini uygulama dışı bir sanal alana eşlemenin yolu yoktur. Bu teknik, yalnızca child.html
öğesi uygulama dizininin dışından yüklendiğinde kullanışlıdır. Yine de penceredeki uygulama içeriğini uygulama dışı
bir sanal alana eşleyebilirsiniz, ancak öncesinde alt belgeyi yüklemek ve bunu istenen sanal alana eşlemek için kendisi
çerçeveler kullanan bir ara sayfa yüklemelisiniz.
Pencere oluşturmak için HTMLLoader sınıfının createRootWindow() işlevini kullandığınızda, yeni pencere
createRootWindow() öğesinin çağrıldığı kaynak belgenin alt öğesi değildir.. Bu nedenle, çağıran pencere ve yeni
pencereye yüklenen uygulama dışı içerik arasında sanal alan köprüsü oluşturamazsınız. Bunun yerine, alt belgeyi
yüklemek için kendisi çerçeveler kullanan yeni pencereye bir ara pencere yükleme işlevini kullanmalısınız. Yeni
pencerenin üst belgesi ve kareye yüklenen alt belge arasında köprü oluşturabilirsiniz.
224
Bölüm 22: HTML ile ilgili olayları işleme
Olay işleme sistemi, programcıların kullanıcı girişlerine ve sistem olaylarına pratik bir şekilde yanıt vermesini sağlar.
Adobe® AIR™ olay modeli hem pratik, hem de standartlara uygundur. Belge Nesnesi Modeli (DOM) Düzey 3 Olaylar
Tanımlaması'na dayalı olarak, endüstri standartlarında bir olay işleme mimarisi olan olay modeli, programcılara güçlü
ve sezgisel bir olay işleme aracı sunar.
HTMLLoader olayları
Bir HTMLLoader nesnesi aşağıdaki ActionScript™ olaylarını gönderir:
Olay
Açıklama
htmlDOMInitialize
HTML belgesi oluşturulduğunda, ancak herhangi bir komut ayrıştırılmadan veya DOM düğümleri
sayfaya eklenmeden gönderilir.
complete
HTML sayfasındaki onload olayından hemen sonra, HTML DOM bir yükleme işlemine yanıt olarak
yaratıldığında gönderilir.
htmlBoundsChanged
contentWidth ve contentHeight özelliklerinden biri veya her ikisi de değiştiğinde gönderilir.
locationChange
HTMLLoader öğesinin konum özelliği değiştiğinde gönderilir.
scroll
HTML motoru kaydırma konumunu her değiştirdiğinde gönderilir. Scroll olaylarının nedeni sayfadaki
çapa linklerinde (# linkleri) gezinme veya window.scrollTo() yöntemine yapılan çağrılar olabilir.
Bir metin girişine veya metin alanına metin girmek de scroll olayına neden olabilir.
uncaughtScriptException
HTMLLoader öğesinde bir JavaScript istisnası oluştuğunda ve istisna JavaScript kodunda
yakalanmadığında gönderilir.
Bir ActionScript işlevini JavaScript olayı için de kaydedebilirsiniz (onClick gibi). Ayrıntılar için bkz. “DOM olaylarını
ActionScript ile işleme” sayfa 224.
DOM olaylarını ActionScript ile işleme
ActionScript işlevlerini JavaScript olaylarına yanıt vermesi için kaydedebilirsiniz. Örneğin aşağıdaki HTML içeriğini
düşünün:
<html>
<body>
<a href="#" id="testLink">Click me.</a>
</html>
Bir ActionScript işlevini sayfadaki herhangi bir olay için işleyici olarak kaydedebilirsiniz. Örneğin aşağıdaki kod
clickHandler() işlevini, HTML sayfasındaki testLink öğesinin onclick olayının dinleyicisi olarak ekler:
HTML ile ilgili olayları işleme
var html:HTMLLoader = new HTMLLoader( );
html.load(urlReq);
html.window.document.getElementById("testLink").onclick = clickHandler;
}
function clickHandler():void {
trace("You clicked it!");
}
Bu olaylar için kayıt yaparken addEventListener() yöntemini de kullanabilirsiniz. Örneğin önceki örnekteki
completeHandler() yöntemini aşağıdaki kodla değiştirebilirsiniz:
var testLink:Object = html.window.document.getElementById("testLink");
testLink.addEventListener("click", clickHandler);
}
Bir dinleyici belirli bir DOM öğesine başvurduğunda, olay dinleyicilerini eklemeden önce HTMLLoader üst öğesinin
complete olayını göndermesini beklemek yerinde bir uygulama olur. HTML sayfaları genellikle birden çok dosya
yükler ve tüm dosyalar yüklenip ayrıştırılana kadar HTML DOM tamamen oluşturulmaz. Tüm öğeler
oluşturulduğunda, HTMLLoader complete olayını gönderir.
Yakalanmayan JavaScript istisnalarına yanıt verme
Aşağıdaki HTML'ye bakın:
<html>
<head>
<script>
function throwError() {
var x = 400 * melbaToast;
}
</script>
</head>
<body>
<a href="#" onclick="throwError()">Click me.</a>
</html>
melbaToast adlı bilinmeyen değişkene başvuran throwError() JavaScript işlevini içerir:
JavaScript işlemi, JavaScript kodunda try/catch yapısıyla yakalanmayan geçersiz bir işlemle karşılaştığında, sayfayı
içeren HTMLLoader nesnesi bir HTMLUncaughtScriptExceptionEvent olayı gönderir. Aşağıdaki kodda olduğu gibi,
bu olay için bir işleyici kaydedebilirsiniz:
html.load(urlReq);
html.width = container.width;
html.height = container.height;
container.addChild(html);
html.addEventListener(HTMLUncaughtScriptExceptionEvent.UNCAUGHT_SCRIPT_EXCEPTION,
htmlErrorHandler);
function htmlErrorHandler(event:HTMLUncaughtJavaScriptExceptionEvent):void
{
trace("exceptionValue:", event.exceptionValue)
for (var i:int = 0; i < event.stackTrace.length; i++)
{
trace("sourceURL:", event.stackTrace[i].sourceURL);
trace("line:", event.stackTrace[i].line);
trace("function:", event.stackTrace[i].functionName);
}
}
JavaScript'in içinde, window.htmlLoader özelliğini kullanarak aynı olayı işleyebilirsiniz:
<html>
<head>
<script>
function throwError() {
}
function htmlErrorHandler(event) {
var message = "exceptionValue:" + event.exceptionValue + "\n";
for (var i = 0; i < event.stackTrace.length; i++){
message += "sourceURL:" + event.stackTrace[i].sourceURL +"\n";
message += "line:" + event.stackTrace[i].line +"\n";
message += "function:" + event.stackTrace[i].functionName + "\n";
}
alert(message);
}
window.htmlLoader.addEventListener("uncaughtScriptException", htmlErrorHandler);
</script>
</head>
<body>
<a href="#" onclick="throwError()">Click me.</a>
</html>
htmlErrorHandler() olay işleyicisi, olayın varsayılan davranışını (JavaScript hata mesajını AIR izleme çıktısına
göndermeyi) iptal eder ve kendi çıktı mesajını oluşturur. HTMLUncaughtScriptExceptionEvent nesnesinin
exceptionValue öğesinin değerini çıkarır. stackTrace dizisindeki her bir nesnenin özelliklerini çıkarır:
exceptionValue: ReferenceError: Can't find variable: melbaToast
sourceURL: app:/test.html
line: 5
function: throwError
sourceURL: app:/test.html
line: 10
function: onclick
Çalışma zamanı olaylarını JavaScript'le işleme
runtime sınıfları, addEventListener() yöntemiyle olay işleyicileri eklemeyi destekler. Bir olay için işleyici işlevi
eklemek üzere, olay türünü ve işleme işlevini sağlayarak olayı gönderen nesnenin addEventListener() yöntemini
çağırın. Örneğin kullanıcı başlık çubuğunda pencereyi kapatma düğmesini tıkladığında gönderilen closing olayını
dinlemek için, aşağıdaki ifadeyi kullanın:
window.nativeWindow.addEventListener(air.NativeWindow.CLOSING, handleWindowClosing);
Olay işleyici işlevi yaratma
Aşağıdaki kod, ana pencerenin konumu hakkında bilgi görüntüleyen basit bir HTML dosyası oluşturur.
moveHandler() adlı bir işleyici işlevi, ana pencerenin move olayını dinler (NativeWindowBoundsEvent sınıfı
tarafından tanımlanan).
<html>
<script src="AIRAliases.js" />
<script>
function init() {
writeValues();
window.nativeWindow.addEventListener(air.NativeWindowBoundsEvent.MOVE,
moveHandler);
}
function writeValues() {
document.getElementById("xText").value = window.nativeWindow.x;
document.getElementById("yText").value = window.nativeWindow.y;
}
function moveHandler(event) {
air.trace(event.type); // move
writeValues();
}
</script>
<body onload="init()" />
<table>
<tr>
<td>Window X:</td>
<td><textarea id="xText"></textarea></td>
</tr>
<tr>
<td>Window Y:</td>
<td><textarea id="yText"></textarea></td>
</tr>
</table>
</body>
</html>
Bir kullanıcı pencereyi taşıdığında, metin alanı öğeleri pencerenin güncellenen X ve Y konumlarını görüntüler.
Olay nesnesinin bir argüman olarak moveHandler() yöntemine iletildiğine dikkat edin. Olay parametresi işleyici
işlevinizin olay nesnesini incelemesini sağlar. Bu örnekte olay nesnesinin type özelliğini, olayın bir move olayı
olduğunu bildirmek için kullanırsınız.
Olay dinleyicilerini kaldırma
Artık ihtiyacınız olmayan bir olay dinleyicisini kaldırmak için removeEventListener() yöntemini kullanabilirsiniz.
Artık kullanılmayacak olan olay dinleyicilerinin tümünü kaldırmak yararlı olacaktır. Gerekli parametreler eventName
ve listener parametreleridir, bunlar addEventListener() yöntemi için gereken parametrelerle aynıdır.
Gezinilen HTML sayfalarındaki olay dinleyicilerini kaldırma
HTML içeriği gezindiğinde veya içeriğe sahip pencere kapatıldığı için HTML içeriği atıldığında, boşaltılan sayfadaki
nesnelere başvuran olay dinleyicileri otomatik olarak kaldırılmaz. Bir nesne, işleyiciye önceden boşaltılmış bir olay
gönderdiğinde, şu hata mesajını görürsünüz: "Uygulama, artık yüklü olmayan bir HTML sayfasındaki JavaScript
nesnesine başvurma girişiminde bulundu." (The application attempted to reference a JavaScript object in an HTML
page that is no longer loaded.)
Bu hatayı önlemek için, atılmadan önce HTML sayfasındaki JavaScript olay dinleyicilerini kaldırın. Sayfa gezinmesi
durumunda (HTMLLoader nesnesinin içinde), window nesnesinin unload olayı sırasında olay dinleyicisini kaldırın.
Örneğin aşağıdaki JavaScript kodu, uncaughtScriptException olayı için bir olay dinleyicisini kaldırır:
window.onunload = cleanup;
window.htmlLoader.addEventListener('uncaughtScriptException', uncaughtScriptException);
function cleanup()
{
window.htmlLoader.removeEventListener('uncaughtScriptException',
uncaughtScriptExceptionHandler);
}
HTML içeriğine sahip pencereler kapatılırken hata oluşmasını önlemek için, NativeWindow nesnesinin
(window.nativeWindow) closing olayına yanıt olarak bir temizleme işlevi çağırın. Örneğin aşağıdaki JavaScript
kodu, uncaughtScriptException olayı için bir olay dinleyicisini kaldırır:
window.nativeWindow.addEventListener(air.Event.CLOSING, cleanup);
function cleanup()
{
window.htmlLoader.removeEventListener('uncaughtScriptException',
uncaughtScriptExceptionHandler);
}
Ayrıca bir olay dinleyicisini çalışır çalışmaz kaldırarak da bu hatanın oluşmasını önleyebilirsiniz. Örneğin aşağıdaki
JavaScript kodu, HTMLLoader nesnesinin createRootWindow() yöntemini çağırarak bir html penceresi oluşturur ve
complete olayı için bir olay dinleyicisi ekler. complete olay işleyicisi çağrıldığında, removeEventListener() işlevini
kullanarak kendi olay dinleyicisini kaldırır:
var html = runtime.flash.html.HTMLLoader.createRootWindow(true);
html.addEventListener('complete', htmlCompleteListener);
function htmlCompleteListener()
{
html.removeEventListener(complete, arguments.callee)
// handler code..
}
html.load(new runtime.flash.net.URLRequest("second.html"));
Gerekmeyen olay dinleyicilerini kaldırmak da sistem çöp toplayıcısının bu dinleyicilerle ilişkilendirilen tüm belleği
geri istemesini sağlar.
Var olan olay dinleyicilerini kontrol etme
hasEventListener() yöntemi sayesinde bir nesnede olay dinleyicisi olup olmadığını kontrol edebilirsiniz.
230
Bölüm 23: HTML Kabı için Komut Dosyası
Oluşturma
HTMLLoader sınıfı, Adobe® AIR™ içindeki HTML içeriği için konteyner olarak görev yapar. Bu sınıf, ActionScript™
3.0 görüntü listesindeki nesnenin davranışı ve görünümünün denetlenmesi için Sprite sınıfından miras alınan birçok
özellik ve yöntem sağlar. Sınıf ayrıca, HTML içeriğinin yüklenmesi, HTML içeriğiyle etkileşim kurulması ve geçmişin
yönetilmesi gibi görevlere ilişkin özellikleri ve yöntemleri tanımlar.
HTMLHost sınıfı, HTMLLoader için bir dizi varsayılan davranış tanımlar. HTMLLoader nesnesini
oluşturduğunuzda, HTMLHost uygulaması sağlanmaz. Bu nedenle HTML içeriği pencere konumunun veya pencere
başlığının değiştirilmesi gibi varsayılan davranışlardan birini tetiklediğinde, hiçbir şey gerçekleşmez. Uygulamanız
için istenen davranışları tanımlamak için HTMLHost sınıfını genişletebilirsiniz.
AIR tarafından oluşturulan HTML pencereleri için varsayılan bir HTMLHost uygulaması sağlanmıştır. True olarak
ayarlanmış defaultBehavior parametresiyle oluşturulan yeni HTMLHost nesnesini kullanarak nesnenin htmlHost
özelliğini ayarlama yoluyla, varsayılan HTMLHost uygulamasını başka bir HTMLLoader nesnesine atayabilirsiniz.
HTMLLoader nesnelerinin görüntü özellikleri
HTMLLoader nesnesi, Adobe® Flash® Player Sprite sınıfının görüntü özelliklerini miras alır. Örneğin arka plan rengini
değiştirebilir, yeniden boyutlandırabilir, taşıyabilir ve gizleyebilirsiniz. Veya filtreler, maskeler, ölçeklendirme ve
döndürme gibi gelişmiş efektler uygulayabilirsiniz. Efektleri uygularken, okunaklılık üzerindeki etkilerini göz önüne
alın. HTML sayfasına yüklenen SWF ve PDF içeriği, bazı efektler uygulandığında görüntülenemez.
HTML pencereleri, HTML içeriğini oluşturan bir HTMLLoader nesnesi içerir. Bu nesne pencere alanı içinde
sınırlanmıştır, bu nedenle boyut, konum, döndürme veya ölçek faktörünün değiştirilmesi her zaman istenen sonuçları
vermez.
Temel görüntü özellikleri
HTMLLoader nesnesinin temel görüntü özellikleri, boyutu ayarlamak ve denetimi göstermek veya gizlemek için üst
display nesnesi içinde denetimi konumlandırmanıza olanak verir. HTML penceresinin HTMLLoader nesnesi için bu
özellikleri değiştirmemelisiniz.
Temel özellikler:
Özellik
Notlar
x, y
Nesneyi üst kabı içinde
geni lik, yükseklik
Görüntü alanının boyutlarını değiştirir.
görünür
Nesnenin ve sahip olduğu tüm içeriğin görünürlüğünü denetler.
HTML penceresi dışında, HTMLLoader nesnesinin geni lik ve yükseklik özellikleri varsayılan olarak 0'dır.
Yüklenen HTML içeriği görünür olmadan önce genişlik ve yüksekliği ayarlamalısınız. HTML içeriği HTMLLoader
boyutuna çizilir, içerikteki HTML ve CSS özelliklerine göre şekillendirilir. HTMLLoader boyutunun değiştirilmesi
içeriği yeniden akıtır.
HTML Kabı için Komut Dosyası Oluşturma
Yeni bir HTMLLoader nesnesine (halen 0 olarak ayarlanmış width içeren) içerik yüklerken HTMLLoader görüntü
geni li i ve yüksekli inicontentWidth ve contentHeight özelliklerini kullanarak ayarlamak size uygun
gelebilir. Bu teknik, HTML ve CSS akış kurallarına göre şekillendirildiğinde belirli bir minimum genişliğe sahip olan
sayfalar için çalışır. Ancak, bazı sayfalar HTMLLoader tarafından sağlanan belirli bir genişlik olmadığında uzun ve dar
bir mizanpajın içine akar.
Not: HTMLLoader nesnesinin genişliğini ve yüksekliğini değiştirdiğinizde, scaleX ve scaleY değerleri diğer birçok display
nesnesindekinin aksine değişmez.
HTMLLoader içeriğinin şeffaflığı
HTMLLoader nesnesinin varsayılan olarak true olan paintsDefaultBackground özelliği HTMLLoader nesnesinin
opak bir arka plan çizip çizmeyeceğini belirler. paintsDefaultBackground öğesi false olduğunda, arka plan boştur.
Display nesnesi konteyneri veya HTMLLoader nesnesinin altındaki diğer display nesneleri, HTML içeriğinin ön plan
öğelerinin arkasında görünür.
HTML belgesinin gövde öğesi veya diğer öğelerinden biri bir arka plan rengi belirlediğinde (örneğin,
style="background-color:gray"), HTML'in bu bölümünün arka plan rengi opaktır ve belirlenen arka plan
rengiyle oluşturulur. HTMLLoader nesnesinin opaqueBackground özelliğini ayarladığınızda ve
paintsDefaultBackground öğesi false olduğunda, opaqueBackground renk kümesi görünür.
Not: HTML belgesindeki öğe için alfa harmanlamalı bir arka plan sağlamak için şeffaf, PNG formatonda bir grafik
kullanabilirsiniz. HTML öğesinin opaklık stilini ayarlama desteklenmez.
HTMLLoader içeriğini ölçekleme
HTMLLoader nesnesini 1.0 dışında bir ölçek faktörüyle ölçeklemekten kaçının. HTMLLoader içeriğindeki metin
belirli bir çözünürlükte oluşturulur ve HTMLLoader nesnesi ölçeklendiğinde pikseller halinde görünebilir. Pencere
yeniden boyutlandırıldığında HTMLLoader nesnesi ve içeriğinin ölçeklenmesini engellemek için Sahne'nin
scaleMode özelliğini StageScaleMode.NO_SCALE olarak ayarlayın.
HTML sayfasına SWF ve PDF içeriği yüklenirken dikkate alınması gerekenler
HTMLLoader nesnesine yüklenen SWF ve PDF içeriği aşağıdaki koşullarda kaybolur:
• HTMLLoader nesnesini 1.0 dışında bir faktöre ölçeklerseniz.
• HTMLLoader nesnesinin alfa özelliğini 1.0 dışında bir değere ayarlarsanız.
• HTMLLoader içeriğini döndürürseniz.
Sorunlu özellik ayarını ve etkin filtreleri kaldırdığınızda içerik yeniden görünüz.
Not: Çalışma zamanı şeffaf pencerelerde SWF veya PDF içeriğini görüntüleyemez.
HTMLLoader öğesine bu tür ortamlar yükleme hakkında daha fazla bilgi için bkz. HTML sayfasında SWF içeriği
yükleme and “PDF içeriği ekleme” sayfa 244.
Gelişmiş görüntü özellikleri
HTMLLoader sınıfı, özel efektler için kullanılabilecek birçok yöntemi miras alır. Bu efektler HTMLLoader
görüntüsüyle kullanıldıklarında genellikle sınırlamalar içerir, ancak geçişler veya diğer geçici efektler için kullanışlı
olabilir. Örneğin, kullanıcı girdisi toplamak için bir iletişim penceresi görüntülediğinizde, kullanıcı iletişim kutusunu
kapatana kadar ana pencere görüntüsünü bulanıklaştırabilirsiniz. Benzer şekilde, bir pencereyi kapatırken
görüntünün yavaşça kapanmasını sağlayabilirsiniz.
Gelişmiş görüntü özellikleri şunları içerir:
Özellik
Sınırlamalar
alfa
HTML içeriğinin okunaklılığını azaltabilir
filtreler
HTML penceresinde, dış efektler pencere kenarı tarafından kesilir.
grafikler
Varsayılan arka plan dahil grafik komutlarıyla çizilen şekiller HTML içeriğinin altında görünür. Çizilen
şekillerin görünür olması için paintsDefaultBackground özelliği false olmalıdır.
opaqueBackground
Varsayılan arka planın rengini değiştirmez. Bu renk katmanının görünür olması için
paintsDefaultBackground özelliği false olmalıdır.
döndürme
Dikdörtgen HTMLLoader alanının köşeleri pencere kenarı tarafından kesilebilir. HTML içeriğine yüklenen
SWF ve PDF içeriği görüntülenmez.
scaleX, scaleY
Oluşturulan görüntü, 1'den büyük ölçek faktörlerinde pikseller halinde görünebilir. HTML içeriğine
yüklenen SWF ve PDF içeriği görüntülenmez.
dönü tür
HTML içeriğinin okunaklılığını azaltabilir. HTML görüntüsü pencere kenarı tarafından kesilebilir.
Dönüştürme döndürme, ölçekleme veya eğriltme içeriyorsa, HTML içeriğine yüklenen SWF ve PDF içeriği
görüntülenmez.
Aşağıdaki örnek, tüm HTML görüntüsünü bulanıklaştırmak için filtre dizisinin nasıl ayarlanacağını gösterir:
var urlReq:URLRequest = new URLRequest("http://www.adobe.com/");
html.load(urlReq);
html.width = 800;
html.height = 600;
var blur:BlurFilter = new BlurFilter(8);
var filters:Array = [blur];
html.filters = filters;
HTML içeriğini kaydırma
HTMLLoader sınıfı, HTML içeriği kaydırmayı denetlemenizi sağlayan aşağıdaki özellikleri içerir:
Özellik
Açıklama
contentHeight
HTML içeriğinin piksel cinsinden yüksekliği.
contentWidth
HTML içeriğinin piksel cinsinden genişliği.
scrollH
HTMLLoader nesnesinde HTML içeriğinin yatay kaydırma konumu.
scrollV
HTMLLoader nesnesinde HTML içeriğinin dikey kaydırma konumu.
Aşağıdaki kod, scrollV özelliğini HTML içeriğinin sayfanın altına kaydırılacağı şekilde ayarlar.
html.addEventListener(Event.HTML_BOUNDS_CHANGE, scrollHTML);
const SIZE:Number = 600;
html.width = SIZE;
html.height = SIZE;
var urlReq:URLRequest = new URLRequest("http://www.adobe.com");
html.load(urlReq);
this.addChild(html);
function scrollHTML(event:Event):void
{
html.scrollV = html.contentHeight - SIZE;
}
HTMLLoader, yatay ve dikey kaydırma çubukları içermez. Kaydırma çubuklarını ActionScript'te uygulayabilirsiniz.
Kaydırma çubuklarına sahip bir HTMLLoader nesnesi içeren bir pencere oluşturmak için
HTMLLoader.createRootWindow() yöntemini de kullanabilirsiniz (bkz. “HTML içeriğini kaydırarak pencereler
oluşturma” sayfa 242).
HTML geçmiş listesine erişme
HTMLLoader nesnesine yeni sayfalar yüklendiğinde, çalışma zamanı nesneye ilişkin bir geçmiş listesi tutar. Geçmiş
listesi, HTML sayfasındaki window.history nesnesine karşılık gelir. HTMLLoader nesnesi HTML geçmiş listesiyle
çalışmanızı sağlayan aşağıdaki özellikler ve yöntemleri içerir:
Sınıf üyesi
Açıklama
historyLength
Geri ve ileri girişler dahil, geçmiş listesinin tam uzunluğu.
historyPosition
Geçmiş listesindeki geçerli konum. Bu konumun önündeki geçmiş öğeleri “geri” gezinmeyi, arkasındaki öğeler
“ileri” gezinmeyi temsil eder.
historyAt()
Geçmiş listesinde belirtilen konumdaki geçmiş girişine karşılık gelen URLRequest nesnesini döndürür.
historyBack()
Mümkinse geçmiş listesinde geriye doğru gezinir.
historyForward()
Mümkinse geçmiş listesinde geriye doğru gezinir.
historyGo()
Tarayıcı geçmişinde belirtilen adım sayısı kadar gezinir. Pozitifse ileriye, negatifse geriye doğru gezinir. Sıfıra
doğru gezinme, sayfayı yeniden yükler. Liste sonunun ardındaki bir konum belirtildiğinde, listenin sonuna
gider.
Geçmiş listesindeki öğeler, HistoryListItem türünde nesneler olarak saklanır. HistoryListItem sınıfı, aşağıdaki
özelliklere sahiptir:
Özellik
Açıklama
isPost
HTML sayfası POST verileri içeriyorsa true olarak ayarlanır.
originalUrl
HTML sayfasının tüm yeniden yönlendirmelerden önceki orijinal URL'si.
ba lık
HTML sayfasının başlığı.
url
HTML sayfasının URL'si.
HTML içeriği yüklenirken kullanılan kullanıcı aracısını
ayarlama
HTMLLoader sınıfı, HTMLLoader tarafından kullanılan kullanıcı aracısı dizesini ayarlamanızı sağlayan userAgent
özelliğini içerir. load() yöntemini çağırmadan önce HTMLLoader nesnesinin userAgent özelliğini ayarlayın.
HTMLLoader nesnesinde bu özelliği ayarladığınızda, load() yöntemine iletilen URLRequest öğesinin userAgent
özelliği kullanılmaz.
Bir uygulama etki alanındaki tüm HTMLLoader nesneleri tarafından kullanılan varsayılan kullanıcı aracısını
URLRequestDefaults.userAgent özelliğini kullanarak ayarlayabilirsiniz. Statik URLRequestDefaults özellikleri,
yalnızca HTMLLoader nesnelerinin load() yöntemiyle kullanılan URLRequest nesneleri için değil, tüm URLRequest
nesneleri için varsayılan olarak geçerlidir. HTMLLoader nesnesinin userAgent özelliğinin ayarlanması, varsayılan
URLRequestDefaults.userAgent ayarını geçersiz kılar.
HTMLLoader nesnesinin userAgent özelliği veya URLRequestDefaults.userAgent için kullanıcı aracı değeri
ayarlamazsanız, varsayılan AIR kullanıcı aracı değeri kullanılır. Bu varsayılan değer, aşağıdaki iki örnekte olduğu gibi
çalışma zamanı işletim sistemine (Mac OS veya Windows gibi), çalışma zamanı diline ve çalışma zamanı sürümüne
bağlı olarak değişir:
•
"Mozilla/5.0 (Macintosh; U; PPC Mac OS X; en) AppleWebKit/420+ (KHTML, like Gecko)
AdobeAIR/1.0"
•
"Mozilla/5.0 (Windows; U; en) AppleWebKit/420+ (KHTML, like Gecko) AdobeAIR/1.0"
HTML içeriğinde kullanım için karakter kodlamasını
ayarlama
HTML sayfası, aşağıdaki şekilde meta etiketini dahil ederek kullandığı karakter kodlamasını belirleyebilir:
meta http-equiv="content-type" content="text/html" charset="ISO-8859-1";
HTMLLoader nesnesinin textEncodingOverride özelliğini ayarlayarak belirli bir karakter kodlamasının
kullanılmasını sağlamak için sayfa ayarını geçersiz kılın:
html.textEncodingOverride = "ISO-8859-1";
HTML sayfası, HTMLLoader nesnesinin textEncodingFallback özelliğini içeren bir ayar belirtmediğinde
kullanılacak HTMLLoader içeriğine ilişkin karakter kodlamasını belirleyin:
html.textEncodingFallback = "ISO-8859-1";
textEncodingOverride özelliği, HTML sayfasındaki ayarı geçersiz kılar. Ve textEncodingOverride özelliği ile
HTML sayfasındaki ayar, textEncodingFallback özelliğini geçersiz kılar.
HTML içeriğini yüklemeden önce textEncodingOverride özelliğini veya textEncodingFallback özelliğini
ayarlayın.
HTML içeriği için tarayıcı benzeri kullanıcı arabirimleri
tanımlama
JavaScript, HTML içeriğini görüntüleyen pencerenin denetlenmesi için birkaç çeşitli API'ler sağlar. Bu API'ler, AIR'de
özel bir HTMLHost sınıfının uygulanmasıyla geçersiz kılınabilir.
HTMLHost sınıfının genişletilmesi hakkında
Örneğin, uygulamanız sekmeli arabirimde birden çok HTMLLoader nesnesi sunuyorsa, ana pencere başlığını değil,
sekmenin etiketini değiştirmek için yüklenen HTML sayfaları tarafından başlık değişikliklerinin yapılmasını
isteyebilirsiniz. Benzer şekilde kodunuz üst görüntüleme nesnesi konteynerindeki HTMLLoader nesnesini yeniden
konumlandırarak, HTMLLoader nesnesini içeren pencereyi taşıyarak, hiçbir şey yapmayarak veya tamamen farklı bir
şey yaparak bir window.moveTo() çağrısına yanıt verebilir.
AIR HTMLHost sınıfı, aşağıdaki JavaScript özellikleri ve yöntemlerini denetler:
•
window.status
•
window.document.title
•
window.location
•
window.blur()
•
window.close()
•
window.focus()
•
window.moveBy()
•
window.moveTo()
•
window.open()
•
window.resizeBy()
•
window.resizeTo()
new HTMLLoader() kullanarak bir HTMLLoader nesnesi oluşturduğunuzda, listelenen JavaScript özellikleri ve
yöntemleri etkinleştirilmez. HTMLHost sınıfı, bu JavaScript API'lerinin varsayılan, tarayıcı benzeri bir uygulamasını
sağlar. Davranışı özelleştirmek için ayrıca HTMLHost sınıfını genişletebilirsiniz. Varsayılan davranışı destekleyen bir
HTMLHost nesnesi oluşturmak için HTMLHost yapıcısındaki defaultBehaviors parametresini true olarak
ayarlayın:
var defaultHost:HTMLHost = new HTMLHost(true);
AIR'de HTMLLoader sınıfının createRootWindow() yöntemiyle bir HTML penceresi oluşturduğunuzda, varsayılan
davranışları destekleyen bir HTMLHost örneği otomatik olarak atanır. HTMLLoader nesnesinin htmlHost özelliğine
farklı bir HTMLHost uygulaması atayarak ana bilgisayar nesne davranışını değiştirebilir veya özellikleri tamamen
devre dışı bırakmak için null değerini atayabilirsiniz.
Not: AIR, HTML tabanlı bir AIR uygulaması için oluşturulan ilk pencereye ve JavaScript window.open() yönteminin
varsayılan uygulamasıyla oluşturulan tüm pencerelere varsayılan bir HTMLHost nesnesi atar.
Örnek: HTMLHost sınıfını genişletme
Aşağıdaki örnek, HTMLHost sınıfının genişletilmesi yoluyla HTMLLoader nesnesinin kullanıcı arabirimini etkileme
biçiminin nasıl özelleştirildiğini gösterir:
1 AIR için bir Flash dosyası oluşturun. Bu dosyanın document sınıfını CustomHostExample olarak ayarlayın ve daha
sonra dosyayı CustomHostExample.fla olarak kaydedin.
2 HTMLHost sınıfını (alt sınıf) genişleten bir sınıf içeren CustomHost.as adlı bir ActionScript dosyası oluşturun. Bu
sınıf, kullanıcı arabirimi ilişkili ayarlardaki değişiklikleri işlemek için yeni sınıfın yöntemlerini geçersiz kılar.
Örneğin, aşağıdaki CustomHost sınıfı window.open() çağrılarına ilişkin davranışları tanımlar ve
window.document.title olarak değişir. window.open() yöntemine yapılan çağrılar HTML sayfasını yeni bir
pencerede açar ve bu pencerenin başlık window.document.title özelliğini (HTML sayfasının <title> öğesi
dahil) olarak ayarlamak üzere değiştirir.
package
{
import
import
import
import
import
import
import
import
import
import
flash.display.StageScaleMode;
flash.display.NativeWindowInitOptions;
flash.events.Event;
flash.events.NativeWindowBoundsEvent;
flash.geom.Rectangle;
flash.html.HTMLLoader;
flash.html.HTMLHost;
flash.html.HTMLWindowCreateOptions;
public class CustomHost extends HTMLHost
{
public var statusField:TextField;
public function CustomHost(defaultBehaviors:Boolean=true)
{
super(defaultBehaviors);
}
override public function windowClose():void
{
htmlLoader.stage.nativeWindow.close();
}
override public function createWindow(
windowCreateOptions:HTMLWindowCreateOptions ):HTMLLoader
{
var initOptions:NativeWindowInitOptions = new NativeWindowInitOptions();
var bounds:Rectangle = new Rectangle(windowCreateOptions.x,
windowCreateOptions.y,
windowCreateOptions.width,
windowCreateOptions.height);
var htmlControl:HTMLLoader = HTMLLoader.createRootWindow(true, initOptions,
windowCreateOptions.scrollBarsVisible, bounds);
htmlControl.htmlHost = new HTMLHostImplementation();
if(windowCreateOptions.fullscreen){
htmlControl.stage.displayState =
StageDisplayState.FULL_SCREEN_INTERACTIVE;
}
return htmlControl;
}
override public function updateLocation(locationURL:String):void
{
trace(locationURL);
}
override public function set windowRect(value:Rectangle):void
{
htmlLoader.stage.nativeWindow.bounds = value;
}
override public function updateStatus(status:String):void
{
statusField.text = status;
trace(status);
}
override public function updateTitle(title:String):void
{
htmlLoader.stage.nativeWindow.title = title + "- Example Application";
}
override public function windowBlur():void
{
htmlLoader.alpha = 0.5;
}
override public function windowFocus():void
{
htmlLoader.alpha = 1;
}
}
}
3 Uygulamaya ilişkin document sınıfını içerecek CustomHostExample.as adlı başka bir ActionScript dosyası
oluşturun. Bu sınıf HTMLLoader nesnesini oluşturur ve bu nesnenin host özelliğini önceki adımda tanımlanan
CustomHost sınıfı örneğine ayarlar:
package
{
import
import
import
import
flash.html.HTMLLoader;
public class CustomHostExample extends Sprite
{
function CustomHostExample():void
{
html.width = 550;
html.height = 380;
var host:CustomHost = new CustomHost();
html.htmlHost = host;
var urlReq:URLRequest = new URLRequest("Test.html");
html.load(urlReq);
addChild(html);
var statusTxt:TextField = new TextField();
statusTxt.y = 380;
statusTxt.height = 20;
statusTxt.width = 550;
statusTxt.background = true;
statusTxt.backgroundColor = 0xEEEEEEEE;
addChild(statusTxt);
host.statusField = statusTxt;
}
}
}
Burada açıklanan kodu test etmek için, aşağıdaki içeriğe sahip bir HTML dosyasını uygulama dizinine dahil edin:
<html>
<head>
<title>Test</title>
<script>
function openWindow()
{
document.title = "Test"
window.open('Test.html');
}
</script>
</head>
<body bgColor="#EEEEEE">
<a href="#" onclick="window.open('Test.html')">window.open('Test.html')</a>
<br/><a href="#" onclick="window.document.location='http://www.adobe.com'">
window.document.location = 'http://www.adobe.com'</a>
<br/><a href="#" onclick="window.moveBy(6, 12)">moveBy(6, 12)</a>
<br/><a href="#" onclick="window.close()">window.close()</a>
<br/><a href="#" onclick="window.blur()">window.blur()</a>
<br/><a href="#" onclick="window.focus()">window.focus()</a>
<br/><a href="#" onclick="window.status = new Date().toString()">window.status=new
Date().toString()</a>
</body>
</html>
Window.location özelliğindeki değişiklikleri işleme
HTML sayfasının URL'sindeki değişiklikleri işlemek için locationChange() yöntemini geçersiz kılın. Bir sayfadaki
JavaScript window.location değerini değiştirdiğinde locationChange() yöntemi çağrılır. Aşağıdaki örnek istenen
URL'yi yükler:
override public function updateLocation(locationURL:String):void
{
htmlLoader.load(new URLRequest(locationURL));
}
Not: Geçerli HTMLLoader nesnesine başvurmak için HTMLHost nesnesinin htmlLoader özelliğini kullanabilirsiniz.
window.moveBy(), window.moveTo(), window.resizeTo(), window.resizeBy()
için JavaScript çağrılarını işleme
HTML içeriğinin sınırlarındaki değişiklikleri işlemek için set windowRect() yöntemini geçersiz kılın. Bir sayfadaki
JavaScript window.moveBy(), window.moveTo(), window.resizeTo(), or window.resizeBy() çağırdığında, set
windowRect() yöntemi çağrılır. Aşağıdaki örnek, masaüstü penceresinin sınırlarını günceller:
override public function set windowRect(value:Rectangle):void
{
htmlLoader.stage.nativeWindow.bounds = value;
}
window.open() için JavaScript çağrılarını işleme
window.open() için JavaScript çağrılarını işlemek üzere createWindow() yöntemini geçersiz kılın. createWindow()
yöntemi uygulamaları, yeni bir HTMLLoader nesnesi oluşturmak ve döndürmekle sorumludur. HTMLLoader
nesnesini genellikle yeni bir pencerede görüntülersiniz, ancak pencere oluşturma zorunlu değildir.
Aşağıdaki örnek, window ve HTMLLoader nesnesi oluşturmak için HTMLLoader.createRootWindow() kullanan
createWindow() işlevinin nasıl uygulanacağını gösterir. Buna ek olarak, bir NativeWindow nesnesini ayrıca
oluşturabilir ve HTMLLoader nesnesini pencere sahnesine ekleyebilirsiniz.
override public function createWindow(windowCreateOptions:HTMLWindowCreateOptions):HTMLLoader{
var bounds:Rectangle = new Rectangle(windowCreateOptions.x, windowCreateOptions.y,
windowCreateOptions.width, windowCreateOptions.height);
var htmlControl:HTMLLoader = HTMLLoader.createRootWindow(true, initOptions,
windowCreateOptions.scrollBarsVisible, bounds);
htmlControl.htmlHost = new HTMLHostImplementation();
if(windowCreateOptions.fullscreen){
htmlControl.stage.displayState = StageDisplayState.FULL_SCREEN_INTERACTIVE;
}
return htmlControl;
}
Not: Bu örnek, window.open() ile oluşturulan tüm yeni pencerelere özel HTMLHost uygulamasını atar. Ayrıca farklı
bir uygulama kullanabilir veya istediğinizde yeni pencereler için htmlHost özelliğini null değerine ayarlayabilirsiniz.
Parametre olarak createWindow() yöntemine iletilen nesne, bir HTMLWindowCreateOptions nesnesidir.
HTMLWindowCreateOptions sınıfı, window.open() çağrısındaki features parametre dizesinde değerleri bildiren
özellikleri içerir:
HTMLWindowCreateOptions özelliği
window.open() JavaScript çağrısındaki features dizesinde
karşılık gelen ayar
fullscreen
tam ekran
height
yükseklik
locationBarVisible
konum
menuBarVisible
menü çubu u
resizeable
yeniden boyutlandırılabilir
scrollBarsVisible
kaydırma çubukları
statusBarVisible
durum
toolBarVisible
araç çubu u
width
geni lik
x
sol veya screenX
y
üst veya screenY
HTMLLoader sınıfı, özellik dizesinde belirtilebilecek tüm özellikleri uygulamaz. Uygulamanız gerektiğinde kaydırma
çubukları, konum çubukları, menü çubukları, durum çubukları ve araç çubukları sağlamalıdır.
JavaScript window.open() yöntemine ilişkin diğer argümanlar sistem tarafından işlenir. createWindow()
uygulaması, HTMLLoader nesnesine içerik yükleyemez veya pencere başlığını ayarlayamaz.
window.close() için JavaScript çağrılarını işleme
Window.close() yöntemine JavaScript çağrılarını işlemek için windowClose() yöntemini geçersiz kılın. Aşağıdaki
örnek, window.close() yöntemi çağrıldığında masaüstü penceresini kapatır:
{
htmlLoader.stage.nativeWindow.close();
}
window.close() için JavaScript çağrılarının var olan pencereyi kapatması gerekmez. Örneğin, aşağıdaki örnekte
olduğu gibi pencereyi (başka bir içeriğe sahip olabilir) açık bırakarak görüntü listesinden HTMLLoader nesnesini
kaldırabilirsiniz:
{
htmlLoader.parent.removeChild(htmlLoader);
}
window.status özelliğindeki değişiklikleri işleme
window.status değerindeki JavaScript değişikliklerini işlemek için updateStatus() yöntemini geçersiz kılın.
Aşağıdaki örnek durum değerini izler:
override public function updateStatus(status:String):void
{
trace(status);
}
İstenen durum dize olarak updateStatus() yöntemine iletilir.
HTMLLoader nesnesi durum çubuğu sağlamaz.
window.document.title özelliğindeki değişiklikleri işleme
window.document.title değerindeki JavaScript değişikliklerini işlemek için updateTitle() yöntemini geçersiz
kılın. Aşağıdaki örnek, pencere başlığını değiştirir ve başlığa "Örnek," dizesini ekler:
override public function updateTitle(title:String):void
{
htmlLoader.stage.nativeWindow.title = title + " - Sample";
}
HTML sayfasında document.title ayarlandığında, istenen başlık dize olarak updateTitle() yöntemine iletilir.
document.title öğesindeki değişiklikler, HTMLLoader nesnesini içeren pencerenin başlığını değiştirmek zorunda
değildir. Örneğin metin alanı gibi başka bir arabirim öğesini değiştirebilirsiniz.
window.blur() ve window.focus() için JavaScript çağrılarını işleme
Aşağıdaki örnekte gösterildiği gibi window.blur() ve window.focus() için JavaScript çağrılarını işlemek için
windowBlur() ve windowFocus() yöntemlerini geçersiz kılın:
override public function windowBlur():void
{
}
override public function windowFocus():void
{
NativeApplication.nativeApplication.activate(htmlLoader.stage.nativeWindow);
}
Not: AIR, bir pencerenin veya bir uygulamanın devre dışı bırakılması için API sağlamaz.
HTML içeriğini kaydırarak pencereler oluşturma
HTMLLoader sınıfı, bir HTMLLoader nesnesi içeren ve bu pencere için bazı kullanıcı arabirimi ayarları tanımlayan
yeni bir pencere (bir NativeWindow nesnesi tarafından temsil edilen) açmanızı sağlayan,
HTMLLoader.createRootWindow() adında statik bir yöntem içerir. Bu yöntem, kullanıcı arabirimini tanımlamanızı
sağlayan dört parametre içerir:
Parametre
Açıklama
visible
Pencerenin başlangıçta görünür olup olmadığını belirten bir Boolean değeri (true veya false).
windowInitOptions
NativeWindowInitOptions nesnesi. NativeWindowInitOptions sınıfı, NativeWindow nesnesi için aşağıdaki
başlatma seçeneklerini tanımlar: pencerenin küçültülebilir, büyütülebilir veya yeniden boyutlandırılabilir olup
olmadığı, pencerenin sistem kromu veya özel krom içerdiği, pencerenin şeffaf olup olmadığı (sistem kromu
kullanmayan pencereler için) ve pencerenin türü.
scrollBarsVisible
Kaydırma çubuklarının olup olmadığı (true veya false).
bounds
Yeni pencerenin konumunu ve boyutunu tanımlayan bir Rectangle nesnesi.
Örneğin, aşağıdaki kod kaydırma çubukları kullanan HTMLLoader içeriğine sahip bir pencere oluşturmak için
HTMLLoader.createRootWindow() yöntemini kullanır:
var bounds:Rectangle = new Rectangle(10, 10, 600, 400);
var html2:HTMLLoader = HTMLLoader.createRootWindow(true, initOptions, true, bounds);
var urlReq2:URLRequest = new URLRequest("http://www.example.com");
html2.load(urlReq2);
html2.stage.nativeWindow.activate();
Not: Doğrudan JavaScript içinde createRootWindow() çağrılarak oluşturulan pencereler açılan HTML penceresinden
bağımsız kalır. Örneğin, JavaScript Window opener ve parent özellikleri null değerindedir. Ancak,
createRootWindow() yöntemini dolaylı olarak createRootWindow() çağıran createWindow() yöntemini geçersiz
kılarak çağırırsanız, opener ve parent açılan HTML penceresine başvurur.
HTMLLoader sınıfının alt sınıflarını oluşturma
Yeni davranışlar oluşturmak için, HTMLLoader sınıfının alt sınıflarını oluşturabilirsiniz. Örneğin, HTMLLoader
olayları için varsayılan olay dinleyicilerini tanımlayan bir alt sınıf oluşturabilirsiniz (HTML oluşturulduğunda veya
kullanıcı bir linki tıklattığında gönderilen olaylar gibi).
Aşağıdaki örnek, JavaScript window.open() yöntemi çağrıldığında normal davranış sağlamak için HTMLHost
sınıfını genişletir. Örnek daha sonra özel HTMLHost uygulama sınıfını kullanan bir HTMLLoader alt sınıfı tanımlar:
package
{
import flash.html.HTMLLoader;
public class MyHTMLHost extends HTMLHost
{
public function MyHTMLHost()
{
super(false);
}
override public function createWindow(opts:HTMLWindowCreateOptions):void
{
var bounds:Rectangle = new Rectangle(opts.x, opts.y, opts.width, opts.height);
var html:HTMLLoader = HTMLLoader.createRootWindow(true,
initOptions,
opts.scrollBarsVisible,
bounds);
html.stage.nativeWindow.orderToFront();
return html
}
}
Aşağıdaki örnek, htmlHost özelliğine bir MyHTMLHost nesnesi atayan HTMLLoader sınıfının alt sınıfını tanımlar:
package
{
import flash.html.HTMLLoader;
import MyHTMLHost;
import HTMLLoader;
public class MyHTML extends HTMLLoader
{
public function MyHTML()
{
super();
htmlHost = new MyHTMLHost();
}
}
}
Bu örnekte kullanılan HTMLHost sınıfı ve HTMLLoader.createRootWindow() yöntemine ilişkin ayrıntılar için bkz.
“HTML içeriği için tarayıcı benzeri kullanıcı arabirimleri tanımlama” sayfa 235.
244
Bölüm 24: PDF içeriği ekleme
Adobe® AIR™'de çalışan uygulamalar yalnızca SWF ve HTML içeriği değil, PDF içeriği de oluşturabilir. AIR
uygulamaları, HTMLLoader sınıfını, WebKit motorunu ve Adobe® Reader® tarayıcı eklentisini kullanarak PDF içeriği
oluşturur. AIR uygulamasında, PDF içeriği uygulamanızın tam yükseklik ve genişliğine göre veya alternatif olarak
arabiriminin bir parçası olarak uzayabilir. Adobe Reader tarayıcı eklentisi PDF dosyasının AIR uygulamasındaki
görüntüsünü kontrol eder, böylece Reader araç çubuğu arabiriminde yapılan değişiklikler (konum, tutturma ve
görünürlük gibi) PDF dosyalarının AIR uygulamalarında ve tarayıcıda daha sonra görüntülenmesi için kalıcı duruma
gelir.
Önemli: Kullanıcı, AIR'de PDF içeriği oluşturmak için Adobe Reader ya da Adobe® Acrobat® 8.1 veya daha yeni bir
sürümü yüklemiş olmalıdır.
PDF Özelliklerini Saptama
Kullanıcı Adobe Reader veya Adobe Acrobat 8.1 ya da daha yeni bir sürüme sahip değilse, PDF içeriği AIR
uygulamasında görüntülenmez. Kullanıcının PDF içeriği oluşturup oluşturamayacağını saptamak için ilk önce
HTMLLoader.pdfCapability özelliğini kontrol edin. Bu özellik HTMLPDFCapability sınıfının aşağıdaki
sabitlerinden biri olarak ayarlanır:
Sabit
Açıklama
HTMLPDFCapability.STATUS_OK
Yeterli bir Adobe Reader sürümü (8.1 veya daha yeni) saptandı ve
PDF içeriği bir HTMLLoader nesnesine yüklenebilir.
HTMLPDFCapability.ERROR_INSTALLED_READER_NOT_FOUND
Herhangi bir Adobe Reader sürümü saptanmadı. Bir HTMLLoader
nesnesi PDF içeriğini görüntüleyemez.
HTMLPDFCapability.ERROR_INSTALLED_READER_TOO_OLD
Adobe Reader saptandı, ancak sürüm çok eski. Bir HTMLControl
nesnesi PDF içeriğini görüntüleyemez.
HTMLPDFCapability.ERROR_PREFERRED_READER_TOO_OLD
Yeterli bir Adobe Reader sürümü (8.1 veya daha yeni) saptandı, ancak
Adobe Reader'ın PDF içeriğini işlemek üzere ayarlanan sürümü
Reader 8.1'den eski. Bir HTMLConrol nesnesi PDF içeriğini
görüntüleyemez.
Not: Windows'ta, kullanıcının sisteminde Adobe Acrobat veya Adobe Reader 7.x ya da daha yeni bir sürüm
çalışmaktaysa, PDF yüklemeyi destekleyen daha yeni bir sürüm yüklenmiş olsa bile bu sürüm kullanılır. Bu durumda,
pdfCampability özelliğinin değeri HTMLPDFCapability.STATUS_OK ise, AIR uygulaması PDF içeriğini yüklemeye
çalışığında daha eski Acrobat veya Reader sürümü bir uyarı görüntüler (ve AIR uygulamasında istisna atılmaz). Bu son
kullanıcılarınız için olası bir durumsa, onlara uygulamanızı çalıştırdıkları sırada Acrobat'ı kapatmalarına ilişkin
talimatlar vermeyi deneyebilirsiniz. PDF içeriği kabul edilebilir bir zaman diliminde yüklenmiyorsa, bu talimatları
görüntülemek isteyebilirsiniz.
Aşağıdaki kod, kullanıcının PDF içeriğini bir AIR uygulamasıda görüntüleyip görüntüleyemeyeceğini belirtir. Eğer
görüntüleyemiyorsa, HTMLPDFCapability hata nesnesine karşılık gelen hata kodunu izler:
PDF içeriği ekleme
if(HTMLLoader.pdfCapability == HTMLPDFCapability.STATUS_OK)
{
trace("PDF content can be displayed");
}
else
{
trace("PDF cannot be displayed. Error code:", HTMLLoader.pdfCapability);
}
PDF içeriğini yükleme
Bir HTMLLoader örneği oluşturarak, bu örneğin boyutlarını ayarlayarak ve PDF yolunu yükleyerek AIR
uygulamasına bir PDF ekleyebilirsiniz.
Aşağıdaki örnek, harici bir siteden PDF yükler. URLRequest öğesini kullanılabilir harici bir PDF'e giden yolla
değiştirin.
var request:URLRequest = new URLRequest("http://www.example.com/test.pdf");
pdf = new HTMLLoader();
pdf.height = 800;
pdf.width = 600;
pdf.load(request);
container.addChild(pdf);
app ve app-storage gibi dosya URL'leri ve AIR'e özgü URL şemalarından da içerik yükleyebilirsiniz. Örneğin, aşağıdaki
kod uygulama dizininin PDF alt dizinindeki test.pdf dosyasını yükler:
app:/js_api_reference.pdf
AIR URL şemaları hakkında daha fazla bilgi için bkz. “URL'lerde AIR URL şemalarını kullanma” sayfa 271.
Komut dosyası PDF içeriği
PDF içeriğini tarayıcıdaki web sayfasındaki gibi kontrol etmek için JavaScript'i kullanabilirsiniz.
Acrobat'a ilişkin JavaScript geliştirmeleri aşağıdaki ek özellikleri sunar:
• Sayfa gezinmesini denetleme ve büyütme
• Belge içinde formları işleme
• Multimedya olaylarını denetleme
Adobe Acrobat'a yönelik JavaScript geliştirmelerine ilişkin tüm ayrıntılar
http://www.adobe.com/devnet/acrobat/javascript.html linklerindeki Adobe Acrobat Geliştirici Bağlantısı'nda
sunulmuştur.
HTML-PDF iletişim temelleri
HTML sayfasındaki JavaScript, PDF içeriğini temsil eden DOM nesnesinin postMessage() yöntemini çağırarak PDF
içeriğindeki JavaScript'e mesaj gönderebilir. Örneğin, aşağıdaki gömülü PDF içeriğini dikkate alın:
<object id="PDFObj" data="test.pdf" type="application/pdf" width="100%" height="100%"/>
Mevcut HTML içeriğinde aşağıdaki JavaScript kodu, PDF dosyasındaki JavaScript'e bir mesaj gönderir:
pdfObject = document.getElementById("PDFObj");
pdfObject.postMessage(["testMsg", "hello"]);
PDF dosyası, bu mesajın alınması için JavaScript'i dahil edebilir. Belge, klasör, sayfa, alan düzeyi ve toplu düzey
bağlamları dahil bazı bağlamlardaki PDF dosyalarına JavaScript kodu ekleyebilirsiniz. Burada yalnızca, PDF
dokümanı açıldığında değerlendirilen komut dosyalarını tanımlayan belge düzeyi bağlamı tartışılır.
PDF dosyası hostContainer nesnesine messageHandler özelliğini ekleyebilir. messageHandler özelliği, mesajları
yanıtlamak için işleyici işlevlerini tanımlayan bir nesnedir. Örneğin aşağıdaki kod, PDF dosyası tarafından ana
bilgisayar konteynerinden (PDF dosyasını içeren HTML içeriği) alınan mesajları işlemeye yönelik işlevi tanımlar:
this.hostContainer.messageHandler = {onMessage: myOnMessage};
function myOnMessage(aMessage)
{
if(aMessage[0] == "testMsg")
{
app.alert("Test message: " + aMessage[1]);
}
else
{
app.alert("Error");
}
}
HTML sayfasındaki JavaScript kodu, sayfada yer alan PDF nesnesinin postMessage() yöntemini çağırabilir. Bu
yöntemin çağrılması, PDF dosyasındaki belge düzeyinde JavaScript'e bir mesaj ("HTML'den Merhaba") gönderir:
<html>
<head>
<title>PDF Test</title>
<script>
function init()
{
pdfObject = document.getElementById("PDFObj");
try {
pdfObject.postMessage(["alert", "Hello from HTML"]);
}
catch (e)
{
alert( "Error: \n name = " + e.name + "\n message = " + e.message );
}
}
</script>
</head>
<body onload='init()'>
<object
id="PDFObj"
data="test.pdf"
type="application/pdf"
width="100%" height="100%"/>
</body>
</html>
Daha gelişmiş bir örnek ve JavaScript'e PDF dosyası eklemek üzere Acrobat 8 kullanmaya ilişkin bilgi için bkz. Adobe
AIR'de PDF içeriği için çapraz komut dosyası.
ActionScript'ten PDF içeriği için komut dosyası
ActionScript kodu (SWF içeriğindeki), PDF içeriğindeki JavaScript ile doğrudan iletişim kuramaz. Ancak,
ActionScript PSD içeriğini yükleyen bir HTMLLoader nesnesinde yüklenen HTML sayfasındaki JavaScript ile iletişim
kurabilir ve bu JavaScript kodu, yüklenen PDF sayfasındaki JavaScript ile iletişim kurabilir. Daha fazla bilgi için bkz.
“HTML ve JavaScript'te programlama” sayfa 206.
AIR'de PDF içeriği için bilinen sınırlamalar
Adobe AIR'deki PDF içeriği aşağıdaki sınırlamaları içerir:
• PDF içeriği saydam (transparent özelliğinin true olarak ayarlandığı) bir pencerede (bir NativeWindow nesnesi)
görüntülenemez.
• Bir PDF dosyasının görüntü düzeni, AIR uygulamasındaki diğer display nesnelerinden farklı çalışır. PDF içeriği
HTML görüntü düzenine göre doğru biçimde kesilse de, her zaman AIR uygulamasının görüntü düzenindeki
içeriğin en üstünde bulunacaktır.
• PDF içeriği tam ekran modundaki bir pencerede görüntülenmez (Sahne displayState özelliği
StageDisplayState.FULL_SCREEN veya StageDisplayState.FULL_SCREEN_INTERACTIVE olarak
ayarlandığında).
• PDF dosyası içeren bir HTMLLoader nesnesinin görsel özellikleri değiştirilemez. HTMLLoader nesnesinin
filters, alpha, rotation veya scaling özelliğinin değiştirilmesi, özellikler sıfırlanana kadar PDF dosyasını
görünmez duruma getirir. Bu durum, HTMLLoader nesnesi içeren display nesne konteynerlerinin özelliklerini
değiştirdiğinizde de geçerlidir.
• PDF içeriğine sahip NativeWindow nesnesine ait Stage nesnesinin scaleMode özelliği
StageScaleMode.NO_SCALE olarak ayarlanmalıdır.
• PDF dosyası içindeki içerik linklerinin tıklatılması, PDF içeriğinin kaydırma konumunu günceller. PDF dosyasının
dışındaki içerik linklerinin tıklatılması, PDF içeren HTMLLoader nesnesini yeniden yönlendirir (linkin hedefi yeni
bir pencere olsa da).
• PDF yorum oluşturma iş akışları, AIR 1.0'da çalışmaz.
248
Bölüm 25: Dijital haklar yönetimini
kullanma
Adobe® Flash® Media Rights Management Server (FMRMS), ortam yayıncılarına içeriği, özellikle FLV ve MP4
dosyalarını dağıtma ve kullanıcıları tarafından sağlanan doğrudan (kullanıcı tarafından ödenen) veya dolaylı (reklamla
ödenen) tazminatla üretim maliyetlerini telafi etme olanağı sağlar. Yayıncılar ortamı, Adobe® Media Player™
uygulamasında veya dijital haklar yönetimi (DRM) API'sini kullanan herhangi bir AIR uygulamasında indirilip
oynatılabilen şifreli FLV'ler olarak dağıtır.
İçerik sağlayıcıları FMRMS ile, içeriklerini kullanıcı kimlik bilgileriyle korumak için kimlik tabanlı lisans kullanabilir.
Örneğin bir tüketici televizyon programını izlemek istiyor, ancak beraberindeki reklamları izlemek istemiyor. Tüketici
reklamları izlememek için kaydolur ve içerik yayıncısına bir prim öder. Artık kullanıcı kimlik denetimi bilgilerini
kullanarak, reklamları izlemeden programa erişip programı oynatabilir. Bir başka tüketici de Internet erişimi olmadan
seyahat ederken içeriği çevrimdışı görüntülemek isteyebilir. Kullanıcı kaydolduktan ve içerik yayıncısına öncelikli
hizmet için ödeme yaptıktan sonra, kimlik denetimi bilgileriyle yayıncının web sitesindeki programlara erişip bunları
indirebilir. Böylece kullanıcı, izin verilen süre boyunca içeriği çevrimdışı görüntüleyebilir. İçerik ayrıca kullanıcı
kimlik bilgileriyle korunur ve başka kullanıcılarla paylaşılamaz.
Bir kullanıcı DRM şifreli dosyayı oynatmayı denediğinde, uygulama FMRMS ile iletişime geçer, FMRMS de
kullanıcının kimliğini denetlemek ve lisans almak için hizmet sağlayıcı arabirimi (SPI) üzerinden içerik yayıncısının
sistemiyle iletişime geçer, lisans kullanıcının içeriği erişimi olup olmadığını ve varsa da ne kadar süreyle olduğunu
belirleyen bir makbuzdur. Makbuz ayrıca kullanıcının içeriğe çevrimdışı erişimi olup olmadığını ve varsa ne kadar
süreyle olduğunu da belirler. Bu gibi durumlarda, şifreli içeriğe erişim durumunu belirlemek için kullanıcı kimlik
bilgilerine ihtiyaç duyulur.
Kimlik tabanlı lisans da adsız erişimi destekler. Örneğin adsız erişim sağlayıcı tarafından reklam destekli içeriği
dağıtmak veya geçerli içeriğe belirli bir gün sayısı boyunca ücretsiz erişim vermek için kullanılabilir. Arşiv
malzemeleri, karşılığında ödeme yapılması gereken öncelikli içerik kapsamına giriyor olabilir ve kullanıcı kimlik
bilgileri gerekir. Ayrıca, içerik sağlayıcı, içeriği için gerekli olan oynatıcının türünü ve sürümünü belirtebilir ve
sınırlayabilir.
AIR uygulamanızın dijital haklar yönetimi şifrelemesiyle korunan içeriği oynatmasını nasıl sağlayacağınız burada
anlatılmaktadır. İçeriği DRM kullanarak nasıl şifreleyeceğini anlamanız gerekli değildir, ancak DRM şifreli içeriğe
erişiminiz olduğu ve kullanıcının kimliğini denetlemek ve makbuzu almak için FMRMS ile iletişim kurduğunuz
varsayılır.
Politika oluşturmak da dahil olmak üzere FMRMS'ye genel bakış için, FMRMS'nin beraberindeki belgelere bakın.
Adobe Media Player hakkında bilgi için bkz. Adobe Media Player içinde Adobe Media Player Yardımı.
Dijital haklar yönetimiyle ilgili ek çevrimiçi bilgiler
Bu kaynaklardan dijital haklar yönetimi hakkında daha fazla bilgi edinebilirsiniz:
Dil Başvurusu
• DRMAuthenticateEvent
• DRMErrorEvent
Dijital haklar yönetimini kullanma
• DRMStatusEvent
• NetStream
• Flash için Adobe AIR Geliştirici Bağlantısı ('dijital haklar yönetimi'ni veya 'drm'yi arayın)
Şifreli FLV iş akışını anlama
AIR uygulaması DRM şifreli bir dosyayı oynatma girişiminde bulunduğunda gönderilebilen dört olay tipi vardır:
StatusEvent, DRMAuthenticateEvent, DRMErrorEvent ve DRMStatusEvent. Bu dosyaları desteklemek için uygulama
DRM olaylarını işleme için olay dinleyicileri eklemelidir.
Aşağıda, AIR uygulamasının DRM şifrelemeyle korunan içeriği nasıl aldığına ve oynattığına ilişkin bir iş akışı
bulunmaktadır:
1 NetStream nesnesi kullanan Uygulama, bir FLV veya MP4 dosyasını oynatma girişiminde bulunur. İçerik şifreliyse,
FLV'nin şifreli olduğunu belirten DRM.encryptedFLV koduna sahip bir events.StatusEvent olayı gönderilir.
Not: Bir uygulama DRM şifreli dosyayı oynatmak istemezse, şifreli içerikle karşılaştığında gönderilen status olayını
dinleyebilir ve ardından kullanıcıya dosyanın desteklenmediğini bildirip bağlantıyı kapatabilir.
2 Dosya tüm kullanıcıların içeriği kimlik denetim bilgilerini girmeden görüntüleyebileceği şekilde adsız olarak
şifrelenmişse, AIR uygulaması bu iş akışının son adımına geçer. Ancak dosya, kullanıcı kimlik bilgilerinin gerekli
olduğu kimlik tabanlı bir lisans isterse, NetStream nesnesi bir DRMAuthenticateEvent olay nesnesi oluşturur.
Oynatmanın başlayabilmesi için kullanıcının kimlik denetimi bilgilerini sağlaması gerekir.
3 AIR uygulaması, gerekli kimlik denetimi bilgilerinin toplanması için bazı mekanizmalar sağlamalıdır.
DRMAuthenticationEvent sınıfının içerik sunucusu tarafından sağlanan usernamePrompt, passwordPrompt ve
urlPrompt özellikleri, son kullanıcıyı hangi verilerin gerekli olduğu konusunda yönlendirmek için kullanılabilir.
Bu özellikleri, gerekli kullanıcı kimlik bilgilerini almak için bir kullanıcı arabirimi oluştururken kullanabilirsiniz.
Örneğin usernamePrompt değer dizesi, kullanıcı adının e-posta adresi biçiminde olması gerektiğini bildirebilir.
Not: AIR, kimlik denetimi bilgilerini toplamak için varsayılan bir kullanıcı arabirimi sağlamaz. Uygulama geliştirici,
kullanıcı arabirimini yazmalı ve DRMAuthenticateEvent olaylarını işlemelidir. Uygulama DRMAuthenticateEvent
nesneleri için bir olay dinleyicisi sağlamazsa, DRM şifreli nesne "waiting for credentials“ (kimlik bilgileri bekleniyor)
durumunda kalır ve içerik kullanılamaz.
4 Uygulama kullanıcı kimlik bilgilerini aldıktan sonra, kimlik bilgilerini setDRMAuthenticationCredentials()
yöntemiyle NetStream nesnesine iletir. Bu, NetStream nesnesine, kullanıcının kimliğini bir sonraki fırsatta
denetlemesi gerektiği işaretini verir. Ardından AIR kimlik bilgilerini kimlik denetimi için FMRMS'ye iletir.
Kullanıcının kimlik denetimi başarılıysa, uygulama bir sonraki adıma geçer.
Kimlik denetimi başarısız olmuşsa, yeni bir DRMAuthenticateEvent olayı gönderilir ve uygulama adım 3'e döner.
Bu işlem süresiz olarak tekrarlanır. Uygulama, tekrarlanan kimlik denetleme girişimlerini işlemek ve sınırlamak
için bir mekanizma sağlamalıdır. Örneğin uygulama, kullanıcının, NetStream bağlantısını kapatabilen girişimi iptal
etmesine izin verebilir.
5 Kullanıcının kimliği doğrulandıktan sonra veya adsız şifreleme kullanılıyorsa, DRM alt sistemi makbuzu alır. Bu
makbuz, kullanıcının içeriği görüntüleme yetkisi olup olmadığını kontrol etmek için kullanılır. Makbuzdaki bilgiler
hem kimlik denetimi yapılmış hem de adsız kullanıcılar için geçerli olabilir. Örneğin hem kimlik denetimi yapılmış
hem de adsız kullanıcıların, içeriğin süresi dolmadan önce belirli bir süre içeriğe erişimi olabilir veya içerik
sağlayıcısı, görüntüleme uygulamasının sürümünü desteklemediği için içeriğe erişimleri olmayabilir.
Bir hata oluşmadıysa ve kullanıcının içeriği görmek için kimlik denetimi yapılmışsa, DRMStatusEvent olay nesnesi
gönderilir ve AIR uygulaması oynatmayı başlatır. DRMStatusEvent nesnesi ilgili makbuz bilgilerini saklar, bu bilgiler
kullanıcı politika ve izinlerini tanımlar. Örneğin içeriğin, çevrimdışıyken veya makbuzun süresi dolduğunda ve içerik
artık görüntülenemediğinde kullanılabilir olup olamayacağına dair bilgileri saklar. Uygulama, kullanıcıya
politikasının durumunu bildirmek için bu bilgileri kullanabilir. Örneğin uygulama, kullanıcının içeriği görebileceği
kaç günü kaldığını bir durum çubuğunda gösterebilir.
Kullanıcıya çevrimdışı erişim verilirse, makbuz önbelleğe alınır, şifreli içerik kullanıcının bilgisayarına yüklenir ve
çevrimdışı kira süresinde belirtilen süre boyunca kullanılabilir olur. Olaydaki “detail” özelliği
“DRM.voucherObtained” öğesini içerir. Uygulama, çevrimdışıyken de erişebilmesi için içeriğin yerel olarak nerede
saklanacağına karar verir.
DRM'yle ilgili tüm hatalar, uygulamanın bir DRMErrorEvent olay nesnesi göndermesiyle sonuçlanır. AIR, DRM
kimlik denetimi başarısızlığını DRMAuthenticationEvent olay nesnesini yeniden başlatarak işler. Tüm diğer hata
olayları uygulama tarafından açık olarak işlenmelidir. Bunlar arasında, kullanıcının geçerli kimlik bilgilerini girdiği,
ancak makbuzun şifreli içeriği koruyarak içeriğe erişimi kısıtladığı durumlar da bulunmaktadır. Örneğin kimliği
denetlenmiş bir kullanıcının, haklar ödenmediği için içeriğe yine de erişimi olmayabilir. Bu durum ayrıca, aynı ortam
yayıncısının kayıtlı üyesi olan iki kullanıcı, yalnızca birinin ödemesini yaptığı içeriği paylaşma girişiminde bulunduğu
zaman da yaşanır. Uygulama kullanıcıyı içerik kısıtlamaları gibi hatalar hakkında uyarmalıdır, ayrıca içeriği görmek
için nasıl kaydolunacağına ve hakların ödemesinin nasıl yapılacağına ilişkin talimatlar gibi bir alternatif de
sağlamalıdır.
NetStream sınıfında değişiklikler
NetStream sınıfı, Flash Player veya bir AIR uygulamasıyla Flash Media Server veya yerel dosya sistemi arasında tek
yönlü bir akış sağlar. (NetStream sınıfı ayrıca aşamalı indirmeyi de destekler.) Bir NetStream nesnesi, NetConnection
nesnesinin içindeki kanaldır. AIR'in bir parçası olarak NetStream sınıfı, DRM'yle ilgili dört yeni olay da içerir:
Olay
Açıklama
drmAuthenticate
DRMAuthenticateEvent sınıfında tanımlı olan bu olay, bir NetStream nesnesi, oynatılması için kullanıcı kimlik
bilgilerinin kimlik denetiminden geçmesi gereken dijital haklar yönetimi (DRM) şifreli içeriğini oynatma
girişiminde bulunduğunda gönderilir.
Bu olayın özellikleri, kullanıcının kimlik bilgilerini almada ve ayarlamada kullanılabilen header,
usernamePrompt, passwordPrompt ve urlPrompt özelliklerini içerir. Bu olay, NetStream nesnesi geçerli
kullanıcı kimlik bilgilerini alana kadar tekrarlanır.
drmError
Bu olay DRMErrorEvent sınıfında tanımlıdır ve dijital haklar yönetimi (DRM) şifreli dosyasını oynatmaya çalışan
bir NetStream nesnesi DRM'yle ilgili bir hatayla karşılaştığında gönderilir. Örneğin DRM error olayı nesnesi,
kullanıcı kimlik denetimi başarısız olduğunda gönderilir. Bunun nedeni kullanıcının içeriği görüntülemek için
gerekli olan hakları satın almamış olması veya içerik sağlayıcısının görüntüleme uygulamasını desteklememesi
olabilir.
drmStatus
DRMStatusEvent sınıfında tanımlıdır ve dijital haklar yönetimi (DRM) şifreli içeriği oynatılmaya başladığında
(kullanıcının içeriği oynatmak için kimliği doğrulanmıştır ve yetkisi vardır) gönderilir. DRMStatusEvent nesnesi,
içeriğin çevrimdışıyken veya makbuzun süresi dolduğunda ve içerik artık görüntülenemediğinde kullanılabilir
olup olamayacağına dair bilgiler gibi makbuzla ilgili bilgiler içerir.
durum
events.StatusEvent sınıfında tanımlıdır ve yalnızca uygulama dijital haklar yönetimiyle (DRM) şifrelenmiş
içeriği oynatma girişiminde bulunduğunda, NetStream.play() yöntemini çağırarak gönderilir. status kod
özelliği "DRM.encryptedFLV" şeklindedir.
NetStream sınıfı aşağıdaki DRM'ye özgü yöntemleri içerir:
Yöntem
Açıklama
resetDRMVouchers()
Geçerli içerik için yerel olarak önbelleğe alınan tüm dijital haklar yönetimi (DRM) makbuz verilerini
siler. Kullanıcının şifreli içeriğe erişebilmesi için uygulamanın makbuzu yeniden indirmesi gerekir.
Örneğin aşağıdaki kod bir NetStream nesnesi için makbuzları kaldırır:
NetStream.resetDRMVouchers();
air.NetStream.resetDRMVouchers();
Kimlik denetimi için NetStream nesnesine kullanıcı adı, şifre ve kimlik denetiminden oluşan bir
kimlik denetimi bilgileri kümesi iletir. Geçerli kimlik denetimi türleri "drm" ve "proxy"
türleridir. "drm" kimlik denetimi türüyle, sağlanan kimlik bilgileri FMRMS için doğrulanır.
"proxy" kimlik denetimi türüyle, kimlik bilgileri proxy sunucusu için doğrulanır ve bilgilerin
proxy sunucusu tarafından gerekli kılınanlarla eşleşmesi gerekir. Örneğin bir kuruluş kullanıcının
Internete erişebilmesi için böyle bir adım gerektirirse, proxy seçeneği uygulamanın bir proxy
sunucusu için kimlik denetimi yapmasına izin verir. Adsız kimlik denetimi kullanılmadığı sürece,
proxy kimlik denetiminden sonra kullanıcı yine de makbuzu almak ve içeriği oynatmak için FMRMS
için kimlik doğrulaması yapmalıdır. FMRMS için kimlik doğrulaması yapmak üzere
setDRMAuthenticationcredentials() öğesini "drm" seçeneğiyle ikinci kez kullanabilirsiniz.
Aşağıdaki kodda kullanıcı adı (“administrator”), şifre (“password”) ve “drm” kimlik denetimi türü, kullanıcının
kimliğini denetlemek üzere ayarlanmıştır. setDRMAuthenticationCredentials() yöntemi, tedarik sağlayıcısı tarafından
bilinen ve kabul edilen (içeriğin görülmesi için izin alınmasını sağlayan aynı kullanıcı kimlik bilgileri) kimlik
bilgileriyle eşleşen kimlik bilgileri sağlamalıdır. Video oynatmaya ve video akışına başarılı bir bağlantı yapıldığını
doğrulamaya ilişkin kod burada yer almamaktadır.
var connection:NetConnection = new NetConnection();
connection.connect(null);
var videoStream:NetStream = new NetStream(connection);
videoStream.addEventListener(DRMAuthenticateEvent.DRM_AUTHENTICATE,
drmAuthenticateEventHandler)
private function drmAuthenticateEventHandler(event:DRMAuthenticateEvent):void
{
videoStream.setDRMAuthenticationCredentials("administrator", "password", "drm");
}
var connection:NetConnection = new air.NetConnection();
var videoStream= new air.NetStream();
videoStream.addEventListener(air.DRMAuthenticateEvent.DRM_AUTHENTICATE,
function drmAuthenticateEventHandler(event)
{
}
DRMStatusEvent sınıfını kullanma
Dijital haklar yönetimi (DRM) kullanılarak korunan içerik başarılı bir şekilde oynatılmaya başladığında (makbuz
doğrulandığında ve kullanıcının içeriği oynatmak için kimliği doğrulandığında ve yetkisi olduğunda), NetStream
nesnesi bir DRMStatusEvent nesnesi gönderir. DRMStatusEvent erişim izni olan adsız kullanıcılar için de gönderilir.
Makbuz, kimlik denetiminden geçmesi gerekmeyen adsız kullanıcının içeriği oynatmak için izni olup olmadığının
doğrulanması amacıyla kontrol edilir. Adsız kullanıcıların çeşitli nedenlerden ötürü erişimi olmayabilir. Örneğin adsız
bir kullanıcı içeriğe süresi dolduğu için erişemeyebilir.
DRMStatusEvent nesnesi, içeriğin çevrimdışıyken veya makbuzun süresi dolduğunda ve içerik artık
görüntülenemediğinde kullanılabilir olup olamayacağına dair bilgiler gibi makbuzla ilgili bilgiler içerir. Uygulama bu
verileri kullanıcının politika durumunu ve izinlerini taşımak için kullanabilir.
DRMStatusEvent özellikleri
DRMStatusEvent sınıfı aşağıdaki özellikleri içerir:
Özellik
Açıklama
detail
status olayının bağlamını açıklayan dize. DRM 1.0 sürümünde tek geçerli değer DRM.voucherObtained
değeridir.
isAnonymous
DRM şifrelemeyle korunan içeriğin, bir kullanıcının kimlik denetimi bilgilerini sağlamasını gerektirmeden
kullanılabilir (true) veya kullanılamaz (false) olduğunu belirtir. false değeri, kullanıcının, içerik sağlayıcı
tarafından bilinen ve beklenen kullanıcı adı ve şifreyle eşleşen bir kullanıcı adı ve şifre sağlaması gerektiği
anlamına gelir.
isAvailableOffline
DRM şifrelemeyle korunan içeriğin çevrimdışıyken kullanılabilir (true) veya kullanılamaz (false) olduğunu
belirtir. Dijital olarak korunan içeriğin çevrimdışıyken kullanılabilir olması için, makbuzunun kullanıcının yerel
bilgisayarında önbelleğe alınmış olması gerekir.
offlineLeasePeriod
İçeriğin çevrimdışıyken görüntülenebileceği kalan gün sayısı.
policies
Özel DRM özellikleri içerebilen özel nesne.
voucherEndDate
Makbuzun süresinin dolduğu ve içeriğin artık görüntülenemediği mutlak tarih.
DRMStatusEvent işleyicisi oluşturma
Aşağıdaki örnek, olayı başlatan NetStream nesnesi için DRM içerik durumu bilgilerini çıkaran bir olay işleyicisi
oluşturur. Bu olay işleyicisini DRM şifreli içeriği işaret eden bir NetStream nesnesine ekleyin.
private function drmStatusEventHandler(event:DRMStatusEvent):void
{
trace(event.toString());
}
function drmStatusEventHandler(event:DRMStatusEvent):void
{
}
DRMAuthenticateEvent sınıfını kullanma
DRMAuthenticateEvent nesnesi, bir NetStream nesnesi oynatılması için kullanıcı kimlik bilgilerinin kimlik
denetiminden geçmesi gereken dijital haklar yönetimi (DRM) şifreli içeriğini oynatma girişiminde bulunduğunda
gönderilir.
DRMAuthenticateEvent işleyicisi gerekli kimlik bilgilerini (kullanıcı adı, şifre ve tür) toplamaktan ve değerleri
doğrulama için NetStream.setDRMAuthenticationCredentials() yöntemine iletmekten sorumludur. Her AIR
uygulaması kullanıcı kimlik belgelerini edinmek için bazı mekanizmalar sağlamalıdır. Örneğin uygulama kullanıcıya
kullanıcı adı ve şifre değerlerini, isteğe bağlı olarak da tür değerini girmesi için basit bir kullanıcı arabirimi sağlayabilir.
AIR uygulaması ayrıca tekrarlanan kimlik denetimi girişimlerinin işlenmesi ve sınırlanması için de bir mekanizma
sağlamalıdır.
DRMAuthenticateEvent özellikleri
DRMAuthenticateEvent sınıfı aşağıdaki özellikleri içerir:
Özellik
Açıklama
authenticationType
Verilen kimlik bilgilerinin FMRMS için mi (“drm”) yoksa bir proxy sunucusu için (“proxy”) kimlik denetimi
yapmaya yönelik olduğunu belirtir. Örneğin bir kuruluş kullanıcının Internete erişebilmesi için böyle bir adım
gerektirirse, "proxy" seçeneği uygulamanın bir proxy sunucusu için kimlik denetimi yapmasına izin verir. Adsız
kimlik denetimi kullanılmadığı sürece, proxy kimlik denetiminden sonra kullanıcı yine de makbuzu almak ve
içeriği oynatmak için FMRMS için kimlik doğrulaması yapmalıdır. FMRMS için kimlik doğrulaması yapmak
üzere setDRMAuthenticationcredentials() öğesini "drm" seçeneğiyle ikinci kez kullanabilirsiniz.
header
Sunucu tarafından sağlanan şifreli içerik dosya üstbilgisi. Şifreli içeriğin bağlamına ilişkin bilgi içerir.
netstream
Bu olayı başlatan NetStream nesnesi.
passwordPrompt
Sunucu tarafından sağlanan, şifre kimlik bilgisi istemi. Dize, istenilen şifre türü için talimat içerebilir.
urlPrompt
Sunucu tarafından sağlanan, URL dizesi istemi. Dize, kullanıcı adı ve şifrenin gönderildiği konumu sağlayabilir.
usernamePrompt
Sunucu tarafından sağlanan, kullanıcı adı kimlik bilgisi istemi. Dize, istenilen kullanıcı adı türü için talimat
içerebilir. Örneğin bir içerik sağlayıcısı, kullanıcı adı olarak e-posta adresi isteyebilir.
DRMAuthenticateEvent işleyicisi oluşturma
Aşağıdaki örnek, olayı başlatan NetStream nesnesine kodlanmış kimlik denetimi bilgileri ileten bir olay işleyicisi
oluşturur. (Video oynatmaya ve video akışına başarılı bir bağlantı yapıldığını doğrulamaya ilişkin kod burada yer
almamaktadır.)
var connection:NetConnection = new NetConnection();
var videoStream:NetStream = new NetStream(connection);
videoStream.addEventListener(DRMAuthenticateEvent.DRM_AUTHENTICATE,
private function drmAuthenticateEventHandler(event:DRMAuthenticateEvent):void
{
}
var connection:NetConnection = new air.NetConnection();
var videoStream= new air.NetStream();
videoStream.addEventListener(air.DRMAuthenticateEvent.DRM_AUTHENTICATE,
function drmAuthenticateEventHandler(event)
{
}
Kullanıcı kimlik bilgilerini almak için bir arabirim oluşturma
DRM içeriğinin kullanıcı kimlik bilgilerini gerektirdiği durumda, AIR uygulamasının kullanıcının kimlik denetimi
bilgilerini genellikle bir kullanıcı arabirimi üzerinden alması gerekir.
DRMErrorEvent sınıfını kullanma
Bir NetStream nesnesi dijital haklar yönetimiyle (DRM) şifrelenmiş dosyayı oynatmaya çalışırken DRM'yle ilgili bir
hatayla karşılaştığında, AIR bir DRMErrorEvent nesnesi gönderir. Geçersiz kullanıcı kimlik bilgileri durumunda
DRMAuthenticateEvent nesnesi, kullanıcı geçerli kimlik bilgilerini girene kadar sürekli gönderme işlemi yaparak
hatayı işler veya AIR uygulaması daha fazla girişime izin vermez. Uygulama DRM'yle ilgili hataları saptamak,
tanımlamak ve işlemek için tüm diğer DRM error olaylarını dinlemelidir.
Bir kullanıcı geçerli kimlik bilgileri girerse, DRM makbuzunun şartlarına bağlı olarak yine de şifreli içeriği görmesine
izin verilmeyebilir. Örneğin, kullanıcı içeriği yetkisiz, yani şifreli içeriğin yayıncısı tarafından doğrulanmamış bir
uygulamada görüntüleme girişiminde bulunuyorsa. Bu durumda bir DRMErrorEvent nesnesi gönderilir. İçerik
bozuksa veya uygulamanın sürümü makbuz tarafından belirtilenle eşleşmiyorsa, error olayları da çalıştırılabilir.
Uygulama hataların işlenmesi için uygun mekanizmayı sağlamalıdır.
DRMErrorEvent özellikleri
DRMErrorEvent sınıfı aşağıdaki özelliği içerir:
subErrorID
Altında yatan soruna ilişkin daha fazla bilgiyle beraber küçük hata kimliğini gösterir.
Aşağıdaki tablo, DRMErrorEvent nesnesinin bildirdiği hataları listeler:
Büyük Hata Kodu
Küçük Hata Kodu
Hata Ayrıntıları
1001
0
Kullanıcı kimlik denetimi başarısız oldu.
1002
0
Flash Media Rights Management Server (FMRMS),
Secure Sockets Layer (SSL) protokolünü
desteklemiyor.
1003
0
İçeriğin süresi dolmuş ve artık görüntülenemiyor.
1004
0
Kullanıcı kimlik denetimi hatası. Örneğin kullanıcı
içeriği satın almamışsa ve görüntüleme hakkına
sahip değilse bu durum yaşanabilir.
1005
0
1006
0
İstemci güncellemesi gerekli, yani Flash Media
Rights Management Server (FMRMS), yeni bir
dijital haklar yönetimi (DRM) motoru istiyor.
1007
0
Genel dahili hata.
1008
Ayrıntılı şifre çözme
hata kodu
Yanlış lisans anahtarı.
1009
0
FLV içeriği bozuk.
1010
0
1011
0
Uygulama sürümü, politikada belirtilenlerle
eşleşmiyor.
1012
0
Şifreli içerikle ilişkilendirilen makbuzun
doğrulaması başarısız oldu, içerik bozuk olabilir.
1013
0
Şifreli içerikle ilişkilendirilen makbuz
kaydedilemedi.
1014
0
FLV üstbilgisinin bütünlüğü başarısız oldu, içerik
bozuk olabilir.
Büyük Hata Kodu
Küçük Hata Kimliği Hata Ayrıntıları
Açıklama
3300
Adobe Policy Server
hata kodu
Uygulama, içerikle ilişkilendirilen geçersiz bir
makbuz saptadı.
3301
0
Kullanıcı kimlik denetimi başarısız oldu.
3302
0
Secure Sockets Layer (SSL), Flash Media Rights
Management Server (FMRMS) tarafından
desteklenmiyor.
3303
0
İçeriğin süresi dolmuş ve artık görüntülenemiyor.
3304
0
Kullanıcı kimlik denetimi hatası. Bu durum,
örneğin kullanıcı içeriği görüntülemek için
gereken hakları satın almadıysa, kullanıcının
kimlik doğrulaması yapılmış olsa bile yaşanabilir.
3305
0
3306
0
Server URL
publisherID:applicationID
Server URL
Açıklama
Sunucuya bağlanılamıyor.
Görüntüleme uygulamasının kimliği, içerik
yayıncısı tarafından desteklenen geçerli bir
kimlikle eşleşmiyor.
Sunucuya bağlanılamıyor.
İstemci güncellemesi gerekli, yani Flash Media
Rights Management Server (FMRMS), yeni bir
dijital haklar yönetimi istemci motoru istiyor.
Büyük Hata Kodu
Küçük Hata Kimliği Hata Ayrıntıları
Açıklama
3307
0
Genel dahili dijital haklar yönetimi hatası.
3308
Ayrıntılı şifre çözme
hata kodu
Yanlış lisans anahtarı.
3309
0
Flash video içeriği bozuk.
3310
0
publisherID:applicationID
Görüntüleme uygulamasının kimliği, içerik
yayıncısı tarafından desteklenen geçerli bir
kimlikle eşleşmiyor. Başka türlü ifade etmek
gerekirse, görüntüleme uygulaması, içerik
sağlayıcısı tarafından desteklenmiyor.
3311
0
min=x:max=y
Uygulama sürümü, makbuzda belirtilenlerle
eşleşmiyor.
3312
0
Şifreli içerikle ilişkilendirilen makbuzun
doğrulaması başarısız oldu, içerik bozuk olabilir.
3313
0
Şifreli içerikle ilişkilendirilen makbuz Microsafe'e
kaydedilemedi.
3314
0
FLV üstbilgisinin bütünlüğü başarısız oldu, içerik
bozuk olabilir.
3315
DRM korumalı içeriğin uzaktan oynatılmasına izin
verilmiyor.
DRMErrorEvent işleyicisi oluşturma
Aşağıdaki örnek, olayı başlatan NetStream nesnesi için bir olay işleyicisi oluşturur. NetStream, DRM şifreli içeriği
oynatma girişiminde bulunurken bir hatayla karşılaşırsa çağrılır. Normalde bir uygulama hatayla karşılaştığında,
temizleme görevlerini gerçekleştirir, kullanıcıyı hata konusunda bilgilendirir ve sorunu çözmeye yönelik seçenekler
sunar.
private function drmErrorEventHandler(event:DRMErrorEvent):void
{
}
function drmErrorEventHandler(event)
{
air.trace(event.toString());
}
257
Bölüm 26: Uygulama başlatma ve
uygulamadan çıkma seçenekleri
Bu bölüm, yüklenmiş bir Adobe® AIR™ uygulamasının başlatılmasına yönelik seçeneklerin ve etkenlerin yanı sıra, bir
uygulamanın kapatılmasına ve çalıştırılmasına yönelik seçenekleri ve etkenleri de tartışır.
Uygulama başlatma
AIR uygulaması, kullanıcı (veya işletim sistemi) aşağıdaki eylemlerde bulunduğunda çağrılır:
• Uygulamayı masaüstü kabuğundan başlatırsa.
• Uygulamayı komut satırı kabuğunda bir komut olarak kullanırsa.
• Uygulamanın varsayılan açılış uygulaması olduğu bir dosya türü açarsa.
• (Mac OS X) Sabitleme görev çubuğundaki uygulama simgesini tıklatırsa (uygulama o anda çalışır durumda olsun
veya olmasın).
• Uygulamayı yükleyiciden başlatmayı seçerse (yeni bir yükleme işleminin sonunda veya zaten yüklenmiş olan
uygulamanın AIR dosyasını çift tıklatarak).
• Yüklenen sürüm uygulama güncellemelerini kendisinin işlediğini bildirdiğinde bir AIR uygulaması güncellemesi
başlatırsa (uygulama tanımlayıcı dosyasına bir <customUpdateUI>true</customUpdateUI> bildirimi katarak).
• AIR uygulaması için tanımlayıcı bilgiler belirten com.adobe.air.AIR
launchApplication() yöntemini ç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ı için bir <allowBrowserInvocation>true</allowBrowserInvocation> bildirimi
içermelidir.) Bkz. “Yüklenmiş bir AIR uygulamasını tarayıcıdan başlatma” sayfa 282.
Bir AIR uygulaması çağrıldığında, AIR, NativeApplication nesnesi yoluyla invoke türü bir InvokeEvent nesnesi
gönderir. Bir uygulama zamanının kendini başlatmasını ve olay dinleyicisini kaydetmesini sağlamak için, invoke
olayları atılmak yerine kuyruğa gönderilir. Bir dinleyici kaydedildiğinde sıradaki tüm olaylar iletilir.
Not: Bir uygulama tarayıcı başlatma özelliği kullanılarak çağrıldığında, uygulama zaten çalışır halde değilse
NativeApplication nesnesi yalnızca bir invoke olayı gönderir. Bkz. “Yüklenmiş bir AIR uygulamasını tarayıcıdan
başlatma” sayfa 282.
invoke olaylarını almak için, NativeApplication nesnesinin
(NativeApplication.nativeApplication)addEventListener() yöntemini çağırın. Bir olay dinleyicisi invoke
olayı için kaydolduğunda, kayıttan önce gerçekleşen tüm invoke olaylarını da alır. Sıradaki invoke olayları,
addEventListener() yöntemine yapılan çağrı geri döndükten sonra kısa aralıklarla, bir kerede bir olay olmak üzere
gönderilir. Bu işlem sırasında yeni bir invoke olayı gerçekleşirse, bu olay sıradaki bir veya daha fazla olaydan önce
gönderilebilir. Bu olay sıralaması sayesinde, başlatma kodunuz çalışmadan önce gerçekleşen tüm 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 gerçekleşen tüm invoke olaylarını alacağını göz önünde 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ı gönderir. Bir invoke olayına yanıt vermek ve uygun eylemi gerçekleştirmek (yeni bir
belge penceresi açmak gibi) AIR uygulamasının sorumluluğundadır.
Uygulama başlatma ve uygulamadan çıkma seçenekleri
InvokeEvent nesnesi uygulamaya iletilen tüm argümanların yanı sıra, uygulamanın çağrıldığı dizini de içerir.
Uygulama bir dosya türü ilişkilendirmesi nedeniyle çağrıldıysa, dosya yolunun tamamı komut satırı argümanlarına
dahil edilir. Benzer şekilde uygulama bir uygulama güncellemesi nedeniyle çağrıldıysa, güncelleme AIR dosyası
yolunun tamamı sağlanır.
Uygulamanız invoke olaylarını, bir dinleyiciyi NativeApplication nesnesiyle kaydederek işleyebilir:
NativeApplication.nativeApplication.addEventListener(InvokeEvent.INVOKE, onInvokeEvent);
air.NativeApplication.nativeApplication.addEventListener(air.InvokeEvent.INVOKE,
onInvokeEvent);
Ve bir olay dinleyicisi tanımlama:
var arguments:Array;
var currentDir:File;
public function onInvokeEvent(invocation:InvokeEvent):void {
arguments = invocation.arguments;
currentDir = invocation.currentDirectory;
}
Komut satırı argümanlarını yakalama
AIR uygulamasının başlatılmasıyla ilişkilendirilen komut satırı argümanları, NativeApplication nesnesi tarafından
gönderilen invoke olayında iletilir. InvokeEvent.arguments özelliği, bir AIR uygulaması çağrıldığında işletim
sistemi tarafından verilen bir dizi argümanı içerir. Argümanlar göreceli dosya yolları içeriyorsa, yolları genellikle
currentDirectory özelliğini kullanarak çözebilirsiniz.
Bir AIR programına iletilen argümanlar, çift tırnak işareti içinde olmadığı sürece beyaz boşluk sınırlı dizeler olarak
kabul edilir:
Argümanlar
Dizi
tick tock
{tick,tock}
tick "tick tock"
{tick,tick tock}
"tick" “tock”
{tick,tock}
\"tick\" \"tock\"
{"tick","tock"}
InvokeEvent.currentDirectory özelliği, uygulamanın başlatıldığı dizini temsil eden bir File nesnesi içerir.
Bir uygulama, uygulama tarafından kaydedilen türde bir dosya açıldığı için çağrıldığında, dosyanın yerel yolu komut
satırı argümanlarına dize olarak dahil edilir. (Dosyada istenilen işlemin açılmasından veya gerçekleştirilmesinden
uygulamanız sorumludur.) Benzer şekilde bir uygulama kendisini güncellemek üzere programlandığında (standart
AIR güncelleme kullanıcı arabirimine güvenmek yerine), kullanıcı, eşleşen uygulama kimliğine sahip bir uygulama
içeren AIR dosyasını çift tıklattığında AIR dosyasının yerel yolu da dahil edilir.
Dosyaya currentDirectory File nesnesinin resolve() yöntemini kullanarak erişebilirsiniz.
if((invokeEvent.currentDirectory != null)&&(invokeEvent.arguments.length > 0)){
dir = invokeEvent.currentDirectory;
fileToOpen = dir.resolvePath(invokeEvent.arguments[0]);
}
Ayrıca argümanın gerçekten bir dosya yolu olduğunu doğrulamanız gereklidir.
Örnek: Invocation olay günlüğü
Aşağıdaki örnek invoke olayı için dinleyicilerin nasıl kaydedileceğini ve olayın nasıl işleneceğini gösterir. Örnek,
alınan tüm invocation olaylarının günlüğünü tutar ve geçerli dizini ve komut satırı argümanlarını gösterir.
Not: Aşağıdaki örneği Adobe® Flash® CS3 kullanarak oluşturmak için, öncelikle bir Flash Dosyası (Adobe AIR)
oluşturun. ActionScript 3.0 Ayarlar panelinde (Dosya > Yayınlama Ayarları... > Ayarlar düğmesi), Document sınıfı
alanına InvokeEventLogExample adını girin. FLA dosyasını InvokeEventLogExample.fla adıyla kaydedin. Ardından
aynı klasörde bir ActionScript dosyası oluşturun. Aşağıdaki kodu ActionScript dosyasına girin ve daha sonra dosyayı
InvokeEventLogExample.as adıyla kaydedin.
package
{
import
import
import
import
flash.events.InvokeEvent;
public class InvokeEventLogExample extends Sprite
{
public var log:TextField;
public function InvokeEventLogExample()
{
log = new TextField();
log.x = 15;
log.y = 15;
log.width = 520;
log.height = 370;
log.background = true;
addChild(log);
NativeApplication.nativeApplication.addEventListener(InvokeEvent.INVOKE, onInvoke);
}
public function onInvoke(invokeEvent:InvokeEvent):void
{
var now:String = new Date().toTimeString();
logEvent("Invoke event received: " + now);
if (invokeEvent.currentDirectory != null)
{
logEvent("Current directory=" + invokeEvent.currentDirectory.nativePath);
}
else
{
logEvent("--no directory information available--");
}
if (invokeEvent.arguments.length > 0)
{
logEvent("Arguments: " + invokeEvent.arguments.toString());
}
else
{
logEvent("--no arguments--");
}
}
public function logEvent(entry:String):void
{
log.appendText(entry + "\n");
trace(entry);
}
}
}
Oturum açılırken başlatma
NativeApplication.nativeApplication.startAtLogin=true ayarı yapılarak, geçerli kullanıcı oturum açtığında
AIR uygulaması otomatik olarak başlatılacak duruma getirilebilir. Bir kez ayarlandıktan sonra, kullanıcı her oturum
açtığında uygulama otomatik olarak başlatılır. Ayar false olarak değiştirilene, kullanıcı ayarı işletim sisteminden elle
değiştirene veya uygulama kaldırılana kadar, uygulama başlangıçta açılmaya devam eder. Oturum açılırken başlatma,
bir çalışma zamanı ayarıdır.
Not: Uygulama, bilgisayar sistemi başlatıldığında başlamaz. Kullanıcı oturum açtığında başlar. Ayar yalnızca geçerli
kullanıcıya yöneliktir. Ayrıca startAtLogin özelliğinin true olarak başarıyla ayarlanması için uygulama
yüklenmelidir. Uygulama yüklenmemişken özellik ayarlanırsa (ADL ile başlatıldığında olduğu gibi) bir hata verilir.
Tarayıcı başlatma
Bir web sitesi, tarayıcı başlatma özelliğini kullanarak, tarayıcıdan başlatılacak şekilde ayarlı olan yüklenmiş AIR
uygulamasını başlatabilir. Tarayıcı başlatmaya yalnızca uygulama tanımlayıcı dosyası allowBrowserInvocation
ayarını true olarak yaptıysa izin verilir:
Uygulama tanımlayıcı dosyası hakkında daha fazla bilgi için bkz. “AIR uygulamasının özelliklerini ayarlama” sayfa 41.
Uygulama tarayıcı üzerinden çağrıldığında, uygulamanın NativeApplication nesnesi bir BrowserInvokeEvent nesnesi
gönderir.
BrowserInvokeEvent olaylarını almak için, AIR uygulamasında NativeApplication nesnesinin
(NativeApplication.nativeApplication) addEventListener() yöntemini çağırın. Bir olay dinleyicisi
BrowserInvokeEvent olayı için kaydolduğunda, kayıttan önce gerçekleşen tüm BrowserInvokeEvent olaylarını da alır.
Bu olaylar addEventListener() yöntemine yapılan çağrı geri döndükten sonra gönderilir, ancak bu gönderme
işlemi, kayıttan sonra alınmış olma ihtimali bulunan diğer BrowserInvokeEvent olaylarından önce gerçekleşmeyebilir.
Bu sayede, başlatma kodunuzun çalışmasından önce gerçekleş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 gerçekleşen tüm BrowserInvokeEvent
olaylarını alacağını göz önünde bulundurun.
BrowserInvokeEvent nesnesi aşağıdaki özelliklere sahiptir:
Özellik
Açıklama
argümanlar
Uygulamaya iletilecek bir argüman (dize) dizisi.
isHTTPS
Tarayıcıdaki içeriğin https URL şemasını kullanıp (true) kullanmaması (false).
isUserEvent
Tarayıcı başlatmanın bir user olayıyla sonuçlanıp sonuçlanmaması. AIR 1.0'da, bu ayar her zaman true
şeklindedir; AIR'de tarayıcı başlatma özelliği için bir user olayı gereklidir.
sandboxType
Tarayıcıdaki içeriğin sanal alan türü. Geçerli değerler, Security.sandboxType özelliğinde kullanılabilen
değerlerle aynı olarak tanımlanır ve aşağıdakilerden biri olabilir:
securityDomain
•
Security.APPLICATION — İçerik, uygulama güvenlik sanal alanındadır.
•
Security.LOCAL_TRUSTED — İçerik, dosya sistemiyle yerel güvenlik sanal alanındadır.
•
Security.LOCAL_WITH_FILE — İçerik, dosya sistemiyle yerel güvenlik sanal alanındadır.
•
Security.LOCAL_WITH_NETWORK — İçerik, ağ iletişimiyle yerel güvenlik sanal alanındadır.
•
Security.REMOTE — İçerik, uzak (ağ) etki alanındadır.
"www.adobe.com" veya "www.example.org" gibi tarayıcıdaki içeriğin güvenlik etki alanı. Bu özellik
yalnızca uzak güvenlik sanal alanındaki içerik için (ağ etki alanından gelen içerik) ayarlanır. Yerel veya
uygulama güvenlik sanal alanındaki içerik için ayarlanmaz.
Tarayıcı başlatma özelliğini kullanırsanız, güvenlik sonuçlarını dikkate aldığınızdan emin olun. Bir web sitesi AIR
uygulamasını başlattığında, verileri BrowserInvokeEvent nesnesinin arguments özelliğini kullanarak gönderebilir. Bu
verileri dosya veya kod yükleme API'leri gibi duyarlı bir işlemde kullanırken dikkatli olun. Tehlike düzeyi,
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 gerçekten de o etki alanına işaret ettiğini doğrulamalıdır. Böylece bir saldırganın, uygulamayı
yanıltarak duyarlı verileri kendisine göndermesini sağlaması engellenebilir.
Hiçbir uygulama, yerel kaynaklara işaret edebilecek BrowserInvokeEvent argümanları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:// protokolünü kullanmasını
sağlamalıdır.
Bir uygulamanın tarayıcıdan çağrılmasına ilişkin ayrıntılar için bkz. “Yüklenmiş bir AIR uygulamasını tarayıcıdan
Uygulama sonlandırma
Bir uygulamayı sonlandırmanın en hızlı yolu NativeApplication.nativeApplication.exit() öğesini
çağırmaktır; uygulamanızın kaydedilecek verileri veya temizlenecek kaynakları yoksa bu oldukça işe yarayan bir
yöntemdir. exit() öğesini çağırmak tüm 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 için, uygun uyarı olaylarını exit() öğesini çağırmadan önce gönderin.
Bir uygulamayı başarıyla kapatırken düşünülecek 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:
•
NativeApplication.nativeApplication.autoExittrue olduğunda son uygulama penceresini kapatarak.
• Örneğin kullanıcı varsayılan menüden uygulamadan çık komutunu seçtiğinde işletim sisteminden uygulamadan
çıkış komutunu seçerek. Bu yalnızca Mac OS sisteminde gerçekleşir; Windows, sistem kenarlığı üzerinden
uygulamadan çıkış komutu sağlamaz.
• Bilgisayarı kapatarak.
Bir çıkış komutu bu rotalardan biriyle işletim sisteminde araya girdiğinde, NativeApplication bir exiting olayı
gönderir. Hiçbir dinleyici exiting olayını iptal etmezse, tüm açık pencereler kapanır. Her pencere bir closing ve
ardından bir close olayı gönderir. Pencerelerden biri closing olayını iptal ederse, kapatma işlemi durur.
Pencerelerin kapanma sırası uygulamanız için bir sorunsa, NativeApplication öğesinden exiting olayını dinleyin ve
pencereleri kendiniz uygun bir sırayla kapatın. Örneğin araç paletlerine sahip bir belge pencereniz varsa durum böyle
olabilir. Sistemin paletleri kapatması uygunsuz, hatta daha da kötü olabilirdi, ancak kullanıcı bazı verileri kaydetmek
için çı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).
Tüm platformlarda tutarlı davranış sağlamak için, çıkış sırası ister işletim sisteminden, ister menü komutlarından veya
ister uygulama mantığından başlatılmış olsun, uygulamadan çıkmak için aşağıdaki uygulamaları izleyin:
1 Her zaman uygulama kodunda exit() öğesini çağırmadan önce NativeApplication nesnesi üzerinden bir exiting
olayı gönderin ve uygulamanızın başka bir bileşeninin olayı iptal etmediğinden emin olun.
public function applicationExit():void {
var exitingEvent:Event = new Event(Event.EXITING, false, true);
NativeApplication.nativeApplication.dispatchEvent(exitingEvent);
if (!exitingEvent.isDefaultPrevented()) {
NativeApplication.nativeApplication.exit();
}
}
2 NativeApplication.nativeApplication nesnesinden uygulama exiting olayını dinleyin ve işleyicideki tüm
pencereleri kapatın (önce bir closing olayı göndererek). Tüm pencereler kapatıldıktan sonra, uygulama verilerini
kaydetmek veya geçici dosyaları silmek gibi gerekli olan tüm temizlik görevlerini yerine getirin. Uygulamadan
çıkılmadan önce bittiğinden emin olmak için temizleme sırasında yalnızca senkronize yöntemler kullanın.
Pencerelerinizin kapanma sırası önemli değilse, NativeApplication.nativeApplication.openedWindows
dizisinde ilerleyebilir ve sırayla tüm pencereleri kapatabilirsiniz. Sıra önemliyse, pencerelerin doğru sırayla
kapanması için bir yöntem sağlayın.
private function onExiting(exitingEvent:Event):void {
var winClosingEvent:Event;
for each (var win:NativeWindow in NativeApplication.nativeApplication.openedWindows) {
winClosingEvent = new Event(Event.CLOSING,false,true);
win.dispatchEvent(winClosingEvent);
if (!winClosingEvent.isDefaultPrevented()) {
win.close();
} else {
exitingEvent.preventDefault();
}
}
if (!exitingEvent.isDefaultPrevented()) {
//perform cleanup
}
}
3 Windows her zaman kendi closing olaylarını dinleyerek kendi temizleme işlemini gerçekleştirmelidir.
4 Daha önceden çağrılan işleyiciler sonraki işleyicilerin exiting olayını iptal edip etmeyeceğini bilemeyeceği için,
uygulamanızda yalnızca bir exiting dinleyicisi kullanın (çalışma sırasına güvenmek de doğru olmaz).
Ayrıca bkz.
“AIR uygulamasının özelliklerini ayarlama” sayfa 41
“Özel uygulama güncelleme kullanıcı arabirimini sunma” sayfa 291
264
Bölüm 27: Uygulama ayarlarını okuma
Çalışma zamanında, uygulamaya ilişkin yayıncı kimliğinin yanı sıra, uygulama tanımlayıcı dosyasının özelliklerini de
elde edebilirsiniz. Bunlar, NativeApplication nesnesinin applicationDescriptor ve publisherID özelliklerinde
ayarlanmıştır.
Uygulama tanımlayıcı dosyasını okuma
NativeApplication nesnesinin applicationDescriptor özelliğini getirerek, şu anda çalışmakta olan uygulamanın
uygulama tanımlayıcı dosyasını aşağıdaki şekilde XML nesnesi olarak okuyabilirsiniz:
var appXml:XML = NativeApplication.nativeApplication.applicationDescriptor;
Böylece XML (E4X) nesnesi olarak uygulama tanımlayıcı verilerine aşağıdaki şekilde erişebilirsiniz:
var appXml:XML = NativeApplication.nativeApplication.applicationDescriptor;
var ns:Namespace = appXml.namespace();
var appId = appXml.ns::id[0];
var appVersion = appXml.ns::version[0];
var appName = appXml.ns::filename[0];
air.trace("appId:", appId);
air.trace("version:", appVersion);
air.trace("filename:", appName);
var xmlString = air.NativeApplication.nativeApplication.applicationDescriptor;
Daha fazla bilgi için bkz. “Uygulama tanımlayıcı dosyasının yapısı” sayfa 41.
Uygulama ve yayıncı kimliklerini getirme
Uygulama ve yayıncı kimlikleri birlikte bir AIR uygulamasını benzersiz olarak tanımlar. Uygulama tanımlayıcısının
<id> öğesinde uygulama kimliğini belirtirsiniz. Yayıncı kimliği, AIR yükleme paketini imzalamak için kullanılan
sertifikadan türetilir.
Uygulama kimliği, aşağıdaki kodda gösterildiği şekilde, NativeApplication nesnesinin id özelliğinden okunabilir:
trace(NativeApplication.nativeApplication.applicationID);
Yayıncı kimliği, NativeApplication publisherID özelliğinden okunabilir:
trace(NativeApplication.nativeApplication.publisherID);
Not: AIR uygulaması ADL ile çalıştırıldığında, ADL komut satırındaki -pubID bayrağı kullanılarak geçici bir kimlik
atanmadığı sürece, bir yayıncı kimliğine sahip olmaz.
Yüklenen bir uygulamaya ilişkin yayıncı kimliği, uygulama yükleme dizini içindeki META-INF/AIR/publisherid
dosyasında da bulunabilir.
Daha fazla bilgi için bkz. “AIR yayıncı kimlikleri hakkında” sayfa 285.
265
Bölüm 28: Çalışma zamanı ve işletim
sistemi bilgileriyle çalışma
Bu bölüm, bir AIR uygulamasının işletim sistemi dosya ilişkilendirmelerini yönetmek, kullanıcı etkinliğini saptamak
ve Adobe® AIR™ çalışma zamanı hakkında bilgi almak için kullandığı yolları tartışır.
Dosya ilişkilendirmelerini yönetme
Uygulamanız ve bir dosya türü arasındaki ilişkilendirmeler uygulama tanımlayıcısında bildirilmelidir. Yükleme işlemi
sırasında, başka bir uygulama önceden varsayılan olarak olarak belirlenmediği sürece, AIR uygulama yükleyicisi AIR
uygulamasını bildirilen tüm dosya türleri için varsayılan açılış uygulaması olarak ilişkilendirir. AIR uygulaması
yükleme işlemi, var olan dosya türü ilişkilendirmesini geçersiz kılmaz. İlişkilendirmeyi başka bir uygulamadan
devralmak için çalışma zamanında NativeApplication.setAsDefaultApplication() yöntemini çağırın.
Uygulamanız başladığında beklenen dosya ilişkilendirmelerinin yerinde olduğunu doğrulamak yararlı bir
uygulamadır. Bunun nedeni, AIR uygulama yükleyicisinin var olan dosya ilişkilendirmelerini geçersiz kılmaması ve
kullanıcı sistemindeki dosya ilişkilendirmelerinin her zaman değişebilir olmasıdır. Başka bir uygulama güncel dosya
ilişkilendirmesine sahipse, var olan bir ilişkilendirmenin devralınmasından önce kullanıcının onayını almak yerinde
bir uygulamadır.
NativeApplication sınıfının aşağıdaki yöntemleri, bir uygulamanın dosya ilişkilendirmelerini yönetmesine olanak
verir. Yöntemlerden her biri, dosya türü uzantısını parametre olarak alır:
Yöntem
Açıklama
isSetAsDefaultApplication()
AIR uygulaması güncel olarak belirtilen dosya türüyle ilişkilendirilmişse true değerini döndürür.
setAsDefaultApplication()
AIR uygulaması ve dosya türü açık eylemi arasında ilişkilendirme oluşturur.
removeAsDefaultApplication()
AIR uygulaması ve dosya türü arasındaki ilişkilendirmeyi kaldırır.
getDefaultApplication()
Dosya türüyle güncel olarak ilişkilendirilmiş uygulama yolunu bildirir.
AIR, yalnızca ilk olarak uygulama tanımlayıcısında bildirilen dosya türlerine ilişkin ilişkilendirmeleri yönetebilir.
Kullanıcı bu dosya türü ve uygulamanız arasındaki ilişkilendirmeyi elle oluşturmuş olsa bile, bildirilmemiş bir dosya
türünün ilişkilendirmeleri hakkında bilgi alamazsınız. Uygulama tanımlayıcısında bildirilmemiş bir dosya türüne
ilişkin uzantı aracılığıyla herhangi bir dosya ilişkilendirme yönetimi yönteminin çağırılması, uygulamanın çalışma
zamanı istisnası vermesine neden olur.
Dosya türlerinin uygulama tanımlayıcısında bildirilmesi hakkında bilgi için bkz. “Dosya türü ilişkilendirmelerini
bildirme” sayfa 48.
Çalışma zamanı ve işletim sistemi bilgileriyle çalışma
Çalıştırma zamanı sürümü ve yama düzeyini getirme
NativeApplication nesnesi, uygulamanın yürütülmekte olduğu çalışma zamanının sürümünü belirten
runtimeVersion özelliğini içerir ("1.0.5" gibi bir dize). NativeApplication nesnesi ayrıca, çalışma zamanının yama
düzeyini ifade eden runtimePatchLevel özelliğini de içerir (2960 gibi bir sayı). Aşağıdaki kod bu özellikleri kullanır:
trace(NativeApplication.nativeApplication.runtimeVersion);
trace(NativeApplication.nativeApplication.runtimePatchLevel);
AIR özelliklerini saptama
Adobe AIR uygulamasıyla paketlenen bir dosya için, Security.sandboxType özelliği Security.APPLICATION
sabitiyle tanımlanan değere ayarlanır. Aşağıdaki kodda gösterildiği şekilde, bir dosyanın Adobe AIR güvenlik sanal
alanında bulunuyor olup olmadığını temel alarak içerik (AIR'e özgü API'ler içerebilir veya içermeyebilir)
yükleyebilirsiniz.
if (Security.sandboxType == Security.APPLICATION)
{
// Load SWF that contains AIR APIs
}
else
{
// Load SWF that does not contain AIR APIs
}
AIR uygulamasıyla yüklenmeyen tüm kaynaklar, bir web tarayıcısında Adobe® Flash® Player tarafından atanacağı
güvenlik sanal alanlarının aynılarına atanır. Uzak kaynaklar, kaynak etki alanlarına göre sanal alanlara yerleştirilir ve
yerel kaynaklar ağ iletişimiyle yerel, dosya sistemiyle yerel veya yerel güvenilir sanal alanlara yerleştirilir.
İçeriğin çalışma zamanında yürütülüp yürütülmediğini (ve bir tarayıcıda çalışan Flash Player'da çalışıp çalışmadığını)
görmek için Capabilities.playerType statik özelliğinin "Masaüstü" olarak ayarlanıp ayarlanmadığını kontrol
edebilirsiniz.
Daha fazla bilgi için bkz. “AIR güvenliği” sayfa 23.
Kullanıcı varlığını izleme
NativeApplication nesnesi, bir kullanıcının bilgisayarı ne zaman etkin olarak kullandığını saptamanıza yardımcı olan
iki olay gönderir. NativeApplication.idleThreshold özelliğiyle belirlenen aralıkta fare veya klavye etkinliği
saptanmadıysa, NativeApplication bir userIdle olayı gönderir. Bir sonraki klavye veya fare girdisi gerçekleştiğinde,
NativeApplication nesnesi bir userPresent olayı gönderir. idleThreshold aralığı saniye cinsinden ölçülür ve 300
varsayılan değerine sahiptir (5 dakika). Ayrıca, son kullanıcı girdisinden itibaren geçen saniye sayısını da
NativeApplication.nativeApplication.lastUserInput özelliğinden elde edebilirsiniz.
Aşağıdaki kod satırları, boşta kalma eşiğini 2 dakika olarak ayarlar ve hem userIdle hem de userPresent olayını
dinler::
Çalışma zamanı ve işletim sistemi bilgileriyle çalışma
NativeApplication.nativeApplication.idleThreshold = 120;
NativeApplication.nativeApplication.addEventListener(Event.USER_IDLE, function(event:Event) {
trace("Idle");
});
NativeApplication.nativeApplication.addEventListener(Event.USER_PRESENT,
function(event:Event) {
trace("Present");
});
Not: Herhangi iki userPresent olayı arasında yalnızca bir userIdle olayı gönderilir.
268
Bölüm 29: Ağ bağlantısını izleme
Adobe® AIR™, AIR uygulamasının yüklenmiş olduğu bilgisayardaki ağ bağlantısına ilişkin değişiklikleri izlemeye
yönelik araçlar sunar. Bir uygulama ağdan alınan verileri kullandığında, bu bilgi işinize yarayacaktır. Ayrıca, uygulama
bir ağ servisinin kullanılabilirliğini kontrol edebilir.
Ağ bağlantısı değişikliklerini saptama
AIR uygulamanız, güvenli olmayan ve değişken ağ bağlantıları içeren ortamlarda çalışabilir. Adobe AIR, bir
uygulamanın çevrimiçi kaynaklara yönelik bağlantıları yönetmesine yardımcı olmak için, ağ bağlantısının her
kullanılabilir veya kullanılamaz oluşunda bir ağ değişikliği olayı gönderir. Uygulamanın NativeApplication nesnesi ağ
değişikliği olayını gönderir. Bu olaya tepki vermek için bir dinleyici ekleyin:
NativeApplication.nativeApplication.addEventListener(Event.NETWORK_CHANGE, onNetworkChange);
Ve bir olay işleyici işlevi tanımlayın:
function onNetworkChange(event:Event)
{
//Check resource availability
}
Event.NETWORK_CHANGE olayı, tüm ağ etkinliğinde gerçekleşen bir değişikliği değil, yalnızca bir ağ bağlantısının
değiştiğini gösterir. AIR, ağ değişikliğinin anlamını yorumlamaya çalışmaz. Ağa bağlı bir bilgisayar birçok gerçek ve
sanal bağlantıya sahip olabilir, bu nedenle bir bağlantının kaybedilmesi, kaynağın kaybedilmesi anlamına gelmeyebilir.
Diğer yandan, yeni bağlantılar da iyileştirilmiş kaynak kullanılabilirliğini garanti etmez. Bazen yeni bir bağlantı,
önceden kullanılabilir olan bir kaynağa erişimi bloke bile edebilir (örneğin VPN'e bağlanıldığında).
Genellikle, bir uygulamanın uzak bir kaynağa bağlanıp bağlanamayacağını belirlemenin tek yolu, denemektir. Bu
amaçla, air.net paketindeki servis izleme çerçeveleri, belirli bir ana bilgisayara ilişkin ağ bağlantısındaki değişiklikleri
olay tabanlı yanıtlama yöntemine sahip AIR uygulamaları sunar.
Not: Servis izleme çerçevesi, sunucunun bir isteği kabul edilebilir biçimde yanıtlayıp yanıtlamadığını saptar. Bu, tam
bağlantıyı garanti etmez. Ölçeklenebilir web servisleri, trafiği bir dizi web sunucusuna yönlendirmek için genellikle
önbelleğe alma ve yük dengeleme gereçlerini kullanır. Bu durumda, servis sağlayıcıları ağ bağlantısına ilişkin yalnızca
kısmi bir tanı sağlar.
Servis izleme temelleri
Servis izleme çerçevesi, AIR çerçevesinden ayrı olarak servicemonitor.swc dosyasında bulunur. Çerçeveyi kullanmak
için, servicemonitor.swc dosyası oluşturma işlemine dahil edilmelidir.
Önemli: Bu sınıfları ActionScript'te kullanmak için ServiceMonitorShim bileşenini Bileşenler panelinden Kitaplık'a
sürükleyin ve aşağıdaki import ifadesini ActionScript 3.0 kodunuza ekleyin:
import air.net.*;
Ağ bağlantısını izleme
ServiceMonitor sınıfı, ağ servislerinin izlenmesi için çerçeveyi uygular ve servis izlemeleri için temel işlevler sağlar.
Varsayılan olarak, bir ServiceMonitor sınıfı örneği, ağ bağlantısına ilişkin olaylar gönderir. ServiceMonitor nesnesi,
örnek oluşturulduğunda ve Adobe AIR'in her ağ değişikliği saptayışında bu olayları gönderir. Ayrıca, genel ağ
bağlantısı olaylarına bakılmaksızın milisaniye cinsinden belirli bir aralıkta bağlantıyı kontrol etmek için
ServiceMonitor örneiğinin pollInterval özelliğini ayarlayabilirsiniz. ServiceMonitor nesnesi, start() yöntemi
çağrılana kadar ağ bağlantısını kontrol etmez.
ServiceMonitor sınıfının alt sınıfı olan URLMonitor sınıfı, belirli bir URLRequest için HTTP bağlantısındaki
değişiklikleri saptar.
ServiceMonitor sınıfının başka bir alt sınıfı olan SocketMonitor sınıfı ise, belirli bir bağlantı noktasındaki belirli bir
ana bilgisayara ilişkin bağlantıdaki değişiklikleri saptar.
HTTP bağlantısını saptama
URLMonitor sınıfı, bağlantı noktası 80'de (HTTP iletişimi için tipik bağlantı noktası) belirli bir adrese HTTP
isteklerinin yapılıp yapılamayacağını belirler. Aşağıdaki kod, Adobe web sitesindeki bağlantı değişikliklerini saptamak
için bir URLMonitor sınıfı örneğini kullanır:
import air.net.URLMonitor;
import flash.events.StatusEvent;
var monitor:URLMonitor;
monitor = new URLMonitor(new URLRequest('http://www.adobe.com'));
monitor.addEventListener(StatusEvent.STATUS, announceStatus);
monitor.start();
function announceStatus(e:StatusEvent):void {
trace("Status change. Current status: " + monitor.available);
}
Soket bağlantısını saptama
AIR uygulamaları, itme modeli bağlanabilirliği için soket bağlantıları da kullanabilir. Güvenlik duvarları ve ağ
yönlendiricileri, güvenlik nedenleriyle genellikle yetkisiz bağlantı noktalarındaki ağ iletişimini kısıtlar. Bu nedenle
geliştiriciler, kullanıcıların soket bağlantıları kuramayabileceğini göz önünde bulundurmalıdır.
URLMonitor örneğiyle benzer olarak, aşağıdaki kod IRC için yaygın bir bağlantı noktası olan 6667'deki soket
bağlantısına ilişkin bağlantı değişikliklerini saptamak üzere bir SocketMonitor sınıfı örneğini kullanır.
import air.net.ServiceMonitor;
import flash.events.StatusEvent;
socketMonitor = new SocketMonitor('www.adobe.com',6667);
socketMonitor.addEventListener(StatusEvent.STATUS, socketStatusChange);
socketMonitor.start();
function announceStatus(e:StatusEvent):void {
trace("Status change. Current status: " + socketMonitor.available);
}
270
Bölüm 30: URL istekleri ve ağ iletişimi
URL istekleri belirtmeye ilişkin yeni Adobe AIR işlevi, tarayıcıda çalışan SWF içeriği tarafından kullanılamaz. Bu işlev,
yalnızca uygulama güvenlik sanal alanındaki içerik tarafından kullanılabilir. Bu bölüm çalışma zamanındaki
URLRequest özelliklerini açıklar ve ağ iletişimi API değişiklikleri AIR içeriğini tartışır.
ActionScript™ 3.0 ağ iletişimi ve iletişim özelliklerini kullanma hakkında diğer bilgiler için Adobe® Flash® CS3 ve
Adobe® Flex™ Builder™ 3 ile birlikte teslim edilen ActionScript 3.0'ı Programlama bölümüne bakın.
URLRequest sınıfını kullanma
URLRequest sınıfı, yalnızca URL dizesinden fazlasını tanımlamanıza olanak verir. AIR, URLRequest sınıfına yalnızca
uygulama güvenlik sanal alanında çalışan AIR içeriği tarafından kullanılabilen bazı yeni özellikler ekler. Çalışma
zamanındaki içerik, yeni URL şemalarını (file ve http gibi standart şemalara ek olarak) kullanarak URL'leri
tanımlayabilir.
URLRequest özellikleri
URLRequest sınıfı, yalnızca AIR uygulama güvenlik sanal alanındaki içerik tarafından kullanılabilen aşağıdaki
özellikleri içerir:
Özellik
Açıklama
followRedirects
Yeniden yönlendirmelerin takip edilip (true, varsayılan değer) edilmeyeceğini (false) belirtir. Bu, yalnızca
çalışma zamanında desteklenir.
manageCookies
HTTP protokol yığınının bu istek için tanımlama bilgilerini yönetmesi gerekip (true, varsayılan değer)
gerekmediğini (false) belirtir. Bu, yalnızca çalışma zamanında desteklenir.
authenticate
Kimlik doğrulama isteklerinin bu istek için işlenmesi gerekip (true) gerekmediğini belirtir. Bu, yalnızca çalışma
zamanında desteklenir. Varsayılan, istekler için kimlik doğrulaması yapmaktır—sunucu kimlik bilgilerinin
gösterilmesini gerektiriyorsa bu, kimlik doğrulama iletişim kutusunun görüntülenmesine neden olabilir.
Kullanıcı adı ve parola da ayarlayabilirsiniz—bkz. “URLRequest varsayılanlarını ayarlama” sayfa 271.
cacheResponse
Bu isteğe ilişkin başarılı yanıt verilerinin önbelleğe alınması gerekip gerekmediğini belirtir. Bu, yalnızca çalışma
zamanında desteklenir. Varsayılan, yanıtı önbelleğe almaktır (true).
useCache
Bu URLRequest verileri almadan önce, yerel önbelleğe başvurulması gerekip gerekmediğini belirler. Bu,
yalnızca çalışma zamanında desteklenir. Varsayılan (true), kullanılabiliyorsa yerel önbelleğe alınmış sürümü
kullanmaktır.
userAgent
HTTP isteğinde kullanılacak kullanıcı aracısı dizesini belirtir.
URLRequest nesnesinin aşağıdaki özellikleri herhangi bir sanal alandaki içerik tarafından ayarlanabilir (yalnızca AIR
uygulama güvenlik sanal alanı değil):
Özellik
Açıklama
contentType
URL isteğiyle gönderilen her verinin MIME içerik türü.
data
URL isteği ile aktarılacak olan verileri içeren bir nesne.
digest
Adobe® Flash® Player önbelleğini izlemek için önbelleğe alınmış bir dosyaya ilişkin güvenli bir "özet".
URL istekleri ve ağ iletişimi
Özellik
Açıklama
method
Bir GET veya POST işlemi gibi HTTP istek yöntemini denetler. (AIR uygulama etki alanında çalışan içerik, "GET"
veya "POST" dışındaki dizeleri method özelliği olarak belirleyebilir. Tüm HTTP fiilleri olanaklıdır ve "GET"
varsayılan yöntemdir. Bkz. “AIR güvenliği” sayfa 23 .)
requestHeaders
HTTP istemine eklenecek HTTP istem başlıkları.
url
İstenecek URL'yi belirtir.
Not: HTMLLoader sınıfı, HTMLLoader nesnesi tarafından yüklenen içeriğe ait ayarlara ilişkin özellikler içerir.
Ayrıntılar için bkz. “HTMLLoader sınıfı hakkında” sayfa 206 .
URLRequest varsayılanlarını ayarlama
URLRequestDefaults sınıfıi URLRequest nesneleri için varsayılan ayarlarını tanımlamanızı sağlar. Örneğin, aşağıdaki
kod manageCookies ve useCache özellikleri için varsayılan değerleri ayarlar:
URLRequestDefaults.manageCookies = false;
URLRequestDefaults.useCache = false;
air.URLRequestDefaults.manageCookies = false;
air.URLRequestDefaults.useCache = false;
URLRequestDefaults sınıfı, belirli bir ana bilgisayar için kullanmak üzere varsayılan bir kullanıcı adı ve parola
belirlemenizi sağlayan setLoginCredentialsForHost() yöntemini içerir. Yöntemin hostname parametresinde
tanımlanan ana bilgisayar, "www.example.com" gibi bir etki alanı veya "www.example.com:80" gibi bir etki alanı ve
bir bağlantı noktası numarası olabilir. "example.com", "www.example.com" ve "sales.example.com" öğelerinden
her birinin benzersiz ana bilgisayarlar olarak dikkate alındığını unutmayın.
Bu kimlik bilgileri, yalnızca sunucu onları istediğinde kullanılır. Kullanıcının kimlik doğrulaması önceden yapıldıysa
(örneğin, kimlik doğrulama iletişim kutusu kullanılarak), kimlik doğrulaması yapılan kullanıcıyı
setLoginCredentialsForHost() yöntemini çağırarak değiştiremezsiniz.
Örneğin, aşağıdaki kod www.example.com adresinde kullanılmak üzere varsayılan bir kullanıcı adı ve bir parola
ayarlar:
URLRequestDefaults.setLoginCredentialsForHost("www.example.com", "Ada", "love1816$X");
air.URLRequestDefaults.setLoginCredentialsForHost("www.example.com", "Ada", "love1816$X");
URLRequestDefaults ayarlarının her özelliği, özelliği ayarlayan içeriğin yalnızca uygulama etki alanına uygulanır.
Ancak, setLoginCredentialsForHost() yöntemi AIR uygulamasında bulunan tüm etki alanlarındaki içeriğe
uygulanır. Uygulama bu yolla bir ana bilgisayarda oturum açabilir ve uygulamadaki tüm içeriğin belirtilen kimlik
bilgileriyle oturum açmasını sağlar.
Daha fazla bilgi için ActionScript 3.0 Dil ve Bileşenler Başvurusu (http://www.adobe.com/go/learn_air_aslr_tr)
adresindeki URLRequestDefaults sınıfına bakın.
URL'lerde AIR URL şemalarını kullanma
Aşağıdaki gibi standart URL şemaları, AIR'deki herhangi bir güvenlik sanal alanındaki URL'leri tanımlarken
kullanılabilir:
http: ve https:
Bunları web tarayıcısında kullandığınız gibi kullanın.
file:
Bunu, dosya sisteminin köküne ilişkin bir yol belirtmek için kullanın. Örneğin:
Uygulama güvenlik sanal alanında çalışan içeriğe ilişkin URL'yi tanımlarken aşağıdaki şemaları da kullanabilirsiniz:
app:
Bunu, yüklenen uygulamanın kök dizinine ilişkin bir yol belirtmek için kullanın (yüklenen uygulamaya ilişkin
uygulama tanımlayıcı dosyasını içeren dizin). Örneğin, aşağıdaki yol yüklenen uygulama dizininin kaynaklar alt
dizinine işaret eder:
app:/resources
Uygulama kaynak dizini, ADL uygulamasında çalışırken uygulama tanımlayıcı dosyasını içeren dizine ayarlanır.
app-storage:
Bunu, uygulama depo dizinine ilişkin bir yol belirtmek için kullanın. AIR, her kullanıcı için yüklenen her uygulamaya
ilişkin verileri depolamak üzere kullanışlı bir yer olan benzersiz bir uygulama depolama dizini tanımlar. Örneğin,
aşağıdaki yol uygulama depo dizininde yer alan ayarlar alz dizinindeki prefs.xml dosyasına işaret eder:
Uygulama depo dizini, kullanıcı adını, uygulama kimliğini ve yayıncı kimliğini temel alır:
• Mac OS'de—:
/Kullanıcılar/kullanıcı adı/Kitaplık/Tercihler/applicationID.publisherID/Local Store/
Örneğin:
/Users/babbage/Library/Preferences/com.example.TestApp.02D88EEED35F84C264A183921344EEA353
A629FD.1/Local Store
• Windows'ta—Belgeler ve Ayarlar dizininde:
kullanıcı adı/Uygulama Verileri/applicationID.publisherID/Local Store/
Örneğin:
C:\Documents and Settings\babbage\Application
Data\com.example.TestApp.02D88EEED35F84C264A183921344EEA353A629FD.1\Local Store
File.applicationStorageDirectory kullanılarak oluşturulan bir File nesnesine ilişkin URL (ve url özelliği) appstorage URL şemasını aşağıdaki şekilde kullanır:
var dir:File = File.applicationStorageDirectory;
dir = dir.resolvePath("preferences");
trace(dir.url); // app-storage:/preferences
var dir = air.File.applicationStorageDirectory;
dir = dir.resolvePath("prefs.xml");
air.trace(dir.url); // app-storage:/preferences
AIR'de URL şemaları kullanma
FileStream veya Sound nesnesi gibi çeşitli nesnelere ilişkin URL isteği tanımlamak için bu URL şemalarınından birini
kullanan bir URLRequest nesnesini kullanabilirsiniz. Bu şemaları AIR'de çalışan HTML içeriğinde de
kullanabilirsiniz; örneğin, bir img etiketinin src niteliğinde.
Ancak, AIR'e özgü bu URL şemalarını (app: ve app-storage:) yalnızca uygulama güvenlik sanal alanındaki içerikte
kullanabilirsiniz. Daha fazla bilgi için bkz. “AIR güvenliği” sayfa 23.
İzin verilmeyen URL şemaları
Bazı API'ler, içeriği bir web tarayıcısında başlatmanıza olanak verir. Güvenlik nedenleriyle, AIR'de bu API'leri
kullanırken bazı URL şemalarının kullanılmasına izin verilmez. İzin verilmeyen şemaların listesi, API'yi kullanan
kodun güvenlik sanal alanına bağlıdır. Ayrıntılar için bkz. “Varsayılan sistem web tarayıcısında bir URL açma”
sayfa 273 .
URLStream sınıfındaki değişiklikler
URLStream sınıfı indirilen URL'lerden indirilen verilere düşük düzeyli erişim sağlar. Çalışma zamanında, URLStream
sınıfı yeni bir olay içerir: httpResponseStatus. httpStatus olayının aksine, httpResponseStatus olayı tüm yanıt
verilerinden önce alınır. httpResponseStatus olayı (HTTPStatusEvent sınıfında tanımlanan), yanıtın döndüğü
kaynak URL olan responseURL özelliğini ve yanıtın döndürdüğü yanıt başlıklarını temsil eden URLRequestHeader
nesnesinin bir dizisi olan responseHeaders özelliğini içerir.
Varsayılan sistem web tarayıcısında bir URL açma
Varsayılan sistem web tarayıcısında bir UYL açmak için navigateToURL() işlevini kullanabilirsiniz. Bu işlevin
request parametresi olarak ilettiğiniz URLRequest nesnesi için yalnızca url özelliği kullanılır.
var url = "http://www.adobe.com";
var urlReq = new air.URLRequest(url);
air.navigateToURL(urlReq);
navigateToURL() işlemini kullanırken, URL şemalarına navigateToURL() işlevini çağıran kodun güvenlik sanal
alanı temelinde izin verilir.
Bazı API'ler, içeriği bir web tarayıcısında başlatmanıza olanak verir. Güvenlik nedenleriyle, AIR'de bu API'leri
kullanırken bazı URL şemalarının kullanılmasına izin verilmez. İzin verilmeyen şemaların listesi, API'yi kullanan
kodun güvenlik sanal alanına bağlıdır. (Güvenlik sanal alanlarına ilişkin ayrıntılar için bkz. “AIR güvenliği” sayfa 23.)
Uygulama sanal alanı
Aşağıdaki şemalara izin verilir. Bunları web tarayıcısında kullandığınız gibi kullanın.
•
http:
•
https:
•
file:
•
mailto: — AIR, bu istekleri kayıtlı sistem posta uygulamasına yönlendirir.
•
app:
•
app-storage:
Diğer URL şemalarına izin verilmez.
Uzak sanal alan
•
http:
•
https:
•
Dosyayla yerel sanal alan
•
file:
•
Ağ iletişimiyle yerel sanal alan
•
http:
• https:
•
Yerel güvenilir sanal alan
•
file:
•
http:
• https:
•
275
Bölüm 31: AIR uygulamalarını Dağıtma,
Yükleme ve Çalıştırma
AIR uygulamaları tek bir AIR yükleme dosyası olarak dağıtılır, bu dosya uygulama kodunu ve tüm varlıkları içerir. Bu
dosyayı, indirme, e-posta gibi genel yöntemlerden biriyle veya CD-ROM gibi bir fiziksel ortamla dağıtabilirsiniz.
Kullanıcılar AIR dosyasını çift tıklatarak uygulamayı yükleyebilir. Kullanıcıların AIR uygulamanızı (ve gerekiyorsa
Adobe® AIR™ uygulamasını) yüklemelerini sağlayan kesintisiz yükleme özelliğini, web sayfasındaki tek bir linki
tıklatarak kullanabilirsiniz.
Bir AIR yükleme dosyası dağıtılmadan önce paketlenmeli ve kod imzalayıcı sertifikası ve özel bir anahtarla
imzalanmalıdır. Yükleme dosyasını dijital olarak imzalamak, uygulamanızın imzalandıktan sonra değiştirilmediğine
dair bir güvence sağlar. Buna ek olarak, dijital sertifikayı Verisign veya Thawte gibi güvenilen bir sertifika yetkilisi
yayımladıysa, kullanıcılarınız yayıncı ve imzalayan olarak kimliğinizi doğrulayabilir. Uygulama AIR Geliştirici
Aracı'yla (ADT) paketlendiğinde AIR dosyası imzalanır.
Bir uygulamayı Flash için AIR güncelleme kullanarak AIR dosyasına paketleme konusunda bilgi için, bkz. “AIR
uygulaması ve yükleme dosyaları oluşturma” sayfa 15.
Bir uygulamayı Adobe® AIR™ SDK kullanarak AIR dosyasına paketleme konusunda bilgi için, bkz. “AIR yükleme
dosyasını AIR Geliştirici Aracı (ADT) kullanarak paketleme” sayfa 306.
AIR uygulamasını masaüstünden yükleme ve çalıştırma
Yalnızca AIR dosyasını alıcıya gönderin. Örneğin AIR dosyasını e-posta eki olarak veya bir web sayfasında link olarak
gönderebilirsiniz.
Kullanıcı AIR dosyasını indirdikten sonra, dosyayı yüklemek için şu talimatları izler:
1 AIR dosyasını çift tıklatın.
Adobe AIR bilgisayarda önceden yüklü olmalıdır.
2 Yükleme penceresinde, varsayılan ayarları seçili halde bırakın ve ardından Devam düğmesini tıklatın.
Windows'ta AIR otomatik olarak şunları yapar:
• Uygulamayı Program Dosyaları dizinine yükler
• Uygulama için bir masaüstü kısayolu oluşturur
• Başlat Menüsü kısayolu oluşturur.
• Program Ekle / Kaldır Denetim Masası'na uygulama için bir giriş ekler
Mac OS'de, uygulama varsayılan olarak Uygulamalar dizinine eklenir.
Uygulama zaten yüklenmişse yükleyici, kullanıcıya, uygulamanın var olan sürümünü açma veya indirilen AIR
dosyasındaki sürüme güncelleme seçenekleri arasında seçim yapma olanağı tanır. Yükleyici AIR dosyasındaki
uygulama kimliğini ve yayıncı kimliğini kullanarak uygulamayı tanımlar.
3 Yükleme işlemi tamamlandığında, Son düğmesini tıklatın.
Mac OS'de bir uygulamanın güncellenen sürümünü yüklemek için, kullanıcının uygulama dizinine yüklemek üzere
yeterli sistem ayrıcalığına sahip olması gerekir. Windows'ta kullanıcının yönetici ayrıcalıklarına sahip olması gerekir.
AIR uygulamalarını Dağıtma, Yükleme ve Çalıştırma
Ayrıca uygulama yeni bir sürümü, ActionScript veya JavaScript kullanarak da yükleyebilir. Daha fazla bilgi için, bkz.
“AIR uygulamalarını güncelleme” sayfa 290.
AIR uygulaması yüklendikten sonra kullanıcı uygulamayı çalıştırmak için, diğer masaüstü uygulamalarında da olduğu
gibi yalnızca uygulama simgesini çift tıklatır.
• Windows'ta uygulamasının simgesini çift tıklatın (masaüstüne veya bir klasöre yüklüdür) veya Başlat menüsünden
uygulamayı seçin.
• Mac OS'de uygulamayı yüklendiği klasörde çift tıklatın. Varsayılan yükleme dizini /Applications dizinidir.
AIR kesintisiz yükleme özelliği sayesinde kullanıcı AIR uygulamasını web sayfasındaki bir linki tıklatarak yükleyebilir.
AIR tarayıcı başlatma özelliği sayesinde kullanıcı yüklenmiş olan AIR uygulamasını web sayfasındaki bir linki
tıklatarak çalıştırabilir. Bu özellikler aşağıdaki bölümde anlatılmaktadır.
AIR uygulamalarını web sayfasından yükleme ve
çalıştırma
Kesintisiz yükleme özelliği, SWF dosyasını, kullanıcının bir AIR uygulamasını tarayıcıdan yüklemesini sağlayan bir
web sayfasına gömmenize olanak tanır. Çalışma zamanı yüklenmemişse, kesintisiz yükleme özelliği çalışma zamanını
yükler. Kesintisiz yükleme özelliği sayesinde kullanıcılar, AIR dosyasını bilgisayarlarına kaydetmeden AIR
uygulamasını yükleyebilirler. AIR SDK'de bir badge.swf dosyası mevcuttur, bu dosya sayesinde kesintisiz yükleme
özelliğini kolaylıkla kullanabilirsiniz. Ayrıntılar için bkz. “AIR uygulamasını yüklemek için badge.swf dosyasını
kullanma” sayfa 277.
Kesintisiz yükleme badge.swf dosyasını özelleştirme hakkında
SDK'yle beraber sağlanan badge.swf dosyasını kullanmaya ek olarak, bir tarayıcı sayfasında kullanmak için kendi SWF
dosyanızı oluşturabilirsiniz. Özel SWF dosyanız çalışma zamanıyla şu şekillerde etkileşimde bulunabilir:
• Bir AIR uygulaması yükleyebilir. Bkz. “Tarayıcıdan AIR uygulaması yükleme” sayfa 281.
• Belirli bir AIR uygulamasının yüklenip yüklenmediğine bakmak için kontrol edebilir. Bkz. “AIR uygulamasının
yüklenip yüklenmediğini bir web sayfasından kontrol etme” sayfa 281.
• Çalışma zamanının yüklenip yüklenmediğine bakmak için kontrol edebilir. Bkz. “Çalışma zamanının yüklenip
yüklenmediğini kontrol etme” sayfa 280.
• Yüklenmiş bir AIR uygulamasını kullanıcının sisteminde başlatabilir. Bkz. “Yüklenmiş bir AIR uygulamasını
tarayıcıdan başlatma” sayfa 282.
Bu özelliklerin tümü, adobe.com adresinde bulunan bir SWF dosyasındaki API'ler çağrılarak sağlanır: air.swf. Bu
bölümde badge.swf dosyasının nasıl kullanılacağı ve özelleştirileceği ve air.swf API'lerini kendi SWF dosyanızdan nasıl
çağıracağınız anlatılmaktadır.
Buna ek olarak tarayıcıda çalışan bir SWF dosyası, LocalConnection sınıfını kullanarak, çalışan bir AIR uygulamasıyla
iletişim kurabilir. Daha fazla bilgi için bkz. Uygulamalar arası iletişim.
Önemli: Bu bölümde anlatılan özellikler (ve air.swf dosyasındaki API'ler) son kullanıcının tarayıcısında Adobe® Flash®
Player 9 update 3'ün yüklü olmasını gerektirir. Flash Player'ın yüklü sürümünü kontrol etmek için kod yazabilir ve Flash
Player'ın gerekli sürümü yüklü değilse, kullanıcıya alternatif bir arabirim sağlayabilirsiniz. Örneğin Flash Player'ın daha
eski bir sürümü yüklüyse, AIR dosyasının yükleme sürümüne bir link verebilirsiniz (bir uygulama yüklemek için
badge.swf dosyasını veya air.swf API'sini kullanmak yerine).
AIR uygulamasını yüklemek için badge.swf dosyasını kullanma
AIR SDK'de bir badge.swf dosyası mevcuttur, bu dosya sayesinde kesintisiz yükleme özelliğini kolaylıkla
kullanabilirsiniz. badge.swf dosyası, çalışma zamanını ve AIR uygulamasını web sayfasındaki bir linkten yükleyebilir.
badge.swf dosyası ve kaynak kodu, web sitenizde yayınlamanız için size sağlanır.
Bu bölümdeki talimatlar, Adobe tarafından sağlanan badge.swf dosyasının parametrelerini ayarlama konusunda bilgi
sağlar. Ayrıca badge.swf dosyası için, özelleştirebileceğiniz kaynak kodunu da sağlıyoruz.
badge.swf dosyasını bir web sayfasına gömme
1 AIR SDK'nin samples/badge dizininde sağlanan aşağıdaki dosyaları bulun ve web sunucunuza ekleyin.
• badge.swf
• default_badge.html
• AC_RunActiveContent.js
2 default_badge.html sayfasını metin düzenleyicisinde açın.
3 default_badge.html sayfasında, AC_FL_RunContent() JavaScript işlevinde, aşağıdaki öğeler için FlashVars
parametre tanımlarını ayarlayın:
Parametre
Açıklama
appname
Çalışma zamanı yüklü olmadığında SWF dosyası tarafından görüntülenen uygulama adı.
appurl
(Zorunlu). Yüklenecek AIR dosyasının URL'si. Göreceli değil, mutlak bir URL kullanmalısınız.
airversion
(Zorunlu). Çalışma zamanının 1.0 sürümü için bunu 1.0'a ayarlayın.
imageurl
Kimlik kartında görüntülenecek görüntünün (isteğe bağlı) URL'si.
buttoncolor
Yükleme düğmesinin rengi (FFCC00 gibi, onaltılık bir değer olarak belirtilir).
messagecolor
Çalışma zamanı yüklü olmadığında düğmenin altında görüntülenen metin mesajının rengi (FFCC00 gibi,
onaltılık bir değer olarak belirtilir).
4 badge.swf dosyasının minimum boyutu 217 piksel genişlik, 180 piksel yüksekliktir. AC_FL_RunContent() işlevinin
width ve height parametrelerinin değerlerini ihtiyaçlarınızı karşılayacak şekilde ayarlayın.
5 İhtiyaçlarınızı karşılayacak şekilde default_badge.html dosyasını yeniden adlandırın ve kodunu ayarlayın (veya
başka bir HTML sayfasına dahil edin).
Ayrıca badge.swf dosyasını düzenleyebilir ve yeniden derleyebilirsiniz. Ayrıntılar için bkz. “badge.swf dosyasını
değiştirme” sayfa 278.
AIR uygulamasını bir web sayfasındaki kesintisiz yükleme linkinden yükleme
Kesintisiz yükleme linkini bir sayfaya ekledikten sonra kullanıcı, SWF dosyasındaki linki tıklatarak AIR uygulamasını
yükleyebilir.
1 Flash Player (sürüm 9 güncelleme 3 veya sonrası) yüklü olan bir web tarayıcısında HTML sayfasına gidin.
2 Web sayfasında, badge.swf dosyasındaki linki tıklatın.
• Çalışma zamanını yüklediyseniz, bir sonraki adıma geçin.
• Çalışma zamanını yüklemediyseniz, yüklemek isteyip istemediğinizi soran bir iletişim kutusu görüntülenir.
Çalışma zamanını yükleyin (bkz. “Adobe AIR yüklemesi” sayfa 1) ve bir sonraki adımla devam edin.
3 Yükleme penceresinde, varsayılan ayarları seçili halde bırakın ve ardından Devam düğmesini tıklatın.
Windows kullanan bir bilgisayarda AIR otomatik olarak şunları gerçekleştirir:
• Uygulamayı c:\Program Files\ konumuna yükler
• Uygulama için bir masaüstü kısayolu oluşturur
• Başlat Menüsü kısayolu oluşturur
• Program Ekle / Kaldır Denetim Masası'na uygulama için bir giriş ekler
Mac OS'de yükleyici uygulamayı Uygulamalar dizinine ekler (örneğin Mac OS'de /Applications dizininde).
4 İstediğiniz seçenekleri belirleyin, ardından Yükle düğmesini tıklatın.
5 Yükleme işlemi tamamlandığında, Son düğmesini tıklatın.
badge.swf dosyasını değiştirme
AIR SDK, badge.swf dosyası için kaynak dosyalar sağlar. Bu dosyalar SDK'nin src klasöründe bulunmaktadır:
Kaynak dosyalar
Açıklama
badge.fla
badge.swf dosyasını derlemek için kullanılan kaynak Flash CS3 veya CS4 dosyası. badge.fla dosyası bir SWF 9
dosyasına (Flash Player'da yüklenebilir) derlenir.
AIRBadge.as
basdge.fla dosyasında kullanılan temel sınıfı tanımlayan bir ActionScript 3.0 sınıfı.
Flash CS3 veya CS4 uygulamasını badge.fla dosyasının görsel arabirimini yeniden tasarlamak için kullanabilirsiniz.
AIRBadge sınıfında tanımlanan AIRBadge() yapıcı işlevi, http://airdownload.adobe.com/air/browserapi/air.swf
adresinde barındırılan air.swf dosyasını yükler. air.swf dosyası, kesintisiz yükleme özelliğini kullanma için kod içerir.
air.swf dosyası başarıyla yüklendiğinde, onInit() yöntemi (AIRBadge sınıfında) çağrılır:
private function onInit(e:Event):void {
_air = e.target.content;
switch (_air.getStatus()) {
case "installed" :
root.statusMessage.text = "";
break;
case "available" :
if (_appName && _appName.length > 0) {
root.statusMessage.htmlText = "<p align='center'><font color='#"
+ _messageColor + "'>In order to run " + _appName +
", this installer will also set up Adobe® AIR™.</font></p>";
} else {
+ _messageColor + "'>In order to run this application, "
+ "this installer will also set up Adobe® AIR™.</font></p>";
}
break;
case "unavailable" :
+ _messageColor
+ "'>Adobe® AIR™ is not available for your system.</font></p>";
root.buttonBg_mc.enabled = false;
break;
}
}
Kod, global _air değişkenini yüklenen air.swf dosyasının ana sınıfına ayarlar. Bu sınıf, badge.swf dosyasının kesintisiz
yükleme işlevini çağırmak için eriştiği aşağıdaki genel yöntemleri içerir:
Yöntem
Açıklama
getStatus()
Çalışma zamanının bilgisayara yüklenip yüklenmediğini (veya yüklenip yüklenemeyebileceğini) belirler.
Ayrıntılar için bkz. “Çalışma zamanının yüklenip yüklenmediğini kontrol etme” sayfa 280.
installApplication() Kullanıcının bilgisayarında belirtilen uygulamayı yükler. Ayrıntılar için bkz. “Tarayıcıdan AIR uygulaması
yükleme” sayfa 281.
•
url—URL'yi tanımlayan bir dize. Göreceli değil, mutlak bir URL yolu kullanmalısınız.
•
runtimeVersion—Uygulama tarafından yüklenmesi gerekli kılınan çalışma zamanının sürümünü
("1.0.M6" gibi) gösteren bir dize.
•
arguments— Yüklemenin ardından başlatılırsa uygulamaya iletilecek olan argümanlar. Uygulama
tanımlayıcı dosyasında allowBrowserInvocation öğesi true olarak ayarlanmışsa, yüklemenin
ardından uygulama başlatılır. (Uygulama tanımlayıcı dosyası hakkında daha fazla bilgi için bkz. “AIR
uygulamasının özelliklerini ayarlama” sayfa 41.) Uygulama, tarayıcıdan kesintisiz yüklemenin bir sonucu
olarak başlatılırsa (kullanıcının yüklemeden sonra başlatmayı seçmesiyle), yalnızca argümanlar iletilirse
uygulamanın NativeApplication nesnesi bir BrowserInvokeEvent nesnesi gönderir. Uygulamaya ilettiğiniz
verilerin güvenlik sonuçlarını göz önünde bulundurun. Ayrıntılar için bkz. “Yüklenmiş bir AIR uygulamasını
tarayıcıdan başlatma” sayfa 282.
url ve runtimeVersion için ayarlar, konteyner HTML sayfasındaki FlashVars ayarları kullanılarak SWF dosyasına
iletilir.
Uygulama, yüklemeden sonra otomatik olarak başlarsa, yüklenen uygulamanın başlatmadan sonra badge.swf
dosyasına başvurması için LocalConnection iletişimini kullanabilirsiniz. Ayrıntılar için bkz. Uygulamalar arası
iletişim.
Ayrıca, bir uygulamanın yüklenip yüklenmediğini kontrol etmek için air.swf dosyasının getApplicationVersion()
yöntemini de çağırabilirsiniz. Bu yöntemi uygulama yükleme işleminden önce veya yükleme başladıktan sonra
çağırabilirsiniz. Ayrıntılar için bkz. “AIR uygulamasının yüklenip yüklenmediğini bir web sayfasından kontrol etme”
sayfa 281.
air.swf dosyasını yükleme
Bir tarayıcıdaki web sayfasından çalışma zamanı ve AIR uygulamalarıyla etkileşimde bulunmak için air.swf
dosyasındaki API'leri kullanan kendi SWF dosyanızı oluşturabilirsiniz. air.swf dosyası
http://airdownload.adobe.com/air/browserapi/air.swf adresinde bulunmaktadır. air.swf API'lerine SWF dosyanızdan
başvurmak için, air.swf dosyasını SWF dosyanızla aynı uygulama etki alanına yükleyin. Aşağıdaki kod, yükleme SWF
dosyasının uygulama etki alanına air.swf dosyasını yüklemeye dair bir örnek gösterir:
var airSWF:Object; // This is the reference to the main class of air.swf
var airSWFLoader:Loader = new Loader(); // Used to load the SWF
var loaderContext:LoaderContext = new LoaderContext();
// Used to set the application domain
loaderContext.applicationDomain = ApplicationDomain.currentDomain;
airSWFLoader.contentLoaderInfo.addEventListener(Event.INIT, onInit);
airSWFLoader.load(new URLRequest("http://airdownload.adobe.com/air/browserapi/air.swf"),
loaderContext);
function onInit(e:Event):void
{
airSWF = e.target.content;
}
air.swf dosyası yüklendikten sonra (Loader nesnesinin contentLoaderInfo nesnesi init olayını gönderdiğinde),
air.swf API'lerinden herhangi birini çağırabilirsiniz. Bu API'ler şu bölümlerde anlatılmaktadır:
• “Çalışma zamanının yüklenip yüklenmediğini kontrol etme” sayfa 280
• “AIR uygulamasının yüklenip yüklenmediğini bir web sayfasından kontrol etme” sayfa 281
• “Tarayıcıdan AIR uygulaması yükleme” sayfa 281
• “Yüklenmiş bir AIR uygulamasını tarayıcıdan başlatma” sayfa 282
Not: AIR SDK'yle sağlanan badge.swf dosyası, air.swf dosyasını otomatik olarak yükler. Bkz. “AIR uygulamasını
yüklemek için badge.swf dosyasını kullanma” sayfa 277. Bu bölümdeki talimatlar, air.swf dosyasını yükleyen kendi SWF
dosyanızı oluşturmaya yöneliktir.
Çalışma zamanının yüklenip yüklenmediğini kontrol etme
SWF dosyası, http://airdownload.adobe.com/air/browserapi/air.swf adresinden yüklenen air.swf dosyasındaki
getStatus() yöntemini çağırarak, çalışma zamanının yüklenip yüklenmediğini kontrol edebilir. Ayrıntılar için bkz.
“air.swf dosyasını yükleme” sayfa 279.
air.swf dosyası yüklendikten sonra, SWF dosyası, aşağıda olduğu gibi air.swf dosyasının getStatus() yöntemini
çağırabilir:
var status:String = airSWF.getStatus();
getStatus() yöntemi, bilgisayardaki çalışma zamanının durumuna bağlı olarak aşağıdaki dize değerlerinden birini
döndürür:
Dize değeri
Açıklama
"available"
Bu bilgisayara çalışma zamanı yüklenebilir, ancak şu anda yüklü değil.
"unavailable"
Bu bilgisayara çalışma zamanı yüklenemez.
"installed"
Bu bilgisayarda çalışma zamanı yüklü.
Flash Player'ın (sürüm 9 yükseltme 3) gerekli sürümü tarayıcıda yüklü değilse, getStatus() yöntemi hata verir.
AIR uygulamasının yüklenip yüklenmediğini bir web sayfasından kontrol
etme
SWF dosyası, http://airdownload.adobe.com/air/browserapi/air.swf adresinden yüklenen air.swf dosyasındaki
getApplicationVersion() yöntemini çağırarak AIR uygulamasının (eşleşen bir uygulama kimliği ve yayıncı
kimliğiyle) yüklenip yüklenmediğini kontrol edebilir. Ayrıntılar için bkz. “air.swf dosyasını yükleme” sayfa 279.
air.swf dosyası yüklendikten sonra, SWF dosyası, aşağıda olduğu gibi air.swf dosyasının getApplicationVersion()
yöntemini çağırır:
var appID:String = "com.example.air.myTestApplication";
var pubID:String = "02D88EEED35F84C264A183921344EEA353A629FD.1";
airSWF.getApplicationVersion(appID, pubID, versionDetectCallback);
function versionDetectCallback(version:String):void
{
if (version == null)
{
trace("Not installed.");
// Take appropriate actions. For instance, present the user with
// an option to install the application.
}
else
{
trace("Version", version, "installed.");
// Take appropriate actions. For instance, enable the
// user interface to launch the application.
}
}
getApplicationVersion() yöntemi aşağıdaki parametrelere sahiptir:
Parametreler
Açıklama
appID
Uygulama için uygulama kimliği. Ayrıntılar için bkz. “Temel uygulama bilgilerini tanımlama” sayfa 42.
pubID
Uygulama için yayıncı kimliği. Ayrıntılar için bkz. “AIR yayıncı kimlikleri hakkında” sayfa 285.
callback
İşleyici işlevi olarak hizmet görecek bir geri çağırma işlevi. getApplicationVersion() yöntemi senkronize
çalışmaz ve yüklü sürümü (veya yüklü sürüm olmadığını) saptadıktan sonra, bu geri çağırma yöntemi çağrılır.
Geri çağırma yöntemi tanımı bir parametre, yüklenmiş uygulamanın sürüm dizesine ayarlı bir dize içermelidir.
Uygulama yüklenmemişse, önceki kod örneğinde gösterildiği gibi işleve bir null değeri iletilir.
Flash Player'ın (sürüm 9 yükseltme 3) gerekli sürümü tarayıcıda yüklü değilse, getApplicationVersion() yöntemi
hata verir.
Tarayıcıdan AIR uygulaması yükleme
SWF dosyası, http://airdownload.adobe.com/air/browserapi/air.swf adresinden yüklenen air.swf
dosyasındaki installApplication() yöntemini çağırarak bir AIR uygulaması yükleyebilir. Ayrıntılar için bkz.
air.swf dosyası yüklendikten sonra, SWF dosyası, aşağıdaki kodda olduğu gibi air.swf dosyasının
installApplication() yöntemini çağırabilir:
var url:String = "http://www.example.com/myApplication.air";
var runtimeVersion:String = "1.0";
var arguments:Array = ["launchFromBrowser"]; // Optional
airSWF.installApplication(url, runtimeVersion, arguments);
installApplication() yöntemi, kullanıcının bilgisayarında belirtilen uygulamayı yükler. Bu yöntem aşağıdaki
parametrelere sahiptir:
Parametre
Açıklama
url
Yüklenecek AIR dosyasının URL'sini tanımlayan dize. Göreceli değil, mutlak bir URL yolu kullanmalısınız.
runtimeVersion
Uygulama tarafından yüklenmesi gerekli kılınan çalışma zamanının sürümünü ("1.0" gibi) gösteren bir dize.
arguments
Yüklemenin ardından başlatılırsa uygulamaya iletilecek olan argüman dizisi. Uygulama tanımlayıcı dosyasında
allowBrowserInvocation öğesi true olarak ayarlanmışsa, yüklemenin ardından uygulama başlatılır.
(Uygulama tanımlayıcı dosyası hakkında daha fazla bilgi için bkz. “AIR uygulamasının özelliklerini ayarlama”
sayfa 41.) Uygulama, tarayıcıdan kesintisiz yüklemenin bir sonucu olarak başlatılırsa (kullanıcının yüklemeden
sonra başlatmayı seçmesiyle), yalnızca argümanlar iletilmişse uygulamanın NativeApplication nesnesi bir
BrowserInvokeEvent nesnesi gönderir. Ayrıntılar için bkz. “Yüklenmiş bir AIR uygulamasını tarayıcıdan
installApplication() yöntemi yalnızca, fare tıklatması gibi bir kullanıcı olayına yönelik olay işleyicisinde
çağrıldığında çalışabilir.
Flash Player'ın (sürüm 9 yükseltme 3) gerekli sürümü tarayıcıda yüklü değilse, installApplication() yöntemi hata
verir.
Mac OS'de bir uygulamanın güncellenen sürümünü yüklemek için, kullanıcının uygulama dizinine yüklemek üzere
yeterli sistem ayrıcalığına (ve uygulama çalışma zamanını güncelliyorsa yönetici ayrıcalıklarına) sahip olması gerekir.
Windows'ta kullanıcı yönetici ayrıcalıklarına sahip olmalıdır.
Ayrıca, bir uygulamanın önceden yüklenip yüklenmediğini kontrol etmek için air.swf dosyasının
getApplicationVersion() yöntemini de çağırabilirsiniz. Bu yöntemi uygulama yükleme işlemi başlamadan önce
veya yükleme başladıktan sonra çağırabilirsiniz. Ayrıntılar için bkz. “AIR uygulamasının yüklenip yüklenmediğini bir
web sayfasından kontrol etme” sayfa 281. Uygulama çalıştıktan sonra, LocalConnection sınıfını kullanarak
tarayıcıdaki SWF içeriğiyle iletişim kurabilir. Ayrıntılar için bkz. Uygulamalar arası iletişim.
Yüklenmiş bir AIR uygulamasını tarayıcıdan başlatma
Tarayıcı başlatma özelliğini kullanmak için (tarayıcıdan başlatılmasına izin vererek), hedef uygulamanın uygulama
tanımlayıcı dosyası aşağıdaki ayarı içermelidir:
Uygulama tanımlayıcı dosyası hakkında daha fazla bilgi için bkz. “AIR uygulamasının özelliklerini ayarlama” sayfa 41.
Tarayıcıdaki bir SWF dosyası, http://airdownload.adobe.com/air/browserapi/air.swf adresinden yüklenen air.swf
dosyasındaki launchApplication() yöntemini çağırarak bir AIR uygulamasını başlatabilir. Ayrıntılar için bkz.
air.swf dosyası yüklendikten sonra, SWF dosyası, aşağıdaki kodda olduğu gibi air.swf dosyasının
launchApplication() yöntemini çağırabilir:
var appID:String = "com.example.air.myTestApplication";
var pubID:String = "02D88EEED35F84C264A183921344EEA353A629FD.1";
var arguments:Array = ["launchFromBrowser"]; // Optional
airSWF.launchApplication(appID, pubID, arguments);
launchApplication() yöntemi air.swf dosyasının (kullanıcı arabirimi SWF dosyasının uygulama etki alanında
yüklüdür) üst düzeyinde tanımlanır. Bu yöntemi çağırmak AIR'in belirtilen uygulamayı başlatmasına neden olur
(yüklüyse ve tarayıcı başlatması olanağı varsa, uygulama tanımlayıcı dosyasındaki allowBrowserInvocation ayarını
kullanarak). Bu yöntem aşağıdaki parametrelere sahiptir:
Parametre
Açıklama
appID
Başlatılacak uygulamanın uygulama kimliği. Ayrıntılar için bkz. “Temel uygulama bilgilerini tanımlama”
sayfa 42.
pubID
Başlatılacak uygulamanın yayıncı kimliği. Ayrıntılar için bkz. “AIR yayıncı kimlikleri hakkında” sayfa 285.
arguments
Uygulamaya iletilecek bir argüman dizisi. Uygulamanın NativeApplication nesnesi, bu diziye ayarlanmış bir
özellikler kümesine sahip olan BrowserInvokeEvent olayını gönderir.
launchApplication() yöntemi yalnızca, fare tıklatması gibi bir user olayı için olay işleyicisinde çağrıldığında
çalışabilir.
Flash Player'ın (sürüm 9 yükseltme 3) gerekli sürümü tarayıcıda yüklü değilse, launchApplication() yöntemi hata
verir.
Uygulama tanımlayıcı dosyasında allowBrowserInvocation öğesi false olarak ayarlıysa, launchApplication()
yöntemini çağırmanın hiçbir etkisi yoktur.
Kullanıcı arabirimini uygulamayı başlatmak için sunmadan önce, air.swf dosyasında getApplicationVersion()
yöntemini çağırmak isteyebilirsiniz. Ayrıntılar için bkz. “AIR uygulamasının yüklenip yüklenmediğini bir web
sayfasından kontrol etme” sayfa 281.
Uygulama tarayıcı başlatma özelliği üzerinden çağrıldığında, uygulamanın NativeApplication nesnesi bir
BrowserInvokeEvent nesnesi gönderir. Ayrıntılar için bkz. “Tarayıcı başlatma” sayfa 260.
Tarayıcı başlatma özelliğini kullanıyorsanız, “Tarayıcı başlatma” sayfa 260 konusunda belirtilen güvenlik sonuçlarını
göz önünde bulundurduğunuzdan emin olun.
Uygulama çalıştıktan sonra, LocalConnection sınıfını kullanarak tarayıcıdaki SWF içeriğiyle iletişim kurabilir.
Ayrıntılar için bkz. Uygulamalar arası iletişim.
Kuruluş konuşlandırma
BT yöneticileri Adobe AIR çalışma zamanı ve AIR uygulamalarını, standart masaüstü konuşlandırma araçlarını
kullanarak sessiz bir şekilde yükleyebilir. BT yöneticileri şunları yapabilir:
• Microsoft SMS, IBM Tivoli gibi araçları veya önyükleyici kullanan sessiz yükleme işlemlerine olanak sağlayan
herhangi bir konuşlandırma aracını kullanarak Adobe AIR çalışma zamanını sessizce yükleyebilir
• Çalışma zamanını konuşlandırmak için kullanılan araçların aynılarını kullanarak AIR uygulamasını sessizce
yükleyebilir
Daha fazla bilgi için, bkz. Adobe AIR Yönetici Kılavuzu (http://www.adobe.com/go/learn_air_admin_guide_tr).
AIR dosyasını dijital olarak imzalama
AIR yükleme dosyalarınızı tanınan bir sertifika yetkilisi (CA) tarafından yayımlanan bir sertifikayla dijital olarak
imzalamak, kullanıcılarınıza, yükledikleri uygulamanın yanlışlıkla veya kötü amaçla değiştirilmediğine dair bir
güvence verir ve sizi imzalayan (yayıncı) olarak tanımlar. AIR uygulaması güvenilen veya yükleme bilgisayarında
güvenilen bir sertifikaya zincirle bağlanan bir sertifikayla imzalandığında, AIR, yükleme sırasında yayıncı adını
görüntüler. Aksi takdirde yayıncı adı “Bilinmeyen” olarak görüntülenir.
Önemli: Kötü amaçlı bir varlık, imzalama anahtar deposu dosyanızı bir şekilde ele geçirirse veya özel anahtarınızı
bulursa, AIR dosyasında sizin kimliğinizi kullanarak sahtecilik yapabilir.
Kod imzalayıcı sertifikalar hakkında bilgi
Kod imzalayıcı sertifikaların kullanımına ilişkin güvenlik teminatları, sınırlamalar ve yasal zorunluluklar Sertifika
Uygulama Bildirimleri'nde (CPS) ve sertifikayı yayımlayan yetkili tarafından yayınlanan abone sözleşmelerinde
anlatılır. En büyük 2 sertifika yetkilisinin sözleşmeleri hakkında daha fazla bilgi için:
Verisign CPS (http://www.verisign.com/repository/CPS/)
Verisign Abone Sözleşmesi (Verisign Subscriber’s Agreement)
(https://www.verisign.com/repository/subscriber/SUBAGR.html)
Thawte CPS (http://www.thawte.com/cps/index.html)
Thawte Kod İmzalama Geliştirici Sözleşmesi (Thawte Code Signing Developer's Agreement)
(http://www.thawte.com/ssl-digital-certificates/free-guides-whitepapers/pdf/develcertsign.pdf)
AIR kod imzalama hakkında
AIR dosyası imzalandığında, yükleme dosyasına bir dijital imza dahil edilir. İmza, AIR dosyasının imzalandıktan
sonra değiştirilmediğini doğrulamak için kullanılan bir paket özetini ve yayıncı kimliğini doğrulamak için kullanılan
imzalayıcı sertifikayla ilgili bilgileri içerir.
AIR, bir sertifikaya güvenilip güvenilmeyeceğini belirlemek için işletim sisteminin sertifika deposuyla desteklenen
ortak anahtar altyapısını (PKI) kullanır. Yayıncı bilgilerinin doğrulanması için, AIR uygulamasının yüklendiği
bilgisayar AIR uygulamasını imzalamak için kullanılan sertifikaya doğrudan güvenmeli veya sertifikayı güvenilen bir
sertifika yetkilisine bağlayan bir sertifika zincirine güvenmelidir.
AIR dosyası güvenilen kök sertifikalarından birine zincirle bağlı olmayan bir sertifikayla (normalde bu tüm kendinden
imzalı sertifikaları da içerir) imzalanırsa, yayıncı bilgileri doğrulanamaz. AIR, AIR paketinin imzalandıktan sonra
değiştirilmediğini belirleyebilse de, dosyayı gerçekten kimin oluşturduğunu ve imzaladığını bilmenin bir yolu yoktur.
Not: Kullanıcı kendinden imzalı bir sertifikaya güvenmeyi seçebilir, bundan sonra sertifikayla imzalanmış olan tüm AIR
uygulamaları sertifikada yayıncı adı olarak ortak ad alanı değerini görüntüler. AIR, kullanıcının bir sertifikayı güvenilir
olarak belirlemesi için herhangi bir yöntem sağlamaz. Sertifika (özel anahtar dahil değil) kullanıcıya ayrı olarak
sağlanmalıdır ve kullanıcı sertifikayı sistem sertifika deposunda uygun bir konuma içe aktarmak için, işletim sistemi
tarafından sağlanan mekanizmalardan birini veya uygun bir araç kullanmalıdır.
AIR yayıncı kimlikleri hakkında
AIR dosyası oluşturmanın bir parçası olarak, AIR Geliştirici Aracı (ADT) bir yayıncı kimliği oluşturur. Bu, AIR
dosyasını oluşturmada kullanılan sertifika için benzersiz olan bir kimliktir. Aynı sertifikayı birden fazla AIR
uygulaması için yeniden kullanırsanız, uygulamalar aynı yayıncı kimliğine sahip olur. Yayıncı kimliği
LocalConnection iletişiminde AIR uygulamasını tanımlamak için kullanılır (bkz. Uygulamalar arası iletişim).
Yüklenmiş bir uygulamanın yayıncı kimliğini, NativeApplication.nativeApplication.publisherID özelliğini
okuyarak tanımlayabilirsiniz.
Aşağıdaki alanlar yayıncı kimliğini hesaplamak için kullanılır: Name, CommonName, Surname, GivenName, Initials,
GenerationQualifier, DNQualifier, CountryName, localityName, StateOrProvinceName, OrganizationName,
OrganizationalUnitName, Title, Email, SerialNumber, DomainComponent, Pseudonym, BusinessCategory,
StreetAddress, PostalCode, PostalAddress, DateOfBirth, PlaceOfBirth, Gender, CountryOfCitizenship,
CountryOfResidence ve NameAtBirth. Bir sertifika yetkilisi tarafından yayımlanan sertifikayı yenilerseniz veya
kendinden imzalı bir sertifikayı yeniden oluşturursanız, yayıncı kimliğinin aynı kalması için bu alanların da aynı
olması gerekir. Buna ek olarak, CA tarafından yayımlanan bir sertifikanın kök sertifikasıyla kendinden imzalı bir
sertifikanın ortak anahtarı da aynı olmalıdır.
Sertifika formatları hakkında
AIR imzalama araçları, Java Şifreleme Mimarisi (JCA) ile erişilebilen tüm anahtar depolarını kabul eder. Bunlar
arasında PKCS12 formatlı dosyalar (genellikle .pfx veya .p12 dosya uzantısı kullanan), Java .keystore dosyaları,
PKCS11 donanım anahtar depoları ve sistem anahtar depoları gibi dosya tabanlı anahtar depoları bulunmaktadır.
ADT'nin erişebildiği anahtar deposu formatları, ADT'yi çalıştırmak için kullanılan Java çalışma zamanının sürümüne
ve yapılandırmasına bağlıdır. PKCS11 donanım belirteçleri gibi bazı anahtar deposu türlerine erişmek, ek yazılım
sürücülerinin ve JCA eklentilerinin yüklenmesini ve yapılandırılmasını gerektirebilir.
AIR dosyalarını imzalamak için, var olan bir sınıf 3, yüksek güvenceli kod imzalayıcı sertifikayı kullanabilir veya yeni
bir tane edinebilirsiniz. Örneğin aşağıdaki Verisign veya Thawte sertifika türlerinden herhangi biri kullanılabilir:
• Verisign:
• Microsoft Authenticode Digital ID
• Sun Java Signing Digital ID
• Thawte:
• AIR Geliştirici Sertifikası
• Apple Geliştirici Sertifikası
• JavaSoft Geliştirici Sertifikası
• Microsoft Authenticode Sertifikası
Not: Sertifika, kod imzalama için işaretlenmiş olmalıdır. Genelde bir SSL sertifikasını AIR dosyalarını imzalamak için
kullanamazsınız.
Zaman damgaları
Bir AIR dosyasını imzaladığınızda paketleme aracı, zaman damgası yetkilisinin sunucusunu, bağımsız doğrulanabilir
bir imzalama tarihi ve saati almak için sorgular. Alınan zaman damgası AIR dosyasına gömülüdür. İmzalayıcı sertifika
imzalama sırasında geçerli olduğu sürece, sertifikanın süresi dolduktan sonra bile AIR dosyası yüklenebilir. Diğer
yandan, zaman damgası alınamazsa, sertifikanın süresi dolduğunda veya sertifika iptal edildiğinde AIR dosyası artık
yüklenemez hale gelir.
AIR paketleme araçları varsayılan olarak bir zaman damgası alır. Ancak zaman damgası hizmeti kullanılamadığında
uygulamaların paketlenmesini sağlamak için, zaman damgalamayı devre dışı bırakabilirsiniz. Adobe, genel olarak
dağıtılan tüm AIR dosyalarının bir zaman damgası içermesini önerir.
AIR paketleme araçları tarafından kullanılan varsayılan zaman damgası yetkilisi Geotrust'tır.
Sertifika alma
Bir sertifika almak için normalde sertifika yetkilisinin web sitesini ziyaret edersiniz ve şirketin tedarik işlemini
tamamlarsınız. AIR araçlarının ihtiyacı olan anahtar deposu dosyasını oluşturmak için kullanılan araçlar, satın alınan
sertifikanın türüne, sertifikanın alıcı bilgisayarda nasıl saklandığına ve bazı durumlarda sertifikayı almak için
kullanılan tarayıcının türüne bağlıdır. Örneğin Verisign veya Thawte, bir Microsoft Authenticode sertifikasını almak
ve dışa aktarmak için Microsoft Internet Explorer kullanmanızı gerekli kılar. Bu şekilde sertifika doğrudan Internet
Explorer kullanıcı arabiriminden .pfx dosyası olarak dışa aktarılabilir.
AIR kurulum dosyalarını paketlemek için, Air Geliştirici Aracı'nı (ADT) kullanarak kendinden imzalı bir sertifika
oluşturabilirsiniz. Bazı üçüncü taraf araçlar da kullanılabilir.
Kendinden imzalı bir sertifikanın nasıl oluşturulacağı ve AIR dosyasını imzalama konusunda talimatlar için, bkz. “AIR
yükleme dosyasını AIR Geliştirici Aracı (ADT) kullanarak paketleme” sayfa 306. Ayrıca AIR dosyalarını Flex Builder,
Dreamweaver ve Flash için AIR güncelleme kullanarak da dışa aktarabilir ve imzalayabilirsiniz.
Aşağıdaki örnek, Thawte Sertifika Yetkilisi'nden AIR Geliştirici Sertifikası'nın nasıl alınacağını ve sertifikanın ADT'yle
kullanıma nasıl hazırlanacağını anlatır. Bu örnek kod imzalayıcı sertifikasını alma ve kullanıma hazırlama yollarından
yalnızca birini göstermektedir.
Örnek: Thawte'den AIR Geliştirici Sertifikası alma
Thawte web sitesi, AIR Geliştirici Sertifikası'nı satın almak için Mozilla Firefox tarayıcı kullanmanızı gerekli kılar.
Sertifikanın özel anahtarı, tarayıcının anahtar deposunda saklanmaktadır. Firefox anahtar deposunun ana şifreyle
korunduğundan ve bilgisayarın da fiziksel koşullar bakımından güvencede olduğundan emin olun. (Tedarik işlemi
tamamlandıktan sonra, sertifika anahtarını ve özel anahtarı tarayıcı anahtar deposundan dışa aktarabilir ve
kaldırabilirsiniz.)
Sertifika kayıt işleminin bir parçası olarak, bir özel/ortak anahtar çifti oluşturulur. Özel anahtar otomatik olarak
Firefox anahtar deposunda saklanır. Sertifikayı Thawte’nin web sitesinden istemek ve almak için aynı bilgisayarı ve
tarayıcıyı kullanmalısınız.
1 Thawte web sitesini ziyaret edin ve Kod İmzalayıcı Sertifikalar için Ürün sayfası (Product page for Code Signing
Certificates) bölümüne gidin.
2 Kod İmzalayıcı Sertifikalar listesinden, Adobe AIR Geliştirici Sertifikası'nı seçin.
3 Üç adımlı kayıt işlemini tamamlayın. Kuruluş ve irtibat bilgileri vermeniz gerekir. Daha sonra Thawte kimlik
doğrulama işlemini gerçekleştirir ve ek bilgiler isteyebilir. Doğrulama tamamlandıktan sonra Thawte size
sertifikayı almanız için gereken talimatların bulunduğu bir e-posta yollar.
Not: Not: Gerekli belge türüyle ilgili ek bilgilere şuradan ulaşılabilir: https://www.thawte.com/ssl-digitalcertificates/free-guides-whitepapers/pdf/enroll_codesign_eng.pdf.
4 Thawte sitesinden yayımlanan sertifikayı alın. Sertifika otomatik olarak Firefox anahtar deposuna kaydedilir.
5 Özel anahtarı ve sertifikayı içeren bir anahtar deposu dosyasını Firefox anahtar deposundan aşağıdaki adımları
izleyerek dışa aktarın:
Not: Özel anahtarı/sertifikayı Firefox'tan dışarı aktarırken, ADT, Flex, Flash ve Dreamweaver'ın kullanabileceği
.p12 (pfx) formatında dışa aktarılır.
a Firefox Sertifika Yöneticisi iletişim kutusunu açın:
b Windows'ta: Araçlar -> Seçenekler -> Gelişmiş -> Sertifikalar -> Sertifikaları Yönet öğelerini açın
c Mac OS'de: Firefox -> Tercihler -> Gelişmiş -> Sertifikalarınız -> Sertifikaları Görüntüle öğelerini açın
d Sertifika listesinden Adobe AIR Kod İmzalayıcı Sertifikası'nı seçin ve Yedekle düğmesini tıklatın.
e Anahtar deposu dosyasının dışa aktarılacağı bir dosya adı ve konum girin ve Kaydet'i tıklatın.
f
Firefox ana şifresini kullanıyorsanız dosyayı dışa aktarırken, yazılım güvenlik aygıtı için şifrenizi girmeniz
istenir. (Bu şifre yalnızca Firefox tarafından kullanılır.)
g Sertifika Yedekleme Şifresi Seç iletişim kutusunda, anahtar deposu dosyası için bir şifre oluşturun.
Önemli: Bu şifre anahtar deposu dosyasını korur ve dosya, AIR uygulamalarını imzalamada kullanılırken
gereklidir. Güvenli bir şifre seçilmelidir.
h Tamam'ı tıklatın. Başarılı bir yedekleme şifresi mesajı almanız gerekir. Özel anahtarı ve sertifikayı içeren anahtar
deposu dosyası .p12 dosya uzantısıyla (PKCS12 formatında) kaydedilir.
6 Dışa aktarılan anahtar deposu dosyasını ADT, Flex Builder, Flash veya Dreamweaver ile kullanın. Dosya için
oluşturulan şifre, bir AIR uygulaması imzalanacağı zaman gereklidir.
Önemli: Özel anahtar ve sertifika, Firefox anahtar deposunda saklanmaya devam eder. Bu sayede sertifika dosyasının
ek bir kopyasını dışa aktarabilirsiniz, ancak sertifikanızın ve özel anahtarınızın güvenliğinin sağlanması için korunması
gereken bir başka erişim noktası da sağlanmış olur.
Sertifikaları değiştirme
Bazı durumlarda, AIR uygulamanızı imzalamak için kullandığınız sertifikayı değiştirmeniz gerekebilir. Bu durumlar
şunlardır:
• Kendinden imzalı bir sertifikadan bir sertifika yetkilisi tarafından yayımlanan bir sertifikaya yükseltme yapılırken
• Süresi dolmak üzere olan kendinden imzalı bir sertifika, başka bir sertifikayla değiştirilirken
• Bir ticari sertifika diğeriyle değiştirilirken, örneğin şirketinizin kimliği değiştiğinde
İmzalayıcı sertifika AIR uygulamasının kimliğini belirleyen öğelerden biri olduğu için, uygulamanız için bir
güncellemeyi farklı bir sertifikayla imzalayamazsınız. AIR'in bir AIR dosyasını güncelleme olarak tanıması için, hem
orijinal hem de güncellenen AIR dosyasını aynı sertifikayla imzalamanız gerekir. Aksi takdirde AIR, var olan
yüklemeyi güncellemek yerine yeni AIR dosyasını ayrı bir uygulama olarak yükler.
AIR 1.1 sürümünden itibaren, bir uygulamanın imzalayıcı sertifikası bir geçiş imzası kullanılarak
değiştirilebilmektedir. Geçiş imzası, güncelleme AIR dosyasına uygulanan ikinci imzadır. Geçiş imzası, imzalayanın
uygulamanın orijinal yayıncısı olduğunu belirten orijinal sertifikayı kullanır.
Önemli: Orijinal sertifikanın süresi dolmadan veya orijinal sertifika iptal edilmeden sertifika değiştirilmelidir.
Sertifikanızın süresi dolmadan önce geçiş imzasıyla imzalanan bir güncelleme oluşturmazsanız, kullanıcılar herhangi bir
güncelleme yüklemeden önce uygulamanızın var olan sürümünü kaldırmak zorunda kalır. Ticari olarak yayımlanan
sertifikalar genellikle sürenin dolmasını önlemek için yenilenebilir. Kendinden imzalı sertifikalar yenilenemez.
Sertifikaları değiştirmek için:
1 Uygulamanız için bir güncelleme oluşturun
2 Güncelleme AIR dosyasını yeni sertifikayla paketleyin ve imzalayın
3 AIR dosyasını orijinal sertifikayla (ADT -migrate komutunu kullanarak) yeniden imzalayın
Geçiş imzası uygulama yordamı “Uygulama sertifikasını değiştirmek için AIR dosyasını imzalama” sayfa 312
bölümünde anlatılmaktadır.
Güncellenen AIR dosyası yüklendiğinde, uygulamanın kimliği değişir. Bu kimlik değişikliğinin etkileri şunlardır:
• Uygulamanın yayıncı kimliği yeni sertifikayla eşleşmek için değişir.
• Yeni uygulama sürümü, var olan şifreli yerel depodaki verilere erişemez.
• Uygulama depolama dizininin konumu değişir. Eski konumdaki veriler yeni dizine kopyalanmaz. (Ancak yeni
uygulama, eski yayıncı kimliğine bağlı olarak orijinal dizini bulabilir).
• Uygulama artık eski yayıncı kimliğini kullanarak yerel bağlantıları açamaz.
• Bir kullanıcı geçiş öncesi AIR dosyasını yeniden yüklerse, AIR bu dosyayı orijinal yayıncı kimliğini kullanarak ayrı
bir uygulama olarak yükler.
Uygulamanın orijinal ve yeni sürümleri arasındaki verilerin geçişini yapmak uygulamanızın sorumluluğundadır.
Şifreli yerel depodaki (ELS) verilerin geçişini yapmak için, verileri sertifikada değişiklik yapılmadan dışa aktarmanız
gerekir. Uygulamanızın yeni sürümünün eski sürümün ELS'sini okuması imkansızdır. (Genellikle verileri yeniden
oluşturmak, verilerin geçişini yapmaktan daha kolaydır.)
Geçiş imzasını olabildiğince fazla sayıdaki sonraki güncellemeye uygulamaya devam etmelisiniz. Aksi takdirde,
orijinalden yükseltme yapmamış olan kullanıcıların bir ara geçiş sürümü yüklemeleri veya sizin son güncellemenizi
yükleyebilmek için kendi geçerli sürümlerini kaldırmaları gerekir. Sonunda orijinal sertifikanın süresi dolar ve siz de
artık geçiş imzası uygulayamazsınız. (Ancak, zaman damgalamayı devre dışı bırakmadığınız sürece, önceden bir geçiş
imzasıyla imzalanan AIR dosyaları geçerliliğini korur. Geçiş imzasının zaman damgası sayesinde AIR, sertifikanın
süresi dolduktan sonra bile imzayı kabul eder.)
Geçiş imzasına sahip bir AIR dosyası diğer yönlerden normal bir AIR dosyasıdır. Uygulama bir sisteme orijinal
sürümü olmadan yüklenirse, AIR yeni sürümü normal bir şekilde yükler.
Not: Ticari olarak yayımlanmış bir sertifikayı yenilediğinizde, genellikle sertifikaya geçiş yapmanız gerekmez. Yenilenen
sertifika, ayırt edilen ad değiştirilene kadar orijinaliyle aynı yayıncı kimliğini korur. Ayırt edilen adın belirlenmesine
yönelik kullanılan sertifika niteliklerinin tam listesi için, bkz. “AIR yayıncı kimlikleri hakkında” sayfa 285.
Terminoloji
Bu bölümde, uygulamanızı genel dağıtım için nasıl imzalamanız gerektiğine yönelik kararlar alırken anlamanız
gereken bazı anahtar sözcükleri kapsayan bir terimler sözlüğü bulunmaktadır.
Terim
Açıklama
Sertifika Yetkilisi (CA)
Güvenilen bir üçüncü taraf olarak hizmet veren ve sonunda bir ortak anahtar sahibinin kimliğini
onaylayan ortak anahtar altyapı ağındaki bir varlık. Normalde bir CA, sertifika sahibinin kimliğini
doğruladığını bildirmek için kendi özel anahtarıyla imzalanan dijital sertifikalar yayımlar.
Sertifika Uygulama Bildirimi (CPS)
Sertifika yetkilisinin sertifika yayımlama ve doğrulamaya ilişkin uygulamalarını ve politikalarını
ortaya koyar. CPS, CA ile aboneleri ve bağlı olduğu taraflar arasındaki anlaşmanın bir parçasıdır.
Ayrıca kimlik doğrulama politikalarını ve sağladıkları sertifikaların sunduğu güvence düzeyleri de
anlatır.
Sertifika İptal Listesi (CRL)
İptal edilen ve artık bağlı olunmaması gereken yayımlanmış sertifikaların bir listesi. AIR, bir AIR
uygulaması imzalandığında ve mevcut zaman damgası yoksa yine uygulama yüklendiğinde CRL'yi
kontrol eder.
Sertifika zinciri
Bir sertifika zinciri, zincirdeki her sertifikanın bir sonraki sertifika tarafından imzalandığı bir sertifika
sırası.
Terim
Açıklama
Dijital Sertifika
Sahibin kimliği, sahibin ortak anahtarı ve sertifikanın kendi kimliği hakkında bilgi içeren dijital bir
belge. Bir sertifika yetkilisi tarafından yayımlanan sertifika da, yayımlayan CA'ya ait bir sertifika
tarafından imzalanır.
Dijital İmza
Yalnızca ortak-özel anahtar çiftinin yarısı olan ortak anahtarla şifresi çözülebilen şifreli bir mesaj
veya özet. Bir PKI'de dijital imza, sonunda sertifika yetkilisine kadar izlenebilen bir veya daha fazla
dijital sertifika içerir. Kişinin yayımlayan sertifika yetkilisine, imzalayanın kimliğine güvendiğini
varsayarak, dijital imza bir mesajın (veya bilgisayar dosyasının) imzalandığından beri
değiştirilmediğini doğrulamak için kullanılabilir (kullanılan şifreleme algoritmasının sağladığı
güvence sınırları dahilinde).
Anahtar Deposu
Dijital sertifikaları ve bazı durumlarda ilgili özel anahtarları içeren veri tabanı.
Java Şifreleme Mimarisi (JCA)
Anahtar depolarını yönetmek ve bunlara erişmek için kullanılan genişletilebilir bir mimari. Daha
fazla bilgi için bkz. Java Şifreleme Mimarisi Başvuru Kılavuzu (Java Cryptography Architecture
Reference Guide).
PKCS #11
RSA Laboratuvarları'nın Şifreleme Belirteci Arabirim Standardı. Donanım belirteci tabanlı anahtar
deposu.
PKCS #12
RSA Laboratuvarları'nın Kişisel Bilgi Alışverişi Sözdizimi Standardı. Genellikle bir özel anahtarı ve
ilişkilendirilmiş dijital sertifikasını içeren dosya tabanlı anahtar deposu.
Özel Anahtar
İki parçalı ortak-özel anahtar asimetrik şifreleme sisteminin özel olan yarısı. Özel anahtar gizli
tutulmalıdır ve hiçbir zaman bir ağ üzerinden iletilmemelidir. Dijital olarak imzalanan mesajlar,
imzalayan tarafından özel anahtarla şifrelenir.
Ortak Anahtar
İki parçalı ortak-özel anahtar asimetrik şifreleme sisteminin ortak olan yarısı. Ortak anahtar
kullanıma açıktır ve özel anahtarla şifrelenen mesajların şifresini çözmek için kullanılır.
Ortak Anahtar Altyapısı (PKI)
Sertifika yetkililerinin ortak anahtar sahiplerinin kimliğini doğruladığı güven sistemi. Ağın
istemcileri, dijital bir mesajı (veya dosyayı) imzalayanın kimliğini doğrulamak için güvenilen bir CA
tarafından yayımlanan dijital sertifikalara güvenir.
Zaman damgası
Bir olayın gerçekleştiği tarihi ve saati içeren dijital olarak imzalanmış veri. ADT, zaman damgasını
AIR paketindeki RFC 3161 uyumlu zaman sunucusundan dahil edebilir. AIR mevcut olduğunda
zaman damgasını, sertifikanın imzalama sırasındaki geçerliliğini belirlemek için kullanır. Bu sayede
imzalayıcı sertifikasının süresi dolduktan sonra da AIR uygulaması yüklenebilir.
Zaman damgası yetkilisi
Zaman damgalarını yayımlayan yetkili. Bir zaman damgasının AIR tarafından tanınması için,
damganın RFC 3161 ile uyumlu olması ve zaman damgası imzasının yükleme bilgisayarındaki
güvenilen kök sertifikaya zincirle bağlı olması gerekir.
290
Bölüm 32: AIR uygulamalarını güncelleme
Kullanıcılar, bilgisayarlarındaki veya tarayıcıdaki (kesintisiz yükleme özelliğini kullanarak) bir AIR dosyasını çift
tıklatarak bir AIR uygulamasını yükleyebilir veya güncelleyebilirler. Adobe® AIR™ yükleyici uygulaması, önceden var
olan bir uygulamayı güncellediğinde kullanıcıyı uyararak yüklemeyi yönetir. (Bkz. “AIR uygulamalarını Dağıtma,
Yükleme ve Çalıştırma” sayfa 275.)
Ancak, Updater sınıfını kullanarak kendini yeni sürüme güncelleyen yüklenmiş bir uygulamanız da olabilir.
(Yüklenmiş bir uygulama, yeni bir sürümün indirilmek ve yüklenmek üzere kullanılabilir olduğunu saptayabilir.)
Updater sınıfı, kullanıcının bilgisayarında yer alan bir AIR dosyasını göstermek ve bu sürüme güncellemenizi sağlayan
bir update() yöntemini içerir.
Güncelleme AIR dosyasının hem uygulama kimliği hem de yayıncı kimliği, güncellenecek uygulamanınkilerle
eşleşmelidir. Yayıncı kimliği imzalanan sertifikadan türetilir, yani hem güncelleme hem de güncellenecek uygulama,
aynı sertifikayla imzalanmış olmalıdır.
AIR 1.1 sürümünden itibaren, bir uygulamayı yeni bir kod imzalayan sertifika kullanması için taşıyabilirsiniz. Yeni bir
imza kullanması için bir uygulamayı taşıma, hem yeni hem de orijinal sertifikayı içeren güncelleme AIR dosyasını
imzalamayı içerir. Sertifika taşıma, tek yönlü bir işlemdir. Taşımadan sonra, yalnızca yeni sertifikayla (veya her iki
dosyayla) imzalanan AIR dosyaları var olan bir yüklemeye güncellemeler olarak dikkate alınır.
Kendinden imzalı sertifikayı ticari kod imzalayan sertifika olarak değiştirmek veya bir kendinden imzalı veya ticari
sertifikadan diğerine geçmek için sertifiya taşımayı kullanabilirsiniz. Sertifikayı taşımazsanız, var olan kullanıcılar yeni
sürümü yüklemeden önce geçerli uygulama sürümlerini kaldırmak zorunda kalır. Daha fazla bilgi için bkz.
“Sertifikaları değiştirme” sayfa 287.
Uygulamaları güncelleme hakkında
Updater sınıfı (flash.desktop paketindeki), geçerli uygulamanızı farklı bir sürümle güncellemek için kullanabileceğiniz
update() yöntemini içerir. Örneğin, kullanıcının masaüstünde bir AIR dosyası sürümü ("Sample_App_v2.air")
bulunuyorsa, aşağıdaki kod uygulamayı günceller:
var updater:Updater = new Updater();
var airFile:File = File.desktopDirectory.resolvePath("Sample_App_v2.air");
var version:String = "2.01";
updater.update(airFile, version);
Updater sınıfını kullanmadan önce, kullanıcı veya uygulama AIR dosyasının güncellenmiş sürümünü bilgisayara
yüklemelidir. Daha fazla bilgi için bkz. “Kullanıcının bilgisayarına bir AIR dosyası indirme” sayfa 292.
Yöntem çağrısının sonuçları
Çalışma zamanındaki bir uygulama update() yöntemini çağırdığında, çalışma zamanı uygulamayı kapatır ve daha
sonra AIR dosyasından yeni sürümü yüklemeye çalışır. Çalışma zamanı, AIR dosyasında belirtilen uygulama kimliği
ve yayıncı kimliğinin update() yöntemini çağıran uygulamaya ilişkin uygulama kimliği ve yayıncı kimliğiyle eşleşip
eşleşmediğini kontrol eder. (Uygulama kimliği ve yayıncı kimliği hakkında bilgi için bkz. “AIR uygulamasının
özelliklerini ayarlama” sayfa 41.) Çalışma zamanı ayrıca, sürüm dizesinin update() yöntemine iletilen sürüm dizesiyle
eşleşip eşleşmediğini kontrol eder. Yükleme başarıyla tamamlanırsa, çalışma zamanı uygulamanın yeni sürümünü
açar. Aksi halde (yükleme tamamlanamazsa), uygulamanın var olan (yükleme öncesi) sürümünü yeniden açar.
Mac OS'de uygulamanın güncellenmiş bir sürümünü yüklemek için, kullanıcının uygulama dizinine yükemek için
yeterli sistem ayrıcalıklarına sahip olması gerekir. Windows'ta, kullanıcının yönetici ayrıcalıklarına sahip olması
gerekir.
Uygulamanın güncellenmiş sürümü çalışma zamanının güncellenmiş sürümünü gerektiriyorsa, yeni çalışma zamanı
sürümü yüklenir. Kullanıcı, çalışma zamanını güncellemek için bilgisayara ilişkin yönetici ayrıcalıklarına sahip
olmalıdır.
ADL kullanarak uygulama test edilirken update() yönteminin çağrılması bir çalışma zamanı istisnasına neden olur.
Sürüm dizesi hakkında
update() yönteminin sürüm parametresi olarak belirtilen dize, yüklenecek AIR dosyasına ilişkin uygulama
tanımlayıcı dosyasında bulunan ana uygulama öğesinin sürüm niteliğindeki dizeyle eşleşmelidir. Sürüm
parametresinin belirtilmesi, güvenlik nedenleri için gereklidir. Uygulamanın AIR dosyasında sürüm numarasını
doğrulaması istenerek, geçerli uygulamada giderilmiş olan bir güvenlik açığını içerebilecek daha eski bir sürümün
yanlışlıkla yüklenmesi engellenir. Uygulama, indirgeme saldırılarını engellemek için yüklenmiş uygulamadaki sürüm
dizesiyle AIR dosyasındaki sürüm dizesinin eşleşip eşleşmediğini de kontrol etmelidir.
Sürüm dizesi herhangi bir formatta olabilir. Örneğin, "2.01" veya "sürüm 2" olabilir. Bu dizenin formatına karar
vermek, siz uygulama geliştiricisine bırakılmıştır. Çalışma zamanı sürüm dizesini doğrulamaz; uygulama kodu, bunu
uygulamanın güncellenmesinden önce yapmalıdır.
Adobe AIR uygulaması web üzerinden bir AIR dosyası indirirse, web servisinin Adobe AIR uygulamasını indirilen
sürüme ilişkin bilgilendirebileceği bir mekanizmaya sahip olmak, iyi bir uygulamadır. Bu şekilde, uygulama dizeyi
update() yönteminin version parametresi olarak kullanabilir. AIR dosyası sürümünün bilinmediği diğer
yöntemlerle elde edildiyse, AIR uygulaması sürüm bilgisini belirlemek için AIR dosyasını inceleyebilir. (AIR dosyası,
sıkıştırılmış bir ZIP arşividir ve uygulama tanımlayıcı dosyası arşivdeki ikinci kayıttır.)
Uygulama tanımlayıcı dosyası hakkında ayrıntılar için bkz. “AIR uygulamasının özelliklerini ayarlama” sayfa 41.
Özel uygulama güncelleme kullanıcı arabirimini sunma
AIR, varsayılan bir güncelleme arabirimi içerir:
Bu arabirim, her zaman kullanıcı bir uygulama sürümünü bilgisayara ilk yüklediğinde kullanılır. Ancak, sonraki
örneklerde kullanmak için kendi arabiriminizi tanımlayabilirsiniz. Bunu yapmak için, yüklenmiş geçerli uygulamaya
ilişkin uygulama tanımlayıcı dosyasında bir customUpdateUI öğesi belirleyin:
Uygulama yüklendiğinde ve kullanıcı yüklenen uygulamayla eşleşen, uygulama kimliğine ve yayıncı kimliğine sahip
bir AIR dosyasını açtığında, çalışma zamanı varsayılan AIR uygulama yükleyicisi yerine uygulamayı açar. Daha fazla
bilgi için bkz. “Uygulama güncellemeleri için özel kullanıcı arabirimi sağlama” sayfa 47.
Uygulama, çağrıldığında (NativeApplication.nativeApplication nesnesi bir invoke olayı gönderdiğinde),
uygulamanın güncellenip güncellenmeyeceğine karar verebilir (Updater sınıfını kullanarak). Güncellemeye karar
verirse, kullanıcıya kendi yükleme arabirimini (çalışan standart arabirimden farklı olan) sunabilir.
Kullanıcının bilgisayarına bir AIR dosyası indirme
Updater sınıfını kullanmak için, kullanıcı veya uygulama önce kullanıcının bilgisayarına bir AIR dosyasını yerel olarak
kaydetmelidir. Örneğin, aşağıdaki kod bir URL'den AIR dosyasını
okur(http://example.com/air/updates/Sample_App_v2.air) ve AIR dosyasını uygulama depo dizinine kaydeder:
var urlString:String = "http://example.com/air/updates/Sample_App_v2.air";
var urlReq:URLRequest = new URLRequest(urlString);
var urlStream:URLStream = new URLStream();
var fileData:ByteArray = new ByteArray();
urlStream.addEventListener(Event.COMPLETE, loaded);
urlStream.load(urlReq);
function loaded(event:Event):void {
urlStream.readBytes(fileData, 0, urlStream.bytesAvailable);
writeAirFile();
}
function writeAirFile():void {
var file:File = File.applicationStorageDirectory.resolvePath("My App v2.air");
fileStream.writeBytes(fileData, 0, fileData.length);
fileStream.close();
trace("The AIR file is written.");
}
Daha fazla bilgi için bkz. “Dosyaları okuma ve dosyalara yazma için iş akışı” sayfa 111.
Uygulamanın ilk kez çalışıp çalışmadığını görmek için
kontrol edin
Uygulamayı güncellediğinizde, kullanıcıya bir "başlarken" veya "hoşgeldiniz" mesajı sunmak isteyebilirsiniz.
Başlatmadan sonra, uygulama mesajın görüntülenip görüntülenmeyeceğini belirlemek için ilk kez çalışıp
çalışmadığını kontrol eder.
Bunu yapmanın bir yolu, uygulamanın başlatılmasından sonra uygulama depo dizinine bir dosya kaydetmektir.
Uygulama her başladığında, bu dosyanın mevcudiyetini kontrol etmelidir. Dosya mevcut değilse, uygulama geçerli
kullanıcı için ilk kez çalışmaktadır. Dosya mevcutsa, uygulama önceden en az bir kez çalışmıştır. Dosya mevcutsa ve
geçerli sürüm numarasından daha eski bir sürüm numarası içeriyorsa, kullanıcının yeni sürümü ilk kez çalıştığını
bilirsiniz.
Uygulamanız verileri yerel olarak (örneğin, uygulama depo dizinine) kaydediyorsa, ilk çalıştırmadan sonra önceden
kaydedilmiş veri (önceki sürümlerden) olup olmadığını kontrol etmek isteyebilirsiniz.
294
Bölüm 33: AIR uygulamalarını
yerelleştirme
Adobe® AIR™ 1.1 birden çok dil desteği içerir.
Yerelleştirmeye giriş
Yerelleştirme, birden çok yerel ayarı desteklemek için varlıkları ekleme işlemidir. Yerel ayar, dil ve ülke kodunun
kombinasyonudur. Örneğin en_US Birleşik Devletler'de konuşulan İngilizceyi, fr_FR Fransa'da konuşulan Fransızcayı
belirtir. Bu yerel ayarlar için bir uygulamayı yerelleştirmek üzere iki varlık kümesi sağlarsınız: biri en_US yerel ayarı,
diğeri fr_FR yerel ayarı için.
Yerel ayarlar dilleri paylaşabilir. Örneğin en_US ve en_GB (İngiltere) farklı yerel ayarlardır. Bu durumda her iki yerel
ayar da İngilizce dilini kullanır, ancak ülke kodu onların farklı yerel ayarlar olduğunu ve bu nedenle farklı varlıklar
kullanabileceklerini gösterir. Örneğin en_US yerel ayarındaki bir uygulama "color" kelimesini yazabilir, ancak aynı
kelime en_GB yerel ayarında "colour" şeklindedir. Ayrıca para birimleri yerel ayara bağlı olarak dolar veya pound
biçimindedir ve tarih ve saat formatı da farklı olabilir.
Ayrıca ülke kodunu belirtmeden de bir dil için bir varlık kümesi sağlayabilirsiniz. Örneğin, İngilizce dili için en
varlıkları ve en_US yerel ayarı için de ABD İngilizcesi'ne özgü ek varlıklar sağlayabilirsiniz.
AIR SDK bir HTML Yerelleştirme Çerçevesi (AIRLocalizer.js dosyasında bulunan) sağlar. Bu çerçeve birden çok yerel
ayarla çalışmaya yardımcı olan API'ler içerir. Ayrıntılar için bkz. “HTML içeriğini yerelleştirme” sayfa 295.
Yerelleştirme, uygulamanızda kullanılan dizeleri çevirmenin ötesinde bir işlemdir. Ses dosyaları, görüntüler ve
videolar gibi her tür varlığı içerebilir.
Uygulama yükleyicisindeki uygulama adını ve
açıklamasını yerelleştirme
Uygulama tanımlayıcı dosyasındaki name ve description öğeleri için birden çok dil belirtebilirsiniz. Örneğin
aşağıdaki örnek, uygulama adını üç dilde belirtir (İngilizce, Fransızca ve Almanca):
<name>
<text xml:lang="en">Sample 1.0</text>
<text xml:lang="fr">Échantillon 1.0</text>
<text xml:lang="de">Stichprobe 1.0</text>
</name>
kodu belirtir.
Ad öğesi, AIR uygulama yükleyicisinin görüntülediği uygulama adını tanımlar. AIR uygulama yükleyicisi, işletim
sistemi ayarları tarafından belirtilen kullanıcı arabirimi dilleriyle en iyi eşleşen yerelleştirilmiş değeri kullanır.
Benzer şekilde uygulama tanımlayıcı dosyasındaki description öğesinin de çok dilli sürümlerini belirtebilirsiniz. Bu
öğe, AIR uygulama yükleyicisinin görüntülediği açıklama metnini tanımlar.
AIR uygulamalarını yerelleştirme
Bu ayarlar yalnızca AIR uygulama yükleyicisinde kullanılabilir olan diller için geçerlidir. Çalışan, yüklü uygulama için
kullanılabilir olan yerel ayarları belirtmez. AIR uygulamaları, AIR uygulama yükleyicisinde kullanılabilir olanlar da
dahil olmak üzere ve bunlara ek olarak birden çok dili destekleyen kullanıcı arabirimleri sağlayabilir.
Daha fazla bilgi için bkz. “Uygulama tanımlayıcı dosyasında özellikleri tanımlama” sayfa 42.
Bir yerel ayar seçme
Uygulamanızın hangi yerel ayarı kullandığını belirlemek için, aşağıdaki yöntemlerden birini kullanabilirsiniz:
• Kullanıcı istemi — Uygulamayı varsayılan bir yerel ayarda başlatıp, ardından kullanıcıdan tercih ettiği yerel ayarı
seçmesini isteyebilirsiniz.
•
Capabilities.languages — Capabilities.languages özelliği, işletim sistemi üzerinden ayarlandığı şekilde
kullanıcının tercih edilen dillerinde bulunan dillerin bir dizisini listeler. Dizeler RFC4646
(http://www.ietf.org/rfc/rfc4646.txt) tarafından tanımlanan dil etiketleri içerir (varsa komut ve bölge bilgileri).
Dizeler sınırlayıcı olarak tire kullanır (örneğin "en-US" veya "ja-JP"). Döndürülen dizideki ilk giriş, language
özelliğiyle aynı birincil dil kimliğine sahipti. Örneğin languages[0]"en-US" olarak ayarlıysa, language özelliği
"en" olarak ayarlıdır. Ancak language özelliği "xu" (bilinmeyen bir dili belirtir) olarak ayarlıysa, languages
dizisindeki ilk öğe farklı olur.
•
Capabilities.language — Capabilities.language özelliği, işletim sisteminin kullanıcı arabirimi dil kodunu
sağlar. Ancak bu özellik 20 bilinen dille sınırlıdır. İngilizce sistemlerde bu özellik yalnızca dil kodunu döndürür,
ülke kodunu döndürmez. Bu nedenlerden ötürü, Capabilities.languages dizisindeki ilk öğeyi kullanmak daha
yararlıdır.
Flaş içeriğini yerelleştirme
Flash CS3 ve CS4, ActionScript 3.0 bileşenlerinde bir Locale sınıfı içerir. Locale sınıfı sayesinde, bir SWF dosyasının
çok dilli bir metni nasıl görüntülediğini kontrol edebilirsiniz. Flash Dizeler paneli sayesinde, dinamik metin
alanlarında dize sabit değerleri yerine dize kimliklerini kullanabilirsiniz. Bu sayede, dile özgü bir XML dosyasından
yüklenen metni görüntüleyen bir SWF dosyası oluşturabilirsiniz. Locale sınıfını kullanma hakkında bilgi için, bkz.
Flash ActionScript 3.0 Language and Components Reference (ActionScript 3.0 Dil ve Bileşenler Başvurusu).
HTML içeriğini yerelleştirme
AIR 1.1 SDK, bir HTML yerelleştirme çerçevesi içerir. AIRLocalizer.js JavaScript dosyası çerçeveyi tanımlar. AIR
SDK'nin çerçeveler dizini, AIRLocalizer.js dosyasını içerir. Bu dosya, birden çok yerelleştirilmiş sürümü destekleyen
uygulamalar oluşturma konusuna yardımcı olmak için işlevler sağlayan air.Localizer sınıfını içerir.
AIR HTML yerelleştirme çerçevesi kodunu yükleme
Yerelleştirme çerçevesini kullanmak için, AIRLocalizer.js dosyasını projenize kopyalayın. Ardından bu dosyayı bir
komut dosyası etiketi kullanarak uygulamanın ana HTML dosyasına ekleyin:
<script src="AIRLocalizer.js" type="text/javascript" charset="utf-8"></script>
Sonraki JavaScript air.Localizer.localizer nesnesini çağırabilir:
<script>
var localizer = air.Localizer.localizer;
</script>
air.Localizer.localizer nesnesi, yerelleştirilmiş kaynakları kullanma ve yönetme için yöntemler ve özellikler
tanımlayan tek nesnedir. Localizer sınıfı aşağıdaki yöntemleri içerir:
Yöntem
Açıklama
getFile()
Belirli bir yerel ayar için belirtilen kaynak paketinin metnini alır. Bkz. “Belirli yerel ayarlar için kaynak alma”
sayfa 301.
getLocaleChain()
Dilleri yerel ayar zincirinde döndürür. Bkz. “Yerel ayar zincirini tanımlama” sayfa 300.
getString()
Bir kaynak için tanımlı olan dizeyi alır. Bkz. “Belirli yerel ayarlar için kaynak alma” sayfa 301.
setBundlesDirectory(
)
Paket dizini konumunu ayarlar. Bkz. “AIR HTML Localizer ayarlarını özelleştirme” sayfa 299.
setLocalAttributePre
fix()
HTML DOM öğelerinde kullanılan yerelleştirici nitelikleri tarafından kullanılan öneki ayarlar. Bkz. “AIR HTML
Localizer ayarlarını özelleştirme” sayfa 299
setLocaleChain()
Yerel ayar zincirinde dillerin sırasını ayarlar. Bkz. “Yerel ayar zincirini tanımlama” sayfa 300.
sortLanguagesByPrefe
rence()
Yerel ayar zincirindeki yerel ayarları, işletim sistemi ayarlarındaki yerel ayar sırasına bağlı olarak sıralar. Bkz.
“Yerel ayar zincirini tanımlama” sayfa 300.
update()
HTML DOM'yi (veya bir DOM öğesini) geçerli yerel ayar zincirindeki yerelleştirilmiş dizelerle günceller. Yerel
ayar zinciriyle ilgili bilgi için, bkz. “Yerel ayar zincirlerini yönetme” sayfa 297. update() yöntemi hakkında
daha fazla bilgi için, bkz. “DOM öğelerini geçerli yerel ayarı kullanmak üzere güncelleme” sayfa 298.
Localizer sınıfı aşağıdaki statik özellikleri içerir:
Özellik
Açıklama
localizer
Uygulama için tek Localizer nesnesine bir başvuru döndürür.
ultimateFallbackLocale
Uygulama hiçbir kullanıcı tercihini desteklemediğinde kullanılan yerel ayar. Bkz.
“Yerel ayar zincirini tanımlama” sayfa 300.
Kaynak paketlerini tanımlama
HTML yerelleştirme çerçevesi yerelleştirme dosyalarından dizelerin yerelleştirilmiş sürümlerini okur. Yerelleştirme
dosyası, bir metin dosyasında serileştirilmiş anahtar tabanlı değerlerin bir koleksiyonudur. Yerelleştirme dosyasına
bazen paket de denir.
Uygulama projesi dizininizin locale (yerel ayar) adlı bir alt dizinini oluşturun. (Farklı bir ad da kullanabilirsiniz, bkz.
“AIR HTML Localizer ayarlarını özelleştirme” sayfa 299.) Bu dizin yerelleştirme dosyalarını içerir. Bu dizin paketler
dizini olarak bilinir.
Uygulamanızın desteklediği her yerel ayar için, paketler dizininin bir alt dizinini oluşturun. Her alt dizini yerel ayar
koduyla eşleşecek şekilde adlandırın. Örneğin French (Fransız) alt dizinini “fr” ve English (İngiliz) alt dizinini “en”
olarak adlandırın. Dil ve ülke kodu olan bir yerel ayarı tanımlamak için alt çizgi (_) karakterini kullanabilirsiniz.
Örneğin U.S. English (Amerikan İngilizcesi) dizinini “en_us” olarak adlandırın. (Alternatif olarak alt çizgi yerine, “enus” örneğinde olduğu gibi tire de kullanabilirsiniz. HTML yerelleştirme çerçevesi her ikisini de destekler.)
Bir yerel ayar alt dizinine istediğiniz sayıda kaynak dosya ekleyebilirsiniz. Genellikle her dil için bir yerelleştirme
dosyası oluşturursunuz (ve dosyayı ilgili dilin dizinine yerleştirirsiniz). HTML yerelleştirme çerçevesi, bir dosyanın
içeriğini okumanızı sağlayan bir getFile() yöntemi içerir (bkz. “Belirli yerel ayarlar için kaynak alma” sayfa 301.
.properties dosya uzantısına sahip dosyalar, yerelleştirme özellik dosyaları olarak bilinir. Bir yerel ayar için anahtar
değer çiftleri tanımlamak üzere onları kullanabilirsiniz. Özellikler dosyası, her satırda bir dize değeri tanımlar.
Örneğin aşağıdaki örnekte dize değeri "Hello in English."greeting adlı anahtar için tanımlanır:
greeting=Hello in English.
Aşağıdaki metni içeren bir özellikler dosyası, altı anahtar değer çifti tanımlar:
title=Sample Application
greeting=Hello in English.
exitMessage=Thank you for using the application.
color1=Red
color2=Green
color3=Blue
Bu örnek özellikler dosyasının, en dizininde saklanacak olan İngilizce sürümünü gösterir.
Bu Özellikler dosyasının Fransızca sürümü fr dizinine konur.
title=Programme d'échantillon
greeting=Bonjour en français.
exitMessage=Merci pour l'usage du programme.
color1=Rouge
color2=Vert
color3=Bleu
Farklı bilgi türleri için birden fazla kaynak dosya tanımlayabilirsiniz. Örneğin bir legal.properties dosyası yasal ortak
metin içerebilir (telif hakkı bilgileri gibi). Bu kaynağı birden fazla uygulamada tekrar kullanmak isteyebilirsiniz. Benzer
şekilde, kullanıcı arabiriminin farklı kısımları için yerelleştirilmiş içerik tanımlayan ayrı dosyalar tanımlayabilirsiniz.
Bu dosyalarda, birden fazla dili desteklemek için UTF-8 kodlaması kullanın.
Yerel ayar zincirlerini yönetme
Uygulamanız AIRLocalizer.js dosyasını yüklediğinde, uygulamanızda tanımlı olan yerel ayarları inceler. Bu yerel
ayarlar, paketler dizininin alt dizinlerine karşılık gelir (bkz. “Kaynak paketlerini tanımlama” sayfa 296). Kullanılabilir
yerel ayarların listesi yerel ayar zinciri olarak bilinir. AIRLocalizer.js dosyası yerel ayar zincirini, işletim sistemi ayarları
tarafından tanımlanmış tercih edilen sırayı temel alarak sıralar. (Capabilities.languages özelliği, işletim sistemi
kullanıcı arabirimi dillerini tercih edilen sırada listeler.)
Dolayısıyla bir uygulama "en", "en_US" ve "en_UK" yerel ayarları için kaynak tanımlarsa, AIR HTML Localizer
çerçevesi yerel ayar zincirini uygun şekilde sıralar. Bir uygulama "en" öğesini birincil yerel ayar olarak bildiren bir
sistemde başladığında, yerel ayar zinciri ["en", "en_US", "en_UK"] şeklinde sıralanır. Bu durumda uygulama
kaynakları önce "en" paketinde, sonra "en_US" paketinde arar.
Ancak sistem "en-US" öğesini birincil yerel ayar olarak bildirirse, sıralama ["en_US", "en", en_UK"] şeklindedir.
Bu durumda uygulama kaynakları önce "en_US" paketinde, sonra "en" paketinde arar.
Varsayılan olarak uygulama yerel ayar zincirindeki ilk yerel ayarı, kullanılacak varsayılan yerel ayar olarak tanımlar.
Uygulamayı ilk kez çalıştırdıktan sonra kullanıcıdan bir yerel ayar seçmesini isteyebilirsiniz. Ardından seçimi bir
tercihler dosyasında saklamayı ve uygulamanın bir sonraki başlatılışında bu yerel ayarı kullanmayı seçebilirsiniz.
Uygulamanız kaynak dizeleri yerel ayar zincirindeki herhangi bir yerel ayarda kullanabilir. Belirli bir yerel ayar bir
kaynak dize tanımlamazsa, uygulama, yerel ayar zincirinde tanımlı olan diğer yerel ayarlar için bir sonraki eşleşen
kaynak dizeyi kullanır.
Localizer nesnesinin setLocaleChain() yöntemini çağırarak yerel ayar zincirini özelleştirebilirsiniz. Bkz. “Yerel ayar
zincirini tanımlama” sayfa 300.
DOM öğelerini yerelleştirilmiş içerikle güncelleme
Uygulamadaki bir öğe, yerelleştirme özellikleri dosyasındaki bir anahtar değere başvurabilir. Örneğin aşağıdaki
örnekte bulunan title öğesi, bir local_innerHTML niteliğini belirtir. Yerelleştirme çerçevesi, yerelleştirilen bir
değeri aramak için bu niteliği kullanır. Çerçeve varsayılan olarak "local_" ile başlayan nitelik adları arar. Çerçeve,
"local_" ifadesinin arkasından gelen metinle eşleşen adlara sahip nitelikleri günceller. Bu durumda çerçeve, title
öğesinin innerHTML niteliğini ayarlar. innerHTML niteliği, varsayılan özellikler dosyasındaki (default.properties)
mainWindowTitle anahtarı için tanımlı olan değeri kullanır:
<title local_innerHTML="default.mainWindowTitle"/>
Geçerli yerel ayar eşleşen bir değer tanımlamazsa, yerelleştirici çerçevesi yerel ayar zincirinin kalanını arar. Yerel ayar
zincirinde bir değerin tanımlı olduğu bir sonraki yerel ayarı kullanır.
Aşağıdaki örnekte p öğesinin metni (innerHTML niteliği), varsayılan özellikler dosyasında tanımlanan greeting
anahtarının değerini kullanır:
<p local_innerHTML="default.greeting" />
Aşağıdaki örnekte, input öğesinin değer niteliği (ve görüntülenen metin), varsayılan özellikler dosyasında tanımlanan
btnBlue anahtarının değerini kullanır:
<input type="button" local_value="default.btnBlue" />
HTML DOM'yi geçerli yerel ayar zincirinde tanımlı olan dizeleri kullanmak üzere güncellemek için, Localizer
nesnesinin update() yöntemini çağırın. update() yöntemini çağırmak Localizer nesnesinin DOM'yi ayrıştırmasına
ve yerelleştirme ("local_...") niteliklerini bulduğu konumda işlemeleri uygulamasına neden olur:
air.Localizer.localizer.update();
Hem bir nitelik ("innerHTML" gibi) hem de karşılık gelen yerelleştirme niteliği için ("local_innerHTML" gibi) değer
tanımlayabilirsiniz. Bu durumda yerelleştirme çerçevesi, yerelleştirme zincirinde karşılık gelen bir değer bulursa,
yalnızca nitelik değerinin üzerine yazar. Örneğin aşağıdaki öğe hem value hem de local_value niteliklerini
tanımlar:
<input type="text" value="Blue" local_value="default.btnBlue"/>
Yalnızca belirli bir DOM öğesini de güncelleyebilirsiniz. Bir sonraki bölüm olan “DOM öğelerini geçerli yerel ayarı
kullanmak üzere güncelleme” sayfa 298 bölümüne bakın.
AIR HTML Localizer "local_" ifadesini varsayılan olarak bir öğenin yerelleştirme ayarlarını tanımlayan nitelikler
için önek olarak kullanır. Örneğin local_innerHTML niteliği varsayılan olarak bir öğenin innerHTML değeri için
kullanılan paket ve kaynak adını tanımlar. Ayrıca local_value niteliği varsayılan olarak bir öğenin value niteliği için
kullanılan paket ve kaynak adını da tanımlar. Localizer öğesini "local_" dışında bir nitelik öneki kullanmak üzere
yapılandırabilirsiniz. Bkz. “AIR HTML Localizer ayarlarını özelleştirme” sayfa 299.
DOM öğelerini geçerli yerel ayarı kullanmak üzere güncelleme
Localizer nesnesi HTML DOM'yi güncellediğinde, işaretli öğelerin, geçerli yerel ayar zincirinde tanımlı dizelere dayalı
olan nitelik değerlerini kullanmasına neden olur. HTML yerelleştiricisinin HTML DOM'yi güncellemesi için,
Localizer nesnesinin update() yöntemini çağırın:
Yalnızca belirtilen bir DOM öğesini güncellemek için, update() yöntemine bir parametre olarak iletin. update()
yöntemi yalnızca parentNode adlı, isteğe bağlı bir parametreye sahiptir. parentNode parametresi belirtildiğinde,
yerelleştirilecek DOM öğesini tanımlar. update() yöntemini çağırmak ve bir parentNode parametresi belirtmek,
yerelleştirme niteliklerini belirten tüm alt öğeler için yerelleştirilen değerleri ayarlar.
Örneğin aşağıdaki div öğesine bakın:
<div id="colorsDiv">
<h1 local_innerHTML="default.lblColors" ></h1>
<p><input type="button" local_value="default.btnBlue" /></p>
<p><input type="button" local_value="default.btnRed" /></p>
<p><input type="button" local_value="default.btnGreen" /></p>
</div>
Bu öğeyi geçerli yerel ayar zincirinde tanımlı yerelleştirilmiş dizeleri kullanmak üzere güncellemek için, aşağıdaki
JavaScript kodunu kullanın:
var divElement = window.document.getElementById("colorsDiv");
air.Localizer.localizer.update(divElement);
Yerel ayar zincirinde bir anahtar değer bulunmazsa, yerelleştirme çerçevesi nitelik değerini "local_" niteliğinin
değerine ayarlar. Örneğin bir önceki örnekte, yerelleştirme çerçevesinin lblColors anahtarı için bir değer
bulamadığını varsayın (yerel ayar zincirindeki hiçbir default.properties dosyasında). Bu durumda innerHTML değeri
olarak "default.lblColors" öğesini kullanır. Bu değeri kullanmak eksik kaynaklar olduğunu (geliştiriciye) belirtir.
update() yöntemi, yerel ayar zincirinde kaynak bulamadığında bir resourceNotFound olayı gönderir.
air.Localizer.RESOURCE_NOT_FOUND sabiti, "resourceNotFound" dizesini tanımlar. Olayın üç özelliği vardır:
bundleName, resourceName ve locale. bundleName özelliği, kaynak bulunamayan paketin adıdır. resourceName
özelliği, kaynak bulunamayan paketin adıdır. locale özelliği, kaynak bulunamayan yerel ayarın adıdır.
update() yöntemi, belirtilen paketi bulamadığında bir bundleNotFound olayı gönderir.
air.Localizer.BUNDLE_NOT_FOUND sabiti, "bundleNotFound" dizesini tanımlar. Olayın iki özelliği vardır:
bundleName ve locale. bundleName özelliği, kaynak bulunamayan paketin adıdır. locale özelliği, kaynak
bulunamayan yerel ayarın adıdır.
update() yöntemi senkronize olmayan bir şekilde çalışır (ve resourceNotFound ve bundleNotFound olaylarını
senkronize olmayan bir şekilde gönderir). Aşağıdaki kod resourceNotFound ve bundleNotFound olayları için olay
dinleyicilerini ayarlar:
air.Localizer.localizer.addEventListener(air.Localizer.RESOURCE_NOT_FOUND, rnfHandler);
air.Localizer.localizer.addEventListener(air.Localizer.BUNDLE_NOT_FOUND, rnfHandler);
function rnfHandler(event)
{
alert(event.bundleName + ": " + event.resourceName + ":." + event.locale);
}
function bnfHandler(event)
{
alert(event.bundleName + ":." + event.locale);
}
AIR HTML Localizer ayarlarını özelleştirme
Localizer nesnesinin setBundlesDirectory() yöntemi sayesinde paketlerin dizin yolunu özelleştirebilirsiniz.
Localizer nesnesinin setLocalAttributePrefix() yöntemi sayesinde paketlerin dizin yolunu ve Localizer
tarafından kullanılan nitelik değerini özelleştirebilirsiniz.
Varsayılan paketler dizini, uygulama dizininin yerel ayar alt dizini olarak tanımlanır. Localizer nesnesinin
setBundlesDirectory() yöntemini çağırarak başka bir dizin de belirtebilirsiniz. Bu yöntem için path adlı bir
parametre gereklidir, bu parametre, bir dize olarak istenilen paketler dizinine giden yoldur. path parametresinin
değeri şunlardan biri olabilir:
•
"locales" gibi, uygulama dizinine göreceli bir yol tanımlayan bir Dize
•
"app://languages" gibi, app, app-storage veya file URL şemalarını kullanan geçerli bir URL tanımlayan bir
Dize (http URL şemasını kullanmayın)
• Bir File nesnesi
URL'ler ve dizin yolları hakkında bilgi için, bkz. “File nesnelerinin Yolları” sayfa 98.
Örneğin aşağıdaki kod paketler dizinini, uygulama depolama dizininin (uygulama dizininin değil) diller alt dizinine
ayarlar:
air.Localizer.localizer.setBundlesDirectory("languages");
path parametresi olarak geçerli bir yol iletin. Aksi takdirde yöntem bir BundlePathNotFoundError istisnası atar.
Hatanın name özelliği "BundlePathNotFoundError" öğesidir ve message özelliği geçersiz yolu belirtir.
AIR HTML Localizer "local_" ifadesini varsayılan olarak bir öğenin yerelleştirme ayarlarını tanımlayan nitelikler
için önek olarak kullanır. Örneğin local_innerHTML niteliği, aşağıdaki input öğesinin innerHTML değeri için
kullanılan paket ve kaynak adını tanımlar:
<p local_innerHTML="default.greeting" />
Localizer nesnesinin setLocalAttributePrefix() yöntemi sayesinde, "local_" dışında bir nitelik öneki
kullanabilirsiniz. Bu statik yöntem için, nitelik öneki olarak kullanmak istediğiniz dize olan bir parametre gereklidir.
Örneğin aşağıdaki kod, yerelleştirme çerçevesini, "loc_" ifadesini nitelik öneki olarak kullanmak üzere ayarlar:
air.Localizer.localizer.setLocalAttributePrefix("loc_");
Yerelleştirme çerçevesinin kullandığı nitelik önekini özelleştirebilirsiniz. Varsayılan değer ("local_"), kodunuzun
kullandığı başka bir nitelikle çakışıyorsa, öneki özelleştirmek isteyebilirsiniz. Bu yöntemi çağırırken, HTML nitelikleri
için geçerli karakterler kullandığınızdan emin olun. (Örneğin değer boşluk karakteri içermemelidir.)
Yerelleştirme niteliklerini HTML öğelerinde kullanma hakkında bilgi için, bkz. “DOM öğelerini yerelleştirilmiş
içerikle güncelleme” sayfa 298.
Paketler dizini ve nitelik öneki ayarları, farklı uygulama oturumları arasında kalıcı değildir. Özel paketler dizini veya
nitelik öneki ayarı kullanıyorsanız, uygulama her başladığında ayarı yeniden yaptığınızdan emin olun.
Yerel ayar zincirini tanımlama
AIRLocalizer.js kodunu yüklediğinizde, varsayılan olarak varsayılan yerel ayar zincirini ayarlar. Paketler dizininde ve
işletim sistemi dil ayarlarında bulunan yerel ayarlar, bu yerel ayar zincirini tanımlar. (Ayrıntılar için bkz. “Yerel ayar
zincirlerini yönetme” sayfa 297.)
Localizer nesnesinin statik setLocaleChain() yöntemini çağırarak, yerel ayar zincirini değiştirebilirsiniz. Örneğin,
kullanıcı belirli bir dil için bir tercih belirtirse, bu yöntemi çağırmak isteyebilirsiniz. setLocaleChain() yöntemi için
chain adlı bir parametre gereklidir, bu parametre ["fr_FR","fr","fr_CA"] gibi bir yerel ayarlar dizisidir. Yerel
ayarların dizideki sırası, çerçevenin kaynak arama sırasını belirler (sonraki işlemlerde). Zincirdeki ilk yerel ayar için
kaynak bulunmazsa, diğer yerel ayarların kaynaklarına bakmaya devam eder. chain argümanı eksikse, bir dizi değilse
veya boş bir diziyse, işlev başarısız olur ve bir IllegalArgumentsError istisnası atar.
Localizer nesnesinin statik getLocaleChain() yöntemi, geçerli yerel ayar zincirindeki yerel ayarları listeleyen bir Dizi
döndürür.
Aşağıdaki kod geçerli yerel ayar zincirini okur ve zincirin başına iki Fransız yerel ayar ekler:
var currentChain = air.Localizer.localizer.getLocaleChain();
newLocales = ["fr_FR", "fr"];
air.Localizer.localizer.setLocaleChain(newLocales.concat(currentChain));
setLocaleChain() yöntemi yerel ayar zincirini güncellediğinde bir "change" olayı gönderir.
air.Localizer.LOCALE_CHANGE sabiti, "change" dizesini tanımlar. Olayın localeChain adlı bir özelliği vardır, bu,
yeni yerel ayar zincirindeki yerel ayar kodlarının bir dizisidir. Aşağıdaki kod bu olay için bir olay dinleyicisi ayarlar:
var currentChain = air.Localizer.localizer.getLocaleChain();
newLocales = ["fr_FR", "fr"];
localizer.addEventListener(air.Localizer.LOCALE_CHANGE, changeHandler);
air.Localizer.localizer.setLocaleChain(newLocales.concat(currentChain));
function changeHandler(event)
{
alert(event.localeChain);
}
Statik air.Localizer.ultimateFallbackLocale özelliği, uygulama hiçbir kullanıcı tercihini desteklemediğinde
kullanılan yerel ayarı temsil eder. Varsayılan olarak "en" değerindedir. Aşağıdaki kodda gösterildiği gibi, başka bir
yerel ayara ayarlayabilirsiniz:
air.Localizer.ultimateFallbackLocale = "fr";
Belirli yerel ayarlar için kaynak alma
Localizer nesnesinin getString() yöntemi, belirli bir yerel ayardaki kaynak için tanımlı olan dizeyi döndürür.
Yöntemi çağırırken bir locale değeri belirtmeniz gerekmez. Bu durumda yöntem yerel ayar zincirinin tamamına
bakar ve belirli kaynak adını sağlayan ilk yerel ayardaki dizeyi döndürür. Bu yöntem aşağıdaki parametrelere sahiptir:
Parametre
Açıklama
bundleName
Kaynağı içeren paket. Bu, .properties uzantısı olmadan özellikler dosyasının dosya
adıdır. (Örneğin bu parametre "alerts" olarak ayarlanırsa, Localizer kodu
alerts.properties adlı yerelleştirme dosyalarına bakar.
resourceName
Kaynak adı.
templateArgs
İsteğe bağlı. Değiştirme dizesindeki numaralı etiketleri değiştirmek için dize dizisi
Örneğin templateArgs parametresinin ["Raúl", "4"] ve eşleşen kaynak
dizenin "Hello, {0}. You have {1} new messages.". olduğu bir işleve
yapılacak çağrıyı düşünün. Bu durumda işlev şunu döndürür: "Hello, Raúl.
You have 4 new messages.". Bu ayarı yoksaymak için, bir null değeri iletin.
locale
İsteğe bağlı. Kullanılacak yerel ayar kodu ("en", "en_us" veya "fr" gibi). Bir
yerel ayar sağlanmışsa ve eşleşen değer bulunmazsa, yöntem değerleri yerel ayar
zincirindeki diğer yerel ayarlarda aramaya devam etmez. Yerel kod
belirtilmemişse işlev, belirli kaynak adı için bir değer sağlayan yerel ayar
zincirindeki ilk yerel ayardaki dizeyi döndürür.
Yerelleştirme çerçevesi işaretli HTML DOM niteliklerini güncelleyebilir. Ancak yerelleştirilmiş dizeleri başka
şekillerde kullanabilirsiniz. Örneğin bir dizeyi dinamik olarak oluşturulmuş bir HTML'de veya bir işlev çağrısında
parametre değeri olarak kullanabilirsiniz. Örneğin aşağıdaki kod alert() işlevini, fr_FR yerel ayarının varsayılan
özellikler dosyasındaki error114 kaynağında tanımlı olan dizeyle çağırır.
alert(air.Localizer.localizer.getString("default", "error114", null, "fr_FR"));
getString() yöntemi, kaynağı belirtilen pakette bulamadığında bir resourceNotFound olayı gönderir.
air.Localizer.RESOURCE_NOT_FOUND sabiti, "resourceNotFound" dizesini tanımlar. Olayın üç özelliği vardır:
bundleName, resourceName ve locale. bundleName özelliği, kaynak bulunamayan paketin adıdır. resourceName
özelliği, kaynak bulunamayan paketin adıdır. locale özelliği, kaynak bulunamayan yerel ayarın adıdır.
getString() yöntemi, belirtilen paketi bulamadığında bir bundleNotFound olayı gönderir.
air.Localizer.BUNDLE_NOT_FOUND sabiti, "bundleNotFound" dizesini tanımlar. Olayın iki özelliği vardır:
bundleName ve locale. bundleName özelliği, kaynak bulunamayan paketin adıdır. locale özelliği, kaynak
bulunamayan yerel ayarın adıdır.
getString() yöntemi senkronize olmayan bir şekilde çalışır (ve resourceNotFound ve resourceNotFound
olaylarını senkronize olmayan bir şekilde gönderir). Aşağıdaki kod resourceNotFound ve bundleNotFound olayları
için olay dinleyicilerini ayarlar:
air.Localizerlocalizer.addEventListener(air.Localizer.RESOURCE_NOT_FOUND, rnfHandler);
air.Localizerlocalizer.addEventListener(air.Localizer.BUNDLE_NOT_FOUND, bnfHandler);
var str = air.Localizer.localizer.getString("default", "error114", null, "fr_FR");
function rnfHandler(event)
{
alert(event.bundleName + ": " + event.resourceName + ":." + event.locale);
}
function bnfHandler(event)
{
alert(event.bundleName + ":." + event.locale);
}
Localizer nesnesinin getFile() yöntemi, belirli bir yerel ayar için bir paketin içeriğini dize olarak döndürür. Paket
dosyası UTF-8 dosyası olarak okunur. Bu yöntem aşağıdaki parametreleri içerir:
Parametre
Açıklama
resourceFileName
Kaynak dosyanın dosya adı ("about.html" gibi).
templateArgs
İsteğe bağlı. Değiştirme dizesindeki numaralı etiketleri değiştirmek için dize dizisi
Örneğin templateArgs parametresinin ["Raúl", "4"] olduğu ve eşleşen
kaynak dizenin iki satır içerdiği bir işleve yapılacak çağrıyı düşünün:
<html>
<body>Hello, {0}. You have {1} new messages.</body>
</html>
Bu durumda işlev iki satırlı bir dize döndürür:
<html>
<body>Hello, Raúl. You have 4 new messages. </body>
</html>
locale
Kullanılacak yerel ayar, örneğin "en_GB" gibi. Bir yerel ayar sağlanmışsa ve
eşleşen dosya bulunmazsa, yöntem yerel ayar zincirindeki diğer yerel ayarlarda
aramaya devam etmez. Hiçbir yerel kod belirtilmemişse işlev,
resourceFileName öğesiyle eşleşen bir dosyaya sahip olan yerel ayar
zincirindeki ilk yerel ayardaki metni döndürür.
Örneğin aşağıdaki kod, fr yerel ayarının about.html dosyasının içeriğini kullanarak document.write() yöntemini
çağırır:
var aboutWin = window.open();
var aboutHtml = localizer.getFile("about.html", null, "fr");
aboutWin.document.close();
aboutWin.document.write(aboutHtml);
getFile() yöntemi, yerel ayar zincirinde kaynak bulamadığında bir fileNotFound olayı gönderir.
air.Localizer.FILE_NOT_FOUND sabiti, "resourceNotFound" dizesini tanımlar. getFile() yöntemi senkronize
olmayan bir şekilde çalışır (ve fileNotFound olayını senkronize olmayan bir şekilde gönderir). Olayın iki özelliği
vardır: fileName ve locale. fileName özelliği, bulunamayan dosyanın adıdır. locale özelliği, kaynak bulunamayan
yerel ayarın adıdır. Aşağıdaki kod bu olay için bir olay dinleyicisi ayarlar:
air.Localizer.localizer.addEventListener(air.Localizer.FILE_NOT_FOUND, fnfHandler);
air.Localizer.localizer.getFile("missing.html", null, "fr");
function fnfHandler(event)
{
alert(event.fileName + ": " + event.locale);
}
Tarihleri, saatleri ve para birimlerini yerelleştirme
Uygulamaların tarihi, saati ve para birimini sunma şekli her yerel ayar için birbirinden oldukça farklıdır. Örneğin
tarihler için ABD standardı ay/gün/yıl, Avrupa için tarihleri sunma şekliyse gün/ay/yıl şeklindedir.
Tarihleri, saatleri ve para birimlerini formatlamak için kod yazabilirsiniz. Örneğin aşağıdaki kod bir Date nesnesini
ay/gün/yıl veya gün/ay/yıl formatına dönüştürür. locale değişkeni (yerel ayarı temsil eden) "en_US" olarak ayarlıysa,
işlev ay/gün/yıl formatını döndürür. Örnek bir Date nesnesini tüm diğer yerel ayarlar için gün/ay/yıl formatına
dönüştürür:
function convertDate(date)
{
if (locale == "en_US")
{
return (date.getMonth() + 1) + "/" + date.getDate() + "/" + date.getFullYear();
}
else
{
return date.getDate() + "/" + (date.getMonth() + 1) + "/" + date.getFullYear();
}
}
304
Bölüm 34: Komut satırı araçlarını
kullanarak AIR uygulaması oluşturma
Adobe® AIR™ komut satırı araçları sayesinde Adobe AIR uygulamalarını test edebilir ve paketleyebilirsiniz. Bu araçları
ayrıca otomatikleştirilmiş oluşturma işlemlerinde de kullanabilirsiniz. AIR komut satırı araçları AIR SDK
(http://www.adobe.com/go/learn_air_download_AIRSDK_tr) adresinde bulunmaktadır.
AIR Hata Ayıklama Başlatıcısı'nı (ADL) Kullanma
AIR Hata Ayıklama Başlatıcısı'nı (ADL) geliştirme sırasında hem SWF tabanlı hem de HTML tabanlı uygulamaları
çalıştırmak için kullanın. ADL kullanarak bir uygulamayı paketlemeden ve yüklemeden çalıştırabilirsiniz. Varsayılan
olarak ADL, SDK'ye dahil olan bir çalışma zamanı kullanır, yani ADL'yi kullanmak için çalışma zamanını ayrı olarak
yüklemeniz gerekmez.
ADL, izleme ifadelerini ve çalışma zamanı hatalarını standart çıktıya yazdırır, ancak kesme noktalarını veya diğer hata
ayıklama özelliklerini desteklemez. SWF tabanlı bir uygulama geliştiriyorsanız, karmaşık hata ayıklama konularında
Flash Hata Ayıklayıcı (veya Flash CS3 ya da CS4) kullanın.
Bir uygulamayı ADL ile başlatma
Aşağıdaki sözdizimini kullanın:
adl [-runtime runtime-directory] [-pubid publisher-id] [-nodebug] application.xml [rootdirectory] [-- arguments]
-runtime runtime-directory Kullanılacak çalışma zamanını içeren dizini belirtir. Belirtilmemişse, ADL programıyla
aynı SDK'de bulunan çalışma zamanı dizini kullanılır. ADL'i SDK klasöründen taşırsanız, çalışma zamanı dizinini
belirtmeniz gerekir. Windows'ta, Adobe AIR dizinini içeren dizini belirtin. Mac OS X'te, Adobe AIR.framework
içeren dizini belirtin.
-pubid publisher-id Bu çalıştırma için AIR uygulamasının yayıncı kimliği olarak belirtilen değeri atar. Geçici bir
yayıncı belirlemek, yerel bağlantı üzerinden iletişim kurma gibi, bir uygulamanın benzersiz olarak tanımlanmasına
yardımcı olan yayıncı kimliğini kullanan AIR uygulaması özellliklerini test etmenizi sağlar. Son yayıncı kimliği, AIR
yükleme dosyasını imzalamak için kullanılan dijital sertifika tarafından belirlenir.
-nodebug Hata ayıklama desteğini kapatır. Kullanılırsa, uygulama işlemi Flash hata ayıklayıcıya bağlanamaz ve
işlenmeyen istisnaların iletişim kutuları bastırılır. İzleme ifadeleri konsol penceresine yazdırılmaya devam edilir. Hata
ayıklamayı kapatma uygulamanızın biraz daha hızlı çalışmasını sağlar ve ayrıca yüklenmiş bir uygulamanın çalışma
modunu daha dikkatle taklit eder.
application.xml Uygulama tanımlayıcı dosya. Bkz. “AIR uygulamasının özelliklerini ayarlama” sayfa 41.
root-directory Uygulamanın çalıştırılacak kök dizinini belirtir. Belirtilmemişse, uygulama tanımlayıcı dosyasını
içeren dizin kullanılır.
-- arguments "--" karakterlerinden sonra gelen tüm karakter dizeleri uygulamaya komut satırı argümanları olarak
iletilir.
Not: Zaten çalışmakta olan bir AIR uygulamasını başlattığınızda, bu uygulamanın yeni bir örneği başlatılmaz. Bunun
yerine çalışan örneğe bir invoke olayı gönderilir.
Komut satırı araçlarını kullanarak AIR uygulaması oluşturma
İzleme ifadelerini yazdırma
İzleme ifadelerini ADL'yi çalıştırmak için kullanılan konsola yazdırmak için, izleme ifadelerini trace() işleviyle
kodunuza ekleyin:
trace("debug message");
air.trace("debug message");
ADL Örnekleri
Geçerli dizinde bir uygulama çalıştırın:
adl myApp-app.xml
Geçerli dizinin alt dizininde bir uygulama çalıştırın:
adl source/myApp-app.xml release
Bir uygulama çalıştırın ve "tick" ve "tock" olmak üzere iki komut satırını iletin:
adl myApp-app.xml -- tick tock
Belirli bir çalışma zamanını kullanarak bir uygulama çalıştırın:
adl -runtime /AIRSDK/runtime myApp-app.xml
Flash Hata Ayıklayıcı'ya (FDB) Bağlanma
SWF tabanlı bir AIR uygulamasının hatalarını Flash Hata Ayıklayıcı'yla ayıklamak için, bir FDB oturumu başlatın ve
daha sonra uygulamanızın hata ayıklama sürümünü başlatın. SWF dosyasının hata ayıklama sürümü otomatik olarak
dinleyen bir FDB oturumuna bağlanır.
1 FDB'yi başlatın. FDB programı, Flex SDK klasörünüzün bin dizininde bulunabilir.
Konsol, FDB istemini görüntüler: <fdb>
2 Çalıştır komutunu çalıştırın: <fdb>run [Enter]
3 Farklı bir komut veya kabuk konsolunda, uygulamanızın hata ayıklama sürümünü başlatın:
adl myApp-debug.xml
4 FDB komutlarını kullanarak kesme noktalarını istenilen şekilde oluşturun.
5 Yazın: continue [Enter]
ADL çıkış ve hata kodları
Aşağıdaki tablo, ADL tarafından yazdırılan çıkış kodlarını açıklamaktadır:
Çıkış kodu
Açıklama
0
Başarılı başlatma. ADL, AIR uygulaması çıktıktan sonra çıkar.
1
Zaten çalışmakta olan AIR uygulamasını başarılı bir şekilde başlatma. ADL hemen çıkar.
2
Kullanım hatası. ADL'ye verilen argümanlar yanlış.
3
Çalışma zamanı bulunamadı.
4
Çalışma zamanı başlatılamadı. Bunun nedeni genellikle uygulamada belirtilen sürümün veya yama
düzeyinin, çalışma zamanının sürümü veya yama düzeyiyle eşleşmemesidir.
Çıkış kodu
Açıklama
5
Bilinmeyen nedenlerden kaynaklanan bir hata oluştu.
6
Uygulama tanımlayıcı dosyası bulunamadı.
7
Uygulama tanımlayıcısının içeriği geçersiz. Bu hata genellikle XML'in doğru biçimlendirilmediğini belirtir.
8
Ana uygulama içerik dosyası (uygulama tanımlayıcı dosyasının <content> öğesinde belirtilen)
bulunamadı.
9
Ana uygulama içerik dosyası geçerli bir SWF veya HTML dosyası değil.
AIR yükleme dosyasını AIR Geliştirici Aracı (ADT)
kullanarak paketleme
AIR yükleme dosyasını hem SWF tabanlı hem de HTML tabanlı AIR uygulamalarınız için AIR Geliştirici Aracı'nı
(ADT) kullanarak oluşturursunuz. (Uygulamanızı oluşturmak için Adobe Flash CS3 kullanıyorsanız, AIR paketini
oluşturmak için Komutlar menüsündeki AIR Dosyası Oluştur komutunu da kullanabilirsiniz. Daha fazla bilgi için,
bkz. “Flash CS3 Professional için Adobe AIR Güncellemesi” sayfa 13. Flash CS4 kullanıyorsanız, Dosya > AIR
Ayarları'nı seçin. Daha fazla bilgi için, Flash Uygulamasını Kullanma bölümündeki Adobe AIR için Yayınlama
konusunu inceleyin.)
ADT, komut satırından veya Ant gibi bir oluşturma aracından çalıştırabileceğiniz bir Java programıdır. AIR ve Flex
SDK'ler, Java programını sizin için çalıştıran komut satırı dosyaları içerir.
AIR yükleme dosyasını paketleme
Her AIR uygulaması, en az bir uygulama tanımlayıcı dosyasına ve ana SWF veya HTML dosyasına sahip olmalıdır.
Diğer yüklenen uygulama varlıkları da AIR dosyasında paketlenmelidir.
Tüm AIR yükleyici dosyaları dijital sertifika kullanılarak imzalanmalıdır. AIR yükleyici, imzayı, uygulama dosyanızda
siz imzaladıktan sonra değişiklik yapılmadığını doğrulamak için kullanır. VeriSign veya Thawte gibi bir sertifika
yetkilisinden kod imzalayıcı sertifikası veya kendinden imzalı bir sertifika kullanabilirsiniz. Güvenilen bir sertifika
yetkilisi tarafından yayımlanan sertifika, uygulamanızın kullanıcılarına yayıncı olarak kimliğinize ilişkin bir güvence
sağlar. Kendinden imzalı bir sertifika, imzalayan olarak kimliğinizi doğrulamada kullanılamaz. Ayrıca bu olumsuzluk
paketin değiştirilmediği yönündeki güvenceyi de zayıflatır, çünkü meşru bir yükleme dosyası kullanıcıya ulaşmadan
önce sahtesiyle değiştirilmiş olabilir.
ADT -package komutunu kullanarak bir AIR dosyasını tek adımda paketleyebilir ve imzalayabilirsiniz. Ayrıca prepare komutuyla ara, imzalanmamış bir paket oluşturabilirsiniz ve ara paketi ayrı bir adımda -sign komutuyla
imzalayabilirsiniz.
Yükleme paketini imzalarken, ADT, zamanı doğrulamak için otomatik olarak bir zaman damgası yetkili sunucusuna
başvurur. Zaman damgası bilgileri AIR dosyasında bulunmaktadır. Doğrulanmış bir zaman damgası içeren AIR
dosyası, ileride herhangi bir zamanda yüklenebilir. ADT zaman damgası sunucusuna ulaşamazsa, paketleme iptal
edilir. Zaman damgalama seçeneğini geçersiz kılabilirsiniz, ancak zaman damgası olmadan, yükleme dosyasını
imzalamak için kullanılan sertifikanın süresi dolduktan sonra artık AIR uygulaması yüklenemez.
Varolan bir AIR uygulamasını güncellemek için bir paket oluşturuyorsanız, paket, orijinal uygulamayla aynı sertifika
veya aynı kimliğe sahip bir sertifika kullanılarak imzalanmalıdır. Aynı kimliğe sahip olmak için, iki sertifika aynı
belirgin ada (tüm bilgilendirici alanlar eşleşir) ve kök sertifikaya giden aynı sertifika zincirine sahip olmalıdır. Bu
nedenle, tanımlayıcı bilgilerin hiçbirini değiştirmediğiniz sürece, bir sertifika yetkilisinden alınan yenilenmiş
sertifikayı kullanabilirsiniz.
AIR 1.1 sürümünden itibaren, -migrate komutunu kullanarak bir uygulamayı yeni sertifika kullanmasını
sağlayabilirsiniz. Sertifikaya geçiş yapmak AIR dosyasının hem yeni hem de eski sertifikalarla imzalanmasını
gerektirir. Sertifika geçişi sayesinde kendinden imzalı bir sertifikadan ticari kod imzalayıcı sertifikasına veya
kendinden imzalı ya da ticari bir sertifikadan başka bir sertifikaya geçebilirsiniz. Bir sertifikaya geçiş yaptığınızda, var
olan kullanıcılarınızın, sizin yeni sürümünüzü yüklemeden önce var olan uygulamalarını kaldırmaları gerekmez.
Geçiş imzaları varsayılan olarak zaman damgalıdır.
Not: Uygulama tanımlayıcı dosyasındaki ayarlar, AIR uygulamasının kimliğini ve varsayılan yükleme yolunu belirler.
Bkz. “Uygulama tanımlayıcı dosyasının yapısı” sayfa 41.
AIR dosyasını tek adımda paketleme ve imzalama
❖ Aşağıdaki sözdizimiyle -package komutunu kullanın (tek bir komut satırında):
adt -package SIGNING_OPTIONSair_fileapp_xml [file_or_dir | -C dirfile_or_dir | -e file dir
...] ...
SIGNING_OPTIONS İmzalama seçenekleri, AIR dosyasını imzalamak için kullanılan özel anahtarı ve sertifikayı
içeren anahtar deposunu tanımlar. Bir AIR uygulamasını ADT tarafından oluşturulan kendinden imzalı bir
sertifikayla imzalamak için kullanabileceğiniz seçenekler şunlardır:
-storetype pkcs12 -keystore certificate.p12
Bu örnekte certificate.p12, anahtar deposu dosyasının adıdır. (Komut satırında verilmediği için ADT sizden şifreyi
ister.) İmzalama seçenekleri “ADT komut satırı imzalama seçenekleri” sayfa 310 tamamen açıklanmaktadır.
air_file Oluşturulan AIR dosyasının adı.
app_xml Uygulama tanımlayıcı dosyasının yolu. Yol, geçerli dizine göre veya mutlak yol olarak belirtilebilir.
(Uygulama tanımlayıcı dosyası, AIR dosyasında “application.xml” olarak yeniden adlandırılır.)
file_or_dir AIR dosyasında paketlenecek dosyalar ve dizinler. İstenilen sayıda dosya ve dizin boşluklarla ayrılarak
belirtilebilir. Bir dizini listelerseniz, gizli dosyalar haricinde bu dizinin içinde bulunan tüm dosyalar ve alt dizinler
pakete eklenir. (Buna ek olarak, uygulama tanımlayıcı dosyası doğrudan veya joker karakter ya da dizin genişletme
yoluyla belirtilmişse, yoksayılır ve pakete ikinci defa eklenmez.) Belirtilen dosyalar ve dizinler geçerli dizinde veya
geçerli dizinin alt dizinlerinden birinde olmalıdır. Geçerli dizini değiştirmek için -C seçeneğini kullanın.
Önemli: Joker karakterler C seçeneğinin ardından file_or_dir argümanlarında kullanılamaz. (Komut kabukları
joker karakterleri, argümanları ADT'ye iletmeden önce genişletir, bu da ADT'nin dosyaları yanlış konumda
aramasına neden olur.) Ancak yine de geçerli dizinin yerine geçmesi için nokta karakterini, ".", kullanabilirsiniz.
Örneğin, "-C assets ." alt dizinler de dahil olmak üzere varlıklar dizinindeki her şeyi uygulama paketinin kök
düzeyine kopyalar.
-C dir Uygulama paketine eklenen sonraki dosyaları ve dizinleri işlemeden önce, çalışma dizinini dir değeri olarak
değiştirir. Dosyalar veya dizinler uygulama paketinin köküne eklenir. Dosya sistemindeki birden çok noktadan
dosyaları dahil etmek için –C seçeneği istenilen sayıda kullanılabilir. dir için göreceli bir yol belirtilmişse, yol her
zaman orijinal çalışma dizininden çözümlenir.
ADT paketteki dosyaları ve dizinleri işledikçe, geçerli dizin ve hedef dosyalar arasındaki göreceli yollar saklanır.
Paket yüklendiğinde, bu yollar uygulama dizini yapısına genişletilir. Bu nedenle, -C release/bin
lib/feature.swf dosyasını belirtmek, release/bin/lib/feature.swf dosyasını kök uygulama klasörünün
lib alt dizinine yerleştirir.
-e file dir Belirtilen dosyayı belirtilen paket dizinine yerleştirir.
Not: Uygulama tanımlayıcı dosyasının <content> öğesi, ana uygulama dosyasının uygulama paketi dizin
ağacındaki son konumunu belirtmelidir.
ADT Örnekleri
Geçerli dizindeki belirli uygulama dosyalarını paketleyin:
adt –package -storetype pkcs12 -keystore cert.p12 myApp.air myApp.xml myApp.swf components.swc
Geçerli çalışma dizinindeki tüm dosyaları ve alt dizinleri paketleyin:
adt –package -storetype pkcs12 -keystore ../cert.p12 myApp.air myApp.xml .
Not: Anahtar deposu dosyası, uygulamanızı imzalamak için kullanılan özel anahtarı içerir. İmzalayıcı sertifikasını
hiçbir zaman AIR paketine dahil etmeyin. ADT komutunda joker karakterler kullanırsanız, anahtar deposu dosyasını
farklı bir konuma yerleştirin, böylece pakete dahil olmaz. Bu örnekte anahtar deposu dosyası cert.p12, üst dizinde
bulunur.
Yalnızca ana dosyaları ve bir görüntüler alt dizinini paketleyin.
adt –package -storetype pkcs12 -keystore cert.p12 myApp.air myApp.xml myApp.swf images
application.xml dosyasını ve bir çalışma dizininde (release/bin) bulunan ana SWF dosyasını paketleyin:
adt –package -storetype pkcs12 -keystore cert.p12 myApp.air release/bin/myApp.xml –C
release/bin myApp.swf
Derleme dosya sisteminizdeki birden fazla yerden alınan varlıkları paketleyin. Bu örnekte uygulama varlıkları
paketlemeden önce aşağıdaki klasörlerde konumlandırılmıştır:
/devRoot
/myApp
/release
/bin
myApp.xml
myApp.swf
/artwork
/myApp
/images
image-1.png
...
image-n.png
/libraries
/release
/libs
lib-1.swf
...
lib-n.swf
AIRAliases.js
Aşağıdaki ADT komutunu /devRoot/myApp dizininden çalıştırma:
adt –package -storetype pkcs12 -keystore cert.p12 myApp.air release/bin/myApp.xml
–C release/bin myApp.swf
–C ../artwork/myApp images
–C ../libraries/release libs
Şu paket yapısıyla sonuçlanır:
/myAppRoot
/META-INF
/AIR
application.xml
hash
myApp.swf
mimetype
/images
image-1.png
...
image-n.png
/libs
lib-1.swf
...
lib-n.swf
AIRAliases.js
ADT'yi bir Java programı olarak çalıştırın (sınıf yolunu ayarlamadan):
java –jar {AIRSDK}/lib/ADT.jar –package -storetype pkcs12 -keystore cert.p12 myApp.air
myApp.xml myApp.swf
ADT'yi bir Java programı olarak çalıştırın (Java sınıf yolu ADT.jar paketini içerecek şekilde ayarlanmış olarak):
java com.adobe.air.ADT –package -storetype pkcs12 -keystore cert.p12 myApp.air myApp.xml
myApp.swf
ADT komut satırı imzalama seçenekleri
ADT, AIR uygulamalarını imzalamak için özel anahtarlara ve sertifikalara erişmek amacıyla Java Cryptography
Architecture (JCA) kullanır. İmzalama seçenekleri anahtar deposunu ve bu anahtar deposu içindeki özel anahtarı ve
sertifikayı tanımlar.
Anahtar deposu hem özel anahtarı hem de ilişkilendirilmiş sertifika zincirini içermelidir. Sertifika zinciri uygulamanın
yayıncı kimliğini belirlemek için kullanılır. İmzalayıcı sertifikası bilgisayarda güvenilen bir sertifikaya eklenirse,
sertifikanın ortak adı AIR yükleme iletişim kutusunda yayıncı adı olarak görüntülenir.
ADT sertifikanın x509v3 standardına uymasını (RFC3280) ve kod imzalama için uygun değerlere sahip Genişletilmiş
Anahtar Kullanımı uzantısını içermesini gerektirir. Sertifikadaki kısıtlamalar korunur ve AIR uygulamalarını
imzalamaya yönelik bazı sertifikaların kullanımını engelleyebilir.
Not: ADT, uygun olduğunda, sertifika geri alma listelerini denetlemek ve zaman damgalarını almak üzere Internet
kaynaklarına bağlanmak için Java çalışma zamanı ortamı proxy ayarlarını kullanır. ADT kullanırken Internet
kaynaklarına bağlanma konusunda bir sorunla karşılaşırsanız ve ağınız belirli proxy ayarları isterse, JRE proxy
ayarlarını yapılandırmanız gerekebilir.
AIR imzalama seçeneklerini belirtme
❖ -package ve -prepare komutları için ADT imzalama seçeneklerini belirtmek üzere aşağıdaki sözdizimini
kullanın:
[-alias aliasName] [-storetype type] [-keystore path] [-storepass password1] [-keypass
password2] [-providerName className] [-tsa url]
-alias aliasName —Anahtar deposundaki anahtarın başka adı. Anahtar deposu yalnızca tek bir sertifika içerdiğinde
başka ad belirtmek gerekmez. Başka ad belirtilmemişse, ADT, anahtar deposundaki ilk anahtarı kullanır.
Tüm anahtar deposu yönetim uygulamaları, başka bir adın sertifikalara atanmasına izin vermez. Örneğin Windows
sistemi anahtar deposunu kullanırken, sertifikanın ayırt edilen adını başka ad olarak kullanın. Kullanılabilir
sertifikaları listelemek için Java Keytool yardımcı programını kullanabilirsiniz, böylece başka adı belirleyebilirsiniz.
Örneğin şu komutu çalıştırmak:
keytool -list -storetype Windows-MY
sertifika için aşağıdakine benzer bir çıktı oluşturur:
CN=TestingCert,OU=QE,O=Adobe,C=US, PrivateKeyEntry,
Certificate fingerprint (MD5): 73:D5:21:E9:8A:28:0A:AB:FD:1D:11:EA:BB:A7:55:88
ADT komut satırında bu sertifikaya başvurmak için, başka adı şu şekilde ayarlayın:
CN=TestingCert,OU=QE,O=Adobe,C=US
Mac OS X'te Keychain'deki bir sertifikanın başka adı, Keychain Access uygulamasında görüntülenen addır.
-storetype type —Anahtar deposu uygulaması tarafından belirlenen anahtar deposu türü. Java'nın çoğu
yüklemesinde bulunan varsayılan anahtar deposu uygulaması JKS ve PKCS12 türlerini destekler. Java 5.0, PKCS11
türü için donanım belirteçlerindeki anahtar depolarına erişim konusunda ve Keychain türü için de Mac OS X
anahtarlığa erişim konusunda destek içerir. Java 6.0, MSCAPI türü için destek içerir (Windows'ta). Diğer JCA
sağlayıcıları yüklenmişse ve yapılandırılmışsa, ek anahtar deposu türleri kullanılabilirdir. Anahtar deposu türü
belirtilmemişse, varsayılan JCA sağlayıcısı için varsayılan tür kullanılır.
Saklama türü
Anahtar deposu formatı
Minimum Java
sürümü
JKS
Java anahtar deposu
dosyası (.keystore)
1.2
PKCS12
PKCS12 dosyası (.p12 veya
.pfx)
1.4
PKCS11
Donanım belirteci
1.5
KeychainStore
Mac OS X Keychain
1.5
Windows-MY
veya WindowsROOT
MSCAPI
1.6
-keystore path —Dosya tabanlı saklama türleri için anahtar deposu dosyasının yolu.
-storepass password1 —Anahtar deposuna erişmek için gereken şifre. Belirtilmemişse, ADT şifreyi ister.
-keypass password2 —AIR uygulamasını imzalamada kullanılan özel anahtara erişim için gereken şifre.
Belirtilmemişse, ADT şifreyi ister.
-providerName className —Belirtilen anahtar deposu türü için JCA sağlayıcısı. Belirtilmemişse, ADT, bu
anahtar deposu türü için varsayılan sağlayıcıyı kullanır.
-tsa url —Dijital imzaya zaman damgası uygulamak için RFC3161-uyumlu zaman damgası sunucusun URL'sini
belirtir. URL belirtilmemişse, Geotrust tarafından sağlanan varsayılan bir zaman damgası sunucusu kullanılır. Bir
AIR uygulamasının imzası zaman damgalı olduğunda, imzalayıcı sertifikasının süresi dolduktan sonra da
uygulama yüklenebilir, bunun nedeni zaman damgasının, sertifikanın imzalama sırasında geçerli olduğunu
doğrulamasıdır.
ADT, zaman damgası sunucusuna bağlanamazsa, imzalama iptal edilir ve hiç paket üretilmez. Zaman damgalamayı
devre dışı bırakmak için -tsa none öğesini belirtin. Ancak, zaman damgası olmadan paketlenmiş bir AIR
uygulaması, imzalayıcı sertifikasının süresi dolduktan sonra artık yüklenebilir olmaz.
Not: İmzalama seçenekleri, Java Keytool yardımcı programının eşdeğer seçenekleri gibidir. Keytool yardımcı
programını, Windows'ta anahtar depolarını incelemek ve yönetmek için kullanabilirsiniz. Apple® güvenlik yardımcı
programı da Mac OS X'te bu amaçla kullanılabilir.
İmzalama seçeneği örnekleri
.p12 dosyasıyla imzalama:
-storetype pkcs12 -keystore cert.p12
Varsayılan Java anahtar deposuyla imzalama:
-alias AIRcert -storetype jks
Belirli bir Java anahtar deposuyla imzalama:
-alias AIRcert -storetype jks -keystore certStore.keystore
Mac OS X anahtarlık ile imzalama:
-alias AIRcert -storetype KeychainStore -providerName Apple
Windows sistemi anahtar deposuyla imzalama:
-alias cn=AIRCert -storeype Windows-MY
Donanım belirteciyle imzalama (Java'yı belirteç kullanmak üzere yapılandırma konusundaki talimatlar ve doğru
providerName değeri için belirteç üreticisinin talimatlarına başvurun):
-alias AIRCert -storetype pkcs11 -providerName tokenProviderName
Zaman damgası gömmeden imzalama:
-storetype pkcs12 -keystore cert.p12 -tsa none
ADT ile imzalanmamış bir AIR ara dosyası oluşturma
İmzalanmamış AIR ara dosyası oluşturmak için -prepare komutunu kullanın. Geçerli bir AIR yükleme dosyası
üretmek için, AIR ara dosyası ADT -sign komutuyla imzalanmalıdır.
-prepare komutu, -package komutuyla aynı bayrakları ve parametreleri alır (imzalama seçenekleri dışında). Aradaki
tek fark çıktı dosyasının imzalanmamasıdır. Ara dosya, dosya adı uzantısıyla oluşturulur: airi.
AIR ara dosyasını imzalamak için, ADT -sign komutunu kullanın. (Bkz. AIR ara dosyasını ADT ile imzalama.)
ADT örneği
adt –prepare unsignedMyApp.airi myApp.xml myApp.swf components.swc
AIR ara dosyasını ADT ile imzalama
AIR ara dosyasını ADT ile imzalamak için, -sign komutunu kullanın. sign komutu yalnızca AIR ara dosyalarıyla
çalışır (airi uzantısı). AIR dosyası ikinci kez imzalanamaz.
AIR ara dosyası oluşturmak için, adt -prepare komutunu kullanın. (Bkz. “ADT ile imzalanmamış bir AIR ara dosyası
oluşturma” sayfa 312.)
AIRI dosyasını imzalama
❖ ADT -sign komutunu aşağıdaki sözdizimiyle kullanın:
adt -sign SIGNING_OPTIONSairi_fileair_file
SIGNING_OPTIONS İmzalama seçenekleri, AIR dosyasının imzalanacağı özel anahtarı ve sertifikayı tanımlar. Bu
seçenekler “ADT komut satırı imzalama seçenekleri” sayfa 310 açıklanmaktadır.
airi_file İmzalanacak olan imzalanmamış AIR ara dosyasının yolu.
air_file Oluşturulacak AIR dosyasının adı.
ADT Örneği
adt –sign -storetype pkcs12 -keystore cert.p12 unsignedMyApp.airi myApp.air
Daha fazla bilgi için, bkz. “AIR dosyasını dijital olarak imzalama” sayfa 284.
Uygulama sertifikasını değiştirmek için AIR dosyasını
imzalama
Var olan bir AIR uygulamasını yeni bir imzalayıcı sertifikası kullanmak üzere güncellemek için, ADT -migrate
komutunu kullanın.
Sertifika geçişi aşağıdaki durumlarda yararlı olabilir:
• Kendinden imzalı bir sertifikadan bir sertifika yetkilisi tarafından yayımlanan bir sertifikaya yükseltme yapılırken
• Süresi dolmak üzere olan kendinden imzalı sertifika, yeni bir kendinden imzalı sertifikayla değiştirilirken
• Bir ticari sertifika diğeriyle değiştirilirken, örneğin şirketinizin kimliği değiştiğinde
Geçiş imzasını uygulamak için orijinal sertifika hala geçerli olmalıdır. Sertifikanın süresi dolduktan sonra, geçiş imzası
uygulanamaz. Uygulamanızın kullanıcılarının güncellenen sürümü yükleyebilmeleri için, var olan sürümü
kaldırmaları gerekecektir. Geçiş imzasının varsayılan olarak zaman damgalı olduğunu unutmayın, böylelikle bir geçiş
imzasıyla imzalanan AIR güncellemeleri, sertifikanın süresi dolduktan sonra da geçerli olur.
Not: Ticari olarak yayımlanmış bir sertifikayı yenilediğinizde, genellikle sertifikaya geçiş yapmanız gerekmez. Yenilenen
sertifika, ayırt edilen ad değiştirilene kadar orijinaliyle aynı yayıncı kimliğini korur. Ayırt edilen adın belirlenmesine
yönelik kullanılan sertifika niteliklerinin tam listesi için, bkz. “AIR yayıncı kimlikleri hakkında” sayfa 285.
Uygulamayı yeni bir sertifika kullanmaya geçirmek için:
1 Uygulamanız için bir güncelleme oluşturun
2 Güncelleme AIR dosyasını yeni sertifikayla paketleyin ve imzalayın
3 AIR dosyasını -migrate komutunu kullanarak orijinal sertifikayla yeniden imzalayın
-migrate komutuyla imzalanmış bir AIR dosyası hem uygulamanın yeni bir sürümünü yüklemek hem de eski
sertifikayla imzalananlar da dahil olmak üzere önceki sürümlerini güncellemek için kullanılabilir.
Bir AIR uygulamasını yeni bir sertifika kullanmaya geçirme
❖ ADT -migrate komutunu aşağıdaki sözdizimiyle kullanın:
adt -migrate SIGNING_OPTIONSair_file_inair_file_out
SIGNING_OPTIONS İmzalama seçenekleri, AIR dosyasının imzalanacağı özel anahtarı ve sertifikayı tanımlar. Bu
seçenekler orijinal imzalayıcı sertifikayı tanımlamalıdır ve “ADT komut satırı imzalama seçenekleri” sayfa 310
açıklanmaktadır.
air_file_in Yeni sertifikayla imzalanan, güncelleme için AIR dosyası.
air_file_out Oluşturulacak AIR dosyası.
ADT Örneği
adt –migrate -storetype pkcs12 -keystore cert.p12 myApp.air myApp.air
Daha fazla bilgi için, bkz. “AIR dosyasını dijital olarak imzalama” sayfa 284.
Not: -migrate komutu ADT'ye AIR 1.1 sürümünde eklendi.
ADT ile kendinden imzalı bir sertifika oluşturma
Kendinden imzalı sertifikalar sayesinde geçerli bir AIR yükleme dosyası üretebilirsiniz, ancak kendinden imzalı
sertifikaların gerçekliği doğrulanamadığı için, bu sertifikalar kullanıcılarınıza yalnızca sınırlı güvenlik teminatları
sağlar. Kendinden imzalı bir AIR dosyası yüklendiğinde, yayıncı bilgileri kullanıcıya Bilinmeyen olarak görüntülenir.
ADT tarafından oluşturulan sertifika beş yıl boyunca geçerlidir.
Kendinden oluşturulan bir sertifikayla imzalanan AIR uygulaması için bir güncelleme oluşturursanız, hem orijinal
hem de güncelleme AIR dosyalarını imzalamak için aynı sertifikayı kullanmanız gerekir. ADT'nin ürettiği sertifikalar,
aynı parametreler kullanılsa bile her zaman benzersizdir. Bu nedenle, güncellemelerin ADT tarafından oluşturulan bir
sertifikayla kendinden imzalanmasını istiyorsanız, orijinal sertifikayı güvenli bir konumda saklayın. Buna ek olarak,
ADT tarafından oluşturulan orijinal sertifikanın süresi dolduktan sonra, güncellenmiş bir AIR dosyası üretemezsiniz.
(Yeni uygulamaları farklı bir sertifikayla yayınlayabilirsiniz, ancak aynı uygulamanın yeni sürümlerini
yayınlayamazsınız.)
Önemli: Adobe, kendinden imzalı sertifikaların sınırlamaları nedeniyle, genel olarak piyasaya sürülmüş AIR
uygulamalarını imzalamak için VeriSign veya Thawte gibi itibarlı bir sertifika yetkilisinden alınan ticari bir sertifikaya
sahip olmanızı özellikle önerir.
ADT tarafından oluşturulan sertifika ve ilişkilendirilmiş özel anahtar, PKCS12 türü bir anahtar deposu dosyasında
saklanır. Belirtilen şifre anahtar deposunda değil, anahtarın kendisinde ayarlanır.
AIR dosyalarının kendiliğinden imzalanması için bir dijital kimlik sertifikası oluşturma
❖ ADT -certificate komutunu kullanın (tek bir komut satırında):
adt -certificate -cn name [-ou org_unit][-o org_name][-c country] key_typepfx_filepassword
-cn name Yeni sertifikanın ortak adı olarak atanan dize.
-ou org_unit Sertifikayı yayımlayan birim olarak atanan dize. (İsteğe bağlı.)
-o org_nameSertifikayı yayımlayan kurum olarak atanan dize. (İsteğe bağlı.)
-c countryİki harfli ISO-3166 ülke kodu. Geçersiz bir kod verilirse, sertifika oluşturulmaz. (İsteğe bağlı.)
key_typeSertifika için kullanılacak anahtar türü, “1024-RSA” veya “2048-RSA”.
pfx_file Oluşturulacak sertifika dosyasının yolu.
password Yeni sertifika için şifre. AIR dosyaları bu sertifikayla imzalanırken şifre gereklidir.
Sertifika oluşturma örnekleri
adt -certificate -cn SelfSign -ou QE -o "Example, Co" -c US 2048-RSA newcert.p12 39#wnetx3tl
adt -certificate -cn ADigitalID 1024-RSA SigningCert.p12 39#wnetx3tl
AIR dosyalarını imzalarken bu sertifikaları kullanmak için, aşağıdaki imzalama seçeneklerini ADT -package veya prepare komutlarıyla kullanırsınız:
-storetype pkcs12 -keystore newcert.p12 -keypass 39#wnetx3tl
-storetype pkcs12 -keystore SigningCert.p12 -keypass 39#wnetx3tl
Apache Ant aracını SDK araçlarıyla kullanma
Bu konu, Apache Ant oluşturma aracının AIR uygulamalarını test etmede ve paketlemede kullanılmasına ilişkin
örnekler sunar.
Not: Bu açıklamalar Apache Ant aracını kapsamlı bir şekilde anlatma amacı taşımaz. Ant belgeleri için, bkz.
http://Ant.Apache.org.
Ant aracını basit projeler için kullanma
Bu örnek, Ant ve AIR komut satırı araçları kullanılarak bir AIR uygulaması oluşturmayı gösterir. Basit bir proje yapısı,
tüm dosyalar tek bir dizinde saklı olarak kullanılır.
Bu özellikler, oluşturma komut dosyasının yeniden kullanılmasını kolaylaştırmak için birçok tanımlı özellik kullanır.
Bir özellik kümesi, komut satırı araçlarının yüklenen konumlarını tanımlar:
<property name="SDK_HOME" value="C:/Flex3SDK"/>
<property name="ADL" value="${SDK_HOME}/bin/adl.exe"/>
<property name="ADT.JAR" value="${SDK_HOME}/lib/adt.jar"/>
İkinci özellik kümesi projeye özgüdür. Bu özellikler, uygulama tanımlayıcı ve AIR dosyalarının kök kaynak dosyasına
dayalı olarak adlandırıldığı bir adlandırma kuralını kabul eder. Diğer kurallar kolaylıkla desteklenir.
<property
<property
<property
<property
<property
<property
name="APP_NAME" value="ExampleApplication"/>
name="APP_ROOT" value="."/>
name="APP_DESCRIPTOR" value="${APP_ROOT}/${APP_NAME}-app.xml"/>
name="AIR_NAME" value="${APP_NAME}.air"/>
name="STORETYPE" value="pkcs12"/>
name="KEYSTORE" value="ExampleCert.p12"/>
ADL'yi bir uygulamayı test etmesi için çağırma
Uygulamayı ADL ile çalıştırmak için, bir exec görevi kullanın:
<target name="test" depends="compile">
<target name="test">
<exec executable="${ADL}">
<arg value="${APP_DESCRIPTOR}"/>
</exec>
</target>
ADT'yi bir uygulamayı paketlemesi için çağırma
Uygulamayı paketlemek için adt.jar aracını çalıştırmak üzere bir Java görevi kullanın:
<target name="package">
<java jar="${ADT.JAR}" fork="true" failonerror="true">
<arg value="-package"/>
<arg value="-storetype"/>
<arg value="${STORETYPE}"/>
<arg value="-keystore"/>
<arg value="${KEYSTORE}"/>
<arg value="${AIR_NAME}"/>
<arg value="${APP_NAME}.swf"/>
<arg value="*.png"/>
</java>
</target>
Uygulamanızın paketlenecek başka dosyaları da varsa, ek <arg> öğeleri ekleyebilirsiniz.
Ant'ı daha karmaşık projeler için kullanma
Genel bir uygulamanın dizin yapısı tek bir dizinden daha karmaşıktır. Aşağıdaki örnek, daha pratik bir proje dizin
yapısına sahip olan bir AIR uygulamasını derlemek, test etmek ve paketlemek için kullanılan bir oluşturma dosyasını
gösterir.
Bu örnek proje, uygulama kaynak dosyalarını ve simge dosyaları gibi başka varlıkları src dizininde saklar. Oluşturma
komut dosyası, aşağıdaki çalışma dizinlerini oluşturur:
build Derlenen SWF dosyalarının sürümlerini (hata ayıklama özelliğine sahip olmayan) saklar.
debug Uygulamanın, derlenen tüm SWF'ler ve varlık dosyaları da dahil olmak üzere paketlenmemiş bir hata ayıklama
sürümünü saklar. ADL yardımcı programı, uygulamayı bu dizinden çalıştırır.
release Son AIR paketini saklar
AIR araçları, geçerli çalışma dizininin dışındaki dosyalarda çalışırken bazı ek seçeneklerin kullanılmasını gerektirir.
Testing ADL'ye iletilen ikinci argüman AIR uygulamasının kök dizinini belirtir. Uygulama kök dizinini belirtmek için
aşağıdaki satır, test görevine eklenir:
<arg value="${debug}"/>
Packaging Son paket yapısının bir parçası olmaması gereken alt dizinlerden dosya paketlemek, ADT çalışma dizininin
değiştirilmesi için -C direktifinin kullanılmasını gerektirir. -C direktifini kullandığınızda, yeni çalışma dizinindeki
dosyalar ve dizinler AIR paket dosyasının kök düzeyine kopyalanır. Bu nedenle, -C build file.png, file.png
dosyasını uygulama dizininin köküne kopyalar. Benzer şekilde -C assets icons, simge klasörünü kök düzeyine
kopyalar, simgeler klasörünün içindeki tüm dosyaları ve dizinleri de kopyalar. Örneğin, aşağıda bulunan paket
görevindeki satır dizisi, simgeler dizinini doğrudan uygulama paket dosyasının kök düzeyine ekler:
<arg value="-C"/>
<arg value="${assets}"/>
<arg value="icons"/>
Not: Birçok kaynağı ve varlığı farklı göreceli konumlara taşımanız gerekiyorsa, ADT için karmaşık bir argüman listesi
oluşturmak yerine, onları Ant görevleri kullanarak geçici bir dizine ayırmak genellikle daha kolaydır. Kaynaklarınız
organize edildikten sonra, onları paketlemek için basit bir ADT argüman listesi kullanılabilir.
<project>

<property name="SDK_HOME" value="C:/Flex3SDK"/>
<property name="ADL" value="${SDK_HOME}/bin/adl.exe"/>
<property name="ADT.JAR" value="${SDK_HOME}/lib/adt.jar"/>

<property name="PROJ_ROOT_DIR" value="."/>
<property name="APP_NAME" value="ExampleApplication"/>
<property name="APP_ROOT_DIR" value="."/>
<property name="APP_ROOT_FILE" value="${APP_NAME}.swf"/>
<property name="APP_DESCRIPTOR" value="${PROJ_ROOT_DIR}/${APP_NAME}-app.xml"/>
<property name="AIR_NAME" value="${APP_NAME}.air"/>
<property name="release" location="${PROJ_ROOT_DIR}/release"/>
<property name="assets" location="${PROJ_ROOT_DIR}/src/assets"/>
<property name="STORETYPE" value="pkcs12"/>
<property name="KEYSTORE" value="ExampleCert.p12"/>
<target name="init" depends="clean">
<mkdir dir="${release}"/>
</target>
<target name="test">
<exec executable="${ADL}">
<arg value="${APP_ROOT_DIR}"/>
</exec>
</target>
<target name="package" depends="init">
<java jar="${ADT.JAR}" fork="true" failonerror="true">
<arg value="-package"/>
<arg value="-storetype"/>
<arg value="${STORETYPE}"/>
<arg value="-keystore"/>
<arg value="${KEYSTORE}"/>
<arg value="${release}/${AIR_NAME}"/>
<arg value="-C"/>
<arg value="${APP_ROOT_DIR}"/>
<arg value="${APP_ROOT_FILE}"/>
<arg value="-C"/>
<arg value="${assets}"/>
<arg value="icons"/>
</java>
</target>
<target name="clean" description="clean up">
<delete dir="${release}"/>
</target>
</project>
318
Dizin
Semboller
? (soru işareti) karakter, adlandırılmamış
SQL parametrelerinde 168
@ (at) karakteri, SQL ifadesi parametre
adlarında 167
\
(iki nokta) karakteri, SQL ifadesi
parametre adlarında 167
kaldırma 2
kaldırma 26
yeni işlevler 49
kurulumu saptama 281
yükleme 1, 23
simgeler 47
Adobe belgeleri 9
sürümler 43, 266, 290
Adobe destek web sitesi 9
tarayıcı başlatma 47
Adobe Media Player 248
telif hakkı bilgileri 45
Adobe Press kitapları 9
yükleme 23, 275
Adobe Reader 193, 244
yükleme yolu 43
Numaralar
1024-RSA 314
AES-CBC 128-bit şifreleme 189
AIR uygulamaları için telif hakkı bilgileri 45
ağ iletişimiyle yerel sanal alan 26
AIR uygulamalarından çıkma 257
2048-RSA 314
AIR çalışma zamanı
AIR uygulamalarını başlatma 257
güncelleme 23
AIR uygulamalarını çalıştırma 275, 282
Á
AC_FL_RunContent() işlevi
(default_badge.html'de) 277
kaldırma 2
AIR uygulamalarını dağıtma 275
saptama 266, 280
AIR uygulamalarını güncelleme 47, 290
yama düzeyleri 42, 266
AIR uygulamalarını yükleme 275
AC_RuntimeActiveContent.js 277
yeni işlevler 49
AIR uygulaması
acceptDragDrop() yöntemi
(NativeDragManager sınıfı) 123, 127
yükleme 1
açılır menüler 77, 87
oluşturma 81
acompc derleyicisi 217
Acrobat 193, 244
Action Message Format (AMF) 124, 148,
151
ActionScript
görüntü nesneleri 64
JavaScript çapraz komut dosyası 213
ActionScript belgeleri 9
ActionScript ve JavaScript arasında dönüşen
Date nesneleri 218
AIR çalışma zamanını veya AIR
uygulamasını güncellemek için gerekli
ayrıcalıklar 23
ayarlar 264
AIRAliases.js dosyası 192, 211, 212
AIRI dosyaları
AIR Geliştirici Aracı (ADT) ile
oluşturma 312
AIR çalışma zamanını veya bir AIR
uygulamasını güncellemek için gerekli
ayrıcalıklar 275, 282
AIRLocalizer.js dosyası 295
AIR dosyaları
Ajax
imzalama 284
paketleme 306
güvenlik 32
uygulama sanal alanında destek 32
AIR dosyalarını imzalama 306
alanlar (veritabanı) 158
AIR dosyalarını paketleme
allowBrowserInvocation öğesi (uygulama
tanımlayıcı dosyası) 47, 257, 260
AIR Geliştirici Aracı (ADT) 306
AIR Geliştirici Aracı (ADT)
allowCrossDomainXHR niteliği (kare ve
iframe öğeleri) 195, 201
ActionScript ve JavaScript arasında dönüşen
RegExp nesneleri 218
AIRI dosyaları 312
bir AIR dosyasını paketleme 306
allowLoadBytesCodeExecution özelliği
(LoaderContext sınıfı) 39
activate() yöntemi (NativeWindow
sınıfı) 60, 65, 66
imzalama seçenekleri 310
alt menü özelliği
kendinden imzalı sertifikalar
oluşturma 313
alt menüler 79, 82
active olayı 71
activeWindow özelliği (NativeApplication
sınıfı) 65
addChild() yöntemi (Stage sınıfı) 63
AIR geliştirici sertifikaları 285
AIR Hata Ayıklama Başlatıcısı (ADL)
çıkış ve hata kodları 305
addChildAt() yöntemi (Stage sınıfı) 63
air özelliği (AIRAliases.js dosyası) 192, 211
adlandırılmamış parametreler (SQL
ifadelerinde) 168
AIR uygulamaları
NativeMenuItem sınıfı 79
alwaysInFront özelliği (NativeWindow
sınıfı) 66
ana anahtarlar
menü öğeleri 80
veritabanları 176
ayarlar 41, 42
ana dizin 99
başlatma 257
ana ekran 74
Adobe Acrobat Geliştirici Merkezi 245
çalıştırma 275, 282
anahtar depoları 310, 314
Adobe AIR
çıkma 257
anımsatıcı karakterler
adlandırılmış parametreler (SQL
ifadelerinde) 167
giriş 7
dağıtma 275
menü öğeleri 80
güncelleme 23
dosya türü ilişkilendirmeleri 48, 258, 265
app desteği URL şeması 220
güncelleme 23, 47, 290
app URL şeması 37, 39, 61, 212, 220, 245
Dizin
app-depolama URL şeması 37
boyut, pencereler 60
AppInstallDisabled (Windows kayıt defteri
ayarları) 26
boyutlar, pencereler 46
setData() yöntemi 145
setDataHandler() yöntemi 145
browseForDirectory() yöntemi (File
sınıfı) 101
clipboardData özelliği (clipboard
olayları) 198
applicationDescriptor özelliği
(NativeApplication sınıfı) 264
browseForOpen() yöntemi (File sınıfı) 102
browseForSave() yöntemi (File sınıfı) 102
clipboardData özelliği (HTML copy-andpaste olayları) 139
ApplicationDomain sınıfı 214
browserInvoke olayı 261, 283
ClipboardFormats sınıfı 143
applicationStorageDirectory özelliği (File
sınıfı) 99
BrowserInvokeEvent sınıfı 260
ClipboardTransferModes sınıfı 144
ByteArray sınıfı
close olayı 71
Apple geliştirici sertifikaları 285
app-storage URL şeması 39, 245
araç çubuğu (Mac OS) 58
arguments özelliği
bytesAvailable özelliği 149
compress() yöntemi 151
close() yöntemi
NativeWindow sınıfı 67
length özelliği 149
close() yöntemi (window nesnesi) 54
position özelliği 149
closing olayı 67, 71, 227, 262
readBytes() yöntemi 148
complete olayı 215, 218, 224
readFloat() yöntemi 148
compress() yöntemi (ByteArray sınıfı) 151
readInt() yöntemi 148
CompressionAlgorithm sınıfı 151
attach() yöntemi (SQLConnection
sınıfı) 178
readObject() yöntemi 148
content öğesi (uygulama tanımlayıcı
dosyası) 46
autoExit özelliği
uncompress() yöntemi 151
InvokeEvent sınıfı 258
Asfunction protokolü 28
at (@) karakteri, SQL ifadesi parametre
adlarında 167
NativeApplication sınıfı 262
readUTFBytes() yöntemi 148
writeBytes() yöntemi 148
AUTOINCREMENT sütunları (SQL) 177
writeFloat() yöntemi 148
ayırıcı satırlar, menü 83
writeInt() yöntemi 148
writeObject() yöntemi 148
B
bağlam menüleri 77, 83
HTML 84
başlangıç (sistem), bir AIR uygulamasını
başlatma 260
writeUTFBytes() yöntemi 148
yapıcı 148
bytesAvailable özelliği (ByteArray sınıfı) 149
Başlat menüsü (Windows) 45
başlık çubuğu simgeleri (Windows) 58
Capabilities sınıfı
bayt sırası 150
playerType özelliği 266
çapraz komut dosyası 34, 213, 220
boyutu 149
konum 149
bayt sırası 150
ContextMenu sınıfı 80, 83
ContextMenuEvent sınıfı
contextMenuOwner özelliği 83
mouseTarget özelliği 83
ContextMenuItem sınıfı 80
contextMenuOwner özelliği
(ContextMenuEvent sınıfı) 83
copy olayı 139
copy() yöntemi (NativeApplication
sınıfı) 141
copyTo() yöntemi (File sınıfı) 109
copyToAsync() yöntemi (File sınıfı) 109
CREATE TABLE ifadesi (SQL) 162
Ch
childSandboxBridge özelliği
belgeler, ilgili 9
LoaderInfo sınıfı 34
Belgelerim dizini (Windows) 99
Window nesnesi 30
bellek içi veritabanları 161
çıkış kodları (ADL) 305
big-endian bayt sırası 150
clearData() yöntemi
bilinmeyen yayıncı adı (AIR uygulama
yükleyicisinde) 284
contextmenu olayı 84
çöp kutusu (dosya silme) 110
Č
Canvas nesnesi 196, 203
bayt dizileri
contenteditable niteliği (HTML) 132
createDirectory() yöntemi (File sınıfı) 106
createElement() yöntemi (Document
nesnesi) 211
createRootWindow() yöntemi
(HTMLLoader sınıfı) 60, 62, 206
createTempDirectory() yöntemi (File
sınıfı) 107, 111
ClipboardData nesnesi 197
createTempFile() yöntemi (File sınıfı) 111
DataTransfer nesnesi 130, 198
creationDate özelliği (File sınıfı) 108
bir AIR uygulamasıyla ilişkilendirilen
uzantılar (dosya) 48, 258
clientX özelliği (HTML drag olayları) 130
creator özelliği (File sınıfı) 108
bir imzayı geçirme 287, 312
clientY özelliği (HTML drag olayları) 130
CSS
bitmap görüntüleri, simgeler için ayar 92
Clipboard 197
AIR uzantıları 204
bitmapler
clipboard olayı 198
HTML stillerine ActionScript'ten
erişme 218
kopyala ve yapıştır desteği 137
sürükle ve bırak desteği 122, 130
bitmaps özelliği (Icon sınıf) 92
boşta kalma süresi (kullanıcı) 266
bounce yöntemi() (Icon sınıfı) 93
clipboard özelliği (NativeDragEvent
sınıfı) 127
Clipboard sınıfı
generalClipboard özelliği 137
getData() yöntemi 123, 127
Ctrl tuşu 80
currentDirectory özelliği (InvokeEvent
sınıfı) 258
Dizin
currentDomain özelliği
(ApplicationDomain sınıfı) 214
dizinleri silme 108, 110
dosyaları taşıma 109
dizinleri taşıma 107
dosyaları yazma 111
customItems özelliği (ContextMenu
sınıfı) 83
dizinleri temizleme 108
DPAPI (şifreli verilerin kullanıcılarla
ilişkilendirilmesi) 189
customUpdateUI öğesi (uygulama
tanımlayıcı dosyası) 47, 257, 291
dışarı sürükleme hareketi 122, 124
Dock menüleri 78
drag olayı 129, 198
dock simgeleri 93
dragend olayı 129, 198
cut olayı 139
Ď
data özelliği
DataTransfer nesnesi
types özelliği 133
DataTransfer nesnesi (HTML sürükle ve
bırak) 130, 131, 132, 133, 198
destek 92
dragenter olayı 129, 198
menüler 81
dragleave olayı 129, 198
pencereyi simge durumuna küçültme
ve 66
dragover olayı 129, 198
zıplatma 93
DRM 248
Document nesnesi
dragstart olayı 129, 198
kimlik bilgileri 254
createElement() yöntemi 211
DRMAuthenticateEvent sınıfı 249, 253
designMode özelliği 132, 199
DRMErrorEvent sınıfı 249
deactivate olayı 71
stylesheets özelliği 218
default_badge.html 277
wirtelin() yöntemi 198
deflate sıkıştırma 151
write() yöntemi 32, 198, 211
DRMStatusEvent sınıfı 249
writeln() yöntemi 32, 211
drop olayı 129, 198
değiştirici tuşlar, menü öğeleri 80
DELETE ifadesi (SQL) 177
deleteDirectory() yöntemi (File sınıfı) 108
deleteDirectoryAsync() yöntemi (File
sınıfı) 108
deleteFile() yöntemi (File sınıfı) 110
deleteFileAsync() yöntemi (File sınıfı) 110
description öğesi (uygulama tanımlayıcı
dosyası) 44
designMode özelliği (Document
nesnesi) 132, 199
desktopDirectory özelliği (File sınıfı) 99
Dictionary sınıfı 212
subErrorID özelliği 254
documentRoot niteliği (kare ve iframe
öğeleri) 29, 193, 201, 220
dropAction özelliği (NativeDragEvent
sınıfı) 126, 127
documentRoot nitelikleri (kare ve iframe
öğeleri) 29
dropEffect özelliği (DataTransfer
nesnesi) 130, 131, 198
documents dizini 99
documentsDirectory özelliği (File sınıfı) 99
doDrag() yöntemi (NativeDragManager
sınıfı) 123, 124, 127
É
effectAllowed özelliği (DataTransfer
nesnesi) 130, 131, 132, 198
dominitialize olayı 201
eklentiler (HTML'de) 193
dosya API'si 97
ekranlar 73
dosya listeleri
sürükle ve bırak desteği 130
dijital haklar yönetimi 248
dosya seçici iletişim kutuları 102
dijital imzalar 284, 306, 310
dosya sistemi
dinamik kod oluşturma 31
hata kodları 254
güvenlik 37
ana 74
numaralandırma 74
pencereler,taşınan 74
ekranları numaralandırma 74
encoding özelliği (File sınıfı) 106
dispatchEvent() yöntemi (NativeWindow
sınıfı) 55
dosya sistemi API'si 97
EncryptedLocalStore sınıfı 189
dosya sistemiyle yerel sanal alan 26, 194
Endian.BIG_ENDIAN 150
display() yöntemi (NativeMenu sınıfı) 87
dosya türlerini kaydetme 265
Endian.LITTLE_ENDIAN 150
displayState özelliği (Stage sınıfı) 72
dosya türü ilişkilendirmeleri 48, 258, 265
enterFrame olayı 63
displayStateChange olayı 55, 71
dosya URL şeması 37, 103, 212
error olayı 166
displayStateChanging olayı 55, 71
dosyalar
etki alanları arası önbellek güvenliği 28
dizin oluşturma 106
başvurma 101
etkin menü öğeleri 81
dizin seçici iletişim kutuları 101
etkin pencere 65
dizinler 99, 106
kopyalama 109
etkinlik (kullanıcı), saptama 266
başvurma 99
okuma 111
eval() işlevi 28, 31, 195, 207, 208
kopyalama 107
silme 110
numaralandırma 107
execute() yöntemi (SQLStatement
sınıfı) 167, 169, 176
oluşturma 106
taşıma 109
exists özelliği (File sınıfı) 108
silme 108, 110
veritabanı 158
exit() yöntemi
taşıma 107
yazma 111
uygulama başlatma 258
dosyaları kopyalama 109
dizinleri kopyalama 107
dosyaları okuma 111
dizinleri numaralandırma 107
dosyaları silme 110
exiting olayı 262
Dizin
F
File sınıfı 97, 98
Flash Media Rights Management Server 248
güvenlik
Flash Player 49, 191, 194, 212
Ajax çerçeveleri 32
asfunction protokolü 28
browseForDirectory() yöntemi 101
FlashVars ayarları (badge.swf'yi kullanmak
için) 277
browseForOpen() yöntemi 102
Flex
CSS 29
applicationStorageDirectory özelliği 98
browseForSave() yöntemi 102
çapraz komut dosyası 34
dinamik kod oluşturma 31
copyTo() yöntemi 109
FLV videoları, şifreleme 248
dosya sistemi 37
copyToAsync() yöntemi 109
FMRMS (Flash Media Rights Management
Server) 248
en iyi uygulamalar 39
createDirectory() yöntemi 106
createTempDirectory() yöntemi 107, 111
createTempFile() yöntemi 111
creationDate özelliği 108
creator özelliği 108
deleteDirectory() yöntemi 108
deleteDirectoryAsync() yöntemi 108
G
geçici dizinler 107
geçici dosyalar 111
gecikmeli oluşturma (kopyalama ve
yapıştırma) 145
etki alanları arası önbellek 28
eval() işlevi 31
HTML 29, 31, 191, 193, 207
içerik yükleme 61
iframe'ler 29
img etiketleri 28
generalClipboard özelliği (Clipboard
sınıfı) 137
indirgeme saldırıları 40
deleteFile() yöntemi 110
deleteFileAsync() yöntemi 110
gereksinimler
JavaScript hataları 207
desktopDirectory özelliği 98
documentsDirectory özelliği 98
PDF oluşturma 244
JavaScript 220
kareler 29
kullanıcı kimlik bilgileri 40
encoding özelliği 106
getApplicationVersion() yöntemi (air.swf
dosyası) 281
exists özelliği 108
getData() yöntemi
metin alanları 28
Loader.loadBytes() yöntemi 39
getDirectoryListingAsync() yöntemi 107
Clipboard sınıfı 127
Pano 138
getRootDirectories() 98
ClipboardData nesnesi 197
sanal alan köprüleri 30, 34, 220
getRootDirectories() yöntemi 98
DataTransfer nesnesi 133, 198
sanal alanlar 26, 193, 194, 220, 266
isDirectory özelliği 108
HTML copy-and-paste olayı 139
tarayıcı başlatma özelliği 261
lineEnding özelliği 106
modificationDate özelliği 108
moveTo() yöntemi 109
moveToAsync() yöntemi 109
moveToTrash() yöntemi 110
moveToTrashAsync() yöntemi 110
name özelliği 108
nativePath özelliği 98, 108
parent özelliği 108
relativize() yöntemi 103
resolvePath() yöntemi 98
separator özelliği 106
size özelliği 108
spaceAvailable özelliği 105
type özelliği 108
url özelliği 98, 108
userDirectory özelliği 98
yerel bir veritabanına başvurma 161
FileMode sınıfı 97
filename öğesi (uygulama tanımlayıcı
dosyası) 43
FileStream sınıfı 97
fileTypes öğesi (uygulama tanımlayıcı
dosyası) 48, 265
Flash belgeleri 9
getData() yöntemi (bir HTML drag olayının
dataTransfer özelliğine ait) 130
getData() yöntemi (Clipboard sınıfı) 123
getDefaultApplication() yöntemi
getDirectoryListing() yöntemi (File
sınıfı) 107
getDirectoryListingAsync() yöntemi (File
sınıfı) 107
getResult() yöntemi (SQLStatement
sınıfı) 176
getScreensForRectangle() yöntemi(Screen
sınıfı) 74
getStatus() yöntemi (air.swf dosyası) 280
gömülü nesneler (HTML'de) 193
göreceli yollar (dosyalar arasında) 103
görev çubuğu simgeleri 66, 92
görüntü nesneleri (ActionScript) 64
görüntü sırası, pencereler 66
görüntüler
Bkz. ekranlar
gözatma
uygulama depolama dizini 25
uygulama dışı sanal alanlar 28
uygulama sanal alanı 26
verileri şifreleme 189
veritabanı 168
XMLHTTPRequest 201
XMLHttpRequest nesneleri 33
yükleme (uygulama ve çalışma
zamanı) 23
yükleme için kullanıcı ayrıcalıkları 23
GZIP formatı 151
H
hafif pencereler 56
hasEventListener() yöntemi 229
hata kodları
DRM 254
height öğesi (uygulama tanımlayıcı
dosyası) 46
height özelliği (HTMLLoader sınıfı) 206
hizmet pencereleri 56
dizin seçmek için 101
hostContainer özelliği (PDF) 246
dosya seçmek için 102
HTML
AIR uzantıları 201
DOM, ActionScript'ten erişim 215
Dizin
eklentiler 193
gömülü nesneler 193
güvenlik 29, 193, 220
ilişkisel veritabanları
Bkz. veritabanları
kaydırma 224
img etiketleri (TextField nesnesi
içeriğinde) 28
kopyala ve yapıştır 139
imleç, sürükle ve bırak efektleri 127, 131
olaylar 224
imzalar
pencereler 60
geçirme 287, 312
sanal alanlar 194
indirgeme saldırıları ve güvenlik 40
Info.plist dosyaları (Mac OS) 45
SWF içeriğini kaplama 62
initialWindow öğesi (uygulama tanımlayıcı
dosyası) 45, 54
yazdırma 194
yükleme içeriği 206
HTML DOM ve yerel pencereler 54
htmlBoundsChanged olayı 224
htmlDOMInitialize olayı 224
htmlLoader özelliği (Window nesnesi) 192,
200, 206
innerHTML özelliği 32, 198, 211
INSERT ifadesi (SQL) 181
installApplication() yöntemi (air.swf
dosyası) 281
installFolder öğesi (uygulama tanımlayıcı
dosyası) 45
htmlLoader özelliği (window nesnesi) 61
INTEGER PRIMARY KEY sütunları
(SQL) 177
HTMLLoader sınıfı 206
invoke olayı 257
createRootWindow() yöntemi 60, 62, 206
height özelliği 206
JavaScript erişimi 192
InvokeEvent sınıfı 48, 258
arguments özelliği 258
currentDirectory özelliği 258
işaretli menü öğeleri 81
loadString() yöntemi 206
isDirectory özelliği (File sınıfı) 108
olaylar 224
paintsDefaultBackground özelliği 57, 63
isHTTPS özelliği (BrowserInvokeEvent
sınıfı) 261
pdfCapability özelliği 244
İşlev yapıcıları (JavaScript'te) 195
runtimeApplicationDomain özelliği 214
işlevler (JavaScript)
width özelliği 206
değişmezler 31
HTMLPDFCapability sınıfı 244
tanımlar 31
HTMLUncaughtScriptException sınıfı 225
yapıcı 210
Í
içeri sürükleme hareketi 122, 126
isSetAsDefaultApplication() yöntemi
JavaScript URL şeması 32, 210
javascript URL şeması 200
JavaSoft geliştirici sertifikaları 285
JSON 195
K
kaldırma
AIR çalışma zamanı 2
AIR uygulamaları 26
kare öğeleri 193, 195, 201
kareler 29
kendinden imzalı sertifikalar 40, 284, 313
Keyboard sınıfı 80
KeyChain (şifreli verilerin kullanıcılarla
ilişkilendirilmesi) 189
keyEquivalent özelliği (NativeMenuItem
sınıfı) 80
keyEquivalentModifiers özelliği
(NativeMenuItem sınıfı) 80
kimlik bilgileri
DRM şifreli içerik için 254
klavye kısayolları
kod imzalama 40, 284
kök birimler 99
komut dosyası etiketleri 195, 198, 210, 212,
216
src özelliği 32
komut satırı argümanları, yakalama 258
Komut tuşu 80
komutlar, menü
Bkz. menü öğeleri
kopyala ve yapıştır
aktarım modları 144
J
Java Cryptography Architecture (JCA) 310
HTML 139, 197
icon öğesi (uygulama tanımlayıcı
dosyası) 47
icon özelliği (NativeApplication sınıfı) 92
JavaScript
menü komutları 140
Icon sınıfı
ActionScript çapraz komut dosyası 213
bitmaps özelliği 92
AIR API'lere erişim 211
bounce() yöntemi 93
AIR çalışma zamanı ve 191
klavye kısayolları 140
varsayılan menü öğeleri (Mac OS) 141
kopyalama ve yapıştırma
gecikmeli oluşturma 145
kullanıcı adları
id öğesi (NativeApplication sınıfı) 264
AIR desteği 194
id öğesi (uygulama tanımlayıcı dosyası) 43
AIRAliases.js dosyası 192, 212
idleThreshold özelliği (NativeApplication
sınıfı) 266
error olayları 224
kullanıcı etkinliği, saptama 266
güvenlik 220
kullanıcı kimlik bilgileri ve güvenlik 40
ifadeler, SQL 166
güvenlik hatalarını önleme 207
iframe öğeleri 29, 193, 195, 201
hatalar 207, 214, 225, 228
iki nokta (\
olaylar, işleme 227
) karakteri, SQL ifadesi parametre
adlarında 167
ikili veriler
Bkz. bayt dizileri
PDF 245
programlama 206
JavaScript güvenliği 31
şifreli ortam içeriği için ayar 248
L
label özelliği (NativeMenuItem sınıfı) 141
lastInsertRowID özelliği (SQLResult
sınıfı) 176
lastUserInput özelliği (NativeApplication
sınıfı) 266
Dizin
length özelliği (ByteArray sınıfı) 149
işaretli 81
lineEnding özelliği (File sınıfı) 106
listRootDirectories() yöntemi (File sınıfı) 99
oluşturma 82
mouseDown olayı 69, 123
little-endian bayt sırası 150
seçme 88
mouseMove olayı 123
load olayı 193, 195, 207, 215
tuş eşdeğerleri 80
monitörler
Bkz. ekranlar
load olayları 211
menuItemSelect olayları 80
mouseTarget özelliği (ContextMenuEvent
sınıfı) 83
loadBytes() yöntemi (Loader sınıfı) 39
menüler 77
move olayı 55, 71
Loader sınıfı 61
açılır 81, 87
Loader.loadBytes() yöntemi 39
alt menüler 79, 82
LoaderContext sınıfı
ayırıcı satırlar 83
moveTo() yöntemi
File sınıfı 109
Window nesnesi 54
allowLoadBytesCodeExecution
özelliği 39
bağlam menüleri 83
moveToAsync() yöntemi (File sınıfı) 109
birlikte çalışılacak sınıflar 78
moveToTrash() yöntemi (File sınıfı) 110
applicationDomain özelliği 34
dock 78
securityDomain özelliği 34
dock öğesi 81
moveToTrashAsync() yöntemi (File
sınıfı) 110
LoaderInfo sınıfı
kopyala ve yapıştır komutları 140
childSandboxBridge özelliği 34
öğeler 79
parentSandboxBridge özelliği 34
olay akışı 79, 87
loadString() yöntemi (HTMLLoader
sınıfı) 206
LocalConnection sınıfı 276, 283
locationChange olayı 224
M
Mac OS
araç çubuğu 58
proxy simgeleri 58
mainScreen özelliği (Screen sınıfı) 74
makbuzlar, DRM şifreli içerikle
kullanma 248
moving olayı 71
oluşturma 81
Ň
name öğesi (uygulama tanımlayıcı
dosyası) 44
özel 78
name özelliği (File sınıfı) 108
pencere 81, 89
sistem tepsisi simgeleri 78
activeWindow özelliği 65
sistem tepsisi simgesi 81
addEventListener() yöntemi 257
türleri 78
applicationDescriptor özelliği 264
tuş eşdeğerleri 80
autoExit özelliği 262
uygulama 81
copy() method() 141
varsayılan sistem 78
exit() yöntemi 262
XML, tanımlama 85
getDefaultApplication() yöntemi 265
yapı 78
icon özelliği 92
masaüstü dizini 99
menuSelect olayları 80
id özelliği 264
masaüstü pencereleri
messageHandler özelliği (PDF) 246
idleThreshold özelliği 266
metin
isSetAsDefaultApplication() yöntemi 265
Bkz. pencereler
maximizable öğesi (uygulama tanımlayıcı
dosyası) 46
lastUserInput özelliği 266
publisherID özelliği 264, 285
maximize() yöntemi (NativeWindow
sınıfı) 67
Microsoft authenticode digital ID'ler 285
Microsoft authenticode sertifikaları 285
removeAsDefaultApplication()
yöntemi 265
maxSize öğesi (uygulama tanımlayıcı
dosyası) 46
Microsoft Windows
runtimePatchLevel özelliği 266
menü
olaylar 89
uygulama 89
yapı 79
menü çubukları 79
menü komutları için hızlandırıcı tuşlar 80
menü komutları için tuş eşdeğerleri 80
menü öğeleri 79
anımsatıcı karakterler 80
data, atama 81
durumlar 81
etkin 81
hızlandırıcı tuşlar 80
başlık çubuğu simgeleri 58
MIME türleri
runtimeVersion özelliği 266
setAsDefaultApplication() yöntemi 48
HTML kopyala ve yapıştır 143, 197
startAtLogin özelliği 260
HTML sürükle ve bırak 130
supportsDockIcon özelliği 92
minimizable öğesi (uygulama tanımlayıcı
dosyası) 46
supportsMenu özelliği 89
supportsSystemTrayIcon özelliği 92
minimize() yöntemi (NativeWindow
sınıfı) 67
NativeApplication.setAsDefaultApplication
() yöntemi 265
minimumPatchLevel niteliği (uygulama
tanımlayıcı dosyası) 42
NativeBoundsEvent sınıfı 71
minSize öğesi (uygulama tanımlayıcı
dosyası) 46
nativeDragDrop olayı 123
mnemonicIndex özelliği
modificationDate özelliği (File sınıfı) 108
nativeDragComplete olayı 123, 126, 128
nativeDragEnter olayı 123, 126, 127, 128
Dizin
NativeDragEvent sınıfı
clipboard özelliği 127
type özelliği 56
visible özelliği 60, 65
orderToFront() yöntemi (NativeWindow
sınıfı) 66
dropAction özelliği 126, 127
yapıcı 60
örnek uygulamalar 2
nativeDragExit olayı 123, 128
NativeWindowDisplayStateEvent sınıfı 71
NativeDragManager sınıfı
NativeWindowInitOptions sınıfı 59, 60
acceptDragDrop() yöntemi 123, 127
doDrag() yöntemi 123, 124, 127
nativeDragOver olayı 123, 126, 127, 128
nesne başvuruları
otomatik başlatma (bir AIR uygulamasını
oturum açılırken başlatma) 260
oturum açma, bir AIR uygulamasını
başlatma 260
outerHTML özellikleri 198
özel anahtarlar 310
nativeDragStart olayı 123, 128
nesne değişmezleri (JavaScript'te) 31
özel güncelleme kullanıcı arabirimi 291
nativeDragUpdate olayı 123, 128
nesneleri serileştirme 124
özel krom 56
NativeMenu sınıfı 79, 87
NetStream sınıfı
Özellikler
alt menü özelliği 79
data özelliği 81
keyEquivalent özelliği 80
keyEquivalentModifiers özelliği 80
resetDRMVouchers() yöntemi 250
language özelliği 295
yöntemi 249, 250
languages özelliği 295
Netstream sınıfı
şifreli içerik, oynatma 249
label özelliği 141
normal pencereler 56
mnemonicIndex özelliği 80
NSHumanReadableCopyright alanı (Mac
OS) 45
nativePath özelliği (File sınıfı) 99, 108
nativeWindow özelliği
Stage sınıfı 59, 65
Window nesnesi 192, 199
nativeWindow özelliği (window nesnesi) 54,
61
Ó
OID sütun adı (SQL) 177
olay seç 79, 88, 89
olayı görüntüleme 79, 89
olaylar
P
P12 dosyaları 285
paintsDefaultBackground özelliği
(HTMLLoader sınıfı) 57, 63
Pano
güvenlik 138
Sistem 137
veri formatları 143, 144
parameters özelliği (SQLStatement
sınıfı) 166, 167
activate yöntemi 65
dinleyiciler 227
parametreler, SQL ifadelerinde 167
activate yöntemi() 60
HTML 224
parent özelliği (File sınıfı) 108
activate() yöntemi 66
işleyiciler 227
parent özelliği (window nesnesi) 61
addEventListener() yöntemi 71
menü 79, 87
parentSandboxBridge özelliği
alwaysInFront özelliği 66
LoaderInfo sınıfı 34
başlatma 64
yerel pencereler 55
Window nesnesi 30
close() yöntemi. 67
ölçeklenebilir vektör grafikleri (SVG) 194
dispatchEvent() yöntemi 55
onclick işleyicisi 210
JavaScript erişimi 192
ondominitialize niteliği 201
parentSandboxBridge özelliği (Window
nesnesi) 221
maximize() yöntemi 67
onload işleyicisi 31
PDF
minimize() yöntemi 67
onmouseover işleyicisi 210
olaylar 71
open() yöntemi
Window nesnesi) 200
destek 193, 244
PDF içeriği
orderBehind() yöntemi 66
SQLConnection sınıfı 161
AIR uygulamasına ekleme 244
orderInBackOf() yöntemi 66
Window nesnesi 33, 60, 200
bilinen sınırlamalar 247
orderInFrontOf() yöntemi 66
open() yöntemi (SQLConnection sınıfı) 161
orderToBack() yöntemi 66
openAsync() yöntemi (SQLConnection
sınıfı) 161, 164
orderToFront() yöntemi 66
restore() yöntemi 67
stage özelliği 63
startMove() yöntemi 69
startResize() yöntemi 69
systemChrome özelliği 56
systemMaxSize özelliği 60
systemMinSize özelliği 60
transparent özelliği 56, 57
opener özelliği (window nesnesi) 61
JavaScript iletişimi 245
yükleme 245
pdfCapability özelliği (HTMLLoader
sınıfı) 244
orderBehind() yöntemi (NativeWindow
sınıfı) 66
pencere
orderInBackOf() yöntemi (NativeWindow
sınıfı) 66
pencere menüleri 77, 89
orderInFrontOf() yöntemi (NativeWindow
sınıfı) 66
pencereler
orderToBack() yöntemi (NativeWindow
sınıfı) 66
kapatma 262
oluşturma 81
arka plan 57
başlatma 58
Dizin
boyut 60
boyutu 46
pencereleri yeniden boyutlandırma 46, 55,
69
runtimePatchLevel özelliği
büyütme 46, 55, 67
pencereleri yeniden yükleme 55, 67
çalışılacak sınıflar 54
pencerelerin arka planı 57
runtimeVersion özelliği (NativeApplication
sınıfı) 266
davranış 56
pencerelerin boyutu 46
dikdörtgen olmayan 57
pencerelerin görünümü 56
etkin 65, 66
pencerelerin görünürlüğü 46
etkinleştirme 60
pencerelerin konumu 46
gizleme 65
pencerelerin sırası 66
görüntü sırası 66
PFX dosyaları 285
görünüm 56
playerType özelliği
görünürlük 46
Capabilities sınıfı 266
gösterme 65
position özelliği (ByteArray sınıfı) 149
hafif 56
postMessage() yöntemi (PDF nesnesi) 246
hizmet pencereleri 56
print() yöntemi (Window nesnesi) 194
ilk 54
Program Dosyaları dizini (Windows) 275
kapatma 55, 67
programMenuFolder öğesi (uygulama
tanımlayıcı dosyası) 45
konum 46
krom 56
küçültme 46
maksimum boyut 60
minimum boyut 60
proxy simgeleri
Mac OS 58
publisherid dosyası 264
publisherID özelliği (NativeApplication
sınıfı) 264, 285
normal pencereler 56
olay akışı 55
Š
sanal alan köprüleri 30, 34, 193, 194, 208,
220
sanal alanlar 26, 194, 220, 266
sandboxRoot niteliği (kare ve iframe
öğeleri) 193, 220
sandboxRoot niteliği (kare ve öğeleri) 196,
201
sandboxRoot özelliği
iframe 29
kare 29
sandboxType özelliği
Security sınıfı 266
satırlar (veritabanı) 158, 176
saydam pencereler 46
scaleMode özelliği
Stage sınıfı 69
Screen sınıfı 73
getScreenForRectangle() yöntemi 74
olaylar 71
Ř
readBytes() yöntemi (ByteArray sınıfı) 148
oluşturma 58, 64, 206
readFloat() yöntemi (ByteArray sınıfı) 148
özel krom 56
readInt() yöntemi (ByteArray sınıfı) 148
özellikler 45
readObject() yöntemi (ByteArray sınıfı) 148
sahne ölçek modları 60
saydamlık 46
readUTFBytes() yöntemi (ByteArray
sınıfı) 148
şeffaflık 57
relativize() yöntemi (File sınıfı) 103
security
simge durumuna küçültme 55, 66, 67
sistem kromu 56
removeAsDefaultApplication() yöntemi
Security sınıfı
sıra 66
removeEventListener() yöntemi 228
stil 56
resetDRMVouchers() yöntemi (NetStream
sınıfı) 250
taşıma 55, 69, 74
mainScreen özelliği 74
screens özelliği 74
screens özelliği (Screen sınıfı) 74
screenX özelliği (HTML drag olayları) 130
screenY özelliği (HTML drag olayları) 130
scroll olayı 224
window.open() 33
allowDomain() yöntemi 34, 38
sandboxType özelliği 266
securityDomain özelliği
(BrowserInvokeEvent sınıfı) 261
türler 56
resizable öğesi (uygulama tanımlayıcı
dosyası) 46
yeniden boyutlandırma 46, 55, 69
resize olayı 55, 71
yeniden yükleme 55, 67
SELECT ifadesi (SQL) 169, 181
resizing olayı 71
yönetme 65
senkronize olmayan programlama
resolvePath() yöntemi (File sınıfı) 99
pencereleri büyütme 46, 55, 67
dosya sistemi 97
Responder sınıfı 166, 176
pencereleri etkinleştirme 60, 66
veritabanları 160, 164, 181
restore() yöntemi (NativeWindow sınıfı) 67
pencereleri gizleme 65
result olayı 166
pencereleri gösterme 65
ROWID sütun adı (SQL) 177
pencereleri kapatma 55, 67, 262
dosya sistemi 97
_ROWID_ sütun adı (SQL) 177
pencereleri küçültme 46
veritabanları 160, 164, 181
runtime özelliği (Window nesnesi) 61, 192,
199, 211
pencereleri simge durumuna küçültme 55,
66, 67
pencereleri sıralama 66
pencereleri taşıma 55, 69
runtimeApplicationDomain özelliği
(HTMLLoader sınıfı) 214
şeffaf pencereler 57
XMLHttpRequests 211
senkronize programlama
XMLHttpRequests 211
separator özelliği (File sınıfı) 106
Dizin
serileştirilmiş nesneler
size özelliği (File sınıfı) 108
SQLTransactionLockType sınıfı 159
soru işareti (?) karakter, adlandırılmamış
SQL parametrelerinde 168
SQLTriggerSchema sınıfı 159
sertifika iptal listesi (CRL) 288
spaceAvailable özelliği (File sınıfı) 105
SQLViewSchema sınıfı 159
sertifika uygulama bildirimi (CPS) 288
SQL
stage özelliği
sertifika yetkilileri (CA'lar) 284
sertifikalar
adlandırılmamış parametreler
(ifadelerde) 168
SQLUpdateEvent sınıfı 159
Stage sınıfı
ADT komut satırı seçenekleri 310
adlandırılmış parametreler
(ifadelerde) 167
AIR dosyalarını imzalama 284
AUTOINCREMENT sütunları 177
addChildAt() yöntemi 63
değiştirme 287, 312
CREATE TABLE ifadesi 162
displayState özelliği 72
formatlar 285
DELETE ifadesi 177
nativeWindow özelliği 59, 65
geçiş 287, 312
hakkında 159
addChild() yöntemi 63
scaleMode özelliği 60, 69
kod imzalama 40
ifadeler 165, 166
StageDisplayState sınıfı 72
süresi dolan 285
ifadelerdeki parametreler 167
StageScaleMode sınıfı 60, 69
yetkililer (CA'lar) 40
INSERT ifadesi 181
zincirler 288
INTEGER PRIMARY KEY sütunları 177
startAtLogin özelliği (NativeApplication
sınıfı) 260
setAsDefaultApplication() yöntemi
(NativeApplication sınıfı) 48, 265
setData() yöntemi
ClipboadData nesnesi 197
Clipboard yöntemi 145
DataTransfer nesnesi 130, 132, 198
setDataHandler() yöntemi (Clipboard
sınıfı) 145
setDragImage() yöntemi (bir HTML drag
olayının dataTransfer özelliğine
ait) 130
yöntemi (NetStream sınıfı) 249, 250
kullanılan sınıflar 159
OID sütun adı 177
startMove() yöntemi (NativeWindow
sınıfı) 69
ROWID sütun adı 177
startResize() yöntemi (NativeWindow
sınıfı) 69
_ROWID_ sütun adı 177
StatusEvent sınıfı 249
SELECT ifadesi 169, 181
stil sayfaları, HTML
UPDATE ifadesi 177
veri türleme 168, 181
SQLCollationType sınıfı 159
SQLColumnNameStyle sınıfı 159
sqlConnection özelliği (SQLStatement
sınıfı) 166
SQLConnection sınıfı 159
ActionScript'te değiştirme 218
styleSheets özelliği (Document nesnesi) 218
subErrorID özelliği (DRMErrorEvent
sınıfı) 254
Sun Java signing digital ID'ler 285
supportsDockIcon özelliği
setInterval() işlevi 32, 200, 209
attach() yöntemi 178
setTimeout() işlevi 32, 200, 209
open yöntemi 161
Shift tuşu 80
open() yöntemi 161
supportsSystemTrayIcon özelliği
openAsync() yöntemi 161, 164
sürükle ve bırak
şifreleme 248
şifreler
supportsMenu özelliği (NativeApplication
sınıfı) 89
SQLError sınıfı 159, 166
aktarım formatları 122
SQLErrorEvent sınıfı 159, 166
şifreli veriler, saklama ve alma 189
değiştirici tuşlar 127
SQLEvent sınıfı 159
şifreli verileri güçlü ciltleme 189
Flex desteği 124
SQLIndexSchema sınıfı 159
simgeler
hareketler 122
SQLLite veritabanı desteği 157
HTML 128, 198
şifreli ortam içeriği için ayar 248
dock 92, 93
Ayrıca bkz. veritabanları
HTML'de varsayılan davranış 129
görev çubuğu 66, 92
SQLMode sınıfı 159, 165
görüntüler 92
HTML'deki olaylar 129
SQLResult sınıfı 159
hareketlendirme 92
ilgili sınıflar 122
SQLSchemaResult sınıfı 159
kaldırma 92
imleç efektleri 127, 131
SQLStatement sınıfı 159, 165
uygulama dışı sanal alan içeriğine
(HTML'de) 135
sistem tepsisi 92
execute yöntemi 167
uygulama 47
execute() yöntemi 169, 176
sürükleme sırasında fare konumu 128
getResult() yöntemi 176
sürümler, AIR uygulaması 266
parameters nesnesi 166
sütunlar (veritabanı) 158
parameters özelliği 167
SWF dosyaları
sistem kromu 56
HTML pencereleri 60
sistem tepsisi simgeleri 78, 81
destek 92
sistemde oturum açma, bir AIR
uygulamasını başlatma 260
sqlConnection özelliği 166
text özelliği 166, 167, 169, 177
SQLTableSchema sınıfı 159
komut dosyası etiketi yoluyla
yükleme 216
Dizin
SWF içeriği
url özelliği (File sınıfı) 99
çoklu, çalışma 178
HTML'de 193
URL şemaları 103
dosyalar 158
HTML'nin üzerini kaplama 62
URL'ler 212
güvenlik 168
systemChrome özelliği (NativeWindow
sınıfı) 56
hakkında 158
kullanımlar 158
systemMaxSize özelliği (NativeWindow
sınıfı) 60
URLs
systemMinSize özelliği (NativeWindow
özelliği) 60
URLStream sınıfı 195
satır kimlikleri 177
userDirectory özelliği (File sınıfı) 99
satırlar 158
userIdle olayı 266
senkronize mod 160
userPresent olayı 266
senkronize olmayan mod 160
uyg. depolama URL şeması 103
sütunlar 158
tam ekran pencereler 72
uyg. URL şeması 103, 194
tablolar 158, 162
tanımlama bilgileri 197
uygulama depolama dizini 25, 99, 103, 212
veri alma 169
tarayıcı başlatma özelliği 47, 260
uygulama depolama URL şeması 25
veri türleme 168, 181
teknik destek 9
uygulama dizini 99
verileri değiştirme 177
text özelliği (SQLStatement sınıfı) 166, 167,
169, 177
uygulama dışı sanal alanlar 28, 135, 194, 207,
208, 220
verileri silme 177
TextField sınıfı
uygulama kimlikleri 43
Ť
tablolar (veritabanı) 158
oluşturma 162
HTML yükleme yeri 206
img etiketleri 28
Thawte sertifikaları 284, 285
title öğesi (uygulama tanımlayıcı dosyası) 46
tost stili pencereler 66
transparent öğesi (uygulama tanımlayıcı
dosyası) 46
HTML içeriği yükleme 206
uygulama menüleri 77, 89
oluşturma 81
uygulama olmayan sanal alanlar 193
uygulama sanal alanı 26, 193, 194, 206, 207,
208, 210, 220, 266
uygulama tanımlayıcı dosyası 41
oluşturma 161
performans 168
yapı 158
version öğesi (uygulama tanımlayıcı
dosyası) 43
video içeriğini şifreleme 248
visible öğesi (uygulama tanımlayıcı
dosyası) 46
visible özelliği
NativeWindow sınıfı 60, 65
uygulama tanımlayıcı özelliği
okuma 264
W
web tarayıcıları
transparent özelliği (NativeWindow
sınıfı) 56, 57
uygulamalar
type özelliği (File sınıfı) 108
uygulamaları çevirme 294
AIR uygulamalarını başlatma 282
type özelliği (NativeWindow sınıfı) 56
uygulamaları kapatma 262
AIR uygulamalarını yükleme 281
types özelliği
uzak sanal alanlar 26, 194
AIR uygulamasının yüklenip
yüklenmediğini saptama 281
DataTransfer nesnesi 198
HTML copy-and-paste olayı 139
Bkz. AIR uygulamaları
uzantılar (dosya), AIR uygulamasıyla
ilişkili 265
AIR çalışma zamanını saptama 280
bir AIR uygulamasını başlatma 260
WebKit 191, 193, 204
HTML drag olayı 130
types özelliği (DataTransfer nesnesi) 133
V
veri doğrulaması, uygulama başlatma 261
-webkit-border-horizontal-spacing CSS
özelliği 204
Ú
uncaughtScriptExcpetion olayı 224
veri formatları, Pano 143
-webkit-border-vertical-spacing CSS
özelliği 204
uncompress() yöntemi (ByteArray
sınıfı) 151
veri türleri, veritabanı 181
verileri sıkıştırma 151
-webkit-margin-bottom-collapse CSS
özelliği 204
unload olayları 199
Verisign sertifikaları 284, 285
-webkit-margin-collapse CSS özelliği 204
UntrustedAppInstallDisabled (Windows
kayıt defteri ayarları) 26
veritabanı
-webkit-margin-start CSS özelliği 204
UPDATE ifadesi (SQL) 177
veri şifreleme 189
hatalar 178
kullanılan sınıflar 159
-webkit-line-break CSS özelliği 204
-webkit-margin-top-collapse CSS
özelliği 204
update() yöntemi (Updater sınıfı) 290
veritabanına bağlanma 164
-webkit-nbsp-mode CSS özelliği 204
UpdateDisabled (Windows kayıt defteri
ayarları) 26
veritabanları
-webkit-padding-start CSS özelliği 204
Updater sınıfı 290
url özelliği
File sınıfı 99, 108
alanlar 158
-webkit-rtl-ordering CSS özelliği 204
ana anahtarlar 176, 177
-webkit-text-fill-color CSS özelliği 204
bağlanma 164
-webkit-text-security CSS özelliği 205
bellek içi 161
Dizin
-webkit-user-drag CSS özelliği 129, 205, 132
-webkit-user-modify CSS özelliği 205
Y
y öğesi (uygulama tanımlayıcı dosyası) 46
-webkit-user-select CSS özelliği 129, 132,
205
yama düzeyleri
width öğesi (uygulama tanımlayıcı
dosyası) 46
yama düzeyleri, AIR çalışma zamanı 42
width özelliği (HTMLLoader sınıfı) 206
Window nesnesi
childSandboxBridge özelliği 30
close() yöntemi 54
htmlLoader nesnesi 192
htmlLoader özelliği 61, 200, 206
moveTo() yöntemi 54
nativeWindow nesnesi 192
nativeWindow özelliği 54, 61, 199
open yöntemi 200
open() yöntemi 33, 60
opener özelliği 61
parent özelliği 61
parentSandboxBridge özelliği 30, 200, 221
print() yöntemi 194
runtime özelliği 28, 32, 61, 192, 199, 211
Window sınıfı 53
WindowedApplication sınıfı 53
windows 53
Windows kayıt defteri ayarları 26
write() yöntemi (Document nesnesi) 198,
211
writeBytes() yöntemi (ByteArray sınıfı) 148
writeFloat() yöntemi (ByteArray sınıfı) 148
writeInt() yöntemi (ByteArray sınıfı) 148
writeln() yöntemi (Document nesnesi) 198,
211
writeObject() yöntemi (ByteArray
sınıfı) 148
writeUTFBytes() yöntemi (ByteArray
sınıfı) 148
X
x öğesi (uygulama tanımlayıcı dosyası) 46
XML
menü tanımlama yolu 85
sınıf 212
XML ad alanı (uygulama tanımlayıcı
dosyası) 42
XMLHttpRequest nesnesi 33, 195, 201, 211
XMLList sınıfı 212
xmlns (uygulama tanımlayıcı dosyası) 42
yayıncı adı 284
yayıncı kimlikleri 264, 285
yazdırma 194
yerel ayarlar, bir uygulama için seçme 295
yerel güvenilir sanal alan 26, 194
yerel menüler
Bkz. menüler
yerel pencereler
Bkz. pencereler
yerel veritabanları
Bkz. veritabanları
yerelleştirme 294
yol sınırlayıcı (dosya sistemi) 101
yollar (dosya ve dizin) 103
yollar, göreceli 103
yükleme
Ž
zaman damgaları 285
zengin internet uygulamaları (RIA'lar) 7
ZIP dosyası formatı 153
ZLIB sıkıştırma 151

Yardım PDF`sini İndir

Transkript

Benzer belgeler

Teknik Sorunlar SSS

Başlıca Programlar

EZOFLASH D2 ADAPTER_V001A

Adobe Genel Kullanım Şartlarına ilişkin Yazılım Şartları

E-Kitap ve Sayısal Hak Yönetimi (Digital Rights Management)

Kaynaklar - BITEFO FETHIYE 2007

Tam Metin(URL)

Yardım PDF`sini İndir

Adobe® Media Encoder CS4`ü kullanma

Adobe - Flash Dersleri