Erstmaliges Erstellen einer AIR-Anwendung für iOS

Erstellen Sie eine SWF-Datei, die den Text „Hello world!“ anzeigt. Dazu können Sie Flash Professional, Flash Builder oder eine andere IDE verwenden. In diesem Beispiel werden einfach ein Texteditor und der im Flex SDK enthaltene Befehlszeilen-SWF-Compiler verwendet.

1. Erstellen Sie an einem passenden Speicherort einen Ordner zum Speichern der Anwendungsdateien. Erstellen Sie eine Datei mit dem Namen HelloWorld.as und bearbeiten Sie die Datei in Ihrem bevorzugten Code-Editor.

2. Fügen Sie den folgenden Code hinzu:

   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. Kompilieren Sie die Klasse mit dem amxmlc-Compiler:

   amxmlc HelloWorld.as

   Die SWF-Datei HelloWorld.swf wird im selben Ordner erstellt.

   Hinweis: In diesem Beispiel wird davon ausgegangen, dass Sie Ihre Umgebungspfadvariable so eingerichtet haben, dass sie den Ordner mit amxmlc enthält. Informationen zum Festlegen des Pfades finden Sie unter Pfadumgebungsvariablen . Alternativ dazu können Sie den vollständigen Pfad zu amxmlc und den anderen Befehlszeilenwerkzeugen, die in diesem Beispiel verwendet werden, eingeben.

Alle iOS-Anwendungen haben Symbole, die in der iTunes-Benutzeroberfläche und auf dem Gerätebildschirm angezeigt werden.

1. Erstellen Sie im Projektverzeichnis ein Verzeichnis und nennen Sie es „icons“.

2. Erstellen Sie drei PNG-Dateien im Verzeichnis „icons“. Nennen Sie diese Dateien „Icon_29.png“, „Icon_57.png“ und „Icon_512.png“.

3. Bearbeiten Sie die PNG-Dateien, um geeignete Grafiken für Ihre Anwendung zu erstellen. Die Dateien müssen 29 x 29, 57 x 57 bzw. 512 x 512 Pixel groß sein. Für diesen Test können Sie einfach einfarbige Quadrate als Symbole verwenden.

   Hinweis: Wenn Sie eine Anwendung an den Apple App Store übermitteln, verwenden Sie eine JPG-Version (keine PNG-Version) der 512-Pixel-Datei. Sie verwenden die PNG-Version beim Testen von Entwicklungsversionen der Anwendung.

Alle iPhone-Anwendungen zeigen ein Anfangsbild an, wenn die Anwendung auf dem iPhone geladen wird. Sie definieren das Anfangsbild in einer PNG-Datei:

1. Erstellen Sie im Hauptentwicklungsverzeichnis eine PNG-Datei mit dem Namen „Default.png“. (Legen Sie diese Datei nicht im Unterverzeichnis „icons“ ab. Achten Sie darauf, den Dateinamen, „Default.png“, mit einem Großbuchstaben-D einzugeben.)

2. Bearbeiten Sie die Datei, sodass sie 320 Pixel breit und 480 Pixel hoch ist. Für den Moment kann es sich bei dem Inhalt um ein einfaches weißes Rechteck handeln. (Dies wird später geändert.)

Ausführliche Informationen zu diesen Grafiken finden Sie unter Anwendungssymbole .

Erstellen Sie eine Anwendungsdeskriptordatei, die die grundlegenden Eigenschaften der Anwendung festlegt. Dazu können Sie eine IDE wie Flash Builder oder einen Texteditor verwenden.

1. Erstellen Sie im Projektordner, der die Datei „HelloWorld.as“ enthält, eine XML-Datei mit dem Namen HelloWorld-app.xml . Bearbeiten Sie diese Datei in Ihrem bevorzugten XML-Editor.

2. Fügen Sie den folgenden XML-Code hinzu:

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

   Der Einfachheit halber werden in diesem Beispiel nur einige der verfügbaren Eigenschaften festgelegt.

   Hinweis: Wenn Sie AIR 2 oder eine frühere Version verwenden, müssen Sie das <version> -Element anstelle des <versionNumber> -Elements verwenden.

3. Ändern Sie die Anwendungs-ID, sodass sie der im iOS Provisioning Portal angegebenen Anwendungs-ID entspricht. (Schließen Sie nicht den zufälligen Bundle-Seed-Teil am Anfang der ID mit ein.)

4. Testen Sie die Anwendung mit ADL:

   adl HelloWorld-app.xml -screensize iPhone

   ADL sollte auf Ihrem Desktop ein Fenster mit dem folgenden Text öffnen: Hello World! Ist dies nicht der Fall, prüfen Sie den Quellcode und Anwendungsdeskriptor auf Fehler.

Sie können jetzt die IPA-Installerdatei mit ADT kompilieren. Dazu benötigen Sie Ihr Apple-Entwicklerzertifikat und den privaten Schlüssel im P12-Dateiformat sowie Ihr Apple-Entwickler-Provisioning-Profil.

