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

07.2.2.4 Metro 与工程体系、依赖与版本升级

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

本节要解决的问题

  • Metro 是怎么把 JS 源码打成 bundle 的,resolver、transform、serializer 各自做什么?
  • 模块解析里的 .ios/.android 平台后缀、package exports 条件导出是怎么工作的?
  • monorepo / workspace 下的符号链接为什么会踩坑,怎么处理?
  • 原生依赖 autolinking 怎么自动接入 Podfile / Gradle,原理是什么?
  • RN 大版本升级流程怎么走,breaking change 与新架构开关怎么处理?
  • CI 构建、产物缓存、调试工具(DevTools / Flipper)现状是什么?

版本前提:本页以 RN 0.70+ 工程体系为基线,autolinking 在 RN 0.60 后成为默认;新架构开关(Fabric/TurboModules/Bridgeless)在各版本默认状态不同,凡涉及默认开关、字段名、命令处均标注待确认。架构演进详见 07.2.2.1。

覆盖范围

知识域 关键内容
Metro 打包 依赖图、resolver、transform、serializer、缓存与增量
模块解析 平台后缀、package exports、Babel/TS 配置、monorepo 符号链接
原生集成 autolinking、Podfile、Gradle、原生依赖版本对齐
版本升级 RN 升级流程、breaking change、新架构开关、依赖兼容
工程与 CI 目录结构、调试工具、构建缓存、打包发布流程

题号索引

题号区间 主题
001-004 Metro 打包原理、缓存增量、模块解析、平台后缀与 exports
005-007 Babel/TS 配置、monorepo 符号链接、autolinking
008-010 Pod/Gradle 集成、依赖管理、目录结构
011-014 RN 版本升级流程、breaking change、新架构开关、第三方库兼容
015-016 调试工具现状、CI 产物与构建缓存
017-018 综合题:升级大版本踩坑、打包发布流程

07.2.2.4-001 Metro 打包的整体流程是什么?

一句话结论

Metro 是 RN 的 JS 打包器:从入口文件出发,递归构建依赖图(resolver),把每个模块转成目标格式(transform),最后把所有模块序列化进一个 bundle(serializer);支持缓存与增量构建。

概念解释

Metro 的四个核心阶段:一是 resolver,负责把 import x from 'foo' 解析成实际文件路径,处理平台后缀、扩展名、目录入口;二是 transform,用 Babel 把每个模块转成可执行格式(JSX、TS、路径重写);三是 serializer,把所有模块按依赖顺序拼成一个 bundle,每个模块包在函数里,用数字 ID 引用;四是缓存,把 transform 结果缓存起来,下次只处理变化的文件。

与 Webpack/Vite 不同,Metro 是为 React Native 定制的:它必须理解平台后缀、Hermes 字节码编译、以及 React Native 的模块系统。

原理流程

入口文件(index.js)
  → resolver:递归找依赖,构建模块图
  → transform:每个模块经 Babel 转换
  → serializer:拼成 bundle(模块 ID + 函数包裹)
  → (可选)hermesc 编译成 .hbc

代码或图示

阶段 职责 可配置点
resolver 路径解析、平台后缀 resolver选项、platforms
transform Babel 编译 transformer、babel.config
serializer 拼 bundle serializer、output 格式
缓存 增量构建 cache 目录、resetCache

常见误区

  • 以为 Metro 是 Webpack 的 RN 版:它是独立实现,不兼容 Webpack 配置。
  • 以为 Metro 只做打包:它同时负责开发服务器与快速刷新。

追问

  • Metro 模块系统用什么格式?答:每个模块包在函数里,用 __d(function(){...}, moduleId, [deps]) 注册(具体格式以版本为准)。
  • 怎么清缓存重新构建?答:用 --reset-cache 参数(命令以版本为准)。

07.2.2.4-002 Metro 的缓存与增量构建是怎么工作的?

一句话结论

