Wix3构建的MSI升级时移除KeyPath文件A并保留文件B的方案咨询

核心问题分析 #

原MSI的componentX组件包含文件A（隐式KeyPath）和B，现在要移除A，同时保证升级时删A留B、全新安装只部署B。之前的错误操作（新建组件、随意改KeyPath）导致目录清空，本质是破坏了MSI对组件状态的跟踪逻辑——组件GUID变更或组件被标记为卸载时，会删除关联的所有文件和目录。

具体实现步骤 #

• 修改原componentX定义，保留组件GUID
  绝对不能修改componentX的GUID，这是MSI识别组件是否已安装的核心标识。移除文件A的<File>节点，同时给文件B显式设置KeyPath="yes"，替代原来A的隐式KeyPath地位：

  <Component Id="componentX" Guid="原组件GUID（务必保留）" Directory="ReporterDir">
    <!-- 移除原文件A的<File>条目 -->
    <File Id="FileB" Source="你的文件B路径" KeyPath="yes" />
  </Component>
  

• 添加RemoveFile清理文件A
  在componentX内部加入<RemoveFile>元素，指定删除文件A，触发时机设为On="install"——这样升级时会执行删除操作，全新安装因A不存在无影响：

  <Component Id="componentX" Guid="原组件GUID" Directory="ReporterDir">
    <File Id="FileB" Source="你的文件B路径" KeyPath="yes" />
    <RemoveFile Id="CleanupFileA" Name="A.xml" On="install" />
  </Component>
  

关键逻辑说明 #

• 升级场景：MSI检测到componentX的KeyPath变为B，而B在旧版本中已存在，因此组件会被视为“已安装并需更新”，不会触发组件卸载，同时执行RemoveFile删除A，最终保留B和Reporter目录。
• 全新安装场景：componentX只部署B，RemoveFile因目标文件不存在不执行，Reporter目录随组件创建并保留B。

避坑注意事项 #

• 禁止将B移到新组件：新组件会被视为全新组件，原componentX会被标记为过时并卸载，连带删除B和Reporter目录。
• 禁止修改组件GUID：GUID变更会让MSI认为是新组件，原组件被卸载，同样导致目录清空。
• 不要设置RemoveFile的On="uninstall"：这会在卸载时删除B，不符合需求。
• 测试时务必覆盖两种场景：从旧版本升级、全新安装，验证文件A是否被移除、B是否保留、目录是否存在。

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