Qt Installer Framework v4.3下如何更新已安装程序的maintenancetool.dat？

问题本质 #

maintenancetool.dat包含安装程序的UI资源、自定义流程脚本等核心内容，且与设备的安装配置绑定，直接手动覆盖会丢失设备特定信息。要实现安装程序自身的更新，必须通过Qt Installer Framework（IFW）的官方更新机制处理，而非手动替换文件。

具体解决方案 #

1. 把安装程序自定义资源组件化

将图标、自定义安装脚本、UI布局等属于安装程序自身的资源，打包成一个独立的必需组件（比如命名为com.yourorg.installer.core）：

• 在组件的package.xml中设置<Essential>true</Essential>，确保初始安装时自动部署。
• 每次更新资源（比如更换图标）时，递增组件的<Version>号，比如从1.0.0改为1.0.1。

2. 配置维护工具的自我更新仓库

IFW支持单独为维护工具提供更新包，步骤如下：

• 使用binarycreator工具结合新的资源文件，重新生成维护工具更新包：

  binarycreator --maintenance-tool --output updated_maintenancetool ./your_installer_config_dir
  

• 将生成的updated_maintenancetool.exe和updated_maintenancetool.dat上传到你的更新仓库。
• 更新仓库根目录的Updates.xml，添加维护工具更新的元数据，示例片段：

  <Update>
    <Name>Maintenance Tool</Name>
    <Version>1.0.1</Version>
    <ReleaseDate>2024-05-20</ReleaseDate>
    <DownloadableArchives>updated_maintenancetool.exe,updated_maintenancetool.dat</DownloadableArchives>
    <Description>Updated installer icons and custom workflow</Description>
  </Update>
  

3. 触发维护工具的自我更新

• 在维护工具的启动逻辑或自定义脚本中，添加版本检查：调用maintenancetool.exe --version获取当前版本，与仓库Updates.xml中的最新版本对比。
• 若检测到更新，调用命令行触发自我更新：

  maintenancetool.exe --update --silent
  

  （--silent参数可实现无交互更新，根据需求选择是否添加）
• 注意：自我更新需要管理员权限，确保维护工具启动时请求管理员权限（可在安装程序配置中设置<RequireAdminRights>true</RequireAdminRights>）。

4. 设备特定信息的自动保留

IFW的维护工具更新机制会自动分离设备特定配置（如安装路径、已安装组件列表）与通用资源，更新过程中只会替换maintenancetool.dat中的资源部分，不会丢失设备专属信息，无需额外处理。

实操示例（更新图标） #

1. 替换安装程序配置目录中的图标文件。
2. 更新核心组件com.yourorg.installer.core的版本号。
3. 用binarycreator重新生成维护工具更新包，上传到仓库并更新Updates.xml。
4. 用户启动维护工具时，工具会自动检测到更新，完成下载替换后，新图标会立即生效。

内容的提问来源于stack exchange，提问作者hummingbird