Metro 把每个模块的 transform 结果按文件内容哈希缓存,下次构建只重新处理内容变化的模块,从而实现增量;缓存失效由文件内容与依赖配置变化触发。

概念解释

缓存粒度是单文件:每个源文件的 transform 输出按文件路径与内容哈希存储。当文件内容变化时,只有它自己和依赖它的模块需要重新 transform。这就是为什么改一个文件后,开发服务器重启很快。

缓存也会失效:Babel 配置变化、依赖图变化(新增/删除 import)、平台切换(ios/android)都会触发重新 transform。常见问题是"缓存脏了"导致诡异 bug,这时用 --reset-cache 清掉重建。

原理流程

首次构建:所有模块 transform → 缓存
后续构建:
  → 对比文件内容哈希
  → 未变化:读缓存
  → 变化:重新 transform → 更新缓存

代码或图示

缓存键示意:
文件路径 + 文件内容哈希 + Babel 配置哈希 + 平台
缓存值:transform 后的模块代码

常见误区

  • 以为改配置后缓存自动生效:Babel 配置变化可能需要手动清缓存。
  • 以为缓存目录可以随意删:删了下次全量构建变慢。

追问

  • 缓存在哪?答:在用户目录的 Metro 缓存目录(具体路径以版本为准)。
  • CI 上怎么利用缓存?答:把缓存目录持久化,命中则大幅加速。

07.2.2.4-003 模块解析中的 .ios/.android 平台后缀是怎么工作的?

一句话结论

Metro resolver 在解析模块时会尝试平台特定的文件名:Button.ios.js 优先于 Button.js,从而实现"同一模块名,两端不同实现"的条件加载。

概念解释

当你写 import Button from './Button',Metro resolver 按顺序尝试:Button.ios.tsx(iOS 当前平台)、Button.native.tsx、Button.tsx。如果当前平台是 Android,就尝试 Button.android.tsx。这让同一逻辑目录下可以放两端差异化实现,业务代码 import 路径不变。

native 后缀是通用回退(所有原生平台共享),ios/android 是平台特定。这个机制也适用于第三方库:库里可以放 Foo.ios.js 与 Foo.android.js。

原理流程

import './Button'
  resolver 尝试顺序(iOS 平台):
    Button.ios.tsx → Button.ios.js → Button.native.tsx → Button.tsx → Button.js
  找到即返回

代码或图示

后缀 适用
.ios.* 仅 iOS
.android.* 仅 Android
.native.* 两端原生共享
无后缀 通用回退

常见误区

  • 以为平台后缀是 Babel 做的:它是 Metro resolver 的能力,与 Babel 无关。
  • 以为 .native 与无后缀等价:.native 在 web 目标不加载,只在原生加载。

追问

  • 怎么在同目录管理两端实现?答:放 Button.ios.tsx 与 Button.android.tsx,可选 Button.native.tsx 共享。
  • Windows/macOS 桌面端用什么后缀?答:随 RN 扩展平台支持,具体后缀以版本为准。

07.2.2.4-004 package exports 与条件导出在 RN 里怎么处理?

一句话结论

package.json 的 exports 字段控制子路径导出与条件导出(如 require/import、browser/node);Metro 对 exports 的支持随版本演进,RN 里常用的条件是 react-native、import、require。

概念解释

现代 npm 包用 exports 而不是 main 字段控制导出。条件导出可以根据环境(浏览器、Node、RN)选择不同入口。Metro resolver 需要识别这些条件,否则会解析错入口。

常见问题:一个库同时提供 main(CommonJS)和 module(ESM),RN 项目下应该用哪个?Metro 默认按配置的条件解析,react-native 条件可以指向 RN 专用入口。如果配置错误,可能引入了 Node 专用代码导致运行时报错。

原理流程

import 'foo'
  → 读 foo/package.json 的 exports
  → 按当前条件(react-native、import、require)选入口
  → 找到实际文件

代码或图示

