Android TV应用设备目录状态显示Not opted in，TV端商店无展示求助

核心修复步骤 #

• 校验TV适配核心配置
  检查AndroidManifest.xml的关键声明：

  • 必须添加Leanback特性声明：<uses-feature android:name="android.software.leanback" android:required="true"/>
  • 启动Activity需绑定LEANBACK_LAUNCHER分类：

    <activity ...>
        <intent-filter>
            <action android:name="android.intent.action.MAIN" />
            <category android:name="android.intent.category.LEANBACK_LAUNCHER" />
        </intent-filter>
    </activity>
    

  • 移除不必要的手机专属硬件特性声明（如android.hardware.telephony），这类声明会导致TV设备被自动排除

• 修正Play Console设备目录设置

  1. 进入Play Console「设备目录」页面
  2. 筛选出状态为“Not opted in”的设备组，查看右侧的排除原因（通常会明确标注是特性、权限或API等级不匹配）
  3. 根据提示调整应用配置后重新提交版本，返回设备目录手动勾选对应TV设备组的「Opt in」选项

• 验证安装包兼容性
  用Android Studio的APK Analyzer打开APK/AAB文件，确认：

  • Manifest中的TV配置无误
  • 未包含会干扰适配判定的冗余手机端资源

• 确认发布状态
  确保应用处于正式发布轨道（而非测试版），且发布区域覆盖目标TV设备所在地区；网页端可访问但TV端搜不到，基本是适配规则问题而非区域限制

额外提示 #

首次发布TV应用后，Play Store可能需要1-2小时完成设备目录同步，提交新版本后可稍作等待再检查状态；minSdkVersion建议设为21及以下，适配主流Android TV设备

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