Merge remote-tracking branch 'upstream/master'

* upstream/master: bump fix DatePicker styles prop covering the context styles of WithTheme (ant-design#566) chore(deps-dev): bump eslint from 4.3.0 to 4.18.2 Modal动画销毁前停止动画 (ant-design#554) fixes ant-design#536 bump 修改文档使用expo sdk32以上版本时出现的问题 (ant-design#535) SegmentedControl comonent selected segment text bug in android (ant-design#520) bump refactor: toast allow fullscreen fixes ant-design#434 bump feat: checkbox read color from theme fixes ant-design#416 bump fix ant-design#412 and picker demo (ant-design#459) doc: remove qrcode fix: demo of picker bump use call fn to invoke scollView's scrollTo (ant-design#408) fix: ant-design#403 bump fix: swipeable not work with android fixes: ant-design#380 feat: 为Card组件的HeaderContent和HeaderExtra添加Wrap style，便于定制 fixes ant-design#395 fix: demo of picker feat: add demo-data pkg fix: demo fix: link of date-picker close ant-design#379 fix: demo of picker chore: add support chore: add ga bump fix: ant-design#344 fix: add babel-runtime fixes ant-design#346 ant-design#309 bump fix: spread SwipeAction rest props (ant-design#318) bump feat(popover): add placement prop fixes ant-design#308 bump fix: popover on android refactor: popover fixes ant-design#285 (ant-design#298) update snap fix: input-item style ant-design#279 bump fix: tabbar not updated fixes ant-design#201 test: update snap fix: demo fix: groupTypes is not supported on Android fixes ant-design#264 bump doc: changelog test: update snaps fix: make InputItem clear icon behave properly in Android close ant-design#248 fix: ant-design#249 refactor: input height fixes ant-design#249 fix search-bar icon size (ant-design#250) bump doc: changelog of 3.0.4 fix: remove react native require cycle warning close ant-design#236 fixes ant-design#233 fix SwipeAction props type defination about left and right (ant-design#230) Segmented control tintcolor (ant-design#211) 修改SegmentedControl默认颜色为主题颜色 doc: fixes ant-design#164 fix: tabBarUnderlineStyle fixes ant-design#174 3.0.3 feat: tabs title support custom React.Element fix ListView loadmore issue with paginationAllLoadedView feat: tabs add renderUnderline add renderTab prop-type of tabs. site: add doc about list-view 3.0.2 site: toast doc test: update snap feat: add Locale definition fix: typescript errors site: provider typo fix: typo fix: typo site: docs site: notes site: 2.x doc: expo site: update notes feat: add dynamic theme example fix: Modal static property has type of any fix: alert's content can be a view element 3.0.1 remove: resolutions fix: scripts site: example site: notes doc: changelog chore: remove unused package 3.0.0 site: list-view fix: jest 3.0.0-17 site: fix examples fix: miss mock file chore: jest site: tab-bar 3.0.0-16 fix: tests feat: add safe area view for tab-bar refactor: tab-bar support custom icon close ant-design#158 chore: code style fix: picker value type always string close ant-design#68 feat: add textAreaRef close ant-design#141 feat: ImagePicker performance enhancement close ant-design#45 fix: type definition feat: add cameraPickerProps close ant-design#94 feat: add locale update snap feat: add list-view fix: incorrect container width close ant-design#162 fix: button with activeStyle fix: Portal imports feat: exports Portal fix: ImagePicker example fix: type definition fix: renderUnderline close ant-design#96 3.0.0-15 chore: ignore demos 3.0.0-14 feat: support item style close ant-design#54 chore: update snap feat: support use12hours close ant-design#151 fix: item style refactor: remove unused props chore: code style chore: add demo for picker fix: picker on android close ant-design#117 refactor: picker fix: allow overwrite activeOpacity close ant-design#133 feat: add renderIcon for steps close ant-design#136 fix: tabs position fix: add disabled property close ant-design#149 fix: locale example fix: modal and toast examples site: icon site: add example site: add icon fonts doc: update examples 3.0.0-13 fix: tabs onChange on android fix: notice-bar tests fix: search-bar tests fix: button tests fix: tag tests chore: decrease duration fix: notice-bar icon feat: partial Theme chore: update snap fix: demo chore: export provider 3.0.0-7 chore: update deps test: update snap feat: exports Portal refactor: locale-provider refactor: picker ant-design#154 refactor: date-picker ant-design#154 refactor: tabs ant-design#154 refactor: list modal notice-bar pagination ant-design#154 refactor: input item ant-design#154 chore: add privacy for camera picker refactor: image-picker close ant-design#42 fix: example refactor: grid icon ant-design#154 refactor: styles ant-design#154 refactor: segmented-control ant-design#154 refactor: slider ant-design#154 refactor: stepper fix: miss refactor: steps ant-design#154 refactor: tab-bar ant-design#154 refactor: styles ant-design#154 test: update snap refactor: checkbox ant-design#154 refactor: carousel ant-design#154 test: button test: update snap refactor: card ant-design#154 refactor: badge ant-design#154 refactor: activity-indicator ant-design#154 refactor: action-sheet ant-design#154 refactor: accordion ant-design#154 refactor(button): use theme context chore: site chore: include vscode configurations test: update snap 3.0.0-6 chore: update icon style: full screen button feat: add sandbox refactor(modal): use portal close ant-design#79 refactor(swipe-action): use react-native-swipeout directly doc: support me please fix: initialPage not work correctly on android side close ant-design#50 refactor: tabs fix: typo fix: optional styles prop close ant-design#30 fix: ts type close ant-design#80 fix: app crashes when message is empty close ant-design#99 test: update snap feat: performance improvements close ant-design#128 refactor: remove top-view instead of portal refactor: remove images fix: font size refactor: radio ant-design#140 chore: clean images ant-design#140 tests: update snap refactor: toast ant-design#140 refactor: replace image with icon ant-design#140 chore: clean refactor: tabs chore: hooks refactor(icon): use @ant-design/icons-react-native ant-design#140 fix: lint feat: exports props wip fix: tests chore: use locale feat: give react hooks a try fix: fonts on android feat: add fonts feat: portal fix components docs
GrigoryPtashko · Jul 23, 2019 · e2bfed9 · e2bfed9
2 parents 33c762e + f42449a
commit e2bfed9
Show file tree

Hide file tree

Showing 454 changed files with 52,934 additions and 8,160 deletions.
diff --git a/.github/ISSUE_TEMPLATE.md b/.github/ISSUE_TEMPLATE.md
@@ -11,5 +11,5 @@ If your issue was not created using the app above, it will be closed immediately
 
   http://new-issue.ant.design?repo=ant-design-mobile-rn
 
-不是用上面的链接创建的 issue 会被立即关闭。
+不使用上面的链接创建的 issue 会被立即关闭。
 -->
diff --git a/.gitignore b/.gitignore
@@ -40,10 +40,10 @@ xcuserdata
 components/**/*.jsx
 components/**/*.js
 my-release-key.keystore
-.vscode
 # yarn.lock
 npm-debug.log*
 !components/**/__tests__/*.js
+!components/**/__mocks__/*.js
 coverage
 /es/
 package-lock.json

diff --git a/.jest.config.js b/.jest.config.js
@@ -1,21 +1,17 @@
 const libDir = process.env.LIB_DIR;
-const { defaults: tsjPreset } = require('ts-jest/presets');
+const {defaults: tsjPreset} = require('ts-jest/presets');
 
 const transformPackages = [
-  'react-native',
-  'react-native-menu',
-  'react-native-tab-view',
-  'react-native-collapsible',
-  'react-native-swipeout',
-  'react-native-camera-roll-picker',
+  'react-native', 'react-native-modal-popover', 'react-native-tab-view',
+  'react-native-collapsible', 'react-native-swipeout',
+  'react-native-camera-roll-picker', '@bang88/react-native-ultimate-listview',
+  'react-native-safe-area-view'
 ]
 
 module.exports = {
   // ...tsjPreset,
   preset: 'react-native',
-  setupFiles: [
-    './tests/setup.js'
-  ],
+  setupFiles: ['./tests/setup.js'],
   moduleFileExtensions: [
     'ts',
     'tsx',
@@ -33,8 +29,8 @@ module.exports = {
     ...tsjPreset.transform,
     // '\\.tsx?$': './node_modules/antd-tools/lib/jest/codePreprocessor',
     // '\\.js$': './node_modules/antd-tools/lib/jest/codePreprocessor',
-    "^.+\\.js$": "<rootDir>/node_modules/react-native/jest/preprocessor.js",
-    "\\.png": '<rootDir>/tests/imageStub.js',
+    '^.+\\.js$': '<rootDir>/node_modules/react-native/jest/preprocessor.js',
+    '\\.png': '<rootDir>/tests/imageStub.js',
   },
   testRegex: libDir === 'dist' ? 'demo\\.test\\.js$' : '.*\\.test\\.js$',
   collectCoverageFrom: [
@@ -48,7 +44,7 @@ module.exports = {
   globals: {
     'ts-jest': {
       babelConfig: true,
-      tsConfig: "tsconfig.test.json",
+      tsConfig: 'tsconfig.test.json',
     }
   }
 };
diff --git a/.npmignore b/.npmignore
@@ -1 +1,2 @@
 lib/**/demo/*.*
+es/**/demo/*.*
diff --git a/.vscode/settings.json b/.vscode/settings.json
@@ -0,0 +1,8 @@
+{
+  "tslint.configFile": "node_modules/antd-tools/lib/tslint.json",
+  "tslint.autoFixOnSave": true,
+  "eslint.autoFixOnSave": true,
+  "editor.codeActionsOnSave": {
+    "source.organizeImports": true
+  }
+}
diff --git a/CHANGELOG.en-US.md b/CHANGELOG.en-US.md
@@ -8,12 +8,97 @@ toc: false
 
 #### Release Schedule
 
-* Weekly release: patch version at the end of every week for routine bugfix (anytime for urgent bugfix).
-* Monthly release: minor version at the end of every month for new features.
-* Major version release is not included in this schedule for breadking change and new features.
+- Weekly release: patch version at the end of every week for routine bugfix (anytime for urgent bugfix).
+- Monthly release: minor version at the end of every month for new features.
+- Major version release is not included in this schedule for breadking change and new features.
 
 ---
 
+### 3.1.7
+
+`2019-04-30`
+
+- Fixes `checkbox` read color from theme [#416](https://github.com/ant-design/ant-design-mobile-rn/issues/416)
+
+### 3.1.5
+
+`2019-03-20`
+
+- Fixed `tabs` type error under react-native@0.59.1 [#403](https://github.com/ant-design/ant-design-mobile-rn/issues/403) by [bestv2](https://github.com/bestv2)
+
+### 3.1.4
+
+`2019-03-15`
+
+- Fixed `tabs` swipeable does not work under Android [#380](https://github.com/ant-design/ant-design-mobile-rn/issues/380)
+- Add Wrap style for `HeaderContent` and `HeaderExtra` of the `card` component for easy customization [#395](https://github.com/ant-design/ant-design-mobile-rn/issues/395) By [christtrc](https://github.com/ant-design/ant-design-mobile-rn/commits?author=christtrc)
+
+### 3.1.3
+
+`2019-02-19`
+
+- Fixes `babel-runtime/helpers/extends` not found after using `babel-plugin-import` [#346](https://github.com/ant-design/ant-design-mobile-rn/issues/346)
+- Fixes `drawer` component of `ios`. When returning, there will be a short stay on the page [#344](https://github.com/ant-design/ant-design-mobile-rn/issues/344)
+
+### 3.1.1
+
+`2019-01-30`
+
+Happy Chinese New Year
+
+- `popover` adds the `placement` property to support configuration of different positions `'top | right | bottom | left | auto'` [#308](https://github.com/ant-design/ant-design-mobile-rn/issues/308)
+
+### 3.1.0
+
+`2019-01-27`
+
+- Refactor `popover` [#298](https://github.com/ant-design/ant-design-mobile-rn/pull/298)
+  - Removed the (`overlayStyle` `contextStyle` `name` `openMenu / closeMenu / toggleMenu` `style` ) property. The refactored version supports multiple Popovers.
+  - Please see the popover example for how to use it.
+- Fix `input-item` style should not be applied to outer container [#279](https://github.com/ant-design/ant-design-mobile-rn/issues/279)
+
+### 3.0.6
+
+`2019-01-15`
+
+- Fixes `image-picker` `groupTypes` is not supported on Android [#264](https://github.com/ant-design/ant-design-mobile-rn/issues/264)
+- Fixes `tab-bar` does not update component after tab has changed [#201](https://github.com/ant-design/ant-design-mobile-rn/issues/201)
+
+### 3.0.5
+
+`2019-01-03`
+
+- Modify `search-bar` icon size [#250](https://github.com/ant-design/ant-design-mobile-rn/pull/250)
+- Fixes `input-item` has new line after blur under `ios` [#249](https://github.com/ant-design/ant-design-mobile-rn/issues/249)
+- Fixes `input-item` clear icon is not displayed correctly under `android` [#248](https://github.com/ant-design/ant-design-mobile-rn/issues/248)
+
+### 3.0.4
+
+`2018-12-28`
+
+- Modify `SegmentedControl` default color to theme color [#211](https://github.com/ant-design/ant-design-mobile-rn/pull/211)
+- Allow overriding `Tabs` `tabBarUnderlineStyle`
+- Improve `SwipeAction` TypeScript type definition [#230](https://github.com/ant-design/ant-design-mobile-rn/pull/230)
+- Improve the `Grid` document and modify the `onClick` property to `onPress` [#234](https://github.com/ant-design/ant-design-mobile-rn/pull/234)
+- Fixed `Modal` circular reference warning [#242](https://github.com/ant-design/ant-design-mobile-rn/pull/242)
+
+### 3.0.0
+
+`2018-12-15`
+
+**Breaking Changes** for more informations please checkout [#119](https://github.com/ant-design/ant-design-mobile-rn/issues/119)
+
+- We get a new package name `@ant-design/react-native` from [afc163](https://github.com/afc163). Thanks..
+- Remove the native suffix
+- More friendly theme support
+- Improve TypeScript type definitions
+- Bug fixes
+- We can preview our Components online using codesandbox and react-native-web
+- Refactor Icon Component and use [ant-design-icons](https://github.com/ant-design/ant-design-icons/tree/master/packages/icons-react-native) instead
+- `Toast` has removed method `hide`
+- Change `Grid` property `onClick` to `onPress`
+- Upgrade from 2.x to 3.0.0 please checkout [upgrade notes](https://rn.mobile.ant.design/docs/react/upgrade-notes)
+
 ### 2.3.0
 
 `2018-10-20`

diff --git a/CHANGELOG.zh-CN.md b/CHANGELOG.zh-CN.md
@@ -8,12 +8,100 @@ toc: false
 
 #### 发布周期
 
-* 修订版本号：每周末会进行日常 bugfix 更新。（如果有紧急的 bugfix，则任何时候都可发布）
-* 次版本号：每月发布一个带有新特性的向下兼容的版本。
-* 主版本号：含有破坏性更新和新特性，不在发布周期内。
+- 修订版本号：每周末会进行日常 bugfix 更新。（如果有紧急的 bugfix，则任何时候都可发布）
+- 次版本号：每月发布一个带有新特性的向下兼容的版本。
+- 主版本号：含有破坏性更新和新特性，不在发布周期内。
 
 ---
 
+### 3.1.7
+
+`2019-04-30`
+
+- 修复 `checkbox` 没有从主题里面读取变量 [#416](https://github.com/ant-design/ant-design-mobile-rn/issues/416)
+
+### 3.1.5
+
+`2019-03-20`
+
+- 修复 `tabs` 在 react-native@0.59.1 下报错 [#403](https://github.com/ant-design/ant-design-mobile-rn/issues/403) by [bestv2](https://github.com/bestv2)
+
+### 3.1.4
+
+`2019-03-15`
+
+- 修复 `tabs` swipeable 在 Android 下面不起作用 [#380](https://github.com/ant-design/ant-design-mobile-rn/issues/380)
+- 为 `card` 组件的 `HeaderContent` 和 `HeaderExtra` 添加 Wrap style，便于定制 [#395](https://github.com/ant-design/ant-design-mobile-rn/issues/395) By [christtrc](https://github.com/ant-design/ant-design-mobile-rn/commits?author=christtrc)
+
+### 3.1.3
+
+`2019-02-19`
+
+- 修复使用 `babel-plugin-import`后找不到`babel-runtime/helpers/extends` [#346](https://github.com/ant-design/ant-design-mobile-rn/issues/346)
+- 修复`ios` 端的 `drawer` 组件，当返回的时候，会有短暂的停留在页面上 [#344](https://github.com/ant-design/ant-design-mobile-rn/issues/344)
+
+### 3.1.1
+
+`2019-01-30`
+
+新春快乐 🐷 年吉祥
+
+- `popover` 新增 `placement` 属性，支持配置不同位置 'top | right | bottom | left | auto' [#308](https://github.com/ant-design/ant-design-mobile-rn/issues/308)
+
+### 3.1.0
+
+`2019-01-27`
+
+- 重构`popover` [#298](https://github.com/ant-design/ant-design-mobile-rn/pull/298)
+  - 删除了(`overlayStyle` `contextStyle` `name` `openMenu / closeMenu / toggleMenu` `style` )属性，重构后的版本支持多个 Popover 同时使用
+  - 使用方式请查看 popover 示例
+- 修复`input-item` style 不应该应用于外层 container [#279](https://github.com/ant-design/ant-design-mobile-rn/issues/279)
+
+### 3.0.6
+
+`2019-01-15`
+
+- 修复`image-picker` 报错 `groupTypes` is not supported on Android [#264](https://github.com/ant-design/ant-design-mobile-rn/issues/264)
+- 修复`tab-bar` 不会更新 tab 内容 [#201](https://github.com/ant-design/ant-design-mobile-rn/issues/201)
+
+### 3.0.5
+
+`2019-01-03`
+
+- 修改`search-bar` icon size [#250](https://github.com/ant-design/ant-design-mobile-rn/pull/250)
+- 修复`input-item` 在`iOS`下换行显示 [#249](https://github.com/ant-design/ant-design-mobile-rn/issues/249)
+- 修复`input-item` clear icon 在`android`下显示不正确 [#248](https://github.com/ant-design/ant-design-mobile-rn/issues/248)
+
+### 3.0.4
+
+`2018-12-28`
+
+- 修改`SegmentedControl`默认颜色为主题颜色 [#211](https://github.com/ant-design/ant-design-mobile-rn/pull/211)
+- 允许覆盖`Tabs` `tabBarUnderlineStyle`
+- 完善`SwipeAction` TypeScript 类型定义 [#230](https://github.com/ant-design/ant-design-mobile-rn/pull/230)
+- 完善 `Grid` 文档，修改`onClick`属性为`onPress` [#234](https://github.com/ant-design/ant-design-mobile-rn/pull/234)
+- 修复`Modal`循环引用警告 [#242](https://github.com/ant-design/ant-design-mobile-rn/pull/242)
+
+### 3.0.0
+
+`2018-12-15`
+
+**不兼容更新** 更多信息请查看 [#119](https://github.com/ant-design/ant-design-mobile-rn/issues/119)
+
+- 全新的包名 `@ant-design/react-native` 谢谢 [afc163](https://github.com/afc163) 提供
+- 组件文件重命名，去掉了之前的`.native`后缀
+- 更友好的主题支持，方便用户自定义，全新的 `Provider`
+- 重构了所有组件支持自定义局部样式
+- 完善 TypeScript 类型定义
+- Toast 现在支持在 Modal 之上显示
+- bug 修复
+- 完善文档，使用 codesandbox 以及 react-native-web 提供部分组件在线预览
+- 重构 Icon 组件，现在使用 [ant-design-icons](https://github.com/ant-design/ant-design-icons/tree/master/packages/icons-react-native)
+- Toast 移除了 `hide` 方法
+- 修改`Grid`的`onClick`属性为`onPress`
+- 更多组件优化以及使用方式请查看文档
+- 从 2.x 升级到 3.0.0 请查看[upgrade notes](https://rn.mobile.ant.design/docs/react/upgrade-notes-cn)
+
 ### 2.3.0
 
 `2018-10-20`

diff --git a/README.md b/README.md
@@ -7,12 +7,13 @@ English | [简体中文](./README.zh-CN.md)
 </p>
 
 # Ant Design Mobile RN
+
 [![](https://img.shields.io/travis/ant-design/ant-design-mobile-rn.svg?style=flat-square)](https://travis-ci.org/ant-design/ant-design-mobile-rn)
 [![Codecov](https://img.shields.io/codecov/c/github/ant-design/ant-design-mobile-rn.svg?style=flat-square)](https://codecov.io/gh/ant-design/ant-design-mobile-rn)
 [![npm package](https://img.shields.io/npm/v/@ant-design/react-native.svg?style=flat-square)](https://www.npmjs.org/package/@ant-design/react-native)
 [![NPM downloads](http://img.shields.io/npm/dm/@ant-design/react-native.svg?style=flat-square)](https://npmjs.org/package/@ant-design/react-native)
 [![Dependency Status](https://david-dm.org/ant-design/ant-design-mobile-rn.svg?style=flat-square)](https://david-dm.org/ant-design/ant-design-mobile-rn)
-[![Percentage of issues still open](http://isitmaintained.com/badge/open/ant-design/ant-design-mobile-rn.svg)](http://isitmaintained.com/project/ant-design/ant-design-mobile-rn "Percentage of issues still open")
+[![Percentage of issues still open](http://isitmaintained.com/badge/open/ant-design/ant-design-mobile-rn.svg)](http://isitmaintained.com/project/ant-design/ant-design-mobile-rn 'Percentage of issues still open')
 [![Join the chat at https://gitter.im/ant-design/ant-design](https://img.shields.io/gitter/room/ant-design/ant-design.svg?style=flat-square)](https://gitter.im/ant-design/ant-design?utm_source=badge&utm_medium=badge&utm_campaign=pr-badge&utm_content=badge)
 
 A configurable Mobile UI specification and React-based implementation.
@@ -21,9 +22,13 @@ A configurable Mobile UI specification and React-based implementation.
 
 ~~Thank you all for trusting us and using antd-mobile-rn. Due to limited application secnarios and development resouces, we regret to annouce antd-mobile-rn will not be officially mainained and updated. If anyone in the community is interested to continue to maintain this project, please contact us in private.~~
 
-We(Community) will continue maintain this project. If you found a bug you can file an issue directly and `PR` are always welcome.
+If you found a bug you can file an issue directly and `PR` are always welcome.
+
+By the way. you can support this project via Star star sta st s... ⭐️ ⭐️ ⭐️ ⭐️ ⭐️.
 
-Discussion: [The new plan](https://github.com/ant-design/ant-design-mobile-rn/issues/119)
+~~Discussion: [The new plan](https://github.com/ant-design/ant-design-mobile-rn/issues/119)~~
+
+The new version `3.x` has been released, please see the installation upgrade guide.[Changelog](https://rn.mobile.ant.design/changelog)
 
 ## Features
 
@@ -34,12 +39,28 @@ Discussion: [The new plan](https://github.com/ant-design/ant-design-mobile-rn/is
 
 ## Demo
 
-<img width="250" src="https://user-images.githubusercontent.com/1698185/27175806-f0a8a7f0-51f2-11e7-85fb-4b7ea9f89e5b.png" />
+<img width="250" src="https://user-images.githubusercontent.com/433259/50051494-1c934080-014e-11e9-82b2-b18c6b727443.png" />
 
 install expo app: https://expo.io/tools
 
 ## Install & Usage
 
+```bash
+$ npm install @ant-design/react-native --save
+```
+
+or
+
+```bash
+yarn add @ant-design/react-native
+```
+
+### Link icon fonts
+
+```bash
+react-native link @ant-design/icons-react-native
+```
+
 [introduce](docs/react/introduce.en-US.md#安装)
 
 ## Links

diff --git a/README.zh-CN.md b/README.zh-CN.md
@@ -7,25 +7,27 @@
 </p>
 
 # Ant Design Mobile RN
+
 [![](https://img.shields.io/travis/ant-design/ant-design-mobile-rn.svg?style=flat-square)](https://travis-ci.org/ant-design/ant-design-mobile-rn)
 [![Codecov](https://img.shields.io/codecov/c/github/ant-design/ant-design-mobile-rn.svg?style=flat-square)](https://codecov.io/gh/ant-design/ant-design-mobile-rn)
 [![npm package](https://img.shields.io/npm/v/@ant-design/react-native.svg?style=flat-square)](https://www.npmjs.org/package/@ant-design/react-native)
 [![NPM downloads](http://img.shields.io/npm/dm/@ant-design/react-native.svg?style=flat-square)](https://npmjs.org/package/@ant-design/react-native)
 [![Dependency Status](https://david-dm.org/ant-design/ant-design-mobile-rn.svg?style=flat-square)](https://david-dm.org/ant-design/ant-design-mobile-rn)
-[![Percentage of issues still open](http://isitmaintained.com/badge/open/ant-design/ant-design-mobile-rn.svg)](http://isitmaintained.com/project/ant-design/ant-design-mobile-rn "Percentage of issues still open")
+[![Percentage of issues still open](http://isitmaintained.com/badge/open/ant-design/ant-design-mobile-rn.svg)](http://isitmaintained.com/project/ant-design/ant-design-mobile-rn 'Percentage of issues still open')
 [![Join the chat at https://gitter.im/ant-design/ant-design](https://img.shields.io/gitter/room/ant-design/ant-design.svg?style=flat-square)](https://gitter.im/ant-design/ant-design?utm_source=badge&utm_medium=badge&utm_campaign=pr-badge&utm_content=badge)
 
 Ant Design 移动端设计规范。`@ant-design/react-native` 是 Ant Design 的移动规范的 React 实现，服务于蚂蚁及口碑无线业务。
 
 ## 通知
 
-~~首先，很感谢信任我们，使用`antd-mobile-rn`。但由于RN目前应用场景比较少以及精力所限，`antd-mobile-rn`仓库不再更新、维护。
+~~首先，很感谢信任我们，使用`antd-mobile-rn`。但由于 RN 目前应用场景比较少以及精力所限，`antd-mobile-rn`仓库不再更新、维护。
 如果社区中有人有意愿维护，可以私信我们。~~
 
-现在由社区维护，我们都是利用空闲时间维护该项目，所以在提交`issues`的时候请描述清楚，如果已经知道问题所在也可以直接提`PR`，添加相应测试如果测试通过会尽快发布一个新版本。
+在提交`issues`的时候请描述清楚，如果已经知道问题所在也可以直接提`PR`，添加相应测试如果测试通过会尽快发布一个新版本。
 
+~~欢迎讨论: [新版计划](https://github.com/ant-design/ant-design-mobile-rn/issues/119)~~
 
-欢迎讨论: [新版计划](https://github.com/ant-design/ant-design-mobile-rn/issues/119)
+新版本`3.x`已经重构完成并发布，安装升级请查看 [更新日志](https://rn.mobile.ant.design/changelog-cn)
 
 ## 特性
 
@@ -42,6 +44,22 @@ Ant Design 移动端设计规范。`@ant-design/react-native` 是 Ant Design 的
 
 ## 安装 & 使用
 
+```bash
+npm install @ant-design/react-native --save
+```
+
+or
+
+```bash
+yarn add @ant-design/react-native
+```
+
+### 链接字体图标
+
+```bash
+react-native link @ant-design/icons-react-native
+```
+
 [介绍](docs/react/introduce.zh-CN.md#安装)
 
 ## 链接