ActionScript-kompilerare

Varje kommandoradsverktyg som du använder för att skapa ett Adobe AIR-program anropar motsvarande verktyg som används för att skapa program:

• amxmlc anropar mxmlc för att kompilera programklasser

• acompc anropar compc för att kompilera biblioteks- och komponentklasser

• aasdoc anropar asdoc för att generera dokumentationsfiler från källkodskommentarer

Den enda skillnaden mellan Flex- och AIR-versionerna av verktygen är att AIR-versionerna läser in konfigurationsalternativen från filen air-config.xml i stället för flex-config.xml.

Flex SDK-verktygen och deras kommnadoradsalternativ beskrivs till fullo i Flex-dokumentationen . Flex SDK-verktygen beskrivs kortfattat här för att hjälpa dig att komma igång och för att visa skillnaderna mellan att bygga Flex-program och AIR-program.

Du kan vanligtvis ange kompileringsalternativ både på kommandoraden och med en eller flera konfigurationsfiler. Den globala Flex SDK konfigurationsfilen innehåller standardvärden som används när kompilatorerna körs. Du kan redigera filen så att den passar din utvecklingsmiljö. Det finns två globala Flex konfigurationsfiler i katalogen frameworks i Flex SDK-installationen. Filen air-config.xml används när du kör kompilatorn amxmlc. Filen konfigurerar kompilatorn för AIR genom att inkludera AIR-biblioteken. Filen flex-config.xml används när du kör mxmlc.

Konfigurationens standardvärden lämpliga för att upptäcka hur Flex och AIR fungerar, men när du startar ett stort projekt bör du kontrollera de tillgängliga alternativen i detalj. Du kan ange projektspecifika värden för kompilatoralternativ i en lokal konfigurationsfil som har prioritet över de globala värdena för ett visst projekt.

Du kan kompilera Adobe® ActionScript® 3.0- och MXML-resurserna i ditt AIR-program med kommandoradskompilatorn för MXML (amxmlc). (Du behöver inte kompilera HTML-baserade program. Om du vill kompilera en SWF-film i Flash Professional behöver du enbart publicera filmen som en SWF-fil.)

Det grundläggande kommandoradsmönstret för att använda amxmlc är:

amxmlc [compiler options] -- MyAIRApp.mxml

där [kompilatoralternativ] anger vilka kommandoradsalternativ som används för att kompilera AIR-programmet.

Kommandot amxmlc anropar den förvalda mxmlc-kompilatorn i Flex med en extra parameter, +configname=air . Den här parametern anger för kompilatorn att använda filen air-config.xml i stället för filen flex-config.xml. Annars använder du amxmlc på samma sätt som mxmlc.

Kompilatorn läser in konfigurationsfilen air-config.xml som anger vilka AIR- och Flex-bibliotek som vanligtvis krävs för att kompilera ett AIR-program. Du kan också läsa in en lokal konfigurationsfil på projektnivå om du vill åsidosätta eller tillföra tilläggsalternativ i den globala konfigurationen. Det enklaste sättet att skapa en lokal konfigurationsfil brukar vara att redigera en kopia av den globala versionen. Du kan läsa in den lokala filen med alternativet -load-config :

-load-config=project-config.xml Åsidosätter globala alternativ.

-load-config+=project-config.xml Lägger till flera värden i de globala alternativ som kan använda flera värden, till exempel alternativet -library-path . Globala alternativ som bara kan använda ett värde åsidosätts.

Om du använder en särskild namngivningsregel för den lokala konfigurationsfilen, läser amxmlc-kompilatorn in den lokala filen automatiskt. Om till exempel huvud-MXML-filen är RunningMan.mxml ska du namnge den lokala konfigurationsfilen så här: RunningMan-config.xml . För att kompilera programmet behöver du nu bara skriva:

amxmlc RunningMan.mxml

RunningMan-config.xml läses in automatiskt eftersom filnamnet matchar den kompilerade MXML-filen.

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>

Använd komponentkompilatorn, acompc, när du vill kompilera AIR-bibliotek och oberoende komponenter. Komponentkompilatorn acompc fungerar som amxmlc-kompilatorn, men med följande undantag:

• Du måste ange vilka klasser i kodbasen som ska tas med i biblioteket eller komponenten.

• acompc söker inte automatiskt efter en lokal konfigurationsfil. Om du vill använda projektkonfigurationsfilen måste du använda alternativet –load-config.

Kommandot acompc anropar den förvalda Flex-komponentkompilatorn compc, men läser in dess konfigurationsalternativ från filen air-config.xml i stället för filen flex-config.xml .