罗罗编程学习记录
本页内容 展开查看

07.2.2.8 构建打包、混合嵌入与热更新

所属:全栈开发面试题库 / 07 端侧与桌面开发 / 07.2 跨平台移动开发 / 07.2.2 React Native

本节要解决的问题

  • Release 构建到底产出什么?Hermes 字节码、Metro 产物、sourcemap 怎么归档?
  • Android 侧 AAB/APK、R8/混淆、so 架构分包、签名怎么配?
  • iOS 侧 Archive、签名与描述文件、隐私清单与权限声明要做什么?
  • 包体由哪些部分组成,怎么瘦身?
  • 存量原生 App 怎么嵌入 RN?RootView、多 Surface、多实例怎么管理?
  • RN 页面与原生页面互相跳转、生命周期桥接怎么做?
  • OTA 热更新的机制、合规边界、灰度与回滚怎么设计?

版本前提:本页涉及的构建命令、产物路径、平台审核规则、第三方热更新服务现状均会变化。CodePush 等服务的可用状态必须按官方公告核对,本页一律标注「待确认」,不得断言其已停服或仍可用。

覆盖范围

知识域 关键内容
Release 产物 Hermes 字节码、Metro bundle、sourcemap、构建归档
Android 构建 AAB/APK、R8/混淆、ABI splits、签名、构建变体
iOS 构建 Archive、签名、描述文件、Privacy Manifest、权限声明
包体治理 构成分析、瘦身手段、资源裁剪
混合嵌入 RootView、多 Surface/多实例、原生-RN 互跳、生命周期桥接
热更新 OTA 机制、自建更新服务、灰度回滚、平台合规

题号索引

题号区间 主题
001-003 Release 构建产物、Hermes 字节码、sourcemap 归档
004-007 Android AAB/R8/so 分包/签名、iOS Archive/隐私清单
008-009 包体构成分析与瘦身
010-014 混合嵌入 RootView、多 Surface、互跳、生命周期、模块边界
015-017 OTA 机制、自建更新、灰度回滚、合规红线
018 综合题:存量 App 嵌入 RN 的方案设计

07.2.2.8-001 Release 构建到底产出什么?

一句话结论

RN 的 Release 产物分两层:Metro 打包出 JS bundle(启用 Hermes 时是字节码 .hbc),原生工程把它与原生代码一起编译成平台安装包(Android AAB/APK、iOS IPA)。sourcemap 必须随版本归档,否则线上堆栈无法还原。

概念解释

Metro 把所有 JS/TS 代码、依赖、资源打包成一个 bundle。默认是 JS 文本;启用 Hermes 时,构建期把 JS 编译成 Hermes 字节码(.hbc),运行时直接加载字节码,省去解析。bundle 还会带上资源(图片、JSON)的映射。

Android 上 bundle 被放在 APK 的 assets/index.android.bundle(或编译后的 .hbc);iOS 上放在 App bundle 的 main.jsbundle。原生工程把这些资产与原生代码、so 库、资源一起打成安装包。

sourcemap 是"编译后位置 → 源码位置"的映射表,崩溃栈里的混淆位置必须靠它还原成可读源码。

原理流程

npm/源码
  → Metro 打包(--dev=false)
  → 产出 index.android.bundle / main.jsbundle(启用 Hermes 时为 .hbc)
  → 同时产出 .map 文件(sourcemap)
  → 原生工程编译:
       Android:gradle assembleRelease → AAB/APK
       iOS:xcodebuild archive → IPA
  → sourcemap + 符号表 + 版本号一起归档

代码或图示

产物 内容 位置
JS bundle / .hbc 编译后的 JS 代码 APK assets / App bundle
sourcemap 源码映射 不进包,归档
原生符号 iOS dSYM / Android mapping 不进包,归档
资源 图片、字体 进包

常见误区

  • 误区:JS bundle 是可独立分发的 App;正解:它必须由原生壳承载,不能单独安装。
  • 误区:sourcemap 不用存;正解:线上崩溃栈还原全靠它,每个版本都要归档。

追问

  • Q:Hermes 字节码与 JS 文本的区别?A:字节码是构建期预编译产物,运行时省去解析;调试与 sourcemap 流程相应变化。
  • Q:怎么手动打 bundle?A:用 RN 提供的 CLI 命令(具体命令以版本为准),或让原生构建脚本自动触发。

07.2.2.8-002 Hermes 字节码在构建期做了什么?

