CMAKE_FIND_PACKAGE_NO_PACKAGE_REGISTRY

在版本 3.1 中新增。

自版本 3.16 起已棄用:請改用 CMAKE_FIND_USE_PACKAGE_REGISTRY 變數。

預設情況下,此變數未設定。如果 CMAKE_FIND_USE_PACKAGE_REGISTRYCMAKE_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 參數一樣。

另請參閱 停用套件註冊表