[ROS]（03）CMakeLists.txt详解

最新推荐文章于 2025-10-22 15:52:20 发布
原创 最新推荐文章于 2025-10-22 15:52:20 发布 · 2.9k 阅读 · 60 ·
CC 4.0 BY-SA版权
版权声明：本文为博主原创文章，遵循 CC 4.0 BY-SA 版权协议，转载请附上原文出处链接和本声明。
文章标签：

#自动驾驶 #开发语言 #ubuntu

部署运行你感兴趣的模型镜像

  文章只是个人学习过程中学习笔记，主要参考ROS教程1。

目录

1、概述

  CMakeLists.txt是用于编译软件包的CMake编译系统的输入文件，几乎可以在任何文本编辑器中进行编辑。该文件描述了如何编译代码以及安装到何处。用于catkin项目的CMakeLists.txt文件是一个标准的附带一些额外约束的vanilla CMakeLists.txt文件。

  catkin是ROS官方自定义的编译系统，它的原理与流程与CMake很相似，和老版本rosbuild相比，支持更好的可移植性（catkin结合了可移植性好的CMake和python）以及交叉编译。（在ROS2使用的编译工具是ament，它是由catkin优化迭代而来的版本）

  CMake语言由 注释（comments）、命令（commands） 和 变量（variables）组成。
  CMake相关文档：https://cmake.org/documentation/

2、CMakeLists.txt文件

2.1 遵循的格式和顺序

  CMakeLists.txt文件必须遵循以下格式，否则软件包将无法正确构建。配置中的顺序确实很重要。CMakeLists.txt的基本语法都还是CMake，而catkin在其中添加了少量的宏（见new）。

顺序语法功能备注
1cmake_minimum_required所需的 CMake 版本–
2project() 包名–
3find_package()查找编译所需的其他 CMake/Catkin 包–
4catkin_python_setup() 启用 Python 模块支持new
5add_message_files()添加在msg文件夹中自定义的*.msg消息文件new
add_service_files()添加在srv文件夹中自定义的*.srv服务文件new
add_action_files()添加在avtion文件夹中自定义的*.action动作文件new
6generate_messages() 调用消息/服务/动作生成特定语言的接口文件new
7catkin_package()指定包构建信息导出new
8add_library() 生成库文件–
add_dependencies()定义目标文件依赖于其他文件，确保其他目标已被构建–
add_executable()生成可执行的二进制文件–
target_link_libraries()指定可执行目标链接的库–
9catkin_add_gtest()要编译的测试new
10 install()安装规则–

2.2 文件解析

# 1 -- 项目所需要的CMake版本，向后兼容 
cmake_minimum_required(VERSION 3.0.2)

# 2 -- 使用CMake project(package-name)声明软件包名称 
# 可以通过使用变量 ${PROJECT_NAME} 在CMake脚本后面的任何位置引用项目名称。
project(beginner_tutorials)

# 3 --  CMake宏，查找编译所需的其他 CMake/Catkin 包(具体分析请看下面的2.3小节)
# [REQUIRED]：当没有满足条件的package时（例如指定的组件未找到等），
#             会终止CMake执行过程，并输出一条错误信息，反之，CMake会继续执行。
# [COMPONENTS]：要查找的组件(components)，通常一个pakcage可能包含多个组件。
#               roscpp、rospy...就是catkin的组件。 
#               任何一个找不到就算失败，会终止CMake执行过程。  
# 确保所有这些依赖package也在package.xml中，使用<depend>或<build_denpend>标记。
find_package(catkin REQUIRED COMPONENTS
  roscpp
  rospy
  std_msgs
)

## 查找 PythonLibs 库
# find_package(PythonLibs REQUIRED)

## 查找C++ Boost库的组件库system、thread
# find_package(Boost REQUIRED COMPONENTS system thread)

## 4 -- 启用 Python 模块支持 
## 如果这个package有setup.py，则取消对此的注释。
## 这个宏确保其中声明的模块和全局脚本得到安装 
# catkin_python_setup()

################################################
## Declare ROS messages, services and actions ##
## 声明 ROS 消息、服务和动作					  ##  
################################################

## 5 --  添加在`msg`文件夹中自定义的`*.msg`文件
## 将Message*.msg替换成你的.msg文件，
# add_message_files(
#   FILES
#   Message1.msg
#   Message2.msg
# )

