升级至WiX v5后引导程序应用图标与UI无法显示问题求助

问题现象 #

• 从WiX v3.11升级到v5版本后，引导程序主窗口仅显示标题栏，其余区域为空白
• 原有的图标、按钮、文本、图片等所有UI元素均无法显示

已尝试的排查步骤 #

• 简化Theme文件：创建最小化的theme.xml文件定位问题，空白现象仍存在
• 启用详细日志：开启verbose日志收集信息，未获取到有效排查线索
• 测试预定义主题：使用WiX官方提供的预定义主题测试，问题依旧
• 验证资源路径：确认主题文件及所有关联资源的路径配置正确且可访问

简化后的Theme.xml代码 #

<?xml version="1.0" encoding="UTF-8"?>
<Theme xmlns="http://wixtoolset.org/schemas/v4/wxs/theme">
    <Font Id="WixUI_Font_Title" Name="Arial" Size="14" Height="20" Bold="yes" />
    <Font Id="WixUI_Font_Normal" Name="Arial" Size="10" Height="13" />
    <Window Id="MainWindow" Width="500" Height="400" Background="white" Title="[ProductName] Setup" FontId="WixUI_Font_Normal" Caption="TestAPP">
        <Text Id="Title" X="10" Y="10" Width="480" Height="30" FontId="WixUI_Font_Title" Caption="Welcome to the [ProductName] setup wizard" />
        <Button Id="NextButton" X="400" Y="350" Width="80" Height="30" Text="Next" />
        <Button Id="CancelButton" X="310" Y="350" Width="80" Height="30" Text="Cancel" />
    </Window>
</Theme>

可能的解决方案 #

1. 修正Theme命名空间：WiX v5的主题命名空间已更新为http://wixtoolset.org/schemas/v5/wxs/theme，当前代码中使用的是v4命名空间，这会导致主题无法被Bootstrapper正确解析，需替换xmlns属性值。
2. 检查Bootstrapper项目引用：确保项目已正确引用WiX v5的Bootstrapper相关扩展包（如WixToolset.Bootstrapper.Runtime.wixext），避免版本不匹配。
3. 确认主题文件嵌入属性：在Bootstrapper项目中，将theme.xml文件的属性设置为Embedded Resource，或在Bundle配置中通过ThemePath正确指定文件路径。
4. 调整窗口属性：WiX v5中窗口的Title和Caption属性可能存在逻辑冲突，建议仅保留Title属性并设置为需要显示的窗口标题。

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