blob: 82ce775a90e2147c59060884d7aa032d45966a0b (
plain) (
blame)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
|
/*******************************************************************************
* Copyright (c) 2003, 2005 IBM Corporation and others.
* All rights reserved. This program and the accompanying materials
* are made available under the terms of the Eclipse Public License v1.0
* which accompanies this distribution, and is available at
* http://www.eclipse.org/legal/epl-v10.html
*
* Contributors:
* IBM - Initial API and implementation
*******************************************************************************/
package org.eclipse.cdt.managedbuilder.core;
import org.eclipse.core.resources.IProject;
import org.eclipse.core.resources.IResource;
/**
* This class represents a project configuration in the old (CDT 2.0)
* managed build system model.
* <p>
* The configuration contains one or more children of type tool-reference.
*
* This class was deprecated in 2.1
*/
public interface IConfigurationV2 extends IBuildObject {
// Schema element names
public static final String CONFIGURATION_ELEMENT_NAME = "configuration"; //$NON-NLS-1$
public static final String TOOLREF_ELEMENT_NAME = "toolReference"; //$NON-NLS-1$
public static final String PARENT = "parent"; //$NON-NLS-1$
/**
* Projects have C or CC natures. Tools can specify a filter so they are not
* misapplied to a project. This method allows the caller to retrieve a list
* of tools from a project that are correct for a project's nature.
*
* @param project the project to filter for
* @return an array of <code>ITools</code> that have compatible filters
* for the specified project
*/
ITool[] getFilteredTools(IProject project);
/**
* Returns the resource that owns the project that owns the configuration.
* @return
*/
public IResource getOwner();
/**
* Answers the configuration that this configuration is based on.
*
* @return
*/
public IConfigurationV2 getParent();
/**
* Returns the target for this configuration.
*
* @return
*/
public ITarget getTarget();
/**
* Answers the <code>ITool</code> in the receiver with the same
* id as the argument, or <code>null</code>.
*
* @param id unique identifier to search for
* @return ITool
*/
public ITool getToolById(String id);
/**
* Returns the tools that are used in this configuration.
*
* @return ITool[]
*/
public ITool[] getTools();
/**
* Returns the tool references that are children of this configuration.
*
* @return
*/
public IToolReference[] getToolReferences();
/**
* Answers <code>true</code> the receiver has changes that need to be saved
* in the project file, else <code>false</code>.
*
* @return boolean
*/
public boolean isDirty();
/**
* Answers whether the receiver has been changed and requires the
* project to be rebuilt.
*
* @return <code>true</code> if the receiver contains a change
* that needs the project to be rebuilt
*/
public boolean needsRebuild();
/**
* Sets the element's "dirty" (have I been modified?) flag.
*
* @param isDirty
*/
public void setDirty(boolean isDirty);
/**
* Sets the name of the receiver to the value specified in the argument
*
* @param name
*/
public void setName(String name);
/**
* Sets the value of a boolean option for this configuration.
*
* @param option The option to change.
* @param value The value to apply to the option.
*
* @throws BuildException
*/
public void setOption(IOption option, boolean value)
throws BuildException;
/**
* Sets the value of a string option for this configuration.
*
* @param option The option that will be effected by change.
* @param value The value to apply to the option.
*
* @throws BuildException
*/
public void setOption(IOption option, String value)
throws BuildException;
/**
* Sets the value of a list option for this configuration.
*
* @param option The option to change.
* @param value The values to apply to the option.
*
* @throws BuildException
*/
public void setOption(IOption option, String[] value)
throws BuildException;
/**
* Sets the rebuild state in the receiver.
*
* @param rebuild <code>true</code> will force a rebuild the next time the project builds
* @see org.eclipse.cdt.managedbuilder.core.IManagedBuildInfo#setRebuildState(boolean)
*/
void setRebuildState(boolean rebuild);
/**
* Overrides the tool command for a tool defined in the receiver.
*
* @param tool The tool that will have its command modified
* @param command The command
*/
public void setToolCommand(ITool tool, String command);
/**
* Sets the configuration that was created from this V2.0 configuration.
*
* @param config
*/
public void setCreatedConfig(IConfiguration config);
/**
* Returns the configuration that was created from this V2.0 configuration.
*
* @return IConfiguration
*/
public IConfiguration getCreatedConfig();
}
|
