Элементы дескриптора приложения AIR

Разрешает API-интерфейсу AIR, встроенному в браузер, обнаруживать и запускать приложение.

Если это значение равно true , учитывайте ограничения системы защиты. Они·описаны·в разделах Вызов приложения AIR из обозревателя (для разработчиков ActionScript) и Вызов приложения AIR из обозревателя (для разработчиков HTML).

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

Родительский элемент: application

Дочерние элементы: нет

<allowBrowserInvocation>true</allowBrowserInvocation>

Разрешает добавлять элементы в файл манифеста Android. AIR создает файл AndroidManifest.xml для каждого пакета APK. Для добавления дополнительных элементов в дескрипторе приложения можно использовать элемент android. Игнорируется на всех платформах, кроме Android.

Родительский элемент: application

Дочерние элементы:

• colorDepth

• manifestAdditions

<android> 
    <manifestAdditions> 
        ... 
    </manifestAdditions> 
</android>

Корневой элемент дескриптора приложения AIR.

Родительский элемент: нет

Дочерние элементы:

• allowBrowserInvocation

• android

• copyright

• customUpdateUI

• description

• extensions

• filename

• fileTypes

• icon

• id

• initialWindow

• installFolder

• iPhone

• name

• programMenuFolder

• publisherID

• supportedLanguages

• supportedProfiles

• version

• versionLabel

• versionNumber

xmlns="http://ns.adobe.com/air/application/1.0" 
xmlns="http://ns.adobe.com/air/application/1.1" 
xmlns="http://ns.adobe.com/air/application/1.5" 
xmlns="http://ns.adobe.com/air/application/1.5.2" 
xmlns="http://ns.adobe.com/air/application/1.5.3" 
xmlns="http://ns.adobe.com/air/application/2.0" 
xmlns="http://ns.adobe.com/air/application/2.5" 
xmlns="http://ns.adobe.com/air/application/2.6" 
xmlns="http://ns.adobe.com/air/application/2.7" 
xmlns="http://ns.adobe.com/air/application/3.0" 
xmlns="http://ns.adobe.com/air/application/3.1" 
xmlns="http://ns.adobe.com/air/application/3.2" 
xmlns="http://ns.adobe.com/air/application/3,3" 
xmlns="http://ns.adobe.com/air/application/3.4" 
xmlns="http://ns.adobe.com/air/application/3.5" 
xmlns="http://ns.adobe.com/air/application/3.6" 
xmlns="http://ns.adobe.com/air/application/3.7"

<?xml version="1.0" encoding="utf-8" ?> 
<application xmlns="http://ns.adobe.com/air/application/3.0"> 
    <id>HelloWorld</id> 
    <version>2.0</version> 
    <filename>Hello World</filename> 
    <name>Example Co. AIR Hello World</name> 
     <description> 
        <text xml:lang="en">This is an example.</text> 
        <text xml:lang="fr">C'est un exemple.</text> 
        <text xml:lang="es">Esto es un ejemplo.</text> 
    </description> 
    <copyright>Copyright (c) 2010 Example Co.</copyright> 
    <initialWindow> 
        <title>Hello World</title> 
        <content> 
            HelloWorld.swf 
        </content> 
        <systemChrome>none</systemChrome> 
        <transparent>true</transparent> 
        <visible>true</visible> 
        <minSize>320 240</minSize> 
    </initialWindow>  
    <installFolder>Example Co/Hello World</installFolder> 
    <programMenuFolder>Example Co</programMenuFolder> 
    <icon> 
        <image16x16>icons/smallIcon.png</image16x16> 
        <image32x32>icons/mediumIcon.png</image32x32> 
        <image48x48>icons/bigIcon.png</image48x48> 
        <image128x128>icons/biggestIcon.png</image128x128>  
    </icon> 
    <customUpdateUI>true</customUpdateUI> 
    <allowBrowserInvocation>false</allowBrowserInvocation> 
    <fileTypes> 
        <fileType> 
            <name>adobe.VideoFile</name> 
            <extension>avf</extension> 
            <description>Adobe Video File</description> 
            <contentType>application/vnd.adobe.video-file</contentType> 
            <icon> 
                <image16x16>icons/avfIcon_16.png</image16x16> 
                <image32x32>icons/avfIcon_32.png</image32x32> 
                <image48x48>icons/avfIcon_48.png</image48x48> 
                <image128x128>icons/avfIcon_128.png</image128x128> 
            </icon> 
        </fileType> 
    </fileTypes> 