// 示意:package.json exports 条件
{
  "exports": {
    ".": {
      "react-native": "./dist/rn.js",
      "import": "./dist/esm.js",
      "require": "./dist/cjs.js"
    }
  }
}

常见误区

  • 以为所有库都能直接用:某些库的 exports 配置没考虑 RN 条件,需要手动指定路径。
  • 以为 main 字段永远生效:exports 优先级高于 main,且会屏蔽未列出的子路径。

追问

  • 怎么排查解析错入口?答:看 Metro 的 resolver 日志,确认实际解析到的文件路径。
  • 条件导出与平台后缀冲突吗?答:不冲突,exports 选入口,平台后缀在入口文件内再解析。

07.2.2.4-005 Babel 与 TypeScript 配置在 RN 里怎么工作?

一句话结论

Metro 用 Babel 做转换,RN 的 preset(babel-preset-react-native)负责处理 JSX、Flow、路径重写;TypeScript 通过 Babel 插件剥离类型,不做类型检查,类型检查由 tsc 或 IDE 单独做。

概念解释

RN 的 Babel 配置在 babel.config.js,核心是 babel-preset-react-native(或新版的 babel-preset-expo 等),它负责:JSX 转译、Flow 类型剥离、import 路径重写、开发模式的快速刷新支持。TypeScript 文件由 Babel 插件 @babel/preset-typescript 处理,只做类型擦除,不做类型检查。

这意味着:类型错误不会在打包时暴露,要靠 tsc 或 CI 单独跑类型检查。这是与 Web 项目的一个常见差异。

原理流程

.tsx 文件
  → Babel(preset-react-native + preset-typescript)
  → 类型擦除 + JSX 转译
  → Metro 模块格式
类型检查:tsc --noEmit 单独跑

代码或图示

// 示意:babel.config.js
module.exports = {
  presets: ['module:babel-preset-react-native'],
};

常见误区

  • 以为 Babel 会做类型检查:它只擦除类型,类型错误运行时才暴露。
  • 以为 TS 配置 tsconfig.json 决定打包:Metro 不读 tsconfig,只读 Babel。

追问

  • 怎么在 CI 里跑类型检查?答:加 tsc --noEmit 步骤,与打包分开。
  • RN 用 Flow 还是 TS?答:RN 源码历史上用 Flow,业务侧常用 TS,两者可共存。

07.2.2.4-006 monorepo / workspace 下的符号链接坑是什么?

一句话结论

Monorepo 用符号链接(symlink)把本地包链接进 node_modules,Metro 默认不跟踪符号链接外的真实文件路径,导致重复打包、Haste Map 冲突、快速刷新失效;需要配置 Metro 识别符号链接。

概念解释

pnpm/yarn workspace 用符号链接把 packages/ui 链接到 node_modules/ui。Metro 默认按 node_modules 路径解析,可能把符号链接内的文件当作"另一份代码",导致:同一模块被打包两次、模块 ID 冲突、Haste 系统找不到模块。

解决方式是在 Metro 配置里告诉它跟随符号链接、识别真实路径(watchFolders、resolver.nodeModulesPaths、resolver.disableHierarchicalLookup 等,具体字段以版本为准)。

原理流程

monorepo:
packages/ui  ──symlink──▶  node_modules/ui
Metro 默认:
  按 node_modules/ui 解析 → 可能把 ui 当外部包
配置后:
  跟随符号链接 → 真实路径 packages/ui → 纳入依赖图

代码或图示

问题 表现 解法
重复打包 bundle 变大、模块冲突 配置跟随符号链接
Haste 冲突 模块名找不到 配置 watchFolders
快速刷新失效 改包代码不生效 监听真实路径

常见误区

  • 以为 monorepo 下 Metro 自动工作:符号链接需要显式配置。
  • 用 npm 的 flat 结构代替 pnpm:能避免符号链接问题,但牺牲了 monorepo 的隔离性。

