1. 概述
1.1 版本说明
版本库 | 信鸽推送配置插件版本 | 支持的功能 |
|---|---|---|
| 10.0 | 10.4.76 | 支持腾讯消息推送中心有偿推送服务 |
| 10.4.975 |
| |
| 10.4.976 |
| |
| 10.4.977 | APP 把华为 v2 通道切换为 v5 通道，因此 OEM 华为通道，不再通过 HW_APPID 来配置，而是通过 agconnect-services.json 来配置 |
1.2 应用场景
OEM 的 FineMobile 数据分析 App 可根据用户需求设置消息推送功能。
1.3 功能介绍
OEM 的 FineMobile 数据分析 App 可以使用自己的信鸽平台，且不通过推送中心进行消息转发。
「消息推送」功能默认不勾选，用户勾选后，需填写一些配置信息，如下图所示：
根据信鸽版本的不同，各类推送方式的功能区别也不相同，具体如下图所示：
注：信鸽推送配置插件 V10.4.76 版本仅适配信鸽 TPNS 版本。
| 信鸽版本配置 | 推送通道 | 功能 |
|---|---|---|
TPNS版本 （收费版本） | 自建通道 | 需要购买 腾讯移动推送服务 打开App 后，可接收消息推送 不打开 App，无法接收消息推送 |
| 厂商通道 | 需要购买 腾讯移动推送服务 无需打开应用，即可收到推送消息 |
注：若用户 配置了 iOS 证书，且证书中不包含「Push Notifications」功能，则消息推送功能灰化，无法打包。如下图所示：
2. 获取信鸽应用密钥
2.1 新建产品
登录 腾讯移动推送平台，点击产品管理>新增产品，填写产品信息，勾选平台版本，点击确定。如下图所示：
注1：如果 iOS 和 Android 都需要打包，则都需要进行注册。
注2：服务器接入点也就是信鸽集群，在后续步骤3.2推送配置和4.3配置密钥会用到，需要注意下。
注3：大陆用户选择广州或上海集群，港澳台及海外用户选择中国香港或新加坡集群。
2.2 配置管理
填写配置，此处的应用包名应与 帆软 App 打包证书 中的package包名一致，如下图所示：
2.3 获取参数
配置完成后，会得到三个和 App 相关的参数：ACCESS ID、ACCESS KEY、SECRET KEY。
3. 服务器推送配置
3.1 插件安装
点击下载插件：信鸽推送配置（TPNS）插件
设计器插件安装方法参照 设计器插件管理
服务器安装插件方法参照 服务器插件管理
注：需安装 V10.4.76 及以上版本的插件
3.2 推送配置
插件安装后，登录数据决策平台，管理系统>移动平台目录下新增推送配置。
推送配置分为「国内设置」和「国际/中国港澳台设置」，国内设置的集群服务器可选广州或上海，国际/中国港澳台设置的集群服务器可选中国香港或新加坡。
推送配置分为「国内设置」和「国际/中国港澳台设置」后，现在可以一次向多个集群推送消息，例如同时向上海和新加坡集群推送消息。
选择设置方式后，填写2.3节获取的ACCESS ID、SECRET KEY，以及2.1新建产品中选择的服务接入点。
如下图所示：
3.3 设置代理服务器
如报表服务器部署在内网，不能访问外网，也不能被外网访问，此时需要配置代理服务器，方可成功推送消息。具体操作请参见：代理服务器配置
4. App 打包配置
4.1 新建应用
注1：正常定制打包步骤请参见 App 打包 ，本文仅对消息推送设置进行说明。
打开 帆软市场 ，点击用户中心>App 打包，新建应用或对已有 App 进行打包，如下图所示：
4.2 选择版本库
仅当选择「10.0 版本库」时，支持设置「消息推送」功能。
4.3 配置密钥
勾选「消息推送」功能，填写2.3节获取的ACCESS ID、ACCESS KEY，以及2.1新建产品中选择的服务接入点。如下图所示：
4.4 信鸽版本配置
信鸽版本配置勾选「TPNS 版本」。
推送通道可选择：
自建通道：打开App 后，可接收消息推送。不打开 App，无法接收消息推送。可跳过第 5 章操作步骤。
厂商通道：开通厂商通道，能够实现无需打开应用，即可收到推送消息。需执行第 5 章操作步骤。
5. 配置厂商通道
注：推送通道选择自建通道时，无需执行本章操作。
开通厂商通道，能够实现无需打开应用，即可收到推送消息。
5.1 获取厂商密钥
5.1.1 国内厂商
1）非华为厂商
用户根据需要适配的厂商通道，到对应的厂商开放平台，开通开发者账号，并获取厂商推送的密钥。如下表所示：
| 厂商 | 开发者平台 | 密钥 | 操作步骤 |
|---|---|---|---|
| 小米 | 小米开放平台 | AppId AppKey AppSecret | 1）进入 小米开放平台 ，开通小米开发者账号 2）获取厂商密钥：AppId、AppKey、AppSecret 更多详情请参见：快速接入指南 |
| 魅族 | 魅族开放平台 | AppId AppKey AppSecret | 1）进入 魅族推送官网，注册并登录开发者账号 2）获取厂商密钥：AppId，AppKey，AppSecret 更多详情请参见：魅族开发文档 |
| oppo | OPPO开放平台 | AppKey AppSecret MasterSecret | 1）使用 OPPO 企业开发者账号，登录 OPPO 开发平台 2）在「管理中心 > 应用服务平台 > 移动应用列表 > 选择应用 > 开发服务 > 推送服务」中完成 OPPO PUSH 权限申请 3）Opush 申请开通成功后，在「OPPO 推送平台 > 配置管理 > 应用配置」页面，获取厂商密钥：AppKey、AppSecret 和 MasterSecret 更多详情请参见：快速接入指引 |
| vivo | vivo开放平台 | AppId AppKey AppSecret | 开发者需向 vivo 申请开通推送权限，获取厂商密钥：AppID 、AppKey、AppSecret 更多详情请参见：快速接入指引 |
2）华为厂商
通过上传 agconnect-services.json 文件来配置。获取该文件的方法参见文档：获取agconnect-services.json文件
注 1：华为 2021 年 9 月 30 日起将停用 V2协议，因此 APP 把华为 v2通道切换为 v5通道。OEM华为通道，不再通过 HW_APPID 来配置，而是通过agconnect-services.json 文件来配置。
注 2：华为停用 V2协议后，老App华为厂商通道将无效，变更为信鸽自建通道。
5.1.2 海外厂商
Android 信鸽集群服务器选择「中国香港」或「新加坡」后，可以使用中国香港或新加坡集群的 FCM 通道向 Google 手机推送消息。
该功能按钮默认关闭，开启后需要上传 google-services.json 文件，获取该文件的方法参见文档：获取FCM的google-services.json
想要更换 google-services.json 文件可以重新传覆盖掉，上传文件后会持久保留，关闭按钮再开启配置文件仍然存在。
FCM 通道的设置位置如下图所示：
注：小米和华为也是支持海外通道的，设置方法同 5.1.1 的介绍。
5.2 配置信鸽厂商接入
登录 腾讯移动推送平台，点击产品管理>对应的应用>配置管理，打开需要的厂商推送通道，填写5.1 节获取的密钥。如下图所示：
5.3 配置 OEM 厂商通道
打开 帆软市场 App 打包界面，在消息推送>厂商通道处填写5.1 节获取的密钥。如下图所示：
注：如不填写相关密钥，即使打开了推送通道，仍将使用信鸽自建通道。
注：当「ANDROID信鸽集群服务器」设置为「香港」或「新加坡」时，推送通道的厂商通道只能选择小米或华为，如下图所示：
6. 效果展示
生成 App 安装包并下载安装，用户可以收到系统通知，App 主页底部菜单显示消息，如下图所示：
注：仅设置服务器消息推送，不设置OEM 消息推送打包，客户端将收不到系统通知，底部无消息列。
仅设置OEM 消息推送打包，不设置服务器消息推送，客户端将收不到系统通知，底部有消息列。
7. 屏蔽信鸽前端配置页面
插件 10.4.975 版本新增一个参数frontPageHidden，可以通过修改这个参数决定是否显示信鸽前端配置页面：
在数据库中修改表fine_conf_entity即可，默认为 false 。
设置frontPageHidden=true时推送配置页面隐藏。
设置frontPageHidden=false时推送配置页面显示。
注：该参数只有超级管理员才能使用，次级管理员或普通用户无权修改。