iOS için ilk AIR uygulamanızı oluşturma

"Hello world!" metnini görüntüleyen bir SWF dosyası oluşturun Bu görevi Flash Professional, Flash Builder veya başka bir IDE kullanarak gerçekleştirebilirsiniz. Bu örnek metin düzenleyicisi ve Flex SDK'ye dahil olan komut satırı SWF derleyicisini kullanır.

1. Uygulama dosyalarınızı saklamak için uygun bir konumda dizin oluşturun. HelloWorld.as adlı bir dosya oluşturun ve dosyayı sık kullandığınız kod düzenleyicide düzenleyin.

2. Aşağıdaki kodu ekleyin:

   package{ 
        
       import flash.display.Sprite; 
       import flash.text.TextField; 
       import flash.text.TextFormat; 
       import flash.text.TextFieldAutoSize; 
        
       public class HelloWorld extends Sprite 
       { 
           public function HelloWorld():void 
           { 
               var textField:TextField = new TextField(); 
               textField.text = "Hello World!"; 
               textField.autoSize = TextFieldAutoSize.LEFT; 
                    
               var format:TextFormat = new TextFormat(); 
               format.size = 48; 
                
               textField.setTextFormat ( format ); 
               this.addChild( textField ); 
           } 
       } 
   }

3. amxmlc derleyicisini kullanarak sınıfı derleyin:

   amxmlc HelloWorld.as

   Aynı klasörde HelloWorld.swf adlı bir SWF dosyası oluşturulur.

   Not: Bu örnek, ortam yol değişkeninizi amxmlc'yi barındıran dizini dahil edecek şekilde ayarladığınızı varsayar. Yolu ayarlamayla ilgili bilgi için bkz. Path ortam değişkenleri . Alternatif olarak, amxmlc ve bu örnekte kullanılan diğer komut satırı araçlarının tam yolunu yazabilirsiniz.

Tüm iOS uygulamaları iTunes uygulamasının kullanıcı arabiriminde ve aygıt ekranında görünen simgelere sahiptir.

1. Proje dizininde bir dizin oluşturarak simgeler adını verin.

2. Simgeler dizininde üç adet PNG dosyası oluşturun. Bunları Icon_29.png, Icon_57.png ve Icon_512.png olarak adlandırın.

3. Uygulamanız için uygun resmi oluşturmak üzere PNG dosyalarını düzenleyin. Dosyalar 29x29 piksel, 57x57 piksel ve 512x512 piksel olmalıdır. Bu test için resim olarak düz renkli kareler kullanabilirsiniz.

   Not: Apple Uygulama Deposuna bir uygulama gönderirken 512 piksellik dosyanın JPG (PNG değil) versiyonunu kullanırsınız. Bir uygulamanın geliştirme sürümlerini test ederken ise PNG versiyonunu kullanırsınız.

Tüm iPhone uygulamaları yüklenirken bir açılış resmi görüntüler. Açılış resmini bir PNG dosyasında tanımlarsınız:

