Qt程序在统信UOS(arm64)上打包成deb安装包，实现一键安装与桌面快捷方式

原创于 2026-06-13 14:31:48 发布 · 797 阅读

10 ·

本内容遵循CC 4.0 BY-SA版权协议

GEO检测

标签

#Qt #统信UOS #打包发布 #arm64

iOS 专栏收录该内容

284 篇文章

订阅专栏

Qt程序在统信UOS(arm64)上打包成deb安装包的完整指南

在国产操作系统生态快速发展的今天，统信UOS作为主流国产Linux发行版之一，其arm64架构版本在信创领域应用广泛。对于Qt开发者而言，将应用程序打包成符合UOS软件商店规范的deb安装包，是实现产品化的重要一步。本文将深入讲解如何将linuxdeployqt生成的程序文件夹转化为专业的deb安装包，实现双击安装、自动创建菜单项和桌面快捷方式的全流程。

1. 准备工作与环境配置

在开始打包之前，需要确保已经完成以下准备工作：

已完成Qt程序在UOS(arm64)上的编译调试
已使用linuxdeployqt工具生成包含所有依赖的应用程序文件夹
准备应用程序图标文件（推荐512x512像素的PNG格式）
确认目标系统已安装dpkg-dev、debhelper等打包工具

安装必要的打包工具：

sudo apt update
sudo apt install dpkg-dev debhelper dh-make

验证打包环境：

dpkg --version
dh_make --version

提示：建议在UOS系统原生环境下进行打包操作，避免跨架构打包可能带来的兼容性问题。

2. deb包结构解析与目录创建

标准的deb安装包需要遵循特定的目录结构。我们首先创建一个打包工作目录：

mkdir -p myapp_deb/DEBIAN myapp_deb/usr/share/myapp myapp_deb/usr/share/applications myapp_deb/usr/share/icons/hicolor/512x512/apps

关键目录说明：

DEBIAN ：存放控制文件和安装脚本
usr/share/myapp ：存放应用程序主体文件
usr/share/applications ：存放.desktop桌面入口文件
usr/share/icons ：存放应用程序图标

将linuxdeployqt生成的程序文件夹内容复制到usr/share/myapp目录：

cp -r linuxdeployqt_output/* myapp_deb/usr/share/myapp/

3. 编写control控制文件

在DEBIAN目录下创建control文件，这是deb包的核心元数据文件：

nano myapp_deb/DEBIAN/control

文件内容示例：

Package: myapp
Version: 1.0.0
Architecture: arm64
Maintainer: Your Name <your.email@example.com>
Depends: libc6 (>= 2.28), libqt5core5a (>= 5.11.3)
Section: utils
Priority: optional
Homepage: https://example.com
Description: 我的Qt应用程序
 这是一个在统信UOS上运行的Qt应用程序示例，
 提供一键安装和桌面快捷方式支持。

关键字段说明：

Package ：软件包名称（小写字母、数字和连字符）
Version ：遵循语义化版本规范
Architecture ：arm64表示专为UOS arm64架构打包
Depends ：列出应用程序运行所需的关键依赖

4. 创建桌面快捷方式与菜单项

4.1 准备应用程序图标

将准备好的图标文件复制到指定位置：

cp myapp.png myapp_deb/usr/share/icons/hicolor/512x512/apps/

4.2 创建.desktop文件

在usr/share/applications目录下创建myapp.desktop文件：

[Desktop Entry]
Version=1.0
Type=Application
Name=我的应用
Comment=一个Qt示例应用程序
Exec=/usr/share/myapp/AppRun
Icon=myapp
Categories=Utility;Application;
Terminal=false
StartupNotify=true

关键参数说明：

Exec ：指定应用程序启动命令
Icon ：指定图标名称（无需扩展名）
Categories ：定义应用程序分类

5. 编写postinst安装后脚本

为了实现安装后自动创建桌面快捷方式，我们需要在DEBIAN目录下创建postinst脚本：

nano myapp_deb/DEBIAN/postinst

脚本内容示例：

#!/bin/sh

# 更新图标缓存
gtk-update-icon-cache -f /usr/share/icons/hicolor/

# 为当前用户创建桌面快捷方式
if [ -d "/home/$USER/Desktop" ]; then
    cp /usr/share/applications/myapp.desktop "/home/$USER/Desktop/"
    chmod +x "/home/$USER/Desktop/myapp.desktop"
    chown $USER:$USER "/home/$USER/Desktop/myapp.desktop"
fi

# 确保应用程序可执行
chmod +x /usr/share/myapp/AppRun

exit 0

设置脚本可执行权限：

chmod 755 myapp_deb/DEBIAN/postinst

6. 构建deb安装包

完成所有文件准备后，使用dpkg命令构建deb包：

dpkg-deb --build myapp_deb myapp_1.0.0_arm64.deb

构建成功后，可以使用以下命令验证deb包内容：

dpkg -c myapp_1.0.0_arm64.deb  # 查看包内容
dpkg -I myapp_1.0.0_arm64.deb  # 查看包信息

7. 测试安装与卸载

在目标系统上测试安装：

sudo apt install ./myapp_1.0.0_arm64.deb

安装后验证：

检查应用程序是否出现在开始菜单
检查桌面是否创建快捷方式
直接运行快捷方式测试程序启动

卸载测试：

sudo apt remove myapp

8. 进阶优化与问题排查

8.1 依赖关系优化

使用dpkg-shlibdeps自动检测依赖关系：

cd myapp_deb
dpkg-shlibdeps -O usr/share/myapp/AppRun

将输出结果添加到control文件的Depends字段中。

8.2 文件权限管理

确保关键文件具有正确的权限：

find myapp_deb -type d -exec chmod 755 {} \;
find myapp_deb -type f -exec chmod 644 {} \;
chmod 755 myapp_deb/usr/share/myapp/AppRun

8.3 常见问题解决

问题1 ：安装后图标不显示

解决方案：运行 gtk-update-icon-cache 并检查图标文件路径

问题2 ：桌面快捷方式无法启动

解决方案：检查.desktop文件中的Exec路径是否正确

问题3 ：依赖缺失导致无法运行

解决方案：使用ldd检查依赖，完善control中的Depends字段

9. 提交到UOS应用商店

如需将应用提交到统信UOS应用商店，还需要：

准备应用截图和详细描述
创建完整的元数据文件
按照UOS开发者文档进行签名
通过开发者平台提交审核

提示：UOS应用商店对应用图标、描述和权限有严格要求，建议提前阅读官方打包规范。

在实际项目开发中，我们发现arm64架构下的Qt应用打包需要特别注意以下几点：

确保所有依赖库都是arm64版本
测试在不同DPI设置下的显示效果
验证在UOS不同版本上的兼容性
考虑添加自动更新功能