CMAKE_IGNORE_PATH¶
Semicolon-separated list of directories
to be ignored by the various find...() commands.
对于 find_program()、 find_library()、 find_file() 和 find_path(),在列出的目录之一中找到的任何文件都将被忽略。列出的目录不递归应用,因此任何要忽略的子目录也必须明确列出。 |CMAKE_IGNORE_VAR|不影响这四个命令使用的搜索 *prefixes*。要忽略搜索前缀下的单个路径(例如 ``bin``、``include``、``lib`` 等),每个路径必须列在 |CMAKE_IGNORE_VAR| 中作为完整的绝对路径。 |CMAKE_IGNORE_PREFIX_VAR|提供了一种更合适的方法来忽略整个搜索前缀。
find_package() 也受 CMAKE_IGNORE_PATH 的影响,但仅限于 Config mode 搜索。在指定目录之一中找到的任何 <Name>Config.cmake 或 <name>-config.cmake 文件都将被忽略。此外,在 CMAKE_IGNORE_PATH 中找到的任何搜索 *prefix*出于向后兼容的原因将被跳过,但新代码应该更喜欢使用 |CMAKE_IGNORE_PREFIX_VAR|忽略前缀。
忽略搜索位置在某些系统目录包含不兼容但可能可链接的库的交叉编译环境中可能很有用。例如,在交叉编译的集群环境中,这允许用户忽略包含用于前端机器的库的目录。
默认情况下,|CMAKE_IGNORE_VAR|是空的。它旨在由项目或最终用户设置。
另请参阅以下变量: