CMake、Ament 与 Catkin：ROS 构建系统的前世今生

CMake、Ament 与 CatkinROS 构建系统的前世今生如果你开发过 ROS机器人操作系统程序一定对CMakeLists.txt、package.xml以及catkin_make或colcon build这些名词不陌生。但你真的清楚CMake、AmentROS 2和CatkinROS 1之间的关系吗它们有什么区别为什么 ROS 2 要从 Catkin 迁移到 Ament本文将为你彻底讲清这三者的定位、联系与区别帮助你更好地理解 ROS 的构建体系。一、CMake通用的构建引擎CMake是一个跨平台的开源构建系统生成器。它本身不直接编译代码而是根据CMakeLists.txt生成原生构建工具如 Makefile、Ninja、Visual Studio 工程所需的文件再由这些工具完成实际的编译链接。CMake 的核心能力检测编译器和系统环境查找依赖库、头文件find_package、find_library定义构建目标可执行文件、静态/动态库管理编译选项、链接选项支持测试CTest、打包CPack适用范围任何C/C 项目也支持 Fortran、CUDA 等以及需要复杂构建配置的 Python 项目通过pybind11等。CMake 不包含任何机器人领域的概念。典型用法mkdirbuildcdbuild cmake..# 生成 Makefilemake# 实际编译二、CatkinROS 1 的元构建系统Catkin是 ROS 1 官方采用的构建系统它构建在 CMake 之上为 ROS 1 包提供了额外的抽象和约定。Catkin 解决了什么问题需要从.msg/.srv文件自动生成代码多个 ROS 包之间复杂的依赖关系工作空间workspace环境变量自动设置setup.bashCatkin 的组成package.xml包的元信息名称、版本、依赖CMakeLists.txt其中调用find_package(catkin REQUIRED ...)和catkin_package()构建工具catkin_make官方简单工具或catkin build更强大的catkin_toolsCatkin 典型用法mkdir-p~/catkin_ws/srccd~/catkin_ws catkin_make# 一次性构建所有包catkin_make --only-pkg-with-deps my_pkg# 只构建某个包Catkin 的 CMakeLists.txt 片段cmake_minimum_required(VERSION 2.8.3) project(my_ros1_pkg) find_package(catkin REQUIRED COMPONENTS roscpp std_msgs) catkin_package( INCLUDE_DIRS include LIBRARIES ${PROJECT_NAME} CATKIN_DEPENDS roscpp std_msgs ) add_executable(my_node src/my_node.cpp) target_link_libraries(my_node ${catkin_LIBRARIES})三、AmentROS 2 的元构建系统Ament是 ROS 2 中取代 Catkin 的元构建系统。同样基于 CMake但设计上更加现代化、模块化。Ament 相比 Catkin 的改进完全隔离的构建不再有devel空间所有产物直接安装到install空间避免交叉污染。一等 Python 支持提供ament_python构建类型原生支持纯 Python 包。更清晰的依赖管理ament_target_dependencies自动处理 include 路径、库、编译定义。更模块化ament_cmake由多个小组件ament_cmake_core、ament_cmake_export_*等组成按需使用。与 colcon 深度集成colcon build统一构建 C 和 Python 包。Ament 典型用法mkdir-p~/ros2_ws/srccd~/ros2_ws colcon build# 构建所有包colcon build --packages-select my_pkg# 只构建指定包Ament 的 CMakeLists.txt 片段cmake_minimum_required(VERSION 3.8) project(my_ros2_pkg) find_package(ament_cmake REQUIRED) find_package(rclcpp REQUIRED) find_package(std_msgs REQUIRED) ament_target_dependencies(my_node rclcpp std_msgs) # 生成消息/服务ROS 2 使用 rosidl rosidl_generate_interfaces(${PROJECT_NAME} msg/MyMsg.msg srv/MySrv.srv ) ament_package()四、三者关系一图以蔽之┌─────────────────────────────────────────────────────────┐ │ CMake │ │ (通用构建系统生成器) │ │ 提供target, find_package, add_executable ... │ └─────────────────┬───────────────────┬───────────────────┘ │ │ ▼ ▼ ┌─────────────────────┐ ┌─────────────────────┐ │ Catkin │ │ Ament │ │ (ROS 1 元构建) │ │ (ROS 2 元构建) │ │ 扩展catkin_package │ │ 扩展ament_* 宏 │ │ 工具catkin_make │ │ 工具colcon │ └─────────────────────┘ └─────────────────────┘CMake是“引擎”提供底层能力。Catkin和Ament是“专用车身套件”基于 CMake 封装出 ROS 领域的高级功能。五、核心功能对比表功能点CMakeCatkin (ROS 1)Ament (ROS 2)适用领域任何 C/C 项目仅 ROS 1 包仅 ROS 2 包包清单文件无或自定义package.xmlpackage.xml查找 ROS 依赖不支持find_package(catkin ...)find_package(rclcpp ...)添加 ROS 依赖手动target_link...${catkin_LIBRARIES}ament_target_dependencies生成消息/服务代码需要手写生成器add_message_filesgenerate_messagesrosidl_generate_interfaces环境脚本无devel/setup.bashinstall/setup.bash构建命令cmake makecatkin_make或catkin buildcolcon build构建空间隔离手动控制devel与build混用buildinstall完全隔离六、为什么 ROS 2 要从 Catkin 迁移到 Ament现代 CMake 需求Catkin 要求 CMake 2.8.32009 年标准而 Ament 要求 3.8可利用现代 CMake 特性如target粒度控制、INTERFACE传播。Python 包支持Catkin 对 Python 包的处理比较别扭需要手动编写setup.pyAment 则原生支持ament_python构建类型。隔离构建Catkin 的devel空间容易导致环境污染和难以复现的问题Ament 强制安装到install空间每个包独立。模块化与可维护性Ament 拆分为多个独立的 CMake 子包如ament_cmake_export_dependencies更易于扩展和维护。与 colcon 统一体验无论 C 还是 Python 包都用colcon build构建开发者体验一致。七、常见问题速查Q1我能在 ROS 2 中直接用 CMake 而不通过 Ament 吗技术上可以但你会失去消息生成、环境脚本自动配置、依赖传播等 ROS 2 生态的关键功能。强烈不建议这么做。Q2Catkin 和 Ament 的 CMakeLists.txt 可以互相转换吗不能直接转换但迁移思路是将catkin_package()改为ament_package()将find_package(catkin REQUIRED COMPONENTS ...)拆成多个独立的find_package并替换依赖添加方式为ament_target_dependencies。Q3Colcon 只能构建 Ament 包吗colcon是构建工具支持多种构建器ament_cmake、ament_python、cmake、python等。你甚至可以用 colcon 构建非 ROS 的纯 CMake 包。Q4学习 ROS 构建系统我应该重点掌握什么底层理解CMake 的核心概念目标、属性、查找包。ROS 层面熟悉package.xml的写法以及对应的构建宏catkin_*或ament_*。构建工具会用catkin_make/colcon build以及常用选项--symlink-install、--packages-select。八、总结系统本质一句话总结CMake通用构建引擎它什么都不懂但什么都能造。CatkinROS 1 的 CMake 扩展为 ROS 1 定制的“老爷车套件”功勋卓著但略显陈旧。AmentROS 2 的 CMake 扩展为 ROS 2 全新设计的“现代套件”更干净、更灵活、更 Python 友好。