如何在WiX 5项目的wxs文件中引用NuGet内容文件并打包进MSI？

核心问题 #

WiX项目的构建系统不会自动处理NuGet包中contentFiles的复制或引用逻辑，即使VS中能看到文件快捷方式，文件仍存放在NuGet缓存目录，无法直接被WiX打包。以下是无需中间项目的直接解决方案：

方案1：将NuGet内容文件复制到输出目录后引用 #

通过修改WiX项目文件（.wixproj）添加MSBuild目标，自动把NuGet缓存中的SQL文件复制到输出目录，再在wxs中引用输出目录的文件：

1. 修改wixproj文件，添加以下MSBuild目标：

<Target Name="CopyNuGetContentFiles" BeforeTargets="Compile">
  <ItemGroup>
    <!-- 替换为你的NuGet包ID -->
    <NuGetContentFiles Include="$(NuGetPackageRoot)my.nuget.package\$(PackageVersion)\contentFiles\any\any\*.sql" />
  </ItemGroup>
  <!-- 保持原目录结构复制到输出目录 -->
  <Copy SourceFiles="@(NuGetContentFiles)" DestinationFiles="@(NuGetContentFiles->'$(OutputPath)\%(RecursiveDir)%(Filename)%(Extension)')" />
</Target>

$(PackageVersion)会自动读取PackageReference中配置的包版本，无需手动修改。

2. 在wxs文件中引用输出目录的文件：

<ComponentGroup Id="SqlFiles" Directory="INSTALLFOLDER">
  <Component Id="SqlComponent" Guid="*">
    <File Source="$(var.TargetDir)\*.sql" Recursive="yes" />
  </Component>
</ComponentGroup>

方案2：直接引用NuGet缓存中的文件（无需复制） #

如果不想复制文件，可以直接在wxs中通过WiX支持的MSBuild变量引用NuGet缓存路径：

1. 在wixproj中定义包版本变量（或自动获取）：

<PropertyGroup>
  <!-- 替换为你的NuGet包版本 -->
  <MyNuGetPackageVersion>1.0.0</MyNuGetPackageVersion>
</PropertyGroup>

可选：自动获取最新包版本（稳定性略差）：

<MyNuGetPackageVersion>$([MSBuild]::GetRegistryValueFromView('HKEY_CURRENT_USER\Software\NuGet\RepositoryPackages\my.nuget.package', 'LatestVersion', null, RegistryView.Default))</MyNuGetPackageVersion>

2. 在wxs文件中直接引用缓存路径：

<ComponentGroup Id="SqlFiles" Directory="INSTALLFOLDER">
  <Component Id="SqlComponent" Guid="*">
    <File Source="$(var.NuGetPackageRoot)my.nuget.package\$(var.MyNuGetPackageVersion)\contentFiles\any\any\*.sql" Recursive="yes" />
  </Component>
</ComponentGroup>

额外优化建议 #

调整NuGet包的contentFiles配置，将buildAction设为None（WiX不需要将文件标记为Content类型）：

<contentFiles>
  <files include="any\any\*.sql" buildAction="None" copyToOutput="true" flatten="false" />
</contentFiles>

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