WiX v4 Burn引导程序：多语言本地化冲突解决及流程咨询

问题原因 #

WiX v4对内置引导程序应用（如WixStandardBootstrapperApplication）的本地化机制做了调整，不再支持v3中直接将多语言本地化文件作为Payload添加的方式。当你未给本地化文件指定唯一的Culture属性时，相同的标识符（如ProgressHeader）会被视为重复定义，触发WIX0100错误。

解决步骤 #

1. 规范本地化文件命名与配置 #

给每个语言的.wxl文件添加明确的Culture属性，确保WiX能区分不同语言的资源：

• 英文本地化文件（en-us.wxl）：

<WixLocalization Culture="en-us" xmlns="http://wixtoolset.org/schemas/v4/wxl">
  <String Id="ProgressHeader">Installing...</String>
  <!-- 其他英文本地化字符串 -->
</WixLocalization>

• 德文本地化文件（de-de.wxl）：

<WixLocalization Culture="de-de" xmlns="http://wixtoolset.org/schemas/v4/wxl">
  <String Id="ProgressHeader">Wird installiert...</String>
  <!-- 其他德文本地化字符串 -->
</WixLocalization>

2. 在Bundle项目中引用本地化文件 #

无需将本地化文件作为BootstrapperApplication的Payload，直接在项目中通过<WixLocalization>元素引用，WiX会在编译时将所有语言资源嵌入到引导程序中：

<Wix xmlns="http://wixtoolset.org/schemas/v4/wxs"
     xmlns:bal="http://wixtoolset.org/schemas/v4/wxs/bal">
  <!-- 引入多语言本地化文件 -->
  <WixLocalization SourceFile="en-us.wxl" />
  <WixLocalization SourceFile="de-de.wxl" />

  <Bundle>
    <BootstrapperApplication>
      <!-- 配置自定义的HyperlinkTheme -->
      <bal:WixStandardBootstrapperApplication Theme="HyperlinkTheme"
                                              ThemeFile="ModifiedHyperlinkTheme.xml" />
    </BootstrapperApplication>
    <!-- 其他Bundle包配置 -->
  </Bundle>
</Wix>

3. 确保Theme文件正确引用本地化标识符 #

修改后的HyperlinkTheme文件中，所有文本需通过!(loc.Identifier)格式引用本地化字符串，示例：

<Page Name="Progress">
  <Text X="10" Y="10" Width="-10" Height="30" FontId="2" Text="!(loc.ProgressHeader)" />
</Page>

WiX v4与v3本地化机制差异 #

• v3：内置引导程序应用的本地化文件需作为Payload添加到BootstrapperApplication中，运行时根据系统语言动态加载。
• v4：本地化资源在编译时通过带Culture属性的<WixLocalization>元素嵌入到引导程序中，无需额外配置Payload；WiX会自动根据系统UI语言匹配对应的本地化资源。

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