Führen Sie das ADT-Programm mit den folgenden Optionen aus, wobei Sie die Werte für Keystore, Storepass und Provisioning-Profil durch Ihre eigenen Daten ersetzen:

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

(Verwenden Sie eine einzelne Befehlszeile; die Zeilenumbrüche in diesem Beispiel wurden lediglich zur besseren Lesbarkeit eingefügt.)

ADT generiert die Installationsprogrammdatei der iOS-Anwendung, HelloWorld.ipa , im Projektordner. Das Kompilieren der IPA-Datei kann einige Minuten dauern.

So installieren Sie die iOS-Anwendung zum Testen auf einem Gerät:

1. Öffnen Sie die iTunes-Anwendung.

2. Fügen Sie das Provisioning-Profil für diese Anwendung zu iTunes hinzu. Wählen Sie in iTunes „Ablage“ > „Zu Mediathek hinzufügen“. Wählen Sie dann die Provisioning-Profildatei aus (die Datei hat den Dateityp „mobileprovision“).

   Für den Moment verwenden Sie das Entwicklungs-Provisioning-Profil, um die Anwendung auf dem Entwicklergerät zu testen.

   Später, wenn Sie eine Anwendung in den iTunes Store stellen, verwenden Sie das Distributionsprofil. Um die Anwendung ad hoc zu verteilen (an mehrere Geräte, ohne den iTunes Store zu verwenden), benutzen Sie das Ad-hoc-Provisioning-Profil.

   Weitere Informationen zu Provisioning-Profilen finden Sie unter Einrichtung für iOS .

3. Einige iTunes-Versionen ersetzen die Anwendung nicht, wenn dieselbe Version der Anwendung bereits installiert ist. Löschen Sie in diesem Fall Ihre Anwendung vom Gerät und aus der Liste der Anwendungen in iTunes.

4. Doppelklicken Sie auf die IPA-Datei für Ihre Anwendung. Sie sollte in der Liste der Anwendungen in iTunes aufgeführt werden.

5. Verbinden Sie das Gerät mit einem USB-Anschluss des Computers.

6. Überprüfen Sie in iTunes die Registerkarte „Programme“ und vergewissern Sie sich, dass die Anwendung in der Liste der zu installierenden Anwendungen ausgewählt ist.

7. Wählen Sie links in der iTunes-Anwendung das Gerät aus. Klicken Sie dann auf „Synchronisieren“. Nach Abschluss der Synchronisierung erscheint die Anwendung „Hello World“ auf Ihrem iPhone.

Wenn die neue Version nicht installiert wurde, löschen Sie sie vom Gerät und aus der Liste der Anwendungen in iTunes und wiederholen Sie den Vorgang. Dies kann vorkommen, wenn die zurzeit installierte Version dieselbe Anwendungs-ID und Version verwendet.

Vor dem Kompilieren der Anwendung haben Sie die Datei „Default.png“ erstellt (siehe Erstellen von Symbolen und Grafiken für den Anfangsbildschirm der Anwendung ). Diese PNG-Datei dient als Startbild, während die Anwendung geladen wird. Beim Testen der Anwendung auf dem iPhone haben Sie möglicherweise den leeren Bildschirm beim Starten bemerkt.

Diesen sollten Sie ändern, damit er zum Startbildschirm Ihrer Anwendung („Hello World!“) passt:

1. Öffnen Sie die Anwendung auf Ihrem Gerät. Wenn der erste „Hello World!“-Text erscheint, drücken Sie die Home-Taste (unter dem Bildschirm) und halten Sie sie gedrückt. Während Sie die Home-Taste gedrückt halten, drücken Sie auf die Power/Standby-Taste oben auf dem iPhone. Damit wird ein Bildschirmfoto erstellt und an die Camera Roll gesendet.

2. Übertragen Sie das Bild auf Ihren Entwicklungscomputer, indem Sie iPhoto oder eine andere Anwendung zum Übertragen von Fotos verwenden. (Auf dem Mac können Sie auch die Bilderfassung verwenden.)

   Sie können das Foto auch per E-Mail an den Entwicklungscomputer senden.

   • Öffnen Sie die Fotos-Anwendung.

   • Öffnen Sie die Camera Roll.

   • Öffnen Sie das Bildschirmfoto, das Sie aufgenommen haben.

   • Tippen Sie auf das Bild und dann auf den Vorwärtspfeil unten links. Klicken Sie dann auf „Per E-Mail senden“ und senden Sie das Bild an sich selbst.

3. Ersetzen Sie die Datei „Default.png“ (in Ihrem Entwicklungsverzeichnis) durch eine PNG-Version des Bildschirmfotos.

4. Kompilieren Sie die Anwendung erneut (siehe Kompilieren der IPA-Datei ) und installieren Sie sie erneut auf dem Gerät.

Die Anwendung verwendet beim Laden jetzt den neuen Startbildschirm.