Общие настройки

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

Пространство имен, назначенное элементом application , в большей степени определяет функции, которые используются в приложении. Например, если в приложении используется пространство имен AIR 2.7, а пользователь установил более позднюю версию, приложение будет по-прежнему видеть поведение AIR 2.7 (даже если поведение в более поздней версии было изменено). Приложение получит доступ к новому поведению и функциям только после изменения пространства имен и публикации обновления. Исправления безопасности являются важным исключением из этого правила.

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

Укажите пространство имен с помощью атрибута xmlns корневого элемента application . Для мобильных приложений необходимо использовать следующие пространства имен (в зависимости от целевой мобильной платформы):

iOS 4+ and iPhone 3Gs+ or Android: 
                            <application xmlns="http://ns.adobe.com/air/application/2.7"> 
                            iOS only: 
                            <application xmlns="http://ns.adobe.com/air/application/2.0">

Некоторые настройки публикуемых приложений могут быть уникальными. К таким настройкам относятся идентификатор, имя и имя файла.

<id>com.example.MyApp</id> 
                                <name>My Application</name> 
                                <filename>MyApplication</filename>

В AIR 2.5 и более поздних версиях укажите версию приложения с помощью элемента versionNumber . Элемент version больше не используется. При указании значения для элемента versionNumber необходимо использовать последовательность из трех цифр, разделенных точками, например «0.1.2». Каждый сегмент номера версии может содержать до трех цифр (то есть максимальным номером версии может быть «999.999.999»). Номер не обязательно должен включать все три сегмента. Также допускается устанавливать версии «1» и «1.0».

Кроме того, можно задать метку для версии с помощью элемента versionLabel . Если добавлена метка версии, она отображается вместо номера версии, например в информационных окнах приложения Android. Метку версии необходимо установить для приложений, которые распространяются через Android Маркет. Если в дескрипторе приложения AIR значение элемента versionLabel не указано, для метки версии Android устанавливается значение элемента versionNumber .

<!-- AIR 2.5 and later --> 
                            <versionNumber>1.23.7<versionNumber> 
                            <versionLabel>1.23 Beta 7</versionLabel>

На платформе Android номер версии AIR versionNumber преобразуется в целое число Android versionCode по формуле: a*1000000 + b*1000 + c , где a, b и c — это компоненты номера версии AIR: a.b.c .

Укажите основной SWF-файл приложения в дочернем элементе content элемента initialWindow . Если целевое устройство имеет мобильный профиль, необходимо использовать SWF-файл (приложения на основе HTML не поддерживаются).

<initialWindow> 
                            <content>MyApplication.swf</content> 
                            </initialWindow>

Файл должен быть включен в пакет AIR (с помощью ADT или ИСР). Если только указать имя в дескрипторе приложения, это не позволит автоматически включить файл в пакет.

Исходный вид и поведение главного окна приложения определяют несколько дочерних элементов элемента initialWindow.

• aspectRatio — указывает, будет ли приложение первоначально отображаться в книжном формате (высота больше ширины), альбомном формате (высота меньше ширины) или любом формате (с автоматической настройкой по всем ориентациям).

  <aspectRatio>landscape</aspectRatio>

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

  <autoOrients>true</autoOrients>

• depthAndStencil указывает на необходимость использования глубины или трафаретного буфера. Такой тип буферов обычно используется при работе с трехмерным содержимым.

  <depthAndStencil>true</depthAndStencil>

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

  <fullScreen>true</fullScreen>