一句话结论

启用 Hermes 后,Metro 输出的不是 JS 文本而是 Hermes 字节码(.hbc):构建期把 JS 解析、编译成字节码,运行时直接加载,无 JIT;这降低了启动时间与内存占用,但需要 sourcemap 工具链适配。

概念解释

构建流程多一步:Metro 打包 → Hermes 编译器把 JS 编译成字节码 → .hbc 写入 bundle。运行时 Hermes 引擎直接加载字节码,跳过 JS 解析与字节码生成阶段。

对调试的影响:源码映射工具要支持 Hermes 字节码栈(栈帧是字节码偏移,不是行列号),需要专门的 sourcemap 处理。

原理流程

JS 源码
  → Metro 打包
  → Hermes 编译(构建期)
  → .hbc 字节码
  → 进 APK/IPA
运行时:加载 .hbc → 直接执行(无 JIT)

代码或图示

维度 JSC(JS 文本) Hermes(字节码)
构建期 不编译 编译成字节码
运行时 解析+编译 直接加载
JIT 有(部分) 无
启动 较慢 较快
内存 较高 较低

常见误区

  • 误区:Hermes 字节码跨架构通用;正解:字节码与引擎版本绑定,升级 Hermes 版本后旧字节码不兼容(具体以版本说明为准)。
  • 误区:Hermes 一定比 JSC 快;正解:启动与内存优,峰值计算性能不一定,需实测。

追问

  • Q:怎么确认 App 用了 Hermes?A:看构建配置(Android gradle.properties 的 hermesEnabled 之类开关,iOS 对应配置,字段以版本为准)。
  • Q:Hermes 字节码栈怎么还原?A:用专门的 sourcemap 工具(如 hermes-stack-demangler 之类,具体工具链以官方文档为准)。

07.2.2.8-003 sourcemap 怎么归档与使用?

一句话结论

每次构建产出 sourcemap(JS 侧)+ 原生符号表(iOS dSYM / Android mapping.txt),按版本号 + 构建号 + 平台归档;线上崩溃上报时带上版本号,监控平台用对应符号表还原栈。

概念解释

还原链路:

  • JS 崩溃:上报的是 bundle 内的位置(如 index.android.bundle:1:23456),用对应版本的 JS sourcemap 还原成源码行列。
  • Android 原生崩溃:经过 R8 混淆后栈是 a.b.c 短名,用 mapping.txt 还原。
  • iOS 原生崩溃:栈是地址,用 dSYM 文件符号化。

三者必须按"版本号 + 构建号 + 平台 + 架构"精确归档,缺一个就还原不出来。

原理流程

构建:
  JS sourcemap  ←┐
  mapping.txt  ←├─ 按 versionCode + buildNo + platform 归档
  dSYM         ←┘

线上崩溃:
  上报栈 + 版本号 + 平台
  → 找对应符号表
  → 还原源码位置

代码或图示

平台 符号表 还原对象
JS JS sourcemap 业务代码栈
Android mapping.txt R8 混淆后栈
iOS dSYM 地址栈

常见误区

  • 误区:只归档 JS sourcemap;正解:原生崩溃同样需要符号表。
  • 误区:开发期构建的 sourcemap 也归档;正解:只有 Release 构建的符号表对应线上包。

追问

  • Q:CI 里怎么自动归档?A:构建脚本在出包后把符号表上传到监控平台(如 Bugly、Sentry 等),按版本号自动关联。
  • Q:sourcemap 能随便给人吗?A:它等于源码,是敏感资产,不要公开。

07.2.2.8-004 Android 侧 AAB、APK 与 R8 混淆怎么配?

一句话结论

Google Play 上架要求 AAB(Android App Bundle),它在分发时按设备架构动态生成 APK;R8 是 Release 构建的代码压缩与混淆工具,替代旧 ProGuard,把类名/方法名缩短以减小体积并增加逆向难度。

概念解释

AAB 不是安装包,是上传给 Google Play 的中间产物,Google 按用户设备(ABI、屏幕密度、语言)生成最优 APK 分发。国内市场仍可能要求直接上传 APK。

R8 在 Release 构建时做三件事:收缩(移除未调用代码)、混淆(类名/方法名改成 a/b/c)、优化(内联、重排)。混淆后必须保留 mapping.txt,否则栈不可读。RN 与原生库需要在 proguard-rules.pro 里加 keep 规则,否则反射与 JNI 调用会被混淆掉。

