Android全局自动采集页面浏览、按钮点击事件原理及自定义实现方案

核心底层逻辑 #

这类全量自动采集方案没有依赖黑科技，核心是基于Android系统开放的全局回调、事件分发两个系统级钩子实现，不需要在每个业务页面、按钮上手动写埋点代码，就能覆盖绝大多数常规场景，轻量Hook即可补全剩余特殊场景，业务接入成本几乎为0。

屏幕浏览（页面曝光）事件采集机制 #

• Activity页面采集：直接通过Application.registerActivityLifecycleCallbacks()注册全局生命周期监听，所有App内Activity的onResumed（页面进入前台可交互）、onPaused（页面离开不可交互）回调都会被全局捕获，不需要单独修改每个Activity的代码。在回调中可以直接拿到Activity的全类名、任务栈信息、根视图参数，作为页面浏览事件的基础上报字段。
• Fragment页面采集：AndroidX 1.4.0及以上版本直接支持通过FragmentManager.registerFragmentLifecycleCallbacks()全局注册监听，初始化时给所有Activity绑定的FragmentManager注入该监听，就能拿到全量Fragment的生命周期回调；低版本兼容场景可以通过Hook ActivityonCreate阶段的FragmentManager实例，提前注入监听，实现同样的效果。
• 误报过滤：针对ViewPager预加载、Navigation后台缓存、Dialog/PopupWindow遮挡页面的场景，需要结合onHiddenChanged、setMenuVisibility、窗口焦点变化回调判断页面真实可见性，避免把不可见的预加载页面误判为曝光。

按钮点击事件采集机制 #

• 全局事件捕获：每个Activity的Window实例持有一个mCallback实例，所有触摸、按键事件在分发给具体控件之前都会先经过这个Callback。初始化时给每个Activity的Window注入自定义代理Callback，保留原始Callback的引用，在代理中监听触摸抬起（ACTION_UP）事件，定位触摸坐标对应的可点击控件（clickable属性为true的Button、TextView、ImageView、自定义View等），即可捕获点击动作。
• 点击监听Hook：针对动态设置点击监听的控件，可以通过Hook View类的setOnClickListener方法，当业务代码给任意View设置点击监听时，自动把原始OnClickListener包装为代理实例：代理执行完原始点击逻辑后，同步触发点击事件上报，这种方式准确率更高，不会漏掉动态添加的控件。
• 事件参数提取：捕获到触发点击的View实例后，通过getResources().getResourceEntryName(view.getId())获取控件在XML中定义的ID名，通过getContentDescription()、getText()（针对TextView子类）获取控件文本内容，结合当前前台Activity/Fragment的信息，就能拼出完整的点击事件字段。

自定义自动采集功能实操建议 #

• 基础能力搭架：在Application的onCreate阶段首先注册全局Activity生命周期回调，在每个Activity的onActivityCreated回调中完成两个操作：一是替换当前Window的mCallback为代理实例，实现点击事件全局捕获；二是给当前Activity绑定的FragmentManager注册Fragment生命周期监听，实现Fragment页面曝光采集。这一步完成后就能覆盖所有App内新增的页面，不需要业务代码额外接入。
• 注意代理逻辑的正确性：所有替换系统回调的代理逻辑，处理完自定义逻辑后必须把事件透传给原始系统回调，不能拦截事件的正常分发，否则会出现页面触摸失效、生命周期错乱的问题。
• 提前做ID映射：不要直接上报View的数字ID、类名这类可读性差的字段，可以在编译期扫描R类、页面类，生成控件ID、页面类名到自定义可读名称的映射表，上报时直接查表替换，降低后续数据清洗的成本。
• 加防重逻辑：点击事件默认加500ms防抖，避免用户快速重复点击同一控件触发多次无效上报；页面曝光加页面唯一标识的短时间去重，比如权限弹窗弹起又收起触发的Activity重复onResume，不需要重复上报。
• 预留配置能力：内置黑白名单配置项，支持按页面类名、控件ID过滤不需要上报的调试页面、系统控件，减少无效数据上报量。
• 特殊场景补全：针对第三方SDK页面、动态添加的自定义控件，可以在页面加载完成后遍历视图树，给所有可点击控件主动挂上代理点击监听，补全覆盖盲区。

内容的提问来源于stack exchange，提问作者Jagdish Choudhary