追问

  • pnpm 为什么容易出问题?答:pnpm 默认用符号链接结构,比 yarn classic 的 flat 结构更需要 Metro 配置。
  • 怎么验证符号链接配置正确?答:看 bundle 里同一模块是否只出现一次。

07.2.2.4-007 原生依赖 autolinking 是怎么工作的?

一句话结论

RN 0.60 后引入 autolinking:JS 包里的原生模块(含 android/ 或 ios/ 目录、或 .podspec)在构建时自动被 Podfile/Gradle 发现并集成,不需要手动改原生工程。

概念解释

旧版本要手动改 Podfile 加 pod 'RNFoo'、改 Gradle 加 implementation project(':rn-foo'),包一多维护痛苦。autolinking 把这步自动化:RN CLI 在构建时扫描 node_modules,找出含原生代码的包,生成 Podfile/Gradle 需要的依赖声明,再让原生工程集成。

iOS 侧通过 CocoaPods 的 use_native_modules! 触发;Android 侧通过 Gradle 的 settings.gradle 配置触发。业务侧只需要 npm install,原生依赖自动就位。

原理流程

npm install 一个含原生代码的包
  → RN CLI 扫描 node_modules
  → 发现包的 android/ 与 ios/
  → iOS:Podfile 执行 use_native_modules! → 集成
  → Android:settings.gradle 配置 → Gradle 集成

代码或图示

平台 触发点 集成方式
iOS Podfile use_native_modules! CocoaPods
Android settings.gradle Gradle project

常见误区

  • 以为 npm install 后 JS 包就能用:含原生代码的包要重新 pod install / gradle sync。
  • 以为 autolinking 覆盖所有场景:某些复杂库仍需手动配置。

追问

  • 怎么排除某个包的 autolinking?答:用配置字段排除(具体字段以版本为准)。
  • 怎么看哪些包被 autolinking 了?答:跑 npx react-native config 查看(命令以版本为准)。

07.2.2.4-008 Podfile 与 Gradle 在 RN 工程里扮演什么角色?

一句话结论

Podfile 是 iOS 的依赖管理文件(CocoaPods),Gradle 是 Android 的构建工具与依赖管理;RN 工程通过它们把 RN 框架、原生模块、第三方原生库集成进原生壳。

概念解释

iOS 侧:Podfile 声明平台版本、引入 React 框架 pod、执行 use_native_modules! 接入 autolinking、安装原生模块。执行 pod install 生成 Pods 工程与 Podfile.lock。Android 侧:settings.gradle 引入 RN 与原生模块工程,build.gradle 声明依赖与签名,Gradle sync 后构建 APK。

工程上常见问题:Podfile.lock 与 Gradle 依赖版本不一致、平台最低版本过低、RN 框架 pod 版本与 JS 版本不匹配。

原理流程

iOS:
  Podfile → pod install → Pods 工程 → Xcode 构建
Android:
  settings.gradle + build.gradle → gradle sync → 构建 APK

代码或图示

文件 平台 职责
Podfile iOS 声明 pod、autolinking、平台版本
Podfile.lock iOS 锁定 pod 版本
settings.gradle Android 引入子工程
build.gradle Android 依赖、签名、构建配置

常见误区

  • 以为改了 JS 包就重新构建原生:含原生代码的包要重新 pod install / gradle sync。
  • 以为 Podfile.lock 不需要提交:锁文件要提交,保证团队与 CI 一致。

追问

  • 怎么解决 pod install 报错?答:看是版本冲突、平台版本过低还是 autolinking 没生效。
  • Gradle 依赖冲突怎么查?答:用 gradlew dependencies 看依赖树(命令以版本为准)。

07.2.2.4-009 RN 工程的典型目录结构是什么?

一句话结论

RN 工程包含 JS/TS 业务源码、原生壳目录(android/ios)、配置文件(package.json、babel、metro、gradle、podfile);原生壳与 JS 包分离,共同组成可发布应用。

概念解释

