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