Uygulama tanımlayıcı dosyasında temel uygulama özelliklerini ayarlayın. Bu bölüm, masaüstü AIR uygulamaları ile ilgili özellikleri kapsar. Uygulama tanımlayıcı dosyasının öğeleri
AIR uygulama tanımlayıcı dosyaları
bölümünde tam olarak açıklanmıştır.
Gerekli AIR çalışma zamanı sürümü
Uygulama tanımlayıcı dosyasının ad alanını kullanarak uygulamanızın gerektirdiği AIR çalışma zamanı sürümünü belirtin.
application
öğesinde atanan ad alanı büyük bir bölümünde uygulamanızın hangi özellikleri kullandığını belirler. Örneğin, uygulamanız AIR 1.5 ad alanını kullanıyorsa ve kullanıcı AIR 3.0'ı yüklemişse uygulamanız AIR 1.5 davranışını görür (davranış AIR 3.0'da değişmiş olsa bile). Yalnızca ad alanını değiştirdiğinizde ve bir güncelleme yayınladığınızda uygulamanız yeni davranışa ve özelliklere erişir. Güvenlik ve WebKit değişiklikleri bu ilkedeki birincil istisnalardır.
Ad alanını kök
application
öğesinin xmlns niteliğini kullanarak belirtin:
<application xmlns="http://ns.adobe.com/air/application/3.0">
Uygulama kimliği
Yayınladığınız her uygulama için birkaç ayar benzersiz olmalıdır. Benzersiz ayarlar, kimliği, adı ve dosya adını içerir.
<id>com.example.MyApplication</id>
<name>My Application</name>
<filename>MyApplication</filename>
Uygulama sürümü
AIR 2.5'ten önceki AIR sürümlerinde uygulamayı
version
öğesinde belirtin. Herhangi bir dizeyi kullanabilirsiniz. AIR çalışma zamanı dizeyi yorumlamaz; “2.0”, “1.0” sürümünden daha yüksek bir sürüm olarak algılanmaz.
<!-- AIR 2 or earlier -->
<version>1.23 Beta 7</version>
AIR 2.5 ve üstünde, uygulama sürümünü
versionNumber
öğesinde belirtin.
version
öğesi artık kullanılamaz.
versionNumber
öğesi için bir değer belirtirken, noktalarla ayrılmış üç numaraya kadar sayı içerebilen, şunun gibi bir sıralama kullanmalısınız: “0.1.2”. Sürüm numarasının her bir parçası en fazla üç basamak içerebilir. (Başka bir deyişle, "999.999.999" izin verilen en büyük sürüm sayısıdır.) Sayıda tüm parçaları içermeniz gerekmez; “1” ve “1.0” örnekleri de geçerli sayılardır.
Ayrıca
versionLabel
öğesini kullanan sürüm için de bir etiket belirtebilirsiniz. Bir sürüm etiketi eklediğinizde, AIR uygulaması yükleyicisi iletişim kutuları gibi yerlerde sürüm numarasının yerine görüntülenir.
<!-- AIR 2.5 and later -->
<versionNumber>1.23.7<versionNumber>
<versionLabel>1.23 Beta 7</versionLabel>
Ana pencere özellikleri
AIR masaüstünde bir uygulama başlattığında, bir pencere oluşturur ve bu pencereye ana SWF dosyasını veya HTML sayfası yükler. AIR, bu uygulama başlangıç penceresinin ilk görünümünü ve davranışını denetlemek için
initialWindow
öğesinin alt öğelerini kullanır.
-
content
—
initalWindow
öğesinin
content
alt öğesindeki ana uygulama SWF dosyası. Masaüstü profilinde aygıtları hedeflediğinizde SWF veya HTML dosyası kullanabilirsiniz.
<initialWindow>
<content>MyApplication.swf</content>
</initialWindow>
Dosyayı AIR paketine dahil etmeniz gerekir (ADT veya IDE'nizi kullanarak) Uygulama tanımlayıcısında ada başvurmak dosyanın otomatik olarak pakete dahil olmasını sağlamaz.
-
depthAndStencil
— Derinlik veya şablon arabelleğini kullanmayı belirtir. Genelde 3B içeriği ile çalışırken bu arabellekleri kullanırsınız.
<depthAndStencil>true</depthAndStencil>
-
height
— İlk pencerenin yüksekliği.
-
maximizable
— Pencerenin ekranı kaplaması için sistem kromunun gösterilip gösterilmediği.
-
maxSize
— İzin verilen maksimum boyut.
-
minimizable
— Pencereyi simge durumuna getirmek için sistem kromunun gösterilip gösterilmediği.
-
minSize
— İzin verilen minimum boyut.
-
renderMode
— AIR 3 veya üst sürümünde masaüstü uygulamaları için oluşturma modu
auto
,
cpu
,
direct
veya
gpu
olarak ayarlanabilir. AIR uygulamasının daha önceki sürümlerinde bu ayar masaüstü platformlarında yoksayılır. renderMode ayarı çalışma zamanında değiştirilemez.
-
auto — aslında cpu modu ile aynıdır.
-
cpu — görüntüleme nesneleri yazılımda görüntüleme belleğinde oluşturulur ve buraya kopyalanır. StageVideo, yalnızca bir pencerenin tam ekran modunda olması durumunda kullanılabilir. Stage3D, yazılım oluşturucusunu kullanır.
-
direct — görüntüleme nesneleri çalışma zamanı yazılımı tarafından oluşturulur, ancak oluşturulan çerçevenin görüntü belleğine kopyalanması (doldurarak oluşturma işlemi) donanımsal olarak hızlandırılır. StageVideo kullanılabilir. Diğer türlüsü mümkünse Stage3D donanım hızlandırmayı kullanır. Pencere saydamlığı true olarak ayarlandığında pencere yazılım oluşturma ve doldurarak oluşturma işlemine "geri döner".
Not:
Mobil platformlar için AIR ile Flash içeriğinin GPU hızlandırmasını desteklemek üzere Adobe, renderMode="gpu" yerine renderMode="direct" (yani Stage3D) kullanmanızı önerir. Adobe resmi olarak şu Stage3D tabanlı çerçeveleri desteklemekte ve önermektedir: Starling (2D) ve Away3D (3D). Stage3D ve Starling/Away3D hakkında daha fazla ayrıntı için bkz.
http://gaming.adobe.com/getstarted/
.
-
gpu — varsa donanım hızlandırma kullanılır.
-
requestedDisplayResolution
— Uygulamanız, yüksek çözünürlüklü ekranlara sahip MacBook Pro bilgisayarlarda
standart
çözünürlük modunu mu yoksa
yüksek
çözünürlük modunu mu kullanmalıdır? Diğer tüm platformlarda değer yoksayılır. Değer
standart
ise, her bir sahne alanı pikseli ekranda dört piksel olarak oluşturulur. Değer
yüksek
ise, her bir sahne alanı pikseli ekranda tek bir fiziksel piksele karşılık gelir. Belirtilen değer tüm uygulama pencerelerinde kullanılır. AIR 3.6 ve üst sürümlerinde,
requestedDisplayResolution
öğesi masaüstü AIR uygulamaları (
intialWindow
öğesinin alt öğesi olarak) için kullanılabilir.
-
resizable
— Pencereyi yeniden boyutlandırmak için sistem kromunun gösterilip gösterilmediği.
-
systemChrome
— Standart işletim sistemi pencere görünümünün kullanılıp kullanılmadığı. Bir pencerenin systemChrome ayarı çalışma zamanında değiştirilemez.
-
title
— Pencerenin başlığı.
-
transparent
— Pencerenin arka planla alfa karışımlı olup olmadığı. Saydamlık açıksa pencere sistem kromunu kullanamaz. Bir pencerenin saydamlık ayarı çalışma zamanında değiştirilemez.
-
visible
— Pencerenin oluşturulur oluşturulmaz görünür olup olmadığı. Varsayılan olarak, uygulamanızın kendini görünür yapmadan önce içeriğini çizmesine zaman tanımak için pencere ilk başta görünür olmaz.
-
width
— Pencerenin genişliği.
-
x
— Pencerenin yatay konumu.
-
y
— Pencerenin dikey konumu.
Masaüstü özellikleri
Aşağıdaki öğeler, masaüstü yüklemesini ve güncelleme özelliklerini kontrol eder.
-
customUpdateUI — Uygulamayı güncellemek için kendi iletişim kutularınızı sağlamanıza izin verir. Varsayılan
false
olarak ayarlanırsa, standart AIR iletişim kutuları kullanılır.
-
fileTypes — Uygulamanızın varsayılan açılış uygulaması olarak kaydetmek isteyeceği dosya türlerini belirtir. Bir dosya türü için başka bir uygulama zaten varsayılan açıcı olarak ayarlanmışsa, AIR mevcut kaydı geçersiz kılmaz. Ancak, uygulamanız NativeApplication nesnesinin
setAsDefaultApplication()
yöntemini kullanarak çalışma zamanında kaydı geçersiz kılabilir. Varolan dosya türü ilişkilerini geçersiz kılmadan önce kullanıcının iznini istemek uygun bir davranıştır.
Not:
Bir uygulamayı sabit çalışma zamanı paketi olarak paketlediğinizde (
-bundle
hedefini kullanarak) dosya türü kaydı yoksayılır. Verilen bir dosya türünü kaydetmek için kaydı uygulayan bir yükleyici programı oluşturmalısınız.
-
installFolder — Uygulamanın yüklü olduğu standart uygulama yükleme klasörüne göre bir yol belirtir. Bu ayarı ortak bir klasörde birden fazla uygulamayı gruplamanın yanı sıra özel bir klasör adı sağlamak için de kullanabilirsiniz.
-
programMenuFolder — Windows Tüm Programlar menüsü için menü hiyerarşisini belirtir. Bu ayarı birden fazla uygulamayı ortak bir menüde gruplamak için kullanabilirsiniz. Hiçbir menü klasörü belirtilmemişse, uygulama kısayolu doğrudan ana menüye eklenir.
Desteklenen profiller
Uygulamanız yalnızca masaüstü için uygunsa, profili desteklenen profiller listesinden hariç tutarak başka profil kullanan aygıtlarda yüklenmesini engelleyebilirsiniz. Uygulamanız NativeProcess sınıfını veya yerel uzantıları kullanıyorsa
extendedDesktop
profilini desteklemeniz gerekir.
supportedProfile
öğesini uygulama tanımlayıcısının dışında bırakırsanız, uygulamanızın tanımlanan tüm profilleri desteklediği varsayılır. Uygulamanızı belirli bir profil listesiyle sınırlandırmak için profilleri boşlukla ayırarak listeleyin:
<supportedProfiles>desktop extendedDesktop</supportedProfiles>
desktop
ve
extendedDesktop
profillerinde desteklenen ActionScript sınıflarının bir listesi için bkz.
Farklı profillerin yetenekleri
.
Gerekli yerel uzantılar
extendedDesktop
profilini destekleyen uygulamalar yerel uzantıları kullanabilir.
AIR uygulamasının uygulama tanımlayıcısında kullandığı tüm yerel uzantıları bildirin. Aşağıdaki örnek, gerekli iki yerel uzantıyı belirtmeye yönelik sözdizimini gösterir:
<extensions>
<extensionID>com.example.extendedFeature</extensionID>
<extensionID>com.example.anotherFeature</extensionID>
</extensions>
extensionID
öğesi uzantı tanımlayıcı dosyasındaki
id
öğesiyle aynı değere sahiptir. Uzantı tanımlayıcı dosyası extension.xml adlı bir XML dosyasıdır. Bu sözdizimi yerel uzantı geliştiricisinden aldığınız ANE dosyasında paketlenir.
Uygulama simgeleri
Masaüstünde, uygulama tanımlayıcısında belirtilen simgeler uygulama dosyası, kısayol ve program menüsü simgeleri olarak kullanılır. Uygulama simgesi, 16x16, 32x32, 48x48 ve 128x128 piksel PNG görüntüleri kümesi olarak sağlanmalıdır. Uygulama tanımlayıcı dosyasının simge öğesinde simge dosyalarının yolunu belirtin:
<icon>
<image16x16>assets/icon16.png</image16x16>
<image32x32>assets/icon32.png</image32x32>
<image48x48>assets/icon48.png</image48x48>
<image128x128>assets/icon128.png</image128x128>
</icon>
Belirli bir boyutta bir simge sağlamazsanız, bir sonraki en büyük boyuttaki simge kullanılır ve sığması için ölçeklenir. Hiçbir simge belirtmezseniz, varsayılan sistem simgesi kullanılır.
Yoksayılan ayarlar
Masaüstündeki uygulamalar mobil profil özellikleri için geçerli olan uygulama ayarlarını yok sayar. Yoksayılan ayarlar şunlardır:
|
|
|