Настройка свойств приложения для настольных систем

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

Требуемая версия среды выполнения AIR

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

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

Укажите пространство имен с помощью атрибута xmlns корневого элемента application :

<application xmlns="http://ns.adobe.com/air/application/3.0">

Идентификация приложения

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

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

Версия приложения

В версиях AIR до AIR 2.5 укажите элемент version . Можно использовать любую строку. Среда выполнения AIR не интерпретирует строку. Версия «2.0» не рассматривается как более поздняя версия по сравнению с «1.0».

<!-- AIR 2 or earlier --> 
<version>1.23 Beta 7</version>

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

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

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

Свойства основного окна

Когда AIR запускает приложение в настольной системе, она создает окно и загружает в него основной SWF-файл или страницу HTML. AIR с помощью дочерних элементов initialWindow управляет изначальным видом и поведением данного окна приложения.

  • content — основной SWF-файл приложения в дочернем элементе content элемента initalWindow . Если для устройства задан профиль настольной системы, можно использовать файл SWF или HTML.

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

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

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

    <depthAndStencil>true</depthAndStencil>
  • height — высота исходного окна.

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

  • maxSize — максимально разрешенный размер.

  • minimizable определяет, отображается ли системный хром для сворачивания окна.

  • minSize — минимально разрешенный размер.

  • renderMode — в среде AIR 3 или более поздних версий для приложений для настольных систем можно установить режим визуализации auto , cpu , direct или gpu . В более ранних версиях AIR этот параметр игнорируется на настольных платформах. Параметр renderMode нельзя изменить во время выполнения.

    • auto — по существу совпадает с режимом cpu.

    • cpu — экранные объекты визуализируются и копируются в видеопамять в программном обеспечении. Класс StageVideo доступен только в полноэкранном режиме окна. Stage3D использует программное средство визуализации.

    • direct — экранные объекты визуализируются программным обеспечением среды выполнения, но копирование визуализированных кадров в видеопамять (блитирование) выполняется с аппаратным ускорением. Класс StageVideo доступен. Stage3D использует аппаратное ускорение, если при всех прочих условиях это возможно. Если для прозрачности окна установлено значение true, то для окна восстанавливается программная визуализация и блитирование.

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

  • requestedDisplayResolution — Должно ли приложение перейти в режим стандартного ( standard ) или высокого ( high ) разрешения на компьютерах MacBook Pro с экранами высокого разрешения. На всех прочих платформах это значение игнорируется. При значении standard (стандартное разрешение) каждый пиксел рабочей области занимает четыре пиксела на экране. При значении high (высокое разрешение) каждый пиксел рабочей области занимает один физический пиксел экрана. Указанное значение действительно для всех окон приложения. Использование элемента requestedDisplayResolution для настольных приложений AIR (в качестве дочернего элемента intialWindow ) допускается в версии AIR 3.6 и более поздних.

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

  • systemChrome определяет, используется ли стандартное оформление окна операционной системы. Настройки окна systemChrome не могут быть изменены во время выполнения.

  • title — заголовок окна.

  • transparent определяет, применяется ли альфа-блендинг при наложении окна на фоновый рисунок. Окно не может использовать системный хром, если прозрачность включена. Параметр окна transparent не может быть изменен во время выполнения.

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

  • width — ширина окна.

  • x — положение окна по горизонтали.

  • y — положение окна по вертикали.

Функции настольной системы

Следующие элементы управляют функциями установки и обновления на настольных системах.

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

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

    Примечание. Регистрация типа файла пропускается при упаковке приложения в качестве связанного пакета среды выполнения (с использованием цели -bundle ). Чтобы зарегистрировать данный тип файла, необходимо создать программу установки, выполняющую регистрацию.
  • installFolder — путь к стандартному каталогу установки приложения, в котором установлено приложение. С помощью этого параметра можно указать другую папку, а также сгруппировать несколько приложений в общей папке.

  • programMenuFolder — определяет иерархию меню в меню Windows «Все программы». С помощью этого параметра несколько приложений можно разместить в одном меню. Если папка меню не указана, ярлык приложения добавляется в основное меню.

Поддерживаемые профили

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

Если элемент supportedProfile не указан в дескрипторе приложения, предполагается, что приложение поддерживает все определенные профили. Чтобы настроить поддержку в приложении только определенных профилей, укажите список профилей, разделив их пробелами:

<supportedProfiles>desktop extendedDesktop</supportedProfiles>

Список классов ActionScript, поддерживаемых в профилях desktop и extendedDesktop , представлен в разделе Возможности различных профилей .

Необходимые собственные расширения

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

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

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

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

Значки приложения

В настольной системе значки, указанные в дескрипторе приложения, используются в качестве значков для файла приложения, ярлыка и меню программы. Значок приложения должен быть предоставлен в виде набора изображений PNG с размерами 16x16, 32x32, 48x48 и 128x128 пикселей. Укажите путь к файлам значков, используя элемент icon в файле дескриптора приложения:

<icon> 
    <image16x16>assets/icon16.png</image16x16> 
    <image32x32>assets/icon32.png</image32x32> 
    <image48x48>assets/icon48.png</image48x48> 
    <image128x128>assets/icon128.png</image128x128> 
</icon> 

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

Игнорируемые настройки

Приложения для настольных систем игнорируют настройки приложения, которые применяются для мобильных профилей. Игнорируются следующие настройки:

  • android

  • aspectRatio

  • autoOrients

  • fullScreen

  • iPhone

  • renderMode (в версиях, предшествующих AIR 3)

  • requestedDisplayResolution

  • softKeyboardBehavior