From a6dc4ce60358d17c37afa752e22293b9d8750832 Mon Sep 17 00:00:00 2001 From: yanyilin Date: Thu, 14 Jul 2022 04:16:49 +0000 Subject: [PATCH] update docs/tutorial/app-push-unipush.md. --- docs/tutorial/app-push-unipush.md | 145 +++++++++++++----------------- 1 file changed, 62 insertions(+), 83 deletions(-) diff --git a/docs/tutorial/app-push-unipush.md b/docs/tutorial/app-push-unipush.md index 495a86804..bfe48099f 100644 --- a/docs/tutorial/app-push-unipush.md +++ b/docs/tutorial/app-push-unipush.md @@ -25,96 +25,75 @@ - 本地离线打包参考[Android平台UniPush模块配置](https://nativesupport.dcloud.net.cn/AppDocs/usemodule/androidModuleConfig/push)、[iOS平台UniPush模块配置](https://nativesupport.dcloud.net.cn/AppDocs/usemodule/iOSModuleConfig/push) -### UniPush推送图标配置@unipush-icons - - -### UniPush自定义推送图标，可自定义push图标和小图标，位置如下图所示： - -![](https://native-res.dcloud.net.cn/images/uniapp/push/custom_push_icon/custom_push_icon_small_instructions.png) - - - -### 注意：需要手动在manifest.json配置 ，目前仅支持个推 & UniPush配置。 -### 5+应用： -+ plus节点 --> distribute节点 --> plugins节点 --> push节点 --> igexin节点（或者unipush节点） --> icons节点 --> small节点下配置 - -``` -"plugins": { // 第三方sdk配置 - "push": { // 模块名称 - "igexin": { // 个推SDK参数配置 - "appid": "xxxxxxx", // 个推的appid - "appkey": "xxxxxxx", // 个推的appkey - "appsecret": "xxxxxxx", // 个推的appsecret - "icons": { // 推送图片配置 - "push": { // push图标，规格与应用图片一致，不配置则默认使用push图标 - "ldpi": "可选，48x48", - "mdpi": "可选，48x48", - "hdpi": "可选，72x72", - "xhdpi": "可选，96x96", - "xxhdpi": "可选，144x144", - "xxxhdpi": "可选，192x192" - }, - "small": { // 小图标，png格式图片，仅使用alpha图层 - "ldpi": "可选，18*18", - "mdpi": "可选，24*24", - "hdpi": "可选，36*36", - "xhdpi": "可选，48*48", - "xxhdpi": "可选，72*72" - }, - "description": "推送图标" - }, - } - } -} +#### 推送图标配置@unipush-icons +UniPush和个推推送模块支持设置自定义推送图标，包括push图标和推送小图标(small) +- push图标 +默认使用应用图标 +- 推送小图标(small) +默认使用个推提供的小图标 + +显示效果如下图所示： +![](https://native-res.dcloud.net.cn/images/uniapp/push/custom_push_icon/custom_push_icon_small_instructions.png) + +##### 源码视图配置 +打开项目的manifest.json文件，切换到“源码视图”，手动设置推送图标。 +在 "app-plus" -> "distribute" -> "sdkConfigs" -> "push" -> "unipush" -> "icons"节点下配置推送图标 +```json + "unipush": { //可选，JSON对象，使用UniPush SDK配置，无需手动配置参数，云端打包自动获取配置参数 + "icons": { //可选，JSON对象，推送图标配置 + "push": { //可选，JSON对象，Push图标配置 + "ldpi": "", //可选，字符串类型，普通屏设备推送图标路径，分辨率要求48x48 + "mdpi": "", //可选，字符串类型，大屏设备设备推送图标路径，分辨率要求48x48 + "hdpi": "", //可选，字符串类型，高分屏设备推送图标路径，分辨率要求72x72 + "xdpi": "", //可选，字符串类型，720P高分屏设备推送图标路径，分辨率要求96x96 + "xxdpi": "", //可选，字符串类型，1080P高密度屏幕推送图标路径，分辨率要求144x144 + "xxxdpi": "", //可选，字符串类型，4K屏设备推送图标路径，分辨率要求192x192 + }, + "smal": { //可选，JSON对象，Push小图标配置 + "ldpi": "", //可选，字符串类型，普通屏设备推送小图标路径，分辨率要求18x18 + "mdpi": "", //可选，字符串类型，大屏设备设备推送小图标路径，分辨率要求24x24 + "hdpi": "", //可选，字符串类型，高分屏设备推送小图标路径，分辨率要求36x36 + "xdpi": "", //可选，字符串类型，720P高分屏设备推送小图标路径，分辨率要求48x48 + "xxdpi": "", //可选，字符串类型，1080P高密度屏幕推送小图标路径，分辨率要求72x72 + "xxxdpi": "", //可选，字符串类型，4K屏设备推送小图标路径，分辨率要求96x96 + } + } + }, + "igexin": { //可选，JSON对象，使用个推推送SDK配置，**已废弃，推荐使用UniPush，UniPush是个推推送VIP版，功能更强大** + "appid": "", //必填，字符串类型，个推开放平台申请的appid + "appkey": "", //必填，字符串类型，个推开放平台申请的appkey + "appsecret": "", //必填，字符串类型，个推开放平台申请的appsecret + "icons": { //可选，JSON对象，推送图标配置 + "push": { //可选，JSON对象，Push图标配置 + "ldpi": "", //可选，字符串类型，普通屏设备推送图标路径，分辨率要求48x48 + "mdpi": "", //可选，字符串类型，大屏设备设备推送图标路径，分辨率要求48x48 + "hdpi": "", //可选，字符串类型，高分屏设备推送图标路径，分辨率要求72x72 + "xdpi": "", //可选，字符串类型，720P高分屏设备推送图标路径，分辨率要求96x96 + "xxdpi": "", //可选，字符串类型，1080P高密度屏幕推送图标路径，分辨率要求144x144 + "xxxdpi": "", //可选，字符串类型，4K屏设备推送图标路径，分辨率要求192x192 + }, + "smal": { //可选，JSON对象，Push小图标配置 + "ldpi": "", //可选，字符串类型，普通屏设备推送小图标路径，分辨率要求18x18 + "mdpi": "", //可选，字符串类型，大屏设备设备推送小图标路径，分辨率要求24x24 + "hdpi": "", //可选，字符串类型，高分屏设备推送小图标路径，分辨率要求36x36 + "xdpi": "", //可选，字符串类型，720P高分屏设备推送小图标路径，分辨率要求48x48 + "xxdpi": "", //可选，字符串类型，1080P高密度屏幕推送小图标路径，分辨率要求72x72 + "xxxdpi": "", //可选，字符串类型，4K屏设备推送小图标路径，分辨率要求96x96 + } + } + } ``` -### uni应用： -+ app-plus节点 --> distribute节点 --> sdkConfigs节点 --> push节点 --> igexin节点（或者unipush节点） --> icons节点 --> small节点下配置 - -~~~ -"sdkConfigs": { - "push": { - "unipush": { - "icons": { // 推送图片配置 - "push": { // push图标，规格与应用图片一致，不配置则默认使用push图标 - "ldpi": "可选，48x48", - "mdpi": "可选，48x48", - "hdpi": "可选，72x72", - "xhdpi": "可选，96x96", - "xxhdpi": "可选，144x144", - "xxxhdpi": "可选，192x192" - }, - "small": { // 小图标，png格式图片，仅使用alpha图层 - "ldpi": "可选，18*18", - "mdpi": "可选，24*24", - "hdpi": "可选，36*36", - "xhdpi": "可选，48*48", - "xxhdpi": "可选，72*72" - }, - "description": "推送图标" - }, - } - } -} - -~~~ +**注意事项** +- igexin节点是配置“个推推送模块”的推动相关图标，已不再维护，推荐使用UniPush模块 +- 5+ App项目在manifest.json文件的 "plus" -> "distribute" -> "plugins" -> "push" -> "unipush" -> "icons"节点下配置推送图标 - - - -### 具体配置信息说明如下： - -### small图片要求 +### 推送小图标(small)要求 设计规范需要注意： 1. 必须是带 Alpha 透明通道的 PNG 图片。 2. 背景必须是透明的。 （如果非透明就会显示为白色方块） - - - - -![](http://partner-dcloud-native.oss-cn-hangzhou.aliyuncs.com/images/uniapp/push/unipsuh_small_icon_style.png.png) - +![](http://partner-dcloud-native.oss-cn-hangzhou.aliyuncs.com/images/uniapp/push/unipsuh_small_icon_style.png.png) -- GitLab