CMP0144

在版本 3.27 中添加。

find_package() 使用大写 <PACKAGENAME>_ROOT 变量。

在 CMake 3.27 及以上版本中,find_package(<PackageName>) 命令现在搜索由大写 <PACKAGENAME>_ROOT CMake 变量和 <PACKAGENAME>_ROOT 环境变量指定的路径,此外还有从策略 CMP0074 开始使用的保留大小写的 <PackageName>_ROOT<PackageName>_ROOT 变量。

此策略的 OLD 行为是忽略 <PACKAGENAME>_ROOT 变量,如果原始 <PackageName> 含有小写字符。此策略的 NEW 行为是使用 <PACKAGENAME>_ROOT 变量。

此策略在 CMake 版本 3.27 中引入。它可由 cmake_policy()cmake_minimum_required() 来设置。如果未将其设置,CMake 将发出警告并使用 OLD 行为。

注意

策略的 OLD 行为 已被弃用 (定义),并且可能会在将来的 CMake 中被移除。