CMAKE_POLICY_VERSION_MINIMUM

在版本 4.0 中新增。

為專案指定最小政策版本,而無需修改其對 cmake_minimum_required(VERSION)cmake_policy(VERSION) 的呼叫。

此變數不應由專案在 CMake 程式碼中設定,以作為設定其自身政策版本的方式。請使用 cmake_minimum_required(VERSION) 和/或 cmake_policy(VERSION) 來達成目的。此變數旨在外部設定專案本身尚未更新的政策。

  • 執行 CMake 的使用者可以在快取中設定此變數,例如 -DCMAKE_POLICY_VERSION_MINIMUM=3.5,以嘗試設定尚未更新為至少設定該政策版本的專案。

    或者,使用者可以設定 CMAKE_POLICY_VERSION_MINIMUM 環境變數,以在新建置樹中自動初始化快取條目。

  • 專案可以在呼叫 add_subdirectory() 之前設定此變數,該呼叫會新增第三方專案,以便在不修改第三方程式碼的情況下設定其政策版本。

請參閱 CMAKE_POLICY_DEFAULT_CMP<NNNN> 以設定個別政策。