.NET Maui TabBar在iOS启动时出现黑屏问题咨询

我的.NET Maui项目中使用以下TabBar代码，在Android平台运行正常，但iOS平台启动后仅显示黑屏。想了解iOS平台的TabBar图标是否存在特殊行为？

<TabBar>
    <Tab Title="Home" Icon="reshot.svg"  >
        <ShellContent Title="Home" ContentTemplate="{DataTemplate local:MainPage}" Route="MainPage" />
    </Tab>
    <Tab Title="Page1" Icon="dotnet_bot.svg">
        <ShellContent Title="Page1" ContentTemplate="{DataTemplate local:Page1}" Route="Page1" />
    </Tab>
    <Tab Title="Page2" Icon="dotnet_bot.svg" >
        <ShellContent Title="Page2" ContentTemplate="{DataTemplate local:Page2}" Route="Page2" />
    </Tab>

    <Tab Title="Page3" Icon="dotnet_bot.svg" >
        <ShellContent Title="Page2" ContentTemplate="{DataTemplate local:Page1}" Route="Page1" />
    </Tab>

    <Tab Title="Page4" Icon="dotnet_bot.svg"  >
        <ShellContent Title="Page2" ContentTemplate="{DataTemplate local:Page2}" Route="Page2" />
    </Tab>
</TabBar>

iOS启动黑屏截图

iOS平台TabBar图标的特殊行为及解决方案 #

核心特殊点 #

• SVG图标支持局限：iOS对Shell TabBar中的SVG图标渲染支持不完善，直接使用SVG会导致图标加载失败，进而触发Shell初始化异常，最终显示黑屏。Android对SVG的适配性更好，因此无此问题。
• 图标资源规范严格：iOS要求TabBar图标必须提供适配不同分辨率的位图资源（如PNG格式），且需遵循文件名@2x.png、文件名@3x.png的命名规则，确保在不同设备上正常显示。
• 初始化容错性差异：当TabBar图标加载失败时，iOS的Shell组件无法完成正常初始化流程，而Android会降级处理（比如显示默认图标或空白），不会直接导致黑屏。

具体修复步骤 #

1. 替换图标格式：将所有Tab的Icon属性值替换为PNG格式文件，同时准备好对应分辨率的版本（如reshot.png、reshot@2x.png、reshot@3x.png）。
2. 检查资源配置：确保图标文件的Build Action设置为MauiIcon，这样Maui会自动为iOS平台处理图标适配。
3. 修复路由冲突：代码中存在重复的Route值（Page3、Page4复用了Page1、Page2的Route），这会干扰Shell的路由系统，建议为每个Tab设置唯一的Route名称。
4. 逐步排查验证：先简化TabBar，只保留1-2个使用有效PNG图标的Tab，确认能正常启动后，再逐步添加其他Tab，排查是否存在其他问题。

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