React Native TV应用安装后主屏幕找不到，仅系统应用列表可见，原因是什么？

核心原因 #

绝大多数情况是Android TV端的应用配置异常导致系统无法识别为可启动的第三方应用，具体分为三类：

• 启动入口配置缺失
• 系统级权限/签名配置误用
• 安装路径不符合第三方应用要求

逐项排查方案 #

1. 检查AndroidManifest.xml启动配置 #

这是最高发的问题，TV应用必须配置专属的桌面启动过滤器，否则系统不会在主屏幕生成应用入口，默认将无启动入口的应用归类到系统应用分组。
请确认主Activity节点下包含以下配置：

<activity
    android:name=".MainActivity"
    android:exported="true">
    <!-- TV端主屏幕启动必须配置项 -->
    <intent-filter>
        <action android:name="android.intent.action.MAIN" />
        <category android:name="android.intent.category.LEANBACK_LAUNCHER" />
    </intent-filter>
    <!-- 如需兼容普通安卓设备可额外添加以下配置 -->
    <intent-filter>
        <action android:name="android.intent.action.MAIN" />
        <category android:name="android.intent.category.LAUNCHER" />
    </intent-filter>
</activity>

2. 检查系统级配置误用 #

查看AndroidManifest.xml的根标签，是否配置了android:sharedUserId="android.uid.system"，该配置会强制将应用标记为系统级应用，非定制ROM场景下请直接删除该配置。
同时确认打包应用使用的是普通的自签名证书，没有使用设备厂商的系统签名，用系统签名打包的应用无论其他配置如何都会被判定为系统应用。

3. 检查安装路径 #

普通第三方应用的默认安装路径为/data/app目录，如果应用被手动push到/system/app、/system/priv-app等系统分区，会被系统直接识别为系统应用，请使用标准的adb install <apk路径>命令安装测试包。 #

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