</application>

Определяет соотношение сторон экрана приложения.

Если параметр не указан, приложение открывается с «естественным» соотношением сторон и ориентацией устройства. Естественная ориентация на разных устройствах может отличаться. Обычно на устройствах с небольшим экраном, например на телефонах, это портретное соотношение сторон. На некоторых устройствах, таких как планшеты iPad, приложение открывается с текущей ориентацией. В среде AIR 3.3 и более поздних версий это применяется ко всему приложению, а не только к начальному экрану.

Родительский элемент: initialWindow

Дочерние элементы: нет

<aspectRatio>landscape</aspectRatio>

Указывает, изменяется ли автоматически ориентация содержимого в приложении при изменении физического положения самого устройства. Дополнительные сведения см. на веб-странице « Ориентация рабочей области ».

При использовании функции автоматической ориентации попробуйте установить следующие значения для свойств Stage align и scaleMode :

stage.align = StageAlign.TOP_LEFT; 
stage.scaleMode = StageScaleMode.NO_SCALE;

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

Родительский элемент: initialWindow

Дочерние элементы: нет

<autoOrients>true</autoOrients>

Указывает какую глубину цвета необходимо использовать: 16 бит или 32 бита.

При использовании глубины цвета 16 бит увеличивается скорость визуализации, но ухудшается точность цветопередачи. До AIR 3 на устройствах Android всегда используется 16-битный цвет. В AIR 3 по умолчанию используется 32-битный цвет.

Родительский элемент: android

Дочерние элементы: нет

<android> 
    <colorDepth>16bit</colorDepth> 
    <manifestAdditions>...</manifestAdditions> 
</android>

Определяет, будет приложение содержать видео или нет.

Родительский элемент: android

Дочерние элементы: нет

<android> 
    <containsVideo>true</containsVideo> 
    <manifestAdditions>...</manifestAdditions> 
</android>

Значение элемента content — это URL-адрес главного файла с содержимым в приложении. Это может быть файл в формате SWF или HTML. URL-адрес задается относительно корневого расположения установочной папки. (Если приложение AIR работает с ADL, URL-адрес задается относительно папки, в которой расположен файл дескриптора приложения. Указать другой корневой каталог можно с помощью параметра root-dir в ADL).

Родительский элемент: initialWindow

Дочерние элементы: нет

<content>TravelPlanner.swf</content>

Элемент contentType требуется в AIR 1.5 (он был необязательным в AIR 1.0 и 1.1). Это свойство помогает некоторым операционным системам выбирать лучшее приложение для открытия файла. Значение должно быть типом содержимого MIME. Обратите внимание, что это значение игнорируется в Linux, если тип файла уже зарегистрирован и имеет назначенный тип MIME.

Родительский элемент: fileType

Дочерние элементы: нет

<contentType>text/plain</contentType>

Информация об авторских правах для приложения AIR. В Mac OS информация об авторских правах отображается в диалоговом окне «О программе» в меню установленного приложения. В Mac OS информация об авторских правах также используется в поле NSHumanReadableCopyright файла Info.plist.

Родительский элемент: application

Дочерние элементы: нет

<copyright>© 2010, Examples, Inc.All rights reserved.</copyright>

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

Когда в установленной версии приложения элемент customUpdateUI имеет значение true и пользователь дважды щелкает на файле AIR для получения новой версии или устанавливает приложение с помощью функции непрерывной установки, в среде выполнения открывается установленная версия приложения. Среда выполнения не открывает заданный по умолчанию установщик приложения AIR. Ход процесса обновления может определяться логикой приложения. (Идентификатор приложения и идентификатор издателя в файле AIR должны совпадать с аналогичными значениями в установленном приложении, чтобы удалось выполнить обновление).

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

Родительский элемент: application

Дочерние элементы: нет

<customUpdateUI>true</customUpdateUI>

Указывает на необходимость использования приложением глубины или трафаретного буфера. Такой тип буферов обычно используется при работе с трехмерным содержимым. По умолчанию значение этого элемента равно false — глубина и трафаретные буферы отключены. Необходимость этого элемента определяется тем, что буферы должны быть выделены в момент запуска приложения, до того, как будет загружено любое содержимое.

Значение, установленное для данного элемента, должно совпадать со значением, переданным в аргументе enableDepthAndStencil методу Context3D.configureBackBuffer() . Если эти значения на совпадают, AIR сообщит об ошибке.

