Android TV自定义启动器重启后恢复为系统默认启动器问题排查

• 启动器组件配置不完整
  检查AndroidManifest.xml中启动器Activity的intent-filter是否包含TV必备的类别声明。正确的配置需覆盖以下内容，缺少LEANBACK_LAUNCHER会导致系统重启时无法识别你的应用为TV启动器：

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

• 厂商ROM的启动器锁定机制
  部分TV厂商会给系统启动器设置强制优先级，或在系统层面锁定默认启动器选项。排查方向：

  • 进入开发者选项，查找是否存在“默认启动器锁定”类开关，尝试关闭；
  • 若设备已Root，可尝试禁用系统启动器组件（操作前务必备份，避免设备无法正常启动）。

• 权限缺失导致识别异常
  确保你的应用已申请并获取以下关键权限：

  • android.permission.RECEIVE_BOOT_COMPLETED：保证系统开机时能正确识别并拉起你的启动器；
  • 部分设备需android.permission.SYSTEM_ALERT_WINDOW：用于维持启动器的前台优先级。
    同时要确认开机广播接收器已正确注册，避免系统开机时跳过你的应用。

• 系统缓存状态异常
  系统默认启动器的状态可能存在缓存冲突，即使设置界面显示默认是你的应用，开机时系统仍读取旧缓存。可尝试：

  • 清除系统设置应用的缓存与数据；
  • 清除自定义启动器的缓存与数据，重新设置为默认启动器；
  • 重启前强制停止系统启动器（若系统允许操作）。

• 启动器启动速度过慢触发 fallback
  若自定义启动器开机初始化耗时过长，系统会因等待超时自动切换到系统启动器。优化方向：

  • 延迟启动时非必要的初始化任务，优先完成核心UI渲染；
  • 给启动器Activity设置android:launchMode="singleTask"，确保实例唯一；
  • 将启动时的IO、网络操作改为异步执行，避免阻塞主线程。

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