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

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 共享层单测优先 测试

五、共享层边界与平台接入

共享层的边界决定项目成败。三条判断标准:

  1. 能共享的:数据模型、接口定义、序列化、校验、业务规则、缓存策略、状态机、埋点协议。
  2. 不该共享的:UI、导航、权限弹窗、系统能力调用、平台特有的交互习惯。
  3. 必须抽象的:存储路径、日志、时钟、随机数、设备信息、加密能力——通过 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 仓库 共享库版本化

八、官方文档与学习资源

  1. Kotlin Multiplatform 官方文档
  2. KMP 快速开始
  3. expect/actual 与源集
  4. iOS 集成方式
  5. Ktor Client
  6. SQLDelight
  7. kotlinx.coroutines
  8. kotlinx.serialization
  9. Compose Multiplatform
  10. Kotlin 官方文档
  11. 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 版本矩阵不兼容 固定版本组合,升级前跑全量构建