如何为已有的手机/平板应用添加Android TV适配支持？

一、Manifest文件必须补全的关键配置 #

不少开发者改完Manifest后TV仍识别为手机应用，大多是漏了以下核心配置：

• 声明TV应用标识：在<application>标签内添加android:banner="@drawable/tv_banner"，这是TV应用的必备标识，缺失的话系统会判定为手机应用。
• 为启动页配置双Intent Filter：
  主Activity需要同时适配两类设备，需添加TV专属的Intent Filter，并设置leanbackLaunchMode属性：

  <activity
      android:name=".MainActivity"
      android:exported="true"
      android:leanbackLaunchMode="default">
      <!-- 手机/平板启动入口 -->
      <intent-filter>
          <action android:name="android.intent.action.MAIN" />
          <category android:name="android.intent.category.LAUNCHER" />
      </intent-filter>
      <!-- TV启动入口 -->
      <intent-filter>
          <action android:name="android.intent.action.MAIN" />
          <category android:name="android.intent.category.LEANBACK_LAUNCHER" />
      </intent-filter>
  </activity>
  

• 禁用TV无关的硬件特性：如果应用包含手机专属功能（如电话、触摸屏依赖），需在<uses-feature>中声明非强制，避免被TV系统过滤：

  <uses-feature android:name="android.hardware.telephony" android:required="false" />
  <uses-feature android:name="android.hardware.touchscreen" android:required="false" />
  

  其中android.hardware.touchscreen设为false尤为关键，TV设备无触摸屏，该属性直接影响系统对应用类型的判定。

二、布局适配的两种高效实现方式 #

1. 资源目录区分法（推荐） #

利用Android资源限定符自动适配，无需额外代码：

• 在res目录下新建layout-tv文件夹，将TV版布局文件放入（文件名需与手机版一致，如activity_main.xml）
• 手机/平板布局保留在默认layout或layout-sw600dp（平板专属）目录
• 系统会根据设备类型自动加载对应目录的布局

2. 代码动态判断加载 #

若需更灵活的逻辑控制，可在Activity中手动判断设备类型：

override fun onCreate(savedInstanceState: Bundle?) {
    super.onCreate(savedInstanceState)
    val isTvDevice = packageManager.hasSystemFeature(PackageManager.FEATURE_LEANBACK)
    setContentView(if (isTvDevice) R.layout.activity_main_tv else R.layout.activity_main)
}

Java版本逻辑一致，通过getPackageManager().hasSystemFeature(PackageManager.FEATURE_LEANBACK)完成设备类型判断。

三、调试排查必做要点 #

• 清理项目缓存：执行Build > Clean Project和Build > Rebuild Project，避免旧Manifest缓存导致配置不生效
• 确认模拟器类型：必须使用Android TV专属模拟器（如“Android TV (1080p)”），不要用平板模拟器替代
• 检查应用属性：在TV模拟器设置中查看应用信息，确认“应用类型”显示为“Android TV应用”，若仍为手机应用，说明Manifest配置存在遗漏
• 从TV应用列表启动：不要直接通过AS运行按钮启动，需在TV模拟器的应用列表中找到带banner图的应用入口启动，避免AS默认使用手机启动模式

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