罗罗编程学习记录 全栈面试题库
本页导航 展开查看

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 版本。

七、版本、灰度与回滚

机制 做法 注意
版本号 语义化 + 构建号,各端一致 商店对构建号有单调递增要求
特性开关 服务端下发,端内读取 开关要有默认值与过期清理
灰度 按用户百分比或白名单放量 三端灰度比例可不同,但指标要统一
指标看板 崩溃率、启动耗时、核心转化 没有统一指标就无法比较灰度效果
回滚 关闭开关 / 回退版本 / 热修配置 已发布版本无法真回滚,只能靠开关
强制更新 版本门槛由服务端控制 留出老版本兼容期

八、三端同步开发的实操流程

以一个「订单列表 + 详情」需求为例,三端并行的正确顺序:

  1. 需求拆解:产品给出页面清单与状态(空态、加载、错误、无权限),三端共用一份。
  2. 契约定义:后端与客户端一起定 OpenAPI,确定分页、排序、字段可空性。
  3. 设计交付:Figma 出三端标注,Token 进入 design-tokens。
  4. 能力矩阵确认:确认三端是否都支持该交互,不支持的写降级方案。
  5. 并行实现:三端各自按同一契约与 Token 开发,用 Mock 联调。
  6. 联调对齐:统一时间格式、金额精度、空值展示、错误文案。
  7. 回归验收:用同一份验收清单跑三端,指标同口径。
  8. 灰度发布:按同一开关逐步放量,观察统一指标。

最容易出错的三处:时间与时区、金额与精度、空值与错误文案。这三项必须在契约层写死,不能各端「看着办」。

九、质量门禁

门禁 阈值(示例,按业务调整) 采集方式
崩溃率 < 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 越来越慢 没有按路径过滤 路径触发 + 远程缓存
老版本被新接口打挂 契约破坏性变更 兼容规则 + 契约测试