WixSharp升级未保留配置数据及交互不友好问题咨询

针对你遇到的两个核心问题——升级时保留用户自定义配置/数据，以及优化升级交互实现后台静默升级，我整理了具体的解决方案：

一、保留用户修改的配置文件和自定义文件夹数据 #

要避免升级时覆盖用户手动修改的配置或删除自定义数据，需要通过组件标记来精准保护这些资源：

1. 保护用户可修改的配置文件 #

将配置文件（如appsettings.json、*.config）放在独立的Component中，设置NeverOverwrite=true确保已修改的文件不会被新版本覆盖，同时保持Permanent=false以便卸载时正常清理：

// 创建配置文件组件，使用固定GUID避免每次构建变更
var configComponent = new Component("AppConfigComponent", new File(@"Files\appsettings.json"))
{
    NeverOverwrite = true, // 已存在且被修改的文件不覆盖
    Permanent = false,     // 卸载时删除，升级时保留
    Guid = new Guid("YOUR-FIXED-GUID-FOR-THIS-COMPONENT")
};
project.Components.Add(configComponent);

2. 保留自定义文件夹数据 #

对于Program Files下用户创建的自定义文件夹（如CustomData），通过标记Component为Permanent=true确保升级时不删除该文件夹及其内容，同时用RemoveFolderEx保证卸载时清理空文件夹：

// 将自定义文件夹挂在主安装目录下
var customDataDir = new Directory("CustomData", project.Dirs[0]);

// 创建保护文件夹的组件，使用固定GUID
var customDataComponent = new Component("CustomDataComponent", customDataDir)
{
    Permanent = true, // 升级时保留整个文件夹
    Guid = new Guid("YOUR-FIXED-GUID-FOR-THIS-COMPONENT")
};

// 添加卸载时清理空文件夹的规则
customDataComponent.Add(new RemoveFolderEx
{
    Id = "RemoveCustomDataFolder",
    On = RemoveFolderEx.OnUninstall,
    Directory = customDataDir.Id
});

project.Components.Add(customDataComponent);

关键注意点 #

• 确保project.MajorUpgrade.MigrateFeatures=true已启用（你代码中已设置），这会迁移旧版本的组件状态，保留用户已安装的资源。
• 受保护的Component必须使用固定的GUID，不能随每次构建变更，否则MSI会将其视为新组件，导致旧组件被误删。

二、优化升级交互，实现后台静默升级 #

当前升级时显示全新安装、末尾提示卸载旧版本，是因为升级时机和UI配置不当，调整如下：

1. 调整MajorUpgrade的升级时机 #

将Schedule改为UpgradeSchedule.afterInstallInitialize，这个时机在安装初始化后立即后台卸载旧版本，用户不会看到卸载界面：

project.MajorUpgrade = new MajorUpgrade
{
    Schedule = UpgradeSchedule.afterInstallInitialize, // 后台静默卸载旧版本
    AllowSameVersionUpgrades = true,
    MigrateFeatures = true,
    IgnoreRemoveFailure = true,
    DowngradeErrorMessage = "A new version of this product is already installed.",
    AllowDowngrades = false,
    SuppressUninstallWarning = true // 禁用卸载警告弹窗
};

2. 确保版本号正确触发升级 #

MSI仅识别版本号的前三位（主版本.次版本.构建版本），第四位修订号不会触发升级检测。因此每次升级必须修改前三位中的至少一位，例如从6.1.1.1改为6.1.2.0或6.2.0.0。

3. 配置UI实现无交互升级 #

如果希望全程静默升级，可设置UI为仅显示进度条，或完全静默：

// 仅显示进度条，无用户交互
project.UI = WixUI.ProgressOnly;

// 也可以在启动安装包的脚本中判断，若检测到已安装版本，自动添加/qn静默参数运行

关键注意点 #

• 保持UpgradeCode固定（你已正确设置），ProductId每次构建生成新GUID（你已正确设置），这是MSI识别同一产品升级的核心。
• 确保安装范围（InstallScope）一致，若旧版本是PerMachine，新版本也必须是PerMachine，否则会被视为不同产品，无法触发升级。

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