如何将自定义WiX扩展从v3版本迁移至v4版本？

核心迁移入手方向 #

• 先吃透v4扩展架构变更：WiX v4完全重构了扩展模型，原WixExtension基类被IWixExtension接口替代，扩展注册从属性驱动转为依赖注入模式，这是所有迁移工作的基础。
• 按优先级迁移组件：优先处理自定义表、自定义操作这类与Windows Installer核心交互的模块，再推进计划操作、UI相关逻辑的迁移。

具体迁移步骤 #

1. 项目基础调整 #

• 把项目目标框架切换为.NET 6或更高版本（WiX v4强制要求）。
• 替换NuGet依赖：移除WiX v3相关包（如WixToolset.Core），安装WixToolset.Extensibility及对应功能模块包（若涉及Office部署，确认v4生态下的基础依赖包）。

2. 自定义表迁移 #

• 原v3通过AddTable注册自定义表，v4需实现ITableDefinitionCreator接口，在DefineTables方法中用TableDefinitionBuilder构建表的列、主键等结构。
• 严格遵循Windows Installer表规范，v4对列类型、约束的校验比v3更严格，需确保表结构完全合规。

3. 自定义操作迁移 #

• 执行操作：原CustomAction类需适配ICustomAction接口，自定义操作的注册通过ICustomActionFactory实现，不再使用[CustomAction]特性。
• 计划操作：原v3通过ScheduleAction添加序列操作，v4需实现ISequenceBuilder接口，在BuildSequence方法中向InstallExecuteSequence或InstallUISequence添加自定义操作节点。

4. 扩展注册与集成 #

• 实现IWixExtension接口，在GetServices方法中注册自定义的表定义创建器、自定义动作工厂、序列构建器等服务。
• 在项目根目录创建wix.extension.json，配置扩展元数据（名称、命名空间等），确保WiX工具链能识别并加载扩展。

5. 验证与测试 #

• 使用WiX v4的candle、light工具重新编译扩展及关联安装包，排查编译阶段的兼容性错误。
• 实际测试Office/Visio插件的部署流程，验证自定义表数据写入、自定义动作执行、序列调度是否符合预期。

参考资源 #

• WiX v4官方文档的「Extensibility Model」和「Custom Actions」章节，是扩展迁移的核心参考。
• WiX v4官方示例库中的自定义扩展项目，可参考其项目结构、服务注册方式及代码实现。

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