CMake 3.30 Release Notes¶
Changes made since CMake 3.29 include the following.
New Features¶
Presets¶
cmake-presets(7)
files now support schema version9
.include
fields now expand all macros except$env{}
and preset-specific macros, i.e., those derived from the fields inside a preset's definition.
File-Based API¶
The
cmake-file-api(7)
"cmakeFiles" version 1 object'sversion
field has been updated to 1.1. It gained aglobsDependent
field to reportfile(GLOB)
calls usingCONFIGURE_DEPENDS
.
Generators¶
Visual Studio Generators now add
UseDebugLibraries
indicators to.vcxproj
files to denote which configurations are debug configurations. See policyCMP0162
.
Languages¶
The
Compile Features
functionality now implements support for thecxx_std_26
andcuda_std_26
meta-features to indicate that the compiler mode must be at least C++26. These meta-features were first documented by CMake 3.25, but were not fully implemented.
Commands¶
The
add_library()
command, on platforms that do not support shared libraries, now rejects creation of shared libraries instead of automatically converting them to static libraries. See policyCMP0164
.The
enable_language()
command now fails with an error if it is called before the firstproject()
call. See policyCMP0165
.The
file(DOWNLOAD)
andfile(UPLOAD)
commands gained aTLS_VERSION <min>
option to specify the minimum TLS version for connections tohttps://
URLs.
Variables¶
The
CMAKE_<LANG>_STANDARD_LATEST
variable was added to describe the latest<LANG>
language standard CMake supports for the selected compiler.The
CMAKE_TLS_VERIFY
environment variable was added as a fallback to the existingCMAKE_TLS_VERIFY
variable. It specifies whether to verify the server certificate forhttps://
URLs by default.The
CMAKE_TLS_VERSION
variable andCMAKE_TLS_VERSION
environment variable were added to specify a default minimum TLS version for connections tohttps://
URLs by thefile(DOWNLOAD)
andfile(UPLOAD)
commands.The
CMAKE_VS_USE_DEBUG_LIBRARIES
variable and correspondingVS_USE_DEBUG_LIBRARIES
target property were added to explicitly controlUseDebugLibraries
indicators in.vcxproj
files.
Properties¶
The
GENERATED
source file property is now visible in all directories. See policyCMP0163
. PolicyCMP0118
's documentation has been revised to describe its actual effects.The
PROPAGATE_TOP_LEVEL_INCLUDES_TO_TRY_COMPILE
global property can be used to propagateCMAKE_PROJECT_TOP_LEVEL_INCLUDES
intotry_compile()
calls that use the whole-project signature. This is primarily intended as a way for dependency providers to be enabled in suchtry_compile()
calls.A
VS_FILTER_PROPS
target property was added to tell Visual Studio Generators to use a custom MSBuild filter.props
file.
Modules¶
The
ExternalProject
module'sExternalProject_Add()
command gained aTLS_VERSION <min>
option, and support for theCMAKE_TLS_VERSION
variable andCMAKE_TLS_VERSION
environment variable, to specify the minimum TLS version for connections tohttps://
URLs.The
FindBacktrace
module now provides an imported target.The
FindBLAS
andFindLAPACK
modules gained support forlibblastrampoline
.The
FindCUDAToolkit
module now provides a target forlibnvfatbin
andlibnvfatbin_static
, if found.The
FindCUDAToolkit
module now searches theCMAKE_CUDA_COMPILER
variable and theCUDACXX
environment variable even when theCUDA
language isn't enabled.The
FindOpenMP
module gained anOpenMP_RUNTIME_MSVC
option to control the OpenMP runtime used with MSVC.The
FindPython
andFindPython3
modules gained support for the free threaded Python version.The
FindPython
,FindPython2
, andFindPython3
modules, on Windows, now offer better support for the Python debug variant:new variables:
Python_EXECUTABLE_DEBUG
Python_INTERPRETER
Python_DEBUG_POSTFIX
new targets:
Python::InterpreterDebug
Python::InterpreterMultiConfig
The
python_add_library()
command now manages theDEBUG_POSTFIX
target property based on the value of thePython_DEBUG_POSTFIX
variable.
Generator Expressions¶
The
<LANG>_COMPILER_FRONTEND_VARIANT
family of generator expressions were added to access the value of the associatedCMAKE_<LANG>_COMPILER_FRONTEND_VARIANT
variables.Link features, as used with the
LINK_LIBRARY
generator expression, gained the ability to have attributes that describe their behavior by specifying theCMAKE_LINK_LIBRARY_<FEATURE>_ATTRIBUTES
orCMAKE_<LANG>_LINK_LIBRARY_<FEATURE>_ATTRIBUTES
variables.The
QUOTE
generator expression was added to evaluate to"
.The
TARGET_PROPERTY
generator expression learned to evaluate custom transitive properties defined by newTRANSITIVE_COMPILE_PROPERTIES
andTRANSITIVE_LINK_PROPERTIES
target properties.The
TARGET_PROPERTY
generator expression now evaluates target propertiesINTERFACE_LINK_OPTIONS
,INTERFACE_LINK_DIRECTORIES
, andINTERFACE_LINK_DEPENDS
correctly by following private dependencies of static libraries. See policyCMP0166
.
CTest¶
The
ctest_submit()
command andctest -T Submit
step gainedTLSVersion
andTLSVerify
options to control negotiation withhttps://
URLs. See theCTEST_TLS_VERSION
andCTEST_TLS_VERIFY
variables.
CPack¶
The
CPack Inno Setup Generator
is now available on non-Windows hosts.The
CPack NuGet Generator
gained theCPACK_NUGET_PACKAGE_README
,CPACK_NUGET_PACKAGE_REPOSITORY_URL
,CPACK_NUGET_PACKAGE_REPOSITORY_TYPE
,CPACK_NUGET_PACKAGE_REPOSITORY_BRANCH
, andCPACK_NUGET_PACKAGE_REPOSITORY_COMMIT
variables.The
CPack NuGet Generator
can now generate dependency groups for framework-specific dependencies. TheCPACK_NUGET_PACKAGE_TFMS
variable was added to specify a list of target framework monikers (TFMs) for which groups should be generated.The
CPack WIX Generator
gained support for WiX Toolset v4. See theCPACK_WIX_VERSION
variable.
Deprecated and Removed Features¶
The
FindBoost
module has been removed by policyCMP0167
. Port projects to upstream Boost'sBoostConfig.cmake
package configuration file, for whichfind_package(Boost)
now searches.Calling
FetchContent_Populate()
with just the name of a dependency is now deprecated. Projects should callFetchContent_MakeAvailable()
instead. See policyCMP0169
. CallingFetchContent_Populate()
with full population details rather than just a dependency name remains fully supported.The
Visual Studio 9 2008
generator has been removed.
Other Changes¶
The precompiled Windows
.msi
installers provided on cmake.org, when performing a fresh installation, now modify the system-widePATH
by default. When replacing an existing installation of 3.30 or later, thePATH
modification preference is preserved by default.The official
.zip
source archive provided on cmake.org now uses LF newlines, instead of CRLF newlines, for consistency with modern conventions.The durations printed after "Configuring done" and "Generating done" messages now reflect time spent in generator-specific steps, and in a code model evaluation step at the beginning of generation that was not previously captured. Printed durations may appear longer than in previous versions of CMake, but are more accurate.
FetchContent
now prefers to populate content directly rather than using a separate sub-build. This may significantly improve configure times on some systems (Windows especially, but also on macOS when using the Xcode generator).cmake --fresh
also forces the download, update, and patch steps of directly populated dependencies to be re-executed. PolicyCMP0168
provides backward compatibility for those projects that still rely on using a sub-build for content population.When
FETCHCONTENT_FULLY_DISCONNECTED
is set to true,FetchContent_MakeAvailable()
and the single-argument form ofFetchContent_Populate()
require that the dependency's source directory has already been populated. CMake 3.29 and earlier did not check this requirement, but it is now enforced, subject to policyCMP0170
.
Updates¶
Changes made since CMake 3.30.0 include the following.
3.30.1, 3.30.2¶
These versions made no changes to documented features or interfaces. Some implementation updates were made to support ecosystem changes and/or fix regressions.
3.30.3¶
The
FindPython
andFindPython3
modules now define, respectively, thePython_DEFINITIONS
andPython3_DEFINITIONS
variables on Windows to support development with the free threaded version of Python. TheINTERFACE_COMPILE_DEFINITIONS
target property is also defined for the various targets provided by these modules.