Configuration Manager
Go Up to View Menu
View > Configuration Manager
Displays the current projects along with the active configuration and the active target platform for each project; allows you to manage build configurations and option sets for project groups.
Managing Large Project Groups: In a single operation on the Configuration Manager, you can set the same active build configuration (such as Debug or Release) for multiple selected projects in a project group. For a single project, you can perform typical configuration management operations using either the Projects Window or the Configuration Manager.
Use the fields on the Configuration Manager to:
- Set the active configuration for one or more projects in a project group
- Set the active platform for one or more projects in a project group
Use the toolbar buttons to:
- Add or delete a build configuration
- Create or edit an option set
- Add or remove a reference to an option set
Use the context menu commands to:
- Create a new build configuration for one or more projects, optionally based on a selected configuration
- Add a reference-to-an-option set to selected projects and selected build configuration(s)
- Delete selected build configurations
- Remove referenced option sets from one or more projects
Fields on the Configuration Manager
| Field | Description |
|---|---|
|
Project |
Lists the projects that are part of the current project group. To perform an operation on one or several projects, select the project or projects and then click the operation (Active configuration or Active platform). |
|
Active configurations |
Enables you to designate the active configuration for either a single project or for multiple projects. For example, if you choose several projects in this list, you can then set the active configuration for all the selected projects simultaneously. You can choose from the default configurations (Debug and Release) or any available custom build configuration that you have created. |
|
Active platforms |
Enables you to designate the same active platform (32-bit Windows, 64-bit Windows, or macOS) for multiple selected projects (or one project). Select the projects in the Project column. For a single current project, the preferred way to set the active target platform is by using the Platforms node in the Projects Window. |
|
Dependencies |
Lists Project Dependencies that apply to the specific project. |
|
Option Sets |
Lists the option sets associated with the specific project. The build configuration that is associated with the option set is shown inside parentheses, such as (Base) or (Debug). |
Toolbar Buttons
| Toolbar Button | Description |
|---|---|
|
|
Add a new build configuration. Opens the New Build Configuration input box, where you can supply a name for the configuration. |
|
|
Delete a build configuration. Opens the Delete Build Configuration dialog box. |
|
|
Add a reference to an option set. Opens the Add Option Set dialog box. Adds an option set to the selected configuration for all selected projects. After you add the option set, an .optset node is added to the Project Manager, under the Build Configurations node. |
|
|
Remove reference to an option set. Opens the Remove Option Set dialog box. Does not delete the |
|
|
Create a new option set. Opens the New Option Set Filename input box, where you can supply a name for the option set. To adjust settings for the option set, click the |
|
|
Edit an option set. Click the down-arrow to select from current option sets. Opens the "Editing option set" dialog box, which is an abbreviated form of the Project Options dialog box that displays only the compiler options. |
|
|
Select All (Ctrl+A). Selects all the projects in the list. |
Context Menu Commands
After you select a project in the Configuration Manager, you can select from the following context menu commands:
|
New Configuration... |
Creates a new build configuration based on the selected active configuration(s); opens the New Build Configuration dialog box. |
|
New Option Set |
Applies an option set to the selected configurations for the selected projects; opens the Add Option Set dialog box. |
|
Delete Configuration... |
Deletes the selected active configuration(s); opens the Delete Build Configuration dialog box. |
|
Remove Option Set... |
Removes a reference to an option set; opens the Remove Option Set dialog box. |