CMAKE_FIND_USE_SYSTEM_PACKAGE_REGISTRY

在 3.16 版本中添加。

控制 System Package Registry 由 find_package() 命令搜索。

默认情况下，此变量未设置，并且行为将回退到已弃用的 CMAKE_FIND_PACKAGE_NO_SYSTEM_PACKAGE_REGISTRY 变量所确定的行为。如果未设置该变量，则 find_package() 将使用 System Package Registry，除非提供了 NO_CMAKE_SYSTEM_PACKAGE_REGISTRY 选项。

当两个变量均已设置时，此变量优先于 CMAKE_FIND_PACKAGE_NO_SYSTEM_PACKAGE_REGISTRY。

在某些情况下，例如仅查找用户特定安装，当在搜索程序包时不希望使用 System Package Registry。如果 CMAKE_FIND_USE_SYSTEM_PACKAGE_REGISTRY 变量为 FALSE，则所有 find_package() 命令将跳过 System Package Registry，就像使用 NO_CMAKE_SYSTEM_PACKAGE_REGISTRY 参数调用它们一样。

另请参阅 禁用 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_PACKAGE_REGISTRY 和 CMAKE_FIND_USE_PACKAGE_ROOT_PATH 变量。