as

Settings
Sign out
Notifications
Alexa
亚马逊应用商店
Ring
AWS
文档
Support
Contact Us
My Cases
新手入门
设计和开发
应用发布
参考
支持
原生
Skip to main content
基于React Native构建的现代应用通常会附带大型的单体JavaScript捆绑包。这些捆绑包中包含所有内容,从核心React库到应用特定的业务逻辑。但是,这种方法带来了挑战: 应用大小更大,启动速度更慢,交付错误修复时的摩擦力也更大。 Vega引入了拆分包系统,在该系统中,常用库位于系统上,应用则仅提供其独有的代码。本文探讨了这意味着什么、它为何重要以及它的工作原理。

关于拆分包

传统上,React Native应用会发布一个包含以下内容的应用捆绑包:
  • 诸如react和react-native之类的核心库
  • Vega专属模块
  • 第三方库
  • 您应用程序的代码
使用拆分包时,应用程序包将会分为两部分:

系统(常用)捆绑包

该捆绑包预安装在设备上,包含广泛使用的库,例如react、react-native和@amazon-devices/react-native-kepler。有关详细信息,请参阅系统分发库。系统包与原生Vega运行时保持同步。

拆分应用程序包

您的应用程序包减去常用库。其中仅包含应用程序专属代码和任何专属依赖项。

如何转化

以下是如何拆分单体捆绑包的简化示意图:
在运行时,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机制,能让系统包高频迭代更新的同时,始终保持与应用的兼容性。

系统包构建全生命周期

以下是分包构建的完整生命周期:
  1. 创建核心捆绑包 — 包含React、React Native和Vega模块。
  2. 创建库捆绑包 – 使用基于核心捆绑包的modules.txt的依赖项感知筛选。
  3. 创建应用捆绑包 — 移除系统提供的所有模块。
  4. 生成元数据 — 列出应用需要哪些系统捆绑包。
  5. 加载Vega — 首先是系统捆绑包,然后是应用捆绑包。
最终形成模块化体系,让应用体积更小、启动更快,同时对底层库版本更新具备更强的抗干扰能力。

相关主题

  • 适用于Vega的React Native应用架构 — 涵盖了Vega背后的更广泛的架构决策,包括如何将React Native运行时内置到OS中以及如何与应用进行动态链接。
  • 支持的库和服务 — 列出所有随系统包预装分发的库,同步标注对应版本号与兼容性说明。
  • 使用VMRP在您的应用中导入库 — 为不支持标准npm别名与覆盖规则的拆分捆绑场景讲解模块解析配置方法。
  • 应用性能最佳实践 — 提供系统捆绑包自动优化之外的进阶技巧,进一步缩减捆绑包大小,提升应用启动速度。
  • 安装和配置Vega ESLint插件 — 包含lint规则,可自动验证package.json中系统分发库的使用情况,标记出在拆分捆绑场景下行为异常的导入。

最后修改于 2026年4月16日