07.2.3.2 Compose Multiplatform、发布与选型
所属:全栈开发面试题库 / 07 端侧与桌面开发 / 07.2 跨平台移动开发 / 07.2.3 Kotlin Multiplatform
版本前提:Kotlin 2.x、Compose Multiplatform 1.7.x;Web(Wasm)目标与部分组件成熟度属快速演进内容,版本敏感项标注「待确认」并给出验证点。
本节要解决的问题
本节覆盖 Compose Multiplatform(CMP)的能力边界、iOS/桌面/Web 表现、资源与多语言、性能与包体积、各端发布流程,以及从 KMP 视角的跨端选型结论。面试重点是「哪些 UI 能跨端复用、哪些仍需平台特化、什么项目适合走 CMP/KMP、什么项目应留在原生」。版本基线为 CMP 1.7.x,具体组件稳定性以官方文档为准。
07.2.3.2-001 Compose Multiplatform 是什么,与 Jetpack Compose 是什么关系?
一句话结论
CMP 是 JetBrains 基于 Compose 运行时扩展的多平台 UI 框架:复用 Compose 的声明式状态模型、组合与重组机制,把渲染与输入适配到 iOS、桌面、Web 等目标;Android 上仍使用 Jetpack Compose。
概念解释
Jetpack Compose 是 Android 官方 UI 工具包,运行在 Android 视图体系之上。CMP 共享 Compose 编译器、状态与组合核心,平台层替换渲染后端与输入事件。同一套 @Composable 代码可在多端运行,但平台组件、手势与系统交互仍有差异。KMP 只共享逻辑层时不依赖 CMP;要共享 UI 才引入 CMP。
原理流程
- 公共 UI 代码用 Compose 声明式 API 编写。
- 编译器处理组合函数与状态追踪。
- 各 target 平台层把组合结果交给对应渲染后端。
代码或图示
@Composable
fun Greeting(name: String) {
Text("Hello, $name")
}
常见误区
- 以为 CMP 就是 Jetpack Compose 改个名字:Android 链路不变,其他目标由 CMP 适配。
- 以为用了 KMP 就必须用 CMP:逻辑共享与 UI 共享是两条独立路线。
追问
- CMP 与 Kotlin Multiplatform 版本如何对齐?答:CMP 与 Kotlin 编译器版本配套发布,版本矩阵以官方说明为准;升级 Kotlin 时需同步核对 CMP 兼容版本(待确认)。
07.2.3.2-002 CMP 覆盖哪些平台目标?
一句话结论
CMP 覆盖 Android、iOS、桌面(JVM)、Web(Wasm/JS)等目标;各目标成熟度不同,Android 最稳,iOS 与桌面可用,Web 目标仍在快速演进。
概念解释
Android 走 Jetpack Compose;iOS 由 CMP 渲染层接入 UIKit/SwiftUI 宿主;桌面目标基于 JVM 窗口体系;Web 目标编译到 Wasm/JS。目标稳定性分级随版本变化:稳定目标可进生产,实验目标需试点验证。选型时先确认目标矩阵与官方稳定性标注,不按演示效果判断生产可用性。
原理流程
- 列出产品需要覆盖的端。
- 核对各端 CMP 目标的官方稳定性与已知限制。
- 试点工程跑通核心页面后再决定全量推广。
代码或图示
Android Jetpack Compose(稳定)
iOS CMP 宿主接入
Desktop JVM 窗口
Web Wasm/JS(成熟度待确认)
常见误区
- 把演示 Demo 的跨端效果等同于生产就绪。
- 忽略 Web 目标在浏览器兼容性与性能上的限制。
追问
- 怎么查某目标是否稳定?答:看 CMP 官方文档的目标状态标注与发行说明;在试点工程覆盖核心交互,记录未解决问题后再立项(待确认当前分级)。
07.2.3.2-003 哪些 Compose 组件在 common 层通用?
一句话结论
基础布局、文本、按钮、图标、状态与动画等核心组件在 common 层可用;Material 组件覆盖度逐版本扩大,复杂系统组件与平台专属控件仍需平台特化或等待生态补齐。
概念解释
common 层可复用:Box、Column、Row、Text、Button、Icon、Image、Spacer、Modifier、状态提升与基础动画。Material 3 组件在 CMP 的覆盖范围随版本扩展;日期选择器、下拉菜单、对话框等组件的跨端一致性需要逐页验证。平台原生控件(地图、WebView、支付控件)不进 common。
原理流程
- 梳理页面用到的组件清单。
- 逐个核对 CMP 组件库是否提供跨端实现。
- 缺失组件用平台宿主嵌入或自研组合封装。
代码或图示
Column {
Text("标题")
Button(onClick = {}) { Text("确认") }
}
常见误区
- 假设 Android 上可用的 Material 组件在 iOS 表现完全一致。
- 把平台 SDK 组件直接写进 common 组合函数。
追问
- 组件缺失时的兜底路径?答:简单控件用基础组件自封装;复杂平台控件在宿主页面嵌入原生组件,通过接口与共享层通信。
07.2.3.2-004 哪些 UI 能力在 CMP 中仍需平台特化?
一句话结论
系统级控件、平台导航与手势规范、设备硬件能力、平台主题与系统交互仍需平台特化;common 层只保留跨端一致的组合逻辑与基础控件。
概念解释
需要特化的典型项:地图、相机、WebView、支付与登录 SDK、推送与权限流程、底部导航/返回手势、安全区与系统栏适配、平台字体与图标规范。这些能力绑定平台 SDK 或交互规范,强行公共化会造成体验分裂。工程上用 expect/actual、平台源集或原生宿主页面承载。
原理流程
- 标注每个页面能力是否依赖平台 SDK 或系统规范。
- 公共可复用部分下沉 common,平台部分留在宿主。
- 两侧通过数据模型与事件接口通信。
代码或图示
公共:列表、表单、按钮、状态展示
特化:地图、相机、WebView、支付、系统导航手势
常见误区
- 把平台 SDK 包装成 common 组件,接口泄漏原生类型。
- 为追求复用牺牲双端交互规范一致性。
追问
- 怎么界定「可公共化」?答:组件输入输出为公共模型、不调用平台 SDK、交互规范双端可接受;任一不满足就留在平台侧。
07.2.3.2-005 平台专属 API 在 CMP 工程中如何使用?
一句话结论
通过平台源集、expect/actual 或原生宿主嵌入使用平台 API;公共组合函数只依赖抽象接口,平台实现按 target 提供。
概念解释
Compose 代码分 commonMain 与平台 main:平台专属逻辑写在对应源集,common 定义接口或 expect 声明。复杂原生视图在宿主页面嵌入,CMP 页面与原生页面互操作。直接在 common 组合函数引用 Android/iOS API 会导致其他 target 编译失败。
原理流程
- common 定义能力接口与数据模型。
- 平台 main 实现接口或嵌入原生视图。
- 组合层通过注入接口调用,不接触平台类型。
代码或图示
interface LocationProvider {
suspend fun current(): GeoPoint?
}
常见误区
- common 组合函数里
if (android)分支调用平台 API。 - 平台视图与 CMP 页面之间不定义通信协议。
追问
- 原生页面如何复用共享层状态?答:原生页面通过 DI 取共享 ViewModel/仓库,数据模型与事件协议在 common 定义,UI 各自实现。
07.2.3.2-006 CMP 各平台渲染后端有什么差异?
一句话结论
Android 走 Compose 既有渲染管线,iOS/桌面/Web 由 CMP 提供对应后端;渲染一致性受后端实现与组件覆盖度影响,不能假设像素级双端一致。
概念解释
Compose 的组合与状态层跨端复用,绘制层按平台适配:Android 已有成熟渲染体系;其他目标通过 CMP 后端把绘制指令交给平台图形栈。字体度量、圆角、阴影、触摸命中与滚动行为可能存在差异。设计评审需要在真机上逐端核对,不能只看代码或单一平台预览。
原理流程
- 公共组合函数描述 UI 状态与结构。
- 各后端把组合指令转为本端绘制与事件。
- 真机逐端核对样式、手势与布局差异。
代码或图示
Compose 组合/状态层(公共)
→ Android 渲染管线
→ iOS 图形适配
→ 桌面/Wasm 后端
常见误区
- 只在 Android 预览确认 UI,上线后 iOS 样式偏移。
- 认为后端差异只影响性能,不影响视觉与手势。
追问
- 差异怎么纳入验收?答:建立双端视觉走查清单,关键页面截图对比;样式差异在公共组件层收敛,无法收敛的平台适配在宿主层处理。
07.2.3.2-007 状态与重组机制在 CMP 中是否一致?
一句话结论
组合状态、remember、状态提升与重组触发机制在公共层一致;差异只在后端事件投递与帧调度,公共代码按 Compose 状态规则编写即可。
概念解释
CMP 复用 Compose 编译器与运行时:状态读取触发订阅,状态变化调度重组。mutableStateOf、remember、LaunchedEffect、派生状态在 common 可用。各端帧刷新与输入事件投递由平台后端完成;公共层不应假设具体线程或绘制时机。
原理流程
- 状态持有在公共 ViewModel/组合层。
- 状态变化触发订阅节点重组。
- 后端按平台帧节奏提交绘制。
代码或图示
var count by remember { mutableStateOf(0) }
Button(onClick = { count++ }) { Text("点击 $count") }
常见误区
- 在组合函数里写副作用而不走 effect API。
- 把平台线程假设带入状态更新逻辑。
追问
- 重组性能问题跨端通用吗?答:状态拆分、稳定类型、避免不必要读取等原则通用;具体掉帧测量按各端性能工具进行。
07.2.3.2-008 Material 组件在 CMP 的覆盖情况如何?
一句话结论
基础 Material 组件覆盖较广,复杂交互组件(选择器、菜单、弹窗、导航组件)的覆盖度与一致性逐版本完善;落地前必须按实际页面组件清单逐项验证。
概念解释
CMP 组件库跟踪 Material 设计规范,但不是 Android Material 全量移植。文本、按钮、图标、卡片等基础组件可用;下拉菜单、日期时间选择、底部导航、抽屉、对话框等需要核对版本支持与样式差异。第三方 Compose 库也要检查是否提供多平台构件。
原理流程
- 从设计稿提取组件清单。
- 核对 CMP 组件库版本内的可用性与平台表现。
- 缺失组件自封装或平台嵌入,记录缺口。
代码或图示
可用度高:Text、Button、Icon、Card、Column/Row
需验证:Menu、DatePicker、NavigationBar、Dialog
常见误区
- 直接抄 Android 项目的 Material 组件导入,其他目标解析失败。
- 组件在某端能显示即认为交互完整,漏测键盘、焦点与关闭手势。
追问
- 第三方 Compose 库怎么判断可用?答:查其是否发布多平台构件、声明哪些 target;在试点页引入并编译各端,不能只看 JVM/Android 可用。
07.2.3.2-009 第三方 Compose 库的跨平台可用性如何判断?
一句话结论
看库是否发布 KMP 构件、声明支持的 target,并在各端编译运行验证;只在 Android/JVM 发布的库不能进 commonMain。
概念解释
Compose 库分纯公共组件、Android 专属与多平台三类。判断顺序:Maven 构件列表 → README target 说明 → 试点工程各端编译与交互。图片加载、图标、图表、动画库是常见缺口;平台专属库可在宿主侧使用,不进公共 UI 模块。
原理流程
- 查库坐标与构件覆盖的 target。
- 试点页引入并跑通 Android、iOS、桌面等目标。
- 记录不可用功能,准备自封装或替代库。
代码或图示
可用:多平台构件 + 目标声明 + 试点验证通过
不可用:仅 JVM/Android 构件,或核心 API 绑定平台 SDK
常见误区
- 看到库基于 Compose 编写就默认跨端可用。
- 只编译通过,未验证手势、动画与资源加载。
追问
- 关键库缺口怎么决策?答:评估自封装成本与替代库;缺口集中在复杂交互时,重新评估该页面是否留在原生实现。
07.2.3.2-010 CMP 中的导航方案现状如何?
一句话结论
跨端导航需要在公共层抽象路由与状态,具体导航组件按目标选择;Android 可用 Navigation 类库,iOS/桌面/Web 需核对 CMP 导航方案成熟度,避免绑定单端导航框架。
概念解释
导航涉及页面栈、返回手势、深链接与系统栏。公共层可定义路由表、页面状态与事件;平台宿主选择本端导航容器。直接在 common 引入 Android Navigation 会破坏其他 target。导航方案与组件库版本演进较快,选型前在试点工程验证路由、返回与深链接(待确认)。
原理流程
- common 定义路由、参数与导航事件。
- 平台宿主挂载对应导航容器。
- 页面状态变化经公共 ViewModel 驱动。
代码或图示
sealed class Route {
data class Detail(val id: String) : Route()
}
常见误区
- common 层直接使用单端 Navigation 组件。
- 导航状态只存在平台容器,公共层无法复用业务编排。
追问
- 多端返回手势如何统一?答:公共层定义返回事件,平台宿主接系统返回手势/返回键后回调;CMP 页面内部返回栈由公共状态管理。
07.2.3.2-011 图片加载与异步资源在 CMP 中如何处理?
一句话结论
图片加载需要多平台图片库或平台适配层;公共层定义图片模型与加载状态,平台引擎负责下载、缓存与解码,避免在 common 绑定 Android 图片库。
概念解释
图片链路涉及网络下载、内存/磁盘缓存、解码与占位图。Android 常用图片库多为 JVM/Android 专属;CMP 生态有多平台图片组件或需平台封装。公共组件接收 URL、尺寸与占位状态,具体加载器在平台 main 装配。Web 图片还受浏览器缓存与解码限制。
原理流程
- common 定义图片参数与加载状态。
- 平台 main 接入多平台图片库或本端加载器。
- 组合层按状态渲染占位、图片与错误态。
代码或图示
@Composable
fun Avatar(url: String, modifier: Modifier)
常见误区
- commonMain 引入 Android 图片加载库。
- 大图直接全尺寸解码,各端内存峰值过高。
追问
- 缓存策略跨端一致吗?答:公共层定义缓存键与尺寸规范,各端实现可不同;列表滚动的缩略图尺寸需在公共模型中约定。
07.2.3.2-012 输入、键盘与焦点在多端有哪些差异?
一句话结论
文本输入基础能力跨端可用,但键盘类型、IME 行为、焦点导航、光标与粘贴交互存在平台差异;表单逻辑可公共化,键盘与焦点细节在平台层适配。
概念解释
TextField、状态绑定与校验规则可在 common 复用。差异点:弹出键盘的高度与遮挡、数字/密码键盘类型、自动填充、焦点顺序、桌面 Tab 焦点导航、Web 表单提交键。表单校验与错误提示公共化,键盘行为在宿主或平台源集处理。
原理流程
- 公共层持有表单状态、校验规则与错误文案。
- 平台层配置键盘类型与 IME 行为。
- 真机逐端验证输入、纠错与提交路径。
代码或图示
var name by remember { mutableStateOf("") }
TextField(value = name, onValueChange = { name = it })
常见误区
- 假设键盘弹出不会遮挡输入框,未做底部适配。
- 桌面/Web 忽略焦点顺序与键盘快捷键。
追问
- 表单提交按钮在各端如何触发?答:公共层暴露提交方法,移动端由按钮/IME 动作触发,桌面/Web 由按钮与回车事件触发。
07.2.3.2-013 对话框、弹窗等系统交互如何跨端适配?
一句话结论
基础弹层可在公共组件层封装,系统权限、分享、相册选择等交互走平台宿主;弹窗层级、返回手势与安全区需在真机逐端核对。
概念解释
自定义 Dialog/BottomSheet 类组件的跨端支持度按版本核对;系统级交互(权限弹窗、分享面板、图片选择器、相机)是平台 SDK 能力。公共层定义弹窗状态与结果回调,平台宿主调用系统组件。弹层在 iOS 与桌面的层级、关闭手势、焦点逃逸行为不同。
原理流程
- 区分自定义弹层与系统交互。
- 公共层管理弹窗可见状态与结果事件。
- 平台宿主接入系统组件并回调公共层。
代码或图示
var showConfirm by remember { mutableStateOf(false) }
常见误区
- 把系统权限流程写进 common 组合函数。
- 弹层只测 Android,漏测 iOS 关闭手势与桌面焦点。
追问
- 弹窗状态如何与页面生命周期绑定?答:状态放在公共 ViewModel 或组合状态,页面退出时复位;系统交互结果通过单次回调返回,避免重复消费。
07.2.3.2-014 动画与自定义绘制能力的可移植性如何?
一句话结论
基础动画、AnimatedVisibility、属性动画与 Canvas 绘制在公共层可用;复杂图形、滤镜与平台渲染特性需按后端能力验证,不假设各端绘制结果一致。
概念解释
Compose 动画 API 与 Canvas 指令跨端复用:补间动画、淡入淡出、尺寸动画可公共化。差异在图形后端能力:抗锯齿、渐变、阴影、路径裁剪与硬件加速表现可能不同。游戏化、重度自定义绘制页面需要在目标端实测帧率与视觉效果。
原理流程
- 公共层使用标准动画与 Canvas API。
- 各后端提交绘制指令到本端图形栈。
- 真机核对动画流畅度与视觉一致性。
代码或图示
AnimatedVisibility(visible = expanded) {
Text("展开内容")
}
常见误区
- 依赖某端独有的绘制效果,其他目标降级或报错。
- 动画时长与插值器未在公共层固定,各端节奏不一。
追问
- 动画卡顿怎么定位?答:先拆重组频率与状态读取,再看后端绘制耗时;复杂页面用各端性能工具测量帧时长,不凭主观感受判断。
07.2.3.2-015 平台主题与深色模式如何跨端处理?
一句话结论
颜色、字号、间距在公共主题中定义,深色模式跟随系统状态;平台字体、品牌色与系统栏外观在宿主层适配,公共层不硬编码平台主题。
概念解释
Compose 主题把颜色、形状、排版集中为 MaterialTheme 数据。公共层提供浅色/深色主题与自定义品牌色;读取系统深色模式状态由平台后端提供。字体家族、字号度量与状态栏颜色属平台适配项。设计令牌应先在公共层统一,再映射到各端规范。
原理流程
- 公共层定义颜色、字体、间距令牌。
- 按主题状态选择配色方案。
- 平台宿主处理系统栏、字体与原生页面外观。
代码或图示
MaterialTheme(colorScheme = if (dark) DarkColors else LightColors) {
Content()
}
常见误区
- 组合函数内散落硬编码颜色,无法切换主题。
- 公共层直接读取平台系统主题 API。
追问
- 品牌色与系统主题冲突时怎么办?答:公共层定义品牌色覆盖项,深色模式单独调色板;原生页面在宿主层同步品牌色与系统栏外观。
07.2.3.2-016 CMP 与原生 UI 如何混排?
一句话结论
两种方式:在原生页面宿主中嵌入 CMP 组合节点,或在 CMP 页面中嵌入原生视图;边界用数据模型与事件接口通信,状态归属公共 ViewModel。
概念解释
混排适合渐进迁移:存量原生页面保留,新页面用 CMP,局部复用原生组件。Android 用 Compose 互操作容器;iOS 通过 CMP 提供的宿主视图接入。跨边界不要直接传原生对象,页面间导航与生命周期在宿主层协调。
原理流程
- 划定 CMP 页面、原生页面与嵌入组件边界。
- 公共层共享状态与业务规则。
- 宿主负责容器、导航与生命周期分发。
代码或图示
原生页面 → 宿主容器 → CMP 组合节点
CMP 页面 → 平台嵌入槽位 → 原生视图
常见误区
- 跨边界直接持有原生控件引用。
- 状态分别在两侧维护,出现双份数据源。
追问
- 混排页面的返回栈怎么管理?答:宿主维护顶层导航,CMP 内部页面栈通过公共状态暴露;系统返回手势交宿主统一处理。
07.2.3.2-017 Android 工程中如何嵌入 CMP 模块?
一句话结论
Android app 依赖共享 UI 模块,在 Activity/Fragment 中用 Compose 容器承载公共组合函数;Android 专属能力仍在 app 模块或 androidMain 实现。
概念解释
Android 目标本身是 Jetpack Compose,CMP 公共 UI 可直接在 Compose 宿主中使用。模块结构:commonMain 放公共组合与状态,androidMain 放 Android 适配。既有 ViewModel、导航与 Jetpack 组件可继续使用,新公共页面逐步替换。
原理流程
- app 模块依赖公共 UI 库。
- Activity/Fragment 用
setContent或 Compose View 挂载公共组合。 - 注入共享 ViewModel 与平台实现。
代码或图示
setContent {
AppTheme { ProfileScreen(viewModel = profileViewModel) }
}
常见误区
- 把 Android 专属依赖写进 commonMain UI 模块。
- 公共组合函数直接读
Context或 Android 资源。
追问
- 存量 Android 页面怎么过渡?答:按页面逐步替换,先共享纯展示与表单页;复杂列表与平台交互页保留原生,过渡期混排共存。
07.2.3.2-018 iOS 原生工程中如何嵌入 Compose 页面?
一句话结论
通过 CMP 提供的 iOS 宿主视图承载公共组合函数,Swift/SwiftUI 页面持有该宿主;数据经共享 ViewModel 与回调接口传递,生命周期由 iOS 页面管理。
概念解释
iOS 不运行 Jetpack Compose,而是由 CMP 后端渲染到宿主视图。工程链路:KMP 产物 framework/XCFramework 链接到 Xcode,Swift 页面创建宿主并传入状态。导航、安全区、键盘与系统栏在 iOS 层适配;具体宿主 API 名称与能力随 CMP 版本核对(待确认)。
原理流程
- 共享 UI 模块编译为 iOS 产物并链接工程。
- Swift 页面创建 CMP 宿主视图。
- 注入共享 ViewModel,订阅状态回调刷新。
代码或图示
SwiftUI/UIKit 页面
→ CMP 宿主视图
→ 公共 @Composable 页面
→ 共享 ViewModel / 仓库
常见误区
- 假设 iOS 上 Compose 页面可直接访问 UIKit 控件。
- 宿主视图未处理安全区、键盘遮挡与生命周期释放。
追问
- 怎么验证 iOS 嵌入稳定性?答:试点核心页面覆盖导航、输入、列表与弹层;核对宿主 API 版本、手势与内存释放,再推广到其他页面。
07.2.3.2-019 如何判断一个 UI 需求能否用 common 实现?
一句话结论
按「组件是否有跨端实现、输入输出是否为公共模型、是否调用平台 SDK、交互规范双端是否可接受」四条判断;任一不满足就下沉平台或原生嵌入。
概念解释
判断清单:组件库是否提供多平台版本;页面是否只依赖公共状态与模型;是否触碰平台硬件/系统服务;交互手势、布局规范是否与平台习惯冲突。复杂图表、自定义图形、媒体编辑类页面要单独评估后端能力。结论应落到试点验证,而不是凭组件名推断。
原理流程
- 拆解页面为组件、数据、交互三部分。
- 逐项对照四条判断标准。
- 存疑页面进试点工程编译并真机验证。
代码或图示
可公共化:基础组件 + 公共模型 + 无 SDK 调用 + 规范一致
需平台化:原生控件 / 硬件能力 / 平台专属交互
常见误区
- 只看功能能否跑通,忽略交互一致性与长期维护成本。
- 把判断结果写死,版本升级后不重新核对组件缺口。
追问
- 混合页面怎么划分?答:公共骨架与表单复用,平台控件嵌入槽位;边界处定义清晰的数据与事件协议。
07.2.3.2-020 CMP 在 iOS 上的渲染与手势表现如何?
一句话结论
基础列表、表单与按钮可用;滚动、触摸命中、返回手势、键盘交互与原生 iOS 控件存在差异,必须在真机覆盖核心路径并与设计规范对齐。
概念解释
iOS 后端把 Compose 指令交给本端图形与输入栈,触摸事件映射为 Compose 手势。已知风险点:滚动惯性与回弹、长按/拖动手势识别、系统返回手势与页面内部返回栈冲突、点击区域命中、键盘弹起遮挡。演示效果不能替代真机多机型验证。
原理流程
- 试点页覆盖列表滚动、按钮、输入、弹层。
- 真机核对手势、滚动与键盘行为。
- 差异在宿主层适配或调整公共组件交互。
代码或图示
验证路径:列表滚动 → 点击命中 → 输入弹键盘 → 返回手势 → 弹层关闭
常见误区
- 只在模拟器快速点测,未覆盖真机手势与键盘。
- 把 iOS 交互问题误判为业务 bug,反复改公共状态。
追问
- 手势冲突怎么处理?答:系统级手势由宿主优先处理,CMP 内部手势只在容器内生效;返回事件统一上报宿主导航。
07.2.3.2-021 iOS 上 Compose 与 SwiftUI/UIKit 如何互操作?
一句话结论
CMP 宿主视图嵌入 SwiftUI/UIKit 页面,双向通过视图容器与回调接口通信;Swift 状态与 Kotlin 状态分别维护,跨层只传公共模型。
概念解释
常见形态:SwiftUI 页面用 UIViewRepresentable 包装 CMP 宿主;UIKit 页面直接持有宿主视图。公共 ViewModel 由 Kotlin 层提供,Swift 订阅回调刷新;原生控件在槽位中嵌入。跨边界不传 Swift struct 或 Kotlin 原生对象,使用导出的 data class。
原理流程
- Swift 页面创建宿主视图并挂载。
- 注入共享 ViewModel 与实现接口。
- 原生控件与 CMP 页面经事件协议通信。
代码或图示
SwiftUI/UIKit
├─ CMP 宿主视图(公共组合)
└─ 原生控件槽位
↓ 公共模型 / 事件回调
Kotlin 共享层
常见误区
- 跨层直接传递 Swift 值类型或 UIKit 对象。
- 两侧各维护一份页面状态,数据源不一致。
追问
- 共享 ViewModel 生命周期怎么挂?答:跟随 Swift 页面生命周期创建与释放,页面退出调用共享层取消方法;具体宿主 API 以当前 CMP 版本为准(待确认)。
07.2.3.2-022 iOS 生命周期与 Compose 宿主如何配合?
一句话结论
宿主视图跟随 iOS 页面出现/消失创建与释放;共享协程作用域在页面退出时取消,状态订阅同步注销,避免残留回调访问已释放对象。
概念解释
iOS 页面生命周期(appear/disappear/内存告警)需要映射到共享层:订阅开始与停止、协程取消、资源释放。Compose 宿主销毁时不能再有回调驱动 UI。公共 ViewModel 暴露 close()/取消方法,Swift 侧在对应生命周期调用。
原理流程
- 页面出现时初始化 ViewModel 并订阅状态。
- 页面消失时注销订阅、取消作用域。
- 宿主视图释放后不再接收回调。
代码或图示
class ScreenViewModel {
private val scope = CoroutineScope(SupervisorJob())
fun close() = scope.cancel()
}
常见误区
- 页面退出后协程仍在后台更新状态,回调访问已释放视图。
- 只销毁宿主视图,未取消 Kotlin 侧订阅与作用域。
追问
- 跨页持久状态放哪里?答:进程级单例仓库或平台会话作用域,不绑定单个 CMP 宿主;页面级状态跟随 ViewModel 释放。
07.2.3.2-023 iOS 安全区、导航栏与返回手势如何适配?
一句话结论
公共布局留出可注入的边距槽位,宿主层读取安全区与导航栏高度;系统返回手势由宿主拦截后回调公共导航事件,不把 iOS 布局参数写死在 common。
概念解释
iPhone 刘海/灵动岛、底部 Home 指示条、导航栏高度影响内容布局。公共组合提供边距参数,宿主把安全区 insets 传入;导航栏样式与返回按钮在 iOS 层实现。CMP 页面内部返回栈与系统侧滑手势需要协调,避免双重返回。
原理流程
- 公共布局接收顶部/底部边距参数。
- iOS 宿主读取安全区并注入。
- 系统返回手势触发公共导航事件,宿主统一出栈。
代码或图示
@Composable
fun Screen(topPadding: Dp, bottomPadding: Dp, content: @Composable () -> Unit)
常见误区
- 公共组件写死状态栏/导航栏高度。
- 侧滑手势与内部返回栈冲突,页面重复退出。
追问
- 不同机型怎么验证?答:覆盖刘海屏、小屏、横屏(如支持);安全区参数在宿主层适配,公共组件按参数布局。
07.2.3.2-024 桌面目标(JVM/Compose Desktop)有哪些能力?
一句话结论
Compose Desktop 基于 JVM 提供窗口、菜单、文件对话框、托盘与多窗口能力,适合工具类、管理后台类桌面应用;系统集成深度与原生桌面框架仍有差距。
概念解释
桌面目标复用 Compose 组件体系,平台层接入 JVM 窗口系统。可做:主窗口、工具栏/菜单、文件选择、通知、系统托盘、拖拽。受限项:原生系统设置面板、深度文件管理、平台原生控件外观与系统级集成。公共业务逻辑与表单可跨端复用,桌面专属交互在 desktopMain 实现。
原理流程
- 定义
jvm("desktop")target 与 desktopMain 源集。 - 公共组合与状态复用,桌面窗口能力在 desktopMain 装配。
- 打包为 JVM 应用或原生安装分发物。
代码或图示
fun main() = application {
Window(onCloseRequest = ::exitApplication) {
App()
}
}
常见误区
- 把桌面菜单、文件对话框写进 commonMain。
- 期望 Compose Desktop 与系统原生应用外观完全一致。
追问
- 桌面应用与移动 App 共享哪些层?答:数据模型、网络、校验与用例层共享;窗口、菜单、文件系统操作留在 desktopMain,UI 组件按复用程度拆分。
07.2.3.2-025 桌面应用如何打包分发?
一句话结论
JVM 产物可打可执行 jar,再用 jpackage 等工具封装为平台安装包;也可携带 JRE 分发,体积与签名方式按操作系统分别处理。
概念解释
Compose Desktop 构建产物默认是 JVM 字节码:开发期直接运行,分发可选瘦 jar(依赖本地 JRE)或捆绑运行时安装包。jpackage 可生成 Windows/macOS/Linux 原生安装格式;macOS 需签名公证,Windows 有代码签名要求。打包链与 CMP/JVM 版本相关,发布前在目标系统实测安装启动。
原理流程
- 编译 JVM 字节码与资源。
- 选择捆绑 JRE 或要求用户安装 JRE。
- 用打包工具生成安装包,完成签名与安装验证。
代码或图示
jar(开发/瘦包) → jpackage → 平台安装包(msi/dmg/deb 等)
常见误区
- 未测试裸机安装,只在开发机运行通过。
- 忽略 macOS 公证与 Windows 签名,安装被系统拦截。
追问
- 捆绑 JRE 体积怎么权衡?答:内部工具可要求预装 JRE 减小体积;面向外部分发通常捆绑运行时,体积纳入基线对比。
07.2.3.2-026 桌面窗口、菜单、托盘与文件对话框如何实现?
一句话结论
这些能力在 desktopMain 通过 Compose Desktop 窗口 API 与 JVM 平台类实现,公共层只暴露动作接口;文件路径与系统对话不进入 common。
概念解释
桌面专属交互:菜单栏与快捷键、系统托盘图标、打开/保存文件对话框、拖拽文件、多窗口管理。公共层定义 FilePicker、MenuAction 等接口,desktopMain 接入平台 API。common 代码不接触 java.io.File、系统窗口句柄。
原理流程
- common 定义桌面能力接口与结果模型。
- desktopMain 实现菜单、托盘、文件对话框。
- 组合层通过注入接口调用,不依赖 JVM 平台类。
代码或图示
interface FilePicker {
suspend fun openFile(): String?
}
常见误区
- commonMain 引用
JFileChooser、JFrame等 Swing 类。 - 文件路径作为平台对象跨层传递。
追问
- 多窗口状态放哪?答:窗口元数据可放公共状态,窗口创建与关闭由 desktopMain 管理;公共层不持有 JVM 窗口引用。
07.2.3.2-027 Web 目标(Wasm)成熟度与限制如何?
一句话结论
Web 目标编译到 Wasm/JS,适合内部工具与轻量页面试点;浏览器兼容、资源加载、路由与生态组件仍在演进,生产外发需按当前版本实测(待确认)。
概念解释
CMP Web 目标复用公共组合与业务层,产物运行在浏览器 Wasm/JS 环境。限制:DOM 与浏览器 API 适配层覆盖度、第三方组件缺口、加载体积与启动速度、本地存储与权限模型、路由刷新行为。选型前确认官方稳定性标注,试点核心链路,不按移动端体验假设。
原理流程
- 核对 Web 目标当前稳定性与已知限制。
- 试点公共页面在浏览器编译运行。
- 验证路由、资源、输入与主要交互后再评估外发。
代码或图示
common UI/业务层 → Wasm/JS 产物 → 浏览器运行时
常见误区
- 把 Web 目标当成与桌面同级稳定目标直接立项。
- 忽略浏览器版本兼容与移动端浏览器内核差异。
追问
- Web 与移动端共享多少?答:数据层、模型、规则可共享;Web 路由、存储、分享与浏览器交互单独适配,UI 复用度取决于组件覆盖。
07.2.3.2-028 Wasm 下的性能与资源加载现状如何?
一句话结论
Wasm 产物体积、下载解析与首屏启动是主要成本;图片、字体与静态资源走浏览器缓存,大数据解码与列表渲染需要专项测量,具体基线随工具链版本变化(待确认)。
概念解释
浏览器环境与原生运行时不同:模块下载、实例化、字体加载、图片解码都影响首屏。CMP Web 产物包含运行时与组件库,未裁剪体积较大。测量项:包体大小、加载到可交互时间、列表滚动帧率、内存占用。资源按浏览器缓存策略管理,避免大文件内联。
原理流程
- 测量产物大小与首屏可交互时间。
- 拆分模块、裁剪未用组件与资源。
- 列表与图片加载按浏览器特性优化并复测。
代码或图示
基线:产物体积 → 下载/解析 → 首屏渲染 → 列表滚动帧率
常见误区
- 用桌面 JVM 性能数据推断 Wasm 表现。
- 大资源打包进 Wasm 模块,首屏体积失控。
追问
- 哪些 Web 场景更适合?答:低频访问的内部工具、表单型页面;重图形、长列表、媒体编辑场景优先评估原生或 Web 技术栈。
07.2.3.2-029 Web 下路由刷新与状态持久化如何处理?
一句话结论
Web 路由需对接浏览器历史与刷新行为,页面状态按 URL 或浏览器存储恢复;公共导航状态模型可复用,浏览器 API 调用留在 Web 适配层。
概念解释
单页应用刷新后状态会重置:路由参数、表单输入、滚动位置需要持久化。Web 适配层对接浏览器 history、URL 参数与本地存储;公共 ViewModel 只维护业务状态。深链接、前进后退与刷新恢复要在浏览器实测,这与移动端页面栈模型不同。
原理流程
- 公共层定义路由与页面状态。
- Web 适配层同步 URL 与浏览器存储。
- 刷新后从 URL/存储恢复状态。
代码或图示
URL 参数 ↔ Web 适配层 ↔ 公共导航状态 ↔ 页面
常见误区
- 假设 Web 页面状态随内存保留,刷新后丢失。
- 公共层直接调用浏览器历史 API。
追问
- 表单草稿怎么保存?答:公共层定义草稿模型,Web 适配层写本地存储;移动端对应本地存储实现,接口在 common 抽象。
07.2.3.2-030 CMP 各目标的稳定性分级如何理解?
一句话结论
官方对目标标注稳定、Beta/实验等状态:稳定目标可生产采用,实验目标只适合试点;分级随版本变化,立项与升级时都要重新核对(待确认)。
概念解释
稳定性判断来自官方文档与发行说明,而非演示效果。Android 目标最成熟;iOS、桌面按版本逐步稳定;Web 目标演进较快。选择目标时记录:官方状态、已知限制、issue 积压、团队可投入的适配成本。试点失败要能回退到原生或其他技术栈。
原理流程
- 查当前版本各目标官方状态。
- 试点工程验证核心链路与缺口清单。
- 生产采用前确认限制可接受、有回退方案。
代码或图示
稳定:生产候选,常规维护
Beta:限定场景试点
实验:预研与验证,不承诺生产
常见误区
- 把会议演示或 Demo 截图当稳定性证据。
- 版本升级后不复核目标状态与已知问题。
追问
- 哪里查分级最可靠?答:CMP 官方文档对应目标页与版本发行说明;issue 跟踪系统核对未修复问题,不依赖二手教程。
07.2.3.2-031 字体与图标在多端如何保持一致?
一句话结论
字体家族、字号与图标资源走公共资源体系;平台默认字体度量不同,需要预留字号与行高适配,图标按矢量资源跨端复用。
概念解释
各端系统默认字体不同:中文、西文、数字的度量与回退字体有差异。公共层定义字号、字重、行高令牌;自定义字体随资源打包。图标优先使用矢量格式,避免位图分辨率差异。字体加载失败时回退到平台默认字体,不能假设所有端预装同一字体。
原理流程
- 公共资源放入字体与图标目录。
- 主题定义字号、字重与行高。
- 真机核对文字截断、行高与图标清晰度。
代码或图示
composeResources/
├── font/
└── drawable/
常见误区
- 固定像素字号不考虑字体度量差异。
- 位图图标在高分屏模糊。
追问
- 文字溢出怎么处理?答:公共组件提供省略、最大行数与自适应规则;长文本在各端实测换行与截断,不把固定宽度写死。
07.2.3.2-032 多语言与字符串资源如何组织?
一句话结论
使用 CMP composeResources 管理多语言字符串与复数规则,公共代码按 key 取文案;平台语言环境由宿主提供,翻译补全与回退策略在资源层统一。
概念解释
composeResources 把字符串、图片、字体等资源纳入多平台打包。文案按语言目录组织,支持复数与参数占位。公共组合通过资源访问器取字符串;系统语言变化由平台层通知。未翻译 key 需要回退语言并在 CI/构建期检查缺失项。
原理流程
- 资源目录按语言放置 strings 文件。
- 组合函数通过
Res.string访问文案。 - 构建期检查未翻译 key,运行期回退默认语言。
代码或图示
Text(stringResource(Res.string.confirm))
常见误区
- 文案硬编码在组合函数中,无法翻译。
- 复数规则只按中文习惯处理,西文复数出错。
追问
- 翻译流程怎么落地?答:资源 key 由开发维护,文案交翻译流程;构建脚本检查缺失 key 与占位符数量,避免运行期拼接错误。
07.2.3.2-033 图片与音视频资源如何跨平台管理?
一句话结论
图片走公共资源目录与多平台图片组件;音视频播放绑定平台媒体能力,公共层只暴露播放器接口与状态,解码与渲染由平台实现。
概念解释
静态图片(矢量、位图)可纳入 composeResources 或多平台加载器。音视频涉及编解码器、播放控制、画中画与系统音量,属平台能力:Android/iOS 用各自播放器,Web 用浏览器媒体元素。公共层定义播放接口、进度与错误状态,平台 main 封装播放器。
原理流程
- 图片资源入公共目录,按组件规范引用。
- 媒体能力抽象为 common 接口。
- 平台 main 接入本端播放器并回调状态。
代码或图示
interface MediaPlayer {
suspend fun play(url: String)
fun pause()
fun release()
}
常见误区
- commonMain 直接调用平台播放器类。
- 大尺寸图片未做压缩与缩略图尺寸约定。
追问
- 音频后台播放怎么处理?答:后台会话、通知栏与系统焦点属平台能力,在宿主层实现;公共层只同步播放状态与业务规则。
07.2.3.2-034 平台主题资源如何差异化覆盖?
一句话结论
公共资源放 common 资源目录,平台专属资源放对应平台源集;同名资源按平台覆盖,主题令牌在公共层定义,平台差异只补充不另起一套规范。
概念解释
资源解析按 target 选择:平台源集可覆盖 common 同名资源。品牌图标、启动图、深色背景等可能按端不同。公共主题定义颜色与样式令牌,平台覆盖的是具体资源而非规则。覆盖关系需要在评审中核对,避免 common 与平台资源语义不一致。
原理流程
- 公共资源入 common 目录。
- 平台差异资源放平台源集同名路径覆盖。
- 构建期核对资源引用与覆盖清单。
代码或图示
commonMain/composeResources/drawable/logo.xml
iosMain/composeResources/drawable/logo.xml # 覆盖
常见误区
- 平台资源与公共资源语义不同名,加载时取错。
- 各端主题令牌各自定义,公共组件配色失控。
追问
- 资源覆盖冲突怎么排查?答:列出同名资源在各源集的位置,确认解析优先级;变更后在各端编译查看实际加载资源。
07.2.3.2-035 无障碍与可访问性在各端如何处理?
一句话结论
基础语义标签可在公共组件层补充;读屏、焦点顺序与系统无障碍设置属平台能力,需要逐端真机验证。
概念解释
Compose 提供语义属性(content description、角色、状态),公共组件可统一补充。各端读屏服务、字号放大、对比度与焦点导航规则不同;移动端与桌面/Web 的无障碍模型差异更大。公共层保证控件语义完整,平台层接入系统无障碍服务并做走查。
原理流程
- 公共组件补充语义描述与角色。
- 平台层开启并测试读屏与焦点导航。
- 按端走查对比度、放大字号与操作可达性。
代码或图示
Icon(painter, contentDescription = "返回", modifier = Modifier.semantics { })
常见误区
- 只给图片装饰性描述,交互控件缺语义。
- 桌面/Web 忽略键盘焦点与屏幕阅读器。
追问
- 无障碍验收看什么?答:关键流程读屏可完成、焦点顺序合理、大字号不截断、对比度达标;各端分别记录问题清单。
07.2.3.2-036 触摸、鼠标与滚轮输入在桌面/Web 如何处理?
一句话结论
公共手势层兼容点击与悬停,桌面/Web 额外处理鼠标悬停、右键、滚轮与键盘焦点;移动端触摸规范与桌面指针行为在平台层区分。
概念解释
移动设备以触摸为主,桌面有鼠标悬停、右键、滚轮滚动与快捷键,Web 还受浏览器事件模型影响。Compose 指针事件可区分输入类型;公共组件不应只绑定触摸手势。可点击区域、悬停反馈、滚动方向在桌面/Web 单独验证。
原理流程
- 公共组件使用通用点击与指针 API。
- 桌面/Web 适配悬停、滚轮与快捷键。
- 各端验证输入路径与焦点状态。
代码或图示
触摸:点击、长按、滑动
鼠标:悬停、点击、右键、滚轮
键盘:Tab 焦点、回车/快捷键
常见误区
- 组件只响应触摸手势,桌面鼠标点击无反馈。
- 忽略 Web 浏览器默认滚动与拖拽行为。
追问
- 复杂拖拽场景怎么跨端?答:公共层定义拖拽状态与结果,指针类型差异在平台适配;移动端滑动与桌面拖拽分别验证。
07.2.3.2-037 设备方向与分屏适配怎么做?
一句话结论
布局使用自适应宽度与权重,不写死屏幕尺寸;横竖屏、折叠屏、分屏与桌面窗口缩放由宿主提供尺寸约束,公共组合按可用空间重排。
概念解释
移动端有横竖屏、折叠展开、小窗模式;桌面窗口可自由缩放,Web 随浏览器宽度变化。固定列宽、全屏堆叠会在窄屏/宽屏出问题。公共组件用 Box/Column/Row 权重、流式布局与断点策略;方向与尺寸变化由宿主通知组合层重组。
原理流程
- 布局基于可用宽度与权重,不写死像素尺寸。
- 定义宽/中/窄断点与对应排列。
- 真机与窗口缩放逐档验证。
代码或图示
Row(modifier = Modifier.fillMaxWidth()) {
Sidebar(modifier = Modifier.weight(1f))
Content(modifier = Modifier.weight(2f))
}
常见误区
- 按手机竖屏尺寸写死间距与列数。
- 折叠屏展开后仍保持双栏挤压布局。
追问
- 断点策略放哪一层?答:断点阈值在公共主题/布局工具集中定义,具体尺寸由宿主传入;平台不另起一套布局规则。
07.2.3.2-038 剪贴板、拖拽与文件选择如何跨端处理?
一句话结论
剪贴板读写抽象为 common 接口;文件选择、拖拽文件来自系统对话框或平台拖放事件,公共层只接收文件模型与结果回调。
概念解释
复制粘贴是跨端基础能力,但剪贴板内容类型与权限提示按平台不同。文件选择器、拖拽上传绑定系统文件服务;Web 受浏览器文件 API 限制。公共层定义 Clipboard、FilePicker 接口,平台 main 实现,不把平台文件对象透传到 common。
原理流程
- common 抽象剪贴板与文件选择接口。
- 平台 main 接入系统对话与拖放事件。
- 返回公共文件模型(名称、大小、内容句柄)。
代码或图示
interface FilePicker {
suspend fun pickImage(): PickedFile?
}
常见误区
- common 引用平台文件类或 URI。
- 大文件直接读入内存,各端 OOM 风险。
追问
- 文件上传怎么接?答:平台句柄交给网络层上传,公共层显示进度与状态;分块与断点续传按网络层能力设计。
07.2.3.2-039 通知、传感器、相机等设备能力如何接入?
一句话结论
这些是平台 SDK 能力:common 定义接口与状态模型,平台 main 封装权限申请、系统服务与回调,CMP 页面通过接口获取结果。
概念解释
本地通知、摄像头、麦克风、定位、传感器、蓝牙、生物识别都绑定平台权限与系统 API。公共层不能直接调用对应 SDK。接入顺序:定义公共能力接口 → 平台实现权限流程与回调 → 组合层订阅状态。权限拒绝、后台限制与错误码在公共错误模型中表达。
原理流程
- common 定义能力接口与结果/错误模型。
- 平台 main 申请权限并调用系统服务。
- 组合层按状态渲染授权、等待与错误界面。
代码或图示
interface CameraScanner {
suspend fun scan(): ScanResult
}
常见误区
- 权限检查与申请代码写进 common 组合函数。
- 只处理成功路径,忽略拒绝授权与系统限制。
追问
- 能力不可用怎么降级?答:公共层返回不可用状态,页面展示替代入口;平台能力清单在产品设计阶段按端对齐。
07.2.3.2-040 CMP 页面如何嵌入 WebView、地图等平台组件?
一句话结论
在宿主页面提供原生组件槽位,CMP 与原生组件经接口通信;复杂平台控件不强行包成公共 Compose 组件。
概念解释
地图、WebView、视频播放器、支付控件是原生/平台组件。混排方式:原生页面嵌入 CMP 节点,或 CMP 页面预留平台嵌入槽位。通信协议用公共模型与事件,导航与生命周期由宿主管理。组件方向、缩放、定位状态通过接口同步,不持有原生对象引用。
原理流程
- 划定平台组件边界与槽位。
- 定义数据展示与交互事件协议。
- 宿主挂载原生组件并接入共享状态。
代码或图示
CMP 页面 ↔ 事件/状态协议 ↔ 原生地图/WebView 槽位
常见误区
- 把原生控件包一层暴露给 common,类型泄漏平台对象。
- 组件状态在两侧各存一份,不同步。
追问
- 地图选点这类双向交互怎么做?答:公共 ViewModel 持有选点状态,原生组件回调更新;地图镜头与手势在平台侧控制,只回传业务坐标。
07.2.3.2-041 调试 CMP 各端有哪些工具链?
一句话结论
Android 复用 Android Studio/Compose 工具;iOS/桌面/Web 靠日志、断点与各端原生调试工具,Compose 状态检查能力按目标可用性不同。
概念解释
公共代码可在 IDE 断点调试。Android 有 Layout Inspector、重组统计等既有工具;iOS 调试依赖 Xcode 调试器、日志与视图层级;桌面用 JVM 调试工具;Web 用浏览器开发者工具。跨端共享层问题先在 JVM/Android 复现,再到其他端定位。版本越新,Compose 调试工具覆盖越完善(待确认)。
原理流程
- 在 JVM/Android 复现公共逻辑问题并断点。
- UI 与平台交互问题转到对应端原生工具。
- 日志统一经公共日志接口输出,便于跨端排查。
代码或图示
Android:Studio + Compose Inspector
iOS:Xcode 断点/视图层级/日志
Desktop:JVM 调试器
Web:浏览器 DevTools
常见误区
- 期待所有端都有与 Android 相同的 Compose 检查面板。
- 跨层问题只在一端反复调试,不回溯公共逻辑。
追问
- 日志怎么统一?答:公共日志接口在各端桥接到本端日志通道;关键状态变化、异常与网络请求带统一 tag 与级别。
07.2.3.2-042 Preview 在桌面与 Android 的可用情况如何?
一句话结论
Android 上可用 Jetpack Compose Preview;其他目标的预览支持按 CMP 版本与 IDE 插件能力不同,未覆盖时靠运行模拟器/桌面窗口查看组合效果。
概念解释
Preview 是 IDE 编译期渲染组合函数的能力,依赖对应目标的渲染后端。Android 链路成熟;桌面、iOS、Web 的预览支持度随工具链演进。开发期在缺失预览的目标上,用最小可运行工程挂载组合函数查看样式,不能假设预览与真机一致。
原理流程
- 可预览目标使用
@Preview查看布局。 - 不支持的目标运行最小宿主工程。
- 样式差异以真机/真实窗口为准。
代码或图示
@Preview
@Composable
fun GreetingPreview() { Greeting("World") }
常见误区
- 只看单端预览就定稿 UI。
- 把预览里的假数据布局当成生产状态。
追问
- 多端样式如何快速核对?答:公共组件用固定假数据,分别在各目标运行;建立组件预览页作为回归基线。
07.2.3.2-043 CMP 性能基线如何测量重组频率与卡顿?
一句话结论
先测公共层重组频率与状态读取,再测各端帧时长与内存;原则与原生 Compose 一致,具体工具指标按目标端读取。
概念解释
性能问题分两层:组合层(多余重组、状态追踪、稳定类型)与渲染层(绘制耗时、列表滚动、图片解码)。测量项:重组次数/跳过数、帧时长、掉帧、内存峰值、启动时间。公共优化原则通用:拆分状态、避免 lambda 重建、稳定数据类、懒加载列表。基线在试点期建立,大改动前后对比。
原理流程
- 建立各端启动、滚动、内存基线。
- 定位高频重组与耗时绘制节点。
- 优化后复测并回归对比。
代码或图示
重组次数 → 帧时长 → 滚动帧率 → 内存/启动
常见误区
- 只看主观流畅度,不记录量化基线。
- 把图片解码、列表渲染问题误判为 Compose 重组问题。
追问
- 列表性能怎么优化?答:用懒加载列表、稳定 key 与稳定类型,限制单项复杂度;图片按尺寸加载,避免主线程解码。
07.2.3.2-044 平台差异问题如何系统排查?
一句话结论
按「公共逻辑 → 组件覆盖 → 后端渲染/事件 → 宿主适配」分层定位:先在 JVM/Android 排除公共问题,再到问题端核对组件实现、手势与宿主集成。
概念解释
跨端差异来源:公共状态错误、组件未覆盖、后端绘制/事件差异、宿主容器配置。排查顺序:同一页面在多端对比表现 → 公共逻辑单测与日志 → 问题端组件清单与版本 → 宿主生命周期/边距/手势。不要一上来改公共状态或全量替换组件。
原理流程
- 复现并记录差异端、机型、操作路径。
- 公共层验证数据与状态正确性。
- 问题端核对组件版本、渲染后端与宿主配置。
代码或图示
公共逻辑 → 组件可用性 → 后端渲染/事件 → 宿主集成
常见误区
- 只在问题端调样式,根因在公共状态或组件缺口。
- 凭单次操作判断问题,未固定复现路径。
追问
- 怎么沉淀排查流程?答:记录现象、端、版本、组件与调用栈;常见差异归入组件缺口清单,供升级 CMP 版本后回归。
07.2.3.2-045 CMP 应用包体积由哪些部分构成?
一句话结论
体积包含 Kotlin 运行时、Compose 组件库、公共业务代码、平台依赖与资源;跨端复用的公共代码在各端各打一份,需按 target 分别核算基线。
概念解释
与单端应用相比,CMP 应用多了共享运行时与组件库体积;公共逻辑虽复用源码,但产物在每个 target 独立打包。构成项:Kotlin 标准库、Compose 运行时与组件、业务类、图片/字体/字符串资源、第三方库。Web 目标还含 Wasm/JS 运行时。体积基线要分端记录,不能只看移动端。
原理流程
- 解包产物,统计运行时、库、业务代码与资源。
- 按 target 建立体积基线。
- 大依赖与资源改动前后对比裁剪。
代码或图示
Kotlin 运行时 + Compose 库 + 业务代码 + 平台依赖 + 资源
常见误区
- 以为共享代码体积只算一份。
- 只测安装包大小,忽略下载体积与资源膨胀。
追问
- 体积增长怎么归因?答:对照基线列出新增依赖、资源与代码;先裁未用库与大图,再评估运行时裁剪配置。
07.2.3.2-046 Android 上 CMP 与原生 Compose 体积有何差异?
一句话结论
Android 目标复用 Jetpack Compose 运行时,增量体积主要来自共享模块与跨端运行时;与纯原生 Compose 项目相比,差异通常小于 iOS/Native 目标,但仍需实测基线。
概念解释
Android 上 CMP 公共 UI 编译为 JVM 字节码参与 dex,Compose 运行时与纯 Compose 项目同源。额外部分是 KMP 元数据/共享业务类与必要依赖。混淆裁剪、资源压缩与 ABI 配置对体积影响更大。不要按 iOS 体积比例推断 Android。
原理流程
- 对比纯原生 Compose 包与引入共享模块后的包体。
- 检查 dex 中共享类与依赖占比。
- 开启混淆与资源压缩后复测。
代码或图示
Android 增量:共享业务类 + 跨端依赖(Compose 运行时同源)
常见误区
- 把 Web/iOS 体积担忧套到 Android。
- 未开混淆就评估最终发布包体积。
追问
- 裁剪手段有哪些?答:R8/ProGuard 混淆裁剪、未用资源移除、图片压缩与按需依赖;具体规则按 AGP 与库要求配置。
07.2.3.2-047 iOS 框架体积与符号裁剪如何处理?
一句话结论
iOS framework/XCFramework 包含 Kotlin/Native 运行时、共享代码与组件库;Release 配置裁剪调试符号与未用代码,按架构分 slice,避免模拟器产物进发布包。
概念解释
Native 产物体积常被运行时与静态链接库拉高。Release 构建关闭调试符号、启用优化与裁剪;XCFramework 按真机/模拟器分目录,发布包只嵌真机 slice。符号表、dSYM 单独归档不进 App。具体裁剪选项随 Kotlin/Native 版本与链接配置变化,需实测(待确认)。
原理流程
- 分别统计 Debug/Release framework 体积。
- 开启优化与符号裁剪,归档 dSYM。
- 发布包核对架构 slice,剔除模拟器产物。
代码或图示
Debug framework(含符号) → Release framework(优化/裁剪)
XCFramework:真机 slice + 模拟器 slice(发布只嵌真机)
常见误区
- 把 Debug 框架体积当发布基线。
- 模拟器二进制随 Release 包提交审核。
追问
- 体积仍偏大怎么查?答:按链接映射表定位大库与未用代码;拆分公共模块、裁剪组件依赖,必要时评估部分页面留原生实现。
07.2.3.2-048 桌面分发体积与 JRE 打包方式如何选择?
一句话结论
桌面应用可要求用户预装 JRE 以减小分发体积,或捆绑运行时生成自包含安装包;面向外部用户通常捆绑 JRE,内部工具可瘦包分发。
概念解释
JVM 应用不捆绑运行时时包体小,但依赖目标机器 Java 环境;捆绑 JRE 后安装包增大、安装后目录占用增加。jpackage 支持按平台生成安装格式,运行时模块可裁剪。体积、安装门槛与用户环境共同决定打包策略,试点期记录两种方式的安装包大小。
原理流程
- 区分内部工具与外部分发场景。
- 瘦包:依赖预装 JRE;自包含:jpackage 捆绑运行时。
- 目标系统裸机验证安装与启动。
代码或图示
瘦 jar + 系统 JRE 体积小,环境依赖高
jpackage 捆绑 JRE 体积大,开箱即用
常见误区
- 开发机有 JRE 就假设用户机器可用。
- 捆绑完整 JRE 而不裁剪模块,体积虚高。
追问
- 跨平台桌面包怎么管理?答:各操作系统分别打包与签名,版本号统一;CI 缓存基础运行时,避免每次全量下载。
07.2.3.2-049 Wasm 产物体积与加载如何优化?
一句话结论
按路由/功能拆分模块,裁剪未用组件与资源,大资源外置缓存;测量下载、实例化与首屏时间,优化项随工具链版本调整(待确认)。
概念解释
Wasm 产物包含运行时、组件库与业务代码,首屏成本来自下载、解析与实例化。优化路径:模块拆分按需加载、删除未使用库与资源、图片字体外置、压缩传输。浏览器缓存策略影响二次访问。生产外发前必须在真实网络与低端设备测量,不能只看本地构建体积。
原理流程
- 统计 Wasm/JS 产物与资源体积。
- 拆分模块、裁剪依赖与内联资源。
- 复测下载到可交互时间并固化基线。
代码或图示
产物拆分 → 依赖裁剪 → 资源外置 → 压缩/缓存 → 首屏测量
常见误区
- 把全部组件库打进首屏模块。
- 用本地高速网络数据判断 Web 加载性能。
追问
- 哪些资源必须外置?答:大图、字体、非首屏数据;运行时与公共库评估长期缓存,业务模块随版本更新。
07.2.3.2-050 启动性能在各端受哪些因素影响?
一句话结论
启动时间受运行时初始化、首屏组合、图片/字体加载与依赖装配影响;公共层延迟初始化重依赖,平台层精简启动链路,分端建立启动基线。
概念解释
启动链路:进程/容器初始化 → 依赖装配 → 首屏组合 → 资源加载。Kotlin 运行时、Compose 初始化、首屏数据拉取、大图与字体都在关键路径。常见问题:Application 里集中初始化 SDK、首屏同步等待数据、未用模块提前加载。公共层提供懒加载与作用域控制,平台层控制启动装配顺序。
原理流程
- 分端测量冷启动到首屏可交互时间。
- 定位关键路径上的初始化与资源加载。
- 延迟非必要依赖,首屏数据按需加载。
代码或图示
进程初始化 → 依赖装配 → 首屏组合 → 数据/资源就绪
常见误区
- 在共享库内部自动初始化全局单例。
- 首屏阻塞等待非必要接口返回。
追问
- 跨端启动差异怎么分析?答:对比各端初始化清单,公共重依赖下沉懒加载;平台 SDK 初始化顺序在宿主层优化,启动基线纳入版本回归。
07.2.3.2-051 重组性能在 CMP 下有哪些优化要点?
一句话结论
稳定类型、拆分状态、避免高频 lambda 重建、懒列表与只读参数是跨端通用优化;具体重组计数按各端 Compose 工具读取。
概念解释
多余重组来自状态粒度太粗、参数不稳定、组合函数内创建对象/lambda。优化:状态下沉到最小作用域,data class 保证相等性,列表项提供稳定 key,避免在组合中做重计算。公共原则与原生 Compose 一致;CMP 后端差异可能放大重组后的绘制成本。
原理流程
- 定位高频重组节点与读取的状态。
- 拆分状态、稳定参数、提取只读子组合。
- 复测重组次数与帧时长。
代码或图示
// 稳定 data class 作为列表项参数
data class RowItem(val id: String, val title: String)
常见误区
- 大函数读取多个状态,任一变化整体重组。
- 每次组合新建 lambda 与对象,破坏参数稳定性。
追问
- 怎么判断重组是否必要?答:按工具统计重组次数与跳过比例;只在显示内容变化时重组为目标,无关状态更新不应触发重排。
07.2.3.2-052 内存占用与图片缓存如何管理?
一句话结论
公共层约定图片尺寸、缓存键与释放规则;平台实现内存/磁盘缓存,大位图按尺寸解码,页面退出释放引用,避免各端无界缓存。
概念解释
内存峰值常见于全尺寸图片解码、列表项持有大图、缓存无上限。公共模型约定缩略图/原图尺寸,图片库按端配置内存缓存上限与回收。列表复用项及时释放位图;大文件与音视频走磁盘/流式加载。内存基线按低端机型测量。
原理流程
- 约定各位置图片尺寸与缓存键。
- 平台图片库限制内存缓存与解码尺寸。
- 页面退出释放引用,复测内存峰值。
代码或图示
原图 → 按目标尺寸解码 → 受限内存缓存 → 磁盘缓存兜底
常见误区
- 列表直接加载原图,滚动时内存飙升。
- 缓存只增不减,长时间使用后 OOM。
追问
- 图片缓存策略能公共化吗?答:缓存键、尺寸与淘汰策略可在 common 定义;具体缓存实现与位图对象在平台 main,不跨层持有原生位图。
07.2.3.2-053 混淆、裁剪与 R8/ProGuard 在桌面侧如何处理?
一句话结论
Android 用 R8 裁剪混淆;JVM 桌面产物按打包方式配置混淆与裁剪,Native/Web 目标走各自工具链,规则需保留反射、序列化与导出接口。
概念解释
混淆裁剪不能误伤:kotlinx.serialization 反射类、导出到 Swift 的公共类型、DI 注入点、原生回调接口都要保留。Android R8 有默认规则与库 consumer 规则;桌面 jpackage 产物按 JVM 混淆工具配置;Native 裁剪选项按 Kotlin/Native 文档。导出 ABI 公共成员不可被裁掉。
原理流程
- 列出必须保留的反射、序列化与导出类型。
- 按目标配置混淆/裁剪规则。
- 发布前各端回归核心链路。
代码或图示
保留:序列化器、导出接口、DI 绑定、原生回调
裁剪:未用业务类、调试符号、冗余依赖
常见误区
- 混淆后序列化/导出类被裁剪,运行期崩溃。
- 只在调试包验证,发布包规则未回归。
追问
- 怎么检查裁剪误伤?答:发布包跑核心冒烟链路;观察反射缺失、导出符号缺失错误,补充保留规则并归档基线配置。
07.2.3.2-054 版本号、签名与渠道如何管理?
一句话结论
公共模块维护语义化版本与变更记录,各端签名、渠道包与商店配置在宿主层管理;KMP/CMP/Kotlin 依赖版本在版本目录锁定,升级走兼容矩阵核对。
概念解释
应用版本号与构建号按平台商店规则填写;签名密钥、证书、Provisioning Profile 属各端发布配置。共享库版本影响多端产物兼容,破坏性变更升大版本。依赖版本(Kotlin、CMP、AGP、Ktor 等)统一在版本目录管理,避免各端解析到不同版本。
原理流程
- 版本目录锁定工具链与库版本。
- 宿主工程按平台规则配置签名与渠道。
- 发版记录公共 API 变更与兼容范围。
代码或图示
版本目录:Kotlin / CMP / AGP / 库版本
宿主层:签名证书、渠道、商店元数据
常见误区
- 各端依赖版本不一致,运行期类缺失。
- 共享库升小版本却改了公共签名,旧端不兼容。
追问
- 多端版本怎么对齐?答:产品版本号由宿主工程统一注入;共享库独立语义化版本,在发版说明中标注兼容的 App 版本范围。
07.2.3.2-055 iOS 上架流程中 CMP 产物扮演什么角色?
一句话结论
CMP/KMP 产物作为内嵌 framework/XCFramework 随 App 打包;上架走标准 iOS 审核流程,需处理架构切片、签名、符号归档与隐私声明,产物本身不改变 App Store 发布规则。
概念解释
Xcode 链接共享 framework 后,二进制随 App 提交审核。要点:Release 只含真机架构、嵌入与签名正确、dSYM 归档、隐私权限说明完整。CMP 产物不绕过审核;原生能力(支付、登录、推送)仍按平台合规要求接入。审核被拒常因权限说明缺失、后台能力未声明,而非框架本身。
原理流程
- Release 构建 XCFramework 并嵌入 App。
- 核对架构、签名与符号归档。
- 填写隐私与权限说明,走 TestFlight/审核流程。
代码或图示
KMP/CMP framework → 嵌入 App → 签名打包 → TestFlight → App Store
常见误区
- 模拟器 slice 进入发布包被架构校验拦截。
- 共享层采集的数据未在隐私清单中声明。
追问
- 框架更新后审核注意什么?答:重新验证链接与签名,确认公共 API 兼容;变更数据采集时同步更新隐私声明。
07.2.3.2-056 桌面应用签名与公证如何处理?
一句话结论
macOS 需开发者证书签名与公证,Windows 有代码签名证书要求;签名后在目标系统裸机验证安装运行,未签名应用会被系统拦截(具体要求随系统版本变化,待确认)。
概念解释
桌面分发信任模型与移动商店不同:macOS 对未签名/未公证应用提示风险,Windows SmartScreen 对未签名安装包告警。打包流程需接入签名工具与证书管理;公证产物需要苹果开发者账号流程。Linux 发行格式依赖包仓库与签名约定。CI 中证书安全存储,不写进脚本明文。
原理流程
- 准备各平台签名证书与凭证。
- 打包后签名、公证(macOS)并归档凭证。
- 干净系统验证安装、启动与卸载。
代码或图示
macOS:签名 → 公证 → notarized 打包
Windows:代码签名证书 → 安装包签名
常见误区
- 只在开发机签名测试,未验证干净系统安装。
- 证书私钥提交到仓库或脚本明文。
追问
- 内部分发怎么简化?答:企业内可通过受信设备管理或内部仓库分发;对外仍需按平台签名公证要求执行,具体政策以当前系统文档为准。
07.2.3.2-057 Web 产物如何部署与托管?
一句话结论
Wasm/JS 产物作为静态资源部署到托管或 CDN,路由、缓存头与资源版本化按 Web 规范配置;接口地址与环境参数在构建期注入。
概念解释
Web 部署不经过应用商店:产物、静态资源与 index.html 上传到静态托管/CDN。注意长缓存资源的文件名哈希、路由刷新回退、gzip/brotli 压缩、HTTPS 与环境接口地址。CMP Web 构建产物目录结构以工具链输出为准(待确认)。
原理流程
- 构建 Web 产物并注入环境配置。
- 静态资源按哈希缓存,HTML 不缓存。
- 部署到 CDN 并验证路由刷新与资源加载。
代码或图示
index.html + Wasm/JS + 资源 → CDN/静态托管 → 浏览器访问
常见误区
- 静态资源强缓存导致旧版本残留。
- 路由刷新回退未配置,深链接 404。
追问
- 环境配置怎么注入?答:构建期按环境注入接口地址与开关;运行期不暴露密钥,敏感服务端代理处理。
07.2.3.2-058 灰度、回滚与热修复的边界在哪里?
一句话结论
逻辑与配置可通过后端下发控制,原生包版本更新走商店审核;跨端共享层代码修复仍需随包发布,不能在未越狱/未审核环境热替换 Kotlin 二进制。
概念解释
灰度手段:功能开关、远端配置、接口降级;回滚靠关闭开关或回退服务端逻辑。客户端二进制(Kotlin 类、CMP 产物、原生代码)修改必须发版,移动平台不支持通用热替换。Web 产物可随部署快速更新。设计期把可远端调整的部分(文案、开关、规则)与必须发版的部分分开。
原理流程
- 区分远端可控配置与客户端代码。
- 灰度开关控制功能开放范围。
- 代码缺陷随新版本发布,服务端配合降级。
代码或图示
可远端:开关、文案、规则、接口降级
需发版:Kotlin/原生代码、UI 结构、依赖升级
Web:静态产物重新部署即更新
常见误区
- 承诺共享层可像 RN/JS 一样动态热更新。
- 关键缺陷只靠开关绕开,长期不发版修复。
追问
- 怎么设计可灰度的功能?答:新功能挂开关与独立接口路径,默认关闭;问题时远端关闭,代码修复随下一版本。
07.2.3.2-059 CI 中构建多目标的成本与缓存如何安排?
一句话结论
CI 为各 target 分别编译,缓存 Gradle 依赖、构建目录与产物;按提交类型分级执行:快速检查跑公共测试,合并前与发版跑全目标构建。
概念解释
多目标编译时间随端数增长:Android、iOS、桌面、Web 各有编译链。缓存策略:Gradle 依赖缓存、构建缓存、产物归档;任务按变化增量执行。流水线分级:PR 跑 commonTest 与核心目标,夜间/合并前跑全量。Windows/macOS/Linux 构建机需匹配对应 target,iOS 产物在 macOS 构建。
原理流程
- 拆分快速检查与全量构建阶段。
- 缓存依赖与构建目录,归档产物。
- 全目标测试与打包在合并/发版前执行。
代码或图示
PR:commonTest + Android/核心目标
夜间:全 target 构建 + 测试 + 产物归档
发版:签名打包 + 冒烟回归
常见误区
- 每次提交全量编译所有目标,排队时间过长。
- 缓存未按 Kotlin/依赖版本隔离,命中错误产物。
追问
- iOS 产物为什么必须 macOS 构建?答:Xcode 链接与签名依赖 macOS 工具链;CI 需配置 macOS runner,Linux/Windows 不能替代该步骤。
07.2.3.2-060 Compose Multiplatform 版本与 BOM 如何对齐?
一句话结论
CMP 提供版本/BOM 统一管理组件与运行时版本,应用在依赖处引用 BOM;CMP 版本必须与 Kotlin 编译器版本配套,不能单独升级某组件。
概念解释
跨组件版本一致性由 BOM 固定,避免 Compose 运行时、组件库版本错配。Kotlin 语言版本、Kotlin Gradle 插件与 CMP 三者有兼容矩阵;升级顺序通常先确认兼容矩阵,再统一升 Kotlin 与 CMP。版本目录集中记录,禁止各模块私改版本。
原理流程
- 查当前 Kotlin 版本对应的 CMP 兼容版本。
- 版本目录声明 CMP BOM 与配套 Kotlin。
- 各模块引用 BOM 管理的组件版本。
代码或图示
Kotlin 2.x ↔ CMP 1.7.x(以官方矩阵为准)
BOM 统一 Compose 组件与运行时版本
常见误区
- 只升级某个 Compose 库,运行时版本不一致。
- Kotlin 与 CMP 版本各自选最新,超出兼容矩阵。
追问
- 升级出问题怎么回退?答:锁定版本目录中最后验证通过的组合;升级在试点工程先跑全目标编译与冒烟,再推广。
07.2.3.2-061 Kotlin 2.x 编译器版本有哪些对齐要求?
一句话结论
Kotlin Gradle 插件、标准库、CMP、跨平台库必须落在同一兼容矩阵;K2 编译器下部分旧插件与注解处理器需确认支持,升级前在试点工程验证。
概念解释
Kotlin 2.x 默认使用 K2 编译器,语言特性与插件兼容范围与旧版本不同。跨平台库对 Kotlin 版本有发布说明;注解处理、序列化、DI 插件需确认 K2 支持。版本对齐在版本目录统一,构建期检查解析警告。不能把 JVM 项目的插件清单直接搬到 KMP。
原理流程
- 查各库对 Kotlin 2.x 与 K2 的支持说明。
- 统一插件、stdlib 与库版本。
- 试点工程全目标编译、测试与核心页面回归。
代码或图示
Kotlin Gradle 插件 = stdlib 版本 ≈ 兼容矩阵内跨平台库版本
常见误区
- 混用新旧 Kotlin 插件版本导致元数据解析失败。
- 依赖未适配 K2 的处理器,编译报错或行为异常。
追问
- 不确定某库是否支持怎么办?答:查库发行说明与 issue;试点工程编译对应 target 验证,不要在生产工程直接试错。
07.2.3.2-062 发布前兼容性测试矩阵包含哪些项?
一句话结论
矩阵覆盖目标端、操作系统版本、设备形态、网络与核心流程;公共逻辑用 commonTest 兜底,UI 与平台交互在真机/桌面/Web 环境逐项走查。
概念解释
测试维度:端(Android/iOS/桌面/Web)、系统版本、屏幕尺寸/折叠态、网络(弱网、离线)、核心业务链路。Android 覆盖主流版本与分辨率;iOS 覆盖近期大版本与机型;桌面按 OS 版本;Web 按浏览器内核。矩阵随产品支持范围维护,发版前执行冒烟与关键回归。
原理流程
- 确定支持的端与系统版本范围。
- 列出核心流程与设备/网络组合。
- 执行 commonTest、平台测试与真机走查,记录缺陷。
代码或图示
端 × 系统版本 × 设备形态 × 网络条件
核心流程:登录、列表、详情、表单、支付/提交
常见误区
- 只在最新系统与模拟器测试,遗漏旧版本与小屏。
- 公共单测通过就认为 UI 流程可用。
追问
- 矩阵怎么控成本?答:核心组合必测,长尾版本用自动化与抽样;问题高发组合优先纳入回归清单。
07.2.3.2-063 崩溃收集与日志如何接入各端?
一句话结论
公共日志/错误模型在共享层定义,平台 main 桥接到各端崩溃与日志 SDK;崩溃上下文、设备信息由平台采集,跨层只传公共错误模型。
概念解释
崩溃收集走各端原生 SDK(移动端商店/平台工具、桌面与 Web 对应方案)。共享层捕获异常并转为领域错误,附带公共上下文(页面、操作、请求标识)。平台桥接补充设备、系统、线程信息。不要把内部堆栈与用户敏感信息直接上报;日志脱敏在公共层统一。
原理流程
- common 定义错误模型与日志接口。
- 平台 main 接入崩溃 SDK 并桥接日志。
- 上报前脱敏,按隐私合规保留必要上下文。
代码或图示
interface CrashReporter {
fun report(error: AppError, context: Map<String, String>)
}
常见误区
- 跨层透传原生异常与堆栈,泄露内部实现。
- 上报包含手机号、token 等敏感字段。
追问
- 跨端问题怎么关联?答:公共层生成统一请求/会话标识,各端日志与崩溃上报带上该标识;服务端日志按标识串联。
07.2.3.2-064 隐私合规:权限声明与数据采集如何处理?
一句话结论
权限用途在平台清单声明,采集字段在公共层定义并脱敏;跨端数据最小化,共享层不持有密钥与敏感明文,合规清单按端核对。
概念解释
移动平台要求权限用途说明、隐私清单与用户授权;Web 受浏览器隐私策略约束。公共层统一数据模型与采集字段,平台桥接按本端合规要求上报。敏感信息(密码、token、身份证、位置)不入日志与崩溃上下文。第三方 SDK 清单需纳入合规评估。
原理流程
- 梳理采集字段、用途与权限清单。
- 公共层脱敏与最小化处理。
- 各端按平台要求填写声明并回归授权流程。
代码或图示
采集字段清单 → 公共脱敏 → 平台 SDK 上报 → 隐私声明/权限说明
常见误区
- 共享层把敏感明文写入本地存储或日志。
- 引入统计/推送 SDK 未纳入合规评估。
追问
- 跨端合规差异怎么对齐?答:公共层定义数据分类与最小集,平台层补充本端声明;产品发版前核对权限、隐私清单与第三方 SDK 列表。
07.2.3.2-065 多端产品版本与功能开关如何管理?
一句话结论
功能开关与灰度配置由远端配置中心下发,公共层读取统一配置;版本兼容按最低支持版本判断,平台不各自维护一套业务开关。
概念解释
多端共用一套功能开关语义:新功能、实验入口、降级策略在公共配置模型中定义。远端配置按端、版本、用户分组下发;公共层判断开关与最低版本。平台只负责配置拉取与缓存,不硬编码业务开关。配置缺失时有默认值兜底。
原理流程
- common 定义配置模型与开关默认值。
- 平台层拉取远端配置并注入。
- 业务层按开关与版本判断功能可见性。
代码或图示
data class FeatureConfig(val newCheckout: Boolean)
常见误区
- 各端代码里写死功能开关。
- 配置无默认值,拉取失败时功能状态不确定。
追问
- 开关与版本兼容怎么配合?答:配置携带最低版本要求,公共层结合 App 版本判断;旧端即使收到新开关也不开启不兼容功能。
07.2.3.2-066 可观测性:埋点与性能 trace 如何跨端复用?
一句话结论
埋点事件定义在公共层,平台桥接到各端分析 SDK;性能 trace 复用公共请求与页面阶段定义,设备与会话信息由平台补充。
概念解释
事件名、参数与时机在公共层统一,避免各端埋点口径不一致。网络请求、页面停留、关键操作可在公共层插桩;平台分析 SDK 接收事件。性能 trace 定义阶段(启动、请求、渲染),各端上报对应指标。用户标识与隐私字段按合规要求处理。
原理流程
- 公共层定义事件模型与埋点时机。
- 平台 main 接入分析 SDK 并转发事件。
- 关键阶段生成 trace,汇总到统一观测面板。
代码或图示
interface Analytics {
fun track(event: String, params: Map<String, String>)
}
常见误区
- 各端自行命名事件与参数,数据无法对齐。
- 埋点阻塞主线程或夹带敏感参数。
追问
- 跨端漏斗怎么核对?答:统一事件名与参数口径,公共层在固定时机上报;看板按端拆分,检查同一漏斗在各端的转化差异。
07.2.3.2-067 常见发布故障有哪些:签名、架构与链接?
一句话结论
高频故障集中在签名/证书错误、架构 slice 缺失或多余、框架未嵌入/链接路径错误;按产物架构、嵌入列表、签名链与缓存逐项排查。
概念解释
iOS:framework 未嵌入导致 dyld 加载失败,架构不匹配报链接错误,证书/Provisioning 不匹配签名失败。Android:依赖 ABI 与签名配置问题。桌面:JRE 缺失或打包路径错误。排查先确认产物架构与嵌入状态,再查签名与搜索路径;更新产物后清理 DerivedData/构建缓存。
原理流程
- 核对产物架构 slice 与目标设备匹配。
- 检查嵌入列表、链接路径与签名身份。
- 清理缓存重新链接,复现最小工程验证。
代码或图示
链接失败 → 嵌入列表 / 架构匹配 / 搜索路径
签名失败 → 证书 / Provisioning / 团队身份
加载失败 → 架构 slice / 框架嵌入 / 缓存旧产物
常见误区
- 改产物后不清理缓存,调试到旧 framework。
- 模拟器 slice 混入 Release 包。
追问
- 怎么预防?答:发版清单固化架构、嵌入与签名检查项;CI 构建产物自动校验架构与符号,冒烟安装到真机/干净环境。
07.2.3.2-068 发布前产物校验清单包含哪些项?
一句话结论
清单覆盖版本号、架构/产物类型、签名、资源完整性、核心流程冒烟与隐私声明;各端产物在干净环境安装启动后再交付发布。
概念解释
校验项:版本与构建号正确;iOS 架构 slice 与嵌入签名;Android 签名与 ABI;桌面安装包可在裸机启动;Web 资源可访问、路由刷新正常。核心链路冒烟:登录、列表、详情、提交。资源(字符串、图片、字体)无缺失,崩溃与日志通道可用。清单每次发版执行并留记录。
原理流程
- 构建产物并记录版本与依赖版本。
- 按端校验架构、签名、资源与配置。
- 干净环境冒烟核心流程,通过后发布。
代码或图示
版本 → 架构/签名 → 资源完整性 → 核心流程冒烟 → 隐私合规
常见误区
- 只在开发机验证安装启动。
- 发版前临时改配置未走清单复核。
追问
- 清单如何固化?答:写入构建脚本检查项与人工走查表;CI 自动校验可机器化部分,人工项保留记录,问题项阻断发布。
07.2.3.2-069 技术版本演进跟进策略是什么?
一句话结论
跟踪 Kotlin/CMP 官方发行说明与兼容矩阵,在试点工程验证后再升级生产;锁定当前稳定组合,避免追新导致平台目标与库兼容风险。
概念解释
KMP/CMP 生态迭代快:target 状态、组件覆盖、互操作导出与打包工具都可能变化。策略:生产用已验证版本组合,季度或按发版窗口评估升级;先在试点分支跑全目标编译、测试与核心页面;记录升级影响与回退版本。不把最新里程碑直接用于外发产品。
原理流程
- 订阅官方发行说明与兼容矩阵。
- 试点分支升级并执行全目标验证。
- 生产窗口统一升级,保留回退版本目录。
代码或图示
官方说明 → 试点验证 → 全目标回归 → 生产升级 → 回退预案
常见误区
- 看到新特性就升级生产工程。
- 长期不升级,积累过大版本差导致无法迁移。
追问
- 哪些变化需要重点评估?答:target 稳定性调整、expect/actual 与导出规则变化、组件库废弃、打包/签名工具链变更;升级前对照发行说明逐项核对。
07.2.3.2-070 KMP/CMP 与 Flutter、RN、原生双端在共享范围上的本质区别是什么?
一句话结论
KMP 默认共享逻辑与数据层、UI 可原生可 CMP;Flutter 自绘整套 UI;RN 用原生控件映射 + JS 桥接;原生双端各写一套。KMP 的复用边界最靠下,UI 一致性需额外选择 CMP 路线。
概念解释
KMP:公共代码编译为各端原生二进制,不接管渲染;适合已有 Android/Kotlin 团队沉淀业务层。Flutter:Dart 框架自绘 UI,跨端视觉一致但受引擎与插件生态约束。RN:JS/TS 逻辑 + 原生组件桥接,类型与性能受桥接影响。原生双端:体验最佳但重复开发。对比只在 KMP 视角下结论,不重复其他栈内部机制。
原理流程
- 明确要共享的是逻辑、UI 还是两者。
- 评估团队栈、体验要求与生态依赖。
- 用试点项目验证关键页面与性能基线。
代码或图示
KMP:逻辑/数据共享,UI 原生或 CMP
Flutter:UI + 逻辑自绘跨端
RN:JS 逻辑 + 原生控件桥接
原生:双端独立实现
常见误区
- 把 KMP 当成与 Flutter 同级的「整套 UI 跨端」方案。
- 只比框架概念,不看团队现有 Kotlin/原生资产。
追问
- 对比时最该先问什么?答:产品要复用的是业务规则还是界面呈现;团队 Android/Kotlin 基础如何;核心页面交互与第三方 SDK 依赖有多深。
07.2.3.2-071 哪类项目明确适合 KMP?
一句话结论
已有 Android/Kotlin 技术栈、双端业务规则与数据层重复度高、UI 可接受原生或部分 CMP、第三方 SDK 以标准能力为主的项目,适合先走 KMP 逻辑共享。
概念解释
适配信号:团队熟悉 Kotlin/Android;双端模型、网络、校验、用例高度一致;设计不要求两套完全独立的交互语言;核心页面非重度自绘/游戏化;平台能力可通过标准 SDK 接入。典型场景:工具类、企业应用、内容/表单型 App、后台管理配套移动应用。CMP 路线再评估 UI 复用。
原理流程
- 盘点双端重复的业务层代码与规则。
- 评估团队 Kotlin 基础与平台 SDK 依赖。
- 试点共享数据/网络层,测复用收益与接入成本。
代码或图示
适合:Kotlin 栈 + 规则重复 + UI 原生可接受 + SDK 标准
优先共享:模型、网络、校验、用例、状态机
常见误区
- 仅凭「双端都要做」就判定适合 KMP,忽略 UI 与生态差异。
- 把重度交互/游戏化页面纳入首批共享范围。
追问
- 试点怎么界定成功?答:公共层复用率、双端缺陷下降、接入工时在预期内;核心页面无不可接受的平台限制。
07.2.3.2-072 哪类项目不适合走 KMP?
一句话结论
团队无 Kotlin/原生积累、UI 高度定制且要求平台级体验、重度依赖未跨端的第三方 SDK、核心链路是图形/游戏/媒体编辑的项目,不适合首期押注 KMP/CMP。
概念解释
不适配信号:前端/JS 为主团队转 Kotlin 成本高;设计追求各端原生深度定制动画与控件;地图、相机、支付、推送等 SDK 跨端缺口大;核心页是自定义渲染、视频处理、实时交互。这类项目硬上共享层会把缺口与适配成本集中到交付期,风险高于收益。
原理流程
- 评估团队语言基础与既有原生资产。
- 审查核心页面交互与第三方 SDK 依赖。
- 缺口集中时选择原生双端或其他更匹配的栈。
代码或图示
不适合:无 Kotlin 积累 / 深度定制 UI / SDK 缺口大 / 重图形实时交互
常见误区
- 为减少重复开发,忽略适配成本与生态缺口。
- 把不适合的核心系统先迁移,再在外围补平台能力。
追问
- 部分模块可共享怎么办?答:只共享规则清晰、SDK 标准的外围模块;核心复杂链路留在原生,不要求整项目统一技术路线。
07.2.3.2-073 业务逻辑共享与 UI 共享两条路线如何选择?
一句话结论
先共享逻辑与数据层,验证收益后再决定是否用 CMP 共享 UI;逻辑共享风险低、回退简单,UI 共享受组件覆盖与后端成熟度约束,应分阶段推进。
概念解释
路线 A(逻辑共享):common 层放模型、网络、校验、用例,双端各自原生 UI。路线 B(叠加 CMP):在逻辑共享之上用公共组合函数覆盖部分页面。选择依据:UI 一致性要求、组件缺口、团队 CMP 经验、目标端成熟度。多数项目从 A 起步,避免一次性承担双份不确定性。
原理流程
- 第一阶段:抽取公共逻辑层,双端原生界面。
- 评估 UI 复用价值与 CMP 试点页面。
- 稳定后逐步扩大 CMP 页面范围。
代码或图示
阶段 1:common 业务层 + 双端原生 UI
阶段 2:试点 CMP 公共页面
阶段 3:按收益扩大 UI 复用范围
常见误区
- 立项即要求 UI 全量跨端,前置风险过高。
- 逻辑层未抽稳就叠加 CMP,问题互相干扰。
追问
- 怎么判断阶段 2 是否启动?答:逻辑复用已落地、双端缺陷下降;存在设计一致的表单/列表页;CMP 目标在当前版本可稳定承载这些页面。
07.2.3.2-074 团队既有 Android/Kotlin 栈时如何评估 KMP 收益?
一句话结论
Kotlin 语言、协程、网络与架构经验可直接迁移到共享层,主要增量成本在 iOS 工具链与互操作边界;Android 资产越完整,逻辑共享的启动收益越明确。
概念解释
已有 Android/Kotlin 团队:语言与框架学习成本低,公共层可复用既有代码风格与测试习惯。新增成本:KMP 工程结构、iOS 产物集成、Swift 互操作、非 Android target 编译。收益:双端业务规则只维护一份,模型与接口变更同步。评估时把既有 Android 业务代码抽取工作量计入,而非只看新代码。
原理流程
- 盘点可抽取的 Android 公共代码与测试。
- 估算 iOS 集成、互操作与适配工作量。
- 试点共享一个完整模块,测量复用率与工时。
代码或图示
可迁移:Kotlin、协程、网络/校验代码、测试习惯
增量成本:KMP 工程、iOS 集成、导出边界、平台适配
常见误区
- 只算新写公共层的工时,漏算存量抽取与 iOS 接入。
- 假设 Android 代码可零改造进 commonMain。
追问
- 收益怎么量化?答:对比双端重复代码量、缺陷修复重复次数、接口变更同步成本;试点模块记录共享比例与两端工时差。
07.2.3.2-075 团队无 Kotlin 基础时如何判断成本?
一句话结论
无 Kotlin/原生积累时,KMP 同时承担语言学习、跨平台工程与 iOS 集成成本,首期风险高;建议先评估是否有更匹配的栈,或在小模块引入并配置培训周期。
概念解释
KMP 不是低门槛全栈银弹:公共层仍需 Kotlin 与协程能力,iOS 侧还要理解框架集成与互操作。JS/TS 为主团队若核心诉求是 UI 快速跨端,RN/Flutter 路径可能更顺;若长期沉淀 Android/Kotlin 产品,补 Kotlin 能力有复利。成本评估包含招聘、培训与试点容错时间。
原理流程
- 评估现有语言栈与人员结构。
- 估算学习曲线、招聘周期与试点失败容忍度。
- 小模块试点,按实际产出再决定扩大。
代码或图示
无 Kotlin 基础:语言学习 + 工程结构 + iOS 集成三重成本
常见误区
- 把 KMP 描述为「会写 Android 就会跨端」。
- 首期把核心业务押给不熟悉的技术栈。
追问
- 最小可行试点怎么选?答:选规则清晰、无复杂 SDK 的外围模块;目标是跑通工程与发布链路,而非追求最大代码复用。
07.2.3.2-076 与 Flutter 对比:UI 一致性与原生能力边界怎么看?
一句话结论
Flutter 自绘 UI,双端视觉一致性强、组件自包含;KMP/CMP 不保证 UI 一致,优势在 Kotlin 栈与原生二进制复用。要整套一致界面选 Flutter 路线更直接,要保留原生体验与 Kotlin 资产选 KMP。
概念解释
Flutter 用 Dart 引擎渲染自有控件,跨端外观由框架控制;插件通道接入原生能力。KMP 公共层是原生编译产物,UI 可保持各端原生规范,CMP 组件覆盖度弱于成熟自绘框架。决策点:设计是否要求跨端像素一致、团队是否接受 Dart 与引擎升级、原生插件生态是否覆盖需求。
原理流程
- 明确 UI 一致性要求与交互复杂度。
- 对比团队栈、插件缺口与性能基线。
- 两个框架各做一个核心页面试点。
代码或图示
Flutter:自绘 UI,一致性强,Dart/引擎依赖
KMP:原生产物,逻辑复用,UI 原生或 CMP 适配
常见误区
- 用 CMP 早期演示效果对标 Flutter 成熟组件库。
- 忽略 Flutter 插件缺口在特定原生能力上的约束。
追问
- 两者能共存吗?答:一个产品内可按模块分栈,但维护两套技术栈与人员能力成本高;跨模块通信要明确边界,不建议长期混用于同一团队。
07.2.3.2-077 与 React Native 对比:类型安全、性能与桥接成本如何?
一句话结论
KMP 编译为原生二进制、静态类型与共享编译期校验更强;RN 走 JS 桥接,动态生态灵活但类型/性能受桥接约束。强类型业务与原生性能优先 KMP,动态化与 JS 生态优先 RN。
概念解释
RN 逻辑在 JS/TS 运行时,通过桥接访问原生组件与模块;KMP 公共代码编译进各端原生二进制,无运行时桥接层。类型安全、重构与编译期错误发现 KMP 占优;RN 优势是 JS 人才、动态发版与既有生态。桥接成本随原生模块数量增长,KMP 的互操作成本集中在导出边界。
原理流程
- 评估业务类型:静态规则密集还是动态内容为主。
- 对比桥接次数、性能敏感路径与人员供给。
- 试点相同页面测量体积、启动与滚动表现。
代码或图示
KMP:原生二进制 + 静态类型,无 JS 运行时桥接
RN:JS/TS 运行时 + 原生桥接,动态化灵活
常见误区
- 把 RN 桥接问题泛化为所有跨端方案的共性。
- 忽略 KMP 在 Swift/ObjC 边界同样需要互操作适配。
追问
- 动态发版需求怎么取舍?答:RN/JS 包可热更新,KMP 二进制修改需随包发布;需要高频动态化的业务模块应单独评估栈选择。
07.2.3.2-078 与原生双端对比:重复开发成本与维护风险如何评估?
一句话结论
原生双端体验与平台跟随最好,但规则、模型、接口修复要重复两遍;KMP 用工程与互操作成本换取业务层单一维护,重复度越高、规则越稳定,共享收益越大。
概念解释
原生路线:Android 与 iOS 独立实现,可深度使用各端最新特性,缺点是双份代码、双份测试与缺陷修复。KMP 共享层把稳定规则下沉,平台 UI 与能力仍原生。评估指标:双端重复代码量、接口变更频率、缺陷重复率、团队规模。规则常变或平台差异极大的部分,共享收益有限。
原理流程
- 统计双端重复的模型、规则与用例。
- 估算共享层抽取、测试与平台适配成本。
- 对比原生双端长期维护成本与风险。
代码或图示
原生:体验最佳,重复开发/测试/修复
KMP:业务层单一维护,工程与边界成本前置
常见误区
- 只算开发人力,不算双端测试与长期缺陷维护。
- 把频繁变动的业务规则强行公共化,接口不稳定。
追问
- 什么时候原生双端更划算?答:产品生命周期短、双端规则差异大、团队小且平台经验深;共享带来的工程成本超过重复开发时,保留原生。
07.2.3.2-079 除移动外还要覆盖桌面/Web 时如何取舍?
一句话结论
KMP 逻辑层可服务多端,UI 是否用 CMP 覆盖桌面/Web 取决于目标成熟度与页面类型;Web 目标未稳定前,桌面可用 Compose Desktop 试点,Web 优先独立技术栈。
概念解释
同一套模型、网络与规则可被 Android、iOS、桌面、Web 复用。UI 层:桌面目标比 Web 成熟,工具类应用可评估 Compose Desktop;Wasm Web 目标适合内部轻量页面试点,外发产品需验证浏览器兼容与性能。多端覆盖扩大了共享层价值,但每个新增目标都有独立适配与验证成本。
原理流程
- 列出目标端与页面类型。
- 核对各 CMP 目标稳定性与缺口。
- 逻辑层统一复用,UI 按目标成熟度分批覆盖。
代码或图示
共享逻辑层 → Android / iOS / Desktop / Web
UI 成熟度:Desktop 试点可用,Web 按版本验证(待确认)
常见误区
- 按移动端进度假设 Web 目标同期可用。
- 为多端目标一次性预留全部 UI 抽象,复杂度前置。
追问
- 一套产品同时要移动、桌面、Web 怎么排期?答:先统一后端与共享逻辑;移动双端优先,桌面按工具场景试点,Web 评估独立栈与 CMP Web 试点结果后再定。
07.2.3.2-080 第三方生态依赖度高的项目如何评估 KMP?
一句话结论
逐个核对关键 SDK 是否有 KMP 构件或可封装的平台适配;核心链路依赖的 SDK 缺口多、且无法接受平台封装成本时,KMP 不应作为首选。
概念解释
依赖清单:支付、登录、推送、统计、地图、相机、即时通讯、图表、图片加载。每个 SDK 评估:多平台构件、双端功能对等、维护活跃度。缺口 SDK 走平台适配层,工作量按接口方法与双端差异估算。核心链路 SDK 缺失比工具库缺失风险更高。
原理流程
- 列出不可替换的核心 SDK 清单。
- 核对各 SDK 跨平台支持与版本活跃度。
- 缺口项估算适配成本,纳入选型决策。
代码或图示
核心 SDK:支付 / 登录 / 推送 / 地图 / IM
判定:有 KMP 构件 > 可平台封装 > 无法对等支持
常见误区
- 只看 Android 侧 SDK 齐全,忽略 iOS 对应能力。
- 低估双端 SDK 接口不对等带来的公共契约裁剪。
追问
- 适配层成本怎么估?答:每个 SDK 按方法数 × 双端接入工时;公共契约取双端能力交集,缺失能力在对应端标注不可用。
07.2.3.2-081 交互重、动画重的页面是否适合 CMP?
一句话结论
基础动画与列表交互可用 CMP 试点;重度自定义渲染、实时手势、游戏化/媒体编辑页面留在原生,避免受组件覆盖与后端性能约束。
概念解释
CMP 动画 API 与 Canvas 可覆盖常规过渡、卡片与表单交互;复杂场景:高频手势追踪、自绘图形引擎、视频/相机实时处理、长列表高自定义项。这类页面后端渲染与事件链路未经生产验证时风险高。判断依据:动画帧率要求、绘制复杂度、是否依赖平台图形能力。
原理流程
- 拆解页面动画与手势复杂度。
- 基础交互进 CMP 试点测量帧率。
- 重度渲染页面保留原生实现。
代码或图示
可试点:淡入淡出、属性动画、标准列表
保留原生:实时手势、自绘引擎、媒体/游戏化
常见误区
- 用演示动画流畅度推断复杂页面性能。
- 把图形密集页面拆给公共层,后期再迁回原生。
追问
- 试点怎么测重度页面?答:低端机型长列表与连续动画测帧时长、内存与掉帧;达不到基线则该页面维持原生,不强行复用。
07.2.3.2-082 存量原生应用渐进式接入 KMP 的路径是什么?
一句话结论
先抽公共逻辑层与新模块,再按页面替换 UI;保持原生工程可独立运行,每阶段可回退,不一次性迁移存量代码。
概念解释
渐进路径:新建 shared 模块 → 抽取模型/网络/校验 → 新业务用共享层 → 老页面按批次迁移 → 评估 CMP 页面。存量原生页面不强制重写;共享层通过接口接入既有代码。每步保留双端独立构建与回退能力,避免大爆炸式迁移。
原理流程
- 建 KMP 模块并接入现有 app 工程。
- 抽取稳定公共规则与模型。
- 新功能优先走共享层,老页面分批替换。
代码或图示
shared 模块 → 规则抽取 → 新功能共享 → 老页面分批迁移 → CMP 评估
常见误区
- 要求存量代码全量重写后再接入。
- 迁移期公共层与原生逻辑双份维护且边界不清。
追问
- 第一批迁移选什么页面?答:规则清晰、SDK 依赖标准、交互简单的表单/列表页;避开复杂列表、媒体与核心交易页。
07.2.3.2-083 先共享数据/网络层再共享 UI 的迁移节奏怎么安排?
一句话结论
数据模型、序列化、网络与仓储先下沉 common 并补测试;稳定后再叠 CMP 页面,避免在未抽稳的业务层上构建跨端 UI。
概念解释
数据层是 UI 的基础:模型、错误类型、仓库接口稳定后,公共组合才有可依赖的契约。先补 commonTest 覆盖规则与解析;数据层双端接入并观察缺陷。之后选设计一致的页面做 CMP 试点,逐步扩大。节奏颠倒会导致 UI 与数据层一起返工。
原理流程
- 下沉模型、序列化、网络配置与仓库接口。
- commonTest 覆盖解析、校验与错误分支。
- 数据层稳定后启动 CMP 页面试点。
代码或图示
模型/序列化 → 网络/仓储 → 测试稳定 → CMP 页面试点
常见误区
- 数据接口频繁变更时同步做公共 UI,返工放大。
- 公共层缺测试,双端行为分歧难以发现。
追问
- 数据层稳定的标志是什么?答:模型与仓库接口变更收敛,commonTest 通过,双端接入后缺陷不再集中在解析与规则层。
07.2.3.2-084 迁移期双端代码并存如何划分边界?
一句话结论
公共层只放跨端稳定规则与模型;未迁移页面留在原生,平台适配代码归平台源集;边界用接口与公共模型固定,禁止 common 反向依赖平台类型。
概念解释
并存期最大风险是边界模糊:公共层混入平台调用,原生层复制公共规则。划分原则:可跨端复用且稳定的下沉 common;平台 SDK、UI、生命周期留平台;过渡期双份代码只允许存在于未迁移页面,公共规则只维护一份。评审检查依赖方向与重复规则。
原理流程
- 标注每个模块/页面的迁移状态。
- 规则下沉 common,平台能力留平台。
- 评审拦截反向依赖与重复实现。
代码或图示
common:模型、规则、仓库接口
平台 main:SDK 封装、UI、生命周期
未迁移页面:原生实现,暂不复用公共规则
常见误区
- 过渡期公共规则在原生层又写一份,后续不一致。
- common 引用平台类型,边界被突破。
追问
- 怎么发现重复规则?答:评审按业务规则清单核对;定期扫描双端相同逻辑,未迁移部分列入后续批次。
07.2.3.2-085 回退方案与代码剥离成本如何评估?
一句话结论
共享层以接口与模块隔离,试点失败可从 app 依赖中移除并恢复原生实现;剥离成本取决于公共层与原生代码的耦合度,接口注入越低耦合越易回退。
概念解释
回退预案在选型期就要准备:哪些页面/模块已共享、依赖如何注入、原生实现是否保留。公共层通过接口被消费,移除 shared 依赖后原生接管;若共享类被原生直接继承或静态耦合,剥离成本高。试点项目应控制范围,保留旧实现作为回退路径。
原理流程
- 记录共享模块清单与消费方。
- 公共层经接口注入,避免静态耦合。
- 回退时移除依赖、恢复原生实现并回归。
代码或图示
接口注入 → 可移除 shared → 原生实现接管
静态耦合 → 剥离需改造原生调用点
常见误区
- 试点未设回退边界,失败后公共代码散落各端。
- 回退时才发现原生旧实现已被删除。
追问
- 怎么量化剥离成本?答:统计公共类被原生直接引用的位置;接口隔离程度高则移除依赖即可,直接继承/静态调用点越多改造量越大。
07.2.3.2-086 CI 与团队协作:模块拆分、评审与测试门禁如何安排?
一句话结论
按业务层拆模块,公共 API 走评审;CI 跑 commonTest 与核心目标构建,公共层变更必须补测试,平台适配单独评审。
概念解释
协作规则:模块边界与依赖方向写入工程规范;公共接口、数据模型变更需要评审。CI 分级:PR 跑公共测试与编译,合并前全目标构建。代码评审检查平台 API 是否误入 common、跨层类型是否泄漏。测试门禁:公共规则无测试不合并,平台缺陷在对应端回归。
原理流程
- 模块按 core-model/network/database/feature 拆分。
- 公共 API 变更走评审与版本记录。
- CI 分级执行测试、构建与产物校验。
代码或图示
PR:commonTest + 核心 target 编译
合并前:全 target 构建 + 测试 + 冒烟
评审:依赖方向 / 平台类型泄漏 / 测试覆盖
常见误区
- 公共层无测试门禁,行为分歧流入双端。
- 模块按 target 拆分,common 无法复用。
追问
- 跨端变更怎么同步评审?答:公共模型/接口变更通知双端负责人;平台适配改动只在对应端评审,公共契约变更必须双方确认。
07.2.3.2-087 招聘与人才供给风险如何控制?
一句话结论
KMP 人才供给小于 Android/iOS 原生与 Web 主流栈;选型前评估内部 Kotlin 储备与培训周期,关键岗位能招聘到,避免技术栈押注后无人维护。
概念解释
市场上成熟 KMP/CMP 工程师少于原生与前端;可迁移来源是 Android/Kotlin 开发者。风险:项目中途人员流失、招聘周期长、外部顾问成本高。缓解:内部培训 Kotlin 与共享层规范,沉淀工程模板与文档,核心模块不依赖个别专家。选型时把人才可得性列为硬指标。
原理流程
- 盘点内部 Kotlin/Android 经验与可培养人员。
- 评估目标城市/渠道招聘周期。
- 沉淀模板、规范与知识文档降低专家依赖。
代码或图示
内部 Kotlin 储备 → 培训路径 → 招聘渠道验证 → 文档/模板沉淀
常见误区
- 只看技术先进性,不看本地人才供给。
- 工程经验集中在一两个人身上。
追问
- 小团队怎么控风险?答:首期范围小、模块边界清;优先复用成熟模板与官方文档,关键决策留记录,不引入未验证的自研框架。
07.2.3.2-088 生态成熟度风险:库缺口与平台目标变化如何跟踪?
一句话结论
持续跟踪组件库 target 覆盖、CMP 目标稳定性与互操作导出规则;选型结论随版本复核,试点期记录缺口清单并设退出条件。
概念解释
生态风险来源:第三方库未适配 KMP、CMP 目标从实验转稳定或调整、导出/打包规则变化。跟踪渠道:官方文档与发行说明、issue 跟踪、试点工程编译结果。每个关键依赖记录版本、target 与已知问题;版本升级后回归缺口清单。试点设明确退出条件:核心页面无法落地即回退原生。
原理流程
- 建立关键库与目标状态清单。
- 版本升级后复核清单与试点页面。
- 触发退出条件时按预案回退。
代码或图示
库 target 覆盖 / 目标稳定性 / 导出打包规则
→ 试点缺口清单 → 版本复核 → 退出条件
常见误区
- 一次选型结论长期沿用,不随版本复核。
- 缺口只记问题,不记录影响范围与替代方案。
追问
- 退出条件怎么写?答:核心页面在当前版本无法稳定渲染/交互,或关键 SDK 无法对等接入且适配成本超预算;满足其一即停止扩大共享范围。
07.2.3.2-089 供应商与长期维护风险如何判断?
一句话结论
看核心依赖的维护活跃度、版本兼容承诺与社区规模;内部掌握共享层源码与构建链,避免关键能力绑定单一不可控外部实现。
概念解释
长期风险:库停更、目标撤销、作者不再适配新 Kotlin 版本。评估:提交频率、issue 响应、发布节奏、被大厂/项目采用程度。核心网络、序列化、DI 优先选活跃多平台库;自研封装保留替换空间。工程文档记录依赖选型理由与替代方案,避免黑盒依赖。
原理流程
- 盘点核心依赖与替代候选。
- 检查活跃度、兼容矩阵与社区规模。
- 公共层经接口隔离,保留替换路径。
代码或图示
活跃度 / 发布节奏 / 兼容维护 / 社区采用
→ 接口隔离 → 可替换实现
常见误区
- 引入个人维护的小众库承载核心链路。
- 业务代码直接耦合库内部类型,替换成本高。
追问
- 库停更了怎么办?答:公共接口隔离下切换实现;关键模块预留自研或替代库方案,升级前先在试点验证新组合。
07.2.3.2-090 场景题:电商类多端应用如何选 KMP 方案?
一句话结论
电商的商品、订单、购物车规则与模型适合 KMP 逻辑共享;首页营销、直播、支付与地图等强 SDK/重交互页面保留原生,CMP 只在表单/列表类页面试点。
概念解释
可共享:商品模型、价格/优惠规则、购物车状态、下单校验、地址簿、序列化与网络层。原生保留:首页信息流、直播/短视频、支付收银台、地图配送、推送与画像 SDK。团队若为 Android/Kotlin 栈,先抽 common 业务层;UI 一致性要求高的活动页不首批进 CMP。
原理流程
- 划分可共享规则与平台/重交互页面。
- 共享数据与用例层,双端原生 UI。
- 试点简单列表/表单页 CMP,核心交易链路不动。
代码或图示
共享:商品/购物车/订单规则、地址、校验
原生:营销信息流、直播、支付、地图、推送
常见误区
- 把收银台与直播页纳入首批跨端 UI。
- 优惠规则在双端各写一份,后续不一致。
追问
- 电商多端怎么控风险?答:交易链路保持原生成熟实现;共享层先服务浏览与辅助功能,缺陷率下降后再评估更多页面。
07.2.3.2-091 场景题:工具类桌面加移动应用如何选型?
一句话结论
规则简单、表单与列表为主的工具应用适合 KMP 共享逻辑,桌面端可评估 Compose Desktop,移动端原生或 CMP 试点;媒体处理、自定义图形类工具另评估原生。
概念解释
典型工具:笔记、记账、待办、格式转换、管理助手。共享模型、校验、存储与同步规则;桌面窗口、菜单、文件对话框在 desktopMain 实现。若核心价值是批量文件处理、图形编辑或系统深度集成,桌面原生框架可能更稳。先抽逻辑层,桌面 UI 按成熟度试点。
原理流程
- 识别工具核心规则与文件/系统能力依赖。
- 共享逻辑层,桌面能力在 desktopMain 封装。
- 试点 Compose Desktop 界面,测量打包体积与启动。
代码或图示
共享:模型、规则、同步
Desktop:窗口/菜单/文件对话框(desktopMain)
常见误区
- 工具重度依赖本地文件系统仍强行公共化。
- 桌面打包未在裸机验证安装与 JRE 依赖。
追问
- 跨端数据怎么同步?答:本地存储接口在 common 抽象,各端实现;云端同步规则共享,冲突策略在公共层定义。
07.2.3.2-092 场景题:强原生交互的社交/内容 App 适合 KMP 吗?
一句话结论
信息流、直播、相机、实时互动与深度动画为主的社交内容产品,首期不适合押注 CMP UI;可在账号、设置、私信规则等外围模块共享逻辑,核心体验保留原生。
概念解释
这类产品的竞争力在滚动帧率、相机/美颜、实时连麦、手势与动画,依赖平台图形与音视频 SDK。KMP 逻辑共享可覆盖用户模型、关系链规则、设置项;CMP 渲染后端在重度交互上未经同等验证。团队若有原生双端能力,核心链路维持原生更稳。
原理流程
- 标注核心体验页与依赖的音视频/图形 SDK。
- 外围规则模块抽取共享层。
- 核心页面保持原生,不纳入 CMP 首批范围。
代码或图示
共享:账号、关系链规则、设置、私信模型
原生:信息流、直播、相机、实时互动、重度动画
常见误区
- 为减少双端重复把核心滑动/相机页纳入跨端。
- 用基础动画效果推断重度交互可行。
追问
- 后续能否扩大共享?答:待 CMP 目标在同类页面验证帧率与稳定性后,再评估非核心页面;核心音视频链路长期保留原生。
07.2.3.2-093 场景题:企业内部多端后台如何选 KMP?
一句话结论
内部管理类应用表单、列表与规则密集,用户规模可控,适合 KMP 共享逻辑;桌面/Web 后台可独立 Web 栈,移动与桌面工具按 Compose Desktop 试点,内部环境降低了外发合规压力。
概念解释
内部系统:审批、报表、库存、客户管理。数据模型与校验规则重复度高,交互标准,第三方 SDK 简单。共享层沉淀业务规则;移动端原生或 CMP 试点,桌面端 Compose Desktop 或现有 Web 后台。内部项目可容忍试点迭代,适合验证 KMP 工程模板。
原理流程
- 梳理表单、列表与审批规则。
- 共享 common 业务层与存储接口。
- 移动/桌面按目标成熟度实现 UI,Web 后台独立栈。
代码或图示
共享:模型、校验、审批规则
移动端:原生 / CMP 试点
桌面:Compose Desktop 或 Web
常见误区
- 内部系统也追求一次覆盖全部端 UI。
- 忽略内部设备系统版本与浏览器清单。
追问
- 内部项目选型优势是什么?答:用户与合规范围可控,试点失败回退成本低;适合沉淀 KMP 模块模板、CI 流程与公共组件,再决定对外产品是否复用。
07.2.3.2-094 KMP 视角的选型决策清单包含哪些项?
一句话结论
按团队栈、重复业务规则、UI 一致性要求、SDK 依赖、目标端成熟度、人才供给与回退成本逐项打分;任一硬约束不满足就不把 KMP 作为首选。
概念解释
清单维度:现有 Kotlin/Android 资产;双端规则重复度;设计是否要求跨端一致 UI;关键 SDK 跨端支持;CMP 目标在当前版本稳定性;招聘与培训;试点可回退性。每项给出现状、证据与风险,结论区分「逻辑共享」「叠加 CMP」「不采用」。清单不是打分表走形式,每项要能追溯到代码、SDK 文档或试点结果。
原理流程
- 收集团队、业务、SDK 与目标端事实。
- 逐项对照硬约束与加分项。
- 形成路线结论与试点范围、退出条件。
代码或图示
团队栈 / 规则重复度 / UI 要求 / SDK 缺口 / 目标成熟度 / 人才 / 回退成本
常见误区
- 只凭框架热度或单篇教程下结论。
- 清单结论无证据支撑,试点失败无法复盘。
追问
- 哪些是硬约束?答:核心 SDK 无法对等接入、团队完全无 Kotlin 储备且无培训周期、核心页面重度图形实时交互;命中其一应谨慎采用。
07.2.3.2-095 如何向非技术干系人说明 KMP 收益?
一句话结论
用「同一套业务规则双端维护、减少重复开发与同步缺陷」表达价值,同时说明 UI 仍可保持原生,技术风险通过小范围试点与回退控制。
概念解释
非技术干系人关心工期、质量与成本。沟通要点:双端重复的规则只写一份;接口与规则变更不再两边同步;试点模块先验证收益;不是一次性替换全部 App。避免堆砌编译器、框架名词,用缺陷重复次数、工时与维护成本等业务指标说明。风险与试点边界要同时讲清。
原理流程
- 对齐业务目标:工期、质量、维护成本。
- 用重复代码与缺陷数据说明共享价值。
- 说明试点范围、周期与回退预案。
代码或图示
收益:规则一份维护 → 减少重复开发/同步缺陷
边界:UI 可原生,试点先行,可回退
常见误区
- 承诺「一套代码所有端完全一致」。
- 只讲技术先进性,不给成本与风险对照。
追问
- 怎么量化汇报?答:试点前后对比双端重复代码量、同类缺陷修复次数、接口变更同步工时;未达预期指标即按预案收缩范围。
07.2.3.2-096 跨端选型中有哪些常见误区?
一句话结论
常见误区:把 KMP 当整套 UI 跨端框架、按演示效果判断生产成熟度、忽略 SDK 缺口与人才供给、一次性迁移存量代码、不设回退条件。
概念解释
逐条对照:KMP 首先是逻辑共享方案;组件覆盖与目标稳定性要查官方文档与真机验证;第三方 SDK 双端对等性必须盘点;团队 Kotlin 能力与招聘周期计入成本;迁移分阶段保留原生路径;试点写明退出条件。选型争论中最容易被忽略的是长期维护成本与生态风险,而非框架概念。
原理流程
- 复盘候选方案的假设是否有证据。
- 核对 SDK、目标成熟度与人才事实。
- 补充试点边界、指标与回退预案。
代码或图示
误区:UI 全共享假设 / 演示即生产 / SDK 漏盘 / 人才低估 / 大爆炸迁移 / 无退出条件
常见误区
- 用其他跨端框架的成功经验直接套 KMP。
- 选型只比功能清单,不比工程与维护成本。
追问
- 怎么检查自己的选型结论?答:每个结论标注证据来源(代码、SDK 文档、试点数据);无证据的乐观假设列为待验证风险。
07.2.3.2-097 试点项目如何界定范围与验收指标?
一句话结论
试点选规则清晰、SDK 标准的外围模块,验收看公共层复用率、双端缺陷、接入工时与目标端稳定性;指标未达预期即停止扩大。
概念解释
试点目标是验证工程链路与收益假设,不是赶业务进度。范围:一个完整模块(模型、仓库、简单页面)。指标:共享代码比例、双端重复缺陷数、试点工时对比预估、各端编译/运行稳定性、关键页面帧率。周期与退出条件预先约定,避免试点变成长期磨合。
原理流程
- 选定低耦合外围模块与验收指标。
- 跑通构建、测试、发布链路。
- 对照指标决定扩大、调整或回退。
代码或图示
范围:单模块 + 简单页面
指标:复用率 / 缺陷重复 / 工时 / 稳定性 / 帧率
常见误区
- 试点选核心复杂页面,风险集中无法判断方案本身。
- 不设量化指标,凭感觉决定推广。
追问
- 试点成功后怎么推广?答:按模块批次扩大,公共组件与模板沉淀;每批重复验收指标,出现回退信号即暂停。
07.2.3.2-098 KMP 路线长期演进应关注什么?
一句话结论
关注 Kotlin/CMP 目标稳定性、组件库覆盖、互操作导出能力与团队工程模板;长期保持小步升级,公共层抽象与平台边界随版本复核。
概念解释
生态演进方向:新 target 成熟、组件补齐、导出与打包工具改善。长期维护要点:版本目录锁定兼容组合;公共 API 变更走评审;模块边界与测试门禁持续有效;文档记录平台适配决策。定期复核选型结论,而不是立项后技术路线固化不变。
原理流程
- 订阅官方发行说明与兼容矩阵。
- 季度复核目标状态、库缺口与升级窗口。
- 试点验证后统一升级,更新工程模板。
代码或图示
目标稳定性 / 组件覆盖 / 导出打包 / 团队模板
常见误区
- 长期不升级,版本差过大无法迁移。
- 生态变化后仍沿用早期缺口判断。
追问
- 长期维护最大的隐性成本是什么?答:平台边界适配与互操作问题随版本累积;公共层抽象清晰、测试齐全,才能把升级成本控制在可接受范围。
07.2.3.2-099 面试中如何回答「为什么选 KMP 而不是 Flutter」?
一句话结论
先澄清共享目标:要跨端一致 UI 选 Flutter 更直接;已有 Kotlin/Android 资产、希望保留原生体验并共享业务规则,KMP 更匹配,CMP 只在需要时覆盖部分 UI。
概念解释
回答结构:承认 Flutter 在自绘 UI 一致性上的优势;说明本项目团队栈、规则重复度与体验要求;KMP 复用 Kotlin 资产、产物为原生二进制、UI 不被框架接管;CMP 作为可选 UI 层试点。不要贬低任一框架,按项目约束给结论。可补充试点验证与回退思路。
原理流程
- 明确产品要共享逻辑还是整套 UI。
- 对照团队栈、体验与 SDK 约束。
- 给出 KMP 适用结论与 Flutter 的适用场景。
代码或图示
整套一致 UI → Flutter
Kotlin 栈 + 原生体验 + 规则共享 → KMP(必要时叠加 CMP)
常见误区
- 回答成「KMP 比 Flutter 先进」。
- 不区分逻辑共享与 UI 共享,结论模糊。
追问
- 被追问 CMP 与 Flutter 组件差距怎么答?答:CMP 组件覆盖与后端成熟度随版本演进,当前以试点真机结果为准;不能用演示效果对标成熟自绘框架,选型前必须验证目标页面。
07.2.3.2-100 如何形成最终的跨端选型结论?
一句话结论
结论必须落到项目约束:团队栈、业务重复度、UI 要求、SDK 依赖、目标端成熟度、成本与风险;先逻辑共享、再评估 UI 复用,并附试点指标与回退条件。
概念解释
最终结论不是罗列方案优缺点,而是在本项目事实上做取舍:明确采用 KMP 的范围(哪些模块共享逻辑、是否试点 CMP 页面)、不采用部分(保留原生的页面与能力)、验证计划与退出条件。证据来自代码盘点、SDK 文档、试点数据与人才评估。结论可随版本复核更新。
原理流程
- 汇总选型清单事实与证据。
- 划定共享范围、原生保留范围与试点计划。
- 约定验收指标、升级窗口与回退预案。
代码或图示
事实盘点 → 共享/原生边界 → 试点与指标 → 退出条件 → 定期复核
常见误区
- 结论只有「用 KMP」,没有范围与风险边界。
- 忽略成本、人才与长期维护,只看技术可行性。
追问
- 一份完整选型结论应包含什么?答:背景约束、候选方案对照、推荐路线、共享范围、试点模块与指标、风险清单、回退方案与复核周期;缺一项都不算可执行结论。
参考来源
- Compose Multiplatform 官方站点:CMP 目标、组件与发布信息总览。
- Kotlin Multiplatform 官方文档:KMP 工程结构、共享层与 target 组织。
- Compose Multiplatform 文档:CMP 工程配置、平台目标与能力说明。
- Android 官方 KMP 指南:Android 侧接入 KMP 的官方实践。
- Compose Multiplatform 帮助文档:桌面打包、组件与开发工具参考。
待整理清单
- [ ] 核对 CMP 1.7.x 各目标(iOS/Desktop/Web Wasm)当前稳定性分级与已知限制
- [ ] 补充 Material 组件在 CMP 各端的覆盖清单与版本对照
- [ ] 补充 CMP 导航、图片加载、状态订阅的多平台库选型矩阵
- [ ] 核对 macOS 公证、Windows 签名与 jpackage 打包的当前系统要求
- [ ] 补充 Web(Wasm)产物拆分、缓存与浏览器兼容的实测基线
- [ ] 整理 KMP/Flutter/RN/原生双端在本项目约束下的对照案例与量化指标