Linux下 将qt 5.9.5 编译的程序打包

<think>我们参考了上述引用中关于Qt程序在Linux下打包部署的信息，特别是引用[2]和[5]提到了两种方法：一种是修改连接库（不推荐），另一种是使用linuxdeployqt工具进行打包（但引用[5]指出它可能没有找齐所有基础依赖库）。此外，引用[3]和[4]提供了关于Qt5.9.5交叉编译的信息，但用户的问题是在Linux下打包，所以重点放在本地打包。 根据用户需求，我们需要将使用Qt5.9.5编译的程序在Linux下打包。这里我们提供一种可靠的方法：使用linuxdeployqt工具，但要注意它可能不能完全覆盖所有依赖，特别是非Qt的系统库。因此，我们可能需要手动补充依赖。 步骤概述： 1. 准备一个发布目录，将可执行程序复制到该目录。 2. 使用linuxdeployqt工具将Qt库和插件复制到发布目录，并创建启动脚本。 3. 检查并补充缺失的非Qt库（如系统库）。 4. 测试打包后的程序在目标机器（无Qt开发环境）上运行。 详细步骤： 步骤1：准备发布目录 假设我们的可执行程序名为`myapp`，创建一个目录（例如`package`）并将`myapp`复制进去。 步骤2：使用linuxdeployqt打包 首先，需要安装linuxdeployqt工具。可以从GitHub下载：https://github.com/probonopd/linuxdeployqt 安装说明：将下载的linuxdeployqt-<version>-x86_64.AppImage重命名为linuxdeployqt，并赋予可执行权限： ```bash chmod +x linuxdeployqt sudo mv linuxdeployqt /usr/local/bin/ ``` 然后，在发布目录（即包含`myapp`的目录）中运行： ```bash linuxdeployqt myapp -appimage ``` 注意：`-appimage`选项会生成一个AppImage文件，这是可选的。如果不需要AppImage，可以不加这个选项，这样会在当前目录下生成一个包含所有依赖的文件夹。 步骤3：检查并补充依赖 运行上述命令后，工具会将Qt库和插件复制到发布目录的lib和plugins子目录中。但是，一些系统库（如glibc、libstdc++等）可能没有打包进来。我们可以使用`ldd`命令检查可执行程序以及所有动态库的依赖： ```bash ldd myapp | grep "not found" ldd lib/*.so | grep "not found" ``` 如果发现有缺失的库，我们需要手动将这些库复制到发布目录的lib文件夹中。注意：要避免复制系统核心库（如libc.so.6），因为目标系统上通常会有，而且版本兼容性问题复杂。如果遇到核心库版本问题，可能需要考虑在较低版本的系统上打包（如使用Docker创建一个旧版系统的容器进行打包）。 步骤4：创建启动脚本（可选） 虽然linuxdeployqt会生成一个启动脚本（通常名为`AppRun`，如果使用AppImage的话），但如果不生成AppImage，我们可以自己创建一个启动脚本`myapp.sh`，内容如下： ```bash #!/bin/bash export LD_LIBRARY_PATH=$(dirname "$0")/lib:$LD_LIBRARY_PATH ./myapp "$@" ``` 然后给这个脚本可执行权限：`chmod +x myapp.sh`。这样，用户可以通过运行这个脚本来启动程序，它会设置动态库的路径。 步骤5：测试 将整个发布目录复制到另一台没有安装Qt的Linux机器上，运行启动脚本（或直接运行AppImage文件）测试程序是否能正常运行。 注意事项： - 如果程序使用了Qt插件（如platforms、imageformats等），linuxdeployqt会尝试将它们复制到plugins目录。但有时可能需要手动调整，确保这些插件被正确放置。 - 如果程序使用了其他资源（如qml文件、翻译文件等），需要手动复制到发布目录的相应位置。 替代方案：使用Docker容器打包（参考引用[5]） 另一种方法是在Docker容器中构建一个完整的运行环境，然后将整个环境导出为镜像或容器。这种方法更彻底，但可能生成较大的镜像。 总结：使用linuxdeployqt是相对简单的方法，但需要仔细检查依赖。对于复杂的程序，可能需要多次测试和补充缺失的库。 相关问题： §§相关问题§§ 1. 如何解决linuxdeployqt打包后程序在目标机器上运行时出现的“找不到Qt平台插件”的问题？ 2. 除了linuxdeployqt，还有哪些工具可以用于打包Qt应用程序？ 3. 如何为Qt应用程序创建AppImage包？</think>### Linux 下打包 Qt 5.9.5 应用程序的步骤 以下是详细打包流程（基于引用[2][5]的方案优化）： #### 一、基础打包方法（推荐） 1. **准备发布目录** 创建新目录，复制编译好的可执行文件（如 `myapp`）： ```bash mkdir release_package && cd release_package cp /path/to/your/project/myapp . ``` 2. **使用 `linuxdeployqt` 工具** ```bash linuxdeployqt myapp -appimage ``` - 工具会自动识别并复制所需的 Qt 库、插件和依赖项 - 生成文件结构： ``` release_package/ ├── myapp # 主程序 ├── lib/ # Qt 动态库 ├── plugins/ # Qt 插件（如 platforms, imageformats） ├── qml/ # QML 模块 └── AppRun # 自动生成的启动脚本 ``` 3. **补充系统依赖（关键步骤）** 通过 `ldd` 检查缺失库： ```bash ldd myapp | grep "not found" ``` 手动复制缺失的系统库（如 `libicu`, `libxcb`）到 `lib/` 目录： ```bash cp /usr/lib/x86_64-linux-gnu/libicu*.so.60 ./lib/ ``` #### 二、完整依赖解决方案 若目标机器无 Qt 环境，需额外操作： 1. **打包 Qt 运行时** 复制 Qt 安装目录的完整环境： ```bash cp -r /opt/Qt5.9.5/5.9.5/gcc_64/plugins/* ./plugins/ cp -r /opt/Qt5.9.5/5.9.5/gcc_64/qml/* ./qml/ ``` 2. **配置启动脚本** 创建 `myapp.sh` 避免路径问题： ```bash #!/bin/sh export LD_LIBRARY_PATH=$(dirname "$0")/lib:$LD_LIBRARY_PATH export QT_PLUGIN_PATH=$(dirname "$0")/plugins ./myapp "$@" ``` 赋予执行权限： ```bash chmod +x myapp.sh ``` #### 三、验证与部署 1. **本地测试** 在无 Qt 开发环境的机器运行： ```bash ./release_package/myapp.sh ``` 2. **Docker 部署（引用[5]）** 创建最小化 Docker 镜像： ```dockerfile FROM alpine:latest COPY release_package /app RUN apk add --no-cache libx11 libxcb libglvnd CMD ["/app/myapp.sh"] ``` #### 注意事项 1. **版本兼容性** - 打包环境尽量使用旧版 Linux（如 Ubuntu 16.04）以兼容更多系统 - 避免使用新版 GLIBC（可通过 `ldd --version` 检查） 2. **常见问题处理** - **报错 "Could not load the Qt platform plugin xcb"**： 复制完整 `platforms` 插件：`cp -r /opt/Qt5.9.5/5.9.5/gcc_64/plugins/platforms/ ./plugins/` - **字体缺失**：添加字体目录 `./fonts/` > 提示：完整依赖包大小约 50-100MB，可通过 `strip` 命令缩减库文件体积： > ```bash > strip lib/*.so.* > ``` ---