CMP0173 — CMake 3.31.1 Documentation

# CMP0173

Added in version 3.31.

The `CMakeFindFrameworks` module is removed.

CMake's framework handling has evolved well beyond what the `CMakeFindFrameworks` module supports. The module lacks any handling of XCFrameworks, it never documented the one command it provides, and `find_library()` provides superior capabilities in all respects.

The `OLD` behavior of this policy is for `CMakeFindFrameworks` to continue to provide the undocumented `cmake_find_frameworks()` command. The `NEW` behavior halts with a fatal error if anything tries to include the module.

This policy was introduced in CMake version 3.31. It may be set by `cmake_policy()` or `cmake_minimum_required()`. If it is not set, CMake warns, and uses `OLD` behavior.

Note

The `OLD` behavior of a policy is `deprecated by definition` and may be removed in a future version of CMake.