CMake 3.4 Release Notes — CMake 3.8.1 Documentation

# CMake 3.4 Release Notes

Contents

- CMake 3.4 Release Notes
  - New Features
    - Generators
    - Commands
    - Variables
    - Properties
    - Modules
    - Generator Expressions
    - CTest
    - CPack
    - Other
  - Deprecated and Removed Features
  - Other Changes

Changes made since CMake 3.3 include the following.

## New Features

### Generators

- The `Visual Studio 14 2015` generator learned to select a Windows 10 SDK based on the value of the `CMAKE_SYSTEM_VERSION` variable and the SDKs available on the host.
- CMake learned rudimentary support for the Apple Swift language. When using the `Xcode` generator with Xcode 6.1 or higher, one may enable the `Swift` language 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 `.swift` source files in targets for compilation.

### Commands

- The `find_program()` command learned a `NAMES_PER_DIR` option to consider all given `NAMES` in each directory before moving on to the next directory.
- The `get_filename_component()` command learned a new `BASE_DIR` subcommand. This is used to specify a base directory when calculating an absolute path from a relative path.
- The `if()` command learned a new `TEST` operator that evaluates to true if a given test name has been defined by the `add_test()` command. See policy `CMP0064`.
- The `install(DIRECTORY)` command `DESTINATION` option learned to support `generator expressions`.
- The `install(FILES)` command `DESTINATION` option learned to support `generator expressions`.
- The `string()` command learned a new `APPEND` subcommand.

### Variables

- The Makefile Generators and the `Ninja` generator learned to add compiler launcher tools like distcc and ccache along with the compiler for `C` and `CXX` languages. See the `CMAKE_<LANG>_COMPILER_LAUNCHER` variable and `<LANG>_COMPILER_LAUNCHER` target property for details.
- New `CMAKE_LINK_SEARCH_START_STATIC` and `CMAKE_LINK_SEARCH_END_STATIC` variables were introduced to initialize the `LINK_SEARCH_START_STATIC` and `LINK_SEARCH_END_STATIC` target properties, respectively.

### Properties

- Visual Studio Generators learned to support additonal target properties to customize projects for NVIDIA Nsight Tegra Visual Studio Edition:
  - `ANDROID_ANT_ADDITIONAL_OPTIONS`
  - `ANDROID_ARCH`
  - `ANDROID_ASSETS_DIRECTORIES`
  - `ANDROID_JAR_DEPENDENCIES`
  - `ANDROID_JAR_DIRECTORIES`
  - `ANDROID_JAVA_SOURCE_DIR`
  - `ANDROID_NATIVE_LIB_DEPENDENCIES`
  - `ANDROID_NATIVE_LIB_DIRECTORIES`
  - `ANDROID_PROCESS_MAX`
  - `ANDROID_PROGUARD`
  - `ANDROID_PROGUARD_CONFIG_PATH`
  - `ANDROID_SECURE_PROPS_PATH`
  - `ANDROID_SKIP_ANT_STEP`
  - `ANDROID_STL_TYPE`
- The `ARCHIVE_OUTPUT_DIRECTORY`, `LIBRARY_OUTPUT_DIRECTORY`, and `RUNTIME_OUTPUT_DIRECTORY` target properties learned to support `generator expressions`.
- The `SOURCE_DIR` and `BINARY_DIR` target properties were introduced to allow project code to query where a target is defined.
- The `OUTPUT_NAME` target property and its variants learned to support `generator expressions`.
- A `TARGET_MESSAGES` global 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 `SHARED` libraries. See the `WINDOWS_EXPORT_ALL_SYMBOLS` target property.

### Modules

