CMAKE_IGNORE_PATH¶
以分號分隔的列表,其中包含各種 find...()
命令要忽略的目錄。
對於 find_program()
、 find_library()
、 find_file()
和 find_path()
,在列出的目錄中找到的任何檔案都將被忽略。列出的目錄不會遞迴應用,因此要忽略的任何子目錄也必須明確列出。CMAKE_IGNORE_PATH
不會影響這四個命令使用的搜尋前綴。要忽略搜尋前綴下的個別路徑(例如 bin
、 include
、 lib
等),每個路徑都必須在 CMAKE_IGNORE_PATH
中列為完整絕對路徑。CMAKE_IGNORE_PREFIX_PATH
提供了一種更合適的方法來忽略整個搜尋前綴。
find_package()
也受到 CMAKE_IGNORE_PATH
的影響,但僅適用於 Config 模式 搜尋。在指定目錄中找到的任何 <Name>Config.cmake
或 <name>-config.cmake
檔案都將被忽略。此外,為了向後相容性原因,在 CMAKE_IGNORE_PATH
中找到的任何搜尋前綴都將被跳過,但新程式碼應優先使用 CMAKE_IGNORE_PREFIX_PATH
以改為忽略前綴。
在交叉編譯環境中,當某些系統目錄包含不相容但可能可連結的函式庫時,忽略搜尋位置可能很有用。例如,在交叉編譯的叢集環境中,這允許使用者忽略包含用於前端機器的函式庫的目錄。
預設情況下,CMAKE_IGNORE_PATH
為空。它旨在由專案或最終使用者設定。
另請參見以下變數