public class OEMConfiguration extends Object implements Configuration, Cloneable
CONTRIBUTOR, CREATOR, DATE, DEFAULT_OUTPUT_DIRECTORY_TOKEN, DESCRIPTION, LANGUAGE, PUBLISHER, TITLE, WARN_ARRAY_TOSTRING_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
Modifier and Type | Method and Description |
---|---|
void |
addActionScriptMetadata(String[] md)
Adds the list of AS3 metadata names to the existing list of AS3 metadata the compiler should
keep in the SWF.
|
void |
addApplicationDomainForRuntimeSharedLibraryPath(File path,
String applicationDomainTarget)
Add application domain setting to the existing list of application domain
settings.
|
void |
addConfiguration(File file)
Adds a file to the existing list of configuration files.
|
void |
addDefineDirective(String name,
String value)
Add a global AS3 compiler configuration value and preserve existing definitions.
|
void |
addExtensionLibraries(File extension,
List<String> parameter) |
void |
addExternalLibraryPath(File[] paths)
Adds to the existing list of SWC files.
|
void |
addExterns(File[] files)
Adds a list of files to the existing list of definitions to be omitted from linking.
|
void |
addExterns(String[] definitions)
Adds a list of definitions to the existing list of definitions.
|
void |
addFontManagers(String[] classNames)
Adds font managers to the existing font manager list.
|
void |
addForceRuntimeSharedLibraryPaths(File[] paths)
Adds SWCs to the existing set of SWCs whose RSLs will be loaded at runtime.
|
void |
addIncludeResourceBundles(String[] bundles)
Adds a list of resource bundles to the existing list.
|
void |
addIncludes(String[] definitions)
Adds a list of definitions to the existing list of definitions.
|
void |
addLibraryPath(File[] paths)
Adds a list of SWC files or directories to the default library path.
|
void |
addLocalFontPaths(String[] paths)
Adds local font paths to the existing local font path list.
|
void |
addRuntimeSharedLibraries(String[] libraries)
Adds a list of runtime shared library URLs to the existing list.
|
void |
addRuntimeSharedLibraryPath(String swc,
String[] rslUrls,
String[] policyFileUrls)
This is equivalent to using more than one
runtime-shared-library-path
option when using the mxmlc compiler. |
void |
addSourcePath(File[] paths)
Adds a list of path elements to the existing source path list.
|
void |
addTheme(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 ActionScript warnings.
|
OEMConfiguration |
clone() |
void |
compress(boolean b)
Enables ZLIB compression on SWF file.
|
void |
enableAccessibility(boolean b)
Enables accessibility in the application.
|
void |
enableAdvancedAntiAliasing(boolean b)
Enables advanced anti-aliasing for embedded fonts, which provides greater clarity for small fonts.
|
void |
enableDebugging(boolean b,
String debugPassword)
Enables debugging in the application.
|
void |
enableDigestComputation(boolean compute)
Enable or disable the computation of a digest for the created swf library.
|
void |
enableDigestVerification(boolean verify)
Verifies the RSL loaded
has the same digest as the RSL specified when the application was compiled.
|
void |
enableFlashType(boolean b)
Enables FlashType for embedded fonts, which provides greater clarity for small fonts.
|
void |
enableStrictChecking(boolean b)
Runs the ActionScript compiler in strict error checking mode.
|
void |
enableVerboseStacktraces(boolean b)
Generates bytecodes that include line numbers.
|
String[] |
getCompilerOptions() |
Map<String,List<String>> |
getExtensions() |
String[] |
getLinkerOptions() |
boolean |
hasChanged() |
void |
includeLibraries(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 |
keepAllTypeSelectors(boolean b)
Disables the pruning of unused type selectors.
|
void |
keepCompilerGeneratedActionScript(boolean b)
Saves temporary source files generated during MXML compilation.
|
boolean |
keepConfigurationReport() |
void |
keepConfigurationReport(boolean b)
Instructs the compiler to keep a report of the compiler configuration settings.
|
boolean |
keepLinkReport() |
void |
keepLinkReport(boolean b)
Instructs the linker to keep a report of the content that is included in the application.
|
boolean |
keepSizeReport() |
void |
keepSizeReport(boolean b)
Instructs the linker to keep a SWF size report.
|
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 |
reset() |
void |
setActionScriptFileEncoding(String encoding)
Sets the ActionScript file encoding.
|
void |
setActionScriptMetadata(String[] md)
Sets the AS3 metadata the compiler should keep in the SWF.
|
void |
setApplicationDomainForRuntimeSharedLibraryPath(File path,
String applicationDomainTarget)
Set the application domain of a configured RSL to override the default
settings.
|
void |
setCompatibilityVersion(int major,
int minor,
int revision)
Sets the SDK compatibility version.
|
void |
setComponentManifest(String namespaceURI,
File manifest)
Specifies a URI to associate with a manifest of components for use as
MXML elements.
|
void |
setComponentManifests(String namespaceURI,
List<File> manifests)
Specifies a URI to associate with a list of potentially several manifests
which map MXML elements to component implementations.
|
void |
setConfiguration(File file)
Loads a file containing configuration options.
|
void |
setConfiguration(String[] args)
Sets the configuration parameters.
|
void |
setContextRoot(String path)
Sets the context root path so that the compiler can replace
{context.root} tokens for
service channel endpoints. |
void |
setDefaultBackgroundColor(int color)
Sets the default background color (may be overridden by the application code).
|
void |
setDefaultCSS(File url)
Sets the location of the default CSS file.
|
void |
setDefaultFrameRate(int rate)
Sets the default frame rate to be used in the application.
|
void |
setDefaultScriptLimits(int maxRecursionDepth,
int maxExecutionTime)
Sets the default script execution limits (may be overridden by root attributes).
|
void |
setDefaultSize(int width,
int height)
Sets the default window size.
|
void |
setDefineDirective(String[] names,
String[] values)
Set global AS3 compiler configuration values and clear existing definitions.
|
void |
setExtensionLibraries(Map<File,List<String>> extensions) |
void |
setExternalLibraryPath(File[] paths)
Sets the list of SWC files or directories to compile against but to omit from linking.
|
void |
setExterns(File[] files)
Sets a list of definitions to omit from linking when building an application.
|
void |
setExterns(String[] definitions)
Sets a list of definitions to omit from linking when building an application.
|
void |
setFontLanguageRange(String language,
String range)
Sets a range to restrict the number of font glyphs embedded into the application.
|
void |
setFontManagers(String[] classNames)
Sets the font managers used by the compiler.
|
void |
setForceRuntimeSharedLibraryPaths(File[] paths)
Sets the SWCs that will have their associated RSLs loaded at runtime.
|
void |
setFrameLabel(String label,
String[] classNames)
Sets a SWF frame label with a sequence of classnames that will be linked onto the frame.
|
void |
setIncludeResourceBundles(String[] bundles)
Sets a list of resource bundles to include in the swf.
|
void |
setIncludes(String[] definitions)
Sets a list of definitions to always link in when building an application.
|
void |
setLibraryPath(File[] paths)
Sets a list of SWC files or directories that contain SWC files.
|
void |
setLicense(String productName,
String serialNumber)
Specifies the licenses that the compiler has to validate before compiling.
|
void |
setLocale(Locale locale)
Deprecated.
As of 3.0, use setLocale(String[])
|
void |
setLocale(String[] locales)
Sets the locales that the compiler would use to replace
{locale} tokens that appear in some configuration values. |
void |
setLocalFontPaths(String[] paths)
Sets the local font file paths to be searched by the compiler.
|
void |
setLocalFontSnapshot(File file)
Sets the location of the local font snapshot file.
|
void |
setMaximumCachedFonts(int size)
Sets the maximum number of embedded font faces that can be cached.
|
void |
setMaximumGlyphsPerFace(int size)
Sets the maximum number of character glyph outlines to cache for each font face.
|
void |
setProjector(File file)
Sets the path to the Flash Player executable when building a projector.
|
void |
setRuntimeSharedLibraries(String[] libraries)
Sets a list of runtime shared library URLs to be loaded before the application starts.
|
void |
setRuntimeSharedLibraryPath(String swc,
String[] rslUrls,
String[] policyFileUrls)
Set the arguments required to use an RSL with optional failover RSLs.
|
void |
setServiceConfiguration(File file)
Sets the location of the FDS service configuration file.
|
void |
setSourcePath(File[] paths)
Sets a list of path elements that form the roots of ActionScript class hierarchies.
|
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(File[] files)
Sets a list of CSS or SWC files to apply as a theme.
|
void |
setToken(String name,
String value)
Defines a token. mxmlc and compc support 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 |
showShadowedDeviceFontWarnings(boolean b)
Toggles whether warnings are displayed when an embedded font name shadows
a device font name.
|
void |
showUnusedTypeSelectorWarnings(boolean b)
Toggles whether warnings generated from unused type selectors are displayed.
|
String |
toString() |
void |
useActionScript3(boolean b)
Uses the ActionScript 3 class based object model for greater performance and better error reporting.
|
void |
useECMAScript(boolean b)
Uses the ECMAScript edition 3 prototype based object model to allow dynamic overriding
of prototype properties.
|
void |
useHeadlessServer(boolean b)
Sets the compiler when it runs on a server without a display.
|
void |
useNetwork(boolean b)
Toggles whether the application SWF is flagged for access to network resources.
|
void |
useResourceBundleMetaData(boolean b)
Determines whether resources bundles are included in the application.
|
public ConfigurationBuffer cfgbuf
public final ToolsConfiguration configuration
public static final String USE_NETWORK
public static final String RUNTIME_SHARED_LIBRARIES
public static final String RAW_METADATA
public static final String PROJECTOR
public static final String METADATA_PUBLISHER
public static final String METADATA_LANGUAGE
public static final String METADATA_LOCALIZED_TITLE
public static final String METADATA_LOCALIZED_DESCRIPTION
public static final String METADATA_DATE
public static final String METADATA_CREATOR
public static final String METADATA_CONTRIBUTOR
public static final String LINK_REPORT
public static final String SIZE_REPORT
public static final String LICENSES_LICENSE
public static final String INCLUDES
public static final String INCLUDE_RESOURCE_BUNDLES
public static final String FRAMES_FRAME
public static final String LOAD_EXTERNS
public static final String LOAD_CONFIG
public static final String EXTERNS
public static final String DEFAULT_SIZE
public static final String DEFAULT_SCRIPT_LIMITS
public static final String DEFAULT_FRAME_RATE
public static final String DEFAULT_BACKGROUND_COLOR
public static final String DEBUG_PASSWORD
public static final String SWF_VERSION
public static final String COMPILER_WARN_XML_CLASS_HAS_CHANGED
public static final String COMPILER_WARN_UNLIKELY_FUNCTION_VALUE
public static final String COMPILER_WARN_SLOW_TEXT_FIELD_ADDITION
public static final String COMPILER_WARN_SCOPING_CHANGE_IN_THIS
public static final String COMPILER_WARN_NUMBER_FROM_STRING_CHANGES
public static final String COMPILER_WARN_NO_TYPE_DECL
public static final String COMPILER_WARN_NO_EXPLICIT_SUPER_CALL_IN_CONSTRUCTOR
public static final String COMPILER_WARN_NO_CONSTRUCTOR
public static final String COMPILER_WARN_NEGATIVE_UINT_LITERAL
public static final String COMPILER_WARN_MISSING_NAMESPACE_DECL
public static final String COMPILER_WARN_LEVEL_NOT_SUPPORTED
public static final String COMPILER_WARN_INTERNAL_ERROR
public static final String COMPILER_WARN_INSTANCE_OF_CHANGES
public static final String COMPILER_WARN_IMPORT_HIDES_CLASS
public static final String COMPILER_WARN_FOR_VAR_IN_CHANGES
public static final String COMPILER_WARN_DUPLICATE_VARIABLE_DEF
public static final String COMPILER_WARN_DUPLICATE_ARGUMENT_NAMES
public static final String COMPILER_WARN_DEPRECATED_PROPERTY_ERROR
public static final String COMPILER_WARN_DEPRECATED_FUNCTION_ERROR
public static final String COMPILER_WARN_DEPRECATED_EVENT_HANDLER_ERROR
public static final String COMPILER_WARN_CONSTRUCTOR_RETURNS_VALUE
public static final String COMPILER_WARN_CONST_NOT_INITIALIZED
public static final String COMPILER_WARN_CLASS_IS_SEALED
public static final String COMPILER_WARN_CHANGES_IN_RESOLVE
public static final String COMPILER_WARN_BOOLEAN_CONSTRUCTOR_WITH_NO_ARGS
public static final String COMPILER_WARN_BAD_UNDEFINED_COMPARISON
public static final String COMPILER_WARN_BAD_NULL_COMPARISON
public static final String COMPILER_WARN_BAD_NULL_ASSIGNMENT
public static final String COMPILER_WARN_BAD_NAN_COMPARISON
public static final String COMPILER_WARN_BAD_ES3_TYPE_PROP
public static final String COMPILER_WARN_BAD_ES3_TYPE_METHOD
public static final String COMPILER_WARN_BAD_DATE_CAST
public static final String COMPILER_WARN_BAD_BOOL_ASSIGNMENT
public static final String COMPILER_WARN_BAD_ARRAY_CAST
public static final String COMPILER_WARN_ASSIGNMENT_WITHIN_CONDITIONAL
public static final String COMPILER_WARN_ARRAY_TOSTRING_CHANGES
public static final String COMPILER_VERBOSE_STACKTRACES
public static final String COMPILER_USE_RESOURCE_BUNDLE_METADATA
public static final String COMPILER_THEME
public static final String COMPILER_STRICT
public static final String COMPILER_SOURCE_PATH
public static final String COMPILER_SHOW_UNUSED_TYPE_SELECTOR_WARNINGS
public static final String COMPILER_SHOW_DEPRECATION_WARNINGS
public static final String COMPILER_SHOW_SHADOWED_DEVICE_FONT_WARNINGS
public static final String COMPILER_SHOW_BINDING_WARNINGS
public static final String COMPILER_SHOW_ACTIONSCRIPT_WARNINGS
public static final String COMPILER_SERVICES
public static final String COMPILER_OPTIMIZE
public static final String COMPILER_NAMESPACES_NAMESPACE
public static final String COMPILER_MOBILE
public static final String COMPILER_LOCALE
public static final String COMPILER_LIBRARY_PATH
public static final String COMPILER_INCLUDE_LIBRARIES
public static final String COMPILER_KEEP_GENERATED_ACTIONSCRIPT
public static final String COMPILER_KEEP_AS3_METADATA
public static final String COMPILER_KEEP_ALL_TYPE_SELECTORS
public static final String COMPILER_HEADLESS_SERVER
public static final String COMPILER_FONTS_MAX_GLYPHS_PER_FACE
public static final String COMPILER_FONTS_MAX_CACHED_FONTS
public static final String COMPILER_FONTS_MANAGERS
public static final String COMPILER_FONTS_LOCAL_FONT_PATHS
public static final String COMPILER_FONTS_LOCAL_FONTS_SNAPSHOT
public static final String COMPILER_FONTS_LANGUAGES_LANGUAGE_RANGE
public static final String COMPILER_FONTS_FLASH_TYPE
public static final String COMPILER_FONTS_ADVANCED_ANTI_ALIASING
public static final String COMPILER_EXTERNAL_LIBRARY_PATH
public static final String COMPILER_ES
public static final String COMPILER_DEFAULTS_CSS_URL
public static final String COMPILER_DEBUG
public static final String COMPILER_COMPRESS
public static final String COMPILER_CONTEXT_ROOT
public static final String COMPILER_AS3
public static final String COMPILER_ALLOW_SOURCE_PATH_OVERLAP
public static final String COMPILER_ACTIONSCRIPT_FILE_ENCODING
public static final String COMPILER_ACCESSIBLE
public static final String TARGET_PLAYER
public static final String RUNTIME_SHARED_LIBRARY_PATH
public static final String VERIFY_DIGESTS
public static final String COMPILER_COMPUTE_DIGEST
public static final String COMPILER_DEFINE
public static final String COMPILER_MXML_COMPATIBILITY
public static final String COMPILER_EXTENSIONS
public static final String REMOVE_UNUSED_RSLS
public static final String RUNTIME_SHARED_LIBRARY_SETTINGS_FORCE_RSLS
public static final String RUNTIME_SHARED_LIBRARY_SETTINGS_APPLICATION_DOMAIN
public String[] getCompilerOptions()
public String[] getLinkerOptions()
public void enableAccessibility(boolean b)
mxmlc/compc --compiler.accessible
.By default, this is disabled.
enableAccessibility
in interface Configuration
b
- boolean valuepublic void setActionScriptFileEncoding(String encoding)
mxmlc/compc --compiler.actionscript-file-encoding
.
By default, the encoding is UTF-8
.
setActionScriptFileEncoding
in interface Configuration
encoding
- charactere encoding, e.g. UTF-8
, Big5
public void allowSourcePathOverlap(boolean b)
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
allowSourcePathOverlap
in interface Configuration
b
- boolean valuepublic void useActionScript3(boolean b)
mxmlc/compc --compiler.as3
.By default, this is enabled.
useActionScript3
in interface Configuration
b
- boolean valuepublic void setContextRoot(String path)
{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.
setContextRoot
in interface Configuration
path
- An instance of String.public void enableDebugging(boolean b, String debugPassword)
mxmlc/compc --compiler.debug
and --debug-password
.
By default, debug is false
and the debug password is "".
enableDebugging
in interface Configuration
b
- boolean valuedebugPassword
- a password that is embedded in the application.public void setDefaultCSS(File url)
mxmlc/compc --compiler.defaults-css-url
.setDefaultCSS
in interface Configuration
url
- an instance of java.io.File
.public void useECMAScript(boolean b)
mxmlc/compc --compiler.es
.By default, this is disabled.
useECMAScript
in interface Configuration
b
- boolean valuepublic void setExternalLibraryPath(File[] paths)
mxmlc/compc --compiler.external-library-path
.setExternalLibraryPath
in interface Configuration
paths
- File.isDirectory()
should return true
or File
instances should represent SWC files.public void addExternalLibraryPath(File[] paths)
addExternalLibraryPath
in interface Configuration
paths
- File.isDirectory()
should return true
or File
instances should represent SWC files.setExternalLibraryPath(File[])
public void setFontLanguageRange(String language, String range)
mxmlc/compc --compiler.fonts.languages.language-range
.
For example,
setFontLanguageRange("englishRange", "U+0020-U+007E");
setFontLanguageRange
in interface Configuration
language
- language namerange
- a range of glyphspublic void setLocalFontSnapshot(File file)
flex2.tools.FontSnapshot
. This is equivalent to using mxmlc/compc --compiler.fonts.local-fonts-snapshot
.setLocalFontSnapshot
in interface Configuration
file
- filepublic void setLocalFontPaths(String[] paths)
mxmlc/compc --compiler.fonts.local-font-paths
.setLocalFontPaths
in interface Configuration
paths
- an array of file paths.public void addLocalFontPaths(String[] paths)
addLocalFontPaths
in interface Configuration
paths
- an array of local font file paths.setLocalFontPaths(String[])
public void setFontManagers(String[] classNames)
mxmlc/compc --compiler.fonts.managers
.setFontManagers
in interface Configuration
classNames
- an array of Java class names.public void addFontManagers(String[] classNames)
addFontManagers
in interface Configuration
classNames
- an array of Java class names.setFontManagers(String[])
public void setMaximumCachedFonts(int size)
mxmlc/compc --compiler.fonts.max-cached-fonts
.
By default, it's 20.setMaximumCachedFonts
in interface Configuration
size
- an integerpublic void setMaximumGlyphsPerFace(int size)
mxmlc/compc --compiler.fonts.max-glyphs-per-face
.
By default, it's 1000.setMaximumGlyphsPerFace
in interface Configuration
size
- an integerpublic void useHeadlessServer(boolean b)
mxmlc/compc --compiler.headless-server
.useHeadlessServer
in interface Configuration
b
- boolean valuepublic void setActionScriptMetadata(String[] md)
mxmlc --compiler.keep-as3-metadata
.
The default value is {Bindable, Managed, ChangeEvent, NonCommittingChangeEvent, Transient}
.
setActionScriptMetadata
in interface Configuration
md
- an array of AS3 metadata namespublic void addActionScriptMetadata(String[] md)
addActionScriptMetadata
in interface Configuration
md
- an array of AS3 metadata namesConfiguration.setActionScriptMetadata(String[])
public void keepAllTypeSelectors(boolean b)
mxmlc/compc --compiler.keep-all-type-selectors
.
By default, it is set to false
.keepAllTypeSelectors
in interface Configuration
b
- boolean valuepublic void keepCompilerGeneratedActionScript(boolean b)
mxmlc/compc --compiler.keep-generated-actionscript
.
By default, it is set to false
.keepCompilerGeneratedActionScript
in interface Configuration
b
- boolean valuepublic void keepLinkReport(boolean b)
Report.writeLinkReport()
to retrieve the linker report.keepLinkReport
in interface Configuration
b
- boolean valuepublic boolean keepLinkReport()
public void keepSizeReport(boolean b)
Report.writeSizeReport()
to retrieve the size report.keepSizeReport
in interface Configuration
b
- boolean valuepublic boolean keepSizeReport()
public void keepConfigurationReport(boolean b)
Report.writeConfigurationReport()
to retrieve the configuration report.keepConfigurationReport
in interface Configuration
b
- boolean valuepublic boolean keepConfigurationReport()
public void includeLibraries(File[] libraries)
mxmlc/compc --compiler.include-libraries
.includeLibraries
in interface Configuration
libraries
- an array of java.io.File
(File.isDirectory()
should return true
or instances must represent SWC files).setIncludes(String[])
,
setExterns(File[])
,
setExterns(String[])
,
setExternalLibraryPath(File[])
public void setIncludeResourceBundles(String[] bundles)
mxmlc/compc --include-resource-bundle
.bundles
- an array of java.lang.String
public void addIncludeResourceBundles(String[] bundles)
bundles
- an array of java.lang.String
setIncludeResourceBundles(String[])
public void setLibraryPath(File[] paths)
mxmlc/compc --compiler.library-path
.setLibraryPath
in interface Configuration
paths
- an array of File
. File.isDirectory()
should return true
or instances must represent SWC files.public void addLibraryPath(File[] paths)
addLibraryPath
in interface Configuration
paths
- an array of File
. File.isDirectory()
should return true
or instances must represent SWC files.setLibraryPath(File[])
public void setLocale(String[] locales)
{locale}
tokens that appear in some configuration values.
This is equivalent to using mxmlc/compc --compiler.locale
.
For example,
addSourcePath(new File[] { "locale/{locale}" }); addLocale(new String[] { "en_US" });The
locale/en_US
directory will be added to the source path.setLocale
in interface Configuration
locale
- Stringpublic void setLocale(Locale locale)
{locale}
tokens that appear in some configuration values.
This is equivalent to using mxmlc/compc --compiler.locale
to set a single locale.
For example,
addSourcePath(new File[] { "locale/{locale}" }); setLocale(Locale.US);The
locale/en_US
directory will be added to the source path.setLocale
in interface Configuration
locale
- java.util.Localepublic void setComponentManifest(String namespaceURI, File manifest)
mxmlc/compc --compiler.namespaces.namespace
.setComponentManifest
in interface Configuration
namespaceURI
- a namespace URImanifest
- a component manifest file (XML)public void setComponentManifests(String namespaceURI, List<File> manifests)
mxmlc/compc --compiler.namespaces.namespace
.namespaceURI
- a namespace URImanifests
- A List of component manifest files (XML)public void optimize(boolean b)
mxmlc/compc --compiler.optimize
.
Application sizes are usually smaller with this option enabled.
By default, it is set to true
.optimize
in interface Configuration
b
- boolean valuepublic void compress(boolean b)
compiler.compress
option of the
mxmlc or compc compilers. Application sizes are usually smaller with this option enabled.compress
in interface Configuration
b
- Boolean value.public void setServiceConfiguration(File file)
mxmlc/compc --compiler.services
setServiceConfiguration
in interface Configuration
file
- filepublic void showActionScriptWarnings(boolean b)
mxmlc/compc --compiler.show-actionscript-warnings
.
By default, it is set to true
.showActionScriptWarnings
in interface Configuration
b
- boolean valuecheckActionScriptWarning(int, boolean)
public void showBindingWarnings(boolean b)
mxmlc/compc --compiler.show-binding-warnings
.
By default, it is set to true
.showBindingWarnings
in interface Configuration
b
- boolean valuepublic void showDeprecationWarnings(boolean b)
mxmlc/compc --compiler.show-deprecation-warnings
.
By default, it is set to true
.showDeprecationWarnings
in interface Configuration
b
- boolean valuepublic void showShadowedDeviceFontWarnings(boolean b)
mxmlc/compc --compiler.show-shadowed-device-font-warnings
.
By default, it is set to true
.showShadowedDeviceFontWarnings
in interface Configuration
b
- boolean valuepublic void showUnusedTypeSelectorWarnings(boolean b)
mxmlc/compc --compiler.show-unused-type-selector-warnings
.
By default, it is set to true
.showUnusedTypeSelectorWarnings
in interface Configuration
b
- boolean valuepublic void setSourcePath(File[] paths)
mxmlc/compc --compiler.source-path
.setSourcePath
in interface Configuration
paths
- an array of java.io.File
(File.isDirectory()
must return true
).public void addSourcePath(File[] paths)
addSourcePath
in interface Configuration
paths
- an array of java.io.File
(File.isDirectory()
must return true
).setSourcePath(File[])
public void enableStrictChecking(boolean b)
mxmlc/compc --compiler.strict
.
By default, it is set to true
.enableStrictChecking
in interface Configuration
b
- boolean valuepublic void setTheme(File[] files)
mxmlc/compc --compiler.theme
.setTheme
in interface Configuration
files
- an array of java.io.File
public void addTheme(File[] files)
addTheme
in interface Configuration
files
- an array of java.io.File
setTheme(File[])
public void useResourceBundleMetaData(boolean b)
mxmlc/compc --compiler.use-resource-bundle-metadata
.
By default, it is set to true
.useResourceBundleMetaData
in interface Configuration
b
- boolean valuepublic void enableVerboseStacktraces(boolean b)
mxmlc/compc --compiler.verbose-stacktraces
.
By default, it is set to false
.enableVerboseStacktraces
in interface Configuration
b
- boolean valuepublic void enableFlashType(boolean b)
mxmlc/compc --compiler.fonts.flash-type
.
By default, it is set to true
.enableFlashType
in interface Configuration
b
- boolean valuepublic void enableAdvancedAntiAliasing(boolean b)
mxmlc/compc --compiler.fonts.advanced-anti-aliasing
.
By default, it is set to false
.enableAdvancedAntiAliasing
in interface Configuration
b
- boolean valuepublic void removeUnusedRuntimeSharedLibraryPaths(boolean b)
remove-unused-rsls
option of the mxmlc compiler.
The default value is false
.
removeUnusedRuntimeSharedLibraryPaths
in interface Configuration
b
- Boolean value that enables or disables the removal.public void checkActionScriptWarning(int warningCode, boolean b)
--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
checkActionScriptWarning
in interface Configuration
warningCode
- warning codeb
- boolean valueConfiguration.WARN_ARRAY_TOSTRING_CHANGES
,
Configuration.WARN_ASSIGNMENT_WITHIN_CONDITIONAL
,
Configuration.WARN_BAD_ARRAY_CAST
,
Configuration.WARN_BAD_BOOLEAN_ASSIGNMENT
,
Configuration.WARN_BAD_DATE_CAST
,
Configuration.WARN_BAD_ES3_TYPE_METHOD
,
Configuration.WARN_BAD_ES3_TYPE_PROP
,
Configuration.WARN_BAD_NAN_COMPARISON
,
Configuration.WARN_BAD_NULL_ASSIGNMENT
,
Configuration.WARN_BAD_NULL_COMPARISON
,
Configuration.WARN_BAD_UNDEFINED_COMPARISON
,
Configuration.WARN_BOOLEAN_CONSTRUCTOR_WITH_NO_ARGS
,
Configuration.WARN_CHANGES_IN_RESOLVE
,
Configuration.WARN_CLASS_IS_SEALED
,
Configuration.WARN_CONST_NOT_INITIALIZED
,
Configuration.WARN_CONSTRUCTOR_RETURNS_VALUE
,
Configuration.WARN_DEPRECATED_EVENT_HANDLER_ERROR
,
Configuration.WARN_DEPRECATED_FUNCTION_ERROR
,
Configuration.WARN_DEPRECATED_PROPERTY_ERROR
,
Configuration.WARN_DUPLICATE_ARGUMENT_NAMES
,
Configuration.WARN_DUPLICATE_VARIABLE_DEF
,
Configuration.WARN_FOR_VAR_IN_CHANGES
,
Configuration.WARN_IMPORT_HIDES_CLASS
,
Configuration.WARN_INSTANCEOF_CHANGES
,
Configuration.WARN_INTERNAL_ERROR
,
Configuration.WARN_LEVEL_NOT_SUPPORTED
,
Configuration.WARN_MISSING_NAMESPACE_DECL
,
Configuration.WARN_NEGATIVE_UINT_LITERAL
,
Configuration.WARN_NO_CONSTRUCTOR
,
Configuration.WARN_NO_EXPLICIT_SUPER_CALL_IN_CONSTRUCTOR
,
Configuration.WARN_NO_TYPE_DECL
,
Configuration.WARN_NUMBER_FROM_STRING_CHANGES
,
Configuration.WARN_SCOPING_CHANGE_IN_THIS
,
Configuration.WARN_SLOW_TEXTFIELD_ADDITION
,
Configuration.WARN_UNLIKELY_FUNCTION_VALUE
,
Configuration.WARN_XML_CLASS_HAS_CHANGED
public void setDefaultBackgroundColor(int color)
mxmlc/compc --default-background-color
.
The default value is 0x869CA7
.setDefaultBackgroundColor
in interface Configuration
color
- RGB valuepublic void setDefaultFrameRate(int rate)
mxmlc/compc --default-frame-rate
.
The default value is 24
.setDefaultFrameRate
in interface Configuration
rate
- frames per secondpublic void setDefaultScriptLimits(int maxRecursionDepth, int maxExecutionTime)
mxmlc/compc --default-script-limits
.
The default maximum recursion depth is 1000
.
The default maximum execution time is 60
.setDefaultScriptLimits
in interface Configuration
maxRecursionDepth
- recursion depthmaxExecutionTime
- execution time in seconds.public void setDefaultSize(int width, int height)
mxmlc/compc --default-size
.
The default width is 500
.
The default height is 375
.setDefaultSize
in interface Configuration
width
- width in pixelsheight
- height in pixelspublic void setExterns(String[] definitions)
mxmlc/compc --externs
.setExterns
in interface Configuration
definitions
- An array of definitions (e.g. classes, functions, variables, namespaces, etc.)public void addExterns(String[] definitions)
addExterns
in interface Configuration
definitions
- an array of definitions (e.g. classes, functions, variables, namespaces, etc.)setExterns(File[])
,
setExterns(String[])
public void setConfiguration(File file)
flex-config.xml
.
This is equivalent to using mxmlc/compc --load-config
.setConfiguration
in interface Configuration
file
- an instance of java.io.File
public void addConfiguration(File file)
addConfiguration
in interface Configuration
file
- a configuration filesetConfiguration(File)
public void setConfiguration(String[] args)
mxmlc/compc
command-line arguments.setConfiguration
in interface Configuration
args
- mxmlc/compc
command-line argumentspublic void setExterns(File[] files)
mxmlc/compc --load-externs
.
This option is similar to setExterns(String[])
. The following is an example of
the file format:
<script> <!-- use 'dep', 'pre' or 'dep' to specify a definition to be omitted from linking. --> <def id="mx.skins:ProgrammaticSkin"/> <pre id="mx.core:IFlexDisplayObject"/> <dep id="String"/> </script>
setExterns
in interface Configuration
files
- an array of java.io.File
Configuration.setExterns(String[])
public void addExterns(File[] files)
addExterns
in interface Configuration
files
- an array of java.io.File
.setExterns(File[])
,
setExterns(String[])
public void setFrameLabel(String label, String[] classNames)
mxmlc/compc --frames.frame
.setFrameLabel
in interface Configuration
label
- A stringclassNames
- an array of class namespublic void setIncludes(String[] definitions)
mxmlc/compc --includes
.setIncludes
in interface Configuration
definitions
- an array of definitions (e.g. classes, functions, variables, namespaces, etc).public void addIncludes(String[] definitions)
addIncludes
in interface Configuration
definitions
- an array of definitions (e.g. classes, functions, variables, namespaces, etc.)setIncludes(String[])
public void setLicense(String productName, String serialNumber)
mxmlc/compc --licenses.license
setLicense
in interface Configuration
productName
- a stringserialNumber
- a serial numberpublic void setSWFMetaData(int field, Object value)
mxmlc/compc
command-line options:
--metadata.contributor --metadata.creator --metadata.date --metadata.description --metadata.language --metadata.localized-description --metadata.localized-title --metadata.publisher --metadata.titleThe valid fields and types of value are specified below:
CONTRIBUTOR java.lang.String CREATOR java.lang.String DATE java.util.Date DESCRIPTION java.util.MapFor example,TITLE java.util.Map LANGUAGE java.lang.String PUBLISHER java.lang.String
Map titles = new HashMap(); titles.put("EN", "Adobe Flex 2 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);
setSWFMetaData
in interface Configuration
field
- CONTRIBUTOR, CREATOR, DATE, DESCRIPTION, TITLE, LANGUAGE, PUBLISHERvalue
- String, Date or MapConfiguration.CONTRIBUTOR
,
Configuration.CREATOR
,
Configuration.DATE
,
Configuration.DESCRIPTION
,
Configuration.TITLE
,
Configuration.LANGUAGE
,
Configuration.PUBLISHER
public void setProjector(File file)
setProjector(new File("C:/.../SAFlashPlayer.exe")) {}This is equivalent to using
mxmlc/compc --projector
.file
- the Flash Player executable.public void setSWFMetaData(String xml)
mxmlc/compc --raw-metadata
.
This option overrides everything set by the setSWFMetaData
method.setSWFMetaData
in interface Configuration
xml
- a well-formed XML fragmentsetSWFMetaData(int, Object)
public void setRuntimeSharedLibraries(String[] libraries)
mxmlc/compc --runtime-shared-libraries
.setRuntimeSharedLibraries
in interface Configuration
libraries
- an array of java.lang.String
.public void addRuntimeSharedLibraries(String[] libraries)
addRuntimeSharedLibraries
in interface Configuration
libraries
- an array of java.lang.String
setRuntimeSharedLibraries(String[])
public void useNetwork(boolean b)
mxmlc/compc --use-network
.
By default, it is set to true
.useNetwork
in interface Configuration
b
- boolean valuepublic void setToken(String name, String value)
mxmlc +flexlib=path1 +foo=bar --var=${foo}
var=bar
after the substitution of ${foo}
.setToken
in interface Configuration
name
- value
- public boolean hasChanged()
public void reset()
public void setTargetPlayer(int major, int minor, int revision)
Configuration
setTargetPlayer
in interface Configuration
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.public void setCompatibilityVersion(int major, int minor, int revision)
Configuration
setCompatibilityVersion
in interface Configuration
major
- The major version. For this release, this value must be 2.minor
- The minor version. For this release, this value must be 0.revision
- For this release, this value must be 1.public void enableDigestComputation(boolean compute)
Configuration
compiler.computDigest
in the compc
compiler.
The default value is true
enableDigestComputation
in interface Configuration
compute
- set to true
to create a digest for the compiled library.public void addRuntimeSharedLibraryPath(String swc, String[] rslUrls, String[] policyFileUrls)
Configuration
runtime-shared-library-path
option when using the mxmlc compiler.addRuntimeSharedLibraryPath
in interface Configuration
swc
- path to the swc. The classes in the swc will be excluded from
the compiled application.rslUrls
- array of URLs. The first RSL URL in the list is the primary RSL. The
remaining RSL URLs will only be loaded if the primary RSL fails to load.policyFileUrls
- array of policy file URLs. Each entry in the rslUrls array must
have a corresponding entry in this array. A policy file may be needed in
order to allow the player to read an RSL from another domain. If
a policy file is not required, then set it to an empty string.Configuration.setRuntimeSharedLibraryPath(String, String[], String[])
public void setRuntimeSharedLibraryPath(String swc, String[] rslUrls, String[] policyFileUrls)
Configuration
addRuntimeSharedLibraryPath
method.
This is equivalent to the -runtime-shared-library-path
option of the mxmlc compiler.setRuntimeSharedLibraryPath
in interface Configuration
swc
- path to the swc. The classes in the swc will be excluded from
the compiled application.rslUrls
- array of URLs. The first RSL URL in the list is the primary RSL. The
remaining RSL URLs will only be loaded if the primary RSL fails to load.policyFileUrls
- array of policy file URLs. Each entry in the rslUrls array must
have a corresponding entry in this array. A policy file may be needed in
order to allow the player to read an RSL from another domain. If
a policy file is not required, then set it to an empty string.Configuration.addRuntimeSharedLibraryPath(String, String[], String[])
public void enableDigestVerification(boolean verify)
Configuration
verify-digests
option in the mxmlc compiler.
The default value is true
enableDigestVerification
in interface Configuration
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.public void addDefineDirective(String name, String value)
Configuration
-define
option.addDefineDirective
in interface Configuration
name
- The qualified name of the configuration constant, e.g. "CONFIG::debugging" or "APP::version"value
- The value of the constant, e.g. "true" or "!CONFIG::release" or "3.0"Configuration.setDefineDirective(String[], String[])
public void setDefineDirective(String[] names, String[] values)
Configuration
setDefineDirective
in interface Configuration
names
- A list of qualified names/configuration constants, e.g. "CONFIG::debugging" or "APP::version"values
- A list of values of the constants, e.g. "true" or "!CONFIG::release" or "3.0"Configuration.addDefineDirective(String, String)
public void addExtensionLibraries(File extension, List<String> parameter)
addExtensionLibraries
in interface Configuration
public void setExtensionLibraries(Map<File,List<String>> extensions)
setExtensionLibraries
in interface Configuration
public OEMConfiguration clone()
public void addForceRuntimeSharedLibraryPaths(File[] paths)
Configuration
runtime-shared-library-settings.force-rsls
option of the
mxmlc compiler.addForceRuntimeSharedLibraryPaths
in interface Configuration
paths
- An array of File
objects. Each File
instance should represent a SWC file. May not be null.#setForcedRuntimeSharedLibraryPaths(File[])
public void setForceRuntimeSharedLibraryPaths(File[] paths)
Configuration
removed-used-rsls
option.
This is equivalent to using the
runtime-shared-library-settings.force-rsls
option of the
mxmlc compiler.setForceRuntimeSharedLibraryPaths
in interface Configuration
paths
- An array of File
objects. Each File
instance should represent a SWC file. May not be null.public void addApplicationDomainForRuntimeSharedLibraryPath(File path, String applicationDomainTarget)
Configuration
runtime-shared-library-settings.application-domain
option of
the mxmlc compiler.addApplicationDomainForRuntimeSharedLibraryPath
in interface Configuration
path
- The File
instance represents a SWC file with RSL
linkage. The RSL associated with the SWC will have its
application domain modified as specified in the
applicationDomainTarget
parameter. May not be
null.applicationDomainTarget
- The application domain an RSL will be
loaded into. May not be null.Configuration.setApplicationDomainForRuntimeSharedLibraryPath(File, String)
public void setApplicationDomainForRuntimeSharedLibraryPath(File path, String applicationDomainTarget)
Configuration
runtime-shared-library-settings.application-domain
option of
the mxmlc compiler.setApplicationDomainForRuntimeSharedLibraryPath
in interface Configuration
path
- The File
instance represents a SWC file with RSL
linkage. The RSL associated with the SWC will have its
application domain modified as specified in the
applicationDomainTarget
parameter. Passing null
resets the application domain settings.applicationDomainTarget
- The application domain an RSL will be loaded
into. May only be null when the path
parameter is null.Copyright © 2016 The Apache Software Foundation. All rights reserved.