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 中移除。