ROS 2构建系统迁移：从catkin到ament_cmake实战指南

1. ROS 1到ROS 2迁移的构建系统变革

从ROS 1到ROS 2的迁移远不止是API的简单替换，最根本的变化在于构建系统的彻底重构。在ROS 1时代，我们熟悉的catkin构建系统采用了一种相对宽松的依赖管理方式，很多路径和依赖关系都被隐藏在全局变量中自动处理。这种设计虽然降低了入门门槛，但也带来了不少隐性问题。

ROS 2的ament_cmake构建系统则采用了完全不同的哲学。它强制开发者必须显式声明每一个构建目标（Target）的依赖关系、包含路径和安装规则。这种改变带来了两个直接影响：首先，项目结构变得更加清晰可控；其次，任何不规范的依赖声明都会立即导致编译失败。

注意：ament_cmake实际上是CMake的一个扩展框架，它在保持CMake灵活性的同时，为ROS 2项目添加了标准化的构建、测试和安装流程。

在实际迁移工作中，我发现最令人头疼的不是新API的学习，而是那些看似莫名其妙的编译错误。经过多个项目的实战积累，我总结出了四个最具代表性的痛点及其解决方案。这些问题的核心都围绕着同一个主题：如何正确声明和管理包的依赖关系。

2. 第三方SDK头文件找不到问题解析

2.1 问题现象与根源分析

当你在ROS 2包中使用第三方SDK时，经常会遇到这样的场景：包自身编译通过，但依赖它的下游包却报出"fatal error: third_party_sdk.h: No such file or directory"的错误。这个问题的根源在于ament_cmake对头文件路径的严格管理。

在ROS 1中，catkin会自动处理很多路径问题。只要在CMakeLists.txt中使用了include_directories()，下游包就能找到这些头文件。但在ROS 2中，这远远不够。ament_cmake要求你必须明确区分两种场景：

• BUILD_INTERFACE：当前包在构建时使用的头文件路径
• INSTALL_INTERFACE：其他包依赖当前包时寻找头文件的路径

2.2 完整解决方案与配置模板

要彻底解决这个问题，需要从多个层面进行配置。以下是一个完整的解决方案模板：

cmake复制# 基础包含路径（仅用于当前包构建）
include_directories(
  include/
  3rdparty/
  3rdparty/include/
)

add_library(${PROJECT_NAME} SHARED src/main_logic.cpp)

# 关键配置：区分构建时和安装后的包含路径
target_include_directories(${PROJECT_NAME} PUBLIC
  $<BUILD_INTERFACE:${CMAKE_CURRENT_SOURCE_DIR}/include>