Compilatori ActionScript

Ognuno degli strumenti della riga di comando che utilizzate per creare un'applicazione Adobe AIR chiama il corrispondente strumento utilizzato per creare le applicazioni:

• amxmlc chiama mxmlc per compilare le classi dell'applicazione

• acompc chiama compc per compilare le classi di librerie e componenti

• aasdoc chiama asdoc per generare i file della documentazione a partire dai commenti del codice sorgente

L'unica differenza tra le versioni Flex e AIR di queste utilità è che le versioni AIR caricano le opzioni di configurazione dal file air-config.xml invece che dal file flex-config.xml.

Gli strumenti Flex SDK e le relative opzioni della riga di comando sono descritti in modo dettagliato nella documentazione Flex . In questa documentazione gli strumenti di Flex SDK vengono descritti a un livello di base per consentirvi di acquisire familiarità con il loro utilizzo ed evidenziare le differenze tra la creazione di applicazioni Flex e la creazione di applicazioni AIR.

Per specificare le opzioni di compilazione, in genere si utilizzano sia la riga di comando che uno o più file di configurazione. Il file di configurazione globale di Flex SDK contiene i valori predefiniti che vengono utilizzati a ogni esecuzione dei compilatori. Potete modificare questo file in base alle esigenze del vostro ambiente di sviluppo. La directory frameworks dell'installazione di Flex SDK contiene due file di configurazione globali per Flex. Il file air-config.xml viene utilizzato quando si esegue il compilatore amxmlc. Questo file configura il compilatore per AIR includendo le librerie AIR. Il file flex-config.xml viene utilizzato quando si esegue mxmlc.

I valori di configurazione predefiniti sono utili per acquisire dimestichezza con il funzionamento di Flex e AIR. Prima di iniziare un progetto di grandi dimensioni, tuttavia, è opportuno esaminare più da vicino le opzioni disponibili. A livello di progetto potete utilizzare un file di configurazione locale, che ha la precedenza sui valori globali, per definire valori specifici del progetto per le opzioni di compilazione.

Potete compilare le risorse Adobe® ActionScript® 3.0 e MXML dell'applicazione AIR con il compilatore MXML della riga di comando (amxmlc). Non dovete compilare applicazioni basate su HTML. Per compilare un file SWF in Flash Professional, pubblicate il filmato in un file SWF.

La sintassi di base da riga di comando per l'uso di amxmlc è la seguente:

amxmlc [compiler options] -- MyAIRApp.mxml

dove [compiler options] specifica le opzioni della riga di comando utilizzate per la compilazione dell'applicazione AIR.

Il comando amxmlc chiama il compilatore standard Flex mxmlc con un parametro aggiuntivo, vale a dire +configname=air . Questo parametro istruisce il compilatore all'utilizzo del file air-config.xml anziché del file flex-config.xml. Per altri aspetti, l'impiego di amxmlc è identico a quello di mxmlc.

Il compilatore carica il file di configurazione air-config.xml specificando le librerie AIR e Flex solitamente richieste per la compilazione di un'applicazione AIR. È inoltre possibile utilizzare un file di configurazione locale a livello di progetto per ignorare o aggiungere ulteriori opzioni alla configurazione globale. Solitamente, il sistema più semplice per creare un file di configurazione locale consiste nel modificare una copia della versione globale. È possibile caricare il file locale con l'opzione -load-config :

-load-config=project-config.xml Ignora le opzioni globali.

-load-config+=project-config.xml Aggiunge ulteriori valori alle opzioni globali che accettano più del valore, come ad esempio l'opzione -library-path . Le opzioni globali che accettano solo un valore vengono ignorate.

Se si utilizza una speciale convenzione di denominazione per il file di configurazione locale, il compilatore amxmlc carica automaticamente il file locale. Ad esempio, se il file MXML principale è RunningMan.mxml , denominate il file di configurazione locale RunningMan-config.xml . A questo punto, per compilare l'applicazione, dovete solo digitare:

amxmlc RunningMan.mxml

RunningMan-config.xml viene caricato automaticamente dal momento che il relativo nome file corrisponde a quello del file MXML compilato.

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>

Il compilatore di componenti acompc consente di compilare librerie AIR e componenti indipendenti. Il compilatore di componenti acompc si comporta come il compilatore amxmlc, con le seguenti eccezioni:

• È necessario specificare quali classi della base di codice desiderate includere nella libreria o nel componente.

• acompc non cerca automaticamente un file di configurazione locale. Per utilizzare un file di configurazione del progetto, è necessario utilizzare l'opzione –load-config.

Il comando acompc chiama il compilatore di componenti Flex standard compc, ma ne carica le opzioni di configurazione dal file air-config.xml invece di flex-config.xml .