Kompilatory języka ActionScript

Każde z narzędzi wiersza poleceń używane do tworzenia aplikacji Adobe AIR wywołuje odpowiednie narzędzia używane do tworzenia aplikacji.

• amxmlc calls mxmlc — do kompilowania klas aplikacji

• acompc calls compc — do kompilowania klas bibliotek i składników

• aasdoc calls asdoc — do generowania plików dokumentacji z komentarzy w kodzie źródłowym

Jedyną różnicą między wersjami Flex i AIR tych programów narzędziowych jest to, że wersje AIR ładują opcje konfiguracji z pliku air-config.xml zamiast z pliku flex-config.xml.

Narzędzia zestawu SDK programu Flex i odpowiednie opcje wiersza poleceń zostały opisane kompleksowo w dokumentacji programu Flex . Narzędzia Flex SDK zostały opisane w niniejszej sekcji na poziomie podstawowym, aby ułatwić rozpoczęcie pracy oraz aby wskazać różnice między tworzeniem aplikacji Flex i budowaniem aplikacji AIR.

Opcje kompilacji zwykle określa się w wierszu poleceń oraz w jednym lub większej liczbie plików konfiguracyjnych. Globalny plik konfiguracyjny Flex SDK zawiera wartości domyślne, które są używane zawsze po uruchomieniu kompilatorów. Ten plik można edytować w celu dostosowania środowiska programowania. Katalog środowiska instalacji Flex SDK zawiera dwa globalne pliki konfiguracyjne Flex. Plik air-config.xml jest używany po uruchomieniu kompilatora amxmlc. Ten plik konfiguruje kompilatora dla środowiska AIR poprzez dołączanie bibliotek AIR. Plik flex-config.xml jest używany po uruchomieniu mxmlc.

Domyślne wartości konfiguracji są odpowiednie do wykrywania sposobów działania środowisk Flex i AIR, jednak w przypadku prac nad projektem w pełnej skali należy bliżej zapoznać się z dostępnymi opcjami. Do lokalnego pliku konfiguracyjnego można wprowadzić wartości właściwe dla projektu — wówczas te wartości będą miały priorytet wyższy niż wartości globalne.

Zasoby Adobe® ActionScript® 3.0 i MXML aplikacji AIR użytkownika można kompilować za pomocą kompilatora MXML (amxmlc) wywoływanego z wiersza poleceń. (Nie ma potrzeby kompilowania aplikacji opartych na kodzie HTML. W celu skompilowania pliku SWF w Flash Professional wystarczy opublikować film do pliku SWF).

Podstawowy wzorzec wiersza poleceń dla kompilatora amxmlc:

amxmlc [compiler options] -- MyAIRApp.mxml

gdzie [compiler options] określa opcje wiersza poleceń używane do kompilowania aplikacji AIR.

Polecenie amxmlc zawiera standardowy kompilator Flex mxmlc oraz dodatkowy parametr +configname=air . Ten parametr informuje kompilator o konieczności użycia pliku air-config.xml zamiast pliku flex-config.xml. Pod innymi względami stosowanie kompilatora amxmlc przebiega tak samo jak stosowanie kompilatora mxmlc.

Kompilator ładuje plik konfiguracji air-config.xml, określając biblioteki AIR i Flex wymagane do skompilowania aplikacji AIR. Możliwe jest również zastosowanie lokalnego pliku konfiguracji na poziomie projektu w celu zastąpienia opcji lub dodania opcji do konfiguracji globalnej. Zwykle najprostszym sposobem utworzenia pliku konfiguracji lokalnej jest edytowanie kopii wersji globalnej. Plik lokalny można załadować za pomocą opcji -load-config :

-load-config=project-config.xml Zastępuje opcje globalne.

-load-config+=project-config.xml Dodaje wartości do opcji globalnych, które przyjmują więcej niż jedną wartość, np. opcja -library-path . Globalne opcje, które przyjmują tylko jedną wartość, są zastępowane.

Jeśli stosowana jest określona konwencja nazewnictwa dla lokalnego pliku konfiguracji, wówczas kompilator amxmlc automatycznie ładuje plik lokalny. Przykład: jeśli główny plik MXML to RunningMan.mxml , wówczas lokalny plik konfiguracji powinien mieć nazwę: RunningMan-config.xml . W celu skompilowania aplikacji należy wpisać:

amxmlc RunningMan.mxml

Plik RunningMan-config.xml jest ładowany automatycznie, ponieważ nazwa jego pliku jest zgodna z nazwą skompilowanego pliku 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>

Kompilator składników acompc służy do kompilowania bibliotek AIR i niezależnych składników. Kompilator składnika acompc działa jak kompilator amxmlc z następującymi wyjątkami:

• Należy określić klasy w kodzie, które będą zawierały bibliotekę lub składnik.

• acompc nie wyszukuje automatycznie lokalnego pliku konfiguracji. W celu użycia pliku konfiguracji projektu należy użyć opcji –load-config.

Polecenie acompc wywołuje standardowy kompilator Flex compc, ale ładuje jego opcje konfiguracji z pliku air-config.xml zamiast z pliku flex-config.xml .