<%= name %>
<%= description %>
<%= name %>小程序，基于 gulp4 和 webpack 打包，src 为源代码，dist** 为打包后代码，小程序添加项目文件夹指定 dist** 目录
# 适配方案介绍
http://confluence.corp.imdada.cn/pages/viewpage.action?pageId=10933392
# 目录结构介绍
```JavaScript
src--|--config --项目配置文件(微信/百度/支付宝)
|--distWeapp --微信包
|--distSwan --百度包
|--disAliapp --支付宝包
|--disQqapp --qq包
|--disTtapp --头条包
|--src--|--adapters --框架-通用功能/非通用功能 适配模块
| |--common --*框架通用功能*
| | |--weapp --微信适配模块
| | |--swan --百度适配模块
| | |--qqapp --qq适配模块
| | |--ttapp --头条适配模块
| | |--aliapp --支付宝适配模块 （微信/百度/支付宝三个模块的目录结构基本一致）
| | |--common --该目录以及自目录 与 src中common模块以及子目录 一一对应
| | |--components --组件
| | |--utils --功能api（request/事件等）二次封装
| |
| |--unique --框架非通用功能，对应子项目库--dadaMPAdapter（注意：只有达达同学有权限拉取该部分模块代码）
| |--weapp --微信适配模块
| |--swan --百度适配模块
| |--qqapp --qq适配模块
| |--aliapp --支付宝适配模块 （微信/百度/支付宝三个模块的目录结构基本一致）
| |--common --该目录以及自目录 与 src中common模块以及子目录 一一对应
| |--pages --该目录以及自目录 与 src中pages模块以及子目录 一一对应
|
|--common --各小程序业务代码，通用业务模块，对应子项目库--spruce（注意：只有达达同学有权限拉取该部分模块代码）
|--components --通用组件
|--pages/web --小程序通过webview适配H5。多端可以使用一套H5，减少开发/维护成本。（浏览器/APP/小程序）
|--pages --各小程序业务逻辑代码
```
# adapters目录内容总结
组件适配：cell、modal、pure-modal、slide-up
页面适配：登陆、个人中心头部
api适配：getStorageSync, setStorageSync, removeStorageSync, request, triggerEvent,
showToast, setIncludePoints, getClipboardData
# 脚本命令
yarn 安装依赖
yarn start:weapp 发布微信小程序代码 生产目录 distWeapp
yarn start:swan 发布百度小程序代码 生产目录 distSwan
yarn start:aliapp 发布支付宝小程序代码 生产目录 disAliapp
# 多端（微信/百度/支付宝/QQ/头条）差异整理
http://confluence.corp.imdada.cn/pages/viewpage.action?pageId=10789946
# 多端适配注意事项
1，编译（目的适配支付宝）：微信组件，可以接收组件未定义属性 如事件/样式，支付宝组件经编译后，这些属性会丢失，需要注意把这些属性统一写在外层。
对此，我们需要注意自定义组件的使用规范，非组件定义的属性，一律不能写在组件上。
编译正确示例：
```JavaScript
```
编译错误示例：
```JavaScript
```
2，事件传递接收传参：
事件触发
```JavaScript
triggerEvent(this, 'chooseCoupon', {
couponId: event.currentTarget.dataset.coupon.couponId,
})
```
接收参数
```JavaScript
let activeId = event.couponId || event.detail.couponId
```
3，事件通过设置data传参大小写：
```JavaScript
taskTypeId = e.currentTarget.dataset.tasktypeid
taskTypeId = e.currentTarget.dataset.taskTypeId
```
4，组件属性赋值（目的适配支付宝）：
支付宝组件外面传入属性定义如 props: { title: 'abc'}，而微信中是property: { type: String, title: 'abc' },
这里适配核心是属性有默认值或者被赋值，所以统一适配成被赋值。需要注意的点是，即使仅需要使用默认值的情况，在使用组件时，
不能省略赋值操作。
```JavaScript
Component({
properties: {
// 是否可点击，显示箭头
hasArrow: {
type: Boolean,
value: true,
},
}
})
|
|
```
5，标签不闭合可能导致xml等转译失败：
因为目前我们的xml/js语法转译主要采用正则匹配替换方式，标签不闭合可能导致xml等语法转译失败。
```JavaScript
|
|
```
6，关于APP_TYPE的使用
该字段可以应用在xml以及js文件中。在编译打包时，根据打包命令参数来赋值，举例如yarn start:weapp，
则APP_TYPE字段会被'weapp'取代，可以应用该字段进行不同平台的适配，但如果对应平台适配差异较大，建议
考虑把对应适配模块抽象到adapters/unique模块。
```JavaScript
if (APP_TYPE === 'weapp') {
return
}
yarn start:weapp 则 APP_TYPE='weapp'
yarn start:swan 则 APP_TYPE='swan'
yarn start:aliapp 则 APP_TYPE='aliapp'
yarn start:qqapp 则 APP_TYPE='qqapp'
yarn start:ttapp 则 APP_TYPE='ttapp'
```
7，已适配api
```JavaScript
getStorageSync,
setStorageSync,
removeStorageSync,
request,
triggerEvent,
setIncludePoints（地图api）,
getClipboardData,
setTitle,
showToast,
showModal,
requestPayment,
makePhoneCall,
navigateToMiniProgram
目前只适配了我们认为常用的api，未来会逐渐适配更多api
```