Flex SDK ile Android için ilk AIR uygulamanızı oluşturma

Başlamak için AIR ve Flex SDK'lerini yüklemiş ve ayarlamış olmanız gerekir. Bu eğitim Flex SDK'den AMXMLC derleyicisini ve AIR Hata Ayıklama Başlatıcısı 'nı (ADL) ve AIR SDK'den AIR Geliştirici Aracı 'nı (ADT) kullanır. Bkz. Flex SDK’yi kurma .

Ayrıca şurada açıklandığı gibi Android web sitesinden Android SDK'yi indirip yüklemeniz gerekir: Android Developers: Installing the SDK (Android Geliştiricileri: SDK'yi Yükleme).

Not: iPhone geliştirmesiyle ilgili bilgi için bkz. Flash Professional CS5 ile bir Hello World iPhone uygulaması oluşturma .

AIR uygulama tanımlayıcı dosyasını oluşturma

Bu bölüm bir XML dosyası olan uygulama açıklayıcısının aşağıdaki yapı ile nasıl oluşturulacağını açıklar:

<application xmlns="..."> 
    <id>...</id> 
    <versionNumber>...</versionNumber> 
    <filename>…</filename> 
    <initialWindow> 
        <content>…</content> 
    </initialWindow> 
    <supportedProfiles>...</supportedProfiles> 
</application>
  1. HelloWorld-app.xml adlı bir XML dosyası oluşturup bu dosyayı proje dizinine kaydedin.

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

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

  3. <id> öğesini ekleyin:

    <id>samples.android.HelloWorld</id> Uygulama kimliği uygulamanızı benzersiz şekilde yayıncı kimliğiyle (AIR'nin uygulama paketini imzalamak için kullanılan sertifikadan türettiği) birlikte tanımlar. Tavsiye edilen form, "com.company.AppName" gibi nokta sınırlı ve ters DNS stili olan bir dizedir.

  4. <versionNumber> öğesini ekleyin:

    <versionNumber>0.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 sistemindeki başvurularda uygulama çalıştırılabilir dosyası, yükleme dizini ve benzerleri 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'nin yükleyeceği kök HTML dosyasını tanımlar.

  7. <supportedProfiles> öğesini ekleyin.

    <supportedProfiles>mobileDevice</supportedProfiles> Uygulamanın yalnızca mobil profilinde çalıştığını belirtir.

  8. Dosyayı kaydedin. Tamamlanmış uygulama açıklayıcısı dosyanız aşağıdaki gibi görünmelidir:

    <?xml version="1.0" encoding="UTF-8"?> 
    <application xmlns="http://ns.adobe.com/air/application/2.7"> 
        <id>samples.android.HelloWorld</id> 
        <versionNumber>0.0.1</versionNumber> 
        <filename>HelloWorld</filename> 
        <initialWindow> 
            <content>HelloWorld.swf</content> 
        </initialWindow> 
        <supportedProfiles>mobileDevice</supportedProfiles> 
    </application>

Bu örnek olabilecek uygulama özelliklerinin yalnızca birkaçını ayarlar. Uygulama tanımlayıcı dosyasında kullanabileceğiniz başka ayarlar da vardır. Örneğin, tam ekranlı bir uygulama oluşturmak için initialWindow öğesine <fullScreen>true</fullScreen> öğesini ekleyebilirsiniz. Android'de uzaktan hata ayıklamayı ve erişimi kontrol edilen özellikleri etkinleştirmek için ayrıca uygulama tanımlayıcısına Android izinleri eklemeniz gerekir. Bu basit uygulama için izinlere gerek yoktur. Bu nedenle şu anda eklemeniz gerekmez.

Daha fazla bilgi için bkz. Mobil uygulama özelliklerini ayarlama .

Uygulama kodunu yazma

HelloWorld.as adlı bir dosya oluşturun ve bir metin düzenleyicisi kullanarak aşağıdaki kodu ekleyin:

package 
{ 
    import flash.display.Sprite; 
    import flash.text.TextField; 
     
    public class HelloWorld extends Sprite 
    { 
        public function HelloWorld() 
        { 
            var textField:TextField = new TextField(); 
            textField.text = "Hello, World!"; 
            stage.addChild( textField ); 
        } 
    } 
}

Uygulamayı derleme

Uygulamayı çalıştırıp hatalarını ayıklamadan önce, MXML kodunu amxmlc derleyicisini kullanarak bir SWF dosyasına derleyin. amxmlc derleyicisi, Flex SDK'nin bin dizininde bulunabilir. İsterseniz, bilgisayarınızın yol ortamını Flex SDK bin dizinini içerecek şekilde ayarlayabilirsiniz. Yolun ayarlanması komut satırındaki hizmet programlarının daha kolay çalıştırılmasını sağlar.

  1. AIR uygulamanızın proje klasörüne gitmek için bir komut kabuğu veya terminal açın.

  2. Aşağıdaki komutu girin:

    amxmlc HelloWorld.as 

amxmlc öğesinin çalıştırılması uygulamanın derlenmiş kodunu içeren HelloWorld.swf dosyasını oluşturur.

Not: Uygulama derlenmezse, sözdizimi veya yazım hatalarını onarın. Hatalar ve uyarılar amxmlc derleyicisini çalıştırmak için kullanılan konsol penceresinde görüntülenir.

Daha fazla bilgi için, bkz. MXML ve ActionScript dosyalarını AIR için derleme .

Uygulamayı test edin

Uygulamayı komut satırından çalıştırmak ve test etmek için, uygulamayı uygulama açıklayıcısı dosyasını kullanarak başlatmak amacıyla AIR Hata Ayıklama Başlatıcısı'nı (ADL) kullanın. (ADL, AIR ve Flex SDK'lerinin bin dizininde bulunabilir.)

