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

В этом разделе описаны принципы создания дескриптора приложения, представляющего собой 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 , содержащий скомпилированный код приложения.

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

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

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

adl HelloWorld-app.xml 

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

Если приложение успешно запущено, можно использовать утилиту 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 и приложений для разработки ».

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