## 5 --  添加在`srv`文件夹中自定义的`*.srv`文件
## 将Service*.msg替换成你的.srv文件
# add_service_files(
#   FILES
#   Service1.srv
#   Service2.srv
# )

## 5 --  添加在`action`文件夹中自定义的`*.action`文件
## 将Action*.action替换成你的.action文件
# add_action_files(
#   FILES
#   Action1.action
#   Action2.action
# )

## 6 --  调用`消息`/`服务`/`动作`生成特定语言的接口文件
## 用于生成所有定义的message、service、action文件，需要添加本文件需要依赖的packages。
## 其实就是告诉编译器，编译 *.msg *.srv *.action 等文件时，需要依赖的库或package。
## Generate added messages and services with any dependencies listed here
# generate_messages(
#   DEPENDENCIES
#   std_msgs  # Or other packages containing msgs
# )

################################################
## Declare ROS dynamic reconfigure parameters ##
################################################
## To declare and build dynamic reconfigure parameters within this
## package, follow these steps:
## * In the file package.xml:
##   * add a build_depend and a exec_depend tag for "dynamic_reconfigure"
## * In this file (CMakeLists.txt):
##   * add "dynamic_reconfigure" to
##     find_package(catkin REQUIRED COMPONENTS ...)
##   * uncomment the "generate_dynamic_reconfigure_options" section below
##     and list every .cfg file to be processed

## Generate dynamic reconfigure parameters in the 'cfg' folder
# generate_dynamic_reconfigure_options(
#   cfg/DynReconf1.cfg
#   cfg/DynReconf2.cfg
# )

###################################
## catkin specific configuration ##
###################################
## 7 -- catkin_package() (具体分析请看下面的2.3小节)
## 由catkin_package生成的文件最终会被安装到devel和build文件夹下。
## INCLUDE_DIRS: 如果package包含头文件，则取消对此行的注释
## LIBRARIES: 项目导出的库
## CATKIN_DEPENDS: 项目依赖的其余catkin项目
## DEPENDS: 项目依赖的其余非catkin项目
catkin_package(
#  INCLUDE_DIRS include
#  LIBRARIES beginner_tutorials
#  CATKIN_DEPENDS roscpp rospy std_msg
#  DEPENDS system_lib
)

###########
## Build ##
###########
## 
## 第一个参数“include”表示包中的include/目录也是路径的一部分。
## catkin_INCLUDE_DIRS：表示建立的环境变量
include_directories(
# include
  ${catkin_INCLUDE_DIRS}
)

## 8 -- add_library() 生成库文件${PROJECT_NAME}
# add_library(${PROJECT_NAME}
#   src/${PROJECT_NAME}/beginner_tutorials.cpp
# )

## 8 -- 定义target依赖的其他target
## add_dependencies(target-name depend-target1 depend-target2 ...)
# add_dependencies(${PROJECT_NAME} ${${PROJECT_NAME}_EXPORTED_TARGETS} ${catkin_EXPORTED_TARGETS})

## 8 -- 生成可执行的二进制文件 
## add_executable(<生成> <源文件>)
## 使用${PROJECT_NAME}引用变量，生成一个名为beginner_tutorials_node的可执行文件。
# add_executable(${PROJECT_NAME}_node src/beginner_tutorials_node.cpp)

## Rename C++ executable without prefix
## The above recommended prefix causes long target names, the following renames the
## target back to the shorter version for ease of user use
## e.g. "rosrun someones_pkg node" instead of "rosrun someones_pkg someones_pkg_node"
# set_target_properties(${PROJECT_NAME}_node PROPERTIES OUTPUT_NAME node PREFIX "")

## Add cmake target dependencies of the executable
## same as for the library above
# add_dependencies(${PROJECT_NAME}_node ${${PROJECT_NAME}_EXPORTED_TARGETS} ${catkin_EXPORTED_TARGETS})	

##  8 -- 指定可执行目标链接的库
# target_link_libraries(${PROJECT_NAME}_node
#   ${catkin_LIBRARIES}
# )

#############
## Install ##
#############

