在使用flashbuilder開發flex程式的過程中，有時我們會為了支援某種主題而在flex編譯器->附加的編譯器參數下加入如下語句：-locale en_US -theme=${flexlib}/themes/Halo/halo.swc。但是我們不能直接使用flashbuilder生成出來的swf或者swc（存在版權問題），必須使用ant構建自己的swf或者swc。將語句-locale en_US -theme=${flexlib}/themes/Halo/halo.swc轉換成ant中的表示為：
<!-- compile a mxml/as file -->
<target name="compile">
<!-- 如果需要生成as源代碼，keep-generated-actionscript設置為true -->
<!-- 生成供Module編譯使用的link report -->
<mxmlc file="${src-dir}/${fileName}.${fileExt}"
output="${export-dir}/${fileName}.swf"
actionscript-file-encoding="UTF-8"
keep-generated-actionscript="false"
link-report="${export-dir}/link-report.xml"
incremental="true">
<load-config filename="${FLEX_HOME}/frameworks/flex-config.xml"/>
<!-- 注意該語句，加入了主題支援 -->
<compiler.theme file="${FLEX_HOME}/frameworks/themes/Halo/halo.swc"/>
<compiler.theme file="${FLEX_HOME}/frameworks/themes/Spark/spark.css"/>
<source-path path-element="${FLEX_HOME}/frameworks"/>
<compiler.library-path dir="${FLEX_HOME}/frameworks" append="true">
<include name="libs" />
<include name="../bundles/{locale}"/>
</compiler.library-path>
<compiler.library-path dir="${basedir}" append="true">
<include name="libs" />
<include name="export" />
</compiler.library-path>
<compiler.source-path path-element="${src-dir}"/>
</mxmlc>
<!-- 如果有生成源代碼，這裏需要做刪除 -->
<!-- delete dir="${src-dir}/generated"/ -->
<delete>
<!-- Deletes cache file -->
<fileset dir="${export-dir}" includes="${fileName}*.cache" defaultexcludes="false"/>
</delete>
</target>
其實這些參數在flex SDK的ant包下的Readme.txt有描述：
################################################################################
# #
# README - flexTasks #
# #
############################################################
Contents
I. Installation
II. Using flexTasks
A. mxmlc
###################
I. Installation
Place flexTasks.jar into the lib directory of your Ant installation.
Alternatively, you can specify the location of the JAR file as an
argument to Ant, as the follow example shows:
ant -lib <some-path>/flexTasks.jar .
In addition to this, you must include the following line in any build
file that uses the mxmlc or asc tasks:
<taskdef resource="flexTasks.tasks" /> .
The build tools that you want to use (such as mxmlc or asc) must be in
your PATH. Unlike Ant, these tasks do not search your current
directory for executables unless the current directory appears in your
PATH (either explicitly or by including ".").
#########
II. Using flexTasks
#####
FlexBuild exposes all of the command-line options of mxmlc through the
attributes and nested elements of an <mxmlc> task. The full name and
abbreviated name of a command line option can be used interchangably
when the option is implemented as an attribute.
The following examples are both acceptable ways to pass the compiler.as3 option
to mxmlc:
<mxmlc file="foo.mxml" compiler.as3="true" />
and
<mxmlc file="foo.mxml" as3="true" />
All boolean options are implemented as attributes of the <mxmlc> element.
All options that take a single argument are also implemented as attributes of
the <mxmlc> element. The descriptions of these types of options vary in the
mxmlc documentation. If an option is documented as taking a <string>,
<filename>, <int>, or some sort of path element, and that option is non-
repeatable, then this option is set by setting an attribute in the <mxmlc>
element.
Options that are repeatable, or take more than one argument (such as
default-size), are implemented as nested elements with attributes corresponding
to the names given to arguments in the mxmlc documentation. For example, if you
want to pass the option -default-size 800 600 to mxmlc, use the following
syntax:
<mxmlc file="foo.mxmlc">
<default-size width="800" height="600" />
</mxmlc>
Do not include multiple nested elements corresponding to a non-repeatable option.
The following two nested elements can contain nested elements:
- <fonts>
- <metadata>
These elements encapsulate all options starting with "compiler.fonts" and "metadata",
repectively. The same rules that apply to other options apply to nested elements.
The following example includes contributors names and a description of the application:
<mxmlc file="foo.mxmlc">
<metadata description="foo app">
<contributor name="Joe" />
<contributor name="Mike" />
</metadata>
</mxmlc>.
There are some exceptions to the rules states above:
- The compiler.fonts.languages.language-range option is set by
adding a <language-range> nested element to <fonts>, rather than a
<languages.language-range> element.
- The following options (repeatable options that take a path-element) are
implemented as FileSets:
-compiler.external-library-path
-compiler.include-libraries
-compiler.library-path
-compiler.theme
The following example shows the usage for external-library-path:
<compiler.external-library-path dir="${lib.dir}">
<include name="**/*.swc" />
<exclude name="not-this-one.swc" />
<compiler.external-library-path>
<compiler.theme file="${src.dir}/foo.mxml" />
To use these options, append the files that the FileSet chooses to the compiler
defaults and set the append attribute of the FileSet to true.
- The file-spec option is not supported. Instead, use the file attribute of
the mxmlc task.
################################################################################
# #
# End of README
A. mxmlc
留言列表
