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