R8 还有一个常被忽略的能力:资源收缩(resource shrinking)。它会自动移除未被引用的图片、字符串、布局资源,但要注意动态加载的资源(如按名字取图片)要加 keep 规则,否则会被误删。

原理流程

gradlew bundleRelease
  → 产出 .aab(上传 Google Play)
  → Google Play 按设备生成 split APK
  → R8 收缩+混淆+优化
  → 产出 mapping.txt(归档)

代码或图示

产物 用途
AAB 上传 Google Play
APK 国内市场 / 直接分发
mapping.txt 栈还原

常见误区

  • 误区:AAB 可以直接安装;正解:它只是上传产物,真机安装要用 APK。
  • 误区:R8 一定会把代码搞崩;正解:只要 keep 规则写全,反射与 JNI 都安全。

追问

  • Q:哪些类要 keep?A:JNI 调用的类、反射调用的类、序列化模型类、RN 模块(具体规则以 RN 官方模板为准)。
  • Q:R8 与 ProGuard 区别?A:R8 是新版工具,合并了收缩与混淆,速度更快,配置语法兼容(具体以 AGP 版本为准)。

07.2.2.8-005 so 架构分包与 ABI splits 怎么做?

一句话结论

RN 依赖原生 so(libreactnative.so、Hermes 等),不同 CPU 架构(armeabi-v7a、arm64-v8a、x86_64)需要不同 so;把所有架构都打进一个 APK 会让包体大几十 MB,按 ABI 分包或用 App Bundle 动态分发可以显著瘦身。

概念解释

Android 设备主要是 arm64-v8a,少量老设备是 armeabi-v7a,x86_64 主要是模拟器。如果一个 APK 带全架构 so,包体会大很多。

方案:

  • App Bundle:Google Play 自动按设备 ABI 分发,最省事。
  • ABI splits:在 gradle 配置 abiFilters 或 splits,为每个 ABI 生成独立 APK。
  • 只保留 arm64-v8a:现代设备基本都支持,能砍掉一大半 so 体积(但要确认 minSdk 与设备覆盖)。

原理流程

默认:APK 含 armeabi-v7a + arm64-v8a + x86_64 全部 so
分包:
  AAB → Play 按设备分发
  或 gradle splits → 每架构一个 APK

代码或图示

架构 设备覆盖 保留建议
arm64-v8a 现代真机 必留
armeabi-v7a 老设备 按覆盖决定
x86_64 模拟器 不上线

常见误区

  • 误区:把 x86_64 so 也打进上线包;正解:上线只保留 arm 架构。
  • 误区:ABI splits 后应用商店自动分发;正解:国内市场要自己上传多个 APK 或用通用包。

追问

  • Q:怎么查 so 体积?A:用 APK Analyzer 看 lib/ 目录,每个架构占多少。
  • Q:RN 升级后 so 会变吗?A:会,每个 RN 版本带对应预编译 so,升级时要确认 ABI 覆盖。

07.2.2.8-006 Android 签名与构建变体怎么管理?

一句话结论

Android 用 keystore 文件 + 密码签名 Release 包;构建变体(debug/release、不同 flavor)用 gradle productFlavors 区分;签名密钥必须妥善保管,丢失就无法发版更新。

概念解释

签名是 App 身份的证明:同一个包名 + 同一签名才能作为升级覆盖。keystore 文件与密码一旦丢失,就不能再更新原应用(只能换包名重新上架)。

构建变体:debug 用 debug keystore, Release 用正式 keystore;多渠道(国内应用商店)用 flavor 区分,每个渠道可能有不同的 SDK、渠道号、资源。

除了 keystore 本身,还要管理"签名配置":不要把 keystore 密码写在 gradle 配置里提交到 Git,应该用环境变量或 keystore.properties(不进版本库)读取。CI 上要用密钥管理服务注入签名信息,不要明文存在 CI 配置里。

原理流程

gradle buildTypes {
  release { signingConfig 正式签名 }
  debug  { signingConfig debug 签名 }
}
productFlavors { google / huawei / xiaomi ... }

代码或图示

变体 用途 签名
debug 开发 debug keystore
release 上线 正式 keystore
flavor 渠道 同 release

常见误区

  • 误区:keystore 提交到 Git;正解:它是敏感资产,放密码管理或 CI 密钥库。
  • 误区:debug 签名也能上线;正解:上线必须用正式签名,且与历史版本一致。

