Skip to content
体验新版
项目
组织
正在加载...
登录
切换导航
打开侧边栏
你丑我先上
unidocs-zh
提交
a5d4e1c6
U
unidocs-zh
项目概览
你丑我先上
/
unidocs-zh
与 Fork 源项目一致
Fork自
DCloud / unidocs-zh
通知
1
Star
0
Fork
0
代码
文件
提交
分支
Tags
贡献者
分支图
Diff
Issue
0
列表
看板
标记
里程碑
合并请求
0
DevOps
流水线
流水线任务
计划
Wiki
0
Wiki
分析
仓库
DevOps
项目成员
Pages
U
unidocs-zh
项目概览
项目概览
详情
发布
仓库
仓库
文件
提交
分支
标签
贡献者
分支图
比较
Issue
0
Issue
0
列表
看板
标记
里程碑
合并请求
0
合并请求
0
Pages
DevOps
DevOps
流水线
流水线任务
计划
分析
分析
仓库分析
DevOps
Wiki
0
Wiki
成员
成员
收起侧边栏
关闭侧边栏
动态
分支图
创建新Issue
流水线任务
提交
Issue看板
体验新版 GitCode,发现更多精彩内容 >>
提交
a5d4e1c6
编写于
8月 02, 2022
作者:
taohebin@dcloud.io
浏览文件
操作
浏览文件
下载
电子邮件补丁
差异文件
update app-push-unipush.md
上级
58daa85b
变更
1
隐藏空白更改
内联
并排
Showing
1 changed file
with
88 addition
and
0 deletion
+88
-0
docs/tutorial/app-push-unipush.md
docs/tutorial/app-push-unipush.md
+88
-0
未找到文件。
docs/tutorial/app-push-unipush.md
浏览文件 @
a5d4e1c6
...
...
@@ -24,6 +24,94 @@
-
UniPush推送功能需要提交云端打包后才能生效,真机运行时请使用
[
自定义调试基座
](
https://ask.dcloud.net.cn/article/35115
)
-
本地离线打包参考
[
Android平台UniPush模块配置
](
https://nativesupport.dcloud.net.cn/AppDocs/usemodule/androidModuleConfig/push
)
、
[
iOS平台UniPush模块配置
](
https://nativesupport.dcloud.net.cn/AppDocs/usemodule/iOSModuleConfig/push
)
#### FCM配置@unipush-gp-fcm
##### 概述
在海外网络环境下,部分网络在连接UniPush技术支持供应商个推的推送服务时,可能出现不稳定的情况。此时,开发者可以接入 FCM 辅助通道,当在个推服务断线的情况下,通过谷歌的 FCM 推送通道下发消息,提升推送到达率。
**使用FCM时手机端需安装Google移动服务(GMS),并且可以正常连接Google服务(国内网络需要翻墙)**
使用FCM必须先开通使用UniPush:
-
开通UniPush服务参考:
[
https://ask.dcloud.net.cn/article/35716
](
https://ask.dcloud.net.cn/article/35716
)
-
App端使用UniPush参考:
[
https://ask.dcloud.net.cn/article/35622
](
https://ask.dcloud.net.cn/article/35622
)
##### 从谷歌后台申请key信息
进入
[
Firebase官网
](
https://firebase.google.com/
)
创建项目,获取google-services.json文件及Server key。
登录google账号,如果没有账号请先注册
![](
https://img.cdn.aliyun.dcloud.net.cn/client/ask/unipush/fcm/signin.png
)
登录后点击右上角的“Go to console”
![](
https://img.cdn.aliyun.dcloud.net.cn/client/ask/unipush/fcm/gotoconsole.png
)
打开项目列表页面,点击“Add project”创建项目
![](
https://img.cdn.aliyun.dcloud.net.cn/client/ask/unipush/fcm/addproject.png
)
输入项目名称(根据自己应用取名),点击“Continue”
![](
https://img.cdn.aliyun.dcloud.net.cn/client/ask/unipush/fcm/createproject1.png
)
确认是否需要使用Google Analytics服务(根据自己需要开启或关闭),点击“Continue”
![](
https://img.cdn.aliyun.dcloud.net.cn/client/ask/unipush/fcm/createproject2.png
)
确认后创建项目,点击“Continue”
![](
https://img.cdn.aliyun.dcloud.net.cn/client/ask/unipush/fcm/createproject3.png
)
进入项目详情页面,点击“Android”图标添加Android应用
![](
https://img.cdn.aliyun.dcloud.net.cn/client/ask/unipush/fcm/android.png
)
输入Android应用信息(包名、昵称、证书SHA-1),点击“Register App”
![](
https://img.cdn.aliyun.dcloud.net.cn/client/ask/unipush/fcm/regapp.png
)
注册Android应用后下载配置文件“google-services.json”,
**保存google-services.json文件后面需要使用**
点击“Next”继续
![](
https://img.cdn.aliyun.dcloud.net.cn/client/ask/unipush/fcm/download.png
)
此步骤中的操作云端打包机已经处理,忽略提示信息,继续点击“Next”,进入下一步
完成注册Android应用,点击“Continue to console”回到项目详情页面
![](
https://img.cdn.aliyun.dcloud.net.cn/client/ask/unipush/fcm/continuetoconsole.png
)
点击“Project settings”,进入项目设置页面
![](
https://img.cdn.aliyun.dcloud.net.cn/client/ask/unipush/fcm/settings.png
)
切换到“Cloud Messaging”项,获取“Server key”,
**保存Server key后面需要使用**
由于新版
`Firebase Cloud Messaging API (V1)`
不提供
`Server key`
, 所以需要手动开启旧版
`Cloud Messaging API`
。
![](
https://native-res.dcloud.net.cn/images/uniapp/push/firebase/firebase_android_setup_get_server_key.png
)
跳转到Api管理页面启动
`Cloud Messaging API`
![](
https://native-res.dcloud.net.cn/images/uniapp/push/firebase/firebase_android_open_old_api.png
)
启动
`Cloud Messaging API`
后即可得到
`Server key`
![](
https://native-res.dcloud.net.cn/images/uniapp/push/firebase/firebase_android_server_key.png
)
##### UniPush后台配置FCM参数
配置FCM需先开通UniPush,如应用未开通UniPush请先开通。
在HBuilderX的mainfest.json页面,在“App SDK配置”项下的“uniPush”栏点击“配置”
![](
https://img.cdn.aliyun.dcloud.net.cn/client/ask/unipush/fcm/hx_unipush.png
)
打开DCloud的开发者中心后台进入应用列表,点击应用名称进入详情,点击上方“uniPush”选项卡,点击“厂商推送设置”按钮进入配置UniPush的FCM参数
[attach]94813[/attach]
保存成功后在HBuilderX中重新提交云端打包,并在“App-云打包”界面选择google play 渠道包:
![](
https://img.cdn.aliyun.dcloud.net.cn/client/ask/unipush/fcm/hx_package.png
)
如果你已经完成了uniPush的代码开发,只需完成上述配置和打包即可,不用修改代码。
如果你还没有开发过推送代码,参考App端使用UniPush参考:
[
https://ask.dcloud.net.cn/article/35622
](
https://ask.dcloud.net.cn/article/35622
)
##### 本地离线打包
Android平台离线sdk集成UniPush支持FCM可参考:
[
Push(消息推送)
](
https://nativesupport.dcloud.net.cn/AppDocs/usemodule/androidModuleConfig/push?id=%e8%b0%b7%e6%ad%8c%e6%8e%a8%e9%80%81
)
##### 注意事项
** FCM 离线消息仅支持GOOGLE 推送,暂不支持国内设备商的海外发行版本**
#### Android平台推送图标配置@unipush-icons
UniPush和个推推送模块支持设置自定义推送图标,包括push图标和推送小图标(small)
...
...
编辑
预览
Markdown
is supported
0%
请重试
或
添加新附件
.
添加附件
取消
You are about to add
0
people
to the discussion. Proceed with caution.
先完成此消息的编辑!
取消
想要评论请
注册
或
登录