Build a Project For Release
Release Mode
A project built in Release mode is capable of running independently on the target hardware without any control or intervention by MPLAB X and any of its associated debug tools. When connected to a debug tool, MPLAB X has no control of a target device in release mode other than to hold it in reset or to program it.

There are several options available when building a project in release mode. It is not necessary to explicitly choose a "Release" mode when performing a release build.


Build Project (Make)
Builds (makes) the project in release mode. This will build only files that have changed since the last build.


Clean and Build Project (Build All / Rebuild)
Cleans (deletes) all files generated by the previous build and then builds all files in the project the project in release mode.


Run Project
Builds (makes) the project in release mode, programs the target, and releases the device from reset so that the program starts running. The debug tool has no control over the program's execution in this mode.


Program Target Project
Programs the target device in release mode and holds the target device in reset.


The build process in MPLAB X is a little different from other development environments. If you are working with a target board and wish to build and run your code on it, you do not need to do a Build or Clean and Build first. Instead, you simply need to do a Run Project.

The Run Project button performs the following tasks:

  1. Build (make) the project in release mode.
  2. If there are no build errors, your application is programmed into the target device using the debug/programming tool selected in the project options.
  3. The target device is released from reset and your code begins running unless you have selected Hold In Reset from the toolbar.
You DO NOT normally need to explicitly do a Build Main_Build_Project.png or Clean and Build Main_Rebuild_Project.png first. The Run Project and Program Target Project functions do a build (make) automatically.
© 2024 Microchip Technology, Inc.
Notice: ARM and Cortex are the registered trademarks of ARM Limited in the EU and other countries.
Information contained on this site regarding device applications and the like is provided only for your convenience and may be superseded by updates. It is your responsibility to ensure that your application meets with your specifications. MICROCHIP MAKES NO REPRESENTATIONS OR WARRANTIES OF ANY KIND WHETHER EXPRESS OR IMPLIED, WRITTEN OR ORAL, STATUTORY OR OTHERWISE, RELATED TO THE INFORMATION, INCLUDING BUT NOT LIMITED TO ITS CONDITION, QUALITY, PERFORMANCE, MERCHANTABILITY OR FITNESS FOR PURPOSE. Microchip disclaims all liability arising from this information and its use. Use of Microchip devices in life support and/or safety applications is entirely at the buyer's risk, and the buyer agrees to defend, indemnify and hold harmless Microchip from any and all damages, claims, suits, or expenses resulting from such use. No licenses are conveyed, implicitly or otherwise, under any Microchip intellectual property rights.