Android SDK 接入文档

个数是个推旗下基于大数据的应用统计产品，从用户属性、使用行为、行业对比等多指标多维度进行全面的移动应用统计分析，帮助 APP 运营者深层次挖掘用户需求，准确了解自身行业地位，从而更好地指导产品运营。

1、登录 个推开发者中心 ，进入个数应用统计。

2、创建个数应用，并获取 AppId。

在以项目名为命名的顶层 build.gradle 文件中，添加个推 maven 库地址：

在 app/build.gradle 文件中引用个数 SDK 依赖库：

注意：为兼容Android9.0，务必在 application 节点添加 android:usesCleartextTraffic="true"

在混淆文件中加入如下配置即可：

如果您的工程使用了AndResGuard进行资源精简，为了避免个数SDK所需资源被错误精简导致功能异常，需要为个数添加白名单配置。

gradle集成AndResGuard的方式，需要您在andResGuard的whiteList节点下添加如下代码:

命令行使用AndResGuard的方式，需要您在config.xml文件中的节点下添加如下代码

在 app/build.gradle 文件中的 android.defaultConfig 下添加 manifestPlaceholders ，配置个数相关的应用参数，如下所示：

APP_ID 为步骤1中从官方网站获取到的值，APP_CHANNEL 为将要发布的渠道。(渠道若为纯数字字符串不能超过int表示的范围)

APP_CHANNEL 也能够通过 Gsconfig 类的 setInstallChannel 方法设置。

注意: 对于同时集成个推多个产品SDK，且SDK之间的APPID值不一致的用户，可以任选一个SDK的APPID配置到GETUI_APPID占位符中，其余SDK在AndroidManifest文件中务必添加对应的标签来补充APPID，参考以下配置：

在您应用的启动入口（Application的onCreate中）调用SDK的初始化代码：

参数：

context 设备上下文

注意事项：为了保证 SDK 服务稳定，开发者需在 App《隐私政策》的 “与授权合作伙伴共享”条款中，将 个推的用户隐私政策 加入其中。并确保在 App 首次运行时通过明显方式提示终端用户阅读您的 App《隐私政策》，取得终端用户的合法授权后，再初始化 SDK ，详情可查看：个推合规指南 。

默认开关是关闭的，可以通过以下代码开启开发者模式：

该模式下，数据会实时上传，且将输出 SDK 相关日志。

注意: 上线时请关闭开关或者注释该行代码。

应用时长统计用于统计启动次数和应用的真实活跃时长，集成 SDK 后不需要开发者调用额外的接口。

其中 Android 平台一次完整的启动包括如下两种情况：

1.从启动应用到关闭应用

2.从启动应用到应用退至后台，且在后台运行时间超过 30s 。也可以修改该默认值：

注意：GsConfig 配置类需要在 SDK 初始化之前配置。

开启开发者模式：

重启应用，会在 logcat 输出

SDK 集成完成后，在 gradle 的 manifestPlaceholders 配置对应的 appid，在 web 端打开 appid 对应的个数服务平台。重启应用，稍等几秒可以看到启动次数刷新。