Android页面埋点：停留时长监控的精确度与底层实现一句话总结：页面停留时长埋点，核心在于精确捕捉页面的可见性变化，并

一句话总结：页面停留时长埋点，核心在于精确捕捉页面的可见性变化，并根据业务需求，区分“活跃时长”和“可见时长”。

全页面停留时长埋点的实现，需要根据业务场景和精度要求，选择合适的方案。

这是最简单的全局埋点方案。通过在 Application 中注册 ActivityLifecycleCallbacks，可以全局监听所有 Activity 的 onResume() 和 onPause() 事件。

优点：实现简单，无代码侵入。
适用场景：计算页面的**“活跃时长”**（即页面处于焦点状态的时间）。
局限：
- 无法处理 Fragment 的可见性变化。
- onResume 和 onPause 的切换，并不完全代表页面的可见状态。例如，当系统弹窗覆盖页面时，Activity 会进入 onPause，但页面仍可能对用户可见。

为了解决基础方案的局限，我们需要更精细地处理页面的可见性。

Fragment可见性：对于 ViewPager 等多 Fragment 场景，Fragment 的 onPause 和 onResume 不会立即触发。开发者需要额外监听 Fragment 的可见性变化，如 onHiddenChanged() 或 setUserVisibleHint()。
窗口焦点：onWindowFocusChanged(hasFocus) 是一个更精确的指标，它标志着页面是否获得了窗口焦点。当系统弹窗或通知栏覆盖页面时，Activity 会失去焦点，此时我们应暂停计时。这种方案能精确计算页面的**“可见停留时长”**。

对于需要完全无侵入、大规模部署的埋点系统，字节码插桩是终极解决方案。

原理：在编译期间，通过 ASM 等工具，在所有 Activity 和 Fragment 的 onResume() 和 onPause() 方法中自动插入埋点代码。
优点：完全无侵入，开发人员无需手动添加埋点。
缺点：增加编译时间；如果插桩逻辑复杂，可能会引入额外的运行时开销。

埋点系统的精确度，依赖于 Android 底层对生命周期和事件的分发机制。

Activity：Activity 的生命周期由 ActivityThread 负责调度，Instrumentation 负责实际调用。当 Instrumentation 调用 onResume() 方法时，它会通知 Application，由 Application 遍历 ActivityLifecycleCallbacks 列表，分发给所有监听器。
Fragment：Fragment 的生命周期由 FragmentManager 内部的状态机管理。当 FragmentManager 切换 Fragment 状态时，会通知 FragmentLifecycleCallbacks 监听器。

onWindowFocusChanged 的回调是由 ViewRootImpl 驱动的。ViewRootImpl 负责将 WindowManagerService（WMS）发送的窗口焦点事件，分发给 Activity。
在 onPause 之后，页面可能仍然可见，但它已经失去了窗口焦点。因此，onWindowFocusChanged 提供的焦点信息，是计算**“可见停留时长”**的关键。

时间戳：使用 SystemClock.elapsedRealtime() 获取时间戳，因为它基于设备启动时间，不受系统时间修改、时区等因素影响。
线程：埋点数据的上报应使用异步线程（如协程或 WorkManager），避免阻塞主线程，从而防止 ANR。

页面标识：使用 Activity 或 Fragment 的类名作为页面标识。
前后台切换：通过 ActivityLifecycleCallbacks 统计活跃 Activity 的数量。当数量从 1 变为 0 时，应用进入后台；当从 0 变为 1 时，应用回到前台。

结论：

全页面停留时长埋点是一个系统工程。它需要开发者深入理解 Android 生命周期分发机制，并结合 Fragment 生命周期、窗口焦点等高级特性，才能构建一个精准、高效、无侵入的埋点系统。

Android页面埋点：停留时长监控的精确度与底层实现