Android Launcher失去焦点后无法恢复焦点

Question

在Android Launcher开发中，常见问题之一是Launcher在返回桌面后无法正常恢复焦点。当用户从第三方应用返回桌面时，Launcher界面虽可见但无焦点，导致遥控器或方向键操作无响应。该问题多因Activity未正确处理onResume生命周期，或根布局未设置focusable和focusableInTouchMode属性所致。此外，某些厂商ROM对任务栈管理策略差异亦可能影响焦点恢复。需确保Launcher主Activity在重新显示时主动请求获取焦点，并合理配置View的焦点属性，以保障TV或车载等场景下的正常交互体验。

Answer 1

Android Launcher焦点恢复问题深度解析与解决方案

1. 问题背景与现象描述

在TV、车载系统等基于遥控器或方向键操作的Android设备中，Launcher作为用户交互的核心入口，其焦点管理至关重要。开发者常遇到的问题是：当用户从第三方应用返回桌面时，Launcher界面虽正常显示，但无法响应方向键或遥控器操作。

该现象的根本表现为——Launcher Activity可见但无焦点（focus），即当前窗口未获取输入事件的处理权。

此类问题在标准手机设备上不易察觉，但在非触摸主导的设备上直接影响用户体验，严重时会导致“死机”错觉。

2. 常见原因分析

• Activity生命周期处理不当：onResume中未主动请求焦点。
• 根布局焦点属性缺失：未设置android:focusable="true"和android:focusableInTouchMode="true"。
• 厂商ROM定制化影响：部分厂商修改了任务栈恢复策略，导致焦点丢失。
• WindowManager策略干预：系统可能因Z-order或可见性判断延迟分配焦点。
• Fragment或动态View加载时机问题：子视图未完成绘制前请求焦点失败。

3. 技术排查流程图

graph TD
    A[用户返回桌面] --> B{Launcher是否可见?}
    B -- 是 --> C{onResume是否被调用?}
    B -- 否 --> H[检查Activity启动模式]
    C -- 是 --> D{根布局是否可聚焦?}
    C -- 否 --> I[检查TaskStack与LaunchMode]
    D -- 是 --> E{是否主动请求焦点?}
    D -- 否 --> J[添加focusable属性]
    E -- 是 --> F[检查焦点是否被抢占]
    E -- 否 --> K[调用requestFocus()]
    F --> G[问题解决]
    

4. 解决方案分层实施

层级	措施	适用场景	风险提示
View层	确保根布局设置focusable和focusableInTouchMode	所有Launcher布局文件	避免嵌套冲突
Activity层	onResume中调用requestFocus()	主Launcher Activity	需在View树完成后执行
生命周期层	重写onWindowFocusChanged判断焦点状态	复杂UI结构	注意多次回调
Manifest层	设置android:windowFocusableInTouchMode="true"	全局配置	影响其他Activity
Framework层	Hook WindowManagerService焦点逻辑（仅系统级）	深度定制ROM	兼容性差，不推荐

5. 关键代码示例

<!-- activity_main.xml -->
<LinearLayout
    xmlns:android="http://schemas.android.com/apk/res/android"
    android:layout_width="match_parent"
    android:layout_height="match_parent"
    android:focusable="true"
    android:focusableInTouchMode="true"
    android:orientation="vertical">

    <!-- 子视图 -->
    <TextView
        android:id="@+id/tv_home"
        android:layout_width="wrap_content"
        android:layout_height="wrap_content"
        android:text="Home Screen"
        android:focusable="true"
        android:clickable="true" />

</LinearLayout>
    

// MainActivity.java
@Override
protected void onResume() {
    super.onResume();
    // 确保View树已加载完成后再请求焦点
    getWindow().getDecorView().post(() -> {
        if (getCurrentFocus() == null) {
            findViewById(R.id.tv_home).requestFocus();
        }
    });
}

@Override
public void onWindowFocusChanged(boolean hasFocus) {
    super.onWindowFocusChanged(hasFocus);
    if (hasFocus && getCurrentFocus() == null) {
        requestFocusWithDelay();
    }
}
    

6. 高阶调试技巧

1. 使用adb shell dumpsys input查看当前焦点窗口。
2. 通过adb logcat | grep -i focus监控焦点变化日志。
3. 在自定义View中重写onFocusChanged进行埋点追踪。
4. 利用StrictMode检测主线程阻塞导致的焦点延迟。
5. 对比不同厂商设备（如小米TV、华为智慧屏）的行为差异。
6. 使用Hierarchy Viewer或Layout Inspector验证焦点路径。
7. 模拟低内存场景测试onDestroy重建后的焦点恢复。
8. 集成自动化测试脚本，模拟KeyEvent发送与响应验证。
9. 分析WMS源码中的updateFocusedWindowLocked调用链。
10. 构建沙箱环境复现特定ROM的焦点异常。

7. 系统级兼容性建议

针对厂商ROM差异，建议采取以下策略：

• 对主流TV厂商（海信、TCL、Sony）建立兼容性白名单机制。
• 在Application初始化时读取ro.product.manufacturer进行差异化处理。
• 封装FocusManager组件，统一管理焦点获取逻辑。
• 在Settings中提供“修复焦点”功能供用户手动触发。