创建第一个用于 iOS 的 AIR 应用程序

创建一个显示文本“Hello world!”的 SWF 文件可以使用 Flash Professional、Flash Builder 或其他 IDE 来执行此任务。此示例只使用了文本编辑器和 Flex SDK 中附带的命令行 SWF 编译器。

1. 在适当的位置创建一个目录，用于存储您的应用程序文件。创建一个名为 HelloWorld.as 的文件，然后使用您喜欢的代码编辑器编辑该文件。

2. 添加以下代码：

   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 编译器编译类：

   amxmlc HelloWorld.as

   将在相同文件夹中创建一个 SWF 文件： HelloWorld.swf 。

   注： 此示例假设您已将环境路径变量设置为包含 amxmlc 的目录。有关设置路径的信息，请参阅 路径环境变量 。此外，也可以键入 amxmlc 以及此示例中使用的其他命令行工具的完整路径。

所有 iOS 应用程序都具有在 iTunes 应用程序的用户界面和设备屏幕上显示的图标。

1. 在您的项目目录中创建一个目录并将其命名为图标。

2. 在该图标目录中创建三个 PNG 文件。将它们分别命名为 Icon_29.png、Icon_57.png 和 Icon_512.png。

3. 编辑这些 PNG 文件为应用程序创建适当的图片。这些文件必须为 29×29 像素、57×57 像素和 512×512 像素。对于此测试，您可以仅使用纯色正方形作为图片。

   注： 将应用程序提交给 Apple 应用程序库时，使用像素为 512 的 JPG 版本文件（而不是 PNG 版本）。测试应用程序的开发版本时使用 PNG 版本。

在 iPhone 上加载应用程序时，所有 iPhone 应用程序均显示初始图像。您可以在 PNG 文件中定义初始图像：

1. 在主开发目录中，创建名为 Default.png 的 PNG 文件。（ 不要 将此文件放在图标子目录中。确保将此文件命名为 Default.png，使用大写 D。）

2. 编辑该文件，使其宽 320 像素，高 480 像素。此刻，内容可能显示为纯白色矩形。（您稍后可以进行更改。）

有关这些图形的详细信息，请参阅 应用程序图标 。

创建应用程序描述符文件，该文件指定了应用程序的基本属性。您可以使用 IDE（如 Flash Builder）或文本编辑器来完成此任务。

1. 在包含 HelloWorld.as 的项目文件夹中，创建一个名为 HelloWorld-app.xml 的 XML 文件。使用您喜欢的 XML 编辑器编辑该文件。

2. 添加以下 XML 代码：

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

   为了简单起见，此示例仅设置了少数几个可用的属性。

   注： 如果您使用的是 AIR 2 或更早版本，则必须使用 <version> 元素，而非 <versionNumber> 元素。

3. 更改应用程序 ID 使其与 iOS Provisioning Portal 中指定的应用程序 ID 相匹配。（不要包含位于 ID 开头的随机捆绑种子部分。）

4. 使用 ADL 测试应用程序：

   adl HelloWorld-app.xml -screensize iPhone

   ADL 将在桌面上打开一个窗口，其中显示以下文本： Hello World! ，如果未显示该文本，请检查源代码和应用程序描述符中的错误。

现在您可以使用 ADT 来编译 IPA 安装程序文件：您必须具有 Apple 开发人员证书、私钥（采用 P12 文件格式）和 Apple 开发供给配置文件。

使用以下选项运行 ADT 实用程序，使用自己的值替换 keystore、storepass 和 provisioning-profile 值：

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

（使用一个命令行；在此示例中添加换行符只是为了便于阅读。）

ADT 在项目目录中生成 iOS 应用程序的安装程序文件 HelloWorld.ipa 。编译 IPA 文件可能需要几分钟的时间。

安装 iOS 应用程序以进行测试：

1. 打开 iTunes 应用程序。

2. 如果您尚未执行此操作，请将该应用程序的供给配置文件添加到 iTunes。在 iTunes 中，选择“文件”>“添加到资料库”。然后选择供给配置文件（其文件类型为 mobileprovision）。

   此刻，要在开发人员设备上测试该应用程序，请使用开发供给配置文件。

   稍后，将应用程序分发给 iTunes Store 时，请使用分发配置文件。要临时分发应用程序（不通过 iTunes Store 分发给多个设备），请使用临时供给配置文件。

   有关供给配置文件的详细信息，请参阅 iOS 设置 。

3. 如果已安装相同版本的应用程序，iTunes 的某些版本不会替换该应用程序。在这种情况下，从您的设备和 iTunes 中的应用程序列表中删除该应用程序。

4. 双击您的应用程序的 IPA 文件。此时，您的应用程序应显示在 iTunes 中的应用程序列表中。

5. 将您的设备连接到计算机上的 USB 端口。

6. 在 iTunes 中，检查“应用程序”选项卡中是否存在该设备，并确保在要安装的应用程序的列表中选中了该应用程序。

7. 选择左侧 iTunes 应用程序列表中的设备。然后单击“同步”按钮。完成同步后，Hello World 应用程序会显示在您的 iPhone 上。

如果未安装新版本，请将其从您的设备以及 iTunes 中的应用程序列表中删除，然后重新执行此过程。这可能是因为目前安装的版本使用的是相同的应用程序 ID 和版本。

在编译应用程序之前，您创建了一个 Default.png 文件（请参见 创建应用程序的图标图片和初始屏幕图片 ）。当加载应用程序时，此 PNG 文件充当启动图像。在 iPhone 上测试应用程序时，您可能已注意到启动时会出现空白屏幕。

您应更改此图像，使之与您的应用程序（“Hello World!”）的启动屏幕相匹配：

1. 打开设备上的应用程序。当第一个“Hello World”文本出现时，按住“主屏幕”按钮（位于屏幕下方）。在按住“主屏幕”按钮的同时，按下“睡眠/唤醒”按钮（位于 iPhone 的顶部）。这会捕获一张屏幕快照并将其发送到摄像头卷。

2. 通过从 iPhoto 或其他照片传输应用程序传输照片将此图像传输到您的开发计算机。（在 Mac OS 上，您也可以使用图像捕捉应用程序。）

   还可以通过电子邮件将照片发送到您的开发计算机：

   • 打开 Photos 应用程序。

   • 打开摄像头卷。

   • 打开您捕获的屏幕快照图像。

   • 点击此图像，然后点击左下角的“转发”（箭头）按钮。然后单击“用电子邮件发送照片”按钮并将图像发送给自己。

3. 使用 PNG 版本的屏幕捕获图像替换 Default.png 文件（位于您的开发目录中）。

4. 重新编译该应用程序（请参阅 编译 IPA 文件 ）并将其重新安装在您的设备中。

该应用程序现在使用的是其加载的新启动屏幕。