AIR SDK ile ilk HTML tabanlı AIR uygulamanızı oluşturma

Adobe® AIR®'in nasıl çalıştığıyla ilgili hızlı ve etkin bir örnek olarak, basit bir HTML tabanlı AIR "Hello World" uygulaması oluşturup paketlemek için bu talimatları kullanın.

Başlamak için, çalışma zamanını yüklemiş ve AIR SDK'yi kurmuş olmanız gerekir. Bu eğitimde AIR Hata Ayıklama Başlatıcısı (ADL) ve AIR Geliştirme Aracı'nı (ADT) kullanırsınız. ADL ve ADT komut satırı yardımcı programlardır ve AIR SDK'nin bin dizininde bulunabilir (bkz. AIR SDK’yi yükleme). Bu eğitim komut satırından program çalıştırmayı ve işletim sisteminiz için gerekli yol ortam değişkenlerinin nasıl kurulacağını bildiğinizi varsayar.

Not: Adobe ® Dreamweaver® kullanıcısıysanız, İlk HTML tabanlı AIR uygulamanızı Dreamweaver ile oluşturun bölümünü okuyun.
Not: HTML tabanlı AIR uygulamaları yalnızca masaüstü ve extendedDesktop profilleri için geliştirilebilir. Mobil ve tv profilleri desteklenmez.

    Proje dosyalarını oluştur

    Her HTML tabanlı AIR projesi şu iki dosyayı içermelidir: uygulama meta verisini belirleyen bir uygulama tanımlayıcı dosyası ve bir üst düzey HTML sayfası. Bu gerekli dosyalara ek olarak, bu proje AIR API sınıflarına ilişkin uygun takma ad değişkenlerini tanımlayan bir AIRAliases.js adlı bir JavaScript kod dosyası içerir.

    1. Proje dosyalarını içerecek bir HelloWorld dizini oluşturun.

    2. HelloWorld-app.xml adlı bir XML dosyası oluşturun.

    3. HelloWorld.html adlı bir HTML dosyası oluşturun.

    4. AIRAliases.js dosyasını AIR SDK'nin çerçeveler klasöründen proje dizinine kopyalayın.

    AIR uygulaması tanımlayıcı dosyasını oluşturun.

    AIR uygulamanızı oluşturmaya başlarken, aşağıdaki yapıda bir XML uygulama tanımlayıcı dosyası oluşturun.

    <application xmlns="..."> 
    <id>…</id> 
    <versionNumber>…</versionNumber> 
    <filename>…</filename> 
    <initialWindow> 
        <content>…</content> 
        <visible>…</visible> 
        <width>…</width> 
        <height>…</height> 
    </initialWindow> 
