By default Blender builds will be similar to official releases. Many build options are available for debugging, faster builds, and to enable or disable various features.
There are a few build targets to choose the overall type of build.
- make - build with all features enabled, except CUDA and Optix
- make lite - build with the absolute minimum amount of features enabled, either for faster builds or to avoid installing many dependencies
- make release - complete build with all options enabled including CUDA and Optix, matching the releases on blender.org
- make headless - build without an interface (for renderfarm or server automation)
- make bpy - build as a python module which can be loaded from python directly
For a full list of targets, run make help.
Setup For Developers
On Windows in Visual Studio or Xcode on macOS, a single build folder can contain both release and debug builds, and you can switch between them in the IDE.
For other platforms, the easiest way to set up a debug build is to build the debug target. This will create a separate build in ../build_<platform>_debug.
The build type of an existing build can also be changed by setting CMAKE_BUILD_TYPE in the CMake configuration to either Debug or RelWithDebInfo.
The most common options can be enabled by using the developer target, which can be combined with other targets. For example:
Or to combine it with a debug build as you usually would:
make debug developer
For faster builds, the Ninja build system can be used. If ninja is installed and available in the path, it can be added to the make command when setting up the build folder. If there already exists a build folder with a different build system, the folder must be removed first. Example command to set up ninja build:
make debug developer ninja
On Linux and macOS, ccache helps make rebuilds faster, especially when switching between git revisions and branches. If ccache is installed, It can be used by setting CMAKE_C_COMPILER_LAUNCHER and CMAKE_CXX_COMPILER_LAUNCHER to ccache in the CMake configuration.
On Windows, sccache can be used to help make rebuilds faster, especially when switching between git revisions and branches. If sccache is installed and available in the path it can be used , however it will only function with the ninja generator.
make full developer ninja sccache
Editing CMake Options
By default, the CMakeCache.txt configuration file will be in ../build_<platform>. There are a multiple ways to edit it.
- Editing CMakeCache.txt in a text editor.
- Opening CMakeCache.txt with the CMake GUI, to easily change options and re-configure. For example on Linux:
- Using ccmake, for a command line text interface to easily change options and re-configure.
- cmake parameters can also be set on the command line, for example:
cmake ../blender \ -DCMAKE_INSTALL_PREFIX=/opt/blender \ -DWITH_INSTALL_PORTABLE=OFF \ -DWITH_BUILDINFO=OFF
- These commands are exactly those found in CMakeCache.txt so you can copy commands from there and use them in the command line without running ccmake.