74 lines
2.8 KiB
Markdown
74 lines
2.8 KiB
Markdown
# react-native-update [](http://badge.fury.io/js/react-native-update)
|
||
|
||
本组件是面向 React Native 提供热更新功能的组件，建议结合[Update 服务](https://update.reactnative.cn/)使用。
|
||
|
||
注意，在 iOS 上使用热更新有被拒的可能。可以按以下步骤屏蔽 iOS 端(`react-native-update`版本需 >= 5.3.2)：
|
||
|
||
1. 如果 RN 版本>=0.60，在项目根目录下编辑或创建 react-native.config.js，添加如下内容
|
||
|
||
```js
|
||
// react-native.config.js
|
||
module.exports = {
|
||
dependencies: {
|
||
'react-native-update': {
|
||
platforms: {
|
||
ios: null, // 阻止ios模块自动链接
|
||
},
|
||
},
|
||
},
|
||
};
|
||
```
|
||
|
||
2. 如果在原生代码端尚未配置，则跳过下面文档中的 ios 端的配置。如果已经配置，则按文档的步骤反向操作（添加的 ios 代码删去）。
|
||
3. 如果是 0.60 以上版本或使用了 cocoapods，在 ios 目录中再次运行 pod install，确保 Podfile 和 Podfile.lock 中都没有'react-native-update'。如果 RN 版本<0.60，则运行`react-native unlink react-native-update`。
|
||
4. 在 js 代码里调用 checkUpdate()方法前，判断 Platform.OS，如果是 ios 平台则直接 return 跳过。
|
||
|
||
### 最近更新
|
||
|
||
请查阅[最近更新文档](CHANGELOG.md)。
|
||
|
||
### 优势
|
||
|
||
1. 命令行工具&网页双端管理，版本发布过程简单便捷，完全可以集成 CI。
|
||
2. 基于 bsdiff 算法创建的**超小更新包**，通常版本迭代后在 1-10KB 之间，避免数百 KB 的流量消耗。
|
||
3. 支持崩溃回滚，安全可靠。
|
||
4. meta 信息及开放 API，提供更高扩展性。
|
||
5. 跨越多个版本进行更新时，只需要下载**一个更新包**，不需要逐版本依次更新。
|
||
|
||
### 安装与快速入门
|
||
|
||
请查阅
|
||
|
||
- [文档-快速入门-准备工作](docs/guide.md)。
|
||
|
||
- [文档-快速入门-添加热更新功能](docs/guide2.md)。
|
||
|
||
- [文档-快速入门-发布版本](docs/guide3.md)。
|
||
|
||
- [文档-常见问题与高级指南](docs/faq_advance.md)。
|
||
|
||
### 命令行工具
|
||
|
||
请查阅[文档-命令行工具](docs/cli.md)。
|
||
|
||
### API 接口
|
||
|
||
请查阅[文档-API 接口](docs/api.md)。
|
||
|
||
### 本地开发
|
||
|
||
```
|
||
$ git clone git@github.com:reactnativecn/react-native-pushy.git
|
||
$ cd react-native-pushy/Example/testHotUpdate
|
||
$ yarn
|
||
$ yarn start
|
||
```
|
||
|
||
本地库文件使用 yarn link 链接，因此可直接在源文件中修改，在 testHotUpdate 项目中调试。
|
||
|
||
### 关于我们
|
||
|
||
本组件由[React Native 中文网](https://reactnative.cn/)独家发布，如有定制需求可以[联系我们](https://reactnative.cn/about.html#content)。
|
||
|
||
关于此插件发现任何问题，可以前往[Issues](https://github.com/reactnativecn/react-native-pushy/issues)或者[中文社区](http://bbs.reactnative.cn/category/7)发帖提问。
|