# 美的项目统一路由跳转技术文档
# 前置说明
本文档主要针对美的项目内各个业务跳转路由链接的规范
# 方案概况
对所有业务路由链接格式作出规范，包括APP外部链接的跳转和APP内部页面的跳转，以及对各种情况的跳转作出相应链接的格式的规范
# 链接url规则-外部跳转APP各界面
- url跳转实例：（app外要跳转到app相关界面的链接示例）
//跳转app内部相关原生界面
midea-meiju://com.midea.meiju/main?type=jumpNative&pageName=service_home&needNavi=1
//跳转app内部weex设备插件
midea-meiju://com.midea.meiju/main?type=jumpWeexPlugin&deviceId=12345678987654&needNavi=1
//跳转app内部h5插件
midea-meiju://com.midea.meiju/main?type=jumpH5Plugin&deviceId=1344478987654&needNavi=1
//跳转app内部服务，场景，帮助中心等等除去weex插件之外的所有weex界面
midea-meiju://com.midea.meiju/main?type=jumpWeex&url=community%2Fforum.js%3FforumCode%3DSQ004%26id%3D68%26forumName%3D%E6%99%BA%E8%83%BD&needNavi=1
//跳转app内部web界面(url值需要做编码encode)
midea-meiju://com.midea.meiju/main?type=jumpWebView&url=xxxxxxxxxxxxxx&needNavi=1
// 跳转dolphinHybird H5插件包示例： moduleNo=模块id&page=目标调试页
meiju://com.midea.meiju/main?type=jumpHybridModule&moduleNo=21000&page=index.html
// 跳转dolphinWeex weex业务插件
meiju://com.midea.meiju/main?type=jumpHybridModule&moduleNo=21000&page=detial.js
// 跳转dolphinHybird web页面示例：
meiju://com.midea.meiju/main?type=jumpWebViewNew&url=xxxx&needNavi=1&enableSafeArea=false&fitsSystemWindows=true
// 跳转电商H5
midea-meiju://com.midea.meiju/main?type=jumpElecBusiness&url=xxxxx&needNavi=1
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
TIP
注意：安卓和iOS头部meiju和Midea-meiju都可以行，安卓之前定义为meiju是为了兼容之前的版本
前段domain是跳转APP的目标链接，固定字段，后面为根据规则编写的路由信息
json信息具体内容有：type–跳转类型，后面的key-value因前面的type不同而不同
| Type | Params | Params Description |
|---|---|---|
| jumpWebView (跳转webview) | url | h5链接地址（url值需要做编码encode） |
| needNavi | 是否需要导航栏 | |
| isHideNavBar | 控制导航栏的显示和隐藏：0 隐藏/1 显示 | |
| jumpH5Plugin (跳转h5插件页) | deviceId | 设备id |
| needNavi | 是否需要导航栏 | |
| 其他 | 其他自定义参数传参最后交由目标界面自己处理 | |
| jumpWeexPlugin (跳转weex插件页) | deviceId | 设备id |
| needNavi | 是否需要导航栏 | |
| 其他 | 其他自定义参数传参最后交由目标界面自己处理 | |
| jumpNative (跳转原生页) | pageName | 原生界面的命名 |
| needNavi | 是否需要导航栏 | |
| 其他 | 其他自定义参数传参最后交由目标界面自己处理 | |
| jumpWeex (跳转weex) | url | url/weex路径 |
| needNavi | 是否需要导航栏 | |
| pageBackgroundColor | 容器背景颜色 | |
| 其他 | 其他自定义参数传参最后交由目标界面自己处理 | |
| jumpElecBusinessWeex (跳转电商weex页面) | url | url/weex路径，示例：dist/pages/member/score_exchange_detail.js?androidback&exchangeId=094927A147 |
| 其他 | 其他自定义参数传参最后交由目标界面自己处理 | |
| jumpWebViewNew (跳转dolphinHybird web页面) | url | 页面路径http://xxx |
| needNavi | 是否需要导航栏 | |
| enableSafeArea (iOS独有) | 是否禁掉安全区域，false为关闭，true为开启，开启后刘海屏底部弧度范围内不显示内容 | |
| fitsSystemWindows (Android独有) | 是否将顶部状态栏高度交给H5控制；true为开启，开启后页面呈全屏状态，可实现沉浸式UI效果 | |
| pageBackgroundColor | 页面webview背景颜色 | |
| replace | 是否替换当前的webview | |
| params |
params: { statusBarType: 'black', // 状态栏样式 black/white showTitleBar: 'YES', // 是否显示标题栏 showStatusBar: 'YES', // 是否显示状态栏 textColor: '#00FFff', // 标题的颜色 backgroundColor: '#00FF00', // 标题栏背景颜色 transparentTitle: 'NO', // 标题栏是否透明 fitsSystemWindows: 'YES', // android专用，"YES" 去掉状态栏占位， "NO" 显示状态占位 enableSafeArea: 'YES', // 只针对iOS设置，是否开发安全区域，开启后安全区域不显示内容 backBtnStyle: '0' //按钮样式。"0"-黑色，"1"-白色 } | |
| jumpHybridModule (跳转dolphinHybird H5插件或weex业务插件) | moduleNo | 模块标识(模块标识和模块别名二选一) |
| module | 模块别名(模块标识和模块别名二选一) | |
| page | 页面相对路径 |
# 链接url规则-APP内部跳转
- 目前支持的内部跳转
| 目标页面 | 对应的url |
|---|---|
| 跳转到【智能】-【食谱】页面（不包含APP导航栏） | {type:"jumpNative",param:{ pageName:"cook_home", needNavi:"0"}} |
| 跳转到【我的】页面（包含APP导航） | {type:"jumpNative",param:{ pageName:"mine_home",needNavi:"1"}} |
| 【首页】页面（包含APP导航） | {type:"jumpNative",param:{ pageName:"home",needNavi:"1", operation:"x"}} ("operation"为可选字段，x=1时为展示捷径页，x=2时为展示全屋页) |
| 跳转到其它运营H5页面（不包含APP导航） | {type:"jumpWebView",param:{ url:"https://www.midea.cn/",needNavi:"1}} |
| 跳转设备插件H5页（不包含APP导航） | {type:"jumpH5Plugin",param:{ deviceId:"2199023350870",needNavi:"1",(其他自定义字段key-value)}} |
| 跳转设备插件weex页（不包含app导航） | {type:"jumpWeexPlugin",param:{ deviceId:"2199023350870",needNavi:"1"， (其他自定义字段key-value)}} |
| 跳转到商城首页（包含APP导航） | {type:"jumpNative",param:{ pageName:"mall",needNavi:"1"}} |
| 场景首页（包含APP导航） | {type:"jumpNative",param:{ pageName:"scene",needNavi:"1"}} |
| 社区首页（不包含APP导航） | {type:"jumpWeex",param:{ pageName:"community",needNavi:"1"}} |
| weex模块子页面（以帮助中心问题详情界面为例） | {type:"jumpWeex",param:{ url:"device-helpcenter/deviceProblems/problemDetail.js? id=1005&tag=1000&........"，needNavi:"1"}} |
| 跳转电商模块 | {type:"jumpElecBusiness",param:{ url:"www.midea.cn 或m.midea.cn或event.midea.cn开头的链接（由电商提供}} |
| 跳转到【智能】-【食谱】食谱详情界面 | {type:"jumpNative",param:{ pageName:"foodDetail", foodId:1234, needNavi:"1"}} |
| 跳转酷狗音乐授权页面（未登录未绑定） | {type:"jumpNative",param:{ pageName:"kugoumusic/auth",deviceId:"xxxxxxx",needNavi:"1"}} |
| 跳转酷狗音乐授权页面（已登录未绑定） | {type:"jumpNative",param:{ pageName:"kugoumusic/bind", diviceId:"xxxxxxx",nickname:"x",pic:"xxxxxxx",canAuth:"1",needNavi:"1"}} |
| 跳转酷狗音乐授权页面（已登录已绑定） | {type:"jumpNative",param:{ pageName:"kugoumusic/status", diviceId:"xxxxxxx",nickname:"x",pic:"xxxxxxx",needNavi:"1"}} |