Skapa ditt första AIR-program för iOS

Skapa en SWF-fil som visar texten ”Hello world!”. Du kan göra detta med Flash Professional, Flash Builder eller en annan integrerad utvecklingsmiljö. I det här exemplet används en textredigerare och det kommandoradsverktyg för SWF-kompilering som ingår i Flex SDK.

1. Skapa en katalog på en lämplig plats för att spara programfilerna. Skapa en fil med namnet HelloWorld.as och redigera filen i önskat kodredigeringsprogram.

2. Lägg till följande kod:

   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. Kompilera klassen med amxmlc-kompileraren:

   amxmlc HelloWorld.as

   En SWF-fil med namnet HelloWorld.swf skapas i samma mapp.

   Obs! Det här exemplet förutsätter att du har konfigurerat systemvariabeln path så att den katalog som innehåller amxmlc finns med. Information om hur du anger sökvägen finns i Systemvariabeln path . Du kan också skriva den fullständiga sökvägen till amxmlc och de andra kommandoradsverktygen som används i det här exemplet.

Alla iOS-program innehåller ikoner som visas i användargränssnittet i iTunes-programmet och på enhetens skärm.

1. Skapa en katalog i din projektkatalog med namnet ”icons”.

2. Skapa tre PNG-filer i katalogen ”icons”. Ge dem namnen Icon_29.png, Icon_57.png och Icon_512.png.

3. Redigera PNG-filerna till den typ av grafik som du vill ha för ditt program. Filerna måste vara 29 x 29 pixlar, 57 x 57 pixlar och 512 x 512 pixlar. För det här testet kan du helt enkelt använda enfärgade fyrkanter som grafik.

   Obs! När du skickar ett program till Apples App Store använder du en JPG-version (inte en PNG-version) av filen med 512 pixlar. PNG-versionen använder du medan du testar utvecklingsversionerna av ett program.

För alla iPhone-program visas en inledande bild när programmet läses in på iPhone-enheten. Du skapar den inledande bilden i en PNG-fil:

1. Skapa en PNG-fil med namnet Default.png i utvecklingens huvudkatalog. (Lägg inte den här filen i underkatalogen ”icons”. Se till att du ger filen namnet Default.png, med ett versalt D.)

2. Redigera filen så att den är 320 pixlar bred och 480 pixlar hög. Tills vidare kan innehållet vara en tom vit rektangel. (Du kommer att ändra detta senare.)

Detaljerad information om de här bilderna finns i Programikoner .

Skapa en programbeskrivningsfil som anger programmets grundläggande egenskaper. Du kan göra detta med en integrerad utvecklingsmiljö som Flash Builder eller med en textredigerare.

1. Skapa en XML-fil med namnet HelloWorld-app.xml i den projektmapp som innehåller filen HelloWorld.as. Redigera den här filen i önskat XML-redigeringsprogram.

2. Lägg till följande XML-kod:

   <?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>

   För enkelhets skull anges bara ett fåtal av de tillgängliga egenskaperna i det här exemplet.

   Obs! Om du använder AIR 2, eller tidigare, måste du använda elementet <version> i stället för elementet <versionNumber> .

3. Ändra program-ID:t så att det matchar det program-ID som anges i iOS Provisioning Portal. (Inkludera inte den slumpmässiga källpaketdelen i början av ID:t.)

4. Testa programmet med ADL:

   adl HelloWorld-app.xml -screensize iPhone

   ADL bör öppna ett fönster på skrivbordet med texten Hello World! . Om inget fönster öppnas kontrollerar du om det finns några fel i källkoden eller programbeskrivningen.

Du kan nu kompilera IPA-installationsfilen med ADT. Du måste ha ditt utvecklarcertifikat från Apple och din privata nyckel i P12-filformat samt din provisioneringsprofil för utveckling från Apple.

Kör ADT-verktyget med följande alternativ och ersätt värdena för keystore, storepass och provisioning-profile med dina värden:

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

(Använd bara en kommandorad. Radbrytningarna i exemplet är bara för att det ska vara lättare att läsa.)

ADT genererar installationsfilen för iOS-programmet, HelloWorld.ipa , i projektkatalogen. Det kan ta några minuter att kompilera IPA-filen.

Så här installerar du iOS-programmet för testning:

1. Öppna iTunes-programmet.

2. Om du inte redan har gjort det ska du lägga till provisioneringsprofilen för programmet i iTunes. Välj Arkiv > Lägg till i biblioteket i iTunes. Välj sedan filen med provisioneringsprofilen (med filtypen mobileprovision).

   När du nu testar programmet på din utvecklarenhet använder du provisioneringsprofilen för utveckling.

   Sedan när du distribuerar programmet till iTunes Store använder du profilen för distribution. Om du vill göra en ad hoc-distribution av programmet (till flera enheter utan att gå via iTunes Store) använder du ad hoc-provisioneringsprofilen.

   Mer information om provisioneringsprofiler finns i iOS-konfiguration .

3. I vissa versioner av iTunes ersätts inte programmet om samma version av programmet redan finns installerat. I så fall tar du bort programmet från din enhet och från listan över program i iTunes.

4. Dubbelklicka på IPA-filen för programmet. Den bör visas i listan med program på iTunes.

5. Anslut enheten till USB-porten på datorn.

6. Kontrollera programfliken för enheten i iTunes och att programmet är markerat i listan över program som ska installeras.

7. Markera enheten i den vänstra listan i iTunes-programmet. Klicka sedan på Synkronisera. När synkroniseringen är slutförd visas programmet Hello World i din iPhone.

Om den nya versionen inte har installerats tar du bort programmet från enheten och från listan över program i iTunes och upprepar sedan proceduren. Detta kan bero på att den installerade versionen använder samma program-ID och version.

Innan du kompilerade programmet skapade du filen Default.png (se Skapa ikoner och inledande skärmbilder för programmet ). Den här PNG-filen visas som startbild medan programmet läses in. När du testade programmet på din iPhone kanske du lade märke till den tomma skärmen som visades när programmet startades.

Du bör ändra den här bilden för att matcha startskärmen för programmet (”Hello World!”):

1. Öppna programmet på din enhet. När den första Hello World-texten visas trycker du på och håller ned hemknappen (under skärmen). Samtidigt som du håller ned hemknappen trycker du på viloläge-/strömknappen (på ovansidan av din iPhone). Då tas en skärmavbild som skickas till kamerarullen.

2. Överför bilden till utvecklingsdatorn med iPhoto eller med något annat bildöverföringsprogram. (I Mac OS kan du också använda programmet Image Capture.)

   Du kan också skicka bilden via e-post till utvecklingsdatorn:

   • Öppna bildprogrammet.

   • Öppna kamerarullen.

   • Öppna den skärmavbild som du har tagit.

   • Tryck på bilden och tryck sedan på framåtpilen längst ned till vänster. Klicka sedan på knappen E-posta bild och skicka bilden till dig själv.

3. Ersätt filen Default.png (i utvecklingskatalogen) med en PNG-version av skärmavbilden.

4. Kompilera om programmet (se Kompilera IPA-filen ) och installera om det på enheten.

Den nya startskärmen används nu under det att programmet läses in.