org.apache.royale.compiler.internal.config.ICompilerSettings Maven / Gradle / Ivy
Show all versions of compiler-common Show documentation
/*
*
* Licensed to the Apache Software Foundation (ASF) under one or more
* contributor license agreements. See the NOTICE file distributed with
* this work for additional information regarding copyright ownership.
* The ASF licenses this file to You under the Apache License, Version 2.0
* (the "License"); you may not use this file except in compliance with
* the License. You may obtain a copy of the License at
*
* http://www.apache.org/licenses/LICENSE-2.0
*
* Unless required by applicable law or agreed to in writing, software
* distributed under the License is distributed on an "AS IS" BASIS,
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
* See the License for the specific language governing permissions and
* limitations under the License.
*
*/
package org.apache.royale.compiler.internal.config;
import java.io.File;
import java.util.Collection;
import java.util.List;
import java.util.Map;
import org.apache.royale.compiler.config.RSLSettings;
import org.apache.royale.compiler.constants.IASWarningConstants;
import org.apache.royale.compiler.mxml.IMXMLNamespaceMapping;
/**
* An interface that allows any of the compiler settings to be modified.
*/
public interface ICompilerSettings extends IWriteOnlyProjectSettings
{
/**
* Defines a token that can be used for token substitutions. On the command line, you use token substitution in
* the following way:
*
*
* mxmlc +royalelib=path1 +foo=bar -var=${foo}
*
*
* Where var=bar occurs after the substitution of ${foo}.
*
* @param name The name of the token.
* @param value The value of the token.
*/
void setToken(String name, String value);
/**
* 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.
*
* @param path An instance of String.
*/
void setContextRoot(String path);
/**
* 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.
*
* @param paths A list of paths. The File.isDirectory() method should return
* true; File instances should represent SWC files.
*/
void setExternalLibraryPath(Collection paths);
/**
* Adds to the existing list of SWC files.
*
* @see #setExternalLibraryPath
*
* @param paths A list of paths. The File.isDirectory() method should return
* true; File instances should represent SWC files.
*/
void addExternalLibraryPath(Collection paths);
/**
* Adds to the existing list of namespace mappings.
*
* @param namespaceMappings
*/
void addNamespaceMappings(Collection namespaceMappings);
/**
* 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.
*
* @param paths An array of File objects. The File.isDirectory() method should return
* true; instances must represent SWC files.
*/
void setLibraryPath(Collection paths);
/**
* Adds a list of path elements to the existing source path list.
*
* @param paths A collection of java.io.File objects. The File.isDirectory() method must return true.
* @see #setSourcePath
*/
void addSourcePath(Collection paths);
/**
* Enables accessibility in the application.
* This is equivalent to using the accessible option of the mxmlc or compc compilers.
*
*
* The default value is false.
*
* @param b Boolean value that enables or disables accessibility.
*/
void enableAccessibility(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.
*
* @param b Boolean value.
*/
void enableStrictChecking(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.
*
* @see #checkActionScriptWarning(int, boolean)
*
* @param b Boolean value.
*/
void showActionScriptWarnings(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.
*
* @param b Boolean value.
*/
void showBindingWarnings(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.
*
* @param b Boolean value.
*/
void showDeprecationWarnings(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.
*
* @param b Boolean value.
*/
void showUnusedTypeSelectorWarnings(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.
*
* @param b Boolean value.
*/
void showMultipleDefinitionWarnings(boolean b);
/**
* 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.
*
* @param files An array of java.io.File objects.
*/
void setTheme(List files);
/**
* Adds a list of CSS or SWC files to the existing list of theme files.
*
* @param files An array of java.io.File objects.
* @see #setTheme
*/
void addTheme(List files);
/**
* 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.
*
* @param libraries An array of java.lang.String objects.
*/
void setRuntimeSharedLibraries(List libraries);
/**
* 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.
*
* @param rslSettings A list of {@link RSLSettings}.
*/
void setRuntimeSharedLibraryPath(List 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+=
*
*
* @param rslSettings A list of {@link RSLSettings}. May not be null.
* @throws NullPointerException if rslSettings is null.
*/
void addRuntimeSharedLibraryPath(List rslSettings);
/**
* 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
*
* @param 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
*/
void enableDigestVerification(boolean verify);
/**
* 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.
*
* @param b Boolean value that enables or disables the removal.
*
* @since 4.5
*/
void removeUnusedRuntimeSharedLibraryPaths(boolean b);
/**
* 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.
*
* @param definitions An array of definitions (for example, classes, functions, variables, or namespaces).
*/
void setExterns(Collection definitions);
/**
* 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.
*
* @param b Boolean value.
*/
void optimize(boolean b);
/**
* 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 "".
*
* @param b Boolean value that enables or disables debugging.
* @param debugPassword A password that is embedded in the application.
*/
void enableDebugging(boolean b, String debugPassword);
/**
* 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.
*
* @param b Boolean value.
*/
void compress(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
*
*
* @param b boolean value
*/
void allowSourcePathOverlap(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.
*
* @param b boolean value
*/
void useResourceBundleMetaData(boolean b);
//---------------------------------------------------------------------------
// Not used by Flash Builder
/**
* Array.toString() format has changed.
*/
int WARN_ARRAY_TO_STRING_CHANGES = IASWarningConstants.ARRAY_TO_STRING_CHANGES;
/**
* Assignment within conditional.
*/
int WARN_ASSIGNMENT_WITHIN_CONDITIONAL = IASWarningConstants.ASSIGNMENT_WITHIN_CONDITIONAL;
/**
* Possibly invalid Array cast operation.
*/
int WARN_BAD_ARRAY_CAST = IASWarningConstants.BAD_ARRAY_CAST;
/**
* Non-Boolean value used where a Boolean value was expected.
*/
int WARN_BAD_BOOLEAN_ASSIGNMENT = IASWarningConstants.BAD_BOOLEAN_ASSIGNMENT;
/**
* Invalid Date cast operation.
*/
int WARN_BAD_DATE_CAST = IASWarningConstants.BAD_DATE_CAST;
/**
* Unknown method.
*/
int WARN_BAD_ES3_TYPE_METHOD = IASWarningConstants.BAD_ES3_TYPE_METHOD;
/**
* Unknown property.
*/
int WARN_BAD_ES3_TYPE_PROP = IASWarningConstants.BAD_ES3_TYPE_PROP;
/**
* Illogical comparison with NaN. Any comparison operation involving NaN will evaluate to false because NaN != NaN.
*/
int WARN_BAD_NAN_COMPARISON = IASWarningConstants.BAD_NAN_COMPARISON;
/**
* Impossible assignment to null.
*/
int WARN_BAD_NULL_ASSIGNMENT = IASWarningConstants.BAD_NULL_ASSIGNMENT;
/**
* Illogical comparison with null.
*/
int WARN_BAD_NULL_COMPARISON = IASWarningConstants.BAD_NULL_COMPARISON;
/**
* Illogical comparison with undefined. Only untyped variables (or variables of type *) can be undefined.
*/
int WARN_BAD_UNDEFINED_COMPARISON = IASWarningConstants.BAD_UNDEFINED_COMPARISON;
/**
* Boolean() with no arguments returns false in ActionScript 3.0.
* Boolean() returned undefined in ActionScript 2.0.
*/
int WARN_BOOLEAN_CONSTRUCTOR_WITH_NO_ARGS = IASWarningConstants.BOOLEAN_CONSTRUCTOR_WITH_NO_ARGS;
/**
* __resolve is deprecated.
*/
int WARN_CHANGES_IN_RESOLVE = IASWarningConstants.CHANGES_IN_RESOLVE;
/**
* Class is sealed. It cannot have members added to it dynamically.
*/
int WARN_CLASS_IS_SEALED = IASWarningConstants.CLASS_IS_SEALED;
/**
* Constant not initialized.
*/
int WARN_CONST_NOT_INITIALIZED = IASWarningConstants.CONST_NOT_INITIALIZED;
/**
* Function used in new expression returns a value. Result will be what the function returns, rather than a new instance of that function.
*/
int WARN_CONSTRUCTOR_RETURNS_VALUE = IASWarningConstants.CONSTRUCTOR_RETURNS_VALUE;
/**
* EventHandler was not added as a listener.
*/
int WARN_DEPRECATED_EVENT_HANDLER_ERROR = IASWarningConstants.DEPRECATED_EVENT_HANDLER_ERROR;
/**
* Unsupported ActionScript 2.0 function.
*/
int WARN_DEPRECATED_FUNCTION_ERROR = IASWarningConstants.DEPRECATED_FUNCTION_ERROR;
/**
* Unsupported ActionScript 2.0 property.
*/
int WARN_DEPRECATED_PROPERTY_ERROR = IASWarningConstants.DEPRECATED_PROPERTY_ERROR;
/**
* More than one argument by the same name.
*/
int WARN_DUPLICATE_ARGUMENT_NAMES = IASWarningConstants.DUPLICATE_ARGUMENT_NAMES;
/**
* Duplicate variable definition
*/
int WARN_DUPLICATE_VARIABLE_DEF = IASWarningConstants.DUPLICATE_VARIABLE_DEF;
/**
* ActionScript 3.0 iterates over an object's properties within a "for x in target" statement in random order.
*/
int WARN_FOR_VAR_IN_CHANGES = IASWarningConstants.FOR_VAR_IN_CHANGES;
/**
* Importing a package by the same name as the current class will hide that class identifier in this scope.
*/
int WARN_IMPORT_HIDES_CLASS = IASWarningConstants.IMPORT_HIDES_CLASS;
/**
* Use of the instanceof operator.
*/
int WARN_INSTANCEOF_CHANGES = IASWarningConstants.INSTANCEOF_CHANGES;
/**
* Internal error in compiler.
*/
int WARN_INTERNAL_ERROR = IASWarningConstants.INTERNAL_ERROR;
/**
* _level is no longer supported. For more information, see the flash.display package.
*/
int WARN_LEVEL_NOT_SUPPORTED = IASWarningConstants.LEVEL_NOT_SUPPORTED;
/**
* Missing namespace declaration (e.g. variable is not defined to be public, private, etc.).
*/
int WARN_MISSING_NAMESPACE_DECL = IASWarningConstants.MISSING_NAMESPACE_DECL;
/**
* Negative value will become a large positive value when assigned to a uint data type.
*/
int WARN_NEGATIVE_UINT_LITERAL = IASWarningConstants.NEGATIVE_UINT_LITERAL;
/**
* Missing constructor.
*/
int WARN_NO_CONSTRUCTOR = IASWarningConstants.NO_CONSTRUCTOR;
/**
* The super() statement was not called within the constructor.
*/
int WARN_NO_EXPLICIT_SUPER_CALL_IN_CONSTRUCTOR = IASWarningConstants.NO_EXPLICIT_SUPER_CALL_IN_CONSTRUCTOR;
/**
* Missing type declaration.
*/
int WARN_NO_TYPE_DECL = IASWarningConstants.NO_TYPE_DECL;
/**
* 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.
*/
int WARN_NUMBER_FROM_STRING_CHANGES = IASWarningConstants.NUMBER_FROM_STRING_CHANGES;
/**
* 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.
*/
int WARN_SCOPING_CHANGE_IN_THIS = IASWarningConstants.SCOPING_CHANGE_IN_THIS;
/**
* Inefficient use of += on a TextField.
*/
int WARN_SLOW_TEXTFIELD_ADDITION = IASWarningConstants.SLOW_TEXTFIELD_ADDITION;
/**
* Possible missing parentheses.
*/
int WARN_UNLIKELY_FUNCTION_VALUE = IASWarningConstants.UNLIKELY_FUNCTION_VALUE;
/**
* Possible usage of the ActionScript 2.0 XML class.
*/
int WARN_XML_CLASS_HAS_CHANGED = IASWarningConstants.XML_CLASS_HAS_CHANGED;
/**
* Keyword this within closure.
*/
int WARN_THIS_WITHIN_CLOSURE = IASWarningConstants.THIS_WITHIN_CLOSURE;
/**
* 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
* --compiler.warn-this-within-closure
*
*
* @param warningCode Warning code.
* @param b Boolean value.
*
* @see #WARN_ARRAY_TO_STRING_CHANGES
* @see #WARN_ASSIGNMENT_WITHIN_CONDITIONAL
* @see #WARN_BAD_ARRAY_CAST
* @see #WARN_BAD_BOOLEAN_ASSIGNMENT
* @see #WARN_BAD_DATE_CAST
* @see #WARN_BAD_ES3_TYPE_METHOD
* @see #WARN_BAD_ES3_TYPE_PROP
* @see #WARN_BAD_NAN_COMPARISON
* @see #WARN_BAD_NULL_ASSIGNMENT
* @see #WARN_BAD_NULL_COMPARISON
* @see #WARN_BAD_UNDEFINED_COMPARISON
* @see #WARN_BOOLEAN_CONSTRUCTOR_WITH_NO_ARGS
* @see #WARN_CHANGES_IN_RESOLVE
* @see #WARN_CLASS_IS_SEALED
* @see #WARN_CONST_NOT_INITIALIZED
* @see #WARN_CONSTRUCTOR_RETURNS_VALUE
* @see #WARN_DEPRECATED_EVENT_HANDLER_ERROR
* @see #WARN_DEPRECATED_FUNCTION_ERROR
* @see #WARN_DEPRECATED_PROPERTY_ERROR
* @see #WARN_DUPLICATE_ARGUMENT_NAMES
* @see #WARN_DUPLICATE_VARIABLE_DEF
* @see #WARN_FOR_VAR_IN_CHANGES
* @see #WARN_IMPORT_HIDES_CLASS
* @see #WARN_INSTANCEOF_CHANGES
* @see #WARN_INTERNAL_ERROR
* @see #WARN_LEVEL_NOT_SUPPORTED
* @see #WARN_MISSING_NAMESPACE_DECL
* @see #WARN_NEGATIVE_UINT_LITERAL
* @see #WARN_NO_CONSTRUCTOR
* @see #WARN_NO_EXPLICIT_SUPER_CALL_IN_CONSTRUCTOR
* @see #WARN_NO_TYPE_DECL
* @see #WARN_NUMBER_FROM_STRING_CHANGES
* @see #WARN_SCOPING_CHANGE_IN_THIS
* @see #WARN_SLOW_TEXTFIELD_ADDITION
* @see #WARN_UNLIKELY_FUNCTION_VALUE
* @see #WARN_XML_CLASS_HAS_CHANGED
* @see #WARN_THIS_WITHIN_CLOSURE
*/
void checkActionScriptWarning(int warningCode, boolean b);
/**
* A contributor's name to store in the SWF metadata.
*/
int CONTRIBUTOR = 1;
/**
* A creator's name to store in the SWF metadata.
*/
int CREATOR = 2;
/**
* The creation date to store in the SWF metadata.
*/
int DATE = 4;
/**
* The default and localized RDF/XMP description to store in the SWF metadata.
*/
int DESCRIPTION = 8;
/**
* The default and localized RDF/XMP title to store in the SWF metadata.
*/
int TITLE = 16;
/**
* The language to store in the SWF metadata (i.e. EN, FR).
*/
int LANGUAGE = 32;
/**
* A publisher's name to store in the SWF metadata.
*/
int PUBLISHER = 64;
/**
* 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 Royale 1.0.0 Application");
*
* Map descriptions = new HashMap();
* descriptions.put("EN", "http://royale.apache.org");
*
* setSWFMetadata(Configuration.LANGUAGE, "EN");
* setSWFMetadata(Configuration.TITLE, titles);
* setSWFMetadata(Configuration.DESCRIPTION, descriptions);
*
*
* @param field One of: CONTRIBUTOR, CREATOR,
* DATE, DESCRIPTION, TITLE,
* LANGUAGE, or PUBLISHER.
* @param value A String, Date, or
* Map object.
*
* @see #CONTRIBUTOR
* @see #CREATOR
* @see #DATE
* @see #DESCRIPTION
* @see #TITLE
* @see #LANGUAGE
* @see #PUBLISHER
*/
void setSWFMetadata(int field, Object value);
/**
* 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.
*
* @see #setSWFMetadata
* @param xml a well-formed XML fragment
*/
void setSWFMetadata(String xml);
/**
* 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.
*
*/
void addLocales(Collection locales);
/**
* Set the output of the target.
*
* @param output File that specifies the where the target should be
* created.
*/
void setOutput(File output);
/**
* Includes a list of libraries (SWCs) to completely include in the application
* This is equivalent to using mxmlc/compc --compiler.include-libraries.
*
* @param libraries a collection of java.io.File (File.isDirectory() should return true or instances must represent SWC files).
*/
void setIncludeLibraries(Collection libraries);
/**
* Provides a list of resource bundle names that should be compiled into
* a resource module or library.
*
* @param bundles A collection of resource bundle names.
*/
void setIncludeResourceBundles(Collection bundles);
/**
* 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.
*
* @param major The major version. Must be greater than or equal to nine.
* @param minor The minor version. Must be greater than or equal to zero.
* @param revision The revsion must be greater than or equal to zero.
*
*/
void setTargetPlayer(int major, int minor, int revision);
//
// Library Settings
//
/**
* Adds a class, function, variable, or namespace to the target library.
*
* This is the equilvalent of the include-classes option of
* the compc compiler.
*
* @param includeClasses a collection of fully-qualified class names.
*/
void setIncludeClasses(Collection includeClasses);
/**
* 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.
*
* @param files The collection of files to be added.
*/
void setIncludeFiles(Map files);
/**
* Adds a collection of namespaces to include in this target library.
*
* This is equivalent to the include-namespaces option of the
* compc compiler.
*
* @param namespaces A collection of Strings where each String is a
* namespace URI.
*/
void setIncludeNamespaces(Collection namespaces);
/**
* 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.
*
* @param styleSheets a map of names to Files to include in the target
* library.
*/
void setIncludeStyleSheet(Map styleSheets);
/**
* Controls whether manifest entries with lookupOnly=true are included in
* the SWC catalog.
*
* @param include true only manifest entries with lookupOnly=true are included in
* the SWC catalog, false otherwise.
*/
void enableIncludeLookupOnly(boolean include);
}