追问

  • Q:密钥丢失怎么办?A:Google Play 有密钥恢复流程(具体以官方为准),国内市场基本无解,所以备份第一。
  • Q:多渠道签名不一致会怎样?A:用户从华为商店装的包,无法升级小米商店的包(签名不同)。

07.2.2.8-007 iOS Archive、签名与隐私清单要做什么?

一句话结论

iOS 用 Xcode Archive 出 IPA,需要开发者账号、描述文件(Provisioning Profile)、证书;2024 年起 Apple 还要求提交 PrivacyInfo.xcprivacy 隐私清单与权限使用说明,否则审核被拒。

概念解释

签名链:开发者证书 → App ID → 描述文件(绑定设备/证书/能力)。Archive 时选择正确的描述文件,导出 IPA。上架 App Store 用 App Store 描述文件,真机调试用 Development 描述文件。

隐私清单(PrivacyInfo.xcprivacy):声明 App 收集哪些数据、用于什么目的、用到哪些"需要声明的 API"(如文件时间戳、UserDefaults 等)。权限声明在 Info.plist 里写 NSCameraUsageDescription 等,向用户解释为什么要权限。

RN 项目里还有一个常见坑:第三方 Pod 自带的隐私清单可能没合并到主工程,导致审核时被拒。要在 Xcode 中检查"Privacy Manifest"是否包含所有依赖的声明,必要时手动合并。

原理流程

Xcode → Archive
  → 选择 Provisioning Profile
  → 导出 IPA
  → 上传 App Store Connect
  → 审核检查:隐私清单 + 权限说明 + 签名

代码或图示

项 内容
证书 Distribution Certificate
描述文件 App Store Provisioning Profile
隐私清单 PrivacyInfo.xcprivacy
权限说明 Info.plist Usage Description

常见误区

  • 误区:只写权限说明就够;正解:Apple 还要求隐私清单与数据披露。
  • 误区:开发证书能上架;正解:上架必须用 Distribution 证书与 App Store 描述文件。

追问

  • Q:RN 库的隐私清单谁负责?A:每个库要自己提供 PrivacyInfo.xcprivacy,主工程要收集合并(具体以 Xcode 版本行为为准)。
  • Q:审核被拒常见原因?A:权限说明文案太笼统、隐私清单缺失、未说明数据收集用途。

07.2.2.8-008 包体由哪些部分组成,怎么分析?

一句话结论

包体主要由原生代码、JS bundle(含 Hermes 字节码)、原生 so、图片资源、字体、第三方 SDK 组成;用平台分析工具(Android APK Analyzer、iOS App Thinning Size Report)逐项占比,砍大不砍小。

概念解释

典型包体构成(示意,以实际为准):

  • 原生代码与资源:几十 MB。
  • JS bundle:几 MB 到十几 MB(Hermes 字节码通常比 JS 文本小)。
  • so 库:每个架构几 MB 到十几 MB。
  • 图片资源:未压缩 PNG/JPG 可能很大。
  • 第三方 SDK:推送、统计、广告可能加起来几十 MB。

瘦身顺序:先砍 so(ABI 分包)、再砍资源(WebP/压缩)、再砍无用 SDK、最后看 JS bundle 与原生代码。

原理流程

APK/IPA 拆解:
  ├─ lib/ (so 库)
  ├─ assets/ (JS bundle、字体)
  ├─ res/ (图片、布局)
  ├─ classes.dex / Framework
  └─ 第三方 SDK

代码或图示

部分 常见手段
so ABI 分包、只留 arm64
图片 WebP、压缩、CDN
资源 未用资源裁剪、Tint
SDK 替换为轻量库
JS bundle 移除未用依赖、压缩

常见误区

  • 误区:先去删代码;正解:so 与图片通常占大头,先动它们。
  • 误区:把所有图片都转成 WebP;正解:透明图与动图要单独评估。

追问

  • Q:怎么知道某个 SDK 占多少?A:用 APK Analyzer 看 classes.dex 与 res,或用依赖分析工具。
  • Q:JS bundle 怎么减?A:移除未用依赖、按需引入、压缩,工具链以 RN 版本为准。

07.2.2.8-009 包体瘦身的实战手段有哪些?

一句话结论

按 ROI 排序:so 分包(一次砍几十 MB)→ 图片资源(WebP + CDN)→ 无用 SDK → R8 收缩 → 代码与资源裁剪。不要为了减 1MB 去重写业务。