一个标准 RN 工程根目录:业务源码在 src/,原生壳在 android/ 与 ios/,配置在根目录。原生壳本身是完整的 Android/iOS 工程,RN 作为依赖集成进去。这种结构允许:JS 业务独立开发,原生壳做宿主;也可以在原生壳里写原生代码。

原理流程

RN 工程根
├── src/            # JS/TS 业务
├── android/        # 原生壳(Android)
├── ios/            # 原生壳(iOS)
├── package.json
├── babel.config.js
├── metro.config.js
└── app.json / app.config.js

代码或图示

目录 内容
src/ 业务组件、页面、逻辑
android/ 原生壳、Gradle、Manifest
ios/ 原生壳、Podfile、Xcode 工程
配置文件 构建、依赖、平台版本

常见误区

  • 以为 RN 工程只有 JS 文件:必须有原生壳承载。
  • 以为原生壳目录可以删:删了无法构建。

追问

  • 混合嵌入时目录结构有什么不同?答:原生壳是既有 App,RN 作为依赖集成,不使用完整 android/ios 目录。
  • Expo 项目呢?答:Expo 把原生壳托管,业务侧看不到 android/ios,需要时 eject。

07.2.2.4-010 依赖管理与版本锁定怎么做?

一句话结论

JS 侧用 package.json 声明范围 + 锁文件(package-lock.json / yarn.lock)锁定版本;原生侧用 Podfile.lock 与 Gradle 锁定;三者都要提交,保证团队与 CI 一致。

概念解释

依赖版本漂移是"本地能跑线上不行"的常见根因。JS 侧锁文件锁定每次安装的精确版本;原生侧 Podfile.lock 锁定 pod 版本,Gradle 用 lockfile 或动态版本声明。任何升级都要显式改锁文件,避免 npm install 意外解析新版本。

工程上还要对齐 JS 包与原生壳的版本:RN 的 JS 版本与原生壳里的 RN 框架版本必须一致,否则会出兼容性问题。

原理流程

package.json(范围声明)
  → npm install / yarn install
  → 生成 lock 文件(精确版本)
  → 原生侧:pod install / gradle sync → 原生锁文件
所有锁文件提交 → 团队与 CI 一致

代码或图示

锁文件 锁定内容
package-lock.json / yarn.lock JS 依赖精确版本
Podfile.lock iOS pod 版本
Gradle lockfile Android 依赖版本

常见误区

  • 只提交 package.json 不提交锁文件:环境解析出不同版本。
  • 升级 RN 时只改 JS 版本不改原生壳:JS 与原生框架版本不匹配。

追问

  • 怎么批量升级依赖?答:用工具如 npm-check-updates 或 yarn upgrade-interactive,升级后回归测试。
  • 锁文件冲突怎么解决?答:重新生成锁文件并审查,不要手动合并冲突。

07.2.2.4-011 RN 大版本升级的标准流程是什么?

一句话结论

标准流程:先看官方升级助手与 changelog → 升级 JS 依赖与原生壳模板 → 处理 breaking change → 跑测试 → 灰度验证 → 全量;不能直接 npm install 一个新版本就完事。

概念解释

RN 升级不是简单改版本号,因为原生壳模板(android/ios 目录)会随版本变化。官方提供升级助手(upgrade helper),展示两个版本之间的模板差异。流程上:

  1. 看 changelog,列出 breaking change 与废弃 API。
  2. 升级 package.json 里的 RN 与相关依赖。
  3. 用升级助手对比原生壳模板,把模板改动合入自己的原生工程。
  4. 重新 pod install / gradle sync。
  5. 处理不兼容的第三方库。
  6. 全量回归测试。

原理流程

1. 看官方升级助手:diff 两个版本的模板
2. 升级 JS 依赖
3. 合入原生壳模板改动
4. pod install / gradle sync
5. 处理 breaking change(API 改名、配置变化)
6. 处理不兼容依赖
7. 测试 → 灰度 → 全量

代码或图示