</application>

    1. Düzenlenecek HelloWorld-app.xml dosyasını açın.

    2. AIR ad alanı niteliğini dahil ederek kök <application> öğesini ekleyin.

      <application xmlns="http://ns.adobe.com/air/application/2.6"> Ad alanının son bölmesi olan “2.6”, uygulama için gerekli çalışma zamanının sürümünü belirtir.

    3. <id> öğesini ekleyin:

      <id>examples.html.HelloWorld</id> Uygulama kimliği uygulamanızı benzersiz şekilde (AIR'nin uygulama paketini imzalamak için kullanılan sertifikadan türettiği) yayıncı kimliğiyle birlikte tanımlar. Uygulama kimliği; yükleme, özel uygulama dosya sistemi deposu dizinine erişim, özel şifrelenmiş depoya erişim ve uygulamalar arası iletişim için kullanılır.

    4. <versionNumber> öğesini ekleyin:

      <versionNumber>0.1</versionNumber> Kullanıcıların uygulamanızın hangi sürümünü yüklediklerini belirlemelerine yardımcı olur.

    5. <filename> öğesini ekleyin:

      <filename>HelloWorld</filename> İşletim sisteminde uygulama çalıştırılabilir dosyası, yükleme dizini ve diğer uygulama başvuruları için kullanılan ad.

    6. İlk uygulama pencerenizin özelliklerini belirlemek için aşağıdaki alt öğeleri içeren <initialWindow> öğesini ekleyin.

      <content>HelloWorld.html</content> AIR'in yükleyeceği kök HTML dosyasını tanımlar.

      <visible>true</visible> Pencereyi hemen görünür hale getirir.

      <width>400</width> Pencere genişliğini ayarlar (piksel biriminde).

      <height>200</height> Pencere yüksekliğini ayarlar.

    7. Dosyayı kaydedin. Tamamlanan uygulama tanımlayıcısı dosyasının aşağıdaki gibi görünmesi gerekir: 

      <?xml version="1.0" encoding="UTF-8"?> 
<application xmlns="http://ns.adobe.com/air/application/2.6"> 
    <id>examples.html.HelloWorld</id> 
    <versionNumber>0.1</versionNumber> 
    <filename>HelloWorld</filename> 
    <initialWindow> 
        <content>HelloWorld.html</content> 
        <visible>true</visible> 
        <width>400</width> 
        <height>200</height> 
    </initialWindow> 
</application>

    Bu örnek olabilecek uygulama özelliklerinin yalnızca birkaçını ayarlar. Pencere kromu, pencere boyutu, saydamlık, varsayılan yükleme dizini, ilişkilendirilmiş dosya türleri ve uygulama simgeleri gibi öğeleri belirlemenize olanak veren tam bir uygulama özellikleri kümesi için bkz. AIR uygulama tanımlayıcı dosyaları.

    Uygulama HTML sayfasını oluşturun

    Artık AIR uygulamanız için ana dosya olarak işlev görecek basit bir HTML sayfası oluşturmanız gerekir.

    1. Düzenlenecek HelloWorld.html dosyasını açın. Aşağıdaki HTML kodunu ekleyin: 

      <html> 
<head> 
    <title>Hello World</title> 
</head> 
<body onLoad="appLoad()"> 
    <h1>Hello World</h1> 
</body> 
</html>

    2. HTML'nin <head> bölmesinde, AIRAliases.js dosyasını içe aktarın:

      <script src="AIRAliases.js" type="text/javascript"></script>

      AIR HTML window nesnesinde runtime adlı bir özellik tanımlar. Çalışma zamanı özelliği sınıfın tam nitelikli paket adını kullanarak yerleşik AIR sınıfına erişim sağlar. Örneğin, bir AIR File nesnesi oluşturmak için JavaScript'e aşağıdaki cümleyi ekleyebilirsiniz: 

      var textFile = new runtime.flash.filesystem.File("app:/textfile.txt");

      AIRAliases.js dosyası en kullanışlı AIR API'lerine ilişkin pratik adları tanımlar. AIRAliases.js dosyasını kullanarak File sınıfının başvurusunu aşağıdaki gibi olacak şekilde kısaltabilirsiniz:

      var textFile = new air.File("app:/textfile.txt");

    3. AIRAliases komut dosyası etiketinin altında, onLoad olayını işlemek için bir JavaScript işlevi içeren başka bir komut dosyası etiketi ekleyin: 

      <script type="text/javascript"> 
function appLoad(){ 
    air.trace("Hello World"); 
} 
</script>

      appLoad() işlevi sadece air.trace() işlevini çağırır. ADL kullanarak uygulamayı çalıştırdığınızda, izleme mesajı komut konsoluna yazdırılır. İzleme ifadeleri hata ayıklamak için çok kullanışlı olabilir.

    4. Dosyayı kaydedin.

    HelloWorld.html dosyanızın aşağıdaki gibi görünmesi gerekir: 

    <html> 
<head> 
    <title>Hello World</title> 
    <script type="text/javascript" src="AIRAliases.js"></script> 
    <script type="text/javascript"> 
        function appLoad(){ 
            air.trace("Hello World"); 
        }  
    </script> 
</head> 
<body onLoad="appLoad()"> 
    <h1>Hello World</h1> 
</body> 
</html>

    Uygulamayı test edin

    Uygulamayı komut satırından çalıştırmak ve test etmek için, AIR Hata Ayıklama Başlatıcısı (ADL) yardımcı programı kullanın. FDB programı, AIR SDK'nin bin dizininde bulunabilir. Zaten AIR SDK'yi yüklemediyseniz AIR SDK’yi yükleme bölümüne bakın.

    1. Bir komut konsolu veya bir kabuk açın. Bu proje için oluşturduğunuz dizini değiştirin.

    2. Aşağıdaki komutu çalıştırın: 

      adl HelloWorld-app.xml

      Bir AIR penceresi uygulamanızı görüntüleyerek açılır. Konsol penceresi ayrıca air.trace() çağrısının sonucunda meydana gelen mesajı görüntüler.

      Daha fazla bilgi için bkz. AIR uygulama tanımlayıcı dosyaları.

    AIR yükleme dosyasını oluşturun

    Uygulamanız başarıyla çalıştığında, uygulamayı bir AIR yükleme dosyasına paketlemek için ADT yardımcı programı kullanabilirsiniz. Bir AIR yükleme dosyası kullanıcılarınıza dağıtabileceğiniz tüm uygulama dosyalarını içeren bir arşiv dosyasıdır. Bir paketlenmiş AIR dosyası yüklemeden önce Adobe AIR yüklemeniz gerekir.

    Uygulama güvenliğini kesinleştirmek için, tüm AIR yükleme dosyaları dijital olarak imzalanmalıdır. Geliştirme nedenlerinden dolayı, ADT veya başka bir sertifika oluşturma aracıyla temel, kendinden imzalı bir sertifika oluşturabilirsiniz. Ayrıca VeriSign veya Thawte gibi bir ticari sertifika yetkilisinden ticari bir kod imzalama sertifikası da alabilirsiniz. Kullanıcılar bir kendinden imzalı AIR dosyası yüklediklerinde, yayıncı yükleme işlemi sırasında "bilinmeyen" olarak görüntülenir. Bu bir kendinden imzalı sertifikanın yalnızca AIR dosyasının oluşturulduğundan beri değiştirilmediğini garantilemesinden kaynaklanır. Herhangi birinin bir sahte AIR dosyasını kendisi imzalayıp onu sizin uygulamanızmış gibi sunmasını engelleyecek herhangi bir durum yoktur. Genel olarak yayınlanan AIR dosyaları için, doğrulanabilir ve ticari bir sertifika tavsiye edilir. AIR güvenlik sorunlarına genel bir bakış için bkz. AIR güvenliği (ActionScript geliştiricileri için) veya AIR güvenliği (HTML geliştiricileri için).

    Bir kendinden imzalı sertifika ve bir anahtar çifti oluşturun.

     Komut isteminde, aşağıdaki komutu girin (ADT çalıştırılabilir dosyası AIR SDK'nin bin dizinindedir): 
    adt –certificate -cn SelfSigned 1024-RSA sampleCert.pfx samplePassword

    ADT bir sertifika ve ilişkili bir özel anahtar içeren sampleCert.pfx adlı bir anahtar deposu oluşturur.

    Bu örnek bir sertifika için ayarlanabilecek minimum sayıda niteliği kullanır: italics öğesindeki parametreler için istediğiniz değerleri kullanabilirsiniz. Anahtar türü 1024-RSA veya 2048-RSA olmalıdır (bkz. AIR uygulamalarını imzalama).

    AIR yükleme dosyasını oluşturun

     Komut istemcisinde, aşağıdaki komutu girin (tek satır halinde): 
    adt -package -storetype pkcs12 -keystore sampleCert.pfx HelloWorld.air 
HelloWorld-app.xml HelloWorld.html AIRAliases.js

    Sizden anahtar deposu dosya şifresi istenecek.

    HelloWorld.air argümanı ADT'nin oluşturduğu bir AIR dosyasıdır. HelloWorld-app.xml uygulama tanımlayıcı dosyasıdır. Sonraki argümanlar uygulamanız tarafından kullanılan dosyalardır. Bu örnek yalnızca iki dosya kullanır, ancak herhangi sayıda dosya ve dizin dahil edebilirsiniz. ADT ana içerik dosyası HelloWorld.html öğesinin pakette olduğunu doğrular, ancak AIRAliases.js dosyasını koymayı unutursanız uygulamanız çalışmaz.

    AIR paketi oluşturulduktan sonra, paket dosyasını çift tıklatarak uygulamayı yükleyip çalıştırabilirsiniz. Ayrıca AIR dosya adını kabukta veya komut penceresinde bir komut olarak da yazabilirsiniz.

    Sonraki Adımlar

    AIR'de, HTML ve JavaScript kodu genelde tipik bir web tarayıcısında davranacağı davranır. (Aslında, AIR Safari web tarayıcısıyla aynı WebKit oluşturma motorunu kullanır.) Ancak, AIR'de HTML uygulamaları geliştirirken anlamanız gereken bazı önemli farklar vardır. Bu farklar ve diğer önemli konularla ilgili daha fazla bilgi için bkz. HTML ve JavaScript’i Programlama.