使用appimage-builder打包C++应用时，如何添加resources文件夹避免段错误？

我之前打包C++应用成AppImage时也碰到过一模一样的问题——程序在本地跑好好的，做成AppImage就段错误，查了半天就是resources文件夹没被打包进去，程序找不到着色器、字体这些资源直接崩了。下面给你具体的解决办法：

1. 修正AppImageBuilder的配置文件 #

appimage-builder完全靠AppImageBuilder.yml来决定打包哪些内容，你得确保这个配置里明确包含了resources文件夹。

打开你的AppImageBuilder.yml，找到files节点（没有的话就新建），加上这行规则：

files:
  - include: 'resources/**'
    destination: '.'

这行的意思是把当前项目根目录下的resources文件夹及其所有子文件/文件夹，原封不动打包到AppImage的根目录（和AppRun在同一个层级）。

另外，也可以在配置的script部分加个复制命令，确保构建AppDir的时候resources已经被放进去了：

script:
  # 先创建AppDir下的resources目录
  - mkdir -p AppDir/resources
  # 把本地的resources内容复制过去
  - cp -r resources/* AppDir/resources/

2. 让程序在AppImage环境下正确找到资源路径 #

就算把resources打包进去了，如果你的代码是用相对当前工作目录的路径（比如./resources/shaders/xxx.glsl）来加载资源，在AppImage运行时可能还是找不到——因为AppImage会在系统临时目录挂载运行，当前工作目录不一定是AppImage的挂载目录。

你得修改C++代码，让程序根据自身可执行文件的位置来推导资源路径：

#include <filesystem>
namespace fs = std::filesystem;

// 获取资源目录的绝对路径
fs::path get_resource_dir() {
    // 获取当前程序的绝对路径
    fs::path exe_path = fs::canonical("/proc/self/exe");
    // 假设resources和AppRun在同一目录下，返回resources的路径
    return exe_path.parent_path() / "resources";
}

之后加载资源的时候，就用这个函数返回的路径拼接文件名，比如：

// 加载顶点着色器
fs::path vertex_shader = get_resource_dir() / "shaders" / "vertex.glsl";
// 这里写加载着色器的代码

3. 验证打包结果 #

改完配置和代码后，重新跑appimage-builder生成AppImage，然后可以用下面的命令解压AppImage，确认resources是否在里面：

./YourAppName.AppImage --appimage-extract

解压后会生成squashfs-root文件夹，进去看看有没有resources，里面的文件是不是都齐了。

如果还是崩，你可以开调试输出看看具体哪个资源找不到：

export LD_DEBUG=libs
./YourAppName.AppImage

或者直接用gdb挂上去看段错误的具体位置：

gdb ./YourAppName.AppImage
run

内容的提问来源于stack exchange，提问作者Jyothikumar S.