Создание первого приложения AIR для Android с использованием пакета Flex SDK

Чтобы начать работу, установите и настройте AIR SDK и Flex SDK. В данном учебном пособии используется компилятор AMXMLC из пакета Flex SDK, а также AIR Debug Launcher (ADL) и AIR Developer Tool (ADT) из пакета AIR SDK. См. раздел « Настройка Flex SDK ».

Также необходимо загрузить и установить Android SDK с веб-сайта Android, как описано на странице Разработчики Android: установка SDK .

Примечание. Дополнительные сведения о разработке приложений для iPhone см. в разделе « Создание приложения Hello World для iPhone с помощью Flash Professional CS5 ».

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

В этом разделе описаны принципы создания дескриптора приложения, представляющего собой XML-файл со следующей структурой:

<application xmlns="..."> 
    <id>...</id> 
    <versionNumber>...</versionNumber> 
    <filename>…</filename> 
    <initialWindow> 
        <content>…</content> 
    </initialWindow> 
    <supportedProfiles>...</supportedProfiles> 
</application>
  1. Создайте XML-файл HelloWorld-app.xml и сохраните его в каталоге проекта.

  2. Добавьте элемент <application> , включая атрибут пространства имен AIR:

    <application xmlns="http://ns.adobe.com/air/application/2.7"> Последний сегмент пространства имен (2.7) задает версию среды выполнения, которая требуется для приложения.

  3. Добавьте элемент <id> :

    <id>samples.android.HelloWorld</id> Идентификатор приложения однозначно идентифицирует приложение в сочетании с идентификатором издателя (который AIR извлекает из сертификата, используемого для подписи пакета приложения). Рекомендуемым форматом является обратная запись строки DNS с использованием точки в качестве разделителя, например "com.company.AppName" .

  4. Добавьте элемент <versionNumber> :

    <versionNumber>0.0.1</versionNumber> Помогает пользователям определить, какую версию приложения они устанавливают.

  5. Добавьте элемент <filename> :

    <filename>HelloWorld</filename> Имя, используемое для выполняемого файла приложения, каталога установки и аналогичных ссылок на приложение в операционной системе.

  6. Добавьте элемент <initialWindow> , содержащий следующие дочерние элементы, чтобы указать свойства исходного окна приложения:

    <content>HelloWorld.swf</content> Определяет корневой HTML-файл приложения AIR для загрузки.

  7. Добавьте элемент <supportedProfiles> .

    <supportedProfiles>mobileDevice</supportedProfiles> Указывает, что приложение запускается только в профиле мобильного устройства.

  8. Сохраните файл. По завершении файл дескриптора приложения должен иметь следующий вид:

    <?xml version="1.0" encoding="UTF-8"?> 
    <application xmlns="http://ns.adobe.com/air/application/2.7"> 
        <id>samples.android.HelloWorld</id> 
        <versionNumber>0.0.1</versionNumber> 
        <filename>HelloWorld</filename> 
        <initialWindow> 
            <content>HelloWorld.swf</content> 
        </initialWindow> 
        <supportedProfiles>mobileDevice</supportedProfiles> 
    </application>

В этом примере устанавливается всего несколько возможных свойств приложения. В файле дескриптора приложения также можно использовать другие настройки. Например, можно добавить значение <fullScreen>true</fullScreen> в элемент initialWindow, чтобы создать полноэкранное приложение. Для включения удаленной отладки и функций управляемого доступа на платформе Android в дескриптор приложения необходимо добавить разрешения Android. Данное простое приложение не требует разрешений, поэтому сейчас их добавлять не нужно.

Дополнительные сведения см. в разделе « Настройка свойств мобильного приложения ».

Написание кода приложения

Создайте файл с именем HelloWorld.as и в текстовом редакторе добавьте следующий код:

package 
{ 
    import flash.display.Sprite; 
    import flash.text.TextField; 
     
    public class HelloWorld extends Sprite 
    { 
        public function HelloWorld() 
        { 
            var textField:TextField = new TextField(); 
            textField.text = "Hello, World!"; 
            stage.addChild( textField ); 
        } 
    } 
}

