CMP0143

在版本 3.26 中添加。

USE_FOLDERS 全局属性默认被视为 ON

当使用 CMake 3.25 或更早版本时,除非项目启用此功能,否则 USE_FOLDERS 默认被视为 OFF。例如

cmake_minimum_required(VERSION 3.25)
project(foobar LANGUAGES CXX)
set_property(GLOBAL PROPERTY USE_FOLDERS ON)

CMake 3.26 及更高版本默认倾向于启用此功能。

请注意,重要的是顶级 CMakeLists.txt 文件末尾的策略设置。策略设置全局应用于整个项目。

此策略为尚未更新以期望启用文件夹的项目提供兼容性。启用文件夹会导致项目在 IDE 中以不同的方式显示。

此策略在 CMake 3.26 版本中引入。它可以通过 cmake_policy()cmake_minimum_required() 设置。如果未设置,CMake 不会发出警告,并使用 OLD 行为。

注意

策略的 OLD 行为是 按定义已弃用,并可能在未来的 CMake 版本中移除。