步骤 工具/手段
看模板差异 官方 upgrade helper
升级依赖 npm/yarn
原生壳同步 pod install / gradle sync
回归 测试 + 灰度

常见误区

  • 以为只改 package.json:原生壳模板不同步会出各种诡异问题。
  • 跨大版本直接升级:建议逐版本升级,不要跳。

追问

  • 怎么处理原生壳里的自定义改动?答:维护 patch 文件或把自定义改动收敛到独立配置,避免每次 merge 冲突。
  • 升级前要评估什么?答:依赖兼容性矩阵、新架构开关状态、最低系统版本要求。

07.2.2.4-012 breaking change 怎么识别与应对?

一句话结论

breaking change 来自官方 changelog、废弃 API 列表、原生配置变化;应对方式是逐个替换 API、调整配置、升级不兼容依赖,并在测试中覆盖。

概念解释

RN 每次大版本都有 breaking change:API 改名、默认行为变化、配置字段废弃、最低系统版本提升。常见应对:

  • API 改名:用 codemod 或手动替换。
  • 默认行为变化:显式配置保持旧行为或适配新行为。
  • 原生配置变化:按升级助手改模板。
  • 第三方库不兼容:升级库或替换。

关键是不要"升完就发",要逐项核对 changelog。

原理流程

读 changelog
  → 列出 breaking change
  → 分类:API 改名 / 配置变化 / 行为变化
  → 逐项修复
  → 搜索代码中是否还在用废弃 API
  → 测试覆盖

代码或图示

变化类型 例子 应对
API 改名 模块名/方法名变化 替换调用
默认行为变化 某开关默认反转 显式配置
配置字段废弃 某字段改名 改配置
最低版本提升 minSdk/IPhone 版本 调整平台版本

常见误区

  • 跳过 changelog 直接升级:运行时才发现 API 不存在。
  • 只改 JS 不改原生配置:原生配置变化是启动崩溃的常见根因。

追问

  • 怎么批量找废弃 API 用法?答:用 codemod 工具或全局搜索 deprecated API 名。
  • 废弃 API 一定会被移除吗?答:通常会有一个版本周期的废弃期,之后移除,具体以 changelog 为准。

07.2.2.4-013 新架构开关在升级时怎么处理?

一句话结论

升级到新架构版本时,Fabric/TurboModules/Bridgeless 开关可能在 gradle.properties / Podfile 环境变量中;要按项目迁移计划决定是否开启,开启前必须评估依赖兼容性。

概念解释

新架构开关在不同版本位置不同:Android 通常在 gradle.properties,iOS 通常在 Podfile 的环境变量(如 RCT_NEW_ARCH_ENABLED,具体字段以版本为准)。升级时要确认:这个版本新架构是否默认开启?项目是否准备好?

如果项目尚未迁移,要显式关闭新架构开关,保持旧架构;如果已准备好,开启并跑通全链路。新架构迁移路径详见 07.2.2.1。

原理流程

升级 RN 版本
  → 确认新架构默认状态(版本相关)
  → 评估依赖兼容性
  → 决定:显式关闭 / 开启迁移 / 跟随默认
  → 开启后修复 Codegen、模块、组件不兼容

代码或图示

开关 位置 状态(以版本为准)
Fabric gradle.properties / Podfile env 逐步默认开启
TurboModules 同上 逐步默认开启
Bridgeless 同上 后续版本

常见误区

  • 以为升级后自动就是新架构:要确认开关与依赖兼容性。
  • 开启新架构后不做全链路回归:渲染与模块行为变化会出问题。

追问

  • 怎么确认项目当前是新架构还是旧架构?答:看开关配置与启动日志(具体日志标识以版本为准)。
  • 新架构开关能灰度吗?答:通过构建配置或运行时开关,具体方案以版本为准。

07.2.2.4-014 第三方原生库不兼容时怎么选型与接入?

一句话结论

按"是否含原生代码"分层判断:纯 JS 库基本不受新架构影响;含原生代码的库看是否提供新架构适配或走 Interop;既无适配又阻塞关键路径的,替换或自研。