Komut istemcisinde aşağıdaki komutu girin:
adl HelloWorld-app.xml 

Daha fazla bilgi için bkz. ADL kullanarak aygıt benzetimi .

APK paket dosyası oluşturma

Uygulamanız başarıyla çalıştığında, uygulamayı bir APK paket dosyasına paketlemek için ADT yardımcı programı kullanabilirsiniz. Bir APK paket dosyası, kullanıcılarınıza dağıtabileceğiniz yerel Android uygulama dosyası biçimidir.

Tüm Android uygulamaları imzalı olmalıdır. AIR dosyalarının aksine, Android uygulamalarını kendinden imzalı bir sertifikayla imzalamak gerekir. Android işletim sistemi uygulama geliştiricisinin kimliğini oluşturmayı denemez. Android paketlerini imzalamak için ADT tarafından oluşturulmuş bir sertifika kullanabilirsiniz. Android market'a gönderilen uygulamalar için kullanılan sertifikalar en az 25 yıllık bir geçerlilik süresine sahip olmalıdır.

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

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

Bu örnek bir sertifika için ayarlanabilecek minimum sayıda niteliği kullanır: Anahtar türü 1024-RSA veya 2048-RSA olmalıdır (bkz. ADT certificate komutu ).

AIR paketini oluşturma

Komut istemcisinde, aşağıdaki komutu girin (tek satır halinde):
adt -package -target apk -storetype pkcs12 -keystore sampleCert.p12 HelloWorld.apk HelloWorld-app.xml HelloWorld.swf

Sizden anahtar deposu dosya şifresi istenecek. Şifreyi girin ve Enter tuşuna basın.

Daha fazla bilgi için bkz. Mobil AIR uygulamasını paketleme .

AIR çalışma zamanını yükleme

Android Market'tan aygıtınıza AIR çalışma zamanının en son sürümünü yükleyebilirsiniz. Ayrıca SDK'nizde bulunan çalışma zamanını da bir aygıta veya Android taklitçisine yükleyebilirsiniz.

Komut istemcisinde, aşağıdaki komutu girin (tek satır halinde):
adt -installRuntime -platform android -platformsdk

Android SDK dizininizde -platformsdk bayrağını ayarlayın (araçlar klasörünün üst öğesini belirtin).

ADT, SDK içinde bulunan Runtime.apk dosyasını yükler.

Daha fazla bilgi için bkz. AIR çalışma zamanını ve geliştirme uygulamalarını yükleme .

AIR uygulamasını yükleme

Komut istemcisinde, aşağıdaki komutu girin (tek satır halinde):
adt -installApp -platform android -platformsdk path-to-android-sdk -package path-to-app

Android SDK dizininizde -platformsdk bayrağını ayarlayın (araçlar klasörünün üst öğesini belirtin).

Daha fazla bilgi için bkz. AIR çalışma zamanını ve geliştirme uygulamalarını yükleme .

Aygıtın veya taklitçinin ekranındaki uygulama simgesine dokunarak uygulamanızı başlatabilirsiniz.