Masaüstü uygulama özelliklerini ayarlama

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:

  • android

  • aspectRatio

  • autoOrients

  • fullScreen

  • iPhone

  • renderMode (AIR 3 öncesinde)

  • requestedDisplayResolution

  • softKeyboardBehavior