统计 SDK 接入文档

5 分钟接完，App 一跑就能看到数据

Android 接入

1放 aar

下载 analytics-1.0.0.aar， 放进 app/libs/，然后在 app/build.gradle.kts 里加一行依赖。

// 1. 把 aar 放进 app/libs/
//    https://tianrunye.com/sdk/analytics-1.0.0.aar

// 2. app/build.gradle.kts
dependencies {
    implementation(files("libs/analytics-1.0.0.aar"))
}

2填密钥

在 AndroidManifest.xml 的 <application> 里加两段 meta-data。密钥只显示一次，掉了就去后台重置。

<!-- AndroidManifest.xml 的 <application> 里 -->
<meta-data
    android:name="com.tianrunye.analytics.APP_KEY"
    android:value="你的 appKey" />
<meta-data
    android:name="com.tianrunye.analytics.APP_TOKEN"
    android:value="你的 appToken" />

权限：只需要 INTERNET。不申请位置、存储、通讯录等任何运行时权限。

3初始化

在 Application.onCreate() 里调用。不能放 Activity 里 —— 崩溃采集和冷启动统计都依赖它尽早执行。

class App : Application() {
    override fun onCreate() {
        super.onCreate()
        // 一行接入。包名自动读，不用传。
        Analytics.init(this)
    }
}

还要记得在 <application android:name=".App"> 里注册这个 Application 类， 否则 onCreate 不会被调用。

4确认接对了

跑起来看 logcat，应该有这段：

TRYA: init ok appKey=你的key debug=true enabled=true
TRYA: 配置正常（你的应用名）

如果是 TRYA: 配置有问题（HTTP 401），就是 token 复制错了； 是 配置警告：包名和登记的不一致，就是包名填错了。 5 秒就能定位，不用等后台有没有数据。

自动采集了什么

  • 启动 —— 冷启动 / 热启动
  • 页面曝光 —— 进 Activity 自动记（可以在配置里关）
  • 前台时长 —— 退后台停表
  • 崩溃 —— 完整堆栈 + 机型 + 系统版本
  • 按钮点击 —— 需要自己调 Analytics.trackButtonClick("名字")