公告
产品功能动态
Android SDK 发布动态
iOS SDK 发布动态
macOS SDK 发布动态
Android 快速接入
简介
本文档提供移动推送 Android 应用快速接入指引。只需按照如下步骤，即可在您的 Android 应用上面使用移动推送服务。
注意：
为了避免您的 App 被监管部门通报或下架，请您在接入 SDK 之前务必按照 Android 合规指南在《隐私政策》中增加移动推送相关说明，并且在用户同意《隐私政策》后再初始化移动推送SDK。
接入前准备
创建 Android 平台应用
2. 完成以上步骤后，进入应用的配置管理页面，准备接入。
步骤1：开始接入
1. 在配置管理页面中， 单击快速接入。
2. 按照接入指引的操作顺序完成配置，然后单击点击验证。
3. 若出现以下提示，则表示 SDK 接入成功 。
注意：
步骤2：接入结果验证
1. 运行 App，过滤“TPush”关键字，查看相关日志：
2. 推送服务注册成功的日志如下：
XG register push success with token:6ed8af8d7b18049d9fed116a9db9c71ab4aabb65
步骤3：厂商通道快速接入
1. 在配置管理页面打开厂商推送通道开关并配置好应用的 AppId、SecretKey 等信息，申请方式可查看各厂商通道的说明文档。
单击查看说明文档，可查看厂商通道说明。
在右侧 AppId、AppKey、AppSecret 处可配置厂商通道信息。
2. 厂商通道信息配置完成后，单击页面上方配置文件下载，下载包含厂商通道配置信息的配置文件，然后用该配置文件替换工程文件中旧的配置文件即可。
问题排查指引
1. 查看插件日志。
如果集成出现异常，则将 tpns-configs.json 文件中的 “debug” 字段置为 true，运行命令：
./gradlew --rerun-tasks :app:processReleaseManifest
并通过“TpnsPlugin”关键字进行分析。
2. sync projects。
3. 在项目的 External Libraries 中查看是否有相关依赖。
4. 如果日志显示 
Execution failed for task ':Paracraft:checkTPNS'，说明检查到有新版本的移动推送Android SDK 可以升级。如果不希望检查更新，可以在 tpns-configs.json 文件中添加 "upgrade": false，效果如下图：
5. 使用插件过程中，遇到 Android Gradle 插件版本跟 Gradle 版本不匹配的问题，可以参考 Android Gradle 插件版本说明 进行版本升级，下图列出了当前各个 Android Gradle 插件版本所需的 Gradle 版本：
文档反馈