CMake 3.4 Release Notes¶
Changes made since CMake 3.3 include the following.
Visual Studio 14 2015generator learned to select a Windows 10 SDK based on the value of the
CMAKE_SYSTEM_VERSIONvariable and the SDKs available on the host.
CMake learned rudimentary support for the Apple Swift language. When using the
Xcodegenerator with Xcode 6.1 or higher, one may enable the
Swiftlanguage with the
enable_language()command or the
project()command (this is an error with other generators or when Xcode is too old). Then one may list
.swiftsource files in targets for compilation.
find_program()command learned a
NAMES_PER_DIRoption to consider all given
NAMESin each directory before moving on to the next directory.
get_filename_component()command learned a new
BASE_DIRsubcommand. This is used to specify a base directory when calculating an absolute path from a relative path.
if()command learned a new
TESToperator that evaluates to true if a given test name has been defined by the
add_test()command. See policy
DESTINATIONoption learned to support
DESTINATIONoption learned to support
string()command learned a new
The Makefile Generators and the
Ninjagenerator learned to add compiler launcher tools like distcc and ccache along with the compiler for
CXXlanguages. See the
<LANG>_COMPILER_LAUNCHERtarget property for details.
CMAKE_LINK_SEARCH_END_STATICvariables were introduced to initialize the
LINK_SEARCH_END_STATICtarget properties, respectively.
Visual Studio Generators learned to support additional target properties to customize projects for NVIDIA Nsight Tegra Visual Studio Edition:
RUNTIME_OUTPUT_DIRECTORYtarget properties learned to support
BINARY_DIRtarget properties were introduced to allow project code to query where a target is defined.
OUTPUT_NAMEtarget property and its variants learned to support
TARGET_MESSAGESglobal property was added to tell the Makefile Generators whether to generate commands to print output after each target is completed.
On Windows with MS-compatible tools, CMake learned to optionally generate a module definition (
.def) file for
SHAREDlibraries. See the
GIT_SUBMODULESoption now also limits the set of submodules that are initialized in addition to the prior behavior of limiting the set of submodules that are updated.
ExternalProjectmodule learned new
USES_TERMINALarguments for giving steps exclusive terminal access. This is useful with the
Ninjagenerator to monitor CMake superbuild progress and prevent CPU oversubscription.
BISON_TARGETmacro learned a new
DEFINES_FILEoption to specify a custom output header to be generated.
FindHDF5module learend a new
HDF5_PREFER_PARALLELoption allowing users to specify that a parallel HDF5 tool is preferred if both are available.
FindIcemodule now provides imported targets.
FindJavamodule learned to optionally find the
FindOpenSSLmodule now provides imported targets.
FindOpenSSLmodule learned a new
OPENSSL_USE_STATIC_LIBSoption to search only for static libraries.
FindPkgConfiglearned a new
pkg_get_variable()command which may be used to query for arbitrary variables from a package (such as for related tools or data and plugin install paths).
FindProtobufmodule gained a new
protobuf_generate_python()function to generate python sources from
FindTIFFmodule learned to search separately for debug and release variants.
FindwxWidgetsmodule learned to support version requests.
FindXercesCmodule learned to search separately for debug and release variants.
FindZLIBmodule learned to search separately for debug and release variants.
GNUInstallDirsmodule learned special default values for certain installation prefixes according to the GNU Coding Standards and the Filesystem Hierarchy Standard.
add_jarfunction learned to support response files (e.g.
@srcs.txt) for source specification.
install_jarfunction learned new
COMPONENToptions to specify the corresponding
UseJavamodule gained a new
create_javahfunction to create C headers from Java classes.
generator expressionhas been added.
CTest learned to optionally measure the CPU load during parallel testing and avoid starting tests that may cause the load to exceed a given threshold. See the
TestLoadsetting of the CTest Test Step, the
CTEST_TEST_LOADvariable, and the
TEST_LOADoption of the
--test-output-size-failedto customize the limit on test output size submitted when running as a Dashboard Client.
CPack DEB Generatorlearned to set package dependencies per component. See variables:
CPackmodule learned to package empty directories.
CPackmodule gained a new setting,
CPACK_VERBATIM_VARIABLES, which can be used to ensure the cpack program receives the settings' values exactly as they were set, even if they contain CMake-special characters. For compatibility, it's off by default.
Compile Featuresfunctionality is now aware of features supported by GNU C compilers on Windows.
CMake learned to honor
*.manifestsource files with MSVC tools. Manifest files named as sources of
.dlltargets will be merged with linker-generated manifests and embedded in the binary.
The Concurrent Fortran 77 compiler is now supported. Its
cmake(1)gained a new
--trace-expandcommand line option that is like
--tracebut expands variable references in the output.
Deprecated and Removed Features¶
CMakeExpandImportedTargetsmodule is now documented as deprecated. See module documentation for an explanation.
CMAKE_USE_RELATIVE_PATHSvariable no longer has any effect. Previously it was partially implemented and unreliable.
FindThreadsmodules learned to work in environments where only CXX is enabled.
CPack DEB Generatornow correctly excludes symlinks during package checksum calculation.
CPack DEB Generatorno longer uses fakeroot and system tar program for packaging.
CPackmodule no longer mangles settings with CMake-special characters when they're used as defaults for other settings. The macro
cpack_set_if_not_set, which was responsible for this, is now deprecated.
CMake no longer links executables with flags to export symbols unless the
ENABLE_EXPORTStarget property is set. See policy
SONAMEfield is no longer set for
MODULElibraries created with the
MODULElibraries are meant for explicit dynamic loading at runtime. They cannot be linked so
SONAMEis not useful.
CMAKE_<LANG>_COMPILE_OBJECTrule variable now substitutes compiler include flags in a separate
<INCLUDES>placeholder instead of the main