Adobe air and android

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

На посты, размещаемые в Twitter™ и Facebook, условия Creative Commons не распространяются.

Источник

Настройки Android

На платформе Android можно использовать элемент дескриптора приложения android , чтобы добавить информацию в манифест приложения Android, который представляет собой файл свойств приложения, используемый в операционной системе Android. ADT автоматически генерирует файл Manifest.xml при создании пакета APK. AIR задает свойства значений, которые требуются для работы определенных функций. Все остальные свойства, настроенные в разделе android дескриптора приложения AIR, добавляются в соответствующий раздел файла Manifest.xml.

Настроить можно только атрибуты, значения которых имеют строковый, целый и логический тип. Настройка ссылок на ресурсы в пакете приложения не поддерживается.

Зарезервированные настройки манифеста Android

AIR настраивает несколько параметров в созданном манифесте Android, чтобы обеспечить корректную работу приложения и среды выполнения. Можно определить следующие настройки:

Элемент manifest

Следующие атрибуты элемента manifest не доступны для настройки:

Элемент activity

Следующие атрибуты элемента activity не доступны для настройки:

Элемент application

Следующие атрибуты элемента application не доступны для настройки:

Разрешения Android

В соответствии с моделью безопасности Android требуется, чтобы приложения запрашивали разрешение на использование функций, связанных с безопасностью и конфиденциальностью. Эти разрешения необходимо указать при упаковке приложений. Они не могут быть изменены во время выполнения. При установке пользователем приложения операционная система Android сообщает, какие разрешения приложение запрашивает. Если требуемое для функции разрешение не запрашивается, операционная система Android может выдать исключение при попытке приложения получить доступ к функции, но исключение не гарантируется. Исключения передаются средой выполнения в приложение. В режиме безопасного возврата сообщения об ошибках, связанных с разрешениями, добавляются в системный журнал Android

В среде AIR разрешения Android задаются в дескрипторе приложения с помощью элемента android . При добавлении разрешений используется следующий формат (здесь PERMISSION_NAME — это имя разрешения Android):

Инструкции по использованию разрешений, настроенные с помощью элемента manifest , добавляются непосредственно в манифест Android.

Для использования функций AIR требуются следующие разрешения:

ACCESS_COARSE_LOCATION Разрешает приложению доступ к данным о местоположении, предоставляемым сетью WIFI или сотовой сетью, которые получаются через класс Geolocation.

ACCESS_FINE_LOCATION: Разрешает приложению доступ к данным GPS через класс Geolocation.

ACCESS_NETWORK_STATE и ACCESS_WIFI_STATE: Разрешает приложению доступ к сведениям о сети через класс NetworkInfo.

CAMERA: Разрешает приложению доступ к камере.

INTERNET: Разрешает приложению выполнять запросы по сети. Также разрешает удаленную отладку.

READ_PHONE_STATE: Разрешает среде выполнения AIR приглушать звук во время телефонных вызовов. Данное разрешение необходимо настроить, если приложение воспроизводит видео в фоновом режиме.

RECORD_AUDIO: Разрешает приложению доступ к микрофону.

WAKE_LOCK и DISABLE_KEYGUARD Разрешает приложению предотвращать переход устройства в режим сна с помощью параметров класса SystemIdleMode.

WRITE_EXTERNAL_STORAGE: Разрешает приложению выполнять запись на внешнюю карту памяти устройства.

Например, чтобы настроить разрешения для приложения, которому требуются все доступные разрешения, в дескриптор приложения можно добавить следующий код:

Пользовательские схемы URI Android

Для запуска приложения AIR с веб-страницы или собственного приложения Android можно применять пользовательскую схему URI. Поддержка пользовательских URI реализована с помощью фильтров намерений, настроенных в манифесте Android, поэтому данный метод недоступен на других платформах.

Фильтр намерений указывает операционной системе Android, что приложение доступно для выполнения определенного действия. В случае пользовательского URI это означает, что пользователь нажал на ссылку, использующую данную схему URI (и браузер не знает, как обработать это событие).

Когда приложение вызывается с помощью пользовательского URI, объект NativeApplication отправляет событие invoke . URL ссылки с параметрами запроса помещается в массив arguments объекта InvokeEvent. Можно настроить любое количество фильтров намерений.

Фильтры совместимости Android

Операционная система Android использует количество элементов в файле манифеста приложения для определения того, совместимо ли приложение с данным устройством. Добавление этой информации в манифест не является обязательным. Если эти элементы не включены, приложение может быть установлено на любом устройстве Android. Однако оно не обязательно будет работать на всех устройствах Android. Например, приложение камеры будет не слишком полезно на телефоне без камеры.

Для фильтрации применяются следующие теги манифеста Android:

uses-sdk (в AIR 3+)

Приложения камеры

Если запрашивается разрешение на использование камеры в приложении, Android предполагает, что приложению требуются все функции камеры, включая автофокусировку и вспышку. Если приложению требуются не все функции камеры или камера является необязательной функцией, для камеры необходимо задать различные элементы uses-feature , чтобы указать, какие не являются обязательными. В противном случае пользователи, устройства которых не поддерживают какую-либо из функций или на которых нет камеры, не смогут найти ваше приложение на Android Маркете.

В следующем примере показано, как запросить разрешения для камеры и указать, что все функции камеры являются необязательными:

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

Если запрашивается разрешение для записи звука, Android предполагает, что приложению требуется микрофон. Если функция запись звука является необязательной, можно добавить тег uses-feature и указать, что микрофон не требуется. В противном случае пользователи, на устройствах которых нет микрофона, не смогут найти ваше приложение на Android Маркете.

В следующем примере показано, как запросить разрешение на использование микрофона и указать, что наличие микрофон не является обязательным:

Расположение для установки

Чтобы разрешить установку или перенос приложения на внешнюю карту памяти, задайте для атрибута installLocation элемента Android manifest значение auto или preferExternal :

Операционная система Android не гарантирует, что приложение будет установлено во внешнюю память. Пользователь может переносить приложение из внутренней во внешнюю память и обратно с помощью системных настроек.

Даже когда приложение установлено во внешнюю память, кэш приложение и пользовательские данные, включая содержимое каталога app-storage, общие объекты и временные файлы, по-прежнему остаются во внутренней памяти. Чтобы не занимать слишком большой объем внутренней памяти, внимательно выбирайте данные, которые будут помещены в каталог хранилища приложения. Большие объемы данных следует сохранять на SD-карте, используя местоположения File.userDirectory или File.documentsDirectory (которые ссылаются на корневой каталог SD-карты на Android).

Включение проигрывателя Flash Player и других подключаемых модулей в объекте StageWebView

В ОС Android 3.0 и более поздних версий приложение должно включать аппаратное ускорение в элементе приложения Android, чтобы содержимое подключаемого модуля отображалось в объекте StageWebView. Чтобы включить визуализацию для подключаемого модуля, задайте атрибуту android:hardwareAccelerated элемента application значение true :

Глубина цвета

В AIR 3 и более поздних версий среда выполнения настраивает дисплей для визуализации цветов с глубиной 32 бита. В более ранних версиях AIR среда выполнения использует глубину цвета 16 бит. Чтобы указать среде выполнения на необходимость использования глубины цвета 16 бит, используйте элемент дескриптора приложения.

При использовании глубины цвета 16 бит увеличивается скорость визуализации, но ухудшается точность цветопередачи.

Источник