Linux动态链接那点事儿（`cmake find_package，linux shared library`路径详解）

最新推荐文章于 2025-07-03 16:08:35 发布
原创 最新推荐文章于 2025-07-03 16:08:35 发布 · 1.3k 阅读 · 4 ·
CC 4.0 BY-SA版权
版权声明：本文为博主原创文章，遵循 CC 4.0 BY-SA 版权协议，转载请附上原文出处链接和本声明。

Motivation

经常在Linux下面写C++程序，尤其是需要集成各种第三方库的工程，肯定对find_package指令不陌生。

这是条很强大的指令。可以直接帮我们解决整个工程的依赖问题，自动把头文件和动态链接文件配置好。比如说，在Linux下面工程依赖了OpenCV，只需要下面几行就可以完全配置好：

add_executable(my_bin src/my_bin.cpp)
find_package(OpenCV REQUIRED)
include_directories(${OpenCV_INCLUDE_DIRS})
target_link_libraries(my_bin, ${OpenCV_LIBS})

工作流程如下：

  1. find_package在一些目录中查找OpenCV的配置文件。
  2. 找到后，find_package会将头文件目录设置到${OpenCV_INCLUDE_DIRS}中，将链接库设置到${OpenCV_LIBS}中。
  3. 设置可执行文件的链接库和头文件目录，编译文件。

到现在为止出现了第一个问题。那就是：
find_package会在哪些目录下面寻找OpenCV的配置文件？

find_package目录

为什么我们要知道这个问题呢？因为很多库，我们都是自己编译安装的。比如说，电脑中同时编译了OpenCV2和OpenCV3，我该如何让cmake知道到底找哪个呢？

其实这个问题在

最低0.47元/天 解锁文章

