ActionScript derleyicileri

Bir Adobe AIR uygulaması oluşturmak için kullandığınız komut satırı araçlarının her biri, uygulamaları oluşturmak için kullanılan karşılık gelen aracı çağırır.

• amxmlc, uygulama sınıflarını derlemek için mxmlc öğesini çağırır.

• acompc, kütüphane ve bileşen sınıflarını derlemek için compc öğesini çağırır.

• aasdoc, kaynak kodu yorumlarından belge dosyaları oluşturmak için asdoc öğesini çağırır.

Yardımcı programların Flex ve AIR sürümleri arasındaki tek fark AIR sürümlerinin yapılandırma seçeneklerini flex-config.xml yerine air-config.xml dosyasından yüklemesidir.

Flex SDK araçları ve komut satırı seçenekleri, Flex belgeleri içinde tam olarak açıklanmıştır. Burada, Flex SDK araçları başlamanıza yardımcı olmak ve Flex uygulamaları ve AIR uygulamaları oluşturma arasındaki farkları belirtmek amacıyla temel bir düzeyde açıklanmaktadır.

Genelde derleme seçeneklerini hem komut satırında hem de bir veya daha fazla yapılandırma dosyasıyla belirlersiniz. Global Flex SDK yapılandırma dosyası derleyicilerin çalıştığı her yerde kullanılan varsayılan değerler içerir. Bu dosyayı kendi geliştirme ortamınıza uyacak şekilde düzenleyebilirsiniz. Flex SDK yüklemenizin çerçeveler dizininde bulunan iki global Flex yapılandırma dosyası vardır. air-config.xml dosyası, amxmlc derleyicisini çalıştırdığınızda kullanılır. Bu dosya AIR kütüphanelerini de dahil ederek AIR için olan derleyiciyi yapılandırır. mxmlc dosyasını çalıştırdığınızda flex-config.xml dosyası kullanılır.

Varsayılan yapılandırma değerleri, Flex ve AIR’nin nasıl çalıştığını keşfetmek için uygundur ancak geniş çaplı bir projeye giriştiğinizde mevcut seçenekleri daha yakından inceleyin. Belirli bir proje için global değerlerin önüne geçen bir yerel yapılandırma dosyasında derleme seçenekleri için projeye özel değerler sağlayabilirsiniz.

Komut satırı MXML derleyicisiyle (amxmlc) AIR uygulamanızın Adobe® ActionScript® 3.0 ve MXML varlıklarını derleyebilirsiniz. (HTML tabanlı uygulamaları derlemeniz gerekmez. Flash Professional'da bir SWF derlemek için, sadece filmi bir SWF dosyasına yayınlayın.)

amxmlc'yi kullanmaya ilişkin temel komut satırı deseni şu şekildedir:

amxmlc [compiler options] -- MyAIRApp.mxml

burada [compiler options] , AIR uygulamanızı derlemek için kullanılan komut satırı seçeneklerini belirtir.

amxmlc komutu standart Flex mxmlc derleyicisini ek bir parametre olan +configname=air parametresiyle çağırır. Bu parametre derleyiciye flex-config.xml dosyası yerine air-config.xml dosyasını kullanması talimatını verir. amxmlc kullanmak diğer bakımlardan mxmlc kullanmakla aynıdır.

Derleyici, bir AIR uygulamasını derlemek için genellikle gerekli olan AIR ve Flex kütüphanelerini belirterek air-config.xml yapılandırma dosyasını yükler. Ayrıca global yapılandırmayı geçersiz kılmak veya bu yapılandırmaya ek seçenekler eklemek için yerel, proje düzeyinde bir yapılandırma dosyası da kullanabilirsiniz. Genellikle yerel bir yapılandırma dosyası oluşturmanın en kolay yolu, global sürümünün bir kopyasını düzenlemektir. Yerel dosyayı -load-config seçeneğini kullanarak yükleyebilirsiniz:

-load-config=project-config.xml Global seçenekleri geçersiz kılar.

-load-config+=project-config.xml -library-path seçeneği gibi, değerden daha fazlasını alan global seçeneklere ek değerler ekler. Yalnızca tek bir değer alan global seçenekler geçersiz kılınır.

Yerel yapılandırma dosyası için özel bir adlandırma kuralı kullanırsanız, amxmlc derleyicisi yerel dosyayı otomatik olarak yükler. Örneğin ana MXML dosyası RunningMan.mxml dosyasıysa, yerel yapılandırma dosyasını şöyle adlandırın: RunningMan-config.xml . Şimdi uygulamayı derlemek için tek yapmanız gereken şunu yazmaktır:

amxmlc RunningMan.mxml

Dosya adı derlenen MXML dosyasının adıyla eşleştiği için, RunningMan-config.xml otomatik olarak yüklenir.

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>

AIR kütüphanelerini ve bağımsız bileşenleri derlemek için, acompc bileşen derleyicisini kullanın. acompc bileşen derleyicisi, aşağıdaki durumlar haricinde amxmlc derleyicisi gibi davranır:

• Kod tabanındaki hangi sınıfların kitaplığa veya bileşene dahil edileceğini belirtmelisiniz.

• acompc otomatik olarak yerel yapılandırma dosyası aramaz. Bir proje konfigürasyon dosyası kullanmak için, –load-config seçeneğini kullanmalısınız.

acompc komutu standart Flex compc bileşen derleyicisini çağırır, ancak yapılandırma seçeneklerini flex-config.xml dosyası yerine air-config.xml dosyasından yükler.