add_library,target_link_libraries,set_target_properties,target_link_libraries使用联系

本文介绍如何使用CMake在Linux环境下构建一个名为libsugan的静态库,并链接OpenCV等依赖库。文章详细展示了CMakeLists.txt配置文件的具体写法,包括设置编译选项、查找外部库、指定源文件及最终生成静态库的过程。

摘要生成于 C知道 ,由 DeepSeek-R1 满血版支持, 前往体验 >

折腾了半下午,终于知道这个货是怎么个关系了。在此写下记录,希望遇到同样问题的同学,不要再次浪费时间了。

首先我是在Linux环境下

先列出我的CmakeLists.txt

注意,在CmakeLists.txt 里,注释用的是#


project(Camera_sugan)         #工程名字
cmake_minimum_required(VERSION 2.6)    #编译最低cmake版本
set( CMAKE_CXX_FLAGS "${CMAKE_CXX_FLAGS} -std=c++11" )   #设置c++编译器

find_package(OpenCV REQUIRED)    #在整个电脑上找opencv包

include_directories(                                 #包含头文件路径
    ./include/inudev/
    ./src/
)

set(SRC_LISTS                                          #将所有的源文件列为一个集合,集合名字叫做SRC_LISTS
    ./src/inuitive.cpp
    ./src/runCamera_Qfeeltech.cpp
)

add_library(libsugan ${SRC_LISTS})    #将集合里的所有的源文件生成一个静态库,该静态库的名字libsugan,注意,在整个CmakeLists里都要用libsugan这个

                                                                        #名字来代替之前那个集合生成的库。
target_link_libraries(libsugan                  #链接静态库需要的依赖库
    ${OpenCV_LIBS}
    ${PROJECT_SOURCE_DIR}/lib/libCommonUtilities.so
    ${PROJECT_SOURCE_DIR}/lib/libInuStreams.so
)
#到此为止就在程序中生成了一个名字为libsugan的静态库,但是我们知道Linux下对库的存储格式是lib+name.a,所以我们生成的静态库名字为libsugan,那么

#存储出来的结果就是liblibsugan.a,看着很别扭,为了大众点,我们用下面这句,保证了存储出来的静态库叫做libsugan.a,

#但是请千万注意,在整个CmakeLists.txt里

#如果想链接生成的这个库必须使用    “add_library(libsugan ${SRC_LISTS})”指明的名字。
set_target_properties(libsugan PROPERTIES OUTPUT_NAME "sugan")

add_executable(demo ./src/main.cpp)
target_link_libraries(demo libsugan)




