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 为空。它 intended to be set by the project or the end user.(意图由项目或最终用户设置。)
另请参阅以下变量