关于拆分包
传统上,React Native应用会发布一个包含以下内容的应用捆绑包:- 诸如
react和react-native之类的核心库 - Vega专属模块
- 第三方库
- 您应用程序的代码
系统(常用)捆绑包
该捆绑包预安装在设备上,包含广泛使用的库,例如react、react-native和@amazon-devices/react-native-kepler。有关详细信息,请参阅系统分发库。系统包与原生Vega运行时保持同步。
拆分应用程序包
您的应用程序包减去常用库。其中仅包含应用程序专属代码和任何专属依赖项。如何转化
以下是如何拆分单体捆绑包的简化示意图:为什么拆分包很重要
拆分包可带来几个关键优势:- 应用更小 — 从应用捆绑包中移除常用库可将其大小减少1MB或更多。
- 启动时间 (TTFD) 更快 — 核心库已预装在设备上,可将应用初始化时间缩短约100至150毫秒。
- 自动错误修复 — 由于系统库是独立更新的,因此无需发布新的应用版本即可修复错误并提高性能。
- 兼容性问题更少 — JS和原生组件都位于同一系统版本中,可确保兼容性。
拆分包机制的工作原理
在底层实现上,拆分捆绑包机制依赖于扩展Metro,它是React Native使用的JavaScript打包工具。通常,Metro会生成一个包含所有应用代码和依赖项的单一index.bundle。为启用拆分,Vega对Metro的序列化器阶段进行了自定义改造,该阶段负责控制如何将模块组合成捆绑包。
为实现这一点,需用到两个关键钩子:
processModuleFilter
- 筛除系统捆绑包中已提供的模块。
- 确保应用捆绑包不会重复
react或react-native等库。
createModuleIdFactory
- 用于为模块分配一致的确定性ID,确保系统包和应用程序包在共享代码时引用相同的模块ID。
- Vega不使用Metro的默认增量ID,而是使用基于哈希的方案(例如模块路径的SHA-256)来保证其在版本之间的稳定性。
捆绑包的类型
分包系统创建了三类主要的包:核心捆绑包(系统)
- 包含基础库(
react、react-native、@amazon-devices/react-native-kepler)。 - 它是首先生成的,会创建一个
modules.txt文件,用于将模块路径映射到ID, - 从而保障后续依赖捆绑包中的模块引用保持一致。
库捆绑包(系统)
- 适用于诸如
react-native-reanimated或react-native-screens之类的热门库。 - 构建时会利用核心捆绑包所创建的
modules.txt,以避免重复打包已经捆绑的依赖项。 - 会为每个库生成其他
modules.txt文件。
应用程序捆绑包(拆分后的应用捆绑包)
- 您的应用程序代码会经过过滤,剔除掉系统包中已包含的任何内容。
- 通过共享的统一ID来引用系统提供的模块。
keplerscript-app-system-bundles-config.json之类的元数据,告知Vega您的应用需要哪个系统捆绑包。运行时,Vega会先加载系统捆绑包,然后在此基础上挂载应用捆绑包。
依赖项与版本管理
拆分捆绑机制的一大核心挑战就是依赖版本控制:- 如果系统捆绑包有
react-native-screens@2.0.0,但您的应用需要2.1.0,则可能会出现冲突。 - 为解决这类冲突,Vega在内部采用带版本标识的模块路径,例如
react-native-screens__2/。 - 仅会将主要版本编码到路径中,例如
__2/,因此从2.0.0到2.0.1的错误修复不会破坏兼容性,也不会强制应用重建。
lodash,但不会在modules.txt中予以列出。因此,如果应用也依赖于相同版本的lodash,则它仍存在于应用包中,以防止系统库升级时意外损坏。
同样重大的安全升级: @amzn/react-native-screens__2/...(2.0.0 → 2.0.1不会改变路径)
不同的主要版本,故意保持区别:@amzn/react-native-screens__3/...
这套方案搭配稳定的模块ID机制,能让系统包高频迭代更新的同时,始终保持与应用的兼容性。
系统包构建全生命周期
以下是分包构建的完整生命周期:- 创建核心捆绑包 — 包含React、React Native和Vega模块。
- 创建库捆绑包 – 使用基于核心捆绑包的modules.txt的依赖项感知筛选。
- 创建应用捆绑包 — 移除系统提供的所有模块。
- 生成元数据 — 列出应用需要哪些系统捆绑包。
- 加载Vega — 首先是系统捆绑包,然后是应用捆绑包。
相关主题
- 适用于Vega的React Native应用架构 — 涵盖了Vega背后的更广泛的架构决策,包括如何将React Native运行时内置到OS中以及如何与应用进行动态链接。
- 支持的库和服务 — 列出所有随系统包预装分发的库,同步标注对应版本号与兼容性说明。
- 使用VMRP在您的应用中导入库 — 为不支持标准npm别名与覆盖规则的拆分捆绑场景讲解模块解析配置方法。
- 应用性能最佳实践 — 提供系统捆绑包自动优化之外的进阶技巧,进一步缩减捆绑包大小,提升应用启动速度。
- 安装和配置Vega ESLint插件 — 包含lint规则,可自动验证
package.json中系统分发库的使用情况,标记出在拆分捆绑场景下行为异常的导入。

