可行且推荐在统信UOS(arm64)原生环境打包deb包;需源码编译linuxdeployqt,严格遵循UOS规范配置control文件、desktop路径、图标尺寸(512×512)、Exec绝对路径,并在postinst中调用update-desktop-database。

直接在统信UOS(arm64)上打包Qt程序为deb安装包,是可行且推荐的路径;跨架构(比如x86主机打arm64包)会引入大量依赖路径错乱、ldd识别失败、patchelf重写失效等问题,不建议尝试。
linuxdeployqt必须源码编译,不能用预编译二进制
统信UOS arm64系统自带的glibc版本通常高于linuxdeployqt官方预编译版所链接的版本,直接运行会报类似 GLIBC_2.34 not found 的错误。实测中,跳过源码编译这一步,90%以上会卡在 linuxdeployqt --appimage 无输出或静默退出。
- 从
https://github.com/probonopd/linuxdeployqt克隆源码,进入tools/linuxdeployqt/ - 注释掉
main.cpp中约192行的 GCC 版本检查逻辑(否则 cmake 会因 GCC 版本过高而拒绝配置) - 确保已安装
qt5-default或你自装 Qt 的qmake在$PATH中,然后执行:cmake . && make
- 生成的
linuxdeployqt可执行文件必须放在 UOS arm64 环境下使用,且和你的 Qt 程序用的是同一套 Qt 安装(比如都用/opt/Qt/5.15.2/gcc_64)
DEBIAN/control 文件必须严格匹配UOS软件商店规范
统信UOS对 deb 包元数据有额外校验,尤其是 Architecture 和 Depends 字段。填错会导致双击安装失败、软件中心拒收、甚至安装后桌面快捷方式不显示。
-
Architecture必须写arm64(不是all或any),用uname -m确认当前确实是aarch64 -
Depends至少包含:libc6 (>= 2.31), libgcc-s1 (>= 11), libstdc++6 (>= 11), libgl1, libxcb-xinerama0—— 注意 UOS 20+ 已弃用libxcb-xinerama0旧名,实际需查apt list --installed | grep xcb确认包名 -
Homepage和Description不能为空,否则软件中心审核不通过;Description需含换行(用$分隔),首行是简短标题,第二行起是详细说明
desktop 文件路径与图标尺寸必须精确对应
UOS 桌面环境(DDE)只从固定路径加载 .desktop 文件,且对图标尺寸敏感。放错位置或尺寸不对,会导致“已安装但找不到启动项”。
-
.desktop文件必须放在usr/share/applications/myapp.desktop(不是~/.local/share/applications/) -
Icon=字段写的是图标名(如myapp),不是完整路径;对应图标要放在usr/share/icons/hicolor/512x512/apps/myapp.png(UOS 强制要求至少提供 512×512 PNG) -
Exec=必须指向绝对路径,例如Exec=/opt/myapp/bin/myapp;如果程序依赖环境变量(如LD_LIBRARY_PATH),必须在Exec中显式封装成脚本,不能靠postinst注入全局变量
dpkg-deb 打包后必须验证 data.tar.gz 内容结构
很多打包失败的根本原因,是 data.tar.gz 解压后目录层级错误——比如把可执行文件放进了 usr/bin/myapp/ 而不是 usr/bin/myapp(多了一层目录),或者 DEBIAN/ 不在压缩包根目录。
- 打包命令必须用:
dpkg-deb --build myapp_deb/ myapp_1.0.0_arm64.deb
(注意末尾无斜杠) - 验证内容:用
ar -x myapp_1.0.0_arm64.deb解出三个文件,再用tar -tzf data.tar.gz | head -20查看顶层路径是否为usr/、DEBIAN/ - 特别注意:UOS 安装器会校验
DEBIAN/control中的Installed-Size字段,必须是真实大小(单位 KB),可用du -sk myapp_deb/ | cut -f1计算后填入,填错会导致“磁盘空间不足”假报错
最易被忽略的一点:UOS 安装 deb 后不会自动 reload DDE 的 desktop database,必须在 postinst 脚本里显式调用 update-desktop-database /usr/share/applications/,否则重启前桌面快捷方式始终不出现。


















