CMP0144

新增於版本 3.27。

find_package() 使用大寫的 <PACKAGENAME>_ROOT 變數。

在 CMake 3.27 及以上版本中，find_package(<PackageName>) 命令現在會搜尋由大寫的 <PACKAGENAME>_ROOT CMake 變數和 <PACKAGENAME>_ROOT 環境變數所指定的字首，此外還有自政策 CMP0074 開始使用的保留大小寫的 <PackageName>_ROOT 和 <PackageName>_ROOT 變數。此政策提供了與尚未更新以避免將 <PACKAGENAME>_ROOT 變數用於其他目的的專案的相容性。

此政策的 OLD 行為是如果原始的 <PackageName> 包含小寫字元，則忽略 <PACKAGENAME>_ROOT 變數。此政策的 NEW 行為是使用 <PACKAGENAME>_ROOT 變數。

此政策在 CMake 版本 3.27 中引入。它可以使用 cmake_policy() 或 cmake_minimum_required() 設定。如果未設定，CMake 會發出警告，並使用 OLD 行為。

注意

政策的 OLD 行為 依定義已被棄用，並可能在未來的 CMake 版本中移除。