如何快速安装linuxdeployqt打包Linux应用？

核心打包工具推荐

使用 linuxdeployqt（推荐）

原理：自动收集Qt依赖库、生成桌面文件并创建AppDir目录（符合Linux桌面标准）。
步骤：

chmod +x linuxdeployqt-continuous-x86_64.AppImage
# 打包步骤
mkdir MyAppDir
cp myapp MyAppDir/usr/bin/          # 复制可执行文件
cp myapp.desktop MyAppDir/           # 创建桌面文件（需手动编写）
cp myapp.png MyAppDir/               # 应用图标
./linuxdeployqt-continuous-x86_64.AppImage MyAppDir/myapp.desktop -appimage

生成文件：
MyApp-x86_64.AppImage（可直接运行的独立包）

关键参数：

• -appimage：输出为AppImage格式
• -qmake=<path>：指定qmake路径（如Qt版本非系统默认）

使用 cqtdeployer（跨平台支持）

优势：支持Debian/RPM/AppImage等多种格式，自动处理非Qt依赖（如OpenGL）。
步骤：

# 安装
sudo apt install cqtdeployer  # 或从GitHub下载二进制
# 打包
cqtdeployer -bin myapp -qmake ~/Qt/5.15.2/gcc_64/bin/qmake -targetDir ./deploy

输出目录：
./deploy 包含所有依赖库和启动脚本。

手动打包方案（适合定制化需求）

收集依赖库

# 查找Qt依赖
ldd myapp | grep "Qt" | awk '{print $3}' | xargs -I{} cp {} ./lib/
# 复制平台插件
mkdir -p ./platforms
cp ~/Qt/5.15.2/gcc_64/plugins/platforms/libqxcb.so ./platforms/

编写启动脚本（myapp.sh）

#!/bin/sh
APP_DIR=$(dirname "$(readlink -f "$0")")
export LD_LIBRARY_PATH=$APP_DIR/lib:$LD_LIBRARY_PATH
export QT_PLUGIN_PATH=$APP_DIR/plugins
$APP_DIR/myapp "$@"

目录结构示例

MyApp/
├── myapp          # 可执行文件
├── myapp.sh       # 启动脚本
├── lib/           # Qt库（libQt5Core.so.5等）
├── platforms/     # 平台插件
├── resources/     # 图片/配置文件等
└── myapp.desktop  # 桌面入口文件

生成安装包（可选）

制作DEB包（Debian/Ubuntu）

# 安装工具
sudo apt install dh-make build-essential
# 创建包结构
mkdir myapp_1.0-1
cp -r MyApp/* myapp_1.0-1/DEBIAN/control  # 需编写control文件
dpkg-deb --build myapp_1.0-1

打包为AppImage

使用appimagetool转换AppDir：

wget https://github.com/AppImage/AppImageKit/releases/download/continuous/appimagetool-x86_64.AppImage
chmod +x appimagetool-x86_64.AppImage
./appimagetool-x86_64.AppImage MyAppDir

关键注意事项

1. 路径问题

   • 硬编码路径改用QCoreApplication::applicationDirPath()
   • 资源文件通过QDir::addSearchPath("icons", "./resources")加载

2. 桌面文件规范（myapp.desktop示例）

   [Desktop Entry]
   Name=MyApp
   Exec=/path/to/myapp.sh
   Icon=/path/to/myapp.png
   Type=Application
   Categories=Utility;

3. 依赖兼容性

   • 使用ldd检查动态库
   • 建议在最低兼容系统（如Ubuntu LTS）中打包

4. Qt插件处理
   需复制plugins目录下的imageformats、sqldrivers等子目录。

验证打包结果

1. 在纯净虚拟机中测试运行
2. 使用strace跟踪系统调用：

   strace -o log.txt ./myapp.sh
   grep "ENOENT" log.txt  # 检查缺失文件

引用说明

• linuxdeployqt：基于Qt官方工具链的扩展，遵循AppImage规范
• cqtdeployer：支持多平台打包，GitHub源码
• Qt依赖管理参考官方文档
• 桌面文件标准见freedesktop.org规范

最佳实践建议：

• 开发环境与部署环境的Qt版本、GCC版本严格一致
• 优先使用linuxdeployqt生成AppImage，避免依赖冲突
• 复杂项目推荐通过CMake集成打包流程（install(TARGETS ...)）