VS2022开发Blazor Hybrid App：如何添加至Android TV模拟器主屏幕及应用菜单

核心原因 #

Android TV对应用的清单配置有特殊要求，默认的Blazor Hybrid/MAUI Android模板未适配TV端的启动器类别和横幅配置，导致系统不将其识别为可展示在主屏幕的TV应用。

具体修复步骤 #

1. 修改AndroidManifest.xml #

找到项目中Platforms/Android/AndroidManifest.xml文件，调整<activity>节点的intent-filter，添加TV专属的启动类别：

<intent-filter>
    <action android:name="android.intent.action.MAIN" />
    <!-- 添加TV启动器类别，让系统识别为TV应用 -->
    <category android:name="android.intent.category.LEANBACK_LAUNCHER" />
    <!-- 保留原有类别，兼容普通Android设备 -->
    <category android:name="android.intent.category.LAUNCHER" />
</intent-filter>

2. 添加Android TV应用横幅 #

Android TV要求应用提供横幅图标，否则可能无法在主屏幕展示：

• 在Platforms/Android/Resources/drawable目录下添加横幅图片（建议尺寸320x180px，PNG格式），命名为banner.png
• 在AndroidManifest.xml的<application>节点中添加横幅配置：

<application ...
    android:banner="@drawable/banner">

3. 适配TV端Activity主题 #

检查<activity>节点的主题配置，确保使用适配TV的主题（MAUI默认主题通常兼容，若有异常可调整）：

<activity
    android:name=".MainActivity"
    android:exported="true"
    android:theme="@style/Maui.SplashTheme"
    android:configChanges="orientation|keyboardHidden|keyboard|screenSize|smallestScreenSize|locale|layoutDirection|fontScale|screenLayout|density|uiMode"
    android:launchMode="singleTop">

4. 重新部署应用 #

修改完成后，先清理项目（右键项目→清理），再重新部署到Android TV模拟器，此时应用图标应能在主屏幕/应用菜单中显示。

额外排查点 #

• 确认使用的是Android TV API 33标准模拟器镜像，而非普通手机模拟器
• 检查应用是否处于“禁用”状态（设置→应用中查看），若禁用则启用后重启模拟器
• 若问题仍存在，尝试通过AVD管理器擦除模拟器数据后重新部署

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