WPF项目通过WIX部署时NuGet本地化资源DLL丢失问题求解

以下是几种针对性的解决方法，按实操优先级排序：

1. 手动在WIX项目中添加卫星DLL引用 #

本地化DLL（卫星DLL）通常存放在输出目录的语言子目录（如zh-CN、en-US）中，WIX默认不会自动识别这些子目录及文件，需要手动配置：

步骤： #

• 在WIX的主安装包文件中，按语言目录结构添加Directory和Component节点：

<Directory Id="INSTALLFOLDER" Name="MyApp">
    <!-- 主程序文件 -->
    <Component Id="MainApplication" Guid="*">
        <File Source="$(var.YourWpfProject.TargetPath)" />
    </Component>

    <!-- 中文本地化DLL -->
    <Directory Id="ZHCN_DIR" Name="zh-CN">
        <Component Id="ZhCnSatelliteDll" Guid="*">
            <File Source="$(var.YourWpfProject.TargetDir)zh-CN\YourNuGetPackage.resources.dll" />
        </Component>
    </Directory>

    <!-- 英文本地化DLL -->
    <Directory Id="ENUS_DIR" Name="en-US">
        <Component Id="EnUsSatelliteDll" Guid="*">
            <File Source="$(var.YourWpfProject.TargetDir)en-US\YourNuGetPackage.resources.dll" />
        </Component>
    </Directory>
</Directory>

• 将这些组件添加到Feature节点中，确保安装时被包含：

<Feature Id="ProductFeature" Title="MyApp" Level="1">
    <ComponentRef Id="MainApplication" />
    <ComponentRef Id="ZhCnSatelliteDll" />
    <ComponentRef Id="EnUsSatelliteDll" />
</Feature>

2. 用WIX Heat工具自动收集卫星DLL #

如果有多个语言版本，手动添加容易遗漏，可使用WIX自带的heat工具自动扫描输出目录并生成WIX配置：

步骤： #

• 在WIX项目的预构建事件中添加以下命令（替换为你的项目路径）：

heat dir "$(var.YourWpfProject.TargetDir)" -dr INSTALLFOLDER -cg SatelliteComponents -gg -sfrag -suid -out "$(ProjectDir)SatelliteFiles.wxs"

参数说明：

• -dr：指定根目录ID（对应WIX中的INSTALLFOLDER）
• -cg：生成的组件组名称
• -gg：自动生成组件GUID
• -sfrag：生成片段而非完整的WIX文档
• 在主WIX文件中引用生成的组件组：

<Fragment>
    <Feature Id="ProductFeature" Title="MyApp" Level="1">
        <ComponentGroupRef Id="SatelliteComponents" />
    </Feature>
</Fragment>

• 若生成的配置包含无关文件，可手动编辑SatelliteFiles.wxs删除不需要的节点，或用-x参数在heat命令中排除目录。

3. 检查自研NuGet包的打包配置 #

确保NuGet包在打包时正确包含了本地化资源，否则项目引用后无法将卫星DLL复制到输出目录：

步骤： #

• 在NuSpec文件中，明确指定卫星DLL的目标路径：

<files>
    <file src="bin\Release\net6.0\YourNuGetPackage.dll" target="lib/net6.0" />
    <file src="bin\Release\net6.0\zh-CN\YourNuGetPackage.resources.dll" target="lib/net6.0/zh-CN" />
    <file src="bin\Release\net6.0\en-US\YourNuGetPackage.resources.dll" target="lib/net6.0/en-US" />
</files>

• 重新打包NuGet包并更新项目中的引用，确认本地构建输出目录已包含语言子目录及对应DLL。

4. 验证WPF项目的本地化设置 #

排除项目本身的配置问题导致卫星DLL未被复制到输出目录：

步骤： #

• 打开WPF项目的.csproj文件，确保没有排除卫星DLL的配置：

<!-- 确保不存在类似以下的排除配置 -->
<!-- <ExcludeFilesFromDeployment>zh-CN\*.dll;en-US\*.dll</ExcludeFilesFromDeployment> -->

• 添加或确认以下属性，确保NuGet依赖文件被复制到输出目录：

<PropertyGroup>
    <CopyLocalLockFileAssemblies>true</CopyLocalLockFileAssemblies>
</PropertyGroup>

测试验证 #

1. 重新构建WPF项目，检查输出目录下的语言子目录及DLL是否存在
2. 构建WIX项目生成安装包
3. 安装后查看目标目录，确认语言子目录和对应的本地化DLL已部署完成

内容的提问来源于stack exchange，提问作者Dávid Terhes