概念解释

so 分包:App Bundle 自动分发或 ABI splits,是最大杠杆。

图片:把大图放 CDN,App 内只留启动图、Tab 图标等必须资源;PNG 转 WebP,用 tinypng 类工具压缩。

SDK 审计:很多 App 接了推送、统计、广告、分享、地图、崩溃,每个都几 MB,要按业务必要性砍。

R8 收缩:Release 开启收缩与混淆,移除未调用代码(要配合 keep 规则)。

原理流程

1. 分析包体构成
2. 砍 so(ABI 分包)
3. 砍图片(WebP + CDN)
4. 砍无用 SDK
5. R8 收缩
6. 复测

代码或图示

手段 典型收益
ABI 分包 20-40%
图片 WebP 5-15%
砍 SDK 视情况
R8 收缩 5-10%

常见误区

  • 误区:用"包体积监控"但不归档;正解:每个版本记录包体构成,回归对比。
  • 误区:为了减包把图片全走 CDN;正解:首屏必须的图片不能走网络,要本地。

追问

  • Q:怎么防止包体回弹?A:CI 加包体上限告警,新版本超过阈值自动拦截。
  • Q:动态框架(iOS)与静态框架区别?A:动态框架可以不打进主包(但会增加启动成本),具体以 Xcode 配置为准。

07.2.2.8-010 存量原生 App 怎么嵌入 RN?

一句话结论

在原生工程里集成 RN 依赖,用一个原生容器(Android ReactNativeHost + ReactRootView,iOS RCTRootView)承载 RN 页面;入口 JS 组件作为 RN 页面根组件,通过原生路由打开。

概念解释

嵌入不是"把整个 App 改成 RN",而是"在原生 App 里加一个 RN 页面"。步骤:

  1. 原生工程加 RN 依赖(Android gradle、iOS CocoaPods)。
  2. 配置 JS bundle 位置(本地开发从 Metro 读,Release 从打包资源读)。
  3. 写一个原生容器 Activity/ViewController,创建 ReactRootView,挂载指定 JS 模块名。
  4. 原生路由跳转到这个容器。

嵌入后还要处理"启动时机":不要在 App 启动时就初始化 ReactHost,因为它会占内存与启动时间。建议在用户首次访问 RN 页面时懒初始化,或者在 App 进入后台时预热。另外 Release 包要把 JS bundle 打包进原生资源,不能依赖 Metro。

原理流程

原生 App 路由 → 打开 RN 容器
  → 初始化 ReactNativeHost(或 RCTBridge)
  → 创建 ReactRootView
  → 挂载 JS 模块(如 "ProductPage")
  → Metro/本地 bundle 加载 → JS 渲染 → 原生视图上屏

代码或图示

平台 容器 入口
Android ReactRootView + Activity ReactNativeHost
iOS RCTRootView + ViewController RCTBridge

常见误区

  • 误区:每个 RN 页面都新建一个 bridge;正解:bridge 初始化成本高,应该复用。
  • 误区:开发模式也能直接 Release 跑;正解:开发模式要连 Metro,Release 用本地 bundle。

追问

  • Q:JS bundle 放哪?A:打包进原生工程资源(随包),或下载到沙盒(热更新场景)。
  • Q:新架构下嵌入有变化吗?A:宿主对象从 bridge 变成 ReactHost/RCTHost,具体以版本为准。

07.2.2.8-011 多 Surface、多实例怎么管理?

一句话结论

一个 RN 运行时(bridge/ReactHost)可以承载多个 Surface(多个 RN 页面实例);不要为每个页面建一个运行时,否则内存与启动成本爆炸。多 Surface 共享 JS 运行时,但各自独立视图树。

概念解释

运行时(bridge/ReactHost)是重资源:它持有 JS 引擎、模块注册表、消息通道。Surface 是轻量的:一个 JS 模块挂载到一个原生视图。

典型模式:

  • App 启动时初始化一个共享运行时。
  • 每次打开 RN 页面,创建一个 Surface,挂载到容器。
  • 页面关闭,销毁 Surface,运行时保留。
  • 多个 Surface 可以同时存活(如 RN 页面 push 另一个 RN 页面)。

原理流程

共享 ReactHost(单例)
  ├─ Surface A:ProductPage(挂载到容器 A)
  ├─ Surface B:CartPage(挂载到容器 B)
  └─ Surface C:...

