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 的未来版本中移除。