1. Ana geliştirme dizininde Default.png adlı bir PNG dosyası oluşturun. (Bu dosyayı simgeler altdizinine koymayın . Dosyayı baş harfi büyük olacak şekilde Default.png olarak adlandırdığınızdan emin olun.

2. Dosyayı genişliği 320 piksel, yüksekliği 480 piksel olacak şekilde düzenleyin. Şimdilik içerik düz beyaz bir dikdörtgen olabilir. (Bunu daha sonra değiştirirsiniz.)

Bu grafiklerle ilgili ayrıntılı bilgi için bkz. Uygulama simgeleri .

Uygulamanın temel özelliklerini belirten bir uygulama tanımlayıcı dosyası oluşturun. Bu görevi Flash Builder veya metin düzenleyicisi gibi bir IDE kullanarak tamamlayabilirsiniz.

1. HelloWorld.as dosyasını içeren proje klasöründe, HelloWorld-app.xml adlı bir XML dosyası oluşturun. Bu dosyayı sık kullandığınız XML düzenleyicisinde düzenleyin.

2. Aşağıdaki XML'i ekleyin:

   <?xml version="1.0" encoding="utf-8" ?> 
   <application xmlns="http://ns.adobe.com/air/application/2.7" minimumPatchLevel="0"> 
       <id>change_to_your_id</id> 
       <name>Hello World iOS</name> 
       <versionNumber>0.0.1</versionNumber> 
       <filename>HelloWorld</filename> 
       <supportedProfiles>mobileDevice</supportedProfiles> 
       <initialWindow> 
           <content>HelloWorld.swf</content> 
           <title>Hello World!</title> 
       </initialWindow> 
       <icon> 
           <image29x29>icons/AIRApp_29.png</image29x29> 
           <image57x57>icons/AIRApp_57.png</image57x57> 
           <image512x512>icons/AIRApp_512.png</image512x512> 
       </icon> 
   </application>

   Kolaylık olması açısından, bu örnek yalnızca kullanılabilir özelliklerden birkaçını ayarlar.

   Not: AIR 2 veya öncesini kullanıyorsanız <versionNumber> öğesi yerine <version> öğesini kullanmanız gerekir.

3. Uygulama kimliğini iOS Provisioning Portal'da belirtilen uygulama kimliği ile eşleşecek şekilde değiştirin. (Rastgele çekirdek paketi bölümünü kimliğin başlangıcına dahil etmeyin.

4. Uygulamayı ADL kullanarak test edin:

   adl HelloWorld-app.xml -screensize iPhone

   ADL masaüstünüzde şu metni görüntüleyen bir pencere açmalıdır: Hello World! Açmıyorsa, hata olup olmadığını görmek için kaynak kodunu ve uygulama tanımlayıcısını kontrol edin.

Artık ADT kullanarak IPA yükleyici dosyasını derleyebilirsiniz. Apple geliştirici sertifikasına ve P12 dosya biçimde özel anahtara ve Apple geliştirme ön hazırlık profiline sahip olmanız gerekir.

ADT yardımcı programını, anahtar deposunu, depo şifresini ve ön hazırlık profili değerlerini kendi değerlerinizle değiştirerek şu seçeneklerle çalıştırın:

adt -package -target ipa-debug 
    -keystore iosPrivateKey.p12 -storetype pkcs12 -storepass qwerty12 
    -provisioning-profile ios.mobileprovision 
    HelloWorld.ipa 
    HelloWorld-app.xml 
    HelloWorld.swf icons Default.png

(Tek bir komut satırı kullanın; bu örnekteki satır sonları okumayı kolaylaştırmak için verilmiştir.)

ADT, proje dizininde HelloWorld.ipa iOS uygulama yükleyici dosyasını oluşturur. IPA dosyasını derlemek birkaç dakika sürebilir.

Test amacıyla iOS uygulamasını yüklemek için:

1. iTunes uygulamasını açın.

2. Bunu zaten yaptıysanız, bu uygulamanın ön hazırlık profilini iTunes'a ekleyin. iTunes'ta File (Dosya) > Add To Library (Kütüphaneye Ekle) seçimini yapın. Ardından ön hazırlık profilini (dosya türü olarak mobileprovision öğesine sahip olan) seçin.

   Şimdilik, uygulamayı geliştirici aygıtınızda test etmek için, geliştirme ön hazırlık profilini kullanın.

   Daha sonra uygulamayı iTunes Mağazasına dağıtırken, dağıtım profilini kullanın. Uygulamayı geçici olarak (iTunes Mağazasından geçirmeden birden fazla aygıta) dağıtmak için geçici ön hazırlık profilini kullanın.

   Ön hazırlık profilleriyle ilgili daha fazla bilgi için bkz. iOS kurulumu .

3. Bazı iTunes sürümleri uygulamanın aynı versiyonu zaten yüklüyse uygulamayı yenisiyle değiştirmez. Bu durumda, uygulamayı aygıttan ve iTunes içerisindeki uygulamalar listesinden silin.

4. Uygulamaya ait IPA dosyasını çift tıklatın. iTunes'da uygulama listesinde görüntülenmelidir.

5. Aygıtı bilgisayarın USB bağlantı noktasına bağlayın.

6. iTunes'ta aygıtın Uygulama sekmesini kontrol edin ve uygulamanın yüklenecek uygulamalar listesinde seçili olduğundan emin olun.

7. iTunes uygulamasının sol taraftaki listesinden aygıtı seçin. Ardından Sync (Senkr) düğmesine basın. Senkr tamamlandığında, Hello World uygulaması iPhone aygıtınızda görünür.

Yeni sürüm yüklü değilse, aygıtınızdan ve iTunes'taki uygulamalar listesinden silin ve ardından bu işlemi yineleyin. O anda yüklü olan sürüm aynı uygulama kimliği ve sürümüne sahipse bu durum söz konusu olabilir.

Uygulamayı derlemenizden önce bir Default.png dosyayı oluşturdunuz (bkz. Uygulama için simge resmi ve başlangıç ekranı resmi oluşturma ). Bu PNG dosyası, uygulama yüklenirken başlangıç görüntüsü olarak görev yapar. Uygulamayı iPhone aygıtınızda test ederken başlangıçtaki bu boş ekranı fark etmiş olabilirsiniz.

Bu resmi, uygulamanın (“Hello World!”) başlangıç ekranıyla eşleşecek şekilde değiştirmelisiniz:

1. Uygulamayı aygıtınızda açın. İlk “Hello World” metni göründüğünde, Home (Ana Sayfa) düğmesini (ekranın altında) basılı tutun. Home (Ana Sayfa) düğmesini basılı tutarken Power/Sleep (Güç/Uyku) düğmesine basın (iPhone menüsünün en üstünde). Bu bir ekran görüntüsü alır ve bu görüntüyü Film Rulosu'na gönderir.

2. iPhoto veya başka bir fotoğraf aktarma uygulamasından fotoğraf aktararak görüntüyü geliştirme bilgisayarınıza aktarın. (Mac OS'ta Image Capture (Resim Yakalama) uygulamasını da kullanabilirsiniz.)

   Ayrıca fotoğrafı e-posta ile geliştirme bilgisayarınıza gönderebilirsiniz:

   • Fotoğraflar uygulamasını açın.

   • Kamera Kaydını açın.

   • Yakaladığınız ekran görüntüsü resmini açın.

   • Resmi tıklatın ve ardından sol alt köşedeki “ileri” (ok) düğmesini tıklatın. Sonra Email Photo (Fotoğrafı E-posta ile Gönder) seçeneğini tıklatarak resmi kendinize gönderin.

3. Default.png dosyasını (geliştirme dizininde) yakalanan ekran resminin bir PNG sürümüyle değiştirin.

4. Uygulamayı yeniden derleyin (bkz. IPA dosyasını derleyin ) ve aygıtınıza yeniden yükleyin.

Artık uygulama yüklenirken yeni başlangıç ekranını kullanır.