## 安装python可执行脚本
# catkin_install_python(PROGRAMS
#   scripts/my_python_script
#   DESTINATION ${CATKIN_PACKAGE_BIN_DESTINATION}
# )

## 9 -- 安装规则 -- 目标文件的安装
## DESTINATION：定义了安装的路径
## 可执行二进制文件beginner_tutorials_node 安装到 ${CATKIN_PACKAGE_BIN_DESTINATION}目录
# install(TARGETS ${PROJECT_NAME}_node
#   RUNTIME DESTINATION ${CATKIN_PACKAGE_BIN_DESTINATION}
# )

## ARCHIVE：静态库
## LIBRARY：动态库
## RUNTIME：可执行目标二进制
# install(TARGETS ${PROJECT_NAME}
#   ARCHIVE DESTINATION ${CATKIN_PACKAGE_LIB_DESTINATION}
#   LIBRARY DESTINATION ${CATKIN_PACKAGE_LIB_DESTINATION}
#   RUNTIME DESTINATION ${CATKIN_GLOBAL_BIN_DESTINATION}
# )

## 9 -- 安装规则 -- 目录的安装
## 如果目录以“/”结尾，表示将目录中的内容安装到目标路径
## 如果目录不以“/”结尾，表示将目录安装为目标路径下的目录
## PATTERN：用于使用正则表达式进行过滤
# install(DIRECTORY include/${PROJECT_NAME}/
#   DESTINATION ${CATKIN_PACKAGE_INCLUDE_DESTINATION}
#   FILES_MATCHING PATTERN "*.h"
#   PATTERN ".svn" EXCLUDE   
# )

## 9 -- 安装规则 -- 普通文件的安装
# install(FILES
#   # myfile1
#   # myfile2
#   DESTINATION ${CATKIN_PACKAGE_SHARE_DESTINATION}
# )

#############
## Testing ##
#############

## 添加基于gtest的cpp测试目标和链接库
# catkin_add_gtest(${PROJECT_NAME}-test test/test_beginner_tutorials.cpp)
# if(TARGET ${PROJECT_NAME}-test)
#   target_link_libraries(${PROJECT_NAME}-test ${PROJECT_NAME})
# endif()

## Add folders to be run by python nosetests
# catkin_add_nosetests(test)

2.3 find_package()

  如果 CMake 通过find_package()2 找到一个package，则会创建几个 CMake 环境变量，这些变量提供有关找到的package的信息。这些环境变量可以稍后在 CMake 脚本中使用。环境变量描述了package导出的头文件在哪里、源文件在哪里、包依赖的库以及这些库的路径。名称始终遵循 <PACKAGE NAME>_<PROPERTY> 的约定：

  • <NAME>_FOUND -：如果找到库，则设置为 true，否则设置为 false
  • <NAME>_INCLUDE_DIRS 或 <NAME>_INCLUDES ：package导出的include路径
  • <NAME>_LIBRARIES 或 <NAME>_LIBS ：package导出的库
  • <NAME>_DEFINITIONS：?

  查找编译所需的其他 CMake/Catkin 包：

find_package(<package-name> REQUIRED COMPONENTS component1 commponent2 …)

  例如：新建的软件包依赖roscpp、rospy、std_msgs

find_package(catkin REQUIRED COMPONENTS
  roscpp
  rospy
  std_msgs
)

  对于这个新建的catkin软件包，将它依赖的其他catkin packages(roscpp、rospy、std_msgs)指定为catin的组件，这是最推荐的方法，这样操作会使它们的include路径、libraries路径等附件到catkin_variables中。例如，catkin_INCLUDE_DIRS 不仅包含了catkin package自己的include路径，还包含组件（例如上面的roscpp、rospy、std_msgs）的include路径，在后续的使用中会很方便！

include_directories(${catkin_INCLUDE_DIRS})
target_link_libraries(${PROJECT_NAME}_node ${catkin_LIBRARIES})

既然有这么多好处，为什么不能把find_package(PythonLibs REQUIRED)整合到一起呢？
这是因为find_package()一次只能查找一个package，catkin是指ROS工程中使用catkin工具编译的packages，而且凡是有catkin编译的包都可以作为catkin的组件，也可以作为单独的package，但PythonLibs 不行，因为它不是ros系统的package，属于第三方package。