Компиляция приложения

Перед выполнением и отладкой приложения скомпилируйте код MXML в SWF-файл с использованием компилятора amxmlc. Компилятор amxmlc находится в каталоге bin пакета Flex SDK. При необходимости можно включить каталог bin пакета Flex SDK в переменную среды для пути на компьютере. Настройка пути делает выполнение утилит в командной строке более простым.

  1. Откройте командную среду или терминал команд и перейдите к папке проекта приложения AIR.

  2. Введите следующую команду:

    amxmlc HelloWorld.as 

При выполнении компилятора amxmlc создается файл HelloWorld.swf , содержащий скомпилированный код приложения.

Примечание. Если не удается скомпилировать приложение, исправьте синтаксические или орфографические ошибки. Ошибки и предупреждения отображаются в окне консоли, используемом для выполнения компилятора amxmlc.

Дополнительные сведения см. в разделе « Компиляция исходных файлов MXML и ActionScript для AIR ».

Проверка приложения

Чтобы выполнить и протестировать приложение из командной строки, используйте инструмент AIR Debug Launcher (ADL) для запуска приложения с помощью соответствующего файла дескриптора приложения. (Инструмент ADL находится в каталоге bin пакетов AIR SDK и Flex SDK.)

В командной строке введите следующую команду:
adl HelloWorld-app.xml 

Дополнительные сведения см. в разделе « Моделирование устройства с помощью ADL ».

Создание файла пакета APK

Если приложение успешно запущено, можно использовать утилиту ADT, чтобы упаковать приложение в файл пакета APK. Файл пакета APK — это собственный формат файлов приложений Android, которые используются для распространения приложениям пользователям.

Все приложения Android должны быть подписаны. В отличие от файлов AIR приложения Android должны быть подписаны с помощью самозаверяющего сертификата. Операционная система Android не пытается установить личность разработчика приложения. Для подписания пакетов Android можно использовать сертификат, сгенерированный с помощью ADT. Сертификаты, используемые для приложений, которые размещаются на Android Маркете, должны иметь срок действия не менее 25 лет.

Создание самозаверяющих подписывающих сертификатов и пары ключей

В командной строке введите следующую команду (выполняемый файл ADT находится в каталоге bin пакета Flex SDK):
adt -certificate -validityPeriod 25 -cn SelfSigned 1024-RSA sampleCert.pfx samplePassword

В этом примере используется минимальный набор атрибутов, которые могут быть установлены для сертификата. Необходимо использовать ключ 1024-RSA или 2048-RSA (см. раздел Команда ADT certificate ).

Создание пакета AIR

Из командной строки выполните следующую команду (вводится одной строкой):
adt -package -target apk -storetype pkcs12 -keystore sampleCert.p12 HelloWorld.apk HelloWorld-app.xml HelloWorld.swf

Будет выдано предложение ввести пароль для файла ключей. Введите пароль и нажмите клавишу Enter.

Дополнительные сведения см. в разделе « Упаковка приложения AIR для мобильных устройств ».

Установка среды выполнения AIR

Последнюю версию среды выполнения AIR на устройство можно установить с Android Маркета. Кроме того, можно установить включенную в SDK среду выполнения на устройство или в эмулятор Android.

Из командной строки выполните следующую команду (вводится одной строкой):
adt -installRuntime -platform android -platformsdk

В качестве значения флага -platformsdk укажите путь к Android SDK (родительский каталог папки tools).

ADT устанавливает файл Runtime.apk, включенный в SDK.

Дополнительные сведения см. в разделе « Установка среды выполнения AIR и приложений для разработки ».

Установка приложения AIR

Из командной строки выполните следующую команду (вводится одной строкой):
adt -installApp -platform android -platformsdk path-to-android-sdk -package path-to-app

В качестве значения флага -platformsdk укажите путь к Android SDK (родительский каталог папки tools).

Дополнительные сведения см. в разделе « Установка среды выполнения AIR и приложений для разработки ».

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