Create a Project Configuration

Last modified by Microchip on 2023/11/10 11:05

Open the Project Properties Window

Use one of the listed methods to Open the Project Properties window.


Manage Configurations

All projects contain at least one configuration called default. You can see this on the left side of the Project Properties window as the second node in the tree. All items collected as branches below this node are part of the default configuration.

Click on the Manage Configurations button at the bottom-left corner of the Project Properties window.

Manage Configurations

Back to Top


Duplicate Existing or Create New Configuration

The easiest way to create new configurations will usually be to click on the Duplicate button which duplicates the selected configuration, in this case default. If you know that your new configuration will be nothing like the current configuration, you can click New instead.

Duplicate Existing or Create New Configuration

Back to Top


Rename the New Configuration

With the new configuration selected, click on the Rename button.

Rename the New Configuration

Back to Top


Give it a Name

The name you provide here is what will be displayed in the IDE to identify this particular configuration in places like the Project Properties window and the drop-down box on the main tool bar.

No spaces are allowed in the name. If you put them in, the IDE will automatically remove them.

Click OK when done.

Give it a Name

Back to Top


Select and Rename the Default Configuration

Select the original, default configuration and click the Rename button.

Select and Rename the Default Configuration

Back to Top


Give it a Name

As in step 5, provide a name for this configuration.

Click OK when done.

Give it a Name

Back to Top


Close the Configuration Manager

When you are done adding or duplicating configurations, click OK.

Close the Configuration Manager

Back to Top


Done

You should now see two configurations in the tree on the left side of the Project Properties window. Their names should be the same as what you provided in steps 5 and 7 above. Each one of these may now be configured separately, effectively making them "projects within a project".

You can repeat this process as many times as you like to create any number of configurations within a single project. Obviously the developers have imposed some upper limit on the number of configurations - but so far no one has hit that limit, whatever it is.

Done

Back to Top