代码或图示

概念 成本 是否复用
运行时/bridge 高 单例共享
Surface 中 按页面
视图容器 低 按页面

常见误区

  • 误区:每个页面新建 bridge;正解:内存会翻倍,启动也变慢。
  • 误区:多 Surface 之间自动共享状态;正解:它们共享同一个 JS 运行时,全局 store 是共享的,但导航状态各自独立。

追问

  • Q:什么时候才需要多运行时?A:完全隔离的业务(如第三方 SDK 提供的独立 RN 模块),一般情况不需要。
  • Q:新架构下多 Surface 怎么配置?A:通过 ReactHost 的 surface API,具体 API 以版本为准。

07.2.2.8-012 RN 页面与原生页面怎么互相跳转?

一句话结论

原生 → RN 用原生路由打开 RN 容器并传参;RN → 原生用原生模块暴露导航方法,或通过统一的路由协议(URL scheme)让 RN 发一个跳转请求给原生。

概念解释

原生 → RN:原生打开容器 Activity/VC,把参数传给 JS 模块(通过 initialProps 或路由参数)。

RN → 原生:JS 侧调用原生模块暴露的方法,如 NativeNavigation.push('NativePage', params),原生侧收到后执行导航。不要让 JS 直接操作原生导航栈。

复杂场景(RN 页面再 push 一个 RN 页面):在 RN 内部用 React Navigation 管理自己的栈,原生只负责最外层容器。

原理流程

原生 → RN:
  原生路由 → 打开 RN 容器 → initialProps 传参 → JS 读参数

RN → 原生:
  JS 调 NativeRouter.open('NativePage', params)
  → 原生模块接收 → 原生导航

代码或图示

方向 机制
原生 → RN 容器 + initialProps
RN → 原生 原生模块导航方法
RN → RN React Navigation
外部 → RN 深链 / URL

常见误区

  • 误区:让 JS 直接拿原生导航栈对象;正解:通过模块方法封装,保持边界。
  • 误区:参数随便传;正解:跨边界参数必须可序列化(旧架构),复杂对象要拆字段。

追问

  • Q:RN 页面关闭后怎么通知原生?A:原生模块提供回调或事件,JS 关闭时调用,原生做清理。
  • Q:返回手势怎么处理?A:原生返回键/边缘手势触发原生路由,原生决定是 pop 容器还是让 JS 内部 pop。

07.2.2.8-013 混合架构下的生命周期与状态共享怎么桥接?

一句话结论

原生页面生命周期(onResume/onPause、viewWillAppear)要桥接到 JS 侧(通过事件或模块);状态共享通过全局 store(Zustand/RTK)或原生模块暴露的共享数据,不要让 JS 直接读原生对象。

概念解释

RN 页面不是原生 Activity,它的"生命周期"由容器决定。容器在 onResume 时要通知 JS(如刷新数据、暂停动画),onPause 时通知 JS(如停止轮播、暂停视频)。实现方式:原生发事件,JS 侧订阅。

状态共享:登录用户、设备信息等跨原生与 RN 的数据,通过原生模块暴露 getter/setter,或由 JS 启动时从原生拉一次初始化。不要让 JS 持有原生对象引用。

原理流程

容器 onResume
  → 原生发事件 "RN_LIFECYCLE" { state: 'resume' }
  → JS 订阅 → 刷新/恢复
容器 onPause
  → 发事件 { state: 'pause' }
  → JS 暂停轮播/视频

代码或图示

生命周期 桥接方式
容器可见 事件通知 JS
容器不可见 事件通知 JS
前后台切换 AppState(RN 自带)
数据共享 原生模块 getter

常见误区

  • 误区:用 React 的 componentDidMount 就够了;正解:那只覆盖 JS 挂载,不覆盖原生容器切到后台再回来。
  • 误区:让 JS 监听原生所有生命周期;正解:只桥接业务关心的事件。

追问

  • Q:App 前后台切换 RN 怎么感知?A:用 RN 自带的 AppState,它在新老架构都支持。
  • Q:原生登录后怎么通知 RN?A:原生模块发事件,RN 全局 store 订阅后更新用户态。

07.2.2.8-014 混合架构下的模块边界与状态怎么共享?

一句话结论

模块边界:原生能力(相机、定位、支付)通过原生模块暴露给 JS;业务逻辑放在 JS;原生与 RN 之间通过"数据契约"(可序列化字段)通信,不共享内存对象。

