02.9 全端并行开发与工程协同
所属:全栈开发面试题库 / 学习路径 / 02 App 端开发
本页目录
一、什么情况下需要全端并行
「同时开发各端原生」不是一开始就做的事。它成立的前提是:
- 同一业务需要 Android、iOS、HarmonyOS,甚至小程序与 Web 同时存在。
- 版本节奏要求一致(例如营销活动必须同一周上线)。
- 已有两个以上端,且重复逻辑开始造成线上不一致。
如果只是「各端各自维护一个 App、版本互不相干」,不需要本页的复杂机制,各自的流水线就够。全端并行的成本主要在协同,不在编码。
二、三种组织模型
| 模型 | 结构 | 优点 | 缺点 | 适用 |
|---|---|---|---|---|
| 多仓各自建 | 每端一个仓库、一套 CI | 隔离干净、上手快 | 契约漂移、重复基建、跨端改动要改多处 | 每端 < 3 人、业务耦合低 |
| Monorepo | 一个仓放各端工程与共享包 | 契约同源、改动原子化、复用基建 | 仓库变大、CI 要按路径过滤 | 多端多团队、共享逻辑多 |
| 平台 + 特性团队 | 平台组维护基建,特性组按业务交付 | 责任清晰、基建不被业务拖累 | 沟通成本高、平台组易成瓶颈 | 组织规模 > 20 人 |
Monorepo 的常见布局:
apps/
android/
ios/
harmony/
miniapp/
packages/
contracts/ # OpenAPI / protobuf 与生成代码
design-tokens/ # 颜色、字号、间距、圆角
shared-domain/ # 共享业务规则(可选 KMP/TS)
tools/
ci/ # 流水线脚本与签名配置
CI 必须按路径过滤:改 apps/android/** 只跑 Android 流水线,改 packages/contracts/** 触发全端契约校验。
三、契约先行
全端并行的第一原则:先定契约,再写各端代码。没有契约,三端一定出现字段名、可空性、枚举值、时间格式不一致。
| 环节 | 做法 | 工具 | 产出 |
|---|---|---|---|
| 接口定义 | OpenAPI 3 或 protobuf,字段带示例与可空性 | Swagger Editor、Apifox、Buf | 契约文件 |
| 代码生成 | 各端生成模型与请求方法 | OpenAPI Generator、protoc、KSP | 不手写模型 |
| Mock | 契约生成 Mock 服务 | Mock Server、Apifox、WireMock | 各端可并行开发 |
| 契约校验 | CI 中比对契约与实现 | 契约测试、schema diff | 破坏性变更被拦截 |
| 版本管理 | 契约版本与 App 版本解耦 | 版本号 + 兼容规则 | 老客户端不被破坏 |
三条兼容规则:新增字段必须可选;枚举新增值各端要能降级;删除字段要先下线再删除。
四、设计系统与 Token
设计系统的目标不是「好看」,而是三端同一套语义:
| 层 | 内容 | 落地方式 |
|---|---|---|
| 基础 Token | 颜色、字号、行高、间距、圆角、阴影、动效时长 | JSON 源文件,生成各端主题 |
| 语义 Token | text-primary、bg-surface、border-danger |
业务只引用语义,不引用色值 |
| 组件 | 按钮、输入框、列表项、弹窗 | 各端各自实现,行为与状态对齐 |
| 模式 | 空态、加载、错误、骨架屏 | 统一文案与交互 |
| 平台适配 | 导航习惯、返回手势、控件形态 | 语义一致、形态随平台 |
生成链路:design-tokens/tokens.json → Style Dictionary → Compose Theme / SwiftUI Asset / ArkUI 资源 / CSS 变量。改色值只改一处,四端同时生效。
五、能力矩阵
同一功能在各端的能力并不对等。开工前先填这张表,能避免「按 Android 的方案排期,结果 iOS 做不出来」。
| 能力 | Android | iOS | HarmonyOS | 小程序 | 降级策略 |
|---|---|---|---|---|---|
| 后台保活 | 前台服务 + 白名单 | 系统限制强 | 后台任务受限 | 不支持 | 改为推送唤醒 |
| 小组件 | App Widget | WidgetKit | 服务卡片 | 不支持 | 端内入口替代 |
| 应用内更新 | 商店 + 自建 | 仅商店 | 商店 | 无 | 提示跳商店 |
| 支付 | 三方 + 商店 | IAP 强制 | IAPKit | 平台支付 | 按端配置 |
| 热更新 | 受限 | 禁止 | 受限 | 平台审核 | 只更新配置与资源 |
| 跨设备流转 | 有限 | 接力 | 分布式 | 无 | 端内同步 |
| 深链 | App Links | Universal Links | 应用链接 | 平台跳转 | 落地页兜底 |
这份矩阵同时是排期依据与产品预期管理工具:产品经理看到某端不支持,才会接受降级方案。
六、多产物流水线
一条流水线要同时产出多个端,关键是「共享阶段 + 端专属阶段」:
| 阶段 | 内容 | 是否共享 | 工具 |
|---|---|---|---|
| 静态检查 | 格式化、lint、类型检查 | 共享规则 | ktlint、SwiftLint、ESLint、ArkTS 检查 |
| 单元测试 | 各端测试 + 共享层测试 | 分端执行 | JUnit、XCTest、Jest、hypium |
| 契约校验 | schema diff、Mock 一致性 | 共享 | Buf、openapi-diff |
| 构建 | 各端产物 | 分端 | Gradle、xcodebuild、hvigor、Vite |
| 签名 | keystore、证书、Profile | 分端 | apksigner、Fastlane match、AGC |
| 分发 | 商店、TestFlight、内测 | 分端 | Play Console、ASC、AGC、蒲公英 |
| 归档 | 符号表、mapping、dSYM | 共享归档 | 对象存储 + 版本索引 |
流水线设计三条纪律:
- 版本号单一来源:由一个文件或一次提交决定,各端读取同一版本,避免三端版本号错位。
- 签名材料集中托管:不要放在 repo 明文里,用密钥管理或 CI 变量。
- 产物可追溯:每个包都能反查到 commit、契约版本、设计 Token 版本。
七、版本、灰度与回滚
| 机制 | 做法 | 注意 |
|---|---|---|
| 版本号 | 语义化 + 构建号,各端一致 | 商店对构建号有单调递增要求 |
| 特性开关 | 服务端下发,端内读取 | 开关要有默认值与过期清理 |
| 灰度 | 按用户百分比或白名单放量 | 三端灰度比例可不同,但指标要统一 |
| 指标看板 | 崩溃率、启动耗时、核心转化 | 没有统一指标就无法比较灰度效果 |
| 回滚 | 关闭开关 / 回退版本 / 热修配置 | 已发布版本无法真回滚,只能靠开关 |
| 强制更新 | 版本门槛由服务端控制 | 留出老版本兼容期 |
八、三端同步开发的实操流程
以一个「订单列表 + 详情」需求为例,三端并行的正确顺序:
- 需求拆解:产品给出页面清单与状态(空态、加载、错误、无权限),三端共用一份。
- 契约定义:后端与客户端一起定 OpenAPI,确定分页、排序、字段可空性。
- 设计交付:Figma 出三端标注,Token 进入
design-tokens。 - 能力矩阵确认:确认三端是否都支持该交互,不支持的写降级方案。
- 并行实现:三端各自按同一契约与 Token 开发,用 Mock 联调。
- 联调对齐:统一时间格式、金额精度、空值展示、错误文案。
- 回归验收:用同一份验收清单跑三端,指标同口径。
- 灰度发布:按同一开关逐步放量,观察统一指标。
最容易出错的三处:时间与时区、金额与精度、空值与错误文案。这三项必须在契约层写死,不能各端「看着办」。
九、质量门禁
| 门禁 | 阈值(示例,按业务调整) | 采集方式 |
|---|---|---|
| 崩溃率 | < 0.3%(可崩溃用户占比) | Crashlytics/Bugly/Sentry/AGC |
| ANR 率 | < 0.5% | Android vitals / 自建 |
| 冷启动 | 中端机 < 1.5s 到首帧 | 端内埋点 + 性能平台 |
| 页面卡顿 | 掉帧率 < 5% | 帧率采样 |
| 包体 | 增量 < 5MB / 版本 | 产物分析 |
| 接口成功率 | > 99.5% | APM + 网关指标 |
| 崩溃符号化率 | > 95% | 符号上传校验 |
门禁的意义是阻止带着已知劣化发布,不是追求数字好看。阈值要在项目初期定,后期只做收紧。
十、常见坑
| 现象 | 真实原因 | 纠正动作 |
|---|---|---|
| 三端字段名不一致 | 手写模型,没有契约生成 | 强制 codegen,禁止手写 DTO |
| 三端版本号错位 | 版本号各端各写 | 单一版本源 + CI 校验 |
| 改一个色值要改四处 | 没有 Token 层 | 建 Token 生成链路 |
| 灰度指标不可比 | 各端埋点口径不同 | 统一事件模型与字段定义 |
| Monorepo CI 越来越慢 | 没有按路径过滤 | 路径触发 + 远程缓存 |
| 老版本被新接口打挂 | 契约破坏性变更 | 兼容规则 + 契约测试 |