当前位置：首页 > news >正文

Android ActivityLifecycleCallbacks ：解耦与监控的神器

news 2026/7/15 4:08:25

在 Android 开发中，我们经常需要在 Activity 的生命周期中执行一些通用操作，比如：

埋点统计：记录每个页面的打开/关闭时间。
全局 UI 注入：自动给所有页面添加水印、Loading 弹窗。
应用前后台判断：监听应用是否退到后台。
Activity 栈管理：维护一个全局的 Activity 列表，方便一键退出应用。

如果通过继承BaseActivity来实现，不仅侵入性强，而且对于第三方库中的 Activity 无能为力。这时候，Application.ActivityLifecycleCallbacks就是你的最佳选择。

1. 什么是 ActivityLifecycleCallbacks？

它是Application类中的一个内部接口，允许你在 Application 级别监听应用内所有 Activity的生命周期事件。

这意味着你不需要修改 Activity 的任何代码，就能在它onCreate、onResume、onDestroy时自动执行逻辑。这是实现**AOP（面向切面编程）**思想的绝佳手段。

2. 基础用法

2.1 定义回调

class MyLifecycleCallbacks : Application.ActivityLifecycleCallbacks { override fun onActivityCreated(activity: Activity, savedInstanceState: Bundle?) { Log.d("Lifecycle", "${activity.javaClass.simpleName} Created") } override fun onActivityStarted(activity: Activity) { Log.d("Lifecycle", "${activity.javaClass.simpleName} Started") } override fun onActivityResumed(activity: Activity) { Log.d("Lifecycle", "${activity.javaClass.simpleName} Resumed") } override fun onActivityPaused(activity: Activity) {} override fun onActivityStopped(activity: Activity) {} override fun onActivitySaveInstanceState(activity: Activity, outState: Bundle) {} override fun onActivityDestroyed(activity: Activity) { Log.d("Lifecycle", "${activity.javaClass.simpleName} Destroyed") } }

2.2 注册回调

在你的Application的onCreate中注册：

class MyApplication : Application() { override fun onCreate() { super.onCreate() registerActivityLifecycleCallbacks(MyLifecycleCallbacks()) } }

3. 实战场景

场景一：判断应用在前台还是后台

通过维护一个计数器，我们可以精准判断应用状态。

class AppStatusTracker : Application.ActivityLifecycleCallbacks { private var activeActivityCount = 0 override fun onActivityStarted(activity: Activity) { if (activeActivityCount == 0) { Log.i("AppStatus", "应用进入前台") } activeActivityCount++ } override fun onActivityStopped(activity: Activity) { activeActivityCount-- if (activeActivityCount == 0) { Log.i("AppStatus", "应用进入后台") } } // 其他方法省略... }

场景二：全局 Activity 管理（一键退出）

维护一个 Activity 栈，方便管理。

object ActivityStackManager : Application.ActivityLifecycleCallbacks { private val activityStack = Stack<Activity>() override fun onActivityCreated(activity: Activity, savedInstanceState: Bundle?) { activityStack.add(activity) } override fun onActivityDestroyed(activity: Activity) { activityStack.remove(activity) } // 获取当前栈顶 Activity fun currentActivity(): Activity? = if (activityStack.isNotEmpty()) activityStack.lastElement() else null // 退出所有页面 fun finishAll() { for (activity in activityStack) { if (!activity.isFinishing) activity.finish() } activityStack.clear() } // 其他方法省略... }

场景三：全局自动添加水印（高级用法）

这是最能体现其解耦能力的场景。无需 BaseActivity，自动为所有页面注入 View。

class GlobalWatermarkCallback(private val watermarkText: String) : Application.ActivityLifecycleCallbacks { override fun onActivityCreated(activity: Activity, savedInstanceState: Bundle?) { // 在 Activity 创建时注入水印 addWatermark(activity) } private fun addWatermark(activity: Activity) { val rootView = activity.findViewById<ViewGroup>(android.R.id.content) // 创建水印 View val watermarkView = TextView(activity).apply { text = watermarkText textSize = 14f setTextColor(Color.parseColor("#33000000")) // 半透明 rotation = -45f gravity = Gravity.CENTER layoutParams = FrameLayout.LayoutParams( FrameLayout.LayoutParams.MATCH_PARENT, FrameLayout.LayoutParams.MATCH_PARENT ) // 关键：设置不可点击，防止阻挡正常操作 isClickable = false isFocusable = false } rootView.addView(watermarkView) } // 其他方法省略... }

4. 注意事项与坑

ContentProvider 中的初始化：很多库（如 LeakCanary, WorkManager）为了免初始化，会利用 ContentProvider 自动注册 LifecycleCallbacks。如果你发现某些逻辑执行顺序奇怪，可以检查一下是否有第三方库也注册了回调。
Fragment 无法监听：这个接口只针对 Activity。如果你需要监听 Fragment，可以参考FragmentManager.FragmentLifecycleCallbacks，原理类似。
性能开销：虽然回调本身开销很小，但如果在onActivityResumed等高频方法中做耗时操作（如复杂的 IO 或大量计算），会直接卡顿 UI 线程，导致页面切换不流畅。