C++ linux打包运行方案(cmake)

文章目录

背景

使用C++编写的一个小项目,需要打包成ubuntu下的可执行文件,方便分发给其他ubuntu执行,因为docker镜像方案过于臃肿,所以需要把项目的动态库都打在软件包中,分发之后可以直接运行,而不需要再重复安装。

动态库

经过依赖精简和梳理,项目最终必须依赖的动态库包括:pcl, yaml, rosbag(用于读取rosbag包)

打包方案

第一步尝试将所有动态库转为静态库安装,发现 pcl 和 rosbag 间接依赖太多,只好暂时先将yaml库转为静态库,这里使用的方式是直接把yaml的源码包含进来。

动态库转静态库

这里把yaml的源码下载到 项目目录/thirdparty/yaml-cpp目录结构如下:

在CMakeLists.txt中, 相关改动如下:

cmake 复制代码
...
# 添加子目录编译 yaml-cpp 库
add_subdirectory(thirdparty/yaml-cpp)
...
target_include_directories(ExeFileName PUBLIC 
  ...
  ${CMAKE_SOURCE_DIR}/thirdparty/yaml-cpp/include
)
target_link_libraries(ExeFileName PUBLIC 
  ...
  yaml-cpp
  ...
)
...

动态库打到软件包中

这里用到了linuxdeploy-x86_64.AppImage工具,安装方式为:

shell 复制代码
wget https://github.com/linuxdeploy/linuxdeploy/releases/download/continuous/linuxdeploy-x86_64.AppImage -O /usr/local/bin/linuxdeploy
chmod +x /usr/local/bin/linuxdeploy

我们以pcl库为例,实际依赖库链接方式保持不变,只是需要在CMakeLists.txt最后加上对应的用于linuxdeploy的内容即可:

cmake 复制代码
...
find_package(PCL REQUIRED COMPONENTS io)
...
target_include_directories(ExeFileName PUBLIC 
  ${PCL_INCLUDE_DIRS}
  ...
)

# 链接库
target_link_libraries(ExeFileName PUBLIC 
  ${PCL_LIBRARIES} 
  ...
)

# 设置安装路径为 AppDir 结构
install(TARGETS ExeFileName DESTINATION usr/bin)

# 设置 RPATH(确保运行时库加载正确)
set_target_properties(ExeFileName PROPERTIES
    INSTALL_RPATH "$ORIGIN/../lib"  # 相对路径指向 ../lib
    BUILD_WITH_INSTALL_RPATH TRUE
    INSTALL_RPATH_USE_LINK_PATH TRUE
)

# 修改原有的打包命令,确保在 Ubuntu 18.04 中兼容
add_custom_target(bundle_appimage_all_in_one
    COMMAND mkdir -p AppDir/usr/lib
    COMMAND linuxdeploy --appdir AppDir    
        -e $<TARGET_FILE:ExeFileName>        
        --output appimage     
        --plugin none             
        --executable $<TARGET_FILE:ExeFileName>  # 显式指定可执行文件
    WORKING_DIRECTORY ${CMAKE_BINARY_DIR}
    DEPENDS ExeFileName
)

注意: 尽量在ubuntu低版本比如18.04上进行打包,以确保高版本ubuntu能向下兼容运行

在编译打包脚本中需要增加linuxdeploy指令进行打包:

shell 复制代码
linuxdeploy --appdir AppDir -e ./ExeFileName \
    --library /lib/x86_64-linux-gnu/libusb-1.0.so.0 \
    --library /lib/x86_64-linux-gnu/libexpat.so.1

因为在运行时发现还是报错,缺少依赖库,所以在linuxdeploy打包时把缺少的动态库显式指定出来。

运行

运行命令为:

bash 复制代码
LD_LIBRARY_PATH=./AppDir/usr/lib ./AppDir/usr/bin/ExeFileName ...

这里要强制带上LD_LIBRARY_PATH,这个问题有待解决,不过不影响使用。

相关推荐
励志要当大牛的小白菜15 分钟前
ART配对软件使用
开发语言·c++·qt·算法
mCell1 小时前
从删库到跑路?这50个Linux命令能保你职业生涯
linux·windows·macos
杰克逊的日记1 小时前
GPU运维常见问题处理
linux·运维·gpu
PAK向日葵1 小时前
【算法导论】如何攻克一道Hard难度的LeetCode题?以「寻找两个正序数组的中位数」为例
c++·算法·面试
誰能久伴不乏2 小时前
Linux系统调用概述与实现:深入浅出的解析
linux·运维·服务器
程序员学习随笔2 小时前
Linux进程深度解析(2):fork/exec写时拷贝性能优化与exit资源回收机制(进程创建和销毁)
linux·运维·服务器
mmoyula2 小时前
【RK3568 PWM 子系统(SG90)驱动开发详解】
android·linux·驱动开发
-SGlow-2 小时前
MySQL相关概念和易错知识点(2)(表结构的操作、数据类型、约束)
linux·运维·服务器·数据库·mysql
爱装代码的小瓶子3 小时前
数据结构之队列(C语言)
c语言·开发语言·数据结构
代码改变世界ctw3 小时前
Linux内核设计与实现 - 第14章 块I/O层
linux·运维·服务器