Android应用关闭时如何发送Firebase Analytics事件？求代码实现

嘿，这个需求我之前帮人处理过，核心就是两个关键点：准确监听应用进入后台/关闭的时机，以及判断用户是否达到了设定的使用时长阈值。下面一步步给你讲具体实现：

一、核心思路 #

• 通过Application.ActivityLifecycleCallbacks监听整个应用的Activity生命周期，以此判断应用是处于前台还是后台。
• 记录应用进入前台的时间戳，当应用进入后台时计算使用时长，若超过你设定的阈值（比如1分钟），就触发Firebase Analytics事件发送。
• 这里的“关闭”我们优先监听应用进入后台的时机（毕竟用户按Home键、切换应用都属于实际意义上的“停止使用”），而非等进程被彻底杀死——那时候大概率已经没法发送事件了。

二、具体实现代码 #

1. 自定义Application类，注册生命周期监听 #

首先在你的Application类里注册Activity生命周期回调，用来跟踪应用的前后台状态：

import android.app.Application
import android.os.Bundle
import com.google.firebase.analytics.FirebaseAnalytics

class MyApp : Application() {
    private var isAppInForeground = false
    private var appForegroundStartTime: Long = 0
    private lateinit var firebaseAnalytics: FirebaseAnalytics
    
    // 自定义使用时长阈值，比如1分钟（60000毫秒），可按需调整
    private val USAGE_DURATION_THRESHOLD = 60000L

    override fun onCreate() {
        super.onCreate()
        firebaseAnalytics = FirebaseAnalytics.getInstance(this)
        
        // 注册Activity生命周期监听
        registerActivityLifecycleCallbacks(object : ActivityLifecycleCallbacks {
            override fun onActivityCreated(p0: android.app.Activity, p1: Bundle?) {}
            override fun onActivityStarted(p0: android.app.Activity) {
                // 应用从后台回到前台时，记录启动时间
                if (!isAppInForeground) {
                    isAppInForeground = true
                    appForegroundStartTime = System.currentTimeMillis()
                }
            }

            override fun onActivityResumed(p0: android.app.Activity) {}
            override fun onActivityPaused(p0: android.app.Activity) {}
            override fun onActivityStopped(p0: android.app.Activity) {
                // 检查是否所有Activity都已进入Stopped状态（即应用完全进入后台）
                val allActivitiesStopped = !applicationContext.registeredActivities.any { it.isResumed }
                if (isAppInForeground && allActivitiesStopped) {
                    isAppInForeground = false
                    // 计算本次使用时长
                    val usageDuration = System.currentTimeMillis() - appForegroundStartTime
                    // 达到阈值则发送事件
                    if (usageDuration >= USAGE_DURATION_THRESHOLD) {
                        sendAppCloseEvent(usageDuration)
                    }
                }
            }

            override fun onActivitySaveInstanceState(p0: android.app.Activity, p1: Bundle) {}
            override fun onActivityDestroyed(p0: android.app.Activity) {}
        })
    }

    private fun sendAppCloseEvent(duration: Long) {
        // 构建事件参数，可自定义需要上报的信息
        val params = Bundle().apply {
            putLong("usage_duration_ms", duration)
            putString("close_trigger", "enter_background")
        }
        // 发送自定义Firebase事件，事件名可按需修改
        firebaseAnalytics.logEvent("app_closed_after_valid_usage", params)
    }
}

2. 补充：处理进程被直接杀死的场景 #

如果用户直接划掉应用杀死进程，上面的onActivityStopped可能触发不及时，我们可以在Application的onTrimMemory方法里做兜底监听：

override fun onTrimMemory(level: Int) {
    super.onTrimMemory(level)
    // 当应用即将被系统杀死时，会触发TRIM_MEMORY_COMPLETE级别
    if (level == TRIM_MEMORY_COMPLETE && isAppInForeground) {
        val usageDuration = System.currentTimeMillis() - appForegroundStartTime
        if (usageDuration >= USAGE_DURATION_THRESHOLD) {
            sendAppCloseEvent(usageDuration)
        }
        isAppInForeground = false
    }
}

3. 必要配置 #

记得在AndroidManifest.xml里指定你的自定义Application类：

<application
    android:name=".MyApp"
    ...>
    ...
</application>

三、注意事项 #

• Firebase Analytics的事件发送是异步的，若进程被立即杀死可能存在丢失风险，但Firebase会自动缓存未发送的事件，下次应用启动时会补发，大部分场景下无需担心。
• 你可以根据产品需求调整USAGE_DURATION_THRESHOLD的数值，比如改成30秒（30000毫秒）。
• 可以用Android Studio的Firebase DebugView实时验证事件是否发送成功，或者在Firebase控制台的Analytics模块等待数小时查看统计数据。

内容的提问来源于stack exchange，提问作者Shailendra Sachan