Создание первого приложения AIR для iOS

AIR 2.6 и более поздние версии, iOS 4.2 и более поздние версии

Написание кода, создание сборки и тестирование базовых функций приложений для iOS можно выполнять с помощью инструментов Adobe. Однако для установки и тестирования приложения для iOS на устройстве и распространения этого приложения требуется присоединиться к программе Apple iOS Developer (участие в программе предусматривает оплату). После присоединения к программе iOS Developer вам будет открыт доступ к порталу iOS Provisioning Portal, на котором можно получить файлы и ресурсы от Apple, необходимые для установки приложения на устройстве, проведения тестирования и последующего распространения. Предоставляется доступ к следующим файлам и ресурсам:

  • Сертификаты разработки и распространения

  • Идентификаторы приложений

  • Файлы для разработки и распространения

Создание содержимого приложения

Создайте SWF-файл, который выводит текст «Hello world!». Для этого можно использовать Flash Professional, Flash Builder или другую интегрированную среду разработки. В данном примере воспользуйтесь текстовым редактором и компилятором SWF с интерфейсом командной строки, который включен в пакет Flex SDK.

  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 настроен в переменной среды Path. Сведения о настройке пути см. в разделе «Переменные среды Path». Как альтернативный вариант можно ввести полный путь к amxmlc и другим инструментам командной строки, используемым в данном примере.

Создание изображений для значка и начального экрана приложения

Все приложения для iOS имеют значки, которые отображаются в пользовательском интерфейсе приложения iTunes и на экране устройства.

  1. Создайте подкаталог в каталоге проекта и присвойте ему имя icons (значки).

  2. Создайте три PNG-файла в каталоге icons. Сохраните их под именами Icon_29.png, Icon_57.png и Icon_512.png.

  3. Отредактируйте PNG-файлы, чтобы создать подходящие значки для приложения. Изображения должны иметь размеры 29 х 29, 57 х 57 и 512 х 512 пикселов. В целях тестирования просто используйте в качестве изображений одноцветные квадраты.

    Примечание. При отправке приложения в магазин Apple App Store используется версия JPG (а не PNG) изображения со стороной 512 пикселов. Версия PNG используется при тестировании рабочих версий приложения.

Все приложения iPhone отображают начальное изображение в процессе загрузки на iPhone. Определите начальное изображение в PNG-файле.

  1. В основном каталоге разработки создайте PNG-файл с именем Default.png. (Не помещайте этот файл в подкаталог icons. Файлу нужно обязательно присвоить имя Default.png, с прописной буквой D.)

  2. Внесите в файл изменения, чтобы его ширина равнялась 320 пикселам, а высота 480 пикселам. Пока в качестве начального изображения можно использовать простой белый прямоугольник. (В дальнейшем его можно будет изменить.)

Дополнительные сведения об этих изображениях см. в разделе «Значки приложения».

Создание файла дескриптора приложения

Создайте файл дескриптора приложения, в котором определяются базовые свойства приложения. Это можно сделать с помощью ИСР, например Flash Builder, или текстового редактора.

  1. В папке проекта, содержащей файл HelloWorld.as, создайте XML-файл с именем HelloWorld-app.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. Измените идентификатор приложения, установив идентификатор приложение, полученные на портале iOS Provisioning Portal (не включайте случайный идентификатор начального числа пакета).

  4. Выполните тестирование приложения с помощью ADL:

    adl HelloWorld-app.xml -screensize iPhone

    ADL должен открывать окно на компьютере с текстом «Hello World!». Если этого не происходит, проверьте исходный код и дескриптор приложение на наличие ошибок.

Компиляция файла IPA

Теперь можно скомпилировать файл установщика IPA с помощью ADT. Вам требуется сертификат разработчика 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, а затем повторите процедуру. Такое происходит, если текущая установленная версия использует тот же идентификатор приложения и номер версии.

Редактирование изображения начального экрана

Перед компиляцией приложения был создан файл Default.png (см. раздел «Создание изображений для значка и начального экрана приложения»). Этот PNG-файл служит начальным экраном, который отображается во время загрузки приложения. При тестировании приложения на iPhone вы, возможно, заметили этот пустой экран при загрузке.

Это изображение необходимо изменить, чтобы оно соответствовало начальному экрану приложения («Здравствуй, мир!»).

  1. Откройте приложение на устройстве. Когда появится первый текст «Здравствуй, мир!», нажмите и удерживайте кнопку «Домой» (под экраном). Удерживая кнопку «Домой», нажмите кнопку «Питание/Режим сна» (вверху на iPhone). В результате будет сделан снимок экрана и отправлен в приложение «Фотопленка».

  2. Перенесите изображение на рабочий компьютер с помощью функции переноса фотографий из iPhoto или другого приложения для перемещения фотографий. (В ОС Mac OS также можно использовать программу «Захват изображений».)

    Также фотографию можно отправить на рабочий компьютер по электронной почте.

    • Откройте приложение «Фотографии».

    • Откройте инструмент «Фотопленка».

    • Откройте сделанный снимок экрана.

    • Нажмите изображение, а затем нажмите кнопку со стрелкой («переслать») в нижнем левом углу. Нажмите кнопку «Отправить по e-mail» и отправьте изображение на свой адрес.

  3. Замените файл Default.png (в каталоге проекта) на PNG-версию снимка экрана.

  4. Выполните повторную компиляцию приложения (см. раздел «Компиляция файла IPA») и переустановите его на устройство.

Теперь при загрузке приложения отображается новый начальный экран.

Примечание. В файле Default.png может использоваться любая графика при условии сохранения правильных размеров (320 х 480 пикселов). Однако в большинстве случаях рекомендуется, чтобы изображение Default.png соответствовало начальному экрану приложения.