React Native For Android の 修改React Native为本地依赖

@author ASCE1885的 Github 简书 微博 CSDN
本文由于潜在的商业目的,不开放全文转载许可,谢谢!

公司的网络可能由于防火墙等原因,使用Gradle在线依赖去下载React Native(以下简称RN)的aar包可能一天都下载不下来,而在使用家中的Wi-Fi就几分钟的事😓,当然目前还没法实现家中办公,而且如果让团队内其他同事也都每次等一天才下载下来,效率将是极其低下的。因此,只能将RN的aar包下载下来,并设置为本地依赖模式,同时引入RN依赖的第三方开源库。

我们先来看看默认的在线依赖RN的方式:

compile 'com.facebook.react:react-native:0.14.+'

下载react-native.aar

RN的aar包托管在Bintray上面,因此,我们可以自己将其下载下来,从而将在线依赖+下载 改为 手动下载+本地依赖。打开bintray搜索react-native,可以查找到React Native的官方Bintray网址,在这个主页中,可以看到RN的一系列版本,最新的是0.15.1:

点击某个版本,进入特定的版本页面,选择Files标签,可以看到如下图所示的文件列表,在这个表中可以选择我们所需要的react-native-0.14.0.aar下载下来即可。

react-native.aar的文件内容

aar文件本质上是一个压缩包,我们可以将其后缀名由.aar修改为.zip,然后解压得到如下所示目录:

其中,classes.jar就是ReactAndroid的代码,使用JD-GUI工具可以一目了然:

而jni目录中存放的是RN依赖的so库,可以看到,为了减小使用RN的APK的包大小,只支持了armeabi-v7ax86两个处理器架构平台:

res目录包含了RN需要的资源,其中包含了很多国际化的文件:

对于我们的应用而言,一般只需要简体中文版本的就够了,因此,为了减小APK包大小,在我们工程的app/build.gradle文件中增加如下过滤,去掉其他语言的资源:

android {
    // 省略其他
    defaultConfig {
        // 省略其他
        resConfigs "zh-rCN"
        resConfigs "nodpi", "hdpi", "xhdpi", "xxhdpi", "xxxhdpi"
    }

Gradle本地依赖

把下载后的aar文件拷贝到工程的app/libs中,接着修改build.gradle文件,添加本地aar文件依赖如下:

dependencies {
    ...
    
    compile(name: 'react-native-0.14.0', ext: 'aar')
}

使用本地依赖方式,构建后react-native-0.14.0.aar不会自动下载RN所依赖的第三方函数库,需要我们手动配置,这些第三方函数库的下载方式可依法炮制。

那么如何查看react-native-0.14.0.aar依赖的第三方函数库呢?这个可以通过阅读RN的源码,打开源码路径下面的ReactAndroid/src/build.gradle文件查看其dependencies,如下所示:

dependencies {
    compile fileTree(dir: 'libs', include: ['*.jar'])
    compile 'com.android.support:appcompat-v7:23.0.1'
    compile 'com.android.support:recyclerview-v7:23.0.1'
    compile 'com.facebook.fresco:fresco:0.8.1'
    compile 'com.facebook.fresco:imagepipeline-okhttp:0.8.1'
    compile 'com.fasterxml.jackson.core:jackson-core:2.2.3'
    compile 'com.google.code.findbugs:jsr305:3.0.0'
    compile 'com.squareup.okhttp:okhttp:2.5.0'
    compile 'com.squareup.okhttp:okhttp-ws:2.5.0'
    compile 'com.squareup.okio:okio:1.6.0'
    compile 'org.webkit:android-jsc:r174650'
}

当然,完整的依赖项还不止这些,因为这些依赖可能还级连依赖其他的函数库,我们可以通过反编译AwesomeProject(通过react-native init AwesomeProject命令生成的)生成的apk,或者在Android Studio中查看AwesomeProject的External Libraries,会发现事实上最终打进apk包的函数包如下所示:

因此,最终我们的RN本地依赖完整函数包如下所示:

对于.jar包,我们只需要将其拷贝到app/libs目录中,并在app/build.gradle文件中如下设置即可正常引用:

dependencies {
    compile fileTree(include: ['*.jar'], dir: 'libs')
}

对于.aar包,传统的做法也是将其拷贝到app/libs目录中,然后在app/build.gradle目录中设置如下:

android {
    ...
    repositories {
        flatDir {
            dirs 'libs'
        }
    }
}

dependencies {
    ...
    compile(name: 'react-native-0.14.0', ext: 'aar')
}

但发现在最新到Android Studio中这样设置之后还是提示找不到react-native-0.14.0包,推测可能是不支持这种老的方式了,那么该如何引入本地.aar依赖呢?目前可行的方式是基于.aar文件新建一个module,并选择导入.JAR/.AAR包,如下图所示:

这种方式每个.aar文件占用一个module,视觉上比较丑陋。所有的.aar文件都新建成module之后,设置app module依赖所有这些基于.aar的module即可。最终工程看起来是这样的:

相关工程已上传到我的Github

将node_modules上传到svn/git

我们使用react-native init命令得到的RN示例中包含一个node_modules目录,这个目录是开发RN必不可少的,如下图所示,包含了很多内容,在网络环境差的时候很难完整下载下来,因此我们也需要把这个目录共享到svn或者git上面,供其他同事使用。

欢迎关注我的微信公众号

推荐阅读更多精彩内容