CMP0143

在 3.26 版本加入.

USE_FOLDERS 全局属性默认被视为 ON

使用 CMake 3.25 或更早版本时,USE_FOLDERS 默认被视为“关闭”,除非项目启用该功能。例如:

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() 命令将其显式设置为 OLDNEW。与许多政策不同,CMake 版本 |release|当此策略未设置且仅使用“旧”行为时*不*发出警告。

备注

策略的“旧”行为是 :manual:根据定义 <cmake-policies(7)> 已弃用,并且可能会在未来版本的 CMake 中删除。