Данный элемент применим только в случае, если renderMode = direct . Если значение renderMode отличается от direct , ADT генерирует ошибку 118:

<depthAndStencil> element unexpected for render mode cpu.  It requires "direct" render mode.

Родительский элемент: initialWindow

Дочерние элементы: нет

<depthAndStencil>true</depthAndStencil>

Описание приложения, отображаемое в установщике приложения AIR.

Если задан единый текстовый узел (вместо нескольких элементов text), установщик приложения AIR использует это описание вне зависимости от языка системы. В противном случае установщик AIR использует описание, наиболее близкое к языку пользовательского интерфейса операционной системы. Например, рассмотрим процесс установки, где элемент description файла дескриптора приложения содержит значение для английской локали (en). Установщик приложения AIR использует описание en, если язык интерфейса операционной системы определяется как английский (en). Также описание en используется, если языком системы является английский США (en-US). Однако если в системе используется английский США (en-US), а в файле дескриптора приложения определяются имена как для американского (en-US), так и британского (en-GB) английского, то установщик приложения AIR использует значение en-US. Если в приложении не задано описание, соответствующее языкам пользовательского интерфейса, установщик приложения AIR использует первое значение description из списка в файле дескриптора приложения.

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

Родительский элемент: application

Дочерние элементы: text

<description>This is a sample AIR application.</description> 

<description> 
    <text xml:lang="en">This is an example.</text> 
    <text xml:lang="fr">C'est un exemple.</text> 
    <text xml:lang="es">Esto es un ejemplo.</text> 
</description> 

Описание типа файла показывается пользователю операционной системой. Локализация описания типа файла не выполняется.

См. также описание элемента description , являющегося дочерним элементом для application

Родительский элемент: fileType

Дочерние элементы: нет

<description>PNG image</description>

Позволяет использовать заказные шрифты для экземпляра StageText в приложении AIR. Это необязательный элемент.

Родительский элемент: application

Дочерние элементы: font

<embedFonts> 
   <font> 
      <fontPath>ttf/space age.ttf</fontPath>
      <fontName>space age</fontName> 
   </font>
   <font> 
      <fontPath>ttf/xminus.ttf</fontPath>
      <fontName>xminus</fontName> 
   </font>
</embedFonts>

В ОС iOS используются свойства, называемые entitlements (разрешения), обеспечивающие приложению доступ к дополнительным ресурсам и возможностям. Эта информация для мобильных приложений ОС iOS задается в элементе Entitlements.

Родительский элемент: iPhone

Дочерние элементы: элементы Entitlements.plist ОС iOS

<iphone> 
... 
   <Entitlements> 
      <![CDATA[ 
         <key>aps-environment</key> 
         <string>development</string> 
      ]]> 
   </Entitlements> 
</iphone>

Строка расширения типа файла.

Родительский элемент: fileType

Дочерние элементы: нет

<extension>png</extension>

Указывает идентификатор расширения ActionScript, который используется в приложении. Идентификатор определен в дескрипторе расширения.

Родительский элемент: extensions

Дочерние элементы: нет

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

Определяет расширения ActionScript, которые используются в приложении.

Родительский элемент: application

Дочерние элементы: extensionID

<extensions> 
    <extensionID>extension.first</extensionID> 
    <extensionID>extension.next</extensionID> 
    <extensionID>extension.last</extensionID> 
</extensions>

Задает имя текстового файла со списком SWF-файлов, которые должны быть настроены ADT для размещения на удаленном сервере. Можно уменьшить первоначальный размер загружаемого приложения путем упаковки подмножества SWF-файлов, используемых приложением, и загрузки оставшихся SWF-файлов (содержащих только ресурсы) во время выполнения с помощью метода Loader.load() . Для использования этой функции необходимо упаковать приложение таким образом, чтобы ADT переместил весь код ActionScript ByteCode (ABC) из внешне загружаемых SWF-файлов в главный SWF-файл приложения, оставляя SWF-файл, содержащий только ресурсы. Этого требует правило Apple Store, запрещающее загрузку любого кода после установки приложения.

Дополнительные сведения см. в разделе Уменьшение загружаемого объема путем загрузки внешних ресурсных SWF .

Родительский элемент: iPhone , initialWindow

Дочерние элементы: нет

<iPhone> 
    <externalSwfs>FileContainingListofSWFs.txt</externalSwfs> 
