|
Eclipse Platform Release 3.7 |
|||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |
public interface IBuildConfiguration
Build Configurations provide a mechanism for orthogonal configuration specific builds within a single project. The resources plugin maintains build deltas per interested builder, per configuration, and allow build configurations to reference each other.
All projects have at least one build configuration. By default this
has Id DEFAULT_CONFIG_ID
. One configuration in the project is defined
to be 'active'. The active configuration is built by default. If unset, the
active configuration defaults to the first configuration in the project.
Build configurations are created with:
IWorkspace.newBuildConfiguration(String, String)
, and
set on a project using IProjectDescription.setBuildConfigurations(IBuildConfiguration[])
.
Build configurations set on Projects must have unique non-null configuration Ids.
When a project is built, a specific configuration is built. This configuration is passed to the builders so they can adapt their behavior appropriately. Builders which don't care about configurations may ignore this, and work as before.
Build configuration can reference other builds configurations. These references are
set using IProjectDescription.setBuildConfigReferences(String, IBuildConfiguration[])
.
A referenced build configuration may have a null
configuration Id which is resolved to the
referenced project's current active build configuration at build time.
Workspace build will ensure that the projects are built in an appropriate order as defined by the reference graph.
IWorkspace.newBuildConfiguration(String, String)
,
IProjectDescription.setActiveBuildConfiguration(String)
,
IProjectDescription.setBuildConfigurations(IBuildConfiguration[])
,
IProjectDescription.setBuildConfigReferences(String, IBuildConfiguration[])
Field Summary | |
---|---|
static String |
DEFAULT_CONFIG_ID
The Id of the default build configuration |
Method Summary | |
---|---|
String |
getId()
Returns the Id of this build configuration. |
IProject |
getProject()
|
Field Detail |
---|
static final String DEFAULT_CONFIG_ID
Method Detail |
---|
IProject getProject()
String getId()
IBuildConfiguration
is set on a Project, this can never be null.
If this IBuildConfiguration is being used as a reference to a build configuration in another project, this may be null. Such build configuration references are resolved to the current active configuration at build time.
|
Eclipse Platform Release 3.7 |
|||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |
Guidelines for using Eclipse APIs.
Copyright (c) Eclipse contributors and others 2000, 2010. All rights reserved.