android tv主屏未显示app launcher图标

Android TV 主屏未显示 app launcher 图标可能是由多种原因造成的。以下是一些基础概念、可能的原因、解决方案以及相关应用场景的详细解释：

基础概念

App Launcher: 这是启动和管理应用程序的用户界面组件。
Android TV: 是专为电视设计的 Android 操作系统版本，侧重于内容发现和播放。

可能的原因

权限问题: 应用可能没有获得必要的权限来在主屏上创建快捷方式。
配置错误: 应用的 AndroidManifest.xml 文件可能没有正确配置主屏图标。
系统限制: 某些 Android TV 设备可能有特定的限制或 bug 影响应用图标的显示。
缓存问题: 设备或应用的缓存可能需要清除。

解决方案

检查权限

确保应用具有以下权限：

<uses-permission android:name="android.permission.INSTALL_SHORTCUT"/>

配置 `AndroidManifest.xml`

确保在 AndroidManifest.xml 中正确设置了主屏图标：

<application
    ...
    android:icon="@mipmap/ic_launcher"
    android:roundIcon="@mipmap/ic_launcher_round">
    <activity android:name=".MainActivity">
        <intent-filter>
            <action android:name="android.intent.action.MAIN" />
            <category android:name="android.intent.category.LAUNCHER" />
        </intent-filter>
    </activity>
</application>

清除缓存

用户可以尝试清除应用缓存和数据：
- 进入 设置 > 应用 > 选择你的应用 > 存储 > 清除缓存 和 清除数据。

使用快捷方式 API

如果上述方法都不奏效，可以尝试使用 Android 的快捷方式 API 动态创建快捷方式：

ShortcutManager shortcutManager = getSystemService(ShortcutManager.class);

ShortcutInfo shortcut = new ShortcutInfo.Builder(this, "id1")
    .setIntent(new Intent(Intent.ACTION_MAIN, Uri.EMPTY, this, MainActivity.class).setFlags(Intent.FLAG_ACTIVITY_CLEAR_TOP))
    .setShortLabel("App Name")
    .setIcon(Icon.createWithResource(this, R.drawable.ic_launcher))
    .build();

shortcutManager.setDynamicShortcuts(Arrays.asList(shortcut));