Invokes the
build
method of the specified builder for this project. Does nothing if this project is closed. If this project has multiple builders on its build spec matching the given name, only the first matching builder will be run.
The builder name is declared in the extension that plugs in to the standard org.eclipse.core.resources.builders
extension point. The arguments are builder specific.
This method may change resources; these changes will be reported in a subsequent resource change event.
This method is long-running; progress and cancellation are provided by the given progress monitor.
@param kind the kind of build being requested. Valid values are:
- {@link IncrementalProjectBuilder#FULL_BUILD}- indicates a full build.
- {@link IncrementalProjectBuilder#INCREMENTAL_BUILD}- indicates a incremental build.
- {@link IncrementalProjectBuilder#CLEAN_BUILD}- indicates a clean request. Clean does not actually build anything, but rather discards all problems and build states.
@param builderName the name of the builder
@param args a table of builder-specific arguments keyed by argument name(key type:
String
, value type:
String
);
null
is equivalent to an empty map
@param monitor a progress monitor, or
null
if progressreporting is not desired
@exception CoreException if the build fails.The status contained in the exception may be a generic {@link IResourceStatus#BUILD_FAILED}code, but it could also be any other status code; it might also be a {@link MultiStatus}.
@exception OperationCanceledException if the operation is canceled. Cancelation can occur even if no progress monitor is provided.
@see IProjectDescription
@see IncrementalProjectBuilder#build(int,Map,IProgressMonitor)
@see IncrementalProjectBuilder#FULL_BUILD
@see IncrementalProjectBuilder#INCREMENTAL_BUILD
@see IncrementalProjectBuilder#CLEAN_BUILD
@see IResourceRuleFactory#buildRule()