WinMerge 安装程序构建指南:基于 Inno Setup 的 Installer 打包全流程

原创2026-09-24 10:57:001,733 阅读
文章标签:开发工具桌面应用代码评审

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 目录下,命名规则如下:

其中 {arch} 为架构名,仓库当前提供 x86、x64、ARM64 三种架构的完整脚本,另外还有面向免管理员权限场景的 WinMergeX64NonAdmin.iss(PrivilegesRequired=lowest,安装到 {userpf}\WinMerge,产物命名为 WinMerge-{version}-x64-PerUser-Setup.exe)。

编译前 Checklist:确认素材齐全

官方 README 强调两点必须核实的前提:

  1. 版本号来源:安装程序从 WinMergeU.exe 的版本资源中读取版本号(脚本内通过 GetFileVersion 预处理指令实现,见下节)。因此必须保证 WinMergeU.exe 的版本资源设置正确。
  2. 文件存在性:安装脚本会逐一检查列出的文件是否存在。但部分文件以整个目录(如 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 官方手册从脚本直接编译):

  1. 启动 ISTool,加载安装脚本(例如 WinMergeX64.is6.iss);
  2. 从菜单选择 Project → Verify Files...,校验所有必需文件是否存在于正确目录;缺失文件须先补齐再继续;
  3. 从菜单选择 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 扩展定位主程序;
  • 通过 ContextMenuEnabled DWORD 控制右键菜单开关(默认关闭,选中 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} 目录,安装时将其追加到系统(管理员模式,HKLM Session Manager\Environment)或用户(非管理员模式,HKCU Environment)的 PATH 中;卸载时按 uninsTasks.txt 记录的任务还原。ChangesEnvironment=yes 确保环境变量变更即时广播。
  • 三路合并:选中 TortoiseGit/SVN 任务后会额外显示自定义向导页(CreateCustomPage + TNewCheckListBox),让用户选择三路合并时的结果窗格(左/中/右)与是否自动合并,TortoiseSVNGitMergeToolCommandLine 据此生成对应参数(如 %base %theirs %mine /o %merged)。脚本通过 RegisterPreviousData 记住用户选择,升级安装时自动恢复。

升级与清理

[InstallDelete] / [UninstallDelete] 段会:

  • 删除历史版本遗留文件(如 2.0 之前的 Diff.txt、早期 7-Zip 集成 DLL Merge7z457.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 修改、版本自读取与签名发布等完整能力。掌握本文的流程与脚本要点,即可在发布周期内稳定复现官方安装包的构建。

登录后查看全文
winmerge