• renderMode — указывает, использует ли среда выполнения графический или центральный процессор для визуализации приложения. В общем случае визуализация с помощью графического процессора повышает скорость визуализации, однако в этом режиме недоступны некоторые функции, например определенные режимы наложения и фильтры PixelBender. Кроме того, возможности и ограничения графического процессора отличаются для разных устройств и разных драйверов устройств. По возможности приложение следует протестировать на как можно большем количестве моделей устройств, особенно при использовании режима визуализации с помощью графического процессора.

  Для режима визуализации можно установить значение gpu , cpu , direct или auto . По умолчанию установлено значение auto , при котором в настоящее время используется режим центрального процессора.

  Примечание. Чтобы использовать возможности графического ускорителя в содержимом Flash с AIR для мобильных платформ, компания Adobe рекомендует использовать параметр renderMode="direct" (т. е. Stage3D), а не renderMode="gpu". Компания Adobe официально поддерживает и рекомендует среды разработки Starling (2D) и Away3D (3D). Дополнительные сведения о Stage3D и Starling/Away3D см. на странице http://gaming.adobe.com/getstarted/ .

  <renderMode>direct</renderMode>

  Примечание. Не используйте renderMode="direct" для приложений, выполняемых в фоновом режиме.

  Режим графического процессора имеет следующие ограничения:

  • Платформа Flex не поддерживает режим визуализации с помощью графического процессора.

  • Фильтры не поддерживаются.

  • Наложения PixelBender и заполнения не поддерживаются.

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

  • Не рекомендуется использовать режим визуализации с помощью графического процессора в приложении, которое воспроизводит видео.

  • При визуализации с помощью графического процессора текстовые поля некорректно перемещаются в видимую область, если открыта виртуальная клавиатура. Чтобы текстовое поле оставалось видимым, когда пользователь вводит текст, используйте свойство рабочей области softKeyboardRect и события клавиатуры, чтобы переместить текстовое поле в видимую область.

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

  Примечание. Реализация режима работы графического процессора для ОС iOS в AIR 2.6 и более поздних версий существенно отличается от реализации в предыдущей версии AIR 2.0. Применяются другие критерии оптимизации.

Чтобы указать, какие профили устройств поддерживает приложение, можно добавить элемент supportedProfiles . Для мобильных устройств используйте профиль mobileDevice. Когда приложение запускается с помощью Adobe Debug Launcher (ADL), ADL в качестве активного профиля использует первый профиль из списка. Кроме того, при запуске ADL можно использовать -profile , чтобы выбрать определенный профиль из списка поддерживаемых. Если приложение работает во всех профилях, элемент supportedProfiles можно не указывать. В этом случае в качестве активного профиля по умолчанию ADL использует профиль настольной системы.

Чтобы настроить поддержку в приложении профилей мобильных устройств и настольной системы и протестировать приложение в профиле мобильных устройств, добавьте следующий элемент:

<supportedProfiles>mobileDevice desktop</supportedProfiles>

Приложения, поддерживающие профиль mobileDevice , могут использовать собственные расширения.

В дескрипторе приложения объявите все собственные расширения, которые используются в этом приложении AIR. В следующем примере показан синтаксис, применяемый для указания требуемых собственных расширений:

<extensions> 
                            <extensionID>com.example.extendedFeature</extensionID> 
                            <extensionID>com.example.anotherFeature</extensionID> 
                            </extensions>

Значение элемента extensionID совпадает со значением элемента id в файле дескриптора расширения. Файл дескриптора расширения — это файл XML с именем extension.xml. Он упакован в ANE-файл, получаемый от разработчика собственного расширения.

Установите для элемента softKeyboardBehavior значение none , чтобы отключить функции автоматического панорамирования и изменение размера, с помощью которых среда выполнения обеспечивает, что поле, в которое вводится текст, остается видимым после открытия виртуальной клавиатуры. Если автоматическая функция отключена, эту роль берет на себя приложение, обеспечивая видимость области ввода текста или другого релевантного содержимого после вызова клавиатуры. Свойство рабочей области softKeyboardRect можно использовать вместе с событием SoftKeyboardEvent, чтобы определять, когда клавиатура открывается, и какую область она закрывает.

Для включения автоматического поведения установите для элемента значение pan :

<softKeyboardBehavior>pan</softKeyboardBehavior>