Task attributes
The table below shows a list of all the attributes the flex2ant mxmlc task supports. The left column shows the original MXMLC compiler option. The second column shows the mxmlc task attribute name. This attribute name usually equals the alias name of the original compiler option (see column on the right). The third column shows the type of the attribute expected by the mxmlc task. The fourth, most right, column shows the discription of the MXMLC compiler option. All descriptions are taken from the original compiler documentation.
Multiple parameters
When specifying compiler parameters for the MXMLC compiler, some compiler options are repeatable. This basically means that you can specify more than one value for this parameter. A good example of a repeatable parameter is the sourcePath parameter with which you can specify paths to folders that hold packages you might want to make available to your application.
Since version 0.0.3, flex2ant also allows you to include repeatable parameters by seperating the parameters by a semi-colon. The example on the tutorials page demonstrates this on the sourcePath parameter. Please beware that some operating system do not handle the usage of spaces in paths very well. While testing on Windows we didn't seem to experience any problems with using spaces in folder names. However, on Linux we were unable to get spaces in folders working correctly.
Futher information
For more information on using the Flex 2 SDK command line compiler and the options that are available on using it, please refer to the Adobe LiveDocs. If you find any inconsistencies or just plain mistakes in the following table then please don't hesitate to contact the flex2ant team at info {at} flex2ant {dot} org.
flex2ant mxmlc task attributes
| MXML compiler option | flex2ant mxmlc task attribute | type | Meaning |
|---|---|---|---|
| -benchmark | benchmark | boolean | output performance benchmark |
| -compiler.accessible | accessible | boolean | alias -accessible generate an accessible SWF |
| -compiler.actionscript-file-encoding | actionscriptFileEncoding | string | alias -actionscript-file-encoding specifies actionscript file encoding. If there is no BOM in the AS3 source files, the compiler will use this file encoding. |
| -compiler.allow-source-path-overlap | allowSourcePathOverlap | boolean | alias -allow-source-path-overlap (advanced) |
| -compiler.as3 | AS3 | boolean | alias -as3 uses the AS3 compatibility mode. default is true. Either -as3 or -es3 must be 'true'. |
| -compiler.context-root <context-path> | contextRoot | string | alias -context-root path to replace {context.root} tokens for service channel endpoints |
| -compiler.debug | debug | boolean | alias -debug |
| -compiler.defaults-css-url <string> | defaultsCSSUrl | string | alias -defaults-css-url (advanced) |
| -compiler.defaults-css-url <string> | defaultsCSSUrl | string | alias -defaults-css-url (advanced) |
| -compiler.doc | doc | boolean | alias -doc (advanced) |
| -compiler.es3 | ES3 | boolean | alias -es3 uses the ES3 compatibility mode. default is false. |
| -compiler.external-library-path [path-element] [...] | externalLibraryPath | string | alias -el list of SWC files or directories to compile against but to omit from linking (repeatable) |
| -compiler.fonts.languages.language-range |
languageRange | string | alias -language-range a range to restrict the number of font glyphs embedded into the SWF (advanced, repeatable) |
| -compiler.fonts.managers [manager-class] [...] | managers | string | alias -managers Compiler font manager classes, in policy resolution order (advanced) |
| -compiler.fonts.max-cached-fonts <string> | maxCachedFonts | string | alias -max-cached-fonts (advanced) |
| -compiler.fonts.max-glyphs-per-face <string> | maxGlyphsPerFace | string | alias -max-glyphs-per-face (advanced) |
| -compiler.fonts.system-search-path [path-element] [...] | systemSearchPath | string | alias -system-search-path (advanced, repeatable) |
| -compiler.headless-server | headlessServer | boolean | alias -headless-server a flag to set when Flex is running on a server without a display (advanced) |
| -compiler.include-libraries [library] [...] | includeLibraries | string | alias -include-libraries a list of libraries (SWCs) to completely include in the SWF (repeatable) |
| -compiler.incremental | incremental | boolean | alias -incremental enables incremental compilation |
| -compiler.keep-all-type-selectors | keepAllTypeSelectors | boolean | alias -keep-all-type-selectors disables the pruning of unused type selectors (advanced) |
| -compiler.keep-generated-actionscript | keep | boolean | alias -keep save temporary source files generated during MXML compilation (advanced) |
| -compiler.library-path [path-element] [...] | libraryPath | string | alias -l list of SWC files or directories that contain SWC files (repeatable) |
| -compiler.locale <string> | locale | string | alias -locale specifies the locale for internationalization |
| -compiler.namespaces.namespace |
namespace | string | alias -namespace Specify a URI to associate with a manifest of components for use as MXML elements (repeatable) |
| -compiler.optimize | optimize | boolean | alias -optimize Enable post-link SWF optimization |
| -compiler.profile | profile | boolean | alias -profile generate a movie that is suitable for performance profiling |
| -compiler.services |
services | string | alias -services path to Flex Data Services configuration file |
| -compiler.show-binding-warnings | showBindingWarnings | boolean | alias -show-binding-warnings toggle whether warnings generated from data binding code are displayed |
| -compiler.show-coach-warnings | showCoachWarnings | boolean | alias -show-coach-warnings runs the AS3 compiler in a mode that detects legal but potentially incorrect code |
| -compiler.show-dependency-warnings | showDependencyWarnings | boolean | alias -show-dependency-warnings show warnings when dependencies cannot be determined at compile time (advanced) |
| -compiler.show-deprecation-warnings | showDeprecationWarnings | boolean | alias -show-deprecation-warnings toggle whether the use of deprecated APIs generates a warning |
| -compiler.source-path [path-element] [...] | sourcePath | string | alias -sp list of path elements that form the roots of ActionScript class hierarchies (repeatable) |
| -compiler.strict | strict | boolean | alias -strict runs the AS3 compiler in strict error checking mode. strict must be 'false' when es3 is 'true'. |
| -compiler.theme [filename] [...] | theme | string | alias -theme list of CSS or SWC files to apply as a theme (repeatable) |
| -compiler.use-resource-bundle-metadata | useResourceBundleMetadata | boolean | alias -use-resource-bundle-metadata |
| -compiler.verbose-stacktraces | verboseStackTraces | boolean | alias -verbose-stacktraces save callstack information to the SWF for debugging (advanced) |
| -compiler.warn-array-tostring-changes | warnArrayToStringChanges | boolean | alias -warn-array-tostring-changes (advanced) |
| -compiler.warn-assigning-undefined-to-non-object-type | warnAssigningUndefinedToNonObjectType | boolean | alias -warn-assigning-undefined-to-non-object-type (advanced) |
| -compiler.warn-bad-type-cast | warnBadTypeCast | boolean | alias -warn-bad-type-cast (advanced) |
| -compiler.warn-bad-undefined-comparison | warnBadUndefinedComparison | boolean | alias -warn-bad-undefined-comparison (advanced) |
| -compiler.warn-boolean-constructor-with-no-args | warnBooleanConstructorWithNoArgs | boolean | alias -warn-boolean-constructor-with-no-args (advanced) |
| -compiler.warn-class-is-sealed | warnClassIsSealed | boolean | alias -warn-class-is-sealed (advanced) |
| -compiler.warn-constructor-returns-value | warnConstructorReturnsValue | boolean | alias -warn-constructor-returns-value (advanced) |
| -compiler.warn-deprecated-event-handler-error | warnDeprecatedEventHandlerError | boolean | alias -warn-deprecated-event-handler-error (advanced) |
| -compiler.warn-deprecated-function-error | warnDeprecatedFunctionError | boolean | alias -warn-deprecated-function-error (advanced) |
| -compiler.warn-deprecated-property-error | deprecatedPropertyError | boolean | alias -warn-deprecated-property-error (advanced) |
| -compiler.warn-duplicate-func-def | warnDuplicateFuncDef | boolean | alias -warn-duplicate-func-def (advanced) |
| -compiler.warn-for-var-in-changes | warnForVarInChanges | boolean | alias -warn-for-var-in-changes (advanced) |
| -compiler.warn-function-parameter-declared-as-void | warnFunctionParameterDeclaredAsVoid | boolean | alias -warn-function-parameter-declared-as-void (advanced) |
| -compiler.warn-math-expressions-treat-null-like-zero | warnMathExpressionsTreatNullLikeZero | boolean | alias -warn-math-expressions-treat-null-like-zero (advanced) |
| -compiler.warn-missing-namespace-decl | warnMissingNamespaceDecl | boolean | alias -warn-missing-namespace-decl (advanced) |
| -compiler.warn-no-constructor | warnNoContructor | boolean | alias -warn-no-constructor (advanced) |
| -compiler.warn-no-explicit-super-call-in-constructor | warnNoExplicitSuperCallInConstructor | boolean | alias -warn-no-explicit-super-call-in-constructor (advanced) |
| -compiler.warn-no-type-decl | warnNoTypeDecl | boolean | alias -warn-no-type-decl (advanced) |
| -compiler.warn-scoping-change-in-this | warnScopingChangeInThis | boolean | alias -warn-scoping-change-in-this (advanced) |
| -compiler.warn-super-only-works-for-class-objects | warnSuperOnlyWorksForClassObjects | boolean | alias -warn-super-only-works-for-class-objects (advanced) |
| -compiler.warn-undefined-function | warnUndefinedFunction | boolean | alias -warn-undefined-function (advanced) |
| -compiler.warn-undefined-reference | warnUndefinedReference | boolean | alias -warn-undefined-reference (advanced) |
| -compiler.warn-var-hidden-by-function | warnVarHiddenByFunction | boolean | alias -warn-var-hidden-by-function (advanced) |
| -compiler.warn-wrong-arg-type | warnWrongArgType | boolean | alias -warn-wrong-arg-type (advanced) |
| -compiler.warn-wrong-number-of-args | warnWrongNumberOfArgs | boolean | alias -warn-wrong-number-of-args (advanced) |
| -compiler.warn-xml-class-has-changed | warnXMLClassHasChanged | boolean | alias -warn-xml-class-has-changed (advanced) |
| -debug-password <string> | debugPassword | string | the password to include in debuggable SWFs (advanced) |
| -default-background-color <int> | defaultBackgroundColor | int | default background color (may be overridden by the application code) (advanced) |
| -default-frame-rate <int> | defaultFrameRate | int | default frame rate to be used in the SWF. (advanced) |
| -default-script-limits |
defaultScriptLimits | string | default script execution limits (may be overridden by root attributes) (advanced) |
| -default-size <width> <height> | defaultSize | string | default application size (may be overridden by root attributes in the application) (advanced) |
| -dump-config |
dumpConfig | string | write a file containing all currently set configuration values in a format suitable for use as a flex config file (advanced) |
| -externs [symbol] [...] | externs | string | a list of symbols to omit from linking when building a SWF (advanced, repeatable) |
| -file-specs [path-element] [...] | fileSpecs | string | a list of source files to compile, the last file specified will be used as the target application (repeatable, default variable) |
| -frames.frame [label] [classname] [...] | frame | string | alias -frame A SWF frame label with a sequence of classnames that will be linked onto the frame. (advanced, repeatable) |
| -help [keyword] [...] | help | string | keywords are 'syntax', 'list', 'advanced', 'aliases', 'details', or a search term |
| -includes [symbol] [...] | includes | string | a list of symbols to always link in when building a SWF (advanced, repeatable) |
| -lazy-init | lazyInit | boolean | Enable/Disable ABC bytecode lazy initialization (advanced) |
| -licenses.license <product%gt; <serial-number> | license | string | alias -license (repeatable) |
| -link-report <filename> | linkReport | string | Output a XML-formatted report of all definitions linked into the application. (advanced) |
| -load-config <filename> | loadConfig | string | load a file containing configuration options (repeatable) |
| -load-externs <filename> | loadExterns | string | an XML file containing <def>, <pre>, and <ext> symbols to omit from linking when building a SWF (advanced, repeatable) |
| -metadata.contributor <name> | contributor | string | alias -contributor A contributor's name to store in the SWF metadata (repeatable) |
| -metadata.creator <name> | creator | string | alias -creator A creator's name to store in the SWF metadata (repeatable) |
| -metadata.date <text> | date | string | alias -date The creation date to store in the SWF metadata |
| -metadata.description <text> | description | string | alias -description The default description to store in the SWF metadata |
| -metadata.language <code> | language | string | alias -language The language to store in the SWF metadata (i.e. EN, FR) (repeatable) |
| -metadata.localized-description <text> <lang> | localizedDescription | string | alias -localized-description A localized RDF/XMP description to store in the SWF metadata (repeatable) |
| -metadata.localized-title <title> <lang> | localizedTitle | string | alias -localized-title A localized RDF/XMP title to store in the SWF metadata (repeatable) |
| -metadata.publisher <name> | publisher | string | alias -publisher A publisher's name to store in the SWF metadata (repeatable) |
| -metadata.title <text> | title | string | alias -title The default title to store in the SWF metadata |
| -output <filename> | output | string | alias -o the filename of the SWF movie to create |
| -raw-metadata <text> | rawMetadata | string | XML text to store in the SWF metadata (overrides metadata.* configuration) (advanced) |
| -resource-bundle-list <filename> | resourceBundleList | string | (advanced) |
| -runtime-shared-libraries [url] [...] | RSL | string | alias -rsl a list of runtime shared library URLs to be loaded before the application starts (repeatable) |
| -use-network | useNetwork | boolean | toggle whether the SWF is flagged for access to network resources |
| -version | version | boolean | display the build version of the program |
| -warnings | warnings | boolean | toggle the display of warnings |