在 CentOS 上将软件打包为 AppImage
核心思路与准备
- 将软件及其依赖整理到一个符合规范的目录 AppDir，包含可执行文件、AppRun 启动脚本、.desktop 元数据和图标。
- 使用 AppImageKit 提供的 appimagetool 将 AppDir 打包成可在多发行版运行的 AppImage 单文件。
- 建议在较新的 CentOS 7/8/9 环境中操作，并提前安装基础构建工具（如 wget、tar、patchelf 等）。AppImage 的目标是在 RHEL/CentOS 等常见发行版上“下载即运行”。
方法一 手动构建 AppDir 并用 appimagetool 打包
- 安装工具（若仓库无 appimagetool，见方法二下载预编译二进制）
- sudo yum update
- sudo yum install -y wget patchelf
- 准备应用与 AppDir
- 假设已有可执行文件 myapp（位于当前目录）
- mkdir -p myapp.AppDir/usr/bin
- cp myapp myapp.AppDir/usr/bin/
- 创建 AppRun（AppImage 入口脚本）
- cat > myapp.AppDir/AppRun << ‘EOF’
#!/bin/sh
HERE=“$(dirname “$(readlink -f “$0”)”)”
exec “$HERE/usr/bin/myapp” “$@”
EOF
- chmod +x myapp.AppDir/AppRun
- 创建 .desktop 与图标
- cat > myapp.AppDir/myapp.desktop << ‘EOF’
[Desktop Entry]
Name=MyApp
Exec=AppRun
Icon=myapp
Type=Application
Categories=Utility;
EOF
- 将图标（如 myapp.png）放入 myapp.AppDir/ 根目录，或在 .desktop 中改为绝对路径
- 打包与测试
- appimagetool myapp.AppDir
- chmod +x myapp-*.AppImage
- ./myapp-*.AppImage
- 说明
- 若程序依赖外部库，可放入 myapp.AppDir/usr/lib 并在 AppRun 中设置 LD_LIBRARY_PATH（仅在必要时使用，避免与系统库冲突）。
方法二 使用 appimage-builder 自动化打包（推荐）
- 安装依赖与工具
- sudo yum install -y patchelf fuse-sshfs
- pip3 install --user appimage-builder
- 生成模板并完善
- cd your-project
- appimage-builder --generate # 生成 AppDir 与基本配置
- 按提示完善：把可执行文件、图标放入相应路径，编辑生成的 .yml 配置（如 AppRun、desktop、图标、依赖收集策略等）
- 构建
- 适用场景
- 自动收集依赖、处理 Qt/GTK 资源、生成更标准化的 AppImage，适合复杂应用与持续集成。
方法三 直接下载并使用 appimagetool 预编译二进制
- 获取工具
- wget “https://gitcode.com/gh_mirrors/ap/AppImageKit/releases/download/continuous/appimagetool-x86_64.AppImage”
- chmod a+x appimagetool-x86_64.AppImage
- 打包
- ./appimagetool-x86_64.AppImage your_appdir
- 常用选项
- -u/–updateinformation 嵌入更新信息
- -s/–sign 使用 GPG 签名
- –comp 指定 Squashfs 压缩方式
- 可通过 --help 查看完整用法。
常见问题与建议
- 运行报缺库或版本不兼容
- 尽量在较新且完整的 CentOS 环境构建；必要时将所需 .so 放入 AppDir/usr/lib 并在 AppRun 中设置 LD_LIBRARY_PATH；使用 patchelf 调整 rpath 仅作为进阶手段。
- Qt 应用
- 使用 linuxdeployqt 收集 Qt 插件与翻译资源，减少运行缺失；配合 appimagetool 完成最终打包。
- 分发与更新
- 生成的 AppImage 通常为 架构特定（如 x86_64）；可用 zsync 做增量更新；对外部资源使用相对路径与打包内资源，减少外部依赖。
- 兼容性边界
- AppImage 并非“万能兼容”，目标系统需具备基本的 glibc 等运行库；建议在目标发行版矩阵中做实测，必要时为不同发行版或版本构建多个 AppImage。