概念解释

边界混乱的典型症状:JS 直接读原生 SharedPreferences、原生代码里写业务规则、JS 与原生互相调用方法名拼写不一致。

清晰边界:

  • 原生模块是"能力接口",每个模块职责单一(如 PaymentModule.pay(order))。
  • 业务规则、状态管理都在 JS。
  • 通信数据是可序列化的字典/对象,不暴露原生对象。
  • 原生侧不直接改 JS 状态,发事件由 JS 处理。

原理流程

JS 业务逻辑
  ├─ 调原生模块:Payment.pay(order) → Promise
  ├─ 订阅原生事件:Push.onNotification → 处理
  └─ 共享数据:UserStore(JS)+ 原生模块 getter 兜底

原生侧:
  └─ 只暴露能力,不写业务

代码或图示

层 职责
原生模块 暴露能力
JS store 业务状态
通信数据 可序列化

常见误区

  • 误区:把业务规则放原生模块;正解:原生模块是能力层,规则在 JS。
  • 误区:让 JS 直接调原生任意类;正解:每个原生模块是一个 API 边界,要版本化与测试。

追问

  • Q:原生模块的版本怎么管理?A:模块 API 加版本号,JS 侧探测支持情况做降级。
  • Q:第三方 SDK(如支付)怎么接?A:封装成原生模块,JS 只调 pay(),不关心 SDK 细节。

07.2.2.8-015 OTA 热更新的机制与边界是什么?

一句话结论

OTA 热更新是在不发版的情况下把新的 JS bundle(及资源包)下发到 App,替换本地 bundle 后重启 JS 运行时生效;它只能改 JS 与资源,不能改原生代码、不能加原生模块、不能改原生配置。

概念解释

机制:App 启动时检查更新服务,有新包则下载到沙盒,下次启动时加载新 bundle。服务端记录每个 App 版本对应的 bundle 版本。

边界:

  • 能改:JS 代码、JS 引用的资源(图片、JSON)。
  • 不能改:原生代码、原生模块、原生配置(权限、签名)、so、原生资源。
  • 风险:新版本 JS 与旧原生不兼容会崩。

热更新包还要做"差量更新":全量 bundle 几 MB,每次都下载浪费流量。差量更新只下载与本地包的差异部分,在原生侧合成新包。这要求客户端有合成逻辑,且要处理合成失败的回退。

原理流程

App 启动
  → 请求更新服务:当前版本 + 当前 bundle 版本
  → 有新包 → 下载到沙盒(后台)
  → 下次启动加载新 bundle
  → 记录 bundle 版本

代码或图示

能改 不能改
JS 代码 原生代码
图片/资源 原生模块
业务逻辑 权限/签名

常见误区

  • 误区:热更新能修所有 bug;正解:原生崩溃、原生模块 bug 修不了。
  • 误区:热更新包立刻生效;正解:通常要下次启动才加载,或重启 JS 运行时。

追问

  • Q:怎么让用户立刻生效?A:重启 JS 运行时(开发者模式),但用户体验是"闪一下",要谨慎。
  • Q:热更新包大小?A:JS bundle 几 MB,要做差量更新(具体方案以自建服务为准)。

07.2.2.8-016 CodePush 等热更新服务现状怎么看?

一句话结论

CodePush 等第三方热更新服务的可用性、维护状态、收费政策会变化,必须按官方最新公告核对,不能凭记忆断言"已停服"或"仍可用";生产环境建议自建更新服务以掌握主动权。

概念解释

CodePush 是微软推出的 RN 热更新服务,其归属与维护状态随公司战略变化(截至本页写作时的具体服务状态与时间线待确认,需查官方公告)。企业自建更新服务的核心是:一个 HTTPS 接口返回最新 bundle 版本、App 内下载与校验、灰度分发、回滚开关。

自建的好处:不依赖第三方、数据自己掌握、可深度定制;代价:要做 CDN、版本管理、灰度、回滚、监控。

原理流程

第三方服务:
  App → 服务端 SDK → 下载/灰度/回滚(服务托管)

自建:
  App → 自己的更新接口 → 下载到沙盒 → 校验 hash → 重启加载

代码或图示

方案 优点 风险
第三方服务 快 服务状态、收费、数据
自建 自主 开发成本

