CMAKE_FIND_PACKAGE_NO_PACKAGE_REGISTRY¶
版本 3.1 中新增。
自版本 3.16 弃用:请改用 CMAKE_FIND_USE_PACKAGE_REGISTRY
变量。
默认情况下,此变量未设置。如果 CMAKE_FIND_USE_PACKAGE_REGISTRY
和 CMAKE_FIND_PACKAGE_NO_PACKAGE_REGISTRY
均未设置,则 find_package()
将使用 用户包注册表,除非提供了 NO_CMAKE_PACKAGE_REGISTRY
选项。
如果已设置 CMAKE_FIND_USE_PACKAGE_REGISTRY
,则将忽略 CMAKE_FIND_PACKAGE_NO_PACKAGE_REGISTRY
。
在某些情况下,例如仅定位整个系统安装,当搜索包时,不希望使用 用户包注册表。如果 CMAKE_FIND_PACKAGE_NO_PACKAGE_REGISTRY
变量为 TRUE
,所有 find_package()
命令将跳过 用户包注册表,就好像使用 NO_CMAKE_PACKAGE_REGISTRY
参数对其进行了调用。
另请参阅 禁用包注册表。