</iPhone>

Строка, используемая в качестве имени файла приложения (без расширения) при установке. Файл приложения запускает приложение AIR в среде выполнения. Если значение name не задано, filename также используется в качестве имени установочной папки.

Родительский элемент: application

Дочерние элементы: нет

<filename>MyApplication</filename>

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

Родительский элемент: fileTypes

Дочерние элементы:

• contentType

• description

• extension

• icon

• name

<fileType> 
    <name>foo.example</name> 
    <extension>foo</extension> 
    <description>Example file type</description> 
    <contentType>text/plain</contentType> 
    <icon> 
        <image16x16>icons/fooIcon16.png</image16x16> 
        <image48x48>icons/fooIcon48.png</imge48x48> 
    <icon> 
</fileType>

Элемент fileTypes позволяет объявлять типы файлов, с которыми могут сопоставляться приложения AIR.

После установки приложения AIR, любой объявляемый тип файла регистрируется в операционной системе и, если эти типы файлов еще не сопоставлены с другим приложением, они назначаются приложению AIR. Для переопределения существующих сопоставлений типов файлов с другими приложениями используйте метод NativeApplication.setAsDefaultApplication() во время выполнения (желательно с разрешения пользователя).

Элемент fileTypes является необязательным.

Родительский элемент: application

Дочерние элементы: fileType

<fileTypes> 
    <fileType> 
        <name>adobe.VideoFile</name> 
        <extension>avf</extension> 
        <description>Adobe Video File</description> 
        <contentType>application/vnd.adobe.video-file</contentType> 
        <icon> 
            <image16x16>icons/AIRApp_16.png</image16x16>       
            <image32x32>icons/AIRApp_32.png</image32x32>       
            <image48x48>icons/AIRApp_48.png</image48x48>      
            <image128x128>icons/AIRApp_128.png</image128x128> 
        </icon> 
    </fileType> 
</fileTypes>

Описывает один заказной шрифт, который можно использовать в приложении AIR.

Родительский элемент: embedFonts

Дочерние элементы: fontName , fontPath

<font> 
   <fontPath>ttf/space age.ttf</fontPath>
   <fontName>space age</fontName> 
</font>

Указывает имя заказного шрифта.

Родительский элемент: font

Дочерние элементы: нет

<fontName>space age</fontName> 

Указывает местоположение файла заказного шрифта.

Родительский элемент: font

Дочерние элементы: нет

<fontPath>ttf/space age.ttf</fontPath> 

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

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

Родительский элемент: iPhone , initialWindow

Дочерние элементы: нет

... 
<renderMode>GPU</renderMode> 
... 
<iPhone> 
... 
   <forceCPURenderModeForDevices>iPad1,1 iPhone1,1 iPhone1,2 iPod1,1 
   </forceCPURenderModeForDevices> 
</iPhone>

Указывает, запускается ли приложение в полноэкранном режиме.

Родительский элемент: initialWindow

Дочерние элементы: нет

<fullscreen>true</fullscreen>

Исходная высота главного окна приложения.

Если высота не задана, она определяется настройками в корневом SWF-файле, а для приложений AIR на основе HTML высоту определяет операционная система.

В AIR 2 максимальная высота окна увеличена с 2048 до 4096 пикселов.

Родительский элемент: initialWindow

Дочерние элементы: нет

<height>4095</height>

Свойство icon указывает один или несколько файлов значков, которые используются в приложении. Значки не являются обязательными. Если свойство icon не задано, операционная система отображает значок по умолчанию.

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

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

Рекомендуется создать изображение для всех размеров значков. Кроме того, проверьте, хорошо ли смотрятся значки в 16- и 32-битном режиме.

Родительский элемент: application

Дочерние элементы: imageNxN

<icon> 
    <image16x16>icons/smallIcon.png</image16x16> 
    <image32x32>icons/mediumIcon.png</image32x32> 
    <image48x48>icons/bigIcon.png</image48x48> 
    <image128x128>icons/biggestIcon.png</image128x128>  
</icon>

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

Родительский элемент: application

Дочерние элементы: нет

<id>org.example.application</id>

Определяет путь к значку относительно каталога приложения.

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

• image16x16

• image29x29 (AIR 2+)

• image32x32

• image36x36 (AIR 2.5+)

• image48x48

• image50x50 (AIR 3.4+)

• image57x57 (AIR 2+)

• image58x58 (AIR 3.4+)

