以下是以表格形式总结的 colcon
配置选项及其功能和可选参数:
选项 | 功能 | 可选参数 | 适用命令 |
---|---|---|---|
--help | 显示当前命令的帮助信息 | 无 | 通用 |
--base-paths | 指定包含包的路径列表 | 路径列表(用空格分隔) | 通用 |
--log-base | 指定日志文件的输出路径 | 一个路径 | 通用 |
--event-handlers | 指定事件处理程序,用于控制日志输出格式和方式 | 逗号分隔的列表(如 console_direct+ , log , status ) | 通用 |
--parallel-workers | 设置并行构建的最大线程数 | 整数 | 通用 |
--merge-install | 将所有包的安装文件合并到一个 install 目录中 | 无 | build |
--packages-select | 指定要构建、测试或列出的包 | 包名列表(用空格分隔) | build , test , list |
--packages-skip | 指定要跳过构建、测试或列出的包 | 包名列表 | build , test , list |
--packages-up-to | 构建指定包及其所有依赖项 | 包名列表 | build |
--packages-above | 构建依赖于指定包的所有包 | 包名列表 | build |
--cmake-args | 向 CMake 构建工具传递额外的参数 | CMake 参数列表 | build |
--catkin-cmake-args | 向 Catkin 构建工具传递额外的参数 | Catkin 参数列表 | build |
--symlink-install | 构建时创建符号链接,而不是复制文件 | 无 | build |
--pytest-args | 向 pytest 测试框架传递额外参数 | pytest 参数列表 | test |
--packages-ignore | 忽略指定的包 | 包名列表 | list |
--continue-on-error | 即使某些包构建失败,也继续构建其他包 | 无 | build |
--event-log | 生成包含所有构建事件的日志文件 | 无 | build |