chore: changelog && docs

NervJS · Jan 21, 2020 · 940f0aa · 940f0aa
1 parent c585700
commit 940f0aa
Show file tree

Hide file tree

Showing 12 changed files with 2,063 additions and 1 deletion.
diff --git a/CHANGELOG.md b/CHANGELOG.md
@@ -1,5 +1,24 @@
 <a name=""></a>
-# [](https://github.com/NervJS/taro/compare/v2.0.1...v) (2020-01-14)
+# [](https://github.com/NervJS/taro/compare/v2.0.2...v) (2020-01-21)
+
+
+
+<a name="2.0.2"></a>
+## [2.0.2](https://github.com/NervJS/taro/compare/v2.0.1...v2.0.2) (2020-01-21)
+
+
+### Bug Fixes
+
+* **cli:** 修复 Node 13 创建项目时的问题, close [#5285](https://github.com/NervJS/taro/issues/5285) ([efc394c](https://github.com/NervJS/taro/commit/efc394c))
+* **h5:** 修复Video组件设置了poster后controlers失效的问题 ([03a3229](https://github.com/NervJS/taro/commit/03a3229))
+* **mini-runner:** 修复小程序 watch 时支持压缩的问题 close [#5322](https://github.com/NervJS/taro/issues/5322) ([#5355](https://github.com/NervJS/taro/issues/5355)) ([11375dc](https://github.com/NervJS/taro/commit/11375dc))
+* **rn:** react native react-redux 版本太低 close [#5335](https://github.com/NervJS/taro/issues/5335) ([e92c019](https://github.com/NervJS/taro/commit/e92c019))
+* 修复编译微信小程序插件时 miniprogramRoot 被更改的问题 close [#5338](https://github.com/NervJS/taro/issues/5338) ([21a0b73](https://github.com/NervJS/taro/commit/21a0b73))
+
+
+### Features
+
+* **swan:** 百度也加上绕开 diff 的后门 ([efaefd4](https://github.com/NervJS/taro/commit/efaefd4)), closes [#5277](https://github.com/NervJS/taro/issues/5277)
 
 
 

diff --git a/website/versioned_docs/version-2.0.2/README.md b/website/versioned_docs/version-2.0.2/README.md
@@ -0,0 +1,144 @@
+---
+title: Taro 介绍
+id: version-2.0.2-README
+original_id: README
+---
+
+> 这是 Taro 2.x 版本的文档，若要查看 1.x 版本的文档，请[点击这里选择版本](/taro/versions.html)。
+
+## 简介
+
+**Taro** 是一套遵循 [React](https://reactjs.org/) 语法规范的 **多端开发** 解决方案。
+
+现如今市面上端的形态多种多样，Web、React-Native、微信小程序等各种端大行其道，当业务要求同时在不同的端都要求有所表现的时候，针对不同的端去编写多套代码的成本显然非常高，这时候只编写一套代码就能够适配到多端的能力就显得极为需要。
+
+使用 **Taro**，我们可以只书写一套代码，再通过 **Taro** 的编译工具，将源代码分别编译出可以在不同端（微信/百度/支付宝/字节跳动/QQ小程序、快应用、H5、React-Native 等）运行的代码。
+
+## 特性
+
+#### React 语法风格
+
+**Taro** 遵循 [React](https://reactjs.org/) 语法规范，它采用与 React 一致的组件化思想，组件生命周期与 React 保持一致，同时支持使用 [JSX 语法](jsx.html)，让代码具有更丰富的表现力，使用 **Taro** 进行开发可以获得和 React 一致的开发体验。
+
+代码示例
+
+```jsx
+import Taro, { Component } from '@tarojs/taro'
+import { View, Button } from '@tarojs/components'
+
+export default class Index extends Component {
+  constructor () {
+    super(...arguments)
+    this.state = {
+      title: '首页',
+      list: [1, 2, 3]
+    }
+  }
+
+  componentWillMount () {}
+
+  componentDidMount () {}
+
+  componentWillUpdate (nextProps, nextState) {}
+
+  componentDidUpdate (prevProps, prevState) {}
+
+  shouldComponentUpdate (nextProps, nextState) {
+    return true
+  }
+
+  add = (e) => {
+    // dosth
+  }
+
+  render () {
+    return (
+      <View className='index'>
+        <View className='title'>{this.state.title}</View>
+        <View className='content'>
+          {this.state.list.map(item => {
+            return (
+              <View className='item'>{item}</View>
+            )
+          })}
+          <Button className='add' onClick={this.add}>添加</Button>
+        </View>
+      </View>
+    )
+  }
+}
+```
+
+> 由于微信小程序端的限制，有极少数 JSX 的优秀用法暂时不能得到很好地支持，同时，为了遵循 React 语法，Taro 在写法上也有一些自己的规范，具体可以参考：[Taro 开发最佳实践](best-practice.html) 。
+
+#### 快速开发微信小程序
+
+Taro 立足于微信小程序开发，众所周知小程序的开发体验并不是非常友好，比如小程序中无法使用 npm 来进行第三方库的管理，无法使用一些比较新的 ES 规范等等，针对小程序端的开发弊端，Taro 具有以下的优秀特性
+
+✅ 支持使用 npm/yarn 安装管理第三方依赖
+
+✅ 支持使用 ES7/ES8 甚至更新的 ES 规范，一切都可自行配置
+
+✅ 支持使用 CSS 预编译器，例如 Sass 等
+
+✅ 支持使用 Redux 进行状态管理
+
+✅ 支持使用 MobX 进行状态管理
+
+✅ 小程序 API 优化，异步 API Promise 化等等
+
+#### 支持多端开发转化
+
+Taro 方案的初心就是为了打造一个多端开发的解决方案。目前 Taro 代码可以支持转换到 **微信/百度/支付宝/字节跳动/QQ小程序** 、**快应用**、 **H5 端** 以及 **移动端（React Native）**。
+
+<div align="center"><img src="https://storage.360buyimg.com/taro-resource/platforms.jpg"/></div>
+
+## 社区共享
+
+[Taro 交流社区——让每一次交流都被沉淀](https://taro-club.jd.com/) 如果您在此文档没有找到想要的答案，请移步[社区](https://taro-club.jd.com)提问，我们会在看到的第一时间给予答复。
+
+[Taro 物料市场——让每一个轮子产生价值](https://taro-ext.jd.com/) 如果您想找一些现成的物料，例如：模版、组件、SDK、UI，可以移步[物料市场](https://taro-ext.jd.com/)查找，也欢迎您发布物料与其他开发者共享。
+
+## Taro UI
+
+一款基于 `Taro` 框架开发的多端 UI 组件库。
+
+[Taro UI](https://taro-ui.jd.com) 特性：
+
+- 基于 `Taro` 开发 UI 组件
+- 一套组件可以在 `微信小程序`，`支付宝小程序`，`百度小程序`，`H5` 多端适配运行（`ReactNative` 端暂不支持）
+- 提供友好的 API，可灵活的使用组件
+
+## 使用案例
+
+Taro 已经投入了我们的生产环境中使用，业界也在广泛地使用 Taro 开发多端应用。
+
+> 社区案例仅收纳了开发者主动提交的案例
+
+![image](https://raw.githubusercontent.com/NervJS/taro-user-cases/master/user-cases.jpg)
+
+## 学习资源
+
+### 官方文章精选
+- [使用 React Hooks 重构你的小程序](https://aotu.io/notes/2019/07/10/taro-hooks/)
+- [Taro 1.3 震撼发布：全面支持 JSX 语法和 HOOKS](https://aotu.io/notes/2019/06/13/taro-1-3/)
+- [小程序框架全面测评](https://aotu.io/notes/2019/03/12/mini-program-framework-full-review/)
+- [Taro 在京东购物小程序上的实践](https://aotu.io/notes/2018/09/11/taro-in-jd/)
+- [用 React 开发小程序的探索之路 （演讲内容整理）| 掘金开发者大会](https://juejin.im/post/5ba346a7f265da0ad13b78bd)
+- [为何我们要用 React 来写小程序 - Taro 诞生记](https://aotu.io/notes/2018/06/25/the-birth-of-taro/)
+- [多端统一开发框架 - Taro介绍](https://aotu.io/notes/2018/06/07/Taro/)
+
+### 分享交流
+- [第十三届 D2 前端技术论坛——使用 Taro 快速构建多端应用](https://www.yuque.com/d2forum/content/d213#6a1363f4)
+- [WeGeek直播课：从0到1快速开发电商小程序](https://link.juejin.im/?target=https%3A%2F%2Fcloud.tencent.com%2Fedu%2Flearning%2Flive-1497)
+- [掘金开发者大会——用React开发小程序的探索之路](https://www.itdks.com/Course/detail?id=16289)
+
+### 其他
+更多文章教程、开源项目等，请参考：[awesome-taro](https://github.com/NervJS/awesome-taro)
+
+掘金小册：[Taro 多端开发实现原理与实战](https://juejin.im/book/5b73a131f265da28065fb1cd?referrer=5ba228f16fb9a05d3251492d)
+
+## 开发交流
+扫码添加 `凹凸实验室-小助手` ，回复 `Taro` 即可进群。（Taro 开发交流15群 已满）
+
+![image](https://user-images.githubusercontent.com/9441951/63744620-7994e800-c8d2-11e9-9e66-ab43d1d75fe8.png)
diff --git a/website/versioned_docs/version-2.0.2/async-await.md b/website/versioned_docs/version-2.0.2/async-await.md
@@ -0,0 +1,43 @@
+---
+title: 异步编程
+id: version-2.0.2-async-await
+original_id: async-await
+---
+
+> Taro 2.x 版本中使用 `async-await` 不再需要 `@tarojs/async-await`。
+
+Taro 支持使用 `async functions` 来让开发者获得不错的异步编程体验，开启 `async functions` 支持需要安装包 `babel-plugin-transform-runtime` 和 `babel-runtime`。
+
+```bash
+$ yarn add babel-plugin-transform-runtime --dev
+$ yarn add babel-runtime
+```
+
+随后修改项目 [`babel` 配置](./config-detail.md#babel)，增加插件 `babel-plugin-transform-runtime`。
+
+```js
+babel: {
+  sourceMap: true,
+  presets: [
+    [
+      'env',
+      {
+        modules: false
+      }
+    ]
+  ],
+  plugins: [
+    'transform-decorators-legacy',
+    'transform-class-properties',
+    'transform-object-rest-spread',
+    ['transform-runtime', {
+      "helpers": false,
+      "polyfill": false,
+      "regenerator": true,
+      "moduleName": 'babel-runtime'
+    }]
+  ]
+}
+```
+
+> 值得注意的事，使用 `async functions` 一定要记得按照[开发前注意](./before-dev-remind.md)中提示的内容进行操作，否则会出现报错