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),展示两个版本之间的模板差异。流程上:
- 看 changelog,列出 breaking change 与废弃 API。
- 升级 package.json 里的 RN 与相关依赖。
- 用升级助手对比原生壳模板,把模板改动合入自己的原生工程。
- 重新 pod install / gradle sync。
- 处理不兼容的第三方库。
- 全量回归测试。
原理流程
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 重装。
概念解释
升级后构建失败的常见根因:
- JS 层:某个库的 imports 用了已废弃 API,或 Babel 配置与新版本不兼容。
- 原生壳层:模板改动没合入,导致 Podfile / Gradle 引用了不存在的路径。
- 依赖层:第三方库版本与新 RN 不兼容,或版本漂移。
- 配置层:配置字段改名/废弃,新架构开关位置变化。
排查顺序应该从最早失败的步骤开始: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 动态下发受平台审核约束,按最新政策评估,不要默认允许。