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>_ROOT 變數,如果原始 <PackageName> 包含小寫字元。此策略的 NEW 行為是使用 <PACKAGENAME>_ROOT 變數。

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

注意

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