如何解决React Native Expo应用在Google Play商店的Android TV适配识别问题

问题情况 #

• 用Expo开发的Android TV应用，在模拟器及真机通过APK安装后能正常运行，但Google Play商店无法识别它为Android TV适配应用，导致TV设备端商店无法下载
• 已尝试在app.json的android字段中添加以下配置，但没有效果：

"intentFilters": [
    {
      "action": "MAIN",
      "category": ["LEANBACK_LAUNCHER"]
    }
  ]

• Google Play商店后台显示细分状态：未加入，TV设备的商店页面也找不到该应用

解决步骤 #

1. 补全app.json的TV适配配置 #

仅添加intentFilters不够，必须补充supportsLeanback和leanbackLauncher字段，完整的android配置示例：

"android": {
  "package": "com.你的应用包名",
  "versionCode": 1,
  "supportsLeanback": true, // 核心：声明应用支持Leanback框架
  "leanbackLauncher": true, // 启用TV启动器入口
  "intentFilters": [
    {
      "action": "MAIN",
      "category": ["LEANBACK_LAUNCHER"]
    }
  ]
}

2. 准备TV专用图标 #

Android TV要求必须提供Leanback横幅图标（尺寸320x180px），同时适配不同分辨率的方形图标。在app.json中配置图标路径：

"android": {
  // ...其他配置
  "icons": {
    "leanback": "./assets/tv-banner.png",
    "mdpi": "./assets/icon-mdpi.png",
    "hdpi": "./assets/icon-hdpi.png",
    // 根据需求补充其他分辨率图标
  }
}

3. 确认Expo SDK版本 #

使用Expo SDK 44及以上版本，旧版本对Android TV适配支持不完善，建议升级到最新稳定版。

4. 正确构建应用并验证配置 #

• 用eas build -p android构建AAB（Google Play优先推荐格式）或APK
• 若不确定配置是否生效，可执行expo prebuild生成原生文件，然后检查android/app/src/main/AndroidManifest.xml中是否包含以下代码：

<intent-filter>
  <action android:name="android.intent.action.MAIN" />
  <category android:name="android.intent.category.LEANBACK_LAUNCHER" />
</intent-filter>
<meta-data android:name="com.google.android.gms.tv.appcategory" android:value="ENTERTAINMENT" />
<uses-feature android:name="android.software.leanback" android:required="true" />

5. 配置Google Play后台 #

提交应用后，进入Google Play控制台：

• 打开商店存在 > 设备兼容性页面，确认Android TV设备选项已勾选
• 检查内容分级和目标受众是否符合TV应用的要求

验证方法 #

构建完成后，可通过以下方式确认配置生效：

• 在Android TV模拟器上安装构建好的安装包，查看是否出现在TV启动器中
• 检查生成的AndroidManifest.xml是否包含Leanback相关配置项

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