<think>我们正在讨论CMake中的`target_link_libraries`命令和RPATH的配置方法。根据提供的引用,我们可以总结如下: 1. **target_link_libraries命令**:用于指定目标(可执行文件或库)所链接的库。该命令可以指定链接的可见性(PRIVATE, PUBLIC, INTERFACE),这些关键字决定了链接依赖的传播方式。 - PRIVATE:依赖项仅用于当前目标的构建,不会传播给依赖此目标的其他目标。 - PUBLIC:依赖项既用于当前目标的构建,也会传播给依赖此目标的其他目标。 - INTERFACE:依赖项不用于当前目标的构建,但会传播给依赖此目标的其他目标。 2. **RPATH配置**:RPATH是存储在可执行文件或动态库中的运行时搜索路径。在CMake中,可以通过设置目标属性来配置RPATH,常用的属性有: - `INSTALL_RPATH`:指定安装后的目标运行时搜索的路径。 - `BUILD_WITH_INSTALL_RPATH`:在构建过程中使用安装后的RPATH(通常用于测试安装后的行为)。 根据引用[1],我们可以使用`set_target_properties`命令来设置RPATH,例如: ```cmake set_target_properties(example PROPERTIES INSTALL_RPATH "/usr/local/lib") ``` 此外,引用[2]提到了`target_link_directories`命令,它用于向目标添加链接目录,但注意这个命令添加的是链接时搜索库的目录,而不是运行时搜索路径(RPATH)。 引用[3]强调了正确理解`target_link_libraries`中PRIVATE、PUBLIC和INTERFACE的重要性,避免误解。 现在,我将详细解释如何结合使用`target_link_libraries`和配置RPATH。 ### 步骤1:使用`target_link_libraries`链接库 假设我们有一个可执行文件`myapp`,它依赖于一个外部库`mylib`(位于`/path/to/mylib`)。在CMakeLists.txt中,我们可以这样写: ```cmake add_executable(myapp main.cpp) # 指定链接库,并设置可见性(例如PUBLIC) target_link_libraries(myapp PUBLIC mylib) ``` ### 步骤2:配置RPATH 在构建过程中,CMake默认会为可执行文件设置RPATH,使其包含构建目录中库的路径。但在安装时,我们可能需要改变RPATH,使其指向安装目录下的库路径。 #### 方法1:设置目标的RPATH属性 我们可以使用`set_target_properties`来设置RPATH属性: ```cmake # 设置安装后的RPATH set_target_properties(myapp PROPERTIES INSTALL_RPATH "/usr/local/lib") ``` #### 方法2:使用CMake的RPATH相关变量 CMake提供了一些全局变量来控制RPATH行为,例如: - `CMAKE_INSTALL_RPATH`:设置安装目标的RPATH。 - `CMAKE_BUILD_WITH_INSTALL_RPATH`:在构建时使用安装RPATH(通常为OFF,构建时使用构建树的RPATH)。 示例: ```cmake set(CMAKE_INSTALL_RPATH "/usr/local/lib") ``` #### 方法3:使用`INSTALL`命令时设置RPATH 在安装目标时,也可以使用`INSTALL`命令的`RPATH`选项,但通常使用上述属性设置更常见。 ### 完整示例 以下是一个完整的CMakeLists.txt示例: ```cmake cmake_minimum_required(VERSION 3.10) project(MyProject) add_executable(myapp main.cpp) # 链接库,假设mylib是一个外部库,需要提前通过find_package或指定路径找到 # 这里假设已经通过find_library找到了mylib,并存储在变量MYLIB中 target_link_libraries(myapp PUBLIC ${MYLIB}) # 设置安装后的RPATH set_target_properties(myapp PROPERTIES INSTALL_RPATH "/usr/local/lib" # 如果希望构建时也使用安装RPATH(通常不需要,除非测试安装行为) # BUILD_WITH_INSTALL_RPATH ON ) # 安装目标 install(TARGETS myapp DESTINATION bin) ``` ### 注意事项 - 在构建时,CMake默认会添加构建目录下的库路径到RPATH,这样可执行文件在构建树中可以直接运行。 - 安装时,如果设置了`INSTALL_RPATH`,则安装后的可执行文件会使用该RPATH。如果没有设置,CMake默认会清除RPATH(可以通过设置`CMAKE_SKIP_INSTALL_RPATH`为OFF来改变)。 - 可以使用工具(如`chrpath`或`patchelf`)来查看或修改已生成的可执行文件的RPATH。 ### 验证RPATH 在Linux上,可以使用`readelf -d <可执行文件>`或`objdump -x <可执行文件> | grep RPATH`来查看RPATH设置。 ### 相关问题 1. 在CMake中,如何为不同的目标设置不同的RPATH? 2. 如何移除可执行文件中的RPATH? 3. 在跨平台开发中,如何处理Windows和Linux上的动态库路径问题? 4. 如何让CMake在构建时使用相对路径设置RPATH,以便于可执行文件在构建树中移动? 5. 使用`target_link_libraries`时,PRIVATE和PUBLIC有什么区别?请举例说明。</think>### CMake `target_link_libraries` 与 RPATH 配置详解 #### 1. **`target_link_libraries` 基础用法** `target_link_libraries` 用于指定目标(可执行文件/库)的链接依赖关系,其语法为: ```cmake target_link_libraries(<target> [PRIVATE|PUBLIC|INTERFACE] <library>... ) ``` - **PRIVATE**:依赖项仅用于构建当前目标,不传播给依赖此目标的其他目标。 示例:`target_link_libraries(myapp PRIVATE libA)` `libA` 仅链接到 `myapp`,不会影响其他依赖 `myapp` 的目标。 - **PUBLIC**:依赖项既用于当前目标,也传播给依赖此目标的其他目标。 示例:`target_link_libraries(mylib PUBLIC libB)` `libB` 会链接到 `mylib`,且任何链接 `mylib` 的目标(如 `myapp`)也会自动链接 `libB`。 - **INTERFACE**:依赖项不用于当前目标,仅传播给依赖此目标的目标。 示例:`target_link_libraries(mylib INTERFACE libC)` `libC` 不会链接到 `mylib`,但链接 `mylib` 的目标(如 `myapp`)会自动链接 `libC`[^3]。 #### 2. **RPATH 配置方法** RPATH 是嵌入在可执行文件中的运行时库搜索路径。在 CMake 中配置 RPATH 的关键步骤: ##### (1) **设置目标属性** 使用 `set_target_properties` 配置 RPATH: ```cmake set_target_properties(myapp PROPERTIES INSTALL_RPATH "/usr/local/lib;/custom/lib" # 安装后的 RPATH BUILD_WITH_INSTALL_RPATH ON # 构建时使用 INSTALL_RPATH ) ``` - `INSTALL_RPATH`:指定安装后运行时搜索库的路径列表(分号分隔)。 - `BUILD_WITH_INSTALL_RPATH`:确保构建目录中的可执行文件直接使用安装后的 RPATH[^1]。 ##### (2) **全局 RPATH 设置** 通过 CMake 变量控制默认行为: ```cmake set(CMAKE_INSTALL_RPATH "/opt/libs") # 所有目标的默认安装 RPATH set(CMAKE_INSTALL_RPATH_USE_LINK_PATH TRUE) # 自动添加链接器路径到 RPATH ``` #### 3. **完整示例 ```cmake cmake_minimum_required(VERSION 3.10) project(MyApp) add_executable(myapp main.cpp) # 链接库并指定可见性 target_link_libraries(myapp PUBLIC lib_public # 传播给依赖者 PRIVATE lib_private # 仅当前目标使用 ) # 配置 RPATH set_target_properties(myapp PROPERTIES INSTALL_RPATH "/usr/local/lib;${CMAKE_INSTALL_PREFIX}/lib" BUILD_WITH_INSTALL_RPATH ON ) # 安装目标 install(TARGETS myapp DESTINATION bin) ``` #### 4. **关键注意事项** 1. **RPATH 优先级**: RPATH 的搜索优先级高于系统默认路径(如 `/usr/lib`),但低于 `LD_LIBRARY_PATH`。 2. **调试 RPATH**: 使用 `readelf -d myapp | grep RPATH`(Linux)或 `otool -l myapp | grep RPATH`(macOS)检查嵌入路径。 3. **避免硬编码路径**: 用 `$ORIGIN` 表示相对路径(Linux/macOS),例如: ```cmake set_target_properties(myapp PROPERTIES INSTALL_RPATH "$ORIGIN/../lib") ``` 这样库文件可放在可执行文件相邻的 `../lib` 目录中。 #### 5. **常见问题解决** - **运行时找不到库**: 检查 `INSTALL_RPATH` 是否包含库的实际安装路径,并确认 `BUILD_WITH_INSTALL_RPATH=ON`。 - **链接传播错误**: 若依赖关系未正确传递,检查 `PUBLIC/PRIVATE/INTERFACE` 的使用: - 库头文件需要依赖 → 用 `PUBLIC` - 仅源文件需要依赖 → 用 `PRIVATE`[^3]。 --- ### 相关问题 1. 如何在 CMake 中为不同平台(Linux/macOS/Windows)配置动态库搜索路径? 2. `target_link_directories` 和 `link_directories` 有何区别?如何正确使用[^2]? 3. 如何让 CMake 自动将构建目录中的库路径添加到 RPATH? 4. 在交叉编译场景下如何配置 RPATH? 5. `PRIVATE/PUBLIC/INTERFACE` 在 `target_include_directories` 和 `target_link_libraries` 中的行为有何异同[^3]? [^1]: 引用自 CMake 官方文档:`set_target_properties` 的 RPATH 配置。 [^2]: 引用自 CMake 命令详解:`target_link_directories` 的使用方法。 [^3]: 引用自 CMake 实践指南:`target_link_libraries` 的可见性说明。
评论 1
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

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

抵扣说明:

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

余额充值