Компиляторы ActionScript

Используемые для создания приложения Adobe AIR инструменты командной строки вызывают соответствующие инструменты, используемые для создания приложений:

• amxmlc вызывает mxmlc для компиляции классов приложения

• acompc вызывает compc для компиляции классов библиотек и компонентов

• aasdoc вызывает asdoc для создания файлов документации из комментариев в исходном коде

Единственное отличие между версиями служебных программ Flex и AIR заключается в том, что версии AIR загружают параметры конфигурации из файла air-config.xml, на не flex-config.xml.

Полное описание инструментов библиотеки Flex SDK и их параметров командной строки см. в документации Flex . Здесь содержится лишь краткое описание инструментово Flex SDK, необходимое для понимания разницы между созданием приложений Flex и приложений AIR.

Обычно параметры компиляции вводятся в командной строке и одном из файлов конфигурации. В глобальном файле конфигурации Flex SDK обычно хранятся значения по умолчанию, используемые каждый раз при запуске компиляторов. Чтобы настроить Flex SDK под собственную среду разработки, внесите изменения в этот файл. Существует два глобальных файла конфигурации Flex, расположенные в папке frameworks в каталоге установки Flex SDK. air-config.xml — используется при запуске компилятора amxmlc. Этот файл настраивает компилятор для AIR путем включения библиотек AIR. flex-config.xml file — используется при запуске компилятора mxmlc.

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

Для компиляции файлов Adobe® ActionScript® 3.0 и MXML для приложения AIR можно использовать компилятор командной строки MXML (amxmlc). (Компиляция для HTML-приложений не требуется. Для компиляции SWF-файла во Flash Professional просто опубликуйте видеоролик в SWF-файл.)

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

amxmlc [compiler options] -- MyAIRApp.mxml

где [compiler options] задает параметры командной строки, используемые для компиляции приложения AIR.

Команда amxmlc вызывает стандартный компилятор Flex mxmlc с дополнительным параметром +configname=air . Этот параметр сообщает компилятору, что нужно использовать файл air-config.xml, а не flex-config.xml. В остальном amxmlc идентичен mxmlc.

Компилятор загружает файл конфигурации air-config.xml, в котором задаются библиотеки AIR и Flex, в большинстве случаев необходимые для компиляции приложения AIR. Также для переопределения или дополнения глобальных параметров конфигурации можно воспользоваться локальным файлом конфигурации на уровне проекта. Как правило, проще всего создать файл локальной конфигурации, скопировав и отредактировав его глобальную версию. Локальный файл можно загрузить с помощью -load-config :

-load-config=project-config.xml переопределяет глобальные параметры.

-load-config+=project-config.xml добавляет значения к тем глобальным параметрам, у которых их более одного, таким как -library-path . Глобальные параметры, принимающие только одно значение, переопределяются.

Если для файла локальной конфигурации используется специальное соглашение об именах, компилятор amxmlc автоматически загружает локальный файл. Например, если основной MXML-файл — RunningMan.mxml , то файл локальной конфигурации будет называться RunningMan-config.xml . Теперь для компиляции приложения нужно ввести всего лишь следующее:

amxmlc RunningMan.mxml

RunningMan-config.xml загружается автоматически, потому что его имя соответствует имени скомпилированного MXML-файла.

amxmlc myApp.mxml

amxmlc –output anApp.swf -- myApp.mxml

amxmlc myApp.as

amxmlc –load-config config.xml -- myApp.mxml

amxmlc –load-config+=moreConfig.xml -- myApp.mxml

amxmlc –library-path+=/libs/libOne.swc,/libs/libTwo.swc  -- myApp.mxml

mxmlc -library-path [AIR SDK]/frameworks/libs/air/airframework.swc, ^ 
[AIR SDK]/frameworks/libs/air/airframework.swc, ^ 
-library-path [Flex SDK]/frameworks/libs/framework.swc ^ 
-- myApp.mxml

mxmlc -library-path [AIR SDK]/frameworks/libs/air/airframework.swc, \ 
[AIR SDK]/frameworks/libs/air/airframework.swc, \ 
-library-path [Flex 3 SDK]/frameworks/libs/framework.swc \ 
-- myApp.mxml

amxmlc -external-library-path+=../lib/myLib.swc -runtime-shared-libraries=myrsl.swf -- myApp.mxml

amxmlc -external-library-path+=../lib/myANE.ane -output=myAneApp.swf -- myAneApp.mxml

java flex2.tools.Compiler +flexlib [Flex SDK 3]/frameworks +configname=air [additional compiler options] -- myApp.mxml

java -jar [Flex SDK 2]/lib/mxmlc.jar +flexlib [Flex SDK 3]/frameworks +configname=air [additional compiler options] -- myApp.mxml

<property name="SDK_HOME" value="C:/Flex46SDK"/> 
<property name="MAIN_SOURCE_FILE" value="src/myApp.mxml"/> 
<property name="DEBUG" value="true"/> 
<target name="compile"> 
    <java jar="${MXMLC.JAR}" fork="true" failonerror="true"> 
        <arg value="-debug=${DEBUG}"/> 
        <arg value="+flexlib=${SDK_HOME}/frameworks"/> 
        <arg value="+configname=air"/> 
        <arg value="-file-specs=${MAIN_SOURCE_FILE}"/> 
    </java> 
</target>

Используйте компилятор acompc для компиляции библиотек AIR и независимых компонентов. Компилятор компонента acompc во многом похож на amxmlc, но есть и ряд отличий:

• Необходимо указать, какие классы в коде необходимо включить в библиотеку или компонент.

• Команда acompc не ищет файл локальной конфигурации автоматически. Для использования файла конфигурации проекта необходимо задать параметр –load-config.

Команда acompc вызывает стандартный для Flex компилятор компонента compc, но загружает его параметры конфигурации из файла air-config.xml (не из flex-config.xml ).