• image72x72 (AIR 2+)

• image100x100 (AIR 3.4+)

• image114x114 (AIR 2.6+)

• image128x128

• image144x144 (AIR 3.4+)

• image512x512 (AIR 2+)

• image1024x1024 (AIR 3.4+)

Значки должны быть созданы в формате PNG и иметь размер, заданный с помощью элемента imgage. Файлы значков следует включить в пакет приложения. Значки, ссылки на которые содержатся в дескрипторе приложения, не включаются автоматически.

Родительский элемент: application

Дочерние элементы: нет

<image32x32>icons/icon32.png</image32x32>

Позволяет указывать дополнительные свойства приложения iOS.

Родительский элемент: iPhone

Дочерние элементы: элементы Info.plist ОС iOS

<InfoAdditions> 
    <![CDATA[ 
        <key>UIStatusBarStyle</key> 
        <string>UIStatusBarStyleBlackOpaque</string> 
        <key>UIRequiresPersistentWiFi</key> 
        <string>NO</string> 
    ]]> 
</InfoAdditions>

Определяет основной файл содержимого и исходный вид приложения.

Родительский элемент: application

<initialWindow> 
    <title>Hello World</title> 
    <content> 
        HelloWorld.swf 
    </content> 
    <depthAndStencil>true</depthAndStencil> 
    <systemChrome>none</systemChrome> 
    <transparent>true</transparent> 
    <visible>true</visible> 
    <maxSize>1024 800</maxSize> 
    <minSize>320 240</minSize> 
    <maximizable>false</maximizable> 
    <minimizable>false</minimizable> 
    <resizable>true</resizable> 
    <x>20</x> 
    <y>20</y> 
    <height>600</height> 
    <width>800</width> 
    <aspectRatio>landscape</aspectRatio> 
    <autoOrients>true</autoOrients> 
    <fullScreen>false</fullScreen> 
    <renderMode>direct</renderMode> 
</initialWindow>

Определяет подкаталог в установочной папке по умолчанию.

В Windows установочным подкаталогом по умолчанию является папка Program Files. В Mac OS это папка /Applications. В Linux это /opt/. Например, если значение свойства installFolder равно "Acme" , а приложение называется "ExampleApp" , то оно будет установлено в каталог C:\Program Files\Acme\ExampleApp в Windows, в /Applications/Acme/Example.app в MacOS и в /opt/Acme/ExampleApp в Linux.

Свойство installFolder не является обязательным. Если свойство installFolder не задано, приложение устанавливается в подкаталог установочной папки по умолчанию на основании свойства name .

Родительский элемент: application

Дочерние элементы: нет

<installFolder>utilities/toolA</installFolder>

Определяет свойства приложения, специфические для ОС iOS.

Родительский элемент: application

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

Родительский элемент: manifestAdditions

Дочерние элементы: определены в Android SDK.

<![CDATA[      
    <manifest android:sharedUserID="1001"> 
        <uses-permission android:name="android.permission.CAMERA"/> 
        <uses-feature android:required="false" android:name="android.hardware.camera"/> 
        <application     android:allowClearUserData="true" 
                    android:enabled="true" 
                    android:persistent="true"/> 
    </manifest> 
]]>

Указывает информацию, которая должна быть добавлена в файл манифеста Android.

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

Родительский документ: android

Дочерние элементы: manifest

<manifestAdditions> 
    <![CDATA[      
        <manifest android:installLocation="preferExternal"> 
            <uses-permission android:name="android.permission.INTERNET"/> 
            <application     android:allowClearUserData="true" 
                        android:enabled="true" 
                        android:persistent="true"/> 
        </manifest> 
    ]]> 
</manifestAdditions>

Определяет возможность разворачивания окна.

Родительский элемент: initialWindow

Дочерние элементы: нет

<maximizable>false</maximizable>

Максимальные размеры окна. Если максимальный размер не задан, он определяется операционной системой.

Родительский элемент: initialWindow

Дочерние элементы: нет

<maxSize>1024 360</maxSize>

Определяет возможность сворачивания окна.

Родительский элемент: initialWindow

Дочерние элементы: нет

<minimizable>false</minimizable>

Указывает минимально разрешенный размер окна.

Родительский элемент: initialWindow

Дочерние элементы: нет

<minSize>120 60</minSize>

Название приложение, которое отображается в установщике приложения AIR.

Если элемент name не задан, установщик приложения AIR отображает в качестве имени приложения значение filename .

