【Qt】如何使用QtInstallerFramework打包Qt程序
使用 Qt Installer Framework 可以将你的 Qt 程序打包成一个带有安装向导的安装包，适用于 Windows、Linux 和 macOS 平台。以下是完整的打包流程，以你当前开发的 ecgexport 应用为例。
🧰 一、准备工作
1. 安装 Qt Installer Framework
- 下载地址：Index of /official_releases/qt-installer-framework
- 推荐版本：
4.5.x（目前最稳定） - 安装完成后会包含以下关键工具：
binarycreatorinstallerbasearchivegen
📁 二、准备你的应用程序目录结构
建议目录结构如下：
myapp/
├── config/
│ └── config.xml
├── packages/
│ └── com.mycompany.myapp/
│ ├── meta/
│ │ └── package.xml
│ └── data/
│ └── ecgexport.exe (或你的程序 + 所有依赖)
└── installer/└── installerbase.exe🛠️ 三、配置文件说明
1. config/config.xml —— 全局配置
<?xml version="1.0" encoding="UTF-8"?>
<Installer><Name>xx报告导出工具</Name><Version>1.0.0</Version><Title>xx文件导出安装程序</Title><Publisher>MyCompany</Publisher><StartMenuDir>MyApp</StartMenuDir><TargetDir>@HomeDir@/MyApp</TargetDir>
</Installer>2. packages/com.mycompany.myapp/meta/package.xml —— 包描述
<?xml version="1.0" encoding="UTF-8"?>
<Package><DisplayName>xx导出模块</DisplayName><Description>用于导出xx报告的桌面应用</Description><Version>1.0.0</Version><ReleaseDate>2025-04-05</ReleaseDate><Default>true</Default><Script>installscript.qs</Script>
</Package>你可以添加可选脚本 installscript.qs 来实现自定义安装逻辑。
🧱 四、打包你的程序
1. 收集所有依赖项
使用 Qt 的 windeployqt 工具收集依赖库：
windeployqt --dir deploy_dir ecgexport.exe
这会自动把 Qt 插件、dll 等复制到 deploy_dir 目录中。
2. 将程序复制到 data/ 目录
cp -r deploy_dir/* myapp/packages/com.mycompany.myapp/data/📦 五、生成安装包
进入 myapp 根目录执行：
binarycreator -c config/config.xml -p packages my_installer.exe生成的安装包为：my_installer.exe
🖼️ 六、美化安装界面（可选）
你可以通过以下方式定制安装器外观：
- 在
config.xml中设置图标：<Logo>path/to/icon.png</Logo> - 使用
installerbase模板替换默认皮肤（高级功能）
✅ 七、测试安装包
双击运行 my_installer.exe，测试是否能正常安装并运行你的程序。
🧪 八、常见问题排查
| 问题 | 解决方案 |
|---|---|
| 安装后无法运行 | 缺少 VC++ 运行时，请确保目标系统已安装 |
| 中文乱码 | 设置合适的字体和编码支持 |
| 依赖缺失 | 检查是否完整使用 windeployqt |
| 启动慢 | 可尝试静态编译（需商业授权） |
📌 示例总结（以你的 ecgexport 为例）
# 步骤 1：部署依赖
windeployqt --dir deploy ecgexport.exe# 步骤 2：复制到 data 目录
cp -r deploy/* myapp/packages/com.mycompany.myapp/data/# 步骤 3：构建安装包
cd myapp
binarycreator -c config/config.xml -p packages ecgexport_installer.exe最终你会得到一个名为 ecgexport_installer.exe 的安装包，可在任意 Windows PC 或 Server 上运行。
如需进一步集成到 CI/CD 流程、自动版本号管理、签名打包等，也可以继续提问。