情景:在Android原生应用中,将某些模块使用React Native实现,目的是为了快速的动态变更已发布内容(Android和iOS公用一套代码)。在我将React Native的版本从0.19.0升级到最新版或者大于0.20.1时,遇到的坑及解决办法与大家分享。
一、集成步骤陈述:
从将React Native集成到Android原生应用中开始聊起。
1、在Android项目的根目录新建一个名称为package.json的文件,package.json中的配置如下:
{
"name": "react-native-module","version": "0.0.1","private": true,"scripts": { "start": "node node_modules/react-native/local-cli/cli.js start" },"dependencies": { "react": "^15.1.0","react-native": "^0.27.2" } }
我们只需要关注下面这个节点:
"dependencies": {
"react": "^15.1.0","react-native": "^0.27.2"
}
react:版本号,react-native:版本号。
2、在android/app/build.gradle文件中,添加React Native依赖:
compile "com.facebook.react:react-native:+" // From node_modules
然后在android/build.gradle文件中(注意跟上面的路径不同)加入本地React Native的maven目录
allprojects {
repositories {
jcenter()
mavenLocal()
maven {
// All of React Native (JS,Obj-C sources,Android binaries) is installed from npm
url "$projectDir/../node_modules/react-native/android"
}
}
}
3、进入package.json这个文件所在目录,执行如下命令:
npm install
需要等待一段时间,最终你会在你Android项目的根目录下,发现多了一个名称为node_modules的文件夹(与package.json文件在同一级目录),node_modules的大小大概是200M左右。node_modules是我们在进行React Native应用或者模块开发时所依赖的库。
4、点击Android Studio工具栏的Gradle Sync 进行Build Project,之后到External Libraries下面找我们在build.gradle文件中所添加的依赖(compile “com.facebook.react:react-native:+”)执行的情况,我们会看到react-native-0.20.1这个依赖,这是什么鬼?我们明明指定的是”react-native”: “^0.27.2”,我们在External Libraries下面应该看到react-native-0.27.2才对呀,我以为是在android/app/build.gradle文件中添加的依赖有问题,于是修改依赖配置如下:
compile 'com.facebook.react:react-native:0.27.2'
Why?
二、对遇到问题的解决办法的探索:
导致这个问题的根本原因是:
1、我最初在我们项目中集成的是官方发布的0.19.0这个版本,之后每次升级只需要修改package.json中react和react-native的版本号,执行npm install ,进行Build Project,官方发布的最新版我就已经跟更新好了。(一直就这么开心的使用着,我是怎么发现自己好像更新不到最新版了呢?我为什要更新?)
2、在使用了RecyclerView嵌套的方式进行页面布局,我们发现被嵌套的子RecyclerView显示不出来。我们知道RecyclerView是v7扩展包中的组件,尝试升级v7的版本号,发现升级后采用RecyclerView嵌套的方式进行页面布局是OK的。但是我们正在使用的React Native所依赖的v7包版本号只能是23.0.1,若把v7的版本号修改成高于23.0.1的,build project报如下错误提示:
AndroidRuntime: FATAL EXCEPTION:AsyncTask#4
Process: package.name,PID: 23140
java.lang.RuntimeException: An error occurred while executing doInBackground()
at android.os.AsyncTask$3.done(AsyncTask.java:307)
at java.util.concurrent.FutureTask.finishCompletion(FutureTask.java:354)
at java.util.concurrent.FutureTask.setException(FutureTask.java:223)
at java.util.concurrent.FutureTask.run(FutureTask.java:242)
at android.os.AsyncTask$SerialExecutor$1.run(AsyncTask.java:234)
at java.util.concurrent.ThreadPoolExecutor.runWorker(ThreadPoolExecutor.java:1113)
at java.util.concurrent.ThreadPoolExecutor$Worker.run(ThreadPoolExecutor.java:588)
at java.lang.Thread.run(Thread.java:818)
Caused by: java.lang.IllegalAccessError: Method 'void android.support.v4.net.ConnectivityManagerCompat.<init>()' is inaccessible to class 'com.facebook.react.modules.netinfo.NetInfoModule' (declaration of 'com.facebook.react.modules.netinfo.NetInfoModule' appears in /data/app/package.name-2/base.apk)
at com.facebook.react.modules.netinfo.NetInfoModule.<init>(NetInfoModule.java:55)
at com.facebook.react.shell.MainReactPackage.createNativeModules(MainReactPackage.java:62)
at com.facebook.react.ReactInstanceManagerImpl.processPackage(ReactInstanceManagerImpl.java:751)
at com.facebook.react.ReactInstanceManagerImpl.createReactContext(ReactInstanceManagerImpl.java:688)
at com.facebook.react.ReactInstanceManagerImpl.access$600(ReactInstanceManagerImpl.java:84)
at com.facebook.react.ReactInstanceManagerImpl$ReactContextInitAsyncTask.doInBackground(ReactInstanceManagerImpl.java:177)
at com.facebook.react.ReactInstanceManagerImpl$ReactContextInitAsyncTask.doInBackground(ReactInstanceManagerImpl.java:162)
at android.os.AsyncTask$2.call(AsyncTask.java:295)
at java.util.concurrent.FutureTask.run(FutureTask.java:237)
at android.os.AsyncTask$SerialExecutor$1.run(AsyncTask.java:234)
at java.util.concurrent.ThreadPoolExecutor.runWorker(ThreadPoolExecutor.java:1113)
at java.util.concurrent.ThreadPoolExecutor$Worker.run(ThreadPoolExecutor.java:588)
at java.lang.Thread.run(Thread.java:818) ```
翻阅v7包中的源码,发现报找不到的方法在v7:23.0.1这个版本中访问权限是public的,在后面的升级版本中改为private。
3、在https://github.com/facebook/react-native上的issues中看到有人说升级React native的版本后,v7的版本号就可以升级到高于23.0.1,我就进行升级React native的版本,然后,然后呢就发现我不管怎么折腾,就是升级不到新的版本。
4、我们知道Android项目默认的依赖包的源jcenter(),打开网址https://bintray.com/bintray/jcenter/com.facebook.react:react-native/view,可以看到如下图:
发现jcenter()上并不包含最新版的React Native(官方只更新到0.20.1)。
我们要怎么才能使用官方发布的最新版或者高于0.20.1 的版本呢?(这个问题困扰了我很久)
1、简单粗暴的方法,直接从Github下载React Native的源码进行编译,让我们的项目依赖这个Libraries项目。这样确实可行,不过我发现在开发阶段,调试不了程序,因为本地启不了npm服务。你或许想到我们搞两份代码,一份依赖原来的低版本配置,开发阶段使用。生产环境直接依赖源码进行编译发布,有段时间我们确实是这么做的。直到有次,我在开发环境编写的代码运行正常,放到生产环境,程序运行直接崩溃,环境不一致导致的坑呀。
2、我跑到Github上去求助,发了一个issues ,发现老外都在友好的为我提供解决方案,倒是国内的React Native开发者,对我是鄙夷一片,各种鄙视,无语死了,这件事从此成了我心里的一个梗。
3、在公司项目目前这个版本接近尾声,我有时间了,又开始倒腾起这个问题。
尝试修改依赖源的地址,我添加了如下源:
maven { url 'https://registry.npm.taobao.org/react-native/' }
这个源是哪里来的?为什么是这个?这个源是我从node_modules里看到如下片段:
"_resolved": "https://registry.npm.taobao.org/react-native/download/react-native-0.27.2.tgz","_shasum": "303ab14423f5eb731fb753e373cdd3774347c12a","_shrinkwrap": null,"_spec": "react-native@^0.27.2",
这段配置在哪里?截图如下:
经测试这种方式不可行。
查阅官方的最新版文档,他们说新版的React Native都只在npm里发布。还记得我们在android/build.gradle文件中配置的如下本地依赖:
maven {
// All of React Native (JS,Android binaries) is installed from npm
url "$projectDir/../node_modules/react-native/android"
}
我们项目所依赖的react-native-v.jar应该是在本地的由npm所管理的node_modules里,我们到node_modules里找找看,果然找到了,截图如下:
4、解决办法,修改package.json中的配置如下:
allprojects {
repositories {
mavenLocal()
jcenter()
maven {
// All of React Native (JS,Android binaries) is installed from npm
url "$projectDir/../node_modules/react-native/android"
}
}
}
仔细对比,会发现和原来的(0.19.0时的配置)差别只是调换了mavenLocal()和jcenter()的顺序,经验证这样就可以依赖到最新版的。
把jcenter()放在前面,表示每次获取依赖库,会优先在jcenter()上找,有就直接使用,这也就解释了之前我们为什么依赖不到本地的最新版。
注:在react native 0.19.0这个版本中,package.json中的配置jcenter()是在前面。