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_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 變數。