2.4 catkin_package()

  catkin_package()2 是给依赖本package的package使用的。可以向其他package导出依赖，这些依赖可能包含头文件、库，或者本package依赖的其他package。
  必须在使用add_library()或add_executable()声明任何目标之前调用此函数。该函数有 5 个可选参数：

  • INCLUDE_DIRS - 导出的包的包含路径（即 cflags）
  • LIBRARIES - 从项目中导出的库
  • CATKIN_DEPENDS - 本项目依赖的其他catkin项目
  • DEPENDS - 此项目所依赖的非 catkin CMake 项目
  • CFG_EXTRAS - 附加配置选项

catkin_package()是在/opt/ros/melodic/share/catkin/cmake/catkin_package.cmake文件定义的。调用 catkin_package()之后，会在/devel/share/<package-name>/cmake目录下生成CMake config模式的查找文件：<package-name>Config.cmake和<package-name>Config-version.cmake。这样，其他软件包package使用`find_package(…)时就会加载配置文件了，从而获得依赖项。
在这里插入图片描述

   然后我们在看一篇ROS Answers上的问答：What is the purpose of CATKIN_DEPENDS?。
https://answers.ros.org/question/58498/what-is-the-purpose-of-catkin_depends/

   DEPENDS 和CATKIN_DEPENDS是来告诉catkin将你软件包的依赖项传递给使用find_package(…)查找你的软件包package的软件包package。
  
   例如：假设你（调用）find_package(Boost REQUIRED)，并且在你的已安装的头文件中（包含）#include <boost/function.hpp>。为了让一个依赖软件包package（别的软件包package）构建和链接你的头文件，他们需要在他们的include路径中有 Boost 的include目录，并且他们需要链接到 Boost 的库。既然你已经在你头文件中使用了它，那么它们应该能从你那获得那个依赖。换言之，正因为它们是依靠你的软件包package构建的，所以它们不需要 find_package(Boost REQUIRED)了，并且不另外使用Boost。
  
  你的软件包package依赖于Boost这一事实是一个实现细节。因此当一些（软件包package）通过find_package(...)查找你的软件包package时，它们能够间接获得对Boost的依赖。其工作方式是在catkin_package(…)调用中放入DEPENDS Boost。在内部，catkin将通过find_package(Boost)获取路径，并且向 ${your_pkg_LIBRARIES} 添加${Boost_LIBRARIES}，向${your_pkg_INCLUDE_DIRS}添加${Boost_INCLUDE_DIRS} 。
  
  我应该注意，catkin 将获取您给它的确切内容并尝试 通过find_package(...) （查找）该软件包package，然后尝试使用该包的_LIBRARIES和_INCLUDE_DIRS变量。这个关于find_package(…)布局的假设并不总是成立，因为CMake没有强制这样做。
  例如：当find_package(…)ing Python时：
  find_package(PythonLibs REQUIRED)结果为变量像是PYTHON_INCLUDE_PATH，
  find_package(OpenGL REQUIRED) 结果为OPENGL_INCLUDE_DIR。
  除了变量前缀的大小写外，这实际的前缀也是不同(PythonLibs -> PYTHON)，并且这后缀也是不标准的(PYTHON_INCLUDE_PATH and OPENGL_INCLUDE_DIR vs *_INCLUDE_DIRS)。
  在这种情况下，你需要将使用INCLUDE_DIRS选项的include dirs变量和使用LIBRARIES 选项的库明确地传递给catkin_package(…)。
  
  虽然CATKIN_DEPENDS选项和DEPENDS选项非常相似，但是你必须把catkin packages只放在这个list中。对你的 catkin 进行分类的好处是依赖于一个单独的选项，catkin能够进行额外的检查并警告你潜在的不正确的做法。
  
  最后，一个简单的例子CMakeLists.txt：

cmake_minimum_required(VERSION 2.8.3)
project(foo)

find_package(Boost REQUIRED
  COMPONENTS
  system
  thread
)

find_package(PythonLibs REQUIRED)
find_package(OpenGL REQUIRED)

find_package(catkin REQUIRED
  COMPONENTS
  rosconsole
  roscpp
)

include_directories(
  include
  ${catkin_INCLUDE_DIRS}
  ${OPENGL_INCLUDE_DIR}
  ${PYTHON_INCLUDE_PATH}
)

catkin_package(
  INCLUDE_DIRS include ${OPENGL_INCLUDE_DIR}
  LIBRARIES foo ${OPENGL_LIBRARIES}
  CATKIN_DEPENDS roscpp
  DEPENDS Boost
)

..

  在这个例子中，你可以看到我（调用了）find_package(Boost...)，并在DEPENDS 部分传递了它，因为它产生了兼容的CMake变量。虽然我（调用了）find_package(PythonLibs...)并在内部使用了它，但是因为它不在我暴露的任何头文件中，所有不需要一起传递。虽然我（调用了） find_package(OpenGL...)，但是因为它产生了不兼容的CMake变量，所以我将它明确地传递给 INCLUDE_DIRS 和 LIBRARIES。最后，我（调用了）find_package(catkin...rosconsole roscpp)，并在内部使用，但是可能我只在我的.c*文件使用了rosconsole，因此我不需要传递它，所以在CATKIN_DEPENDS变量中我只放了roscpp。
  
  最后一个例子，如果一个package直接使用一个像Boost这样的依赖，它们应该确保通过find_package(...)显式地查找它，并且它们不能通过其他package隐式依赖于它。
  
  发生这种情况的一个例子是，如果一个软件包packagefoo将Boost作为依赖项导出，还有一个依赖于foo的软件包packagebar，但也在内部使用Boost，那么bar将在没有显示依赖Boost的情况下也能正常编译。但是后来foo可能决定重构并删除它对 Boost 的依赖。此刻bar将无法编译，因为它不再具有通过foo对 Boost 的隐式依赖。

  1. ROS.org. ROS教程[EB/OL]. 2020-12-22[2022-7-5].
    http://wiki.ros.org/cn/ROS/Tutorials. ↩︎

  2. ROS.org. CMakeLists.txt[EB/OL]. 2019-07-25[2022-07-05].
    http://wiki.ros.org/catkin/CMakeLists.txt. ↩︎ ↩︎

您可能感兴趣的与本文相关的镜像

Python3.10

Python3.10

Conda
Python

Python 是一种高级、解释型、通用的编程语言，以其简洁易读的语法而闻名，适用于广泛的应用，包括Web开发、数据分析、人工智能和自动化脚本

【ROS2】package.xml 和 CMakeLists.txt 详解，并添加Qt依赖库
郭老二
10-22 779
1） package.xml的作用ROS2中 使用 colcon 来构建工程。colcon 会读取 package.xml 文件中的信息，以确定唯一的包名、使用的构建工具、依赖包等。每个包的具体编译方法，使用 CMakeLists.txt 来描述。详见CMake的使用方法。
ros2/ros1中的cmakelists.txt文件解释
12-21 1196
nodeletnodeletExample:PREFIX "")toimage_viewExample:Example:myProgramSyntax:Example:.........)
ROS-CMakeLists.txt文件
weixin_51568145的博客
06-17 2461
CMakeLists.txt 是一个用于构建 CMake 项目的配置文件。CMake 是一个跨平台的构建系统生成工具，用于管理和构建软件项目。CMakeLists.txt 文件是在 CMake 中定义项目的基本配置和构建规则的文本文件。CMakeLists.txt 文件通常位于项目的根目录，并包含一系列的 CMake 命令和指令。这些命令和指令描述了项目的源代码文件、依赖项、编译选项、链接库、可执行文件等信息，以及项目的构建方式和生成目标。
ROS之CMakeLists.txt 文件
cookie909的博客
03-26 712
 http://blog.csdn.net/u013243710/article/details/35795841 http://wiki.ros.org/catkin/CMakeLists.txt  文件CMakeLists.txt是用于构建软件包的CMake构建系统的输入。任何符合cmake的包都包含一个或多个CMakeLists。txt文件描述如何构建代码并将其安装到何处。 结构和机制1. ...
【CMakeLists.txt】 Qt 自动化构建配置详解
最新发布
weixin_43219667的博客
10-22 371
简化配置：无需手动调用等命令减少错误：自动处理依赖关系，避免遗漏 MOC/UIC/RCC 处理提高可维护性：CMakeLists.txt 文件更简洁清晰跨平台兼容：在不同平台上保持一致的构建行为这些设置大大简化了 Qt 项目的构建配置，是现代 Qt CMake 项目的标准做法。
rtab_map安装教程
Mantana的博客
03-01 1605
RTAB_map安装教程（官网链接：https://github.com/introlab/rtabmap_ros#installation） 1、安装： sudo apt-get install ros-kinetic-rtabmap-ros/ 2、设置环境变量： export LD_LIBRARY_PATH=$LD_LIBRARY_PATH:/opt/ros/kinetic/lib/x86_64-linux-gnu 3、设置路径： source /opt/ros/kinetic/setup.bash
CMakeLists.txt
anmin1992的专栏
09-08 262
示例(在编写CMakeLists.txt前, 创建好src, include, lib, bin, build目录, 其中cmake ..在build目录中执行) # 一般都会先声明cmake的版本 CMAKE_MINIMUM_REQUIRED(VERSION 2.8) PROJECT(hello_world) # Release 和 Debug IF(NOT CMAKE_BUILD_...
ROS中的CMakeLists.txt
Chunyes的专栏
07-18 518
ROS中的CMakeLists.txt
【ROS】CMakeLists.txt文件解析
qq_52785580的博客
01-15 2077
这就是CMakeLists.txt文件的大部分主要功能的解析，其中还有一个generate_dynamic_reconfigure_options()函数没有说到，这个是根动态参数配置相关的，将会在介绍dynamic reconfigure的文章中说到。
ros2 功能包 CMakeLists.txt 结构详细解释
专注 激光SLAM, 目标检测, 欢迎关注, 分享交流！
10-07 1426
ROS2的CMakeLists.txt是构建系统的核心配置文件，负责编译、链接、安装及依赖管理。关键内容包括：声明CMake最低版本和项目名称；通过find_package查找ROS2依赖包；使用add_executable/add_library定义目标；ament_target_dependencies声明依赖关系；配置安装规则；最后必须调用ament_package()生成ROS2元数据。还需注意包名一致性、依赖传递和标准安装路径规范。完整配置应包含可执行文件/库定义、依赖声明、安装规则及可选的测试和
CMakeLists.txt详解
weixin_42301918的博客
05-14 7885
#声明使用的最低版本 cmake_minimum_required(VERSION 3.0) # 指定工程名 PROJECT (HELLO) # 现阶段，你只需要了解 SET 指令可以用来显式的定义变量即可 # 将 hello.cpp 赋值给 SRC_LIST 变量，也可以指定多个源文件，用空格隔开 # SET(SRC_LIST test01.cpp test02.cpp sub.cpp hello.cpp) SET(SRC_LIST hello.cpp) ##使用MESSAGE向屏幕输出信息，STA
ROS之CMakeLists
mko_li的博客
05-26 1146
文章为个人在学习ROS中遇到的问题的总结及理解，如有错误，欢迎留言指出。
ROS中的CMakelists
buzaishihaizi的博客
11-13 1426
CMakeLists.txt 在ROS的编程过程中，如果CMakeLists.txt如果写不好，编译就很难成功。如果看不懂CMakeLists.txt那么很多错误你也不知道时什么回事。所以深入了解它是很右必要的。现在我们就来看看它。 我们使用cmake进行程序编译的时候，会根据CMakeLists.txt这个文件进行一步一步的处理，然后形成一个MakeFile文件，系统再通过这个文件的设置进行
ros的CMakeLists详解
windistance的博客
01-12 4881
文件结构 CMakeListx.txt文件必须准守下面的这些守则，否则的话，程序包将不能被正确的构建。在配置文件中，下面的顺序很重要。 Required CMake Version (cmake_minimum_required) Package Name (project()) Find other CMake/Catkin packages needed for b...
CMakelists.txt
limin0108的专栏
08-12 1064
CMAKE_MINIMUM_REQUIRED(VERSION 2.6) PROJECT(name C CXX) INCLUDE(FindPkgConfig) SET(VERSION_MAJOR 0) SET(VERSION "${VERSION_MAJOR}.1.0") SET(PREFIX ${CMAKE_INSTALL_PREFIX}) SET(EXEC_PREFIX ${PR
ROS中CMakeLists.txt文件详解
weixin_43956732的博客
06-01 3728
这篇文章是有关ROS中catkin CMakeLists.txt使用的内容。 CMakeList.txt文件是CMake编译系统编译软件包过程的输入文件。任何CMake兼容包都包含一个或多个CMakeLists.txt文件，这些文件描述了如何编译代码以及将其安装到哪里。将CMakeLists.txt文件应用于一个catkin项目时，它就作为一个标准的附带一些限制条件的vanilla CMakeLists.txt文件。使用CMake编译程序时，cmake指令依据CMakeLists.txt 文件生成makef
ROS1&ROS2之CmakeList.txt和package.xml用法详解
MGodmonkey的专属博客
07-26 7173
目前还在学习ROS+无人机框架中，，，更多更新文章详见我的个人博客主页【
ROS下CMakeLists.txt文件解析
gaoziqunde的博客
06-01 1078
从gcc到make再到cmake以及catkin解析参考make和cmake简要介绍_make cmake-优快云博客catkin是ROS官方自定义的编译系统，它的原理与流程与Cmake很相似，和老版本rosbuild相比，支持更好的可移植性（catkin结合了可移植性好的CMake和python）以及交叉编译。（在ROS2使用的编译工具是ament，它是由catkin优化迭代而来的版本）。知乎 - 安全中心。
ROS——CMakeLists.txt总结
pmj110119的博客
10-24 445
1. Package name project(robot_brain) 项目名需与package名一致。 2. Finding Dependent CMake Packages find_package(catkin REQUIRED COMPONENTS nodelet) 利用find_package()语法，将此package所依赖的其他package，以components形...
CMake Error: The current CMakeCache.txt directory /home/lmw/dev_ws/ydlidar_ros2_ws/build/ydlidar_ros2_driver/CMakeCache.txt is different than the directory /home/yahboom/ydlidar_ws/build/ydlidar_ros2_driver where CMakeCache.txt was created. This may result in binaries being created in the wrong place. If you are not sure, reedit the CMakeCache.txt CMake Error: The source "/home/lmw/dev_ws/ydlidar_ros2_ws/src/ydlidar_ros2_driver/CMakeLists.txt" does not match the source "/home/yahboom/ydlidar_ws/src/ydlidar_ros2_driver/CMakeLists.txt" used to generate cache. Re-run cmake with a different source directory.
07-07
<think>我们正在解决一个特定的CMake错误：CMake Error: Current CMakeCache.txt directory does not match the original directory 这个错误通常发生在以下情况： 1. 用户移动了构建目录（build directory）的位置。 2. 用户重命名了构建目录。 3. 用户复制了构建目录到另一个位置。 原因分析： CMake在构建目录中生成一个CMakeCache.txt文件，该文件记录了原始构建目录的绝对路径。当CMake再次运行时，它会检查当前目录是否与缓存中记录的目录一致。如果不一致，就会报此错误。 解决方案： 1. 最彻底的方法：清除构建目录并重新配置。 删除整个构建目录（或者至少删除CMakeCache.txt和CMakeFiles目录），然后重新运行cmake。 2. 如果不想重新配置（例如，配置过程耗时很长，或者有自定义的设置），可以尝试手动修改CMakeCache.txt文件中的路径： 打开CMakeCache.txt，找到包含原始路径的变量（如CMAKE_CACHEFILE_DIR），将其修改为当前目录的路径。 3. 如果构建目录只是被移动到了同一台机器上的另一个位置，并且你希望保留之前的配置，可以尝试使用sed（在Linux/macOS）或文本编辑器（在Windows）来替换所有旧路径为新路径。 4. 另一种情况：构建目录是符号链接（symbolic link）的目标，而实际路径没有改变，但CMake可能因为符号链接而认为路径改变。这时，可以尝试使用真实路径（realpath）来构建，或者删除缓存重新生成。 但是，请注意：手动修改缓存文件可能很复杂，因为缓存文件中可能有多个地方记录了旧路径。因此，通常建议重新生成缓存。 步骤详解： 方法1：清除并重新配置（推荐） ```bash # 在构建目录的父目录中执行 rm -rf build # 删除整个构建目录 mkdir build # 重新创建构建目录 cd build cmake .. # 重新运行CMake配置 ``` 方法2：手动修改缓存（适用于高级用户） 在CMakeCache.txt中，查找旧路径并替换为新路径。注意，旧路径可能以多种形式出现（绝对路径、转义路径等）。主要修改以下变量： - CMAKE_CACHEFILE_DIR:INTERNAL - 以及其他所有包含旧路径的变量（如项目特定的变量） 例如，旧路径为`/old/path/build`，新路径为`/new/path/build`，则使用sed命令（在Linux/macOS）： ```bash sed -i 's|/old/path/build|/new/path/build|g' CMakeCache.txt ``` 在Windows上，可以用文本编辑器替换。 但是，这种方法可能不彻底，因为有些路径可能被编码或出现在多个地方。因此，如果替换后仍然出错，建议使用方法1。 方法3：使用CMake的-U选项清除特定缓存变量（不常用） 可以尝试清除导致问题的特定变量，但通常很难确定是哪些变量，所以不推荐。 预防措施： 1. 避免移动或重命名构建目录。如果需要，请删除并重新生成。 2. 在构建目录中使用CMake时，确保工作目录没有改变。 引用说明： 在CMake的文档中，关于缓存文件的路径匹配检查是为了确保构建目录的一致性，避免因路径改变导致的构建问题[^1]。 相关问题： §§相关问题§§ 1. CMake缓存文件（CMakeCache.txt）的作用是什么？ 2. 如何安全地移动CMake构建目录？ 3. 除了路径不一致，还有哪些常见的CMake缓存错误？ 4. 如何强制CMake重新生成缓存文件？ 5. CMake构建目录中哪些文件可以安全删除？</think>### 解决CMake缓存路径不一致错误 当出现`CMake Error: Current CMakeCache.txt directory does not match the original directory`错误时，通常是由于构建目录位置改变或缓存文件残留导致。以下是完整解决方案： #### 🔧 核心解决步骤 1. **彻底清除缓存**（推荐首选方案） 删除整个`build`目录并重新配置： ```bash rm -rf build # 删除旧构建目录 mkdir build && cd build cmake .. # 重新生成配置 ``` > 这是最可靠的解决方案，能100%解决路径不一致问题[^1] 2. **手动更新缓存路径**（适用于保留配置的场景） 在`CMakeCache.txt`中修改关键变量： ```cmake # 修改前 CMAKE_CACHEFILE_DIR:INTERNAL=/old/path/build # 修改后 CMAKE_CACHEFILE_DIR:INTERNAL=/new/path/build ``` 同时全局替换所有旧路径引用： ```bash sed -i 's|/old/path|/new/path|g' CMakeCache.txt ``` #### ⚠️ 常见触发场景及应对 | 场景 | 现象 | 解决方案 | |------|------|----------| | 移动构建目录 | 物理位置改变 | 必须删除缓存或更新所有路径引用 | | 分支切换 | Git操作导致路径变化 | 使用`git clean -xdf`清理构建目录 | | 共享缓存 | 多机器共用缓存文件 | 禁用缓存共享：`cmake -DCMAKE_CACHE_DISABLE=ON` | | 符号链接 | 通过链接访问构建目录 | 使用真实路径：`cmake -B $(realpath build)` | #### 🛠️ 高级调试技巧 1. **检查缓存版本兼容性** 在`CMakeLists.txt`首行添加： ```cmake cmake_minimum_required(VERSION 3.20) # 匹配当前CMake版本 ``` 2. **强制刷新缓存** ```bash cmake -U 'CMAKE_*' .. # 清除所有缓存变量 cmake --fresh .. # CMake 3.24+ 专用刷新命令 ``` 3. **诊断缓存文件** 使用`cmake -L`列出所有缓存变量，检查路径相关项： ```bash cmake -L | grep -E "DIR|PATH" ``` > **预防措施**：在版本控制中忽略构建目录（`.gitignore`添加`build/`），避免意外提交缓存文件[^1]
评论
成就一亿技术人!
拼手气红包6.0元
还能输入1000个字符
 
红包 添加红包
表情包 插入表情
表情包 代码片
 条评论被折叠 查看
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

当前余额3.43元 前往充值 >
需支付：10.00元
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付元
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明：

1.余额是钱包充值的虚拟货币，按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载，可以购买VIP、付费专栏及课程。

余额充值