《Clion开发C/C++系列》- CMAKE配置RPATH

前言

C/C++开发Linux程序时，有时候需要依赖第三方的so库，可是编译之后的产物，在运行起来的时候，该去哪里找之前编译期间的so库呢？

有好几种方案，我就说普遍的：

1. 在LD_LIBRARY_PATH环境变量里，加入你的so库的文件夹

2.在编译期间，指定运行时搜寻库的地址，可以是相对地址也可以是绝对地址

这个我也是尝试了好久，网络上的教程几乎都翻了个遍，都没用，后来被我尝试出来了：

关键

SET_TARGET_PROPERTIES(FFmpegLog PROPERTIES BUILD_RPATH "$ORIGIN/../;/another/run/path" LINK_FLAGS "-Wl,--disable-new-dtags")

这里面的 $ORIGIN 代表可运行文件本身，那么 $ORIGIN/../ 的意思是可执行文件相同的目录下，

如果有多个目录，用 ; 分开

最后的 LINK_FLAGS "-Wl,--disable-new-dtags" 是一定要添加的，我尝试过不添加，结果就是不生效。

示例

这里给一个我使用FFMpeg开发的CmakeList.txt作为例子：

cmake_minimum_required(VERSION 3.22.1)
project(FFmpegLog)

set(CMAKE_CXX_STANDARD 20)
# 设置几种类型的变异产物的输出位置
set(CMAKE_RUNTIME_OUTPUT_DIRECTORY ${CMAKE_SOURCE_DIR}/bin)
set(CMAKE_LIBRARY_OUTPUT_DIRECTORY ${CMAKE_SOURCE_DIR}/bin)
set(CMAKE_ARCHIVE_OUTPUT_DIRECTORY ${CMAKE_SOURCE_DIR}/bin)

# 把所需要用到的so库，设置在一个变量里
set(FFMPEG_LIBS
        /home/xiaolei/ClionProjects/FFmpeg/output/lib/libavcodec.so
        /home/xiaolei/ClionProjects/FFmpeg/output/lib/libavdevice.so
        /home/xiaolei/ClionProjects/FFmpeg/output/lib/libavfilter.so
        /home/xiaolei/ClionProjects/FFmpeg/output/lib/libavformat.so
        /home/xiaolei/ClionProjects/FFmpeg/output/lib/libavutil.so
        /home/xiaolei/ClionProjects/FFmpeg/output/lib/libswresample.so
        /home/xiaolei/ClionProjects/FFmpeg/output/lib/libswscale.so
)
# 链接库的目录
link_directories(/home/xiaolei/ClionProjects/FFmpeg/output/lib)
# 引入头文件的目录
include_directories(/home/xiaolei/ClionProjects/FFmpeg/output/include)
# 自己的源码文件的目录
aux_source_directory(${CMAKE_SOURCE_DIR}/src DIR_MAIN_SRCS)

# 设置编译产物位可执行文件
add_executable(FFmpegLog ${DIR_MAIN_SRCS})

# 把可执行文件与第三方动态库链接起来。
target_link_libraries(
        FFmpegLog PUBLIC
        avcodec
        avdevice
        avfilter
        avformat
        avutil
        swresample
        swscale
)

# 设置RPARH
SET_TARGET_PROPERTIES(FFmpegLog PROPERTIES BUILD_RPATH "$ORIGIN/../;/another/run/path" LINK_FLAGS "-Wl,--disable-new-dtags")

#在编译结束后，执行自定义脚本，把刚才列出的so库循环拷贝到指定目录下（其实就是生成的可执行文件目录下）
foreach(LIB_FILE ${FFMPEG_LIBS})
    add_custom_command(TARGET FFmpegLog POST_BUILD
            COMMAND ${CMAKE_COMMAND} -E copy_if_different
            ${LIB_FILE}
            ${CMAKE_SOURCE_DIR}/bin
    )
endforeach()

End.