mirror of
https://github.com/kuaifan/dootask.git
synced 2026-08-06 21:08:34 +00:00
61 lines
2.2 KiB
Markdown
61 lines
2.2 KiB
Markdown
---
|
||
id: push-notice.config.howto
|
||
title: 配置友盟 APP 推送
|
||
type: howto
|
||
feature: push-notice
|
||
scope: admin
|
||
locale: zh
|
||
aliases:
|
||
- 配置友盟
|
||
- UMENG 配置
|
||
- APP 推送配置
|
||
- 配置 appkey
|
||
- 怎么开推送
|
||
- 友盟密钥
|
||
related_tools: []
|
||
related_pages: []
|
||
prerequisites:
|
||
- 需要系统管理员权限
|
||
- 已在 https://www.umeng.com 注册友盟账号并创建对应的 iOS / Android 应用
|
||
- 已拿到 App Key 和 App Master Secret
|
||
negative:
|
||
- 当环境变量 SYSTEM_SETTING=disabled 时禁止从界面修改推送设置（密钥会脱敏显示）
|
||
- 必须同时填 iOS 和 Android 的 key/secret 才能两端都收到；只填一端则只推一端
|
||
- 默认 production_mode=true，意味必须用正式签名的 APP 包，开发版 APP 收不到
|
||
last_verified: v1.7.90
|
||
---
|
||
|
||
# 配置友盟 APP 推送
|
||
|
||
## 入口
|
||
桌面端：左侧栏「管理后台」→「系统设置」→「APP 推送」选项卡
|
||
|
||
## 操作步骤
|
||
1. 在「开启推送」选择「开启」
|
||
2. 「iOS 参数配置」区填写：
|
||
- Appkey
|
||
- App Master Secret
|
||
3. 「Android 参数配置」区填写：
|
||
- Appkey
|
||
- App Master Secret
|
||
4. 底部「提交」保存
|
||
5. 保存后即时生效，无需重启服务
|
||
|
||
## 字段说明
|
||
| 字段 | 默认 | 说明 |
|
||
|---|---|---|
|
||
| push | close | 总开关；close 时所有 APP 推送任务不入队 |
|
||
| ios_key | 空 | 友盟 iOS App Key |
|
||
| ios_secret | 空 | 友盟 iOS App Master Secret，前端 password 显示 |
|
||
| android_key | 空 | 友盟 Android App Key |
|
||
| android_secret | 空 | 友盟 Android App Master Secret |
|
||
|
||
## 推送配置生效后做什么
|
||
- 接 alias 注册：APP 启动登录后自动调 `api/users/umeng/alias` 注册别名（详见 [[push-notice.alias.concept]]）
|
||
- 推送触发：新消息到达 `WebSocketDialogMsgTask` 会调用 `PushUmengMsg` 入队推送，参考 [[push-notice.scenarios.concept]]
|
||
- 推送结果落 `umeng_logs` 表：可用于排查（详见 [[push-notice.troubleshoot.faq]]）
|
||
|
||
## 不支持
|
||
- 国内厂商通道（OPPO/华为/小米/VIVO）不开箱即用：需走友盟厂商通道下发，并在友盟控制台单独配置厂商证书
|
||
- 不能用替代推送服务，DooTask 推送层与友盟 SDK 强绑定
|