移动推送 Android 快速接入-快速入门-文档中心-腾讯云

简介
本文档提供移动推送 Android 应用快速接入指引。只需按照如下步骤，即可在您的 Android 应用上面使用移动推送服务。
注意
为了避免您的 App 被监管部门通报或下架，请您在接入 SDK 之前务必按照 Android 合规指南 在《隐私政策》中增加移动推送相关说明，并且在用户同意《隐私政策》后再初始化移动推送SDK。 
接入前准备
创建 Android 平台应用
1. 接入 SDK 之前，需要您前往移动推送 控制台 创建产品和 Android 应用，详情请参见 创建产品和应用 文档。
?
?
2. 完成以上步骤后，进入应用的配置管理页面，准备接入。
?
?
步骤1：开始接入
1. 在配置管理页面中， 单击快速接入。
?
?
2. 按照接入指引的操作顺序完成配置，然后单击点击验证。
?
?
3. 若出现以下提示，则表示 SDK 接入成功 。
?

 若出现以下提示，请确认 App 是否成功注册推送服务，可参见 接入结果验证。
 
?
?
注意
为提升离线抵达率，移动推送 SDK 默认开启联合保活能力，开发者可手动关闭，详情请参见 关闭移动推送保活功能。
步骤2：接入结果验证
1. 运行 App，过滤“TPush”关键字，查看相关日志：
?

如出现有类似上图日志，则表明 移动推送-SDK 的插件集成方式已经成功。
2. 推送服务注册成功的日志如下：
XG register push success with token:6ed8af8d7b18049d9fed116a9db9c71ab4aabb65
若未搜索到 Token，请查看注册接口返回的错误码，根据 错误码对照表 排查。
步骤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 版本：
?
?
Android 快速接入

本页目录：

简介

接入前准备

创建 Android 平台应用

步骤1：开始接入

步骤2：接入结果验证

步骤3：厂商通道快速接入

问题排查指引
