Deepin-Wine打包Windows软件避坑指南：以QQ 9.4.8为例，详解info、control和run.sh关键配置-平芜编程栈

Deepin-Wine高级打包实战：从info到run.sh的深度排错手册

最近在技术社区看到不少开发者抱怨："明明按照教程一步步操作，打包出来的Windows软件却总是报错"。作为经历过无数次深夜debug的老兵，我完全理解这种挫败感。今天我们就以QQ 9.4.8为例，解剖Deepin-Wine打包过程中的那些"魔鬼细节"。

1. 容器环境构建的隐藏陷阱

很多教程会告诉你用WINEARCH=win32创建容器就万事大吉，但实际使用中我发现32位容器对现代Windows软件的支持正在逐渐弱化。特别是当遇到以下情况时：

# 更可靠的容器创建命令（添加dll覆盖设置） WINEPREFIX=~/.deepinwine/qq deepin-wine5 winecfg

在winecfg中需要特别关注：

函数库选项卡：勾选riched20和usp10（解决富文本显示问题）
图形选项卡：取消勾选"允许窗口管理器装饰窗口"（避免界面元素错位）

注意：容器路径不要包含中文或空格，否则run.sh脚本可能无法正确解析

字体问题看似简单，实则暗藏杀机。除了常规的simsun.ttc，还需要特别注意：

缺失字体	症状表现	解决方案
Segoe UI	界面文字消失	从Windows系统复制segoeui.ttf
Tahoma	对话框乱码	同时部署tahoma.ttf和tahomabd.ttf
Microsoft YaHei	部分按钮无文字	添加msyh.ttc到Fonts目录

2. info文件的版本控制玄机

info文件看似只是个简单的JSON配置，但版本号格式错误会导致软件无法被应用商店识别。我踩过的坑包括：

{ "appid": "com.qq.im.deepin", "version": "9.4.8deepin20", // 必须数字开头 "arch": ["i386"], "permissions": { "audio_record": true // 此项为true才能使用麦克风 } }

常见版本号错误模式：

v9.4.8（含字母前缀）
9.4.8-beta（含非数字字符）
9_4_8（使用非法分隔符）

修改版本号时务必同步更新三个地方：

info文件中的version字段
DEBIAN/control文件中的Version行
run.sh脚本中的版本检查逻辑

3. control文件的依赖管理艺术

control文件中Depends字段的依赖声明直接决定安装成功率。经过多次测试，我发现这些依赖最容易被忽略：

Depends: libvkd3d1 (>= 1.0), # Direct3D 12支持 libgnutls30, # 解决SSL连接问题 libodbc1, # 数据库连接必需 libsdl2-2.0-0, # 游戏相关功能 deepin-wine-plugin-virtual # 虚拟化支持

依赖项处理技巧：

使用apt-cache show查看最小版本要求
对可选功能使用Recommends而非Depends
冲突包声明要精确（如Conflicts: deepin.com.qq.im<8.9.0）

我曾遇到过一个典型案例：用户反馈QQ无法视频通话，最终发现是缺少libgstreamer-plugins-base1.0-0这个依赖项。

4. run.sh脚本的调优实战

run.sh是软件运行的入口脚本，也是问题高发区。下面是几个关键修改点：

#!/bin/bash export WINEPREFIX="${WINEPREFIX:-/opt/apps/com.qq.im.deepin/files}" export LC_ALL=zh_CN.UTF-8 # 强制中文locale export GTK_IM_MODULE=fcitx # 输入法集成 # 解决高分屏模糊问题 export WINEDPI=96 [ "$(xrandr | grep ' connected' | wc -l)" -gt 1 ] && export WINEDPI=120 # 容器完整性检查 if [ ! -f "$WINEPREFIX/system.reg" ]; then deepin-wine5 winecfg # 自动初始化容器 fi

常见run.sh故障排查：

启动闪退：添加export WINEDEBUG=+err查看错误日志
无法输入中文：确保包含export XMODIFIERS=@im=fcitx
托盘图标缺失：需要export XDG_CURRENT_DESKTOP=Deepin

5. 桌面集成与MIME类型配置

entries/applications目录下的.desktop文件需要特别注意这些字段：

[Desktop Entry] Exec="/opt/apps/com.qq.im.deepin/files/run.sh" -u %u # %u处理URL唤醒 MimeType=application/qq;x-scheme-handler/tencent; # 协议支持 StartupWMClass=QQ.exe # 窗口类名匹配

关键验证步骤：

使用xdg-mime query default application/qq检查MIME注册
通过xprop WM_CLASS获取正确的StartupWMClass
用desktop-file-validate验证.desktop文件语法

6. 构建过程中的校验机制

很多打包问题其实源于文件权限和校验失败。这里有个增强版的打包流程：

# 生成更完整的md5sums find extract/opt -type f -exec md5sum {} + > extract/DEBIAN/md5sums # 添加postinst脚本处理首次运行配置 cat > extract/DEBIAN/postinst <<EOF #!/bin/sh chmod 755 /opt/apps/com.qq.im.deepin/files/run.sh update-desktop-database EOF chmod 755 extract/DEBIAN/postinst # 严格模式构建 dpkg-deb --root-owner-group -Zxz -b extract/ build/

构建完成后务必进行这些测试：