引言
React Native以其独到的特性,吸引着互联网公司纷纷为之投入或多或少的人力。在实际的开发过程中,开发者们也确实尝到了甜头,它的组件化思想、热更新机制 以及jsx和es6等的引入,都给开发者们带来了很大的便利。也难怪在npm和github上,每天都会有很多react-native的新模块出现。这也充分表明了各大公司对其的看好。
然而,从目前qq群、微信公众号、社区、论坛等各大信息交流平台中了解到,大家都是保持在研究和观望状态,顶多把某个不重要的页面交给React Native来练手。其中缘由纷繁复杂。
今天我们这里主要是探讨——bundle文件太大
不想看原理,直接看怎么使用请点击这里,开源链接
现状
React Native应用的开发者们,在项目开发完后,都会遇到一个问题,生成的bundle文件太大。一个AwesomeProject项目,在没有什么逻辑代 码的情况下,打完之后约530k。随着业务的增多,业务复杂性的上升,文件的大小势必会急剧增大。react-native打包成一个bundle的做 法,必定是要得到解决的。
分析
react-native默认提供的打包方式有两种:
· 离线打包
react-native bundle
--entry-file index.ios.js
--platform ios
--dev true
--bundle-output dest/main.jsbundle
--assets-dest dest
· 在线打包
http://localhost:8081/index.ios.bundle?platform=ios&dev=true
具体有哪些参数可以打开如下文件进行查看:
$youProjectRoot/AwesomeProject/node_modules/react-native/local-cli/bundle/bundleCommandLineArgs.js
如:
module.exports = [{
command: 'entry-file',
description: 'Path to the root JS file,either absolute or relative to JS root',
type: 'string',
required: true,},
......
官网中还给出了一些其它的使用方式,地址:
https://github.com/facebook/react-native/tree/master/packager
不过,不论哪种方式都是只有一个“entry-file”,然后根据“entry-file”去进行依赖分析、文件压缩等操作,最后输出在 “bundle-output”中。然后通过NSBundle的URLForResource方法来指定加载打好的的bundle文件。如:
jsCodeLocation = [[NSBundlemainBundle] URLForResource:@"main"withExtension:@"jsbundle"];
这样的打包模式,对用户体验来说是非常不错的。但是考虑到国内的网络状况以及对App size的控制,打成一个Bundle的模式在国内还是行不通的。
思考
在传统的Hybrid开发中,要解决文件太大的问题,我们常常会想到如下几个办法:
· 进行拆包
· 按需加载本地文件
· 按需加载线上文件
那么,能否把Hybrid开发中的经验应用在React Native项目中呢。在React Native项目中,针对文件大的问题,我们做了如下尝试:
· 多业务进行拆包
借助gulp、grunt等工具,通过配置不同的任务,在调用React Native提供的打包命令,可以将App打包成多个文件。
· 按需加载本地文件
在开发环境的情况下,React Native是支持加载本地文件的。这里想要做的是,在打包完的bundle中也可以加载本地文件,这就需要对require进行扩张了。
· 按需加载线上文件
在开发Hybrid时,为了减少包体积。开发者们经常会将一些不重要的页面或文件,走线上动态获取的方式。这个功能只有在web端的 requirejs中有,ReactNative和webpack中都是不支持的。要实现此项功能,需要对React Native中的require进行扩张。
· 按需加载react-native模块
不论是reactjs还是react-native,在代码的组织方式上都是按模块进行划分的。可能Facebook也意识到react框架太大了。这个模块划分的方式,给开发者们的按需载入创造了机会。
实现
这里简单阐述下部分功能的实现思路:
· React Native自身模块拆分
在打完的main.jsbundle中,常常会看到好多polyfills的文件,那这些文件从哪里来的呢。打开
node_modules/react-native/packager/react-packager/src/Resolver/index.js
文件,会看到这些polyfills文件都是在这里设置的,
path.join(__dirname,'polyfills/String.prototype.es6.js'),
path.join(__dirname,'polyfills/Array.prototype.es6.js'),
......
由名字可以看出,这些是用来对es6、es7进行适配的。所以代码中如果只有es5的语法是不是就可以不需要这些文件了呢,这也是个优化点,不过看起来量不大。
有人可能经常会有这样的想法:我们实际项目中用到的React Native模块其实并没几个,我们在打包的时候,是否可以只打包我们需要的模块呢。我们找到文件
/node_modules/react-native/Libraries/react-native/react-native.js
可以看到所有React Native的模块定义都是在这里了,包括Components、APIs等等。
var ReactNative = {
// Components
get ActivityIndicatorIOS() { return require('ActivityIndicatorIOS'); },
get ART() { return require('ReactNativeART'); },
......
所以,可以在打包的时候,根据实际情况,通过脚本等手段,注释掉一些用不到或不常用的模块以减少输出的体积。当然也可以把部分不常用的模块,抽出来单独作为一个文件,在需要的时候,通过按需加载的方式引入进来。
· 业务模块拆分
App的设计一般都是按照业务线划分的。每个业务都对应一套自己的逻辑。当然也有部分业务线会出现依赖情况。按React Native提供的打包方法,将所有业务线的逻辑都打在一起,势必会造成好多业务线代码的浪费。有可能那个业务线就根本不会被用户访问到。所以我们就想着能不能将一些基础的、公共的业务线打在一起,其它独立的业务线都各自独立成包。
React Native提供的打包方法允许输入一个入口文件,那么这个入口文件可以是整个App的入口,也可以是各业务线自己的入口。由此我们可以将各业务线单独成包,但这样的结果并不能直接投入使用。可以想到,这里并没有过滤机制,各业务线之间一些模块会被重复的打进去也包括react-native模块。而 React Native打包提供的参数中也只有blacklist会涉及一些过滤,但却无法满足我们的需求。
还好packager为我们提供了很多可以的API。通过参考
/node_modules/react-native/local-cli/bundle/buildBundle.js
中的打包逻辑,我们以一个入口文件的打包为例,可以将打包逻辑设计成如下:
1、加载打包需要用到的模块
var config = require('config.js')
var ReactPackager =require('react-native/packager/react-packager')
var Bundle =require('react-native/packager/react-packager/src/Bundler/Bundle')
var saveAssets =require('react-native/local-cli/bundle/saveAssets')
var outputBundle =require('react-native/local-cli/bundle/output/bundle')
2、创建client
var client =ReactPackager.createClientFor({
projectRoots: config.projectRoots,
blacklistRE: config.blacklistRE,
...})
3、调用outputBundle进行打包,将打包后的bundle返回
outputBundle.build(client, {
entryFile: config.file,
......})
4、分析bundle中的module,将符合条件的module加入到新的bundle中
定义一个新的bundle
var newBundle = new Bundle();
bundle.getModules().forEach(function(module) {
if(filter(module.sourcePath)){
newBundle._modules.push(module);
}......})
5、定义过滤机制
function filter(path){
var ret = true;
if(
(path.indexOf('/react-native/')!=-1)||
(sourcePath.indexOf('/fbjs/')!=-1)||
......){ret = false;}return ret;}
上只是个简单的过滤,在复杂的过滤中,还需要调用ReactPackager.getDependencies找到每个模块的依赖,然后在过滤的时候调用过滤模块的依赖,依次递归才能达到真正的滤掉。
6、对module进行合并、替换等处理
newBundle.finalize()
7、调用outputBundle输出新的bundle
outputBundle.save(newBundle, {},false)
到此,一个带有过滤功能的打包脚本就基本成型了,之后的多文件入口同时打包的功能,也就是要在上面做些扩扩展就可以了。
在打包方面,其实也也可走网络打包,packager的网络打包逻辑中,凡是请求以.bundle结尾的文件,都会对这个文件进行打包。而其它格式 的文件,则请求什么返回什么。所以可以根据该特性来实现打包。可以将过滤条件作为querystring的方式传递过去,然后在
react-native/packager/react-packager/src/Bundler/index.js
文件中对querystring进行拦截,并实现其过滤功能。
然而在实际的拆包中会发现,packager中打出的包都会将模块名称替换为数字id。这导致拆出的包中,引入不到某些模块,因为不是在一起打包,模块的id都对不上,或者会出现重复的情况。
我们的思路是打包的时候不进行id的替换,依然使用原有的模块名称,做到类似在web中requireJS使用的那样。 找到文件
node_modules/react-native/packager/reat-packager/src/Resolver/index.js
将如下代码中的moduleName,替换为model的绝对路径
functiondefineModuleCode(moduleName, code, verboseName = '') {
return [
`__d(`,
`${JSON.stringify(moduleName)}/*<-替换的地方*/ /* ${verboseName} */, `,
`function(global, require, module, exports){`,
`${code}`,
'\n});',
].join('');
}
这样只完成了define(如:define(0,...))中的名称替换,我们还需要找到require(如:require(0))中的名称替换,于是找到如下文件
node_modules/react-native/packager/reat-packager/src/Bundle/Bundle.js
在super(BundleBase)中,定义一个获取模块的方法getModuleName,将下面的super.getMainModuleId替换为super.getModuleName,这样在_addRequireCall就可以拿到模块的绝对路径了
_addRequireCall(moduleId) {
const code =`;require(${JSON.stringify(moduleId)});`;
const name = 'require-' + moduleId;
......
}finalize(options) {
options = options || {};
if (options.runMainModule) {
options.runBeforeMainModule.forEach(this._addRequireCall,this);
this._addRequireCall(super.getMainModuleId());/*<-替换的地方*/
}super.finalize();}
这样就完成了模块名称的保留,我们就可以愉快的使用我们的拆包模块了。
· 按需加载实现
经过上面的介绍,我们已经完成了模块的拆分。那么光有独立的模块还是不能让App运行起来,需要有一种能力将这些模块联系起来,这就是模块加载机制。
常规的加载会有如下两种场景:
1、本地模块
有时候为了加快页面打开速度,我们常常会选择将首页和非首页的页面进行分开打包,在App启动时,只加载首页的模块,待首页模块加载完毕后,再去异步的加载后续页面的模块。这里的本地模块加载就是用在这种场景中。那么在React Native中该如何实现这种加载方式呢。
要读写本地文件,光有javascript是办不到的,所以一定要借助native的能力。简单的代码实现如下:
#import"RCTBridgeModule.h"
@implementation RequireLocal
RCT_EXPORT_MODULE()
RCT_EXPORT_METHOD(loadPath:(NSString*)path callback:(RCTResponseSenderBlock)callback)
{
NSString *filePath = [[NSBundle mainBundle] pathForResource:pathofType:nil];
if ([[NSFileManager defaultManager] fileExistsAtPath:filePath]) {
NSString *content = [[NSString alloc]initWithContentsOfFile:filePath
......
}
@end
代码的流程为:按照React Native中对native模块封装的规范,实现RCTBridgeModule协议,并通过定义宏RCT_EXPORT_MODULE、RCT_EXPORT_METHOD将native模块的功能暴露给javascript来调用。
在native的模块中,采用NSBundle的 pathForResource方法,将文件路拿到。再借助NSString的initWithContentsOfFile方法获取到文件的内容。然后在javascript中,将拿到的内容,进行一次包装,如:
var str='__d("'+filePath+'", function(global, require, module, exports) {'+
content+
'})'
最后调用eval,便可将拿到的内容执行到当前的jscontext中。
2、线上模块
在App的开发中经常会为了控制size大小而发愁,尤其是苹果的100m限制,所以各业务线都在绞尽脑汁的想办法减size。自然而然的大家就想到了将一些资源放在服务端,在需要的时候将其异步加载下来,也就是常常听说的直连。对于服务器异步加载的实现,代码如下:
fetch(filePath)
.then((response) =>response.text())
.then((responseText) => {
......
代码的流程为:采用React Native提供的fetch方法,将需要的模块异步的从服务器上拉回来,接下来的动作,和上面的“本地模块”的逻辑一样。在实际的模块加载中,我们还需要对模块进行缓存,以提高模块的访问速度。
后续
在经过上面的介绍中,我们应该大概知道拆包和按需加载的实现原理。但是大家也都看到了,这要侵入react-native的代码中,进行很多地方的修改。这样不利于之后对react-native的版本升级。所以我们需要想一种更合理的解决办法。也就是我们现在正在做的一个尝试。
将React Native中的cmd模块,在线下或运行时编译为AMD模块,然后调用r.js的来对其进行打包,以达到干净的完成拆包和按需加载的功能。而且r.js 的打包配置的灵活度我觉得比packager、webpack、browserify等工具都灵活好使。
Q&A
问:是否考虑过多个业务公用一套rn的基础库?
魏晓军:是。
问:如果有,怎么做版本控制?
魏晓军:目前通文件夹控制,在我们的app中,基础框架一般只维护2个版本,再要有新的版本就会推动下掉一个老版本 。
问:线上资源的更新策略是什么样的?例如携程酒店和机票是公用一套rn的底层库吗?
魏晓军:更新策略,通过md5对比,差分到文件级别。酒店和机票现在还没上rn版本,若上,则都是公用一套rn底层。
问:用r.js打包react-native比webpack灵活在哪里呢?
魏晓军:这都是相对的,webpack有它独特的优势。这里我只拿r.js中的path、module等属性的概念来做对比,webpack在这方就相对弱了,拆包也只能通过代码中的require.entry来识别。
问:官方 RN 是在不断的迭代更新的,想请问下携程实际使用的是什么版本,和官方 RN 有差异吗?
魏晓军:我们目前是基于0.23开发的。
问:和官方 RN 保持同步更新吗?策略又是怎样的?
魏晓军:不同步更新,也没法同步更新。只有看到某些特别的亮点后,会选择跨越式的更新,如从0.23可能直接到0.32。