02.8 KMP 跨平台路线
所属:全栈开发面试题库 / 学习路径 / 02 App 端开发
本页目录
一、路线定位
KMP(Kotlin Multiplatform)不是「再造一个 Flutter」,它的定位是 共享逻辑,保留原生 UI:
- 共享层放网络、数据模型、校验规则、业务用例、缓存策略,用 Kotlin 写一次。
- UI 仍由 Android Compose 与 iOS SwiftUI 各自实现,观感与系统能力不受损。
- 也可以选 Compose Multiplatform,把 UI 一起共享,但 iOS 侧的成熟度与体验需要实测。
这条路线最适合已有原生双端团队、被重复业务逻辑拖累的场景。它不适合零基础:expect/actual、源集、Gradle 多目标、iOS framework 导出这些机制,要求你同时懂 Kotlin、Gradle 与 iOS 构建。
适合谁:Android 团队想消除双端重复逻辑;iOS 团队愿意接 Kotlin 共享层;需要逐步迁移而不是整体替换的存量项目。不适合:只有前端背景、想在短期内独立交付双端的人(先走 Flutter 或 RN 更现实)。
二、阶段划分
| 阶段 | 主题 | 关键内容 | 产出 | 参考学时(全职) |
|---|---|---|---|---|
| K0 | Kotlin 与 Gradle | 协程、序列化、多模块、版本目录 | 可构建的多模块工程 | 2 周 |
| K1 | KMP 工程 | 源集结构、目标配置、expect/actual、依赖声明 | 双端可调用的共享模块 | 3 周 |
| K2 | 共享数据层 | Ktor、序列化、SQLDelight、缓存与同步 | 共享 Repository | 4 周 |
| K3 | 共享领域层 | 用例、校验、状态机、错误建模 | 可测试的领域层 | 3 周 |
| K4 | 平台接入 | Android 接入、iOS framework/XCFramework、SPM/CocoaPods | 双端跑通同一业务 | 4 周 |
| K5 | UI 共享(可选) | Compose Multiplatform、资源、主题、导航 | 共享 UI 版本 | 5 周 |
| K6 | 工程与发布 | 构建产物、CI、版本发布、崩溃符号化 | 可发布的共享库 | 3 周 |
合计约 21 周(不含 UI 共享)。已熟悉 Kotlin 与 Android 可压缩到 14–16 周。
三、知识点地图
| 模块 | 知识点 | 掌握程度 |
|---|---|---|
| 工程 | 源集(commonMain/androidMain/iosMain)、目标声明、层级结构 | 能讲清原理 |
| 工程 | expect/actual 的匹配规则与限制 | 能讲清原理 |
| 工程 | Gradle 多目标构建、变体、发布配置 | 会用 |
| 语言 | 协程与 Flow 跨平台行为、调度器差异 | 能讲清原理 |
| 语言 | kotlinx.serialization、datetime、atomicfu | 会用 |
| 网络 | Ktor Client 引擎选择(OkHttp/Darwin)、拦截器 | 能讲清原理 |
| 数据 | SQLDelight schema、查询、迁移、驱动差异 | 能用 |
| 数据 | 缓存策略、离线优先、冲突处理 | 能讲清原理 |
| 领域 | 用例分层、错误类型、结果封装 | 会用 |
| 接入 | iOS framework 导出、XCFramework、SPM 与 CocoaPods | 能讲清原理 |
| 接入 | Android 模块依赖、ProGuard 规则 | 会用 |
| 互操作 | Objective-C/Swift 调用限制、SKIE 改善体验 | 了解 |
| UI 共享 | Compose Multiplatform 渲染、资源、主题、导航 | 了解 |
| 质量 | commonTest、平台测试、CI 矩阵 | 会用 |
| 发布 | 版本号、制品发布、符号上传 | 会用 |
四、技术栈与常用框架
| 领域 | 首选 | 备选 | 说明 | 文档 |
|---|---|---|---|---|
| 构建 | Gradle + Version Catalog | — | 多目标工程必须统一版本 | KMP 文档 |
| 网络 | Ktor Client | 平台原生网络封装 | 引擎按平台切换,接口统一 | Ktor |
| 序列化 | kotlinx.serialization | Moshi(Android 侧) | 编译期生成,跨平台一致 | 序列化 |
| 并发 | kotlinx.coroutines | 平台回调封装 | Flow 作为统一数据流 | 协程 |
| 数据库 | SQLDelight | Room KMP、Realm | SQL 优先、可生成类型安全查询 | SQLDelight |
| 键值 | multiplatform-settings | 平台封装 | 统一 Key-Value 接口 | multiplatform-settings |
| 依赖注入 | Koin | 手动容器 | Koin 跨平台支持好 | Koin |
| 日志 | Kermit | 平台封装 | 统一日志与级别 | Kermit |
| 时间 | kotlinx-datetime | 平台 API | 统一时区与格式化 | datetime |
| UI(可选) | Compose Multiplatform | 原生 UI | iOS 侧需实测性能与体验 | CMP |
| iOS 互操作 | SKIE | 原生导出 | 改善 suspend/Flow 的 Swift 体验 | SKIE |
| 测试 | kotlin.test + 平台测试 | Turbine | 共享层单测优先 | 测试 |
五、共享层边界与平台接入
共享层的边界决定项目成败。三条判断标准:
- 能共享的:数据模型、接口定义、序列化、校验、业务规则、缓存策略、状态机、埋点协议。
- 不该共享的:UI、导航、权限弹窗、系统能力调用、平台特有的交互习惯。
- 必须抽象的:存储路径、日志、时钟、随机数、设备信息、加密能力——通过 expect/actual 或接口注入。
iOS 接入的两种方式:
| 方式 | 做法 | 适用 | 注意 |
|---|---|---|---|
| 直接导出 framework | Gradle 生成 Shared.framework |
小团队快速接入 | 需处理架构(arm64/simulator)合并 |
| XCFramework + SPM | 发布二进制包,Swift Package 引用 | 多团队、版本化管理 | 需固定发布流程与符号 |
六、架构模式与设计选型
| 模式 | 共享范围 | 适用 | 代价 |
|---|---|---|---|
| 共享数据层 | 网络 + 模型 + Repository | 默认推荐,风险最低 | UI 仍双份 |
| 共享领域层 | 再加用例与状态 | 业务规则复杂的项目 | 需要清晰的领域建模 |
| 共享状态层 | 再加 ViewModel 等价物 | 想统一状态逻辑 | 与平台生命周期对接需适配 |
| 共享 UI | Compose Multiplatform | 人力极紧、UI 不复杂 | iOS 体验与生态风险 |
实践建议:从数据层开始共享,跑通一个完整业务后再扩展到领域层。一次性把 UI 也搬过去,通常会在动画、输入法、无障碍这些细节上返工。
七、设计软件与工具链
| 用途 | 工具 | 说明 |
|---|---|---|
| IDE | IntelliJ IDEA / Android Studio + KMP 插件 | 共享层开发与多目标配置 |
| iOS 侧 | Xcode | framework 接入与调试 |
| 设计稿 | Figma、Sketch、MasterGo | 双端各自实现 UI 时共用一套标注 |
| 设计规范 | Material 3 + HIG | 共享逻辑不等于共享观感 |
| 调试 | Android Studio 调试器、Xcode LLDB | 跨语言断点需分别设置 |
| 构建 | Gradle 任务 + xcodebuild | CI 需要 macOS 节点构建 iOS 产物 |
| 依赖发布 | Maven 仓库、SPM 仓库 | 共享库版本化 |
八、官方文档与学习资源
- Kotlin Multiplatform 官方文档
- KMP 快速开始
- expect/actual 与源集
- iOS 集成方式
- Ktor Client
- SQLDelight
- kotlinx.coroutines
- kotlinx.serialization
- Compose Multiplatform
- Kotlin 官方文档
- KMP 测试
九、出口验收
- [ ] 能解释源集结构与 expect/actual 的匹配规则,能自己新增一个平台实现。
- [ ] 能用 Ktor + 序列化搭出共享网络层,并在双端复用。
- [ ] 能用 SQLDelight 完成建表、查询、迁移,双端行为一致。
- [ ] 能把共享层导出为 iOS framework 并在 Swift 中调用。
- [ ] 能写共享层单测,并在 CI 上跑双平台测试。
- [ ] 能说清哪些能力必须留在平台侧,并给出抽象方式。
- [ ] 能回答 07.2.3 Kotlin Multiplatform 中的主要题目。
十、常见坑
| 现象 | 真实原因 | 纠正动作 |
|---|---|---|
| iOS 编译找不到 framework | 架构不匹配或未合并模拟器切片 | 用 XCFramework 或配置 universal framework |
| 共享层在 iOS 上崩溃 | 使用了 JVM 专有 API | 检查 commonMain 只依赖多平台库 |
| 协程在主线程阻塞 | 调度器未按平台配置 | 明确 Dispatchers 与平台主线程映射 |
| 数据库行为不一致 | 驱动或 SQL 方言差异 | 用 SQLDelight 生成查询,避免手写方言 |
| 包体变大 | 共享层引入大量传递依赖 | 裁剪依赖,检查导出符号 |
| 版本升级后编译失败 | Kotlin/AGP/Xcode 版本矩阵不兼容 | 固定版本组合,升级前跑全量构建 |