Adobe AIR için yerel uzantıları kullanma

Yerel uzantı geliştiricileri bir ANE dosyasına yerel uzantı paketlerler. ANE dosyası yerel uzantı için gerekli kütüphaneleri ve kaynakları içeren bir arşiv dosyasıdır.

Bazı aygıtlar için ANE dosyasının, yerel uzantının kullandığı yerel kod kütüphanesini içerdiğini unutmayın. Ancak diğer aygıtlar için yerel kod kütüphanesi aygıta yüklüdür. Bazı durumlarda yerel uzantıda belirli bir aygıt için hiçbir yerel kod yoktur. Yerel uzantı yalnızca ActionScript ile uygulanır.

AIR uygulama geliştiricisi olarak ANE dosyasını aşağıdaki gibi kullanırsınız:

ActionScript 3.0 bir NativeProcess sınıfı sağlar. Bu sınıf, bir AIR uygulamasının ana bilgisayar işletim sisteminde yerel işlemleri çalıştırmasını sağlar. Bu özellik platforma özgü özelliklere ve kütüphanelere erişim sağlayan yerel uzantılara benzer. Yerel uzantı kullanmak yerine NativeProcess sınıfını kullanmaya karar verirken aşağıdakileri göz önünde bulundurun:

• Yalnızca extendedDesktop AIR profili NativeProcess sınıfını destekler. Bu nedenle, mobileDevice ve extendedMobileDevice AIR profillerine sahip uygulamalar için yerel uzantılar tek seçenektir.

• Yerel uzantı geliştiricileri çoğunlukla çeşitli platformlar için yerel uygulamalar sağlar, ancak sağladıkları ActionScript API platformlar arasında genelde aynıdır. NativeProcess sınıfını kullanırken yerel işlemi başlatacak ActionScript kodu farklı platformlar arasında değişebilir.

• NativeProcess sınıfı ayrı bir işlem başlatırken yerel bir uzantı AIR uygulamasıyla aynı işlemde çalışır. Bu nedenle, kod çökmesi konusunda kaygılanıyorsanız NativeProcess sınıfını kullanmak daha güvenlidir. Ancak ayrı işlem, büyük olasılıkla uygulamanız gereken işlemler arası iletişim işlemesine sahip olduğunuz anlamına gelmektedir.

Bir SWC dosyası arşiv biçimindeki bir ActionScript sınıfı kütüphanesidir. SWC dosyası bir SWF dosyasını ve diğer kaynak dosyaları içerir. SWC dosyası bireysel ActionScript kodunu ve kaynak dosyaları paylaşma yerine ActionScript sınıflarını paylaşmaya yönelik uygun bir yöntemdir.

Yerel bir uzantı paketi bir ANE dosyasıdır. Bir SWC dosyası gibi bir ANE dosyası da SWF dosyasını ve arşiv biçimindeki diğer dosyaları içeren bir ActionScript sınıfı kütüphanesidir. Ancak, bir ANE dosyası ve bir SWC dosyası arasındaki en önemli fark yalnızca bir ANE dosyasının yerel bir kod kütüphanesi içerebileceğidir.

AIR 3'ten itibaren, uygulamalarda aşağıdaki aygıtlar için yerel uzantılar kullanabilirsiniz:

Çoğunlukla aynı yerel uzantı birden çok platformu hedefler. Uzantının ANE dosyası desteklenen her platform için ActionScript ve yerel kütüphaneleri içerir. Genelde ActionScript kütüphanelerinde tüm platformlar için ortak arabirimler bulunur. Yerel kütüphaneler mutlaka farklıdır.

Bazen yerel bir uzantı varsayılan bir platformu destekler. Varsayılan platform uygulamasında yalnızca ActionScript kodu bulunur, ancak yerel kod bulunmaz. Uzantının özel olarak desteklemediği bir platform için bir uygulama paketlerseniz, uygulama yürütüldüğünde varsayılan uygulamayı kullanır. Örneğin, yalnızca mobil aygıtlara uygulanan bir özellik sağlayan bir uzantı düşünün. Uzantı, bir masaüstü uygulamasının özelliğin benzetimini yapmak için kullanabileceği varsayılan bir uygulama da sağlayabilir.

Aşağıdaki AIR profilleri yerel uzantıları destekler:

Uygulamanızda yerel bir uzantı kullanmak için aşağıdaki görevleri uygulayın:

1. Uygulama tanımlayıcı dosyanızdaki uzantıyı bildirin.

2. ANE dosyasını uygulamanızın kütüphane yoluna ekleyin.

3. Uygulamayı paketleyin.

Tüm AIR uygulamalarında bir uygulama tanımlayıcı dosyası bulunur. Uygulama yerel bir uzantı kullandığında, uygulama tanımlayıcı dosyası bir <extensions> öğesi içerir. Örneğin:

<extensions> 
    <extensionID>com.example.Extension1</extensionID> 
    <extensionID>com.example.Extension2</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 dosya ANE dosyasında paketlenir. Uzantı extension.xml dosyasına bakmak için bir arşiv çıkarma aracı kullanabilirsiniz.

Yerel bir uzantı kullanan bir uygulamayı derlemek için ANE dosyasını kütüphane yolunuza dahil edin.

Yerel uzantılar kullanan bir uygulamayı paketlemek için ADT kullanın. Flash Professional CS5.5 veya Flash Builder 4.5.1 kullanarak uygulamayı paketleyemezsiniz.

ADT kullanma hakkında ayrıntılar AIR Geliştirici Aracı (ADT) sayfasında yer almaktadır.

Örneğin, aşağıdaki ADT komutu yerel uzantılar kullanan bir uygulama için bir DMG dosyası (Mac OS X için yerel bir yükleyici dosyası) oluşturur:

adt -package 
    -storetype pkcs12 
    -keystore myCert.pfx 
    -target native 
    myApp.dmg 
    application.xml 
    index.html resources 
    -extdir extensionsDir

adt -package 
    -target apk 
    -storetype pkcs12 -keystore ../codesign.p12 
    myApp.apk 
    myApp-app.xml 
    myApp.swf icons 
    -extdir extensionsDir

Aşağıdaki komut bir iPhone uygulaması için bir iOS paketi oluşturur:

adt -package 
    -target ipa-ad-hoc 
    -storetype pkcs12 -keystore ../AppleDistribution.p12 
    -provisioning-profile AppleDistribution.mobileprofile 
    myApp.ipa 
    myApp-app.xml 
    myApp.swf icons Default.png 
    -extdir extensionsDir

Aşağıdakileri unutmayın:

• Yerel bir yükleyici paket türü kullanın.

• Uzantı dizinini belirtin.

• ANE dosyasının uygulamanın hedef aygıtını desteklediğinden emin olun.