CMAKE_FIND_USE_PACKAGE_REGISTRY¶
在 3.16 版本中添加。
控制 find_package()
命令的默认行为,以确定是否搜索 用户软件包注册表 提供的路径。
默认情况下,此变量未设置,行为将回退到由已弃用的 CMAKE_FIND_PACKAGE_NO_PACKAGE_REGISTRY
变量确定的行为。如果该变量也未设置,则 find_package()
将使用 用户软件包注册表,除非提供了 NO_CMAKE_PACKAGE_REGISTRY
选项。
当两者都设置时,此变量优先于 CMAKE_FIND_PACKAGE_NO_PACKAGE_REGISTRY
。
在某些情况下,例如仅定位系统范围内的安装,在搜索软件包时,不希望使用 用户软件包注册表。如果 CMAKE_FIND_USE_PACKAGE_REGISTRY
变量为 FALSE
,则所有 find_package()
命令都将跳过 用户软件包注册表,就像使用 NO_CMAKE_PACKAGE_REGISTRY
参数调用一样。
另请参阅 禁用软件包注册表 以及 CMAKE_FIND_USE_CMAKE_PATH
, CMAKE_FIND_USE_CMAKE_ENVIRONMENT_PATH
, CMAKE_FIND_USE_INSTALL_PREFIX
, CMAKE_FIND_USE_CMAKE_SYSTEM_PATH
, CMAKE_FIND_USE_SYSTEM_ENVIRONMENT_PATH
, CMAKE_FIND_USE_SYSTEM_PACKAGE_REGISTRY
和 CMAKE_FIND_USE_PACKAGE_ROOT_PATH
变量。