量U部署及接入文档

Appearance

隐私条款 ​

  • 条款1 使用量U的源码和库即意味着使用者同意该隐私条款
  • 条款2 不得对库和二进制部分进行反向编译或逆向工程意图破解程序
  • 条款3 不得在违背条款2的情况或其他方式下修改量U系统源码而达到明文传输和存储用户隐私信息的目的
  • 条款4 任何违背条款2和条款3而带来的一切风险，由使用者全部承担，量U不承但任何责任
  • 条款5 量U拥有对该隐私条款的最终解释权和修改权

概述 ​

Kotlin 使用的 SDK 与 Java 相同，若您的 APP 使用 Kotlin 开发，可直接集成 Java 版 SDK
若使用 Groovy DSL 风格的 Gradle 配置，则与 Java 完全相同
若使用 Kotlin DSL 风格的 Gradle 配置，则配置有少许不同
下面列出 Kotlin DSL 集成的不同之处（仅以自动打包集成方式为例）

自动打包SDK集成（推荐） ​

自动打包集成不需要开发者在 SDK 中手动配置域名等参数，直接下载的 SDK 已经是定制好的分包，直接调用 SDK 的方法即可完成上报，接入过程方便快捷

  1. 安装量U系统，填写 SDK 上报域名等信息（域名推荐使用 https 协议）
  2. 系统安装完成，添加应用后，每款应用信息最右边都会有一个下载 SDK 的按钮
  3. 开发者点击下载 SDK，此时系统会将此前填写的 SDK 上报域名、应用 AppID 等信息全部打包进 SDK，下载后进行集成即可

使用 Android Studio 进行本地集成（Groovy DSL风格） ​

与 Java 集成相同

使用 Android Studio 进行本地集成（Kotlin DSL风格） ​

  • 手动导入，将下载好的 lionu.aar 库文件放入项目的 libs 目录下

图片

  • 修改 app 层面的 build.gradle.kts，添加 lionu 库支持
dependencies {
    implementation(files("libs/lionu.aar"))
    ......
}

注意：files 采用 aar 的相对路径（相对 build.gradle.kts 而言），这里 libs 目录与 build.gradle.kts 文件同级，所以写成 files("libs/lionu.aar")

  • 修改 AndroidManifest.xml 在 application 节点内添加内容进行初始化
<?xml version="1.0" encoding="utf-8"?>
<manifest xmlns:tools="http://schemas.android.com/tools"
    xmlns:android="http://schemas.android.com/apk/res/android">

    <application
        .......>
        <activity
            .....>
            .....
        </activity>
        <provider
            android:name="com.android.reportx.util.ApplicationProvider"
            android:authorities="${applicationId}.contextprovider"
            android:exported="false" />
        <meta-data
            android:name="CHANNEL_KEY"
            android:value="default" />
    </application>
</manifest>

配置完成 开始数据上报 ​

  • 在代码开头引入包
import com.android.reportx.util.RP;  //也可选中代码中的 RP 文本再按 Alt+Enter 自动导入
  • 上报启动激活 请在您的主界面（通常是MainActivity）的 onCreate 函数中调用以下代码：
RP.launch(this@MainActivity)
  • 上报注册事件 请在注册完成的回调中调用以下代码：
RP.reg(this@MainActivity)
  • 上报付费事件 请在支付完成的回调中调用以下代码：
RP.pay(this@MainActivity, amount)    //amount 为订单的支付金额 单位为 分

注意：对于适配了Android 6.0以上 (API >= 23) 的App，建议开发者在获得了动态权限之后，再调用SDK上报代码，否则SDK获取设备信息可能受影响。