概念解释

判断依据:一是看库是否有原生代码(android/、ios/、.podspec);二是看库是否标注新架构支持;三是实测关键路径。处理策略:升级适配版本、走 Interop 过渡、fork 补适配、替换为社区替代方案。

接入后要封装统一 JS 接口,隔离平台差异,便于后续替换。

原理流程

依赖清单 → 是否含原生代码?
  ├─ 纯 JS:低风险,验证行为差异
  └─ 含原生
       ├─ 有新架构适配 → 升级
       ├─ 无适配但 Interop 可用 → 过渡兜底
       └─ 完全不可用 → 替换/自研

代码或图示

评估项 关注点
平台支持 Android/iOS 是否覆盖
RN 版本兼容 是否匹配当前版本
新架构支持 是否提供 Fabric/TurboModule
维护活跃度 更新频率、issue 处理

常见误区

  • 只看 star 数选型:版本兼容与维护活跃度更关键。
  • 库直接暴露给业务层:应封装一层,便于替换与降级。

追问

  • 库停止维护怎么办?答:评估替代方案或自行维护补丁,注意长期成本。
  • 怎么快速扫出含原生代码的依赖?答:检查 node_modules 下是否有 android/ios 目录。

07.2.2.4-015 调试工具现状(DevTools / Flipper)是什么?

一句话结论

JS 调试走 Chrome DevTools 协议(官方 RN DevTools),原生调试走平台 IDE(Android Studio / Xcode);Flipper 历史上是集成调试桌面工具,近年官方支持状态有调整,需以最新文档为准。

概念解释

RN 调试分两层:JS 层用 Chrome DevTools 连接 Hermes/JSC,断点、看调用栈、看控制台;原生层用 Android Studio / Xcode 调试原生模块与渲染。Flipper 曾经是把这些整合到一个桌面应用的工具,随 RN 官方工具链演进,其支持状态在变化(待确认)。

工程上常见问题:调试连接失败、Hermes 下某些高级调试功能不可用、发布包不能调试。

原理流程

开发包 → Hermes/JSC 开启调试服务
  → Chrome DevTools 连接 → JS 调试
  → Android Studio / Xcode 连接 → 原生调试
发布包 → 无调试服务 → 靠日志与 sourcemap

代码或图示

调试对象 工具
JS 代码 Chrome DevTools / 官方 RN DevTools
原生模块 Android Studio / Xcode
渲染层级 官方 DevTools / 平台工具
线上问题 sourcemap + 日志

常见误区

  • 在发布包上 attach 调试:发布包不开放调试端口。
  • 以为 Flipper 还是官方首选:工具链在调整,以最新文档为准。

追问

  • 怎么调试启动期 JS?答:启动期代码运行早,调试器连接前已执行,需要打点或离线复现。
  • 原生模块怎么调试?答:用平台 IDE attach 进程,打断点在原生代码。

07.2.2.4-016 CI 构建与产物缓存怎么配置?

一句话结论

CI 上跑 RN 构建要:安装依赖(带锁文件)、pod install、Gradle 同步、bundle 打包;缓存 Metro、Pod、Gradle 目录以加速;产物按版本归档。

概念解释

CI 构建慢的常见原因:每次全量安装依赖、重新下载 pod、Gradle 重新解析、Metro 重新 transform。优化手段:把依赖目录、Pod 目录、Gradle 缓存、Metro 缓存持久化到 CI 缓存,命中则跳过。

产物要按版本归档:JS bundle、.hbc、sourcemap、APK/IPA,与版本号一一对应,用于崩溃还原。

原理流程

CI:
  → 拉代码(含锁文件)
  → 缓存命中:npm install 增量
  → pod install(缓存 Pods)
  → gradle sync(缓存 Gradle)
  → Metro bundle(缓存 transform)
  → 构建产物 → 归档

代码或图示

