WinMerge 安装程序构建指南:基于 Inno Setup 的 Installer 打包全流程
WinMerge 安装程序构建指南:基于 Inno Setup 的 Installer 打包全流程
本文面向需要从源码构建 WinMerge 安装包的开发者和发布维护者,系统讲解 WinMerge 仓库中 Installer/InnoSetup/README.md 所定义的安装程序构建流程:从环境准备、脚本选型、素材清单到使用 ISTool 或命令行完成编译与产物测试。读完本文,你将能够独立完成 WinMerge 官方安装程序的打包、校验与发布命名,并理解安装脚本内部的文件装配、版本读取、注册表写入与 Shell 扩展注册等实现细节。
构建环境准备
构建 WinMerge 安装程序依赖以下两款工具:
| 工具 | 说明 |
|---|---|
| Inno Setup | 安装程序编译器,仓库脚本同时兼容 5.x 与 6.x 两个大版本 |
| ISTool(推荐) | Inno Setup 脚本的可视化管理工具,提供 "Verify Files..." 文件校验与 "Compile Setup" 一键编译,对大型安装脚本的维护帮助很大 |
安装脚本存放在仓库 Installer/InnoSetup 目录下,命名规则如下:
- Inno Setup 5.x:
WinMerge{arch}.iss,例如 WinMergeX86.iss、WinMergeX64.iss - Inno Setup 6.x:
WinMerge{arch}.is6.iss,例如 WinMergeX64.is6.iss、WinMergeARM64.is6.iss
其中 {arch} 为架构名,仓库当前提供 x86、x64、ARM64 三种架构的完整脚本,另外还有面向免管理员权限场景的 WinMergeX64NonAdmin.iss(PrivilegesRequired=lowest,安装到 {userpf}\WinMerge,产物命名为 WinMerge-{version}-x64-PerUser-Setup.exe)。
编译前 Checklist:确认素材齐全
官方 README 强调两点必须核实的前提:
- 版本号来源:安装程序从
WinMergeU.exe的版本资源中读取版本号(脚本内通过GetFileVersion预处理指令实现,见下节)。因此必须保证WinMergeU.exe的版本资源设置正确。 - 文件存在性:安装脚本会逐一检查列出的文件是否存在。但部分文件以整个目录(如
Plugins/dlls/{arch})或文件掩码(如*.flt)方式打包,这类文件不会精确到文件名校验,需要人工确认所有必需文件都已就位。
需要预先编译或下载的文件
| 类别 | 文件 / 目录 | 来源 |
|---|---|---|
| 主程序 | WinMergeU.exe |
编译 WinMerge 主工程 |
| 翻译 | Translations/WinMerge/*.po、Translations/ShellExtension/*.po |
仓库内 Translations 目录 |
| 手册 | WinMerge.chm(及多语言 .chm) |
编译 Docs/Manual 生成 |
| Shell 扩展 | ShellExtensionU.dll、ShellExtension{arch}.dll、WinMergeContextMenu.dll、WinMergeContextMenuPackage.msix |
编译 ShellExtension |
| 文档 | Docs/Users/*(ReadMe、ReleaseNotes、ChangeLog、GPL.rtf、Contributors) |
仓库内 Docs/Users |
| 过滤器 | Filters/*(.flt 与 FileFilter.tmpl) |
仓库内 Filters |
| 配色方案 | ColorSchemes/*(.ini) |
仓库内 ColorSchemes |
| 插件 | Plugins/dlls/{arch}/*.dll、*.sct、Plugins/Commands/**/*.bat、Plugins.xml |
仓库内 Plugins |
| 外部组件 | Frhed、WinIMerge、WinWebDiff、Merge7z、GNU patch、darkmodelib、tree-sitter-grammars、tidy-html5、jq、cliphcat、md4c | 执行 DownloadDeps.cmd 下载 |
README 明确指出:上述文件大多由编译 WinMerge、文档等工程产生,但"如何编译这些工程"不属于本文档讨论范围。
DownloadDeps.cmd:一键获取外部组件
对于 Frhed、WinIMerge、WinWebDiff、Merge7z、GNU patch 等外部二进制组件,仓库提供了 DownloadDeps.cmd 自动下载脚本。它依赖本机已安装 7-Zip(脚本会先检测 7z 命令),随后按照 urls_destdirs 列表中声明的下载地址与解压目标目录,逐项下载、解压:
- Merge7z / Frhed / WinIMerge / WinWebDiff / darkmodelib / tree-sitter-grammars 等按 x86、x64、ARM、ARM64 四个平台分别解压到
Build\{arch}\Release; - msys2 组件(
patch.exe、msys-2.0.dll等)被挑选出来复制到Build\msys2\usr\bin,供安装脚本中的Commands\msys2插件命令使用; - 脚本最后还会把 Filters、ColorSchemes、Plugins、ShellExtension 等目录同步复制到各平台的 Release 布局中,与安装脚本的
Source:路径一一对应。
从脚本结构可以推断,BuildInstaller.cmd 与 DownloadDeps.cmd 组成了完整的发布流水线:先下载依赖,再编译主程序,最后运行安装脚本生成安装包。
构建前目录结构要求
README 给出的标准素材目录布局如下(路径均相对仓库根目录):
Build/
msys2/ # GNU patch 运行时(msys2 组件)
*.*
Manual/htmlhelp/ # 手册 CHM
WinMerge*.chm
ShellExtension/
ShellExtension*.dll
{arch}/
WinMergeContextMenu.dll
WinMergeContextMenuPackage.msix
{arch}/
Release/
Frhed/ # 十六进制编辑器组件
*.*
Merge7z/ # 7-Zip 集成 DLL
*.*
WinMergeU.exe
Docs/
Users/
ChangeLog.html
Contributors.txt
GPL.rtf
ReadMe.txt
ReleaseNotes.html
ColorSchemes/
*.ini
Filters/
FileFilter.tmpl
*.flt
Plugins/
Commands/
**/*.bat
**/*.txt
dlls/
{arch}/
*.dll
*.sct
WinMerge32BitPluginProxy/Release/
WinMerge32BitPluginProxy.exe
Translations/
Docs/
*.*
InnoSetup/
*.isl
ShellExtension/
*.po
WinMerge/
*.po
需要特别说明的是:安装脚本中大量使用 ..\..\ 前缀的 Source: 路径(例如 ..\..\Build\{#ARCH}\Release\WinMergeU.exe),即脚本以 Installer/InnoSetup 为基准向上两级定位仓库根目录,因此务必保证上述目录结构与实际编译产物一致,否则 iscc.exe 编译会因找不到源文件而失败。
使用 ISTool 创建安装程序
README 的推荐流程(若不用 ISTool,则参照 Inno Setup 官方手册从脚本直接编译):
- 启动 ISTool,加载安装脚本(例如
WinMergeX64.is6.iss); - 从菜单选择 Project → Verify Files...,校验所有必需文件是否存在于正确目录;缺失文件须先补齐再继续;
- 从菜单选择 Project → Compile Setup 编译安装程序,编译过程耗时较长,需耐心等待。
编译成功后,安装包输出在仓库根目录的 Build 文件夹中,文件名为 WinMerge-{version}-Setup.exe(x64 为 WinMerge-{version}-x64-Setup.exe,见各脚本 [Setup] 段的 OutputDir=..\..\Build 与 OutputBaseFilename 配置)。
建议:清理文件名中的冗余零
README 特别给出一个发布建议(非强制规则):如果生成的安装包文件名是 WinMerge-2.6.0.0-Setup.exe,上传前建议重命名为 WinMerge-2.6-Setup.exe,去掉无意义的尾缀零,使文件名更简洁。
命令行批量构建:BuildInstaller.cmd
除了 ISTool 图形化编译,仓库还提供 BuildInstaller.cmd 一键脚本,它在 %ProgramFiles% 与 %ProgramFiles(x86)% 下自动探测 Inno Setup 5/6 的 iscc.exe 并调用编译:
- 无参数:依次构建 x86、x64、x64NonAdmin、ARM64 全部安装包;
x64:构建 x64 与 x64NonAdmin;x86:仅构建 x86;ARM64:优先尝试 Inno Setup 6(WinMergeARM64.is6.iss),否则回退 Inno Setup 5;- 其它参数:按传入的平台名尝试构建对应脚本。
脚本统一通过 /DTranslationsDir=..\..\Build\Translations 预处理宏把翻译目录指向 Build\Translations,与 DownloadDeps.cmd 复制的翻译产物衔接。
安装脚本实现剖析
版本号自动读取
所有脚本在头部通过 Inno Setup 预处理指令从 WinMergeU.exe 读取版本:
#define AppVersion GetFileVersion(SourcePath + "\..\..\Build\" + ARCH + "\Release\WinMergeU.exe")
#define ShellExtensionVersion GetFileVersion(SourcePath + "..\..\Build\ShellExtension\" + ShellExtension64bit)
#define WinMergeContextMenuVersion GetFileVersion(SourcePath + "..\..\Build\ShellExtension\" + ARCH + "\WinMergeContextMenu.dll")
AppVersion 同时用于 VersionInfoVersion(安装程序自身的版本资源)、SetupWindowTitle 以及 OutputBaseFilename,实现"一处编译、处处同步"。
[Setup] 关键配置
以 WinMergeX64.is6.iss 为例,[Setup] 段的核心参数:
| 参数 | 值 | 含义 |
|---|---|---|
AppName / AppVersion |
WinMerge / {#AppVersion} |
应用名与版本 |
DefaultDirName |
{autopf}\WinMerge |
默认安装目录(Program Files) |
PrivilegesRequired |
admin |
需要管理员权限(注册 Shell 扩展、写入 HKLM) |
PrivilegesRequiredOverridesAllowed |
dialog |
允许用户通过对话框选择降级安装 |
MinVersion |
0,6.1 |
最低 Windows 7 |
ArchitecturesInstallIn64BitMode |
{#ARCH} |
以 64 位模式安装 |
Compression / InternalCompressLevel |
lzma/ultra / ultra |
最大压缩比,脚本注释提醒 ultra 压缩约需 320MB 内存 |
SolidCompression |
true |
实心压缩,提高压缩率 |
ChangesAssociations / ChangesEnvironment |
true |
更新文件关联与系统 PATH |
OutputDir / OutputBaseFilename |
..\..\Build / WinMerge-{#AppVersion}-{#ARCH}-Setup |
输出位置与文件名 |
ShowLanguageDialog |
auto |
仅当未找到精确语言匹配时才显示语言选择对话框 |
SignTool / SignedUninstaller |
signbat $f / yes |
当环境变量 SIGNBAT_PATH 非空时启用代码签名 |
组件(Components)与任务(Tasks)
脚本定义了典型(typical)、完整(full)、紧凑(compact)、自定义(custom)四种安装类型:
- 组件:
Core(主程序与文档,fixed 不可取消)、ShellExtension32bit、filters、Plugins,以及约 40 个Languages\*语言子组件——语言组件会根据用户在语言选择页的选项自动决定默认勾选(Languages: Arabic/Languages: not Arabic两条声明实现"选中即装、不选不装")。 - 任务:
ShellExtension(资源管理器右键菜单)、modifypath(加入系统 PATH,默认不勾选)、TortoiseCVS/TortoiseGit/TortoiseSVN集成(通过Check:函数仅在检测到对应软件已安装时出现)、desktopicon、quicklaunchicon。
文件装配:从 [Files] 段看安装内容
[Files] 段是脚本最长的部分,安装内容大致分为:
- 主程序:
WinMergeU.exe、VisualElementsManifest、LogoImages、Resources、TreeSitterGrammars; - 32 位插件代理:
WinMerge32BitPluginProxy.exe(供 32 位插件在 64 位进程内运行); - Shell 扩展:32/64 位
ShellExtension*.dll与 Windows 11 使用的WinMergeContextMenu.dll、WinMergeContextMenuPackage.msix,均带uninsrestartdelete restartreplace标志以便替换被占用的 DLL; - 归档支持:
Merge7z\目录下的Merge7z.dll、7z.dll与语言文件; - 多语言:每个语言组件的
{arch}.po(主程序与 Shell 扩展各一份)与ReadMe-*.txt说明文档,以及法/希/意/日/西等语言的WinMerge{lang}.chm; - Filters / ColorSchemes:通过
*.flt、FileFilter.tmpl、*.ini掩码批量打入,flags 含sortfilesbyextension comparetimestamp ignoreversion; - 插件:
Plugins.xml、全部.sct脚本插件与dlls\{arch}\*.dll二进制插件; - 外部组件:
Frhed、WinIMerge、WinWebDiff、darkmodelib各自目录; - 命令工具:GNU patch(
Commands\msys2)、tidy-html5、cliphcat、jq、md4c,以及 Plugins/Commands 下的 PlantUML、Apache-Tika、q、yq、dumpbin、ildasm、Java、CFR、gettext 等命令插件。
注册表集成
[Registry] 段完成以下集成工作:
- 注册
.WinMerge工程文件关联(打开用WinMergeU.exe、编辑用NOTEPAD.EXE); - 写入
App Paths,让 WinMerge 可通过"开始菜单 → 运行"启动; - 写入
Software\Thingamahoochie\WinMerge\Executable供 Shell 扩展定位主程序; - 通过
ContextMenuEnabledDWORD 控制右键菜单开关(默认关闭,选中 ShellExtension 任务时置 1); - 检测并写入 TortoiseCVS / TortoiseGit / TortoiseSVN 的外部差异与合并工具配置,命令行为
WinMergeU.exe -e -ub -dl %bname -dr %yname %base %mine; - 依据语言选择对话框写入
Locale\LanguageId(各语言对应 LCID),使 WinMerge 启动语言与安装语言一致; - 清理旧版残留(如
LeftMax、DirViewMax及过时的 MessageBox 隐藏记录)。
管理员版(WinMergeX64.is6.iss)使用 HKA(HKLM 与 HKCU 合并写入)并配合 originaluser.iss 中 GetOriginalUserSID 解析"发起安装的原始用户"SID,把设置同时写入 HKLM 与原始用户的 HKCU 下。
Shell 扩展注册与 Explorer 重启
[Run] 段在安装结束时依次执行:
regsvr32.exe /s "{app}\ShellExtensionU.dll" ; 注册 32 位 Shell 扩展
regsvr32.exe /s "{app}\ShellExtensionX64.dll" ; 注册 64 位 Shell 扩展
WinMerge32BitPluginProxy.exe /RegServer ; 注册插件代理 COM 组件
PowerShell ... Add-AppxPackage ... ; Windows 11 下安装 MSIX 包
卸载时对应执行 /u 反注册与 /UnregServer。由于 Shell 扩展 DLL 被 explorer.exe 占用时无法直接删除,[Code] 段的 RenameShellExtensionDLLIfExists 先把旧 DLL 改名为 *.{PID}.old,安装完成后 DeleteRenamedShellExtensionDLL 尝试删除;若仍被占用,则询问用户是否重启 Explorer(taskkill /f /im explorer.exe 后重新拉起),并在 DeinitializeSetup 中兜底启动 Explorer。
PATH 修改与 Tortoise 三路合并选项
- PATH 修改:任务
modifypath借助 modpath.is6.iss 实现,ModPathDir()返回{app}目录,安装时将其追加到系统(管理员模式,HKLMSession Manager\Environment)或用户(非管理员模式,HKCUEnvironment)的 PATH 中;卸载时按uninsTasks.txt记录的任务还原。ChangesEnvironment=yes确保环境变量变更即时广播。 - 三路合并:选中 TortoiseGit/SVN 任务后会额外显示自定义向导页(
CreateCustomPage+TNewCheckListBox),让用户选择三路合并时的结果窗格(左/中/右)与是否自动合并,TortoiseSVNGitMergeToolCommandLine据此生成对应参数(如%base %theirs %mine /o %merged)。脚本通过RegisterPreviousData记住用户选择,升级安装时自动恢复。
升级与清理
[InstallDelete] / [UninstallDelete] 段会:
- 删除历史版本遗留文件(如 2.0 之前的
Diff.txt、早期 7-Zip 集成 DLLMerge7z457.dll等、旧.lang翻译文件、WinMerge.exe.manifest); - 当用户取消某组件时同步删除对应文件(如不装 Filters 则删除
{app}\Filters下的.flt与模板); - 卸载时清理
Merge7z*.dll、Codecs、Formats、Lang等可能由手工或旧安装器引入的残留,空目录(dirifempty)一并移除。
测试安装程序
README 最后强调必须测试安装程序。建议至少验证:
- 全新安装与覆盖升级两条路径;
- 语言选择、组件勾选与任务选项对安装内容的影响;
- 右键菜单、
.WinMerge文件关联、Tortoise 集成是否生效; - 卸载后注册表、PATH、开始菜单与安装目录是否完整清理。
总结
WinMerge 的安装程序由 Installer/InnoSetup 目录下多份按架构与 Inno Setup 版本组织的 .iss 脚本驱动,通过 DownloadDeps.cmd 汇集外部组件、BuildInstaller.cmd 自动探测编译器批量产出,覆盖了多语言组件化安装、Shell 扩展注册、Tortoise 系列集成、PATH 修改、版本自读取与签名发布等完整能力。掌握本文的流程与脚本要点,即可在发布周期内稳定复现官方安装包的构建。