- The `ExternalProject` module `ExternalProject_Add()` function `GIT_SUBMODULES` option 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.
- The `ExternalProject` module learned new `USES_TERMINAL` arguments for giving steps exclusive terminal access. This is useful with the `Ninja` generator to monitor CMake superbuild progress and prevent CPU oversubscription.
- The `FindBISON` module `BISON_TARGET` macro learned a new `DEFINES_FILE` option to specify a custom output header to be generated.
- The `FindHDF5` module learend a new `HDF5_PREFER_PARALLEL` option allowing users to specify that a parallel HDF5 tool is preferred if both are available.
- The `FindIce` module now provides imported targets.
- The `FindJava` module learned to optionally find the `idlj` and `jarsigner` tools.
- The `FindOpenSSL` module now provides imported targets.
- The `FindOpenSSL` module learned a new `OPENSSL_USE_STATIC_LIBS` option to search only for static libraries.
- The `FindPkgConfig` learned 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).
- The `FindProtobuf` module gained a new `protobuf_generate_python()` function to generate python sources from `.proto` files.
- The `FindTIFF` module learned to search separately for debug and release variants.
- The `FindwxWidgets` module learned to support version requests.
- The `FindXercesC` module learned to search separately for debug and release variants.
- The `FindZLIB` module learned to search separately for debug and release variants.
- The `GNUInstallDirs` module learned special default values for certain installation prefixes according to the GNU Coding Standards and the Filesystem Hierarchy Standard.
- The `UseJava` module `add_jar` function learned to support response files (e.g. `@srcs.txt`) for source specification.
- The `UseJava` module `install_jar` function learned new `DESTINATION` and `COMPONENT` options to specify the corresponding `install()` command options.
- The `UseJava` module gained a new `create_javah` function to create C headers from Java classes.

### Generator Expressions

- A new `$<SHELL_PATH:...>` `generator expression` has been added.

### CTest

- 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 `ctest(1)` command `--test-load` option, the `TestLoad` setting of the CTest Test Step, the `CTEST_TEST_LOAD` variable, and the `TEST_LOAD` option of the `ctest_test()` command.
- `ctest(1)` learned options `--test-output-size-passed` and `--test-output-size-failed` to customize the limit on test output size submitted when running as a Dashboard Client.

### CPack

- The `CPackDeb` module learned to set package dependencies per component. See variables:
  - `CPACK_DEBIAN_<COMPONENT>_PACKAGE_BREAKS`
  - `CPACK_DEBIAN_<COMPONENT>_PACKAGE_CONFLICTS`
  - `CPACK_DEBIAN_<COMPONENT>_PACKAGE_ENHANCES`
  - `CPACK_DEBIAN_<COMPONENT>_PACKAGE_PREDEPENDS`
  - `CPACK_DEBIAN_<COMPONENT>_PACKAGE_PROVIDES`
  - `CPACK_DEBIAN_<COMPONENT>_PACKAGE_RECOMMENDS`
  - `CPACK_DEBIAN_<COMPONENT>_PACKAGE_REPLACES`
  - `CPACK_DEBIAN_<COMPONENT>_PACKAGE_SUGGESTS`
- The `CPack` module learned to package empty directories.
- The `CPack` module 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.

### Other

- The `Compile Features` functionality is now aware of features supported by GNU C compilers on Windows.
- CMake learned to honor `*.manifest` source files with MSVC tools. Manifest files named as sources of `.exe` and `.dll` targets will be merged with linker-generated manifests and embedded in the binary.
- The Concurrent Fortran 77 compiler is now supported. Its `compiler id` is `CCur`.
- `cmake(1)` gained a new `--trace-expand` command line option that is like `--trace` but expands variable references in the output.

## Deprecated and Removed Features

- The `CMakeExpandImportedTargets` module is now documented as deprecated. See module documentation for an explanation.
- The `CMAKE_USE_RELATIVE_PATHS` variable no longer has any effect. Previously it was partially implemented and unreliable.

## Other Changes

- The `CheckFunctionExists`, `CheckLibraryExists`, `CheckSymbolExists`, and `FindThreads` modules learned to work in environments where only CXX is enabled.
- The `CPackDeb` module now correctly excludes symlinks during package checksum calculation.
- The `CPackDeb` no longer uses fakeroot and system tar program for packaging.
- The `CPack` module 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_EXPORTS` target property is set. See policy `CMP0065`.
- The `SONAME` field is no longer set for `MODULE` libraries created with the `add_library()` command. `MODULE` libraries are meant for explicit dynamic loading at runtime. They cannot be linked so `SONAME` is not useful.
- The internal `CMAKE_<LANG>_COMPILE_OBJECT` rule variable now substitutes compiler include flags in a separate `<INCLUDES>` placeholder instead of the main `<FLAGS>` placeholder.