Specifications

135ADOBE FLEX 3

Building and Deploying Adobe Flex 3 Applications

For example, if your application’s top-level file is called MyApp.mxml, the compiler first checks for a MyApp-

config.xml file for configuration settings. With this feature, you can easily compile multiple applications using

different configuration options without changing your command-line options or your flex-config.xml file.

Options in the local configuration file take precedence over options set in the flex-config.xml file. Options set in

a configuration file that the

load-config option specify take precedence over the local configuration file.

Command-line settings take precedence over all configuration file settings. For more information on the prece-

dence of compiler options, see “About option precedence” on page 138.

Configuration file syntax

You store values in a configuration file in XML blocks, which follow a specific syntax. In general, the tags you use

match the command-line options.

About the root tag

The root tag of the default configuration file, flex-config.xml, is <flex-config>. If you write a custom configu-

ration file, it must also have this root tag. Compiler configuration files must also have an XML declaration tag, as

the following example shows:

<?xml version="1.0"?>

<flex-config xmlns="http://www.adobe.com/2006/flex-config">

You must close the <flex-config> tag as you would any other XML tag. All compiler configuration files must

be closed with the following tag:

</flex-config>

In general, the second tag in a configuration file is the <compiler> tag. This tag wraps most compiler options.

However, not all compiler options are set in the

<compiler> block of the configuration file.

Tags that you must wrap in the compiler block are prefixed by

compiler in the help output (for example,

compiler.services). If the option uses no dot-notation in the help output (for example, include-file), it is a

tag at the root level of the configuration file, and the entry appears as follows:

...

</compiler>

<include-file>

<path>c:/images/logo/logo1.gif</path>

</include-file>