缓存目录 加速内容
node_modules 依赖安装
Pods iOS 依赖下载
Gradle caches Android 依赖
Metro cache JS transform

常见误区

  • CI 上每次清缓存:构建时间翻倍。
  • 产物不归档 sourcemap:线上崩溃无法还原。

追问

  • 怎么保证 CI 与本地一致?答:都用锁文件,CI 不做版本浮动安装。
  • CI 上怎么跑测试?答:加单元测试、E2E 测试步骤,与构建分开。

07.2.2.4-017 综合题:团队升级 RN 大版本后构建失败,怎么排查?

一句话结论

按"JS 层 → 原生壳层 → 依赖层 → 配置层"分层排查:先确认 Metro 打包是否通过,再看 pod install / gradle sync,再看依赖版本,最后看配置字段是否废弃;不要一把梭 npm install 重装。

概念解释

升级后构建失败的常见根因:

  1. JS 层:某个库的 imports 用了已废弃 API,或 Babel 配置与新版本不兼容。
  2. 原生壳层:模板改动没合入,导致 Podfile / Gradle 引用了不存在的路径。
  3. 依赖层:第三方库版本与新 RN 不兼容,或版本漂移。
  4. 配置层:配置字段改名/废弃,新架构开关位置变化。

排查顺序应该从最早失败的步骤开始:Metro bundle 先过,再 pod install,再 gradle build。

原理流程

构建失败
  → Metro bundle 失败?
    ├─ 是:看 Babel/import 错误,查 API 废弃
    └─ 否 → pod install 失败?
       ├─ 是:看 Podfile 模板、autolinking、平台版本
       └─ 否 → gradle build 失败?
          ├─ 是:看 Gradle 依赖、模板、新架构开关
          └─ 否 → 运行时崩溃?
             → 看启动日志、Codegen、模块注册

代码或图示

判定树:
升级后构建失败
  → Metro 报错? → Babel/import/API 问题
  → pod install 报错? → Podfile 模板/autolinking
  → gradle 报错? → Gradle 依赖/模板/开关
  → 运行时崩溃? → Codegen/模块/新架构开关

常见误区

  • 直接删 node_modules 重装:没定位根因,下次还会失败。
  • 只看最后一条错误:前面的错误可能才是根因。

追问

  • 怎么看升级助手有没有同步模板?答:对比当前原生壳与官方模板 diff。
  • 升级后运行时崩溃但构建通过?答:查新架构开关、Codegen 产物、模块注册。

07.2.2.4-018 综合题:发布构建流程与产物归档怎么做?

一句话结论

发布流程:CI 上用锁文件安装依赖 → Metro 打包发布 bundle(压缩、无调试)→ hermesc 编译字节码 → 原生工程构建签名产物 → 按版本归档 bundle、.hbc、sourcemap、APK/IPA。

概念解释

发布构建与开发构建的差异:发布构建压缩、无调试代码、bundle 优化、签名。产物归档是线上崩溃还原的前提:每个版本的 bundle、.hbc、sourcemap 必须与版本号一一对应,否则线上崩溃栈无法还原。

常见错误:开发包直接当发布包发、sourcemap 没归档、版本号与构建号不一致。

原理流程

发布构建:
  → 锁文件安装依赖
  → Metro bundle(发布模式:压缩、无调试)
  → hermesc 编译 .hbc
  → 原生工程构建(签名)
  → 产物:APK/IPA + .hbc + sourcemap
  → 按版本号归档

代码或图示

产物 用途
APK/IPA 分发
.hbc 字节码运行
sourcemap 崩溃栈还原
bundle(调试用) 可选归档

常见误区

  • 用开发包测发布性能:开发包带调试,结果不可信。
  • sourcemap 不归档:线上崩溃栈无法还原。

追问

  • 怎么减小发布包?答:压缩、按需引入、移除调试代码、检查未用依赖。
  • 热更新/动态化要注意什么?答:JS bundle 动态下发受平台审核约束,按最新政策评估,不要默认允许。