200万优质内容无限畅学
Linux中编写并使用Shared Library
白马负金羁
04-01 1万+
Linux中的shared libraries 文件为共享库，与windows下dll类似，是动态加载的。在链接动态库生成可执行文件时，并不会把动态库的代码复制到执行文件中，而是在执行文件中记录对动态库的引用。本文介绍在Linux中用C语言编写动态链接库并在C/C++中调用.so文件的方法
CMake入门教程【核心篇】链接库(target_link_libraries)
小鱼酱的博客
01-02 3895
CMake链接库(target_link_libraries)
CMake和Linux编程：find_package的使用
weixin_33812433的博客
07-11 440
1.第一个CMake例子 　　在 t1 目录建立 main.c 和 CMakeLists.txt(注意文件名大小写)：　　main.c 文件内容： //main.c #include <stdio.h> int main() { printf(“Hello World from t1 Main!n”); return 0; } 　Cmake...
CMake 里常见的几种库和目标类型
is0815的博客
07-03 274
类型生成文件代码位置运行时依赖用途静态库.a.lib代码打包成库无代码封装，独立运行动态库.so.dll.dylib代码打包成库依赖动态库文件共享库，减少磁盘和内存占用接口库无只传递接口信息无传递头文件路径、宏、依赖等配置对象库目标文件.o（无库文件）生成中间目标文件无编译复用中间文件，构建复杂库。
安装linux后找不到系统文件夹,CMake安装库到系统文件夹并被find_package找到
weixin_39926014的博客
05-01 475
大家经常在网上使用一些别人写好的库，大概步骤是先用github下载下来，在库的源文件夹中使用如下命令安装cd mkdir buildcd buildcmake ..makesudo make install通过上面的一系列命令就把这个库安装到系统里了。如果我们在写其他C程序中调用了该库，那么我们就需要在编译该程序的CMakeLists中写如find_package(libABC REQUIRED)...
error while loading shared libraries .so 动态库路径设置
evolay的专栏
07-24 146
./a.out: error while loading shared libraries: lib???.so.9: cannot open shared object file: No such file or directory 解决方法： cp libxxx.so.9 /usr/local/lib/ echo "/usr/local/lib" >> /etc/ld.so.conf ldconfig
linux 静态 链接库,Linux下静态链接库和动态链接库的创建与使用
weixin_42354992的博客
05-14 340
1 创建链接库使用简单的一个函数来实现链接库功能，函数实现如下：library.cpp文件：#include "library.h"#include void hello() {std::cout << "Hello, library World!" << std::endl;}library.h文件：#ifndef LIB_PUBLISHER_LIBRARY_H#defi...
cmake添加查找目录_cmake find_package路径详解
weixin_36414025的博客
01-17 4077
Motivation经常在Linux下面写C++程序，尤其是需要集成各种第三方库的工程，肯定对find_package指令不陌生。这是条很强大的指令。可以直接帮我们解决整个工程的依赖问题，自动把头文件和动态链接文件配置好。比如说，在Linux下面工程依赖了OpenCV，只需要下面几行就可以完全配置好：add_executable(my_bin src/my_bin.cpp)find_package...
cmake用法详解
weixin_41541150的博客
12-20 2007
1.cmake用法详解 ①编写CMakeLists.txt ②执行cmake PATH生成Makefile（PATH是cmakelists.txt所在路径） ③make编译 假设我们的项目中只有一个源文件main.cpp，CMakeLists.txt文件如下所示： 1 PROJECT(main) 2 CMAKE_MINIMUM_REQUIRED(VERSION 2.6) //...
Linux - CMake详细教程
几度春风里的博客
03-12 5186
本文详细的介绍了CMake是开源、跨平台的构建工具，可以让我们通过编写简单的配置文件去生成本地的Makefile。
linux的链接库
杰特JET的博客
03-24 923
linux的链接库概述静态链接库共享函数库动态加载函数库如何指定链接的是动态库还是静态库？链接库的顺序静态库链接问题gcc链接参数库链接参数`--whole-archive``--no-whole-archive``--wrap``–start-group` `--end-group`ldcc动态链接库参考链接 概述 程序函数库可分为3种类型：静态函数库（static libraries）、共享函数库（shared libraries）、动态加载函数库（dynamically loaded librari
Linux link 错误error while loading shared libraries
fengshengwei3的专栏
12-20 328
目录 一背景 二.问题分析 1.定位问题 2. Linux下的常识 三 解决问题 1.首先介绍一个变量$LD_LIBRARY_PATH 2.如何解决 3.解决一下 一背景 自己写了一个库，然后写了一个demo去调用，调用的时候提示 ./test: error while loading shared libraries: xxx.so.0:cannot open s...
cmake 生成、使用动态库和 linux 动态库路径(LD_LIBRARY_PATH)
laidene的博客
03-26 1904
【代码】cmake 生成、使用动态库和 linux 动态库路径(LD_LIBRARY_PATH)
cmake:find_package查找pthread for win32的实现脚本
10km的专栏
10-09 1557
pthread for win32本身没有提供find_package脚本，cmake官方也没有提供，所以如果在cmake中要查找pthread for win32的库，就得自己实现，我参照FindJPEG.cmake自己写了个查找脚本FindPTHREADW32。 cmake官方提供的FindJPEG.cmake非常简单，只输出了include文件夹位置和JPEG库文件(JPEG_INCLUDE...
C++学习—— CMake找不到LD_LIBRARY_PATH的so文件
m0_37876745的博客
09-13 2822
C++学习——CMAKE找不到LD_LIBRARY_PATH的so文件
CMake库搜索函数居然不搜索LD_LIBRARY_PATH
「 虚幻私塾」
07-30 414
本文通过编译后运行找不到库文件的问题引入，首先分析了find_package(JNI)的工作流程，而后针对cmake不搜索LD_LIBRARY_PATH的问题，提出了一种通用的解决办法。本文分享自华为云社区《
LD_LIBRARY_PATH的设定
weixin_33906657的博客
09-27 235
LD_LIBRARY_PATH的设定 变量LD_LIBRARY_PATH 是用来在Linux下设置动态链接库(*.so)的查找路径，我们一般情况下都需要在运行一个带有动态链接库的程序是运行 export LD_LIBRARY_PATH=. 否则就会出现 ./pcs: symbol lookup error: ./pcs: undefined symbol: _ZN4ut...
Linux共享库简单总结
一名热爱技术的工程师的博客。分享技术干货，记录美好生活。永远相信美好的事情即将发生。
12-25 2847
库静态库编译的二进制会重新包含一份静态库的副本共享库编译gcc -shared -o file.c-fPIC链接ldld-linux.so.2可执行程序–>动态依赖表流程：程序运行–>加载ld-linux.so.2–>搜索动态库路径寻–>路径下根据动态链接表搜索动态库 –> 搜索相应符号链接加载至内存执行符号链接覆盖：简单的说是两个同名的函数具有相同的符号链接则会绑定第一次搜索到的符号链接函数程序运
交叉编译不能执行怎么办xy-shiqi@xyshiqi-vmware:~/ros2_ws/src/only-navigaton$ cd ~/ros2_ws rm -rf build_arm install_arm log xy-shiqi@xyshiqi-vmware:~/ros2_ws$ unset LD_LIBRARY_PATH xy-shiqi@xyshiqi-vmware:~/ros2_ws$ source /opt/poky/3.1.20/environment-setup-aarch64-poky-linux source /opt/ros/humble/setup.bash xy-shiqi@xyshiqi-vmware:~/ros2_ws$ source /opt/poky/3.1.20/environment-setup-aarch64-poky-linux Your environment is misconfigured, you probably need to 'unset LD_LIBRARY_PATH' but please check why this was set in the first place and that it's safe to unset. The SDK will not operate correctly in most cases when LD_LIBRARY_PATH is set. For more references see: http://tldp.org/HOWTO/Program-Library-HOWTO/shared-libraries.html#AEN80 http://xahlee.info/UnixResource_dir/_/ldpath.html xy-shiqi@xyshiqi-vmware:~/ros2_ws$ source /opt/poky/3.1.20/environment-setup-aarch64-poky-linux Your environment is misconfigured, you probably need to 'unset LD_LIBRARY_PATH' but please check why this was set in the first place and that it's safe to unset. The SDK will not operate correctly in most cases when LD_LIBRARY_PATH is set. For more references see: http://tldp.org/HOWTO/Program-Library-HOWTO/shared-libraries.html#AEN80 http://xahlee.info/UnixResource_dir/_/ldpath.html xy-shiqi@xyshiqi-vmware:~/ros2_ws$ source /opt/ros/humble/setup.bash xy-shiqi@xyshiqi-vmware:~/ros2_ws$ colcon build \ --build-base build_arm \ --install-base install_arm \ --merge-install \ --cmake-args \ -DCMAKE_TOOLCHAIN_FILE=/opt/poky/3.1.20/sysroots/x86_64-pokysdk-linux/usr/share/cmake/OEToolchainConfig.cmake Starting >>> only-navigaton --- stderr: only-navigaton CMake Error at /opt/ros/humble/share/ament_cmake/cmake/ament_cmake_export_dependencies-extras.cmake:21 (find_package): By not providing "Findament_cmake_export_interfaces.cmake" in CMAKE_MODULE_PATH this project has asked CMake to find a package configuration file provided by "ament_cmake_export_interfaces", but CMake did not find one. Could not find a package configuration file provided by "ament_cmake_export_interfaces" with any of the following names: ament_cmake_export_interfacesConfig.cmake ament_cmake_export_interfaces-config.cmake Add the installation prefix of "ament_cmake_export_interfaces" to CMAKE_PREFIX_PATH or set "ament_cmake_export_interfaces_DIR" to a directory containing one of the above files. If "ament_cmake_export_interfaces" provides a separate development package or SDK, be sure it has been installed. Call Stack (most recent call first): /opt/ros/humble/share/ament_cmake/cmake/ament_cmakeConfig.cmake:41 (include) CMakeLists.txt:31 (find_package) --- Failed <<< only-navigaton [0.54s, exited with code 1] Summary: 0 packages finished [0.76s] 1 package failed: only-navigaton 1 package had stderr output: only-navigaton xy-shiqi@xyshiqi-vmware:~/ros2_ws$
最新发布
07-16
<think>首先，用户的问题是关于ROS2交叉编译中的CMake错误："Could not find a package configuration file provided by 'ament_cmake' with any of the following names"。用户引用了几个参考，但我需要基于用户的实际问题来回答。 用户的问题："我想解决交叉编译过程中出现的CMake错误问题 请问ros2 cross compilation cmake error could not find package configuration file for ament_cmake_export_interfaces"。这似乎是用户真正的需求。 从系统级指令： - 所有行内数学表达式用$...$。 - 独立公式用$$...$$并单独成段。 - 使用中文回答。 - 生成相关问题。 - 回答中引用的段落末尾自然地添加引用标识。 用户可见层指令： - 回答结构清晰，帮助用户逐步解决问题。 - 尽量保证回答真实可靠。 参考的引用： - [^1]: Could not find a package configuration file provided by "ament_cmake" with any of the following names. - [^2]: 在CMAKELists文件中也需要修改，详细可参考详解使用ament_cmake构建ROS2功能包... 包括add_executable, ament_target_dependencies等。 - [^3]: 对比ROS1和ROS2的turtlesim包，分析差异。 这些引用似乎与用户的问题相关，但用户的问题是关于交叉编译中的CMake错误。用户提到"交叉编译"，所以错误可能是在交叉编译环境中出现的。 关键错误：Could not find package configuration file for 'ament_cmake_export_interfaces'。这类似于[^1]中的错误，但具体是'ament_cmake_export_interfaces'。 在ROS2中，ament_cmake是构建系统的核心部分。这个错误通常表示CMake找不到ament_cmake包，可能是因为环境变量设置不正确或缺少必要的依赖。 步骤解决： 1. **确认环境设置**：在交叉编译中，需要确保交叉编译工具链正确设置，并且ROS2的依赖在目标平台上可用。 2. **安装ament_cmake**：ament_cmake应该作为ROS2基础的一部分安装。如果缺少，可能需要安装它。 3. **检查CMakeLists.txt**：参考[^2]，确保CMakeLists.txt文件正确配置了ament_target_dependencies。 4. **设置环境变量**：在交叉编译时，需要设置如AMENT_PREFIX_PATH等环境变量来指向ROS2安装目录。 从用户引用[^2]，它展示了如何在CMakeLists.txt中使用ament_target_dependencies和安装目标。这可能是相关的。 用户的问题具体是'ament_cmake_export_interfaces'，这可能是ament_cmake的一个组件。错误消息表明CMake找不到这个包的配置文件。 可能的原因： - ament_cmake没有正确安装。 - 在交叉编译环境中，ROS2的路径没有正确设置。 - CMakeLists.txt中没有正确声明依赖。 解决方案： 1. **安装ament_cmake**：确保在主机系统上安装了ROS2的ament_cmake包。可以使用包管理器如apt安装。 - 例如，在Ubuntu上：`sudo apt install ros-<distro>-ament-cmake` 2. **设置环境变量**：在交叉编译时，设置AMENT_PREFIX_PATH到ROS2的安装目录。 - 例如：`export AMENT_PREFIX_PATH=/path/to/ros2/install` 3. **修改CMakeLists.txt**：确保在CMakeLists.txt中，有find_package(ament_cmake REQUIRED)或类似语句。 - 参考[^2]，它使用了ament_target_dependencies，这依赖于find_package。 4. **交叉编译工具链**：确保工具链文件正确配置了路径。 结构回答： - 逐步解释问题原因。 - 提供解决方案步骤。 - 生成相关问题。 使用中文回答。 生成相关问题：基于用户问题，生成相关的问题，如优化交叉编译、常见错误等。 确保回答真实可靠：基于ROS2文档和常见实践。 最终回答结构： 1. 解释错误原因。 2. 提供解决步骤。 3. 引用相关引用（自然添加）。 4. 生成相关问题。</think>### ROS2交叉编译中的CMake错误解决方案 您在ROS2交叉编译过程中遇到的CMake错误："Could not find package configuration file provided by 'ament_cmake_export_interfaces'"，通常是由于ROS2构建系统（ament）的环境变量或依赖配置不正确导致的。这个错误在交叉编译环境中尤其常见，因为目标平台（如ARM设备）的依赖路径可能与主机系统不同。下面我将一步步解释原因并提供解决方案，帮助您修复问题。 #### 错误原因分析 - **核心问题**：CMake在交叉编译时无法定位`ament_cmake_export_interfaces`包的配置文件（通常是`ament_cmake_export_interfacesConfig.cmake`文件）。这通常是因为： - 环境变量（如`AMENT_PREFIX_PATH`）未正确设置，导致CMake找不到ROS2的安装目录。 - 交叉编译工具链未配置ROS2依赖路径，或主机系统缺少必要的ament组件。 - `CMakeLists.txt`文件中未正确定义ament依赖，或依赖声明不完整。 - **交叉编译特殊性**：在交叉编译中，ROS2的ament构建系统需要显式指定目标平台的路径，否则CMake默认搜索主机系统的路径，从而引发此类错误[^1]。 #### 解决步骤 以下是针对此错误的完整解决方案，基于ROS2官方文档和常见实践。请按顺序操作： 1. **确认并安装缺失的ament组件** 首先，确保主机系统（编译环境）安装了`ament_cmake`及其导出接口包。在终端中运行： ```bash # 安装ROS2基础构建工具（替换<distro>为您的ROS2发行版，如humble） sudo apt install ros-<distro>-ament-cmake ros-<distro>-ament-cmake-export-interfaces ``` 如果已安装，验证包路径： ```bash # 查找ament_cmake_export_interfaces配置文件 find /opt/ros/ -name "ament_cmake_export_interfacesConfig.cmake" ``` 正常输出应类似：`/opt/ros/<distro>/share/ament_cmake_export_interfaces/cmake/ament_cmake_export_interfacesConfig.cmake`。如果未找到，说明安装不完整，需重新安装ROS2基础包。 2. **设置交叉编译环境变量** 交叉编译时，必须显式设置`AMENT_PREFIX_PATH`，指向ROS2在目标平台的安装目录。在您的编译脚本或终端中添加： ```bash # 示例：假设ROS2已交叉编译安装到/path/to/ros2_install export AMENT_PREFIX_PATH="/path/to/ros2_install" export CMAKE_PREFIX_PATH="$AMENT_PREFIX_PATH:$CMAKE_PREFIX_PATH" ``` - **关键点**：`AMENT_PREFIX_PATH`必须包含目标平台的ROS2库路径。如果是嵌入式设备，确保该路径是设备上的有效路径（可通过交叉编译工具链同步）。 - 验证设置：运行`echo $AMENT_PREFIX_PATH`，确认输出正确。 3. **修改CMakeLists.txt文件** 参考您的项目配置[^2]，在`CMakeLists.txt`中添加或修正ament依赖声明： ```cmake cmake_minimum_required(VERSION 3.5) project(your_project) # 必须添加find_package，确保CMake能定位ament_cmake find_package(ament_cmake REQUIRED) find_package(ament_cmake_export_interfaces REQUIRED) # 显式声明缺失包 # 添加您的可执行文件（示例） add_executable(your_node src/your_node.cpp) # 使用ament_target_dependencies链接依赖 ament_target_dependencies( your_node "rclcpp" "std_msgs" "ament_cmake_export_interfaces" # 包含缺失包 ) # 安装和导出配置 install(TARGETS your_node DESTINATION lib/${PROJECT_NAME}) ament_package() ``` - **注意**：如果您的项目依赖其他ROS2包，在`ament_target_dependencies`中列出所有包名，确保顺序正确（基础包如`ament_cmake`在前）。 4. **配置交叉编译工具链文件** 创建一个工具链文件（如`toolchain.cmake`），指定目标平台和ROS2路径： ```cmake # toolchain.cmake 示例 set(CMAKE_SYSTEM_NAME Linux) # 目标平台系统 set(CMAKE_C_COMPILER /path/to/cross-compiler-gcc) # 交叉编译器路径 set(CMAKE_CXX_COMPILER /path/to/cross-compiler-g++) # 设置ROS2路径 set(AMENT_PREFIX_PATH "/path/to/ros2_install") list(APPEND CMAKE_PREFIX_PATH "${AMENT_PREFIX_PATH}") # 帮助CMake搜索包 set(CMAKE_FIND_ROOT_PATH "${AMENT_PREFIX_PATH}") set(CMAKE_FIND_ROOT_PATH_MODE_PACKAGE ONLY) ``` 编译时使用此文件： ```bash cmake -DCMAKE_TOOLCHAIN_FILE=/path/to/toolchain.cmake .. ``` 5. **测试与验证** 完成以上步骤后，重新运行CMake配置： ```bash rm -rf build/ # 清除旧构建 mkdir build && cd build cmake -DCMAKE_TOOLCHAIN_FILE=toolchain.cmake .. # 或直接使用环境变量 make ``` - 如果错误消失，说明配置成功。 - 如果仍报错，检查CMake输出日志，确认`ament_cmake_export_interfaces`的路径是否被正确引用。 #### 常见陷阱与预防 - **路径一致性**：交叉编译时，主机和目标平台的ROS2版本必须一致（如均为Humble），否则可能引发兼容性问题。 - **工具链兼容性**：确保交叉编译器支持C++17（ROS2要求），可通过`set(CMAKE_CXX_STANDARD 17)`在CMakeLists.txt中强制指定。 - **环境隔离**：使用Docker或虚拟环境避免主机污染，参考ROS2交叉编译最佳实践[^1]。 通过以上步骤，您应该能解决此CMake错误。如果问题持续，请提供更多上下文（如CMakeLists.txt内容或编译日志），我会进一步协助您。
评论 1
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

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

抵扣说明：

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

余额充值