节点相关

功能包相关

话题相关

服务相关

接口相关

参数相关

动作相关

colcon 构建命令

构建指令

• -packages-select ，仅生成单个包（或选定的包）。

• -packages-up-to，构建选定的包，包括其依赖项。

• -packages-above，整个工作区，然后对其中一个包进行了更改。此指令将重构此包以及（递归地）依赖于此包的所有包。

指定构建后安装的目录

合并构建目录

• -merge-install，使用 作为所有软件包的安装前缀，而不是安装其中的软件包特定子目录。

• --install-base，如果没有此选项，每个包都将提供自己的环境变量路径，从而导致非常长的环境变量值。使用此选项时，添加到环境变量的大多数路径将相同，从而导致环境变量值更短。

符号链接安装

错误时继续安装

CMake参数

• -cmake-args，将任意参数传递给CMake。与其他选项匹配的参数必须以空格为前缀。

控制构建线程

• -executor EXECUTOR，用于处理所有作业的执行程序。默认值是根据所有可用执行程序扩展的优先级选择的。要查看完整列表，请调用 colcon extensions colcon_core.executor --verbose。
• sequential [colcon-core]
一次处理一个包。
• parallel [colcon-parallel-executor]
处理多个作业平行.

• -parallel-workers NUMBER
• 要并行处理的最大作业数。默认值为 os.cpu_count() 给出的逻辑 CPU 内核数。

开启构建日志