react-native版本迁移教程

如果在学习react-native的过程中遇到什么问题,欢迎加入QQ群397885169一起学习,一起成长。

识兔已经更新到0.57了哦,欢迎star

识兔,一款用来识别图片的开源项目,在未来还会添加更多有意思的东西

welfare.gif

前言

react-native在三天前,也就是2018.9.12号更新了0.57.0版本,这个版本终于正常的兼容了babel7,解决了0.56版本使用mobx等装饰器需要各种配置的问题。

主要更新(合并0.56版本和0.57版本重要的修复)

  • TextInput不能输入中文的问题

  • TextInput.clear()TextInput.setNativeProps({text: ''})不能正常使用的问题

  • 更新iOS最低兼容到iOS9

  • WebView添加WKWebView,通过useWebKit={true}开启

  • 为安卓添加overflow

  • 为安卓Image添加默认占位图defaultSource,但是在debug下是看不到的,只有在release中才能看到

  • 安卓现在TextInputunderlineColorAndroid默认为透明(终于不用手动更改了)

  • 打开Modal可以覆盖状态栏层?

  • 修复Modal+ FlatList滚动

  • 导出FlatListSectionList的动画,
    现在支持Animated的组件包括了ViewTextImageScrollViewFlatListSectionList

以上是0.560.57版本,我整理的主要更新,更详细的更新日志,请参考官方日志。

项目升级

升级

开发react-native经常会遇到升级新版本,官方提供了命令行的升级方式,我管这种叫做升级,这种方式的好处就是傻瓜式,执行命令行就可以自动升级版本了,但这个方式的缺陷也很明显,如果升级中出现问题,很难排查错误。所以,我更推荐第二种方式。

迁移

迁移:顾名思义,搬迁移动,流程就是,新建个项目,把原有项目中的更改,慢慢搬家,搬到新的项目中,这样的坏处很明显,很慢,才做过程中,可能会有遗忘,但是这样方式,更方便管理,流程出现错误,只要对着原项目更改就可以了,更可控。

0.57版本迁移教程

未使用装饰器

如果你的项目中,没有用到Mobx,这种需要es6装饰器语法支持的三方库或者方法,那么恭喜你,只要你完整的迁移项目就可以了,除了YellowBox会给你造成一点麻烦外,基本不会遇到其他问题的,如果真的遇到问题啦,欢迎加群,咱们一起讨论解决办法。

使用装饰器

如果你的项目使用了装饰器,那么也要恭喜你,顺利的度过了0.56版本的那个深坑,在0.57版本中,要修改的东西相对于0.56少了很多。

接下来,就说明下操作步骤。

  • 首先,需要安装下面的4个babel库,因为从0.56版本开始,react-native默认支持bable7,之前的写法都不对了。

package.json

@babel/core
@babel/plugin-proposal-decorators
@babel/plugin-transform-runtime
@babel/runtime
  • 其次,要修改babelrc文件,更新几个参数就好。.文件在mac上是默认隐藏的,所以,你可能需要打开IDE,不管是webstrom还是vscode都可以。

  • 完成下面这步就可以正常的使用装饰器啦!但是最后一步才是最重要的!

.babelrc

{
  "presets": ["module:metro-react-native-babel-preset"],
  "plugins": [
    ["@babel/plugin-proposal-decorators", { "legacy": true }],
    ["@babel/transform-runtime", {
      "helpers": true,
      "regenerator": false
    }]
  ]
}
  • 修复App入口文件,默认是index.js。这也是个bug,如果不添加如下代码,会导致release包无法正常运行。详细信息可以参考这个issues,解决办法comment
import applyDecoratedDescriptor from '@babel/runtime/helpers/esm/applyDecoratedDescriptor';

import initializerDefineProperty from '@babel/runtime/helpers/esm/initializerDefineProperty';

Object.assign(babelHelpers, { applyDecoratedDescriptor, initializerDefineProperty });

const App = require('./app/index').default;

AppRegistry.registerComponent(appName, () => App);

小技巧

新版本中,对YellowBox做了增强,项目中有各种问题都会暴露出来,可以使用YellowBox.ignoreWarnings(['Require cycle:'])关闭一波。

iOS升级可能遇到的问题

1. 缺少libfishhook.a文件

error: Build input file cannot be found: '/Users/Rabbit/Desktop/DouXi/node_modules/react-native/Libraries/WebSocket/libfishhook.a'

找不到libfishhook.a,如果经常开发,可能知道要手动添加,但是手动添加到主目录是没用的,要参考下两图哦!

react-native版本迁移教程_第1张图片
修复错误1.jpg

react-native版本迁移教程_第2张图片
修复错误2.png

这里参考了这篇文章

2. 'config.h' file not found

老生常谈的问题,缺少third-party文件(如果不知道是什么,请点击该链接),但很多人手动添加并且重启后还是不行,这是少执行了一个sh脚本。

cd node_modules/react-native/third-party/glog-0.3.4
../../scripts/ios-configure-glog.sh

可能有些开发者的本地glog版本不是0.3.4,所以,这里要对应你本地的版本才可以

查看glog本地版本的方法
cd ./rncache
open .

这个问题是XCode10导致的,每次编译项目都要执行上面的代码太过于麻烦,所以,可以把上面的代码写到package.json中,如下

...
"scripts": {
    "start": "node node_modules/react-native/local-cli/cli.js start",
    "build": "cd node_modules/react-native/third-party/glog-0.3.5/ && ../../scripts/ios-configure-glog.sh",
    "test": "jest"
  },
...

3. 如下图,缺少@runtime

react-native版本迁移教程_第3张图片
9EE9A1A0192EF593DE4ED99D7E2EC795.jpg

解决办法就是安装下咯。
yarn add @babel/runtime 或者 npm install @babel/runtime

总结

0.57是个很棒的版本,之后会疯狂安利,react-native也在重构,真心希望可以解决现在存在的各种痛点。

如果在学习react-native的过程中遇到什么问题,欢迎加入QQ群397885169一起学习,一起成长。

我开源的项目识兔在昨天完成0.57版本的更新,欢迎star哦!

你可能感兴趣的:(react-native版本迁移教程)