Родительский элемент: application

Дочерние элементы: text

<name>Test Application</name> 

<name> 
    <text xml:lang="en">Hello AIR</text> 
    <text xml:lang="fr">Bonjour AIR</text> 
    <text xml:lang="es">Hola AIR</text> 
</name> 

Указывает название типа файла.

Родительский элемент: fileType

Дочерние элементы: нет

<name>adobe.VideoFile</name>

Определяет расположение ярлыков приложения в меню «Программы» в ОС Windows или в меню «Приложения» (Applications) в Linux (эта настойка в настоящее время не учитывается в других операционных системах).

Родительский элемент: application

Дочерние элементы: нет

<programMenuFolder>Example Company/Sample Application</programMenuFolder>

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

При создании обновления для приложения следует указывать только идентификатор издателя. В качестве значения элемента publisherID следует указать идентификатор издателя, сгенерированный инструментом AIR для более ранней версии приложения. Идентификатор издателя для установленного приложения можно найти в папке, в которой установлено приложение, в файле META-INF/AIR/publisherid .

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

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

Родительский элемент: application

Дочерние элементы: нет

<publisherID>B146A943FBD637B68C334022D304CEA226D129B4.1</publisherID>

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

Родительский элемент: initialWindow

Дочерние элементы: нет

<renderMode>direct</renderMode>

Определяет разрешение, которое используется приложением на устройствах и компьютерах с дисплеем высокого разрешения: стандартное (standard) или высокое (high). Если установлено значение standard , по умолчанию приложение считает, что экран имеет стандартное разрешение. Если установлен параметр high , в приложении можно будет использовать все доступные пиксели.

К примеру, в случае дисплея iPhone с разрешением 640x960, при значении standard полное разрешение экрана будет 320x480, и каждый пиксел приложения будет занимать четыре пиксела экрана. При значении high полное разрешение экрана будет 640x960.

На устройствах со стандартным разрешением экрана размер рабочей области соответствует размерам экрана независимо от заданных настроек.

Если элемент requestedDisplayResolution вложен в элемент iPhone , он относится к устройствам iOS. В этом случае может использоваться атрибут excludeDevices для указания тех устройств, к которым этот параметр не применяется.

Если элемент requestedDisplayResolution вложен в элемент initialWindow , он относится к настольным приложениям AIR на компьютерах MacBook Pro, поддерживающих дисплей высокого разрешения. Указанное значение действительно для всех собственных окон платформы в данном приложении. Вложение элемента requestedDisplayResolution в initialWindow поддерживается с версии AIR 3.6.

Родительский элемент: iPhone , initialWindow

Дочерние элементы: нет

<initialWindow> 
    <requestedDisplayResolution>high</requestedDisplayResolution> 
</initialWindow>

<iPhone> 
    <requestedDisplayResolution excludeDevices="iPad3 iPad4">high</requestedDisplayResolution> 
</iPhone>

Определяет возможность изменения размеров окна.

Родительский элемент: initialWindow

Дочерние элементы:

<resizable>false</resizable>

Определяет поведение приложения по умолчанию при отображении виртуальной клавиатуры. По умолчанию окно приложение смещается вверх. Среда выполнения сохраняет фокус в текстовом поле или интерактивном объекте на экране. Используйте параметр pan , если в приложении нет собственной логики для обработки клавиатуры.

Автоматическое поведение можно отключить, установив для элемента softKeyboardBehavior значение none . В этом случае текстовые поля и интерактивные элементы передают событие SoftKeyboardEvent по нажатию программной клавиши, однако среда выполнения не сдвигает и не изменяет размер окна приложения. Видимость области ввода обеспечивает приложение.

Родительский элемент: initialWindow

Дочерние элементы: нет

<softKeyboardBehavior>none</softKeyboardBehavior>

Идентифицирует языки, поддерживаемые приложением. Этот элемент используется только в iOS, связанной среде выполнения Mac и приложениях Android. Элемент игнорируется приложениями любых других типов.

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

Родительский элемент: application

Дочерние элементы: нет

<supportedLanguages>en ja fr es</supportedLanguages>

Идентифицирует профили, поддерживаемые для приложения.

Родительский элемент: application

Дочерние элементы: нет

<supportedProfiles>desktop extendedDesktop</supportedProfiles>

<supportedProfiles>desktop mobileDevice</supportedProfiles>

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

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

Родительский элемент: initialWindow

