Configuration Manager

From RAD Studio
Jump to: navigation, search

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

New Build Configuration

Add a new build configuration. Opens the New Build Configuration input box, where you can supply a name for the configuration.

Delete Build Configuration

Delete a build configuration. Opens the Delete Build Configuration dialog box.

Add Reference to an Option Set

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

Remove reference to an option set. Opens the Remove Option Set dialog box. Does not delete the .optset file.

Create Option Set

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 EditOptSet.png Edit an option set button.

Edit Option Set

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)

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.

See Also