常见误区

  • 误区:凭记忆说 CodePush 已停服;正解:必须查官方公告,标注待确认。
  • 误区:热更新服务随便用;正解:它受平台合规约束(见下题)。

追问

  • Q:自建更新服务要做什么?A:版本管理、bundle 上传、灰度比例、强制更新开关、回滚、监控。
  • Q:怎么校验 bundle 完整性?A:下载后比对 hash,防止 CDN 被篡改或下载损坏。

07.2.2.8-017 平台合规红线、灰度与回滚怎么设计?

一句话结论

App Store 对动态下发 JS 有明确审核规则,国内 Android 各市场对"热更新/动态代码加载"也有要求(具体条款以各市场最新公告为准,待确认);灰度按用户比例/设备/版本分批,回滚用"关闭新 bundle 开关"立即切回旧包。

概念解释

合规:App Store 要求热更新不能改变 App 的核心功能与元数据,不能下载可执行代码做"热修复原生";纯 JS bundle 在多数情况下被允许,但规则会更新,必须按最新审核指南核对。国内 Android 市场对动态加载有不同态度,特别是涉及金融、内容类 App,要按目标市场规则评估。

灰度:按用户 ID 哈希分流,1% → 10% → 50% → 100%,观察崩溃率与错误率。

回滚:服务端配置开关,发现问题立即把"当前 bundle 版本"切回上一个稳定版,App 下次启动加载旧包。

原理流程

发布:
  新 bundle 上传 → 灰度 1% → 观察 24h → 10% → 50% → 100%
异常:
  服务端开关切回旧版本 → App 下次启动加载旧包

代码或图示

阶段 比例 观察
灰度1 1% 崩溃率、错误率
灰度2 10% 同上 + 用户反馈
全量 100% 持续监控

常见误区

  • 误区:热更新随便发;正解:它仍然是一次发布,要有灰度与回滚。
  • 误区:回滚要重新发版;正解:切开关即可,下次启动生效。

追问

  • Q:怎么强制更新?A:服务端下发最低版本要求,App 检测到版本过低时弹窗引导用户去商店更新(这是原生更新,不是热更新)。
  • Q:热更新与商店审核冲突怎么办?A:合规存疑时走正式发版,不要冒审核风险。

07.2.2.8-018 综合题:存量原生 App 嵌入 RN 的方案怎么设计?

一句话结论

按"单例运行时 + 容器复用 + 路由协议 + 原生模块边界"设计:一个共享 ReactHost,原生路由打开 RN 容器并传参,RN 通过统一路由模块跳原生,生命周期事件桥接,状态通过全局 store 与原生模块共享,不做热更新(先验证稳定性)。

概念解释

这道题要把前面所有点串起来:

  1. 初始化:App 启动时创建单例 ReactHost,预加载 bundle(但不首屏渲染)。
  2. 容器:每个原生页面是一个 Activity/VC,里面挂 ReactRootView,传入 JS 模块名与参数。
  3. 路由:原生 → RN 走容器 + initialProps;RN → 原生走 RouterModule.push/split;RN → RN 走 React Navigation。
  4. 生命周期:容器可见/不可见发事件给 JS;App 前后台用 AppState。
  5. 状态:登录用户由原生模块暴露 getter,JS 启动时拉取并同步到 store;跨 RN 页面用全局 store。
  6. 原生能力:支付、相机、推送封装成独立原生模块。
  7. 发布:先随包发,验证稳定后再评估是否加热更新(合规先确认)。

原理流程

App 启动
  → 初始化 ReactHost(单例)
  → 预加载 bundle(后台)
  → 原生路由跳 RN 容器
       → 创建 Surface 挂载 JS 模块
       → initialProps 传参
       → JS 内部 React Navigation
       → 需要跳原生时调 RouterModule

代码或图示

决策点 方案
运行时 单例共享
容器 每页面一个
路由 协议 + 原生模块
状态 全局 store + 原生模块 getter
热更新 先不上,合规后评估

常见误区

  • 误区:一上来就全量 RN 化;正解:先嵌一个独立页面验证链路,再逐步迁移。
  • 误区:嵌入后不监控;正解:混合栈的崩溃率、JS 错误率、启动时间都要单独看板。

追问

  • Q:怎么判断某个页面该不该用 RN?A:看跨端复用价值、交互复杂度、迭代频率;频繁变化且两端一致的页面适合 RN。
  • Q:嵌入后包体增加多少?A:RN 基础库 + so 会增加一定体积,要在预算内评估。