ICompilerSettings (Apache Flex - FlexJS: Compiler: Parent 0.8.0-SNAPSHOT API)

All Superinterfaces:

IWriteOnlyProjectSettings

All Known Implementing Classes:

Configurator, Optimizer.OptimizerConfigurator
```
public interface ICompilerSettings
extends IWriteOnlyProjectSettings
```
An interface that allows any of the compiler settings to be modified.

Field Summary

Fields
Modifier and Type	Field and Description
`static int`	`CONTRIBUTOR` A contributor's name to store in the SWF metadata.
`static int`	`CREATOR` A creator's name to store in the SWF metadata.
`static int`	`DATE` The creation date to store in the SWF metadata.
`static int`	`DESCRIPTION` The default and localized RDF/XMP description to store in the SWF metadata.
`static int`	`LANGUAGE` The language to store in the SWF metadata (i.e.
`static int`	`PUBLISHER` A publisher's name to store in the SWF metadata.
`static int`	`TITLE` The default and localized RDF/XMP title to store in the SWF metadata.
`static int`	`WARN_ARRAY_TO_STRING_CHANGES` `Array.toString()` format has changed.
`static int`	`WARN_ASSIGNMENT_WITHIN_CONDITIONAL` Assignment within conditional.
`static int`	`WARN_BAD_ARRAY_CAST` Possibly invalid Array cast operation.
`static int`	`WARN_BAD_BOOLEAN_ASSIGNMENT` Non-Boolean value used where a `Boolean` value was expected.
`static int`	`WARN_BAD_DATE_CAST` Invalid `Date` cast operation.
`static int`	`WARN_BAD_ES3_TYPE_METHOD` Unknown method.
`static int`	`WARN_BAD_ES3_TYPE_PROP` Unknown property.
`static int`	`WARN_BAD_NAN_COMPARISON` Illogical comparison with `NaN`.
`static int`	`WARN_BAD_NULL_ASSIGNMENT` Impossible assignment to `null`.
`static int`	`WARN_BAD_NULL_COMPARISON` Illogical comparison with `null`.
`static int`	`WARN_BAD_UNDEFINED_COMPARISON` Illogical comparison with `undefined`.
`static int`	`WARN_BOOLEAN_CONSTRUCTOR_WITH_NO_ARGS` `Boolean()` with no arguments returns `false` in ActionScript 3.0.
`static int`	`WARN_CHANGES_IN_RESOLVE` `__resolve` is deprecated.
`static int`	`WARN_CLASS_IS_SEALED` `Class` is sealed.
`static int`	`WARN_CONST_NOT_INITIALIZED` Constant not initialized.
`static int`	`WARN_CONSTRUCTOR_RETURNS_VALUE` Function used in new expression returns a value.
`static int`	`WARN_DEPRECATED_EVENT_HANDLER_ERROR` EventHandler was not added as a listener.
`static int`	`WARN_DEPRECATED_FUNCTION_ERROR` Unsupported ActionScript 2.0 function.
`static int`	`WARN_DEPRECATED_PROPERTY_ERROR` Unsupported ActionScript 2.0 property.
`static int`	`WARN_DUPLICATE_ARGUMENT_NAMES` More than one argument by the same name.
`static int`	`WARN_DUPLICATE_VARIABLE_DEF` Duplicate variable definition
`static int`	`WARN_FOR_VAR_IN_CHANGES` ActionScript 3.0 iterates over an object's properties within a "`for x in target`" statement in random order.
`static int`	`WARN_IMPORT_HIDES_CLASS` Importing a package by the same name as the current class will hide that class identifier in this scope.
`static int`	`WARN_INSTANCEOF_CHANGES` Use of the `instanceof` operator.
`static int`	`WARN_INTERNAL_ERROR` Internal error in compiler.
`static int`	`WARN_LEVEL_NOT_SUPPORTED` `_level` is no longer supported.
`static int`	`WARN_MISSING_NAMESPACE_DECL` Missing namespace declaration (e.g. variable is not defined to be `public`, `private`, etc.).
`static int`	`WARN_NEGATIVE_UINT_LITERAL` Negative value will become a large positive value when assigned to a `uint` data type.
`static int`	`WARN_NO_CONSTRUCTOR` Missing constructor.
`static int`	`WARN_NO_EXPLICIT_SUPER_CALL_IN_CONSTRUCTOR` The `super()` statement was not called within the constructor.
`static int`	`WARN_NO_TYPE_DECL` Missing type declaration.
`static int`	`WARN_NUMBER_FROM_STRING_CHANGES` In ActionScript 3.0, white space is ignored and `''` returns `0`.
`static int`	`WARN_SCOPING_CHANGE_IN_THIS` Change in scoping for the `this` keyword.
`static int`	`WARN_SLOW_TEXTFIELD_ADDITION` Inefficient use of `+=` on a `TextField`.
`static int`	`WARN_UNLIKELY_FUNCTION_VALUE` Possible missing parentheses.
`static int`	`WARN_XML_CLASS_HAS_CHANGED` Possible usage of the ActionScript 2.0 `XML` class.

Method Summary

Methods
Modifier and Type	Method and Description
`void`	`addExternalLibraryPath(Collection<File> paths)` Adds to the existing list of SWC files.
`void`	`addLocales(Collection<String> locales)` Add to the existing list of locales without overriding and locales settings in configuration files.
`void`	`addNamespaceMappings(Collection<IMXMLNamespaceMapping> namespaceMappings)` Adds to the existing list of namespace mappings.
`void`	`addRuntimeSharedLibraryPath(List<RSLSettings> rslSettings)` A list of RSLs to load, complete with all the settings on how to load the RSLs.
`void`	`addSourcePath(Collection<File> paths)` Adds a list of path elements to the existing source path list.
`void`	`addTheme(List<File> files)` Adds a list of CSS or SWC files to the existing list of theme files.
`void`	`allowSourcePathOverlap(boolean b)` Allows some source path directories to be subdirectories of the other.
`void`	`checkActionScriptWarning(int warningCode, boolean b)` Enables checking of the following ActionScript warnings: --compiler.warn-array-tostring-changes --compiler.warn-assignment-within-conditional --compiler.warn-bad-array-cast --compiler.warn-bad-bool-assignment --compiler.warn-bad-date-cast --compiler.warn-bad-es3-type-method --compiler.warn-bad-es3-type-prop --compiler.warn-bad-nan-comparison --compiler.warn-bad-null-assignment --compiler.warn-bad-null-comparison --compiler.warn-bad-undefined-comparison --compiler.warn-boolean-constructor-with-no-args --compiler.warn-changes-in-resolve --compiler.warn-class-is-sealed --compiler.warn-const-not-initialized --compiler.warn-constructor-returns-value --compiler.warn-deprecated-event-handler-error --compiler.warn-deprecated-function-error --compiler.warn-deprecated-property-error --compiler.warn-duplicate-argument-names --compiler.warn-duplicate-variable-def --compiler.warn-for-var-in-changes --compiler.warn-import-hides-class --compiler.warn-instance-of-changes --compiler.warn-internal-error --compiler.warn-level-not-supported --compiler.warn-missing-namespace-decl --compiler.warn-negative-uint-literal --compiler.warn-no-constructor --compiler.warn-no-explicit-super-call-in-constructor --compiler.warn-no-type-decl --compiler.warn-number-from-string-changes --compiler.warn-scoping-change-in-this --compiler.warn-slow-text-field-addition --compiler.warn-unlikely-function-value --compiler.warn-xml-class-has-changed
`void`	`compress(boolean b)` Enables ZLIB compression on SWF file.
`void`	`enableAccessibility(boolean b)` Enables accessibility in the application.
`void`	`enableDebugging(boolean b, String debugPassword)` Enables debugging in the application.
`void`	`enableDigestVerification(boolean verify)` Verifies the RSL loaded has the same digest as the RSL specified when the application was compiled.
`void`	`enableIncludeLookupOnly(boolean include)` Controls whether manifest entries with lookupOnly=true are included in the SWC catalog.
`void`	`enableStrictChecking(boolean b)` Runs the ActionScript compiler in strict error checking mode.
`void`	`optimize(boolean b)` Enables post-link optimization.
`void`	`removeUnusedRuntimeSharedLibraryPaths(boolean b)` Enables the removal of RSLs associated with libraries that are not used by an application.
`void`	`setContextRoot(String path)` Sets the context root path so that the compiler can replace `{context.root}` tokens for service channel endpoints.
`void`	`setExternalLibraryPath(Collection<File> paths)` Sets the list of SWC files or directories to compile against, but to omit from linking.
`void`	`setExterns(Collection<String> definitions)` Sets a list of definitions to omit from linking when building an application.
`void`	`setIncludeClasses(Collection<String> includeClasses)` Adds a class, function, variable, or namespace to the target library.
`void`	`setIncludeFiles(Map<String,File> files)` Adds a collection of files to the target library.
`void`	`setIncludeLibraries(Collection<File> libraries)` Includes a list of libraries (SWCs) to completely include in the application This is equivalent to using `mxmlc/compc --compiler.include-libraries`.
`void`	`setIncludeNamespaces(Collection<String> namespaces)` Adds a collection of namespaces to include in this target library.
`void`	`setIncludeResourceBundles(Collection<String> bundles)` Provides a list of resource bundle names that should be compiled into a resource module or library.
`void`	`setIncludeStyleSheet(Map<String,File> styleSheets)` Specifies a map of style sheets to add to the target library.
`void`	`setLibraryPath(Collection<File> paths)` Sets a list of SWC files or directories that contain SWC files.
`void`	`setOutput(File output)` Set the output of the target.
`void`	`setRuntimeSharedLibraries(List<String> libraries)` Sets a list of run-time shared library URLs to be loaded before the application starts.
`void`	`setRuntimeSharedLibraryPath(List<RSLSettings> rslSettings)` A list of RSLs to load, complete with all the settings on how to load the RSLs.
`void`	`setSWFMetadata(int field, Object value)` Sets the metadata section of the application SWF.
`void`	`setSWFMetadata(String xml)` Sets the metadata section of the application SWF.
`void`	`setTargetPlayer(int major, int minor, int revision)` Sets the version of the Flash Player that is being targeted by the application.
`void`	`setTheme(List<File> files)` Sets a list of CSS or SWC files to apply as a theme.
`void`	`setToken(String name, String value)` Defines a token that can be used for token substitutions.
`void`	`showActionScriptWarnings(boolean b)` Runs the ActionScript compiler in a mode that detects legal but potentially incorrect code.
`void`	`showBindingWarnings(boolean b)` Toggles whether warnings generated from data binding code are displayed.
`void`	`showDeprecationWarnings(boolean b)` Toggles whether the use of deprecated APIs generates a warning.
`void`	`showMultipleDefinitionWarnings(boolean b)` Toggles whether warnings generated from two code files with the same name are displayed.
`void`	`showUnusedTypeSelectorWarnings(boolean b)` Toggles whether warnings generated from unused type selectors are displayed.
`void`	`useResourceBundleMetaData(boolean b)` Determines whether resources bundles are included in the application.

Methods inherited from interface org.apache.flex.compiler.internal.config.IWriteOnlyProjectSettings
setActionScriptFileEncoding, setCompatibilityVersion, setDefineDirectives, setExcludeNativeJSLibraries, setExtensionLibraries, setFlex, setIncludeSources, setLocales, setNamespaceMappings, setServicesXMLPath, setSourcePath

- Field Detail
  - WARN_ARRAY_TO_STRING_CHANGES
```
static final int WARN_ARRAY_TO_STRING_CHANGES
```
    Array.toString() format has changed.
    
    See Also:
    Constant Field Values
  - WARN_ASSIGNMENT_WITHIN_CONDITIONAL
```
static final int WARN_ASSIGNMENT_WITHIN_CONDITIONAL
```
    Assignment within conditional.
    
    See Also:
    Constant Field Values
  - WARN_BAD_ARRAY_CAST
```
static final int WARN_BAD_ARRAY_CAST
```
    Possibly invalid Array cast operation.
    
    See Also:
    Constant Field Values
  - WARN_BAD_BOOLEAN_ASSIGNMENT
```
static final int WARN_BAD_BOOLEAN_ASSIGNMENT
```
    Non-Boolean value used where a Boolean value was expected.
    
    See Also:
    Constant Field Values
  - WARN_BAD_DATE_CAST
```
static final int WARN_BAD_DATE_CAST
```
    Invalid Date cast operation.
    
    See Also:
    Constant Field Values
  - WARN_BAD_ES3_TYPE_METHOD
```
static final int WARN_BAD_ES3_TYPE_METHOD
```
    Unknown method.
    
    See Also:
    Constant Field Values
  - WARN_BAD_ES3_TYPE_PROP
```
static final int WARN_BAD_ES3_TYPE_PROP
```
    Unknown property.
    
    See Also:
    Constant Field Values
  - WARN_BAD_NAN_COMPARISON
```
static final int WARN_BAD_NAN_COMPARISON
```
    Illogical comparison with NaN. Any comparison operation involving NaN will evaluate to false because NaN != NaN.
    
    See Also:
    Constant Field Values
  - WARN_BAD_NULL_ASSIGNMENT
```
static final int WARN_BAD_NULL_ASSIGNMENT
```
    Impossible assignment to null.
    
    See Also:
    Constant Field Values
  - WARN_BAD_NULL_COMPARISON
```
static final int WARN_BAD_NULL_COMPARISON
```
    Illogical comparison with null.
    
    See Also:
    Constant Field Values
  - WARN_BAD_UNDEFINED_COMPARISON
```
static final int WARN_BAD_UNDEFINED_COMPARISON
```
    Illogical comparison with undefined. Only untyped variables (or variables of type *) can be undefined.
    
    See Also:
    Constant Field Values
  - WARN_BOOLEAN_CONSTRUCTOR_WITH_NO_ARGS
```
static final int WARN_BOOLEAN_CONSTRUCTOR_WITH_NO_ARGS
```
    Boolean() with no arguments returns false in ActionScript 3.0. Boolean() returned undefined in ActionScript 2.0.
    
    See Also:
    Constant Field Values
  - WARN_CHANGES_IN_RESOLVE
```
static final int WARN_CHANGES_IN_RESOLVE
```
    __resolve is deprecated.
    
    See Also:
    Constant Field Values
  - WARN_CLASS_IS_SEALED
```
static final int WARN_CLASS_IS_SEALED
```
    Class is sealed. It cannot have members added to it dynamically.
    
    See Also:
    Constant Field Values
  - WARN_CONST_NOT_INITIALIZED
```
static final int WARN_CONST_NOT_INITIALIZED
```
    Constant not initialized.
    
    See Also:
    Constant Field Values
  - WARN_CONSTRUCTOR_RETURNS_VALUE
```
static final int WARN_CONSTRUCTOR_RETURNS_VALUE
```
    Function used in new expression returns a value. Result will be what the function returns, rather than a new instance of that function.
    
    See Also:
    Constant Field Values
  - WARN_DEPRECATED_EVENT_HANDLER_ERROR
```
static final int WARN_DEPRECATED_EVENT_HANDLER_ERROR
```
    EventHandler was not added as a listener.
    
    See Also:
    Constant Field Values
  - WARN_DEPRECATED_FUNCTION_ERROR
```
static final int WARN_DEPRECATED_FUNCTION_ERROR
```
    Unsupported ActionScript 2.0 function.
    
    See Also:
    Constant Field Values
  - WARN_DEPRECATED_PROPERTY_ERROR
```
static final int WARN_DEPRECATED_PROPERTY_ERROR
```
    Unsupported ActionScript 2.0 property.
    
    See Also:
    Constant Field Values
  - WARN_DUPLICATE_ARGUMENT_NAMES
```
static final int WARN_DUPLICATE_ARGUMENT_NAMES
```
    More than one argument by the same name.
    
    See Also:
    Constant Field Values
  - WARN_DUPLICATE_VARIABLE_DEF
```
static final int WARN_DUPLICATE_VARIABLE_DEF
```
    Duplicate variable definition
    
    See Also:
    Constant Field Values
  - WARN_FOR_VAR_IN_CHANGES
```
static final int WARN_FOR_VAR_IN_CHANGES
```
    ActionScript 3.0 iterates over an object's properties within a "for x in target" statement in random order.
    
    See Also:
    Constant Field Values
  - WARN_IMPORT_HIDES_CLASS
```
static final int WARN_IMPORT_HIDES_CLASS
```
    Importing a package by the same name as the current class will hide that class identifier in this scope.
    
    See Also:
    Constant Field Values
  - WARN_INSTANCEOF_CHANGES
```
static final int WARN_INSTANCEOF_CHANGES
```
    Use of the instanceof operator.
    
    See Also:
    Constant Field Values
  - WARN_INTERNAL_ERROR
```
static final int WARN_INTERNAL_ERROR
```
    Internal error in compiler.
    
    See Also:
    Constant Field Values
  - WARN_LEVEL_NOT_SUPPORTED
```
static final int WARN_LEVEL_NOT_SUPPORTED
```
    _level is no longer supported. For more information, see the flash.display package.
    
    See Also:
    Constant Field Values
  - WARN_MISSING_NAMESPACE_DECL
```
static final int WARN_MISSING_NAMESPACE_DECL
```
    Missing namespace declaration (e.g. variable is not defined to be public, private, etc.).
    
    See Also:
    Constant Field Values
  - WARN_NEGATIVE_UINT_LITERAL
```
static final int WARN_NEGATIVE_UINT_LITERAL
```
    Negative value will become a large positive value when assigned to a uint data type.
    
    See Also:
    Constant Field Values
  - WARN_NO_CONSTRUCTOR
```
static final int WARN_NO_CONSTRUCTOR
```
    Missing constructor.
    
    See Also:
    Constant Field Values
  - WARN_NO_EXPLICIT_SUPER_CALL_IN_CONSTRUCTOR
```
static final int WARN_NO_EXPLICIT_SUPER_CALL_IN_CONSTRUCTOR
```
    The super() statement was not called within the constructor.
    
    See Also:
    Constant Field Values
  - WARN_NO_TYPE_DECL
```
static final int WARN_NO_TYPE_DECL
```
    Missing type declaration.
    
    See Also:
    Constant Field Values
  - WARN_NUMBER_FROM_STRING_CHANGES
```
static final int WARN_NUMBER_FROM_STRING_CHANGES
```
    In ActionScript 3.0, white space is ignored and '' returns 0. Number() returns NaN in ActionScript 2.0 when the parameter is '' or contains white space.
    
    See Also:
    Constant Field Values
  - WARN_SCOPING_CHANGE_IN_THIS
```
static final int WARN_SCOPING_CHANGE_IN_THIS
```
    Change in scoping for the this keyword. Class methods extracted from an instance of a class will always resolve this back to that instance. In ActionScript 2.0, this is looked up dynamically based on where the method is invoked from.
    
    See Also:
    Constant Field Values
  - WARN_SLOW_TEXTFIELD_ADDITION
```
static final int WARN_SLOW_TEXTFIELD_ADDITION
```
    Inefficient use of += on a TextField.
    
    See Also:
    Constant Field Values
  - WARN_UNLIKELY_FUNCTION_VALUE
```
static final int WARN_UNLIKELY_FUNCTION_VALUE
```
    Possible missing parentheses.
    
    See Also:
    Constant Field Values
  - WARN_XML_CLASS_HAS_CHANGED
```
static final int WARN_XML_CLASS_HAS_CHANGED
```
    Possible usage of the ActionScript 2.0 XML class.
    
    See Also:
    Constant Field Values
  - CONTRIBUTOR
```
static final int CONTRIBUTOR
```
    A contributor's name to store in the SWF metadata.
    
    See Also:
    Constant Field Values
  - CREATOR
```
static final int CREATOR
```
    A creator's name to store in the SWF metadata.
    
    See Also:
    Constant Field Values
  - DATE
```
static final int DATE
```
    The creation date to store in the SWF metadata.
    
    See Also:
    Constant Field Values
  - DESCRIPTION
```
static final int DESCRIPTION
```
    The default and localized RDF/XMP description to store in the SWF metadata.
    
    See Also:
    Constant Field Values
  - TITLE
```
static final int TITLE
```
    The default and localized RDF/XMP title to store in the SWF metadata.
    
    See Also:
    Constant Field Values
  - LANGUAGE
```
static final int LANGUAGE
```
    The language to store in the SWF metadata (i.e. EN, FR).
    
    See Also:
    Constant Field Values
  - PUBLISHER
```
static final int PUBLISHER
```
    A publisher's name to store in the SWF metadata.
    
    See Also:
    Constant Field Values
- Method Detail
  - setToken
```
void setToken(String name,
            String value)
```
    Defines a token that can be used for token substitutions. On the command line, you use token substitution in the following way:
```
 mxmlc +flexlib=path1 +foo=bar -var=${foo}
 
```
    Where var=bar occurs after the substitution of ${foo}.
    Parameters:
    name - The name of the token.
    value - The value of the token.
  - setContextRoot
```
void setContextRoot(String path)
```
    Sets the context root path so that the compiler can replace {context.root} tokens for service channel endpoints. This is equivalent to using the compiler.context-root option for the mxmlc or compc compilers.
    By default, this value is undefined.
    
    Parameters:
    path - An instance of String.
  - setExternalLibraryPath
```
void setExternalLibraryPath(Collection<File> paths)
```
    Sets the list of SWC files or directories to compile against, but to omit from linking. This is equivalent to using the compiler.external-library-path option of the mxmlc or compc compilers.
    
    Parameters:
    paths - A list of paths. The File.isDirectory() method should return true; File instances should represent SWC files.
  - addExternalLibraryPath
```
void addExternalLibraryPath(Collection<File> paths)
```
    Adds to the existing list of SWC files.
    
    Parameters:
    paths - A list of paths. The File.isDirectory() method should return true; File instances should represent SWC files.
    See Also:
    setExternalLibraryPath(java.util.Collection<java.io.File>)
  - addNamespaceMappings
```
void addNamespaceMappings(Collection<IMXMLNamespaceMapping> namespaceMappings)
```
    Adds to the existing list of namespace mappings.
    
    Parameters:
    namespaceMappings -
  - setLibraryPath
```
void setLibraryPath(Collection<File> paths)
```
    Sets a list of SWC files or directories that contain SWC files. This is equivalent to using the compiler.library-path option of the mxmlc or compc compilers.
    
    Parameters:
    paths - An array of File objects. The File.isDirectory() method should return true; instances must represent SWC files.
  - addSourcePath
```
void addSourcePath(Collection<File> paths)
```
    Adds a list of path elements to the existing source path list.
    
    Parameters:
    paths - A collection of java.io.File objects. The File.isDirectory() method must return true.
    See Also:
    IWriteOnlyProjectSettings.setSourcePath(java.util.List<java.io.File>)
  - enableAccessibility
```
void enableAccessibility(boolean b)
```
    Enables accessibility in the application. This is equivalent to using the accessible option of the mxmlc or compc compilers.
    The default value is false.
    
    Parameters:
    b - Boolean value that enables or disables accessibility.
  - enableStrictChecking
```
void enableStrictChecking(boolean b)
```
    Runs the ActionScript compiler in strict error checking mode. This is equivalent to using the compiler.strict option of the mxmlc or compc compilers.
    The default value is true.
    
    Parameters:
    b - Boolean value.
  - showActionScriptWarnings
```
void showActionScriptWarnings(boolean b)
```
    Runs the ActionScript compiler in a mode that detects legal but potentially incorrect code. This is equivalent to using the compiler.show-actionscript-warnings option of the mxmlc or compc compilers.
    The default value is true.
    
    Parameters:
    b - Boolean value.
    See Also:
    checkActionScriptWarning(int, boolean)
  - showBindingWarnings
```
void showBindingWarnings(boolean b)
```
    Toggles whether warnings generated from data binding code are displayed. This is equivalent to using the compiler.show-binding-warnings option of the mxmlc or compc compilers.
    The default value is true.
    
    Parameters:
    b - Boolean value.
  - showDeprecationWarnings
```
void showDeprecationWarnings(boolean b)
```
    Toggles whether the use of deprecated APIs generates a warning. This is equivalent to using the compiler.show-deprecation-warnings option of the mxmlc or compc compilers.
    The default value is true.
    
    Parameters:
    b - Boolean value.
  - showUnusedTypeSelectorWarnings
```
void showUnusedTypeSelectorWarnings(boolean b)
```
    Toggles whether warnings generated from unused type selectors are displayed. This is equivalent to using the compiler.show-unused-type-selector-warnings option of the mxmlc or compc compilers.
    The default value is true.
    
    Parameters:
    b - Boolean value.
  - showMultipleDefinitionWarnings
```
void showMultipleDefinitionWarnings(boolean b)
```
    Toggles whether warnings generated from two code files with the same name are displayed. This is equivalent to using the compiler.show-multiple-definition-warnings option of the mxmlc or compc compilers.
    The default value is true.
    
    Parameters:
    b - Boolean value.
  - setTheme
```
void setTheme(List<File> files)
```
    Sets a list of CSS or SWC files to apply as a theme. This is equivalent to using the compiler.theme option of the mxmlc or compc compilers.
    
    Parameters:
    files - An array of java.io.File objects.
  - addTheme
```
void addTheme(List<File> files)
```
    Adds a list of CSS or SWC files to the existing list of theme files.
    
    Parameters:
    files - An array of java.io.File objects.
    See Also:
    setTheme(java.util.List<java.io.File>)
  - setRuntimeSharedLibraries
```
void setRuntimeSharedLibraries(List<String> libraries)
```
    Sets a list of run-time shared library URLs to be loaded before the application starts. This is equivalent to the runtime-shared-libraries option of the mxmlc or compc compilers.
    
    Parameters:
    libraries - An array of java.lang.String objects.
  - setRuntimeSharedLibraryPath
```
void setRuntimeSharedLibraryPath(List<RSLSettings> rslSettings)
```
    A list of RSLs to load, complete with all the settings on how to load the RSLs. The RSLs will be loaded in the order that they appear in the list. This is the complete list of RSLs that could possibly be loaded. This list could be reduced if unused RSLs are being removed. These RSL settings override any settings in configuration files. Set an empty list to disable the use of RSLs. This is equivalent to using the following command line options in the mxmlc compiler:
    - runtime-shared-library-path
    - application-domain
    - force-rsls
    If rslSettings is null, then all existing RSL settings are removed. It will have the effect of removing the RSL related options from the command line which will allow settings from configuration files to be applied to the configuration.
    Parameters:
    rslSettings - A list of RSLSettings.
  - addRuntimeSharedLibraryPath
```
void addRuntimeSharedLibraryPath(List<RSLSettings> rslSettings)
```
    A list of RSLs to load, complete with all the settings on how to load the RSLs. The RSLs will be loaded in the order that they appear in the list. This is the complete list of RSLs that could possibly be loaded. This list could be reduced if unused RSLs are being removed. The RSL provided to this method append to list of RSLs specified in any configuration files. This is equivalent to using the following command line options in the mxmlc compiler:
    - runtime-shared-library-path+=
    - application-domain+=
    - force-rsls+=
    Parameters:
    rslSettings - A list of RSLSettings. May not be null.
    
    Throws:
    
    NullPointerException - if rslSettings is null.
  - enableDigestVerification
```
void enableDigestVerification(boolean verify)
```
    Verifies the RSL loaded has the same digest as the RSL specified when the application was compiled. This is equivalent to using the verify-digests option in the mxmlc compiler. The default value is true
    
    Parameters:
    verify - set to true to verify the digest of the loaded RSL matches the digest of the expected RSL. Set to false to disable the checks during the development process but it is highly recommend that production applications be compiled with verify set to true.
    Since:
    
    3.0
  - removeUnusedRuntimeSharedLibraryPaths
```
void removeUnusedRuntimeSharedLibraryPaths(boolean b)
```
    Enables the removal of RSLs associated with libraries that are not used by an application. This is equivalent to using the remove-unused-rsls option of the mxmlc compiler.
    The default value is false.
    
    Parameters:
    b - Boolean value that enables or disables the removal.
    Since:
    
    4.5
  - setExterns
```
void setExterns(Collection<String> definitions)
```
    Sets a list of definitions to omit from linking when building an application. This is equivalent to using the externs option of the mxmlc and compc compilers.
    
    Parameters:
    definitions - An array of definitions (for example, classes, functions, variables, or namespaces).
  - optimize
```
void optimize(boolean b)
```
    Enables post-link optimization. This is equivalent to using the compiler.optimize option of the mxmlc or compc compilers. Application sizes are usually smaller with this option enabled.
    The default value is true.
    
    Parameters:
    b - Boolean value.
  - enableDebugging
```
void enableDebugging(boolean b,
                   String debugPassword)
```
    Enables debugging in the application. This is equivalent to using the compiler.debug and -debug-password=true|false options for the mxmlc or compc compilers.
    The default value debug is false. The default debug password is "".
    
    Parameters:
    b - Boolean value that enables or disables debugging.
    debugPassword - A password that is embedded in the application.
  - compress
```
void compress(boolean b)
```
    Enables ZLIB compression on SWF file. This is equivalent to using the compiler.compress option of the mxmlc or compc compilers. Application sizes are usually smaller with this option enabled.
    
    Parameters:
    b - Boolean value.
  - allowSourcePathOverlap
```
void allowSourcePathOverlap(boolean b)
```
    Allows some source path directories to be subdirectories of the other. This is equivalent to using mxmlc/compc --compiler.allow-source-path-overlap.
    By default, this is disabled.
    In some J2EE settings, directory overlapping should be allowed. For example,
```
 wwwroot/MyAppRoot
 wwwroot/WEB-INF/flex/source_path1
 
```
    Parameters:
    b - boolean value
  - useResourceBundleMetaData
```
void useResourceBundleMetaData(boolean b)
```
    Determines whether resources bundles are included in the application. This is equivalent to using mxmlc/compc --compiler.use-resource-bundle-metadata. By default, it is set to true.
    
    Parameters:
    b - boolean value
  - checkActionScriptWarning
```
void checkActionScriptWarning(int warningCode,
                            boolean b)
```
    Enables checking of the following ActionScript warnings:
```
 --compiler.warn-array-tostring-changes
 --compiler.warn-assignment-within-conditional
 --compiler.warn-bad-array-cast
 --compiler.warn-bad-bool-assignment
 --compiler.warn-bad-date-cast
 --compiler.warn-bad-es3-type-method
 --compiler.warn-bad-es3-type-prop
 --compiler.warn-bad-nan-comparison
 --compiler.warn-bad-null-assignment
 --compiler.warn-bad-null-comparison
 --compiler.warn-bad-undefined-comparison
 --compiler.warn-boolean-constructor-with-no-args
 --compiler.warn-changes-in-resolve
 --compiler.warn-class-is-sealed
 --compiler.warn-const-not-initialized
 --compiler.warn-constructor-returns-value
 --compiler.warn-deprecated-event-handler-error
 --compiler.warn-deprecated-function-error
 --compiler.warn-deprecated-property-error
 --compiler.warn-duplicate-argument-names
 --compiler.warn-duplicate-variable-def
 --compiler.warn-for-var-in-changes
 --compiler.warn-import-hides-class
 --compiler.warn-instance-of-changes
 --compiler.warn-internal-error
 --compiler.warn-level-not-supported
 --compiler.warn-missing-namespace-decl
 --compiler.warn-negative-uint-literal
 --compiler.warn-no-constructor
 --compiler.warn-no-explicit-super-call-in-constructor
 --compiler.warn-no-type-decl
 --compiler.warn-number-from-string-changes
 --compiler.warn-scoping-change-in-this
 --compiler.warn-slow-text-field-addition
 --compiler.warn-unlikely-function-value
 --compiler.warn-xml-class-has-changed
 
```
    Parameters:
    warningCode - Warning code.
    b - Boolean value.
    See Also:
    WARN_ARRAY_TO_STRING_CHANGES, WARN_ASSIGNMENT_WITHIN_CONDITIONAL, WARN_BAD_ARRAY_CAST, WARN_BAD_BOOLEAN_ASSIGNMENT, WARN_BAD_DATE_CAST, WARN_BAD_ES3_TYPE_METHOD, WARN_BAD_ES3_TYPE_PROP, WARN_BAD_NAN_COMPARISON, WARN_BAD_NULL_ASSIGNMENT, WARN_BAD_NULL_COMPARISON, WARN_BAD_UNDEFINED_COMPARISON, WARN_BOOLEAN_CONSTRUCTOR_WITH_NO_ARGS, WARN_CHANGES_IN_RESOLVE, WARN_CLASS_IS_SEALED, WARN_CONST_NOT_INITIALIZED, WARN_CONSTRUCTOR_RETURNS_VALUE, WARN_DEPRECATED_EVENT_HANDLER_ERROR, WARN_DEPRECATED_FUNCTION_ERROR, WARN_DEPRECATED_PROPERTY_ERROR, WARN_DUPLICATE_ARGUMENT_NAMES, WARN_DUPLICATE_VARIABLE_DEF, WARN_FOR_VAR_IN_CHANGES, WARN_IMPORT_HIDES_CLASS, WARN_INSTANCEOF_CHANGES, WARN_INTERNAL_ERROR, WARN_LEVEL_NOT_SUPPORTED, WARN_MISSING_NAMESPACE_DECL, WARN_NEGATIVE_UINT_LITERAL, WARN_NO_CONSTRUCTOR, WARN_NO_EXPLICIT_SUPER_CALL_IN_CONSTRUCTOR, WARN_NO_TYPE_DECL, WARN_NUMBER_FROM_STRING_CHANGES, WARN_SCOPING_CHANGE_IN_THIS, WARN_SLOW_TEXTFIELD_ADDITION, WARN_UNLIKELY_FUNCTION_VALUE, WARN_XML_CLASS_HAS_CHANGED
  - setSWFMetadata
```
void setSWFMetadata(int field,
                  Object value)
```
    Sets the metadata section of the application SWF. This option is equivalent to using the following options of the mxmlc and compc compilers:
```
 metadata.contributor
 metadata.creator
 metadata.date
 metadata.description
 metadata.language
 metadata.localized-description
 metadata.localized-title
 metadata.publisher
 metadata.title
 
```
    The valid fields and types of value are specified below:
```
 CONTRIBUTOR      java.lang.String
 CREATOR          java.lang.String
 DATE             java.util.Date
 DESCRIPTION      java.util.Map
 TITLE            java.util.Map
 LANGUAGE         java.lang.String
 PUBLISHER        java.lang.String
 
```
    For example:
```
 Map titles = new HashMap();
 titles.put("EN", "Apache Flex 4.8.0 Application");
 
 Map descriptions = new HashMap();
 descriptions.put("EN", "http://www.adobe.com/products/flex");
 
 setSWFMetadata(Configuration.LANGUAGE, "EN");
 setSWFMetadata(Configuration.TITLE, titles);
 setSWFMetadata(Configuration.DESCRIPTION, descriptions);
 
```
    Parameters:
    field - One of: CONTRIBUTOR, CREATOR, DATE, DESCRIPTION, TITLE, LANGUAGE, or PUBLISHER.
    value - A String, Date, or Map object.
    See Also:
    CONTRIBUTOR, CREATOR, DATE, DESCRIPTION, TITLE, LANGUAGE, PUBLISHER
  - setSWFMetadata
```
void setSWFMetadata(String xml)
```
    Sets the metadata section of the application SWF. This is equivalent to using mxmlc/compc --raw-metadata. This option overrides everything set by the setSWFMetadata method.
    
    Parameters:
    xml - a well-formed XML fragment
    See Also:
    setSWFMetadata(int, java.lang.Object)
  - addLocales
```
void addLocales(Collection<String> locales)
```
    Add to the existing list of locales without overriding and locales settings in configuration files. The locale/en_US directory will be added to the source path.
  - setOutput
```
void setOutput(File output)
```
    Set the output of the target.
    
    Parameters:
    output - File that specifies the where the target should be created.
  - setIncludeLibraries
```
void setIncludeLibraries(Collection<File> libraries)
```
    Includes a list of libraries (SWCs) to completely include in the application This is equivalent to using mxmlc/compc --compiler.include-libraries.
    
    Parameters:
    libraries - a collection of java.io.File (File.isDirectory() should return true or instances must represent SWC files).
  - setIncludeResourceBundles
```
void setIncludeResourceBundles(Collection<String> bundles)
```
    Provides a list of resource bundle names that should be compiled into a resource module or library.
    
    Parameters:
    bundles - A collection of resource bundle names.
  - setTargetPlayer
```
void setTargetPlayer(int major,
                   int minor,
                   int revision)
```
    Sets the version of the Flash Player that is being targeted by the application. Features requiring a later version of the Player will not be compiled into the application.
    
    Parameters:
    major - The major version. Must be greater than or equal to nine.
    minor - The minor version. Must be greater than or equal to zero.
    revision - The revsion must be greater than or equal to zero.
  - setIncludeClasses
```
void setIncludeClasses(Collection<String> includeClasses)
```
    Adds a class, function, variable, or namespace to the target library. This is the equilvalent of the include-classes option of the compc compiler.
    
    Parameters:
    includeClasses - a collection of fully-qualified class names.
  - setIncludeFiles
```
void setIncludeFiles(Map<String,File> files)
```
    Adds a collection of files to the target library. This is equivalent to the include-file option of the compc compiler. Each entry in the map represents a file to include in the target library. The key is the name of the file in the target library and the value is the file that will be added to the library.
    
    Parameters:
    files - The collection of files to be added.
  - setIncludeNamespaces
```
void setIncludeNamespaces(Collection<String> namespaces)
```
    Adds a collection of namespaces to include in this target library. This is equivalent to the include-namespaces option of the compc compiler.
    
    Parameters:
    namespaces - A collection of Strings where each String is a namespace URI.
  - setIncludeStyleSheet
```
void setIncludeStyleSheet(Map<String,File> styleSheets)
```
    Specifies a map of style sheets to add to the target library. The map's key/value pairs are as follows: key: the name of the file in the target library value: the File to include.
    
    Parameters:
    styleSheets - a map of names to Files to include in the target library.
  - enableIncludeLookupOnly
```
void enableIncludeLookupOnly(boolean include)
```
    Controls whether manifest entries with lookupOnly=true are included in the SWC catalog.
    
    Parameters:
    include - true only manifest entries with lookupOnly=true are included in the SWC catalog, false otherwise.

Interface ICompilerSettings

Field Summary

Method Summary

Methods inherited from interface org.apache.flex.compiler.internal.config.IWriteOnlyProjectSettings

Field Detail

WARN_ARRAY_TO_STRING_CHANGES

WARN_ASSIGNMENT_WITHIN_CONDITIONAL

WARN_BAD_ARRAY_CAST

WARN_BAD_BOOLEAN_ASSIGNMENT

WARN_BAD_DATE_CAST

WARN_BAD_ES3_TYPE_METHOD

WARN_BAD_ES3_TYPE_PROP

WARN_BAD_NAN_COMPARISON

WARN_BAD_NULL_ASSIGNMENT

WARN_BAD_NULL_COMPARISON

WARN_BAD_UNDEFINED_COMPARISON

WARN_BOOLEAN_CONSTRUCTOR_WITH_NO_ARGS

WARN_CHANGES_IN_RESOLVE

WARN_CLASS_IS_SEALED

WARN_CONST_NOT_INITIALIZED

WARN_CONSTRUCTOR_RETURNS_VALUE

WARN_DEPRECATED_EVENT_HANDLER_ERROR

WARN_DEPRECATED_FUNCTION_ERROR

WARN_DEPRECATED_PROPERTY_ERROR

WARN_DUPLICATE_ARGUMENT_NAMES

WARN_DUPLICATE_VARIABLE_DEF

WARN_FOR_VAR_IN_CHANGES

WARN_IMPORT_HIDES_CLASS

WARN_INSTANCEOF_CHANGES

WARN_INTERNAL_ERROR

WARN_LEVEL_NOT_SUPPORTED

WARN_MISSING_NAMESPACE_DECL

WARN_NEGATIVE_UINT_LITERAL

WARN_NO_CONSTRUCTOR

WARN_NO_EXPLICIT_SUPER_CALL_IN_CONSTRUCTOR

WARN_NO_TYPE_DECL

WARN_NUMBER_FROM_STRING_CHANGES

WARN_SCOPING_CHANGE_IN_THIS

WARN_SLOW_TEXTFIELD_ADDITION

WARN_UNLIKELY_FUNCTION_VALUE

WARN_XML_CLASS_HAS_CHANGED

CONTRIBUTOR

CREATOR

DATE

DESCRIPTION

TITLE

LANGUAGE

PUBLISHER

Method Detail

setToken

setContextRoot

setExternalLibraryPath

addExternalLibraryPath

addNamespaceMappings

setLibraryPath

addSourcePath

enableAccessibility

enableStrictChecking

showActionScriptWarnings

showBindingWarnings

showDeprecationWarnings

showUnusedTypeSelectorWarnings

showMultipleDefinitionWarnings

setTheme

addTheme

setRuntimeSharedLibraries

setRuntimeSharedLibraryPath

addRuntimeSharedLibraryPath

enableDigestVerification

removeUnusedRuntimeSharedLibraryPaths

setExterns

optimize

enableDebugging

compress

allowSourcePathOverlap

useResourceBundleMetaData

checkActionScriptWarning

setSWFMetadata

setSWFMetadata

addLocales