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