能否用WiX 4.0.3在.NET Core 6及以上编写托管代码自定义操作？

可行性说明 #

WiX 4.0.3完全支持在.NET Core 6及以上版本开发Windows Installer托管自定义操作，虽然Windows Installer本身仅能在Windows平台运行，但你可以将整个自定义操作项目迁移至.NET Core生态，只需确保项目为Windows平台专属的类库类型。

解决编译错误的核心步骤 #

你遇到的编译错误本质是项目类型或NuGet依赖配置不正确，按以下步骤修正：

1. 创建正确的项目类型：必须创建Windows类库（.NET），而非通用类库。通用类库不包含Windows平台API绑定，无法兼容WiX DTF（Deployment Tools Foundation）组件。
2. 引用正确的NuGet包：弃用旧的Microsoft.Deployment.WindowsInstaller，改用WiX 4官方DTF包：

   Install-Package WixToolset.Dtf.WindowsInstaller -Version 4.0.3
   

3. 调整项目文件配置：确保目标框架指定为Windows专属版本，同时锁定架构（与安装包架构一致），示例项目文件：

   <Project Sdk="Microsoft.NET.Sdk">
     <PropertyGroup>
       <TargetFramework>net6.0-windows</TargetFramework>
       <PlatformTarget>x86</PlatformTarget> <!-- 或x64，需与安装包架构匹配 -->
       <Nullable>enable</Nullable>
       <ImplicitUsings>enable</ImplicitUsings>
     </PropertyGroup>
   
     <ItemGroup>
       <PackageReference Include="WixToolset.Dtf.WindowsInstaller" Version="4.0.3" />
     </ItemGroup>
   </Project>
   

自定义操作编写示例 #

使用WiX 4 DTF的[CustomAction]属性标记操作方法，示例代码：

using WixToolset.Dtf.WindowsInstaller;

public class CustomActions
{
    [CustomAction]
    public static ActionResult MySampleAction(Session session)
    {
        session.Log("执行.NET 6自定义操作：MySampleAction");
        
        // 在此编写你的业务逻辑，如读取安装参数、修改系统配置等
        var productName = session["ProductName"];
        session.Log($"当前安装产品：{productName}");

        return ActionResult.Success;
    }
}

打包配置要点 #

在WiX项目中引用自定义操作DLL，并配置调用逻辑：

<!-- 引用自定义操作二进制文件 -->
<Binary Id="CustomActions.dll" SourceFile="..\CustomActions\bin\$(Configuration)\net6.0-windows\CustomActions.dll" />

<!-- 定义自定义操作 -->
<CustomAction Id="InvokeMySampleAction" BinaryKey="CustomActions.dll" DllEntry="MySampleAction" Execute="Immediate" Return="check" />

<!-- 在安装序列中触发操作 -->
<InstallExecuteSequence>
    <Custom Action="InvokeMySampleAction" After="InstallInitialize" />
</InstallExecuteSequence>

关键注意事项 #

• 架构一致性：自定义操作的编译架构（x86/x64）必须与WiX安装包的架构完全匹配，否则会出现运行时加载失败。
• 自包含部署：为避免目标机器缺少.NET Core运行时，建议将自定义操作项目设置为自包含部署，在项目文件中添加：

  <PropertyGroup>
    <PublishSingleFile>true</PublishSingleFile>
    <SelfContained>true</SelfContained>
    <RuntimeIdentifier>win-x86</RuntimeIdentifier> <!-- 或win-x64 -->
  </PropertyGroup>
  

• 日志调试：通过session.Log()输出调试信息，可在安装时通过msiexec /i setup.msi /l*v install.log查看详细日志。

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