Document! X 2022
Configure Build Profile and Build Flags / Build Configurations
In This Topic
    Build Configurations
    In This Topic

    Build Configurations allow you to define a specific set of Build Profiles, Additional Locales, and Publishing Targets so that you can quickly Build and Publish a set of outputs as a single operation. Build Configurations can be saved directly from your selections when you start a Build, or can be managed in the Project Settings Editor (opened by clicking the Project Settings ribbon button).

    Build Configurations can be particularly useful if you are using build automation (building from the Command Line or Team Foundation Server) in order to identify (as a named configuration you can reference in the command line build) the set of outputs you wish to build.

    Build Configuration Fundamentals

    Creating a new Build Configuration

    1. Click the Project Settings button on the Project ribbon tab.
    2. Select the Build Configurations page.
    3. Click the New toolbar button.
    4. The new Build Configuration is created and selected for edit.
    5. On the right side of the Build Configuration Editor, choose the Build Profiles, Additional Locales, and Publishing Targets you want included in the new Build Configuration.
    6. The new Build Configuration is now available for selection when you start a Build.

     - or -

    1. Click the Build button on the Project ribbon tab.
    2. Under the Custom Build Configuration heading, choose the Build Profiles, Additional Locales, and Publishing Targets you want included in the Build Configuration.
    3. Select the Save Build Configuration option.
    4. Type an identifying name for the Build Configuration in the Configuration Name: field.
    5. Click Start Build.
    6. The Build begins and the new Build Configuration is saved for future use. 

    Editing a Build Configuration

    1. Click the Project Settings button on the Project ribbon tab.
    2. Select the Build Configurations page.
    3. Select the Build Configuration you want to edit.
    4. On the right side of the Build Configuration Editor you can modify the Build Configuration properties. 

    Deleting a Build Configuration

    1. Click the Project Settings button on the Project ribbon tab.
    2. Select the Build Configurations page.
    3. Select the Build Configuration you wish to delete.
    4. Click the  Delete toolbar button.

    Building a specific Build Configuration

    1. Click the  Build button on the Project ribbon tab.
    2. The available Build Configurations are listed under the Saved Build Configurations.
    3. Click the Start Build button next to the required Build Configuration to start a build for that Build Configuration.
    See Also
    Build Configuration Event Actions

     

     

    © 2023 Innovasys. All Rights Reserved.

    Send Feedback