深入解析ActivityRecord Token机制：从原理到最佳实践

1次阅读

共计 2394 个字符，预计需要花费 6 分钟才能阅读完成。

在 Android 开发中，ActivityRecord Token 是 Activity 与系统服务（如 AMS、WMS）通信的桥梁。但许多开发者对它的生命周期管理不够重视，导致以下常见问题：

Activity 无法正常销毁 ：当 Token 被错误持有时，AMS 无法回收对应的 Activity 实例，表现为onDestroy() 被延迟调用或完全不调用
WindowManagerService 报错：在错误的线程使用 Token 进行跨进程调用时，会触发BadTokenException（典型错误日志：”Unable to add window — token null is not valid”）
内存泄漏连锁反应：一个泄漏的 Token 会导致对应的 Activity、DecorView 乃至整个视图树无法被 GC 回收

ActivityRecord Token 本质上是 Binder 代理对象，其序列化 / 反序列化过程如下：

AMS 通过 ActivityRecord.appToken 生成 IBinder 对象
通过 Binder 驱动将对象引用转换为扁平化的 Parcel 数据
客户端进程接收后重建为 IApplicationToken.Stub 代理对象

// AOSP 代码片段（ActivityRecord.java）final IApplicationToken.Stub appToken = new Token();

private class Token extends IApplicationToken.Stub {// 实现 WMS 回调接口}

在系统服务端，Token 与组件的关系如下图所示：

[Client Process]           [System Server]
Activity  -----------------> ActivityRecord
  |                           /       \
  |-> ViewRootImpl           AMS       WMS

关键点：

每个 ActivityRecord 对应一个唯一的 Token
ViewRootImpl 通过 setView() 将 Token 传递给 WMS
Token 的生命周期必须与 Activity 的 onDestroy() 同步

class SafeTokenHandler(activity: Activity) {private val weakToken = WeakReference(activity.window?.attributes?.token)

    @MainThread
    fun performWindowAction(action: (IBinder?) -> Unit) {if (Looper.myLooper() != Looper.getMainLooper()) {throw IllegalThreadStateException("Must call from UI thread")
        }
        action(weakToken.get())
    }
}

添加依赖：

dependencies {debugImplementation 'com.squareup.leakcanary:leakcanary-android:2.9'}

自定义检测规则：

class TokenLeakDetector : ObjectInspector {override fun inspect(reporter: ObjectReporter) {reporter.whenInstanceOf("android.view.ViewRootImpl") { instance ->
            val tokenField = instance.javaClass.getDeclaredField("mWindowToken")
            tokenField.isAccessible = true
            val token = tokenField.get(instance) as IBinder?
            if (token != null && token.isBinderAlive) {reporter.reportLeak("ViewRootImpl token leaked", "")
            }
        }
    }
}

永远只在 UI 线程操作 Token（可通过 @MainThread 注解强制约束）
禁止在静态变量或长生命周期对象中持有原始 Token 引用

当设备旋转等操作触发配置变更时：

旧 Activity 的 Token 会随 onDestroy() 被回收
新 Activity 实例会生成新 Token
需要重写 onSaveInstanceState() 转移必要数据

override fun onSaveInstanceState(outState: Bundle) {super.onSaveInstanceState(outState)
    // 保存与窗口无关的临时状态
    outState.putString("KEY_DATA", transientData)
}

在 Jetpack Compose 架构下：