平台类适配开发流程

[Ymm0008]

H5 适配

第一步：工程启动

首先 clone NutUI 的工程到本地

git clone https://github.com/jdf2e/nutui.git

cd nutui

yarn && yarn dev

1、启动后注意切换到手机模式

2、点击对应组件查看运行结果

第二步：开发设计

H5 的开发仅关注 index.vue 文件，进行修改组件逻辑或新增 props。如涉及 api 的改动，需要同步中英文的 md 文档。

详细开发流程务必关注 #1671

第三步：预览验证

开发完成后推荐使用草料工具生成二维码，使用手机扫码验证，或者开发者利用其它方式进行手机验证。

Taro 适配

工程的下载依照 H5 的步骤进行，工程启动命令略有不同。

# 启动 taro 环境下的 h5
yarn dev:taro:h5

# 启动 taro 环境下的微信小程序
yarn dev:taro:weapp

关于其他的命令，可查看 package.json 文件。

以下小程序的适配我们以微信小程序为例

第一步：工程启动

1、taro H5 的启动会自动打开浏览器

2、taro 小程序启动后，我们需借助开发者工具发开预览页面（PS：每个小程序都有独立的开发者工具）

3、小程序启动后，打开的文件目录层级为 nutui -> src -> sites -> mobile-taro -> vue -> dist

第二步：taro 适配开发

关于 taro 的开发需要关注 index.taro.vue 文件，包括 taro 环境下启动的 H5 和 小程序，适配开发都在此文件中进行。

每个小程序的 api 或有不同，开发者可根据 Taro.getEnv() 判断环境进行适配。

第三步：预览验证

根据开发者工具提供的预览功能，我们直接扫码查看效果。

开发流程

以上步骤均为前期的开发工作，组件开发请遵守 NutUI 的流程规范，请关注 #1671

注意事项

1. H5 和 taro 的样式使用同一个文件 index.scss，需要将组件的样式都写在此文件中。

2. doc 文档需区分 taro 和 H5，H5 部分包括 doc.md 和 doc.en-US.md，taro 部分包括 doc.taro.md。