Дочерние элементы: нет

<systemChrome>standard</systemChrome>

Определяет локализованную строку.

Атрибут xml:lang текстового элемента задает код языка согласно документу RFC4646 (http://www.ietf.org/rfc/rfc4646.txt).

Установщик приложений AIR использует элемент text со значением атрибута xml:lang , которое наиболее точно соответствует языку операционной системы пользователя.

Например, можно выполнить установку, используя элемент text со значением «en», задающим английский язык. Установщик приложения AIR использует значение en, если язык пользовательского интерфейса определяется как английский (en). Также имя en используется, если языком системы является английский США (en-US). Однако если для пользовательского интерфейса установлен английский США (en-US), а в файле дескриптора приложения определяются имена как для американского (en-US), так и британского (en-GB) английского, то установщик приложения AIR использует значение en-US.

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

Дочерние элементы: нет

<text xml:lang="fr">Bonjour AIR</text>

Определяет заголовок, отображаемый в панели заголовка исходного окна приложения.

Заголовок отображается только в том случае, если для элемента systemChrome установлено значение standard .

Родительский элемент: initialWindow

Дочерние элементы: нет

<title>Example Window Title</title>

Определяет, применяется ли альфа-блендинг при наложении исходного окна приложения на рабочий стол.

Окно с прозрачными областями прорисовывается медленнее и требует больше ресурсов памяти. Параметр прозрачности нельзя изменить во время выполнения.

Родительский элемент: initialWindow

Дочерние элементы: нет

<transparent>true</transparent>

Указывает номер версии приложения.

Строка версии зависит от приложения. AIR никоим образом не интерпретирует строку версии. Следовательно, версия «3.0» не обязательно будет новее, чем «2.0». Примеры: «1.0» , «.4» , «0.5» , «4.9» , «1.3.4a» .

В AIR 2.5 и более поздних версиях элемент version заменяется элементами versionNumber и versionLabel .

Родительский элемент: application

Дочерние элементы: нет

<version>0.1 Alpha</version>

Указывает строку с версией в удобном для восприятия представлении.

Значение метки версии отображается в диалоговых окнах установки вместо значения элемента versionNumber . Если элемент versionLabel не используется, в обоих случаях будет использоваться элемент versionNumber .

Родительский элемент: application

Дочерние элементы: нет

<versionLabel>0.9 Beta</versionlabel>

Номер версии приложения.

Родительский элемент: application

Дочерние элементы: нет

<versionNumber>1.0.657</versionNumber> 
 
<versionNumber>10</versionNumber> 
 
<versionNumber>0.01</versionNumber>

Определяет, является ли окно видимым сразу после его создания.

Окна AIR, включая исходное окно, по умолчанию при создании являются невидимыми. Затем окно можно отобразить, вызвав для окна метод activate() объекта NativeWindow или задав для свойства visible значение true . Иногда полезно скрывать основное окно вначале, чтобы изменения его положения, размера и компоновки его элементов не отображались.

Компонент Flex mx:WindowedApplication автоматически отображает и активирует окно непосредственно перед отправкой события applicationComplete , кроме случаев, когда атрибут visible имеет значение false в определении MXML.

В профилях мобильных устройств, которые не поддерживают окна, элемент visible игнорируется.

Родительский элемент: initialWindow

Дочерние элементы: нет

<visible>true</visible>

Исходная ширина главного окна приложения.

Если ширина не задана, она определяется настройками в корневом SWF-файле, а для приложений AIR на основе HTML высоту определяет операционная система.

В AIR 2 максимальная ширина окна увеличена с 2048 до 4096 пикселов.

Родительский элемент: initialWindow

Дочерние элементы: нет

<width>1024</width>

Положение исходного окна приложения по горизонтали.

В большинстве случаев рекомендуется вместо задания фиксированного значения рекомендуется разрешить операционной системе определять исходное положение.

Точка начала координат экрана (0,0) — это левый верхний угол основного окна экрана (определяется операционной системой).

Родительский элемент: initialWindow

Дочерние элементы: нет

<x>120</x>

Положение исходного окна приложения по вертикали.

В большинстве случаев рекомендуется вместо задания фиксированного значения рекомендуется разрешить операционной системе определять исходное положение.

Точка начала координат экрана (0,0) — это левый верхний угол основного окна экрана (определяется операционной системой).

Родительский элемент: initialWindow

Дочерние элементы: нет

<y>250</y>