告别依赖烦恼：用Qt windeployqt + Inno Setup打造专业Windows安装包

从开发到交付：Qt应用的专业级Windows安装包制作全攻略

当你花费数月时间精心打磨出一款Qt应用程序，最后却只能将一堆散乱的文件压缩成zip发给用户时，那种感觉就像米其林大厨把食材直接端上桌——技术再精湛，体验却大打折扣。本文将带你突破开发者的思维局限，用windeployqt+Inno Setup组合拳，打造不输商业软件的安装体验。

1. 基础准备：用windeployqt构建可移植包

1.1 Release编译的正确姿势

在开始打包前，确保你的工程已经通过Release模式编译。Qt Creator中常见的坑是：

• 构建套件选择：明确区分32位/64位
• 运行时库匹配：MSVC版需对应Visual Studio版本
• QML应用特殊处理：需要额外指定qml目录

推荐使用以下CMake配置片段确保Release构建纯净：

set(CMAKE_BUILD_TYPE Release)
set(CMAKE_EXE_LINKER_FLAGS_RELEASE "/SUBSYSTEM:WINDOWS /ENTRY:mainCRTStartup")

1.2 windeployqt的进阶用法

基础命令windeployqt.exe MyApp.exe往往不够用，实战中需要处理这些情况：

多架构场景：

# 32位应用
C:\Qt\5.15.2\msvc2019\bin\windeployqt.exe --dir deploy MyApp.exe

# 64位应用
C:\Qt\5.15.2\msvc2019_64\bin\windeployqt.exe --dir deploy MyApp.exe

QML应用必备参数：

windeployqt.exe --qmldir C:\path\to\project\qml --quick .

常见问题排查工具：

• Dependency Walker：检查缺失的DLL
• Process Monitor：监控运行时文件加载行为
• ldd等效命令（Linux开发者习惯迁移）：

  dumpbin /DEPENDENTS MyApp.exe
  

2. 安装包工程规划艺术

2.1 文件结构设计原则

专业级安装包的文件布局应该遵循：

MyApp_Installer/
├── scripts/
│   ├── setup.iss          # Inno Setup主脚本
│   └── custom.iss         # 自定义脚本片段
├── resources/
│   ├── installer_icon.ico # 安装程序图标
│   └── banner.bmp         # 安装向导横幅
└── output/                # 最终生成的安装包

2.2 版本管理策略

推荐在安装包中集成版本信息自动更新机制：

[Setup]
AppVersion={#GetFileVersion("MyApp.exe")}
VersionInfoVersion={#GetFileVersion("MyApp.exe")}

3. Inno Setup脚本深度定制

3.1 基础脚本模板解析

一个完整的.iss文件包含这些关键部分：

[Setup]
AppName=MyQtApplication
AppVersion=1.0
DefaultDirName={autopf}\MyApp
DefaultGroupName=MyApp
OutputDir=output
OutputBaseFilename=MyApp_Setup
Compression=lzma2/ultra64
SolidCompression=yes

[Files]
Source: "deploy\*"; DestDir: "{app}"; Flags: ignoreversion recursesubdirs

[Icons]
Name: "{group}\MyApp"; Filename: "{app}\MyApp.exe"
Name: "{commondesktop}\MyApp"; Filename: "{app}\MyApp.exe"

3.2 高级功能实现

注册表操作示例：

[Registry]
Root: HKCU; Subkey: "Software\MyCompany"; Flags: uninsdeletekey
Root: HKCU; Subkey: "Software\MyCompany\MyApp"; ValueType: string; ValueName: "InstallPath"; ValueData: "{app}"

多语言支持：

[Languages]
Name: "en"; MessagesFile: "compiler:Default.isl"
Name: "zh_CN"; MessagesFile: "compiler:Languages\ChineseSimplified.isl"

自定义安装步骤：

[Code]
procedure CurStepChanged(CurStep: TSetupStep);
begin
  if CurStep = ssPostInstall then
  begin
    MsgBox('配置已完成，建议重启系统使设置生效', mbInformation, MB_OK);
  end;
end;

4. 专业级安装包增强技巧

4.1 视觉品牌化定制

• 安装向导主题：使用WizardImageFile指定横幅图片
• 安装过程动画：通过BeforeInstall/AfterInstall添加进度提示
• 数字签名：使用signtool为安装包添加数字证书

4.2 安装后行为控制

[Run]
Filename: "{app}\MyApp.exe"; Description: "启动应用程序"; Flags: postinstall nowait skipifsilent
Filename: "{app}\documentation.pdf"; Description: "查看用户手册"; Flags: postinstall shellexec skipifsilent

4.3 差异化部署策略

针对不同用户群体可以设计多种安装模式：

[Types]
Name: "full"; Description: "完整安装"
Name: "compact"; Description: "精简安装"
Name: "custom"; Description: "自定义安装"; Flags: iscustom

[Components]
Name: "main"; Description: "主程序"; Types: full compact custom; Flags: fixed
Name: "docs"; Description: "文档"; Types: full
Name: "samples"; Description: "示例项目"; Types: full

5. 持续集成自动化方案

5.1 命令行编译脚本

将安装包制作集成到CI流程中：

:: 使用windeployqt打包
windeployqt --release --no-compiler-runtime --dir deploy MyApp.exe

:: 编译Inno Setup脚本
ISCC.exe /O"output" /F"MyApp_Setup" setup.iss

5.2 版本号自动同步

在CMake中生成版本信息头文件：

configure_file(
  ${CMAKE_SOURCE_DIR}/version.h.in
  ${CMAKE_BINARY_DIR}/version.h
)

然后在Inno Setup脚本中引用：

#define AppVersion GetStringFileInfo("..\build\MyApp.exe", "ProductVersion")

6. 疑难问题解决方案库

6.1 常见错误代码处理

6.2 性能优化技巧

• 使用LZMA2压缩算法平衡体积与速度
• 对大型资源文件采用external标志单独压缩
• 通过Check函数实现硬件检测：

  function IsSSE42Supported: Boolean;
  begin
    Result := IsProcessorFeaturePresent(PF_XMMI64_INSTRUCTIONS_AVAILABLE);
  end;
  

在最近为某工业控制软件打包时，通过优化文件布局和压缩策略，我们将安装包体积从380MB缩减到215MB，同时安装时间缩短40%。关键是把频繁访问的DLL放在压缩块开头，而将大型数据文件设为单独压缩单元。