Document! X and HelpStudio 2019
Project Fundamentals / 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 particuarly 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 will be created and selected for edit;
    5. On the right hand 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 will now be available for selection when you start a Build.

     - or -

    1. Click the Build button on the Project Ribbon Tab;
    2. Under the Custom Configuration heading, choose the Build Profiles, Additional Locales and Publishing Targets you want included in the Build Configuration;
    3. Tick 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 will begin and the new Build Configuration will be 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 wish to edit;
    4. On the right hand 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 will be listed under the Saved Build Configurations heading;
    3. Click the Start Build button beside the desired Build Configuration to start a build for that Build Configuration.

     

    See Also