| name | mobile-ota |
| description | 推 mobile JS 改动到生产 (OTA, eas update)。当用户说「发 OTA」「推 OTA」「JS 改动上线手机」「热更新移动端」时使用。只发 iOS bundle;原生/插件/SDK 改动不能 OTA,走 mobile-testflight-release。 |
Mobile OTA
.ts/.tsx/.js/样式/文案/API 调用/hooks/RN 组件 的改动,走 OTA(秒级生效,不用重 build/发版)。
先判断:能 OTA 吗?
✅ 能 OTA:纯 JS/TS、RN 组件、navigation、React Query、状态、样式、文案、API 调用。
❌ 不能 OTA(必须 build,走 mobile-testflight-release):app.json plugins / Info.plist / Podfile / 新 native module / Expo SDK 升级 / expo-* 大版本。
推
cd "$(git rev-parse --show-toplevel)"
./scripts/mobile-ota.sh production "改动说明"
脚本 = eas update --platform ios --channel <channel>。只发 iOS(react-native-maps 会炸 web bundler,Android 也没分发)。
快速路径
- 先确认改动确实包含
mobile/ 或 packages/shared/ 运行树；没有 Mobile 运行树变化就不要发 OTA。
- 优先从当前 canonical main 工作区发布；脚本会按 Mobile/shared 相关树判断 dirty 和 origin/main 等价性，无关的未跟踪文件不值得为此重新 clone。
- 若必须使用 clean release checkout，先比较两边
mobile/package-lock.json。锁文件完全一致且原工作区 mobile/node_modules 可用时，可复用该依赖目录；只有缺失或 lock 不一致时才执行 npm ci。禁止无条件重装 1300+ 包。
- 后端与 Mobile 同时改动时，后端部署期间可以准备 clean checkout、校验 lock 和依赖，但必须等后端健康门通过后才能发布 OTA。
- OTA 脚本已经复用一次 Hermes export，并对网络/资产处理失败做有界重试；不要在外层再套无界重试或重复 bundle。
关键坑
- OTA 打包的是工作树(working tree),不是 HEAD。未提交的 WIP 会漏进生产 OTA。先 commit 或移出 WIP 再推；以脚本的 source/dirty-worktree guard 为准。
- 设备拉取时机:cold start 或退后台 30s+ 才拉新 bundle。下拉刷新只重取数据,不换 bundle——验证 OTA 生效要杀进程重开。
- runtime version 必须匹配(
app.json runtimeVersion policy=appVersion);跨 runtime 的改动 OTA 推不动,要发新 build。
npx 必须使用脚本锁定的 eas-cli@22.0.0；npm cache 命中时不得额外安装全局 CLI。- channels:
development(dev client / sim 允许)· preview(内部分发)· production(App Store,见 mobile/eas.json)。
和后端配套
涉及前后端的功能:两条都走 —— 后端 backend-deploy(路由生效)+ 移动端 OTA(渲染代码)。漏任一条 → 手机看到旧行为或「加载失败」。本会话踩过:合并了没部署 + 没 OTA → 功能不可用。
改了后端 schema → 先 cd mobile && npm run generate-types 再 OTA(防手写类型漂移)。
