跳到主要内容

kmpkg_host_path_list

修改主机路径列表变量（如 PATH、INCLUDE、LIBPATH 等）。

用法​

kmpkg_host_path_list(PREPEND <list-var> [<path>...])
kmpkg_host_path_list(APPEND <list-var> [<path>...])
kmpkg_host_path_list(SET <list-var> [<path>...])

详细说明​

变量类型​

<list-var> 可以是普通的 CMake 变量名，也可以是 ENV{variable-name} 形式（此时 kmpkg_host_path_list 会直接修改对应的系统环境变量）。

操作行为​

  • PREPEND：将传入的路径添加到现有列表的最前面，因此这些路径会被优先搜索；
  • APPEND：将传入的路径添加到现有列表的最后面，因此这些路径会在原有路径之后被搜索；
  • SET：用传入的路径列表完全替换现有变量的值。

路径顺序​

在 APPEND、PREPEND、SET 三种模式下，传入的路径均会按参数顺序添加/设置（即先传入的路径排在前）。

空路径处理​

  • 若 APPEND 或 PREPEND 未传入任何路径，函数不会执行任何操作；
  • 若 SET 未传入任何路径，会将目标变量的值设为空字符串。

源码​

scripts/cmake/kmpkg_host_path_list.cmake