RN打包

作者: FingerStyle | 来源:发表于2022-11-25 20:29 被阅读0次

什么是JSBundle

JSBundle 是 JS代码打包后的产物,在React-native里面主要是通过react-native-cli提供的命令进行打包。跟网页类似,一个RN项目除了代码还会有资源文件,比如本地图片、JSON等,这些都会放到跟JSbundle同级的assets目录下。这些文件可以内置在原生的工程里,在原生工程启动时通过RN官方提供的方法加载JSbundle,并放到JS引擎中执行。也可以打成压缩包之后通过网络下载(也就是热更新)后再在本地执行。

react-native-cli

React-native官方提供的命令行工具,里面包含了拉取react-native模版工程(init命令)、诊断运行环境(doctor命令)、打包(bundle命令),以及远程调试(本地node服务)所用到的代码。默认通过npm依赖的方式集成到react-native源码中,也可以单独下载(https://github.com/react-native-community/cli#documentation),具体命令可通过官方文档或npx react-native --help 查阅

JSBundle格式

原始格式

原始格式是纯文本的JS代码,默认情况下会进行压缩和混淆


jsbundle-minify.png

当打包时关闭掉-minify选项后,可以看到原始的代码


jsbundle.png
JSbundle里每一行都是一个module,也就是一个文件的内容,在每一行的末尾会有该module的ID和所依赖的其他module的ID
jsbundle-2.png

moduleId是根据编译时的顺序生成的,默认是从0开始生成,按文件依次递增。前面的内容都是框架自带的module,我们自己写的module通常在后面。


jsbundle-3.png
本文是根据官方提供的awesome project模版拉取的代码并生成的jsbunble,可以跟源码对比看看有什么差异。

官方为了缩减JSbundle的大小,对很多函数做了简化处理,例如declare变成了__d, require变成了__r。

Hermes二进制格式

二进制格式的本质是字节码,字节码是JS转成可执行代码的中间形式。由于JS代码在 JS引擎里面需要编译为字节码或者机器码才能执行,这一阶段比较耗时,而且每次启动都是执行,明显是属于重复工作。为了减少这个时间,官方推出了hermes二进制格式,也就是我们说的字节码,支持预编译并且可以缓存在本地,减少二次编译,甚至可以在生成JSbundle的时候就编译为二进制格式。关于字节码的详细解释,可以参考我这篇博客(https://www.jianshu.com/p/af772cc66428),这里就不详细解释了。

RAM格式

RAM也是一种二进制格式,推出的目的是为了压缩包大小,主要是将jsbundle按模块拆分为单个的文件以支持按需加载,但是由于只支持iOS,并没有真正推广起来。想了解可以看官方介绍(https://facebook.github.io/metro/docs/bundling),不推荐深入研究。

打包脚本

我们使用react-native bundle命令来打包,假设打出来的包都放在 build 这个目录下,我们需要执行以下指令:

  1. 这生成index.android.bundle和index.android.bundle.packager.map,分别是JSbundle和sourceMap文件
    npx react-native bundle --platform android --dev false --entry-file index.js --bundle-output ./build/index.android.bundle --sourcemap-output ./build/index.android.bundle.packager.map

  2. 生成hermes二进制文件index.android.bundle.hbc及其与源码的映射文件index.android.bundle.hbc.map(主要是记录模块的VLQ编码与二进制文件中对应函数的偏移量的映射关系)。注意这里-output-source-map的值是上一步生成的JSBundle,并非我们通常所说的sourcemap文件。不同的版本hermesc的位置略有不同,可执行
    ./node_modules/hermes-engine/osx-bin/hermesc -emit-binary -out ./build/index.android.bundle.hbc -output-source-map ./build/index.android.bundle

    ./node_modules/react-native/sdks/hermesc/osx-bin/hermesc -emit-binary -out ./build/index.android.bundle.hbc -output-source-map ./build/index.android.bundle

  3. 根据第1步生成的sourcemap以及第2步生成的映射文件生成二进制文件的sourcemap。这一步不是必须的,但是如果你想通过sentry之类的错误收集平台来找到出错的代码,并且JSbundle是使用了hermes二进制格式的,就一定要上传这个sourceMap。
    ./node_modules/react-native/scripts/compose-source-maps.js ./build/index.android.bundle.packager.map ./build/index.android.bundle.hbc.map -o ./build/index.android.bundle.map

metro

metro是react-native专用的打包工具,有点类似web开发里面的webpack。前面说的react-native bundle命令背后就是用的metro(可参考代码 https://github.com/react-native-community/cli/tree/main/packages/cli-plugin-metro),关于metro的使用可以参考官方文档(https://facebook.github.io/metro/docs/concepts)

metro 大致可以分为resolver、transformer和Serialization三个阶段,分别是解析源码生成module的依赖图、转换module的格式已被目标平台所理解以及序列化生成最终产物,三个阶段官方有提供默认的实现(比如transformer是使用了babel),也提供了配置来替换一些关键函数。metro内部会根据依赖图的变化计算新增、修改和删除的模块,并且通过缓存transformer的结果来提升debug时的热更新效率。关于metro有很多博客介绍,可以参考https://www.jianshu.com/p/5730da61132f

metro.png

我们做拆包,主要是针对Serialization这个阶段做修改,修改的函数包括createModuleIdFactory(自定义模块ID的生成规则,确保唯一即可)、processModuleFilter(根据module信息判断是否已经处理过,打业务包需要)

hermesc

这是hermes的一个命令行工具,封装了hemres用到的常用函数,其中-emit-binary 功能是根据传入的路径找到jsbundle,加载内容,然后一行一行的解析,将JS编译为字节码,同时生成映射文件。这个工具也支持dump字节码、AST、IR以及解析JSX、ts等功能,可以说是非常全面了。可以输入./node_modules/react-native/sdks/hermesc/osx-bin/hermesc --help 查看所有的命令

相关文章

  • iOS 打包 React Native文件

    如果项目中用到了RN,那么打包测试,或者上线前,都需要将RN部分打包成为main.jsbundle文件, ...

  • RN打包

    react-native因为是用JavaScript语言写的,所以需要把js代码和图片资源都放进apk中,所以打包...

  • RN 打包

    1 iOS打包:react-native bundle --entry-file index.ios.js --...

  • RN 打包

    项目根目录下 创建文件夹release_ios 2.终端 项目根目录 输入 :react-native bund...

  • RN打包

    ios:react-native bundle --entry-file index.ios.js --bundl...

  • RN打包

    什么是JSBundle JSBundle 是 JS代码打包后的产物,在React-native里面主要是通过rea...

  • React-Native 入门之小技巧

    本文介绍一些RN的全局设置: 修改字体(全局) RN切换打包环境 切换后台,多次切换后台环境,切换打包环境好像是 ...

  • RN热更新原理之Android篇

    1.前言 我们知道RN打包后的最终APP,访问的是一个bundle文件,这个bundle文件是所有RN代码打包成的...

  • Android项目集成RN系列:修改端口号 / 离线包 / 消息

    【简述RN集成到Android原生项目】手动修改React Native端口号将RN项目打包成离线包RN与Andr...

  • React-Native 打包记录

    网上RN项目的离线打包教程如下: RN项目的离线打包(ios) - 简书 但是这样打出来的的api文件会有2个as...

网友评论

      本文标题:RN打包

      本文链接:https://www.haomeiwen.com/subject/aobffdtx.html