Android 接入指南

概述

Android 归因 SDK 核心逻辑以 AAR（R8 混淆）二进制分发，支持 React Native (Expo)、Flutter 和纯原生 Kotlin/Java 三种接入方式。归因完成后自动上报设备画像（去重/防刷）。

接入方式

纯原生 Kotlin/Java 项目

如果你的 Android 项目不使用 React Native，可以直接集成 AAR：

集成 AAR

1. 将 xxinstall-core.aar 放入 app/libs/ 目录
2. 在 build.gradle 中添加依赖：

dependencies {
    implementation fileTree(dir: 'libs', include: ['*.aar'])
}

3. 调用 SDK：

import com.xxinstall.sdk.XXinstall
import com.xxinstall.sdk.XXinstallConfig

// 设置 API 地址
XXinstall.setHost("https://your-api-domain.com")

// 初始化并获取归因结果
val config = XXinstallConfig(
    appKey = "YOUR_APP_KEY",
    appSecret = "YOUR_APP_SECRET",
    debug = true,
)

XXinstall.init(context, config) { result ->
    result.fold(
        onSuccess = { attr ->
            Log.d("XXinstall", "归因: inviteCode=${attr.inviteCode}, channel=${attr.channel}")
        },
        onFailure = { err ->
            Log.e("XXinstall", "归因失败: ${err.message}")
        },
    )
}

可选参数