如何在Android应用中通过代码修改UI模式以适配电视盒子的TV资源？

原代码失效原因 #

• 直接赋值uiMode没有清除原有类型标记：uiMode为类型标记+夜间模式标记的组合字段，需先通过UI_MODE_TYPE_MASK清除原有类型位再赋值，否则会覆盖原有夜间模式配置、甚至赋值不生效
• 调用时机错误：在Activity启动后更新配置，已加载的资源不会自动刷新，必须在Context初始化阶段完成修改

正确实现步骤 #

1. 重写Application的attachBaseContext方法 #

在应用最早的Context初始化阶段修改配置，全局生效：

// Java实现
@Override
protected void attachBaseContext(Context base) {
    super.attachBaseContext(base);
    if (isTvOrBoxDevice()) {
        Configuration config = getResources().getConfiguration();
        // 清除原有uiMode类型标记
        config.uiMode &= ~Configuration.UI_MODE_TYPE_MASK;
        // 赋值为电视类型
        config.uiMode |= Configuration.UI_MODE_TYPE_TELEVISION;
        getResources().updateConfiguration(config, getResources().getDisplayMetrics());
    }
}

// Kotlin实现
override fun attachBaseContext(base: Context?) {
    super.attachBaseContext(base)
    if (isTvOrBoxDevice()) {
        val config = resources.configuration
        // 清除原有uiMode类型标记
        config.uiMode = config.uiMode and Configuration.UI_MODE_TYPE_MASK.inv()
        // 赋值为电视类型
        config.uiMode = config.uiMode or Configuration.UI_MODE_TYPE_TELEVISION
        resources.updateConfiguration(config, resources.displayMetrics)
    }
}

2. 补充设备判断逻辑 #

避免在手机上误触发TV模式，可参考如下判断逻辑：

private boolean isTvOrBoxDevice() {
    PackageManager pm = getPackageManager();
    // 原生电视特征判断
    boolean isNativeTv = pm.hasSystemFeature(PackageManager.FEATURE_TELEVISION) 
                || pm.hasSystemFeature(PackageManager.FEATURE_LEANBACK);
    if (isNativeTv) return true;
    // 第三方电视盒子补充判断：无触摸、支持遥控器
    boolean hasTouch = pm.hasSystemFeature(PackageManager.FEATURE_TOUCHSCREEN);
    boolean hasRemote = pm.hasSystemFeature(PackageManager.FEATURE_REMOTE_CONTROL);
    return !hasTouch && hasRemote;
}

3. 运行时动态切换的补充操作 #

如果需要在应用运行时动态切换模式，修改完配置后调用对应Activity的recreate()方法，让页面重新加载资源即可生效。

注意事项 #

• 同时适配手机、TV两类设备时，需在AndroidManifest.xml中添加如下配置，避免手机设备无法安装应用：

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

• Android 12及以上版本出现配置不生效时，可在对应Activity的manifest节点添加android:configChanges="uiMode"，避免系统自动恢复原有配置。

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