CMAKE_FIND_USE_SYSTEM_PACKAGE_REGISTRY

3.16 版新增。

控制 find_package() 命令搜索 系统包注册表

默认情况下,此变量未设置,行为将回退到由已弃用的 CMAKE_FIND_PACKAGE_NO_SYSTEM_PACKAGE_REGISTRY 变量决定的行为。如果该变量也未设置,则 find_package() 将使用 系统包注册表,除非提供了 NO_CMAKE_SYSTEM_PACKAGE_REGISTRY 选项。

当两个变量都设置时,此变量的优先级高于 CMAKE_FIND_PACKAGE_NO_SYSTEM_PACKAGE_REGISTRY

在某些情况下,例如只查找用户特定的安装,在搜索包时使用 系统包注册表 是不希望的。如果 CMAKE_FIND_USE_SYSTEM_PACKAGE_REGISTRY 变量为 FALSE,则所有 find_package() 命令将跳过 系统包注册表,就好像它们使用了 NO_CMAKE_SYSTEM_PACKAGE_REGISTRY 参数调用一样。

另请参阅 禁用包注册表

另请参阅 CMAKE_FIND_USE_CMAKE_PATHCMAKE_FIND_USE_CMAKE_ENVIRONMENT_PATHCMAKE_FIND_USE_INSTALL_PREFIXCMAKE_FIND_USE_CMAKE_SYSTEM_PATHCMAKE_FIND_USE_SYSTEM_ENVIRONMENT_PATHCMAKE_FIND_USE_PACKAGE_REGISTRYCMAKE_FIND_USE_PACKAGE_ROOT_PATH 变量。