Использование собственных расширений для Adobe AIR

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

Обратите внимание, что для некоторых устройств в ANE-файле содержится библиотека собственного кода, используемая собственным расширением. Но для других устройств библиотека собственного кода установлена на устройстве. В некоторых случаях для определенного устройства собственное расширение может вовсе не иметь собственного кода; он реализован только с помощью ActionScript.

Разработчик приложений AIR использует ANE-файл следующим образом.

ActionScript 3.0 предоставляет класс NativeProcess. Класс позволяет приложению AIR выполнять собственные процессы в операционной системе хоста. Эта возможность аналогична собственным расширениям, которые предоставляют доступ к характерным для платформы функциям и библиотекам. При принятии решения об использовании класса NativeProcess или собственного расширения учитывайте следующее.

• Только профиль AIR extendedDesktop поддерживает класс NativeProcess. Поэтому для приложений с профилями AIR mobileDevice и extendedMobileDevice возможен выбор только собственных расширений.

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

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

SWC-файл является библиотекой классов ActionScript в архивном формате. SWC-файл содержит SWF-файл и другие файлы ресурсов. С помощью SWC-файла можно удобно получать общий доступ к классам ActionScript, не используя специальный код ActionScript и файлы ресурсов.

Пакет собственного расширения является ANE-файлом. Как и SWC-файл, ANE-файл также является библиотекой классов ActionScript, содержащей SWF-файл и другие файлы ресурсов в архивном формате. Однако наиболее важное различие ANE- и SWC-файлов заключается в том, что только ANE-файл может содержать библиотеку собственного кода.

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

Часто одно и то же собственное расширение предназначено для нескольких платформ. В ANE-файле расширения содержатся ActionScript и собственные библиотеки для каждой поддерживаемой платформы. Как правило, библиотеки ActionScript имеют одинаковые общедоступные интерфейсы для всех платформ. Собственные библиотеки обязательно различаются.

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

Следующие профили AIR поддерживают собственные расширения:

Для использования собственного расширения в приложении выполните следующие задачи.

1. Объявите расширение в файле дескриптора приложения.

2. Включите ANE-файл в путь к библиотеке приложения.

3. Упакуйте приложение.

Для всех приложений AIR предусмотрен файл дескриптора приложения. Когда в приложении используется собственное расширение, файл дескриптора приложения включает элемент <extensions> . Например:

<extensions> 
    <extensionID>com.example.Extension1</extensionID> 
    <extensionID>com.example.Extension2</extensionID> 
</extensions>

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

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

Используйте инструмент ADT для упаковки приложения, в котором используются собственные расширения. Создание пакета приложения с помощью Flash Professional CS5.5 или Flash Builder 4.5.1 невозможно.

Сведения об использовании инструмента ADT приводятся в документе « AIR Developer Tool (ADT) ».

Например, следующая команда ADT создает DMG-файл (собственный файл установщика для ОС Mac OS X) для приложения, в котором используются собственные расширения:

adt -package 
    -storetype pkcs12 
    -keystore myCert.pfx 
    -target native 
    myApp.dmg 
    application.xml 
    index.html resources 
    -extdir extensionsDir

adt -package 
    -target apk 
    -storetype pkcs12 -keystore ../codesign.p12 
    myApp.apk 
    myApp-app.xml 
    myApp.swf icons 
    -extdir extensionsDir

Следующая команда создает пакет iOS для приложения iPhone:

adt -package 
    -target ipa-ad-hoc 
    -storetype pkcs12 -keystore ../AppleDistribution.p12 
    -provisioning-profile AppleDistribution.mobileprofile 
    myApp.ipa 
    myApp-app.xml 
    myApp.swf icons Default.png 
    -extdir extensionsDir

Обратите внимание на следующие моменты.

• Используйте тип пакета собственного установщика.

• Укажите каталог расширения.

• Убедитесь, что ANE-файл поддерживает целевое устройство приложения.