零代码三步快速集成腾讯移动推送（Android）

rickenwang • 2023-01-03 • 云技术社区 • 282 阅读

先来段正式的产品介绍：

腾讯移动推送是一款专业的移动 App 推送平台，支持百亿级的通知/消息推送，秒级触达移动用户，全面支持 Android 和 iOS 两大主流平台。开发者可以方便地通过嵌入 SDK，通过 API 调用或者 Web 端可视化操作，实现对特定用户推送，大幅提升用户活跃度，有效唤醒沉睡用户，并实时查看推送效果。

说得简单点，就是如下几点:

支撑腾讯多款自有 App 的推送服务，专业、可靠。
支持 IOS 和 Android 两大平台，Android 平台下还支持华为、小米、魅族厂商通道进行推送；
支持 API 和 Web 端推送，操作方便；
支持指定用户推送，推送更有效率；

下面以 Android 接入腾讯移动推送为例，步骤非常简单，在不需要编写任何代码的情况下就可以让你的应用集成专业的推送服务。

准备工作

您首先需要一个 Android 工程，这个工程可以是您现有的工程，也可以是您新建的一个空的工程。

第一步：创建项目和应用

在集成前，您必须先在腾讯云移动开发平台控制台上有项目和应用，去控制台点点点，顺带输入信息，就得到了一个android应用。如果还没有，现在去移动开发平台创建应用。

注意：创建应用时填写的包名需要和实际 Android 工程的 applicationId 保持一致。

第二步：添加配置文件 (实际就是把文件拖拽到指定位置）

在您创建好的应用上点击【下载配置】按钮来下载该应用的配置文件的压缩包：

downloadConfig.png

解压该压缩包，您会得到 tac_service_configurations.json 和 tac_service_configurations_unpackage.json 两个文件，请您如图所示添加到您自己的工程中去。

tac_android_configuration.jpg

注意：
请您按照图示来添加配置文件，tac_service_configurations_unpackage.json 文件中包含了敏感信息，请不要打包到 apk 文件中，MobileLine SDK 也会对此进行检查，防止由于您误打包造成的敏感信息泄露。

第三步：集成 SDK

您需要在您应用级 build.gradle 文件（通常是 app/build.gradle）中添加 messaging 服务依赖：

dependencies {
    // 增加这两行
    compile 'com.tencent.tac:tac-core:1.1.0'
    compile 'com.tencent.tac:tac-messaging:1.1.0'
}

'com.tencent.tac:tac-messaging:1.1.0' 默认引入了厂商通道推送包，如果不需要集成厂商推送，您可以改用 'com.tencent.tac:tac-messaging-lite:1.1.0'

到此您已经成功接入了 MobileLine 移动推送服务。

验证服务

查看服务启动情况

安装并运行 App 后，SDK 会自动在 Messaging 后台进行注册，注册成功后会打印如下日志：

I/tacApp: TACMessagingService register success, code is 0, token is 495689dbfda473ef44de899cf45111fd83031156

这里日志打印的 token 信息标识推送时的唯一 ID，您可以通过 token 信息给该设备发送通知。
如果没有打印以上日志，请查看常见问题。

在控制台上推送通知栏消息

打开 MobileLine 控制台，选择【创建推送】下的【通知栏消息】，并填写好 通知标题 和 通知内容，然后选择单选框中的【单个设备】，然后将注册成功后打印的设备唯一标识 token 信息拷贝到编辑框中（示例这里为 495689dbfda473ef44de899cf45111fd83031156 ），然后点击【确认推送】。

console_push_notification_simple.png

推送通知栏消息成功后，App 在运行状态下会收到通知栏消息。

这里您也可以选择推送给所有的设备，设备收到消息可能会有一定的延时。

后续步骤

注册回调接口

注册回调接口非常重要，您可以注册回调接口来接收推送服务在不同状态下给您的回调，具体有：

onRegisterResult() : 注册 Messaging 服务后回调。
onUnregisterResult() : 反注册 Messaging 服务后回调。
onMessageArrived() : 收到透传消息（即控制台上的应用内消息）后回调。
onNotificationArrived() : 收到通知栏消息后回调。
onNotificationClicked() : 点击通知栏消息后回调。
onNotificationDeleted() : 删除通知栏消息后回调。
onBindTagResult() : 绑定标签后回调。
onUnbindTagResult() : 解绑标签后回调。

如何注册回调接口，请参见这里。

集成厂商推送通道

我们建议您集成厂商推送通道，通过集成厂商官方提供的系统级推送通道，在对应厂商手机上，推送消息能够通过系统通道抵达终端，并且无需打开应用就能够收到推送，目前支持华为、小米和魅族三个厂商通道，具体集成方式请参考这里。集成厂商通道后，由于不同厂商通道推送服务的限制，回调接口中有些方法或者参数将不会回调给您，详细信息请参考回调信息详细说明。