反馈已提交

网络繁忙

当前为10.0版本文档,只有最新版本的文档支持在线编辑修改,如果想创建/编辑文档,请移步至 最新版帮助文档

App打包支持消息推送

  • 文档创建者:Carly
  • 历史版本:14
  • 最近更新:Carly 于 2022-12-14
  • 1. 概述

    1.1 版本说明

    版本库

    信鸽推送配置插件版本

    支持的功能
    10.010.4.76支持腾讯消息推送中心有偿推送服务
    10.4.975
    • 新增一个参数,用来设置是否屏蔽掉信鸽前端配置页面

    • 新增信鸽集群服务器设置项,解决信鸽账号选择非广州集群后收不到信鸽消息的问题

    10.4.976
    • 服务器推送配置分为「国内设置」和「国际/中国港澳台设置」

    • App 打包配置页新增 FCM 通道,支持推送海外消息

    10.4.977APP 把华为 v2 通道切换为 v5 通道,因此 OEM 华为通道,不再通过 HW_APPID 来配置,而是通过 agconnect-services.json 来配置

    1.2 应用场景

    OEM 的 FineMobile 数据分析 App 可根据用户需求设置消息推送功能。

    1.3 功能介绍

    OEM 的 FineMobile 数据分析 App 可以使用自己的信鸽平台,且不通过推送中心进行消息转发。

    「消息推送」功能默认不勾选,用户勾选后,需填写一些配置信息,如下图所示:

    1611741504718789.png

    根据信鸽版本的不同,各类推送方式的功能区别也不相同,具体如下图所示:

    注:信鸽推送配置插件 V10.4.76 版本仅适配信鸽 TPNS 版本。

    信鸽版本配置
    推送通道功能

    TPNS版本

    (收费版本)

    自建通道需要购买 腾讯移动推送服务

    打开App 后,可接收消息推送

    不打开 App,无法接收消息推送

    厂商通道

    需要购买 腾讯移动推送服务

    无需打开应用,即可收到推送消息

    注:若用户 配置了 iOS 证书,且证书中不包含「Push Notifications」功能,则消息推送功能灰化,无法打包。如下图所示:

    1593860815392693.png

    2. 获取信鸽应用密钥

    2.1 新建产品

    登录 腾讯移动推送平台,点击产品管理>新增产品,填写产品信息,勾选平台版本,点击确定。如下图所示:

    注1:如果 iOS 和 Android 都需要打包,则都需要进行注册。

    注2:服务器接入点也就是信鸽集群,在后续步骤3.2推送配置4.3配置密钥会用到,需要注意下。

    注3:大陆用户选择广州或上海集群,港澳台及海外用户选择中国香港或新加坡集群。

    2020-06-04_15-04-27.png

    2.2 配置管理

    填写配置,此处的应用包名应与 帆软 App 打包证书 中的package包名一致,如下图所示:

    image.png

    2.3 获取参数

    配置完成后,会得到三个和 App 相关的参数:ACCESS IDACCESS KEYSECRET KEY

    image.png

    3. 服务器推送配置

    3.1 插件安装

    点击下载插件:信鸽推送配置(TPNS)插件

    设计器插件安装方法参照 设计器插件管理

    服务器安装插件方法参照 服务器插件管理

    注:需安装 V10.4.76 及以上版本的插件

    3.2 推送配置

    插件安装后,登录数据决策平台,管理系统>移动平台目录下新增推送配置

    推送配置分为「国内设置」和「国际/中国港澳台设置」,国内设置的集群服务器可选广州或上海,国际/中国港澳台设置的集群服务器可选中国香港或新加坡。

    推送配置分为「国内设置」和「国际/中国港澳台设置」后,现在可以一次向多个集群推送消息,例如同时向上海和新加坡集群推送消息。

    选择设置方式后,填写2.3节获取的ACCESS IDSECRET KEY,以及2.1新建产品中选择的服务接入点。

    如下图所示:

    1611131398235654.png

    3.3 设置代理服务器

    如报表服务器部署在内网,不能访问外网,也不能被外网访问,此时需要配置代理服务器,方可成功推送消息。具体操作请参见:代理服务器配置

    4. App 打包配置

    4.1 新建应用

    注1:正常定制打包步骤请参见 App 打包 ,本文仅对消息推送设置进行说明。

    打开 帆软市场 ,点击用户中心>App 打包新建应用或对已有 App 进行打包,如下图所示:

    2020-06-04_10-41-43.png

    4.2 选择版本库

    仅当选择「10.0 版本库」时,支持设置「消息推送」功能。

    image.png

    4.3 配置密钥

    勾选「消息推送」功能,填写2.3节获取的ACCESS IDACCESS KEY,以及2.1新建产品中选择的服务接入点。如下图所示:

    1606976428984935.png

    4.4 信鸽版本配置

    信鸽版本配置勾选「TPNS 版本」。

    推送通道可选择:

    • 自建通道:打开App 后,可接收消息推送。不打开 App,无法接收消息推送。可跳过第 5 章操作步骤。

    • 厂商通道:开通厂商通道,能够实现无需打开应用,即可收到推送消息。需执行第 5 章操作步骤。

    1591329929830422.png

    5. 配置厂商通道

    注:推送通道选择自建通道时,无需执行本章操作。

    开通厂商通道,能够实现无需打开应用,即可收到推送消息。

    5.1 获取厂商密钥

    5.1.1 国内厂商

    1)非华为厂商

    用户根据需要适配的厂商通道,到对应的厂商开放平台,开通开发者账号,并获取厂商推送的密钥。如下表所示:

    厂商
    开发者平台密钥操作步骤
    小米小米开放平台

    AppId

    AppKey

    AppSecret

    1)进入 小米开放平台 ,开通小米开发者账号

    2)获取厂商密钥:AppId、AppKey、AppSecret

    更多详情请参见:快速接入指南

    魅族魅族开放平台

    AppId

    AppKey

    AppSecret

    1)进入 魅族推送官网,注册并登录开发者账号

    2)获取厂商密钥:AppId,AppKey,AppSecret

    更多详情请参见:魅族开发文档

    oppoOPPO开放平台

    AppKey

    AppSecret

    MasterSecret

    1)使用 OPPO 企业开发者账号,登录 OPPO 开发平台

    2)在「管理中心 > 应用服务平台 > 移动应用列表 > 选择应用 > 开发服务 > 推送服务」中完成 OPPO PUSH 权限申请

    3)Opush 申请开通成功后,在「OPPO 推送平台 > 配置管理 > 应用配置」页面,获取厂商密钥:AppKey、AppSecret 和 MasterSecret

    更多详情请参见:快速接入指引

    vivovivo开放平台

    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 通道的设置位置如下图所示:

    Snag_20721e26.png

    注:小米和华为也是支持海外通道的,设置方法同 5.1.1 的介绍。

    5.2 配置信鸽厂商接入

    登录 腾讯移动推送平台,点击产品管理>对应的应用>配置管理,打开需要的厂商推送通道,填写5.1 节获取的密钥。如下图所示:

    2020-06-04_16-25-32.png

    5.3 配置 OEM 厂商通道

    打开 帆软市场  App 打包界面,在消息推送>厂商通道处填写5.1 节获取的密钥。如下图所示:

    注:如不填写相关密钥,即使打开了推送通道,仍将使用信鸽自建通道。

    1591259797590620.png

    注:当「ANDROID信鸽集群服务器」设置为「香港」或「新加坡」时,推送通道的厂商通道只能选择小米或华为,如下图所示:

    1611131912862133.png

    6. 效果展示

    生成 App 安装包并下载安装,用户可以收到系统通知,App 主页底部菜单显示消息,如下图所示:

    1572242716442067.png

    注:仅设置服务器消息推送,不设置OEM 消息推送打包,客户端将收不到系统通知,底部无消息列。

           仅设置OEM 消息推送打包,不设置服务器消息推送,客户端将收不到系统通知,底部有消息列。

    7. 屏蔽信鸽前端配置页面

    插件 10.4.975 版本新增一个参数frontPageHidden,可以通过修改这个参数决定是否显示信鸽前端配置页面:

    在数据库中修改表fine_conf_entity即可,默认为 false 。

    • 设置frontPageHidden=true时推送配置页面隐藏。

    • 设置frontPageHidden=false时推送配置页面显示。

    注:该参数只有超级管理员才能使用,次级管理员或普通用户无权修改。

    附件列表


    主题: 移动端应用
    已经是第一篇
    已经是最后一篇
    • 有帮助
    • 没帮助
    • 只是浏览

    售前咨询电话

    400-811-8890转1

    在线技术支持

    请前往「服务平台」,选择「在线支持」

    热线电话:400-811-8890转2

    总裁办24H投诉

    热线电话:173-1278-1526