07.1.1.7.3 性能、测试与互操作
所属:全栈开发面试题库 / 07 端侧与桌面开发 / 07.1 原生移动开发 / 07.1.1 Android / 07.1.1.7 Jetpack Compose 深入
本节要解决的问题
本节覆盖重组性能诊断手段、Baseline Profile 与基准测试、Compose 单元/仪器化测试与语义树、@Preview 多设备验证,以及与 View 体系互操作和跨模块编译配置。版本基线:Compose BOM 2024.x、Kotlin 2.x、Android 14 / compileSdk 34;版本敏感行为标「待确认」并写明验证点。
07.1.1.7.3-001 如何查看一个可组合项的重组次数与跳过次数?
一句话结论
Android Studio 的 Layout Inspector 可查看节点的重组次数(recompose count)与跳过次数(skip count),配合日志或编译器报告定位高频重调节点。
概念解释
Inspector 连接运行中的应用,在 Compose 树中展示每个节点被执行与被跳过的统计。重组次数高且与状态变化不匹配,说明作用域过大或参数不稳定。调试版可开启相关统计,发布版不依赖该计数做性能结论。
原理流程
连接设备/模拟器 → 打开 Layout Inspector
→ 选择 Compose 页签 → 查看节点 Recompose / Skip 计数
→ 交互触发状态变化 → 观察哪些节点计数上涨
代码或图示
节点 A:recompose 12,skip 0 → 每次都重调,排查稳定性
节点 B:recompose 1,skip 11 → 可跳过,表现正常
常见误区
- 把首次组合计入重组次数,基线对比时未排除首帧。
- 只看函数调用日志,未区分跳过与实际重调。
追问
- 计数为零说明什么?答:节点未被重新执行;需结合是否首次组合与是否被跳过判断。
- 发布包能看到这些统计吗?答:统计能力依赖调试信息,性能结论应以 Profiler 轨迹与线上指标为准。
07.1.1.7.3-002 Compose 编译器稳定性报告在哪里查看,能说明什么?
一句话结论
编译器在构建输出或专用报告中标记参数类型是否稳定/不稳定,帮助定位无法跳过的可组合项;具体开关与报告位置随 Kotlin/Compose 编译器版本变化。
概念解释
稳定性推导结果决定节点能否跳过。报告中标注不稳定的参数类型,提示需要不可变化、注解或不可变包装。Kotlin 2.x 下编译器插件并入 Kotlin 仓库,报告入口与旧版 Compose 编译器可能不同,需以目标版本构建文档为准(待确认)。
原理流程
构建编译 → 稳定性推导
→ 报告:stable / unstable 类型与参数
→ 针对不稳定项改造数据模型
代码或图示
unstable: MutableList<Item>、捕获可变引用的 lambda
stable: String、基本类型、@Immutable 数据类
常见误区
- 只看运行时计数,不在编译期排除不稳定参数根因。
- 跨版本照搬旧版报告开关名,未核对 Kotlin 2.x 配置。
追问
- 报告中的泛型如何判定?答:泛型实参稳定性参与推导,未约束的泛型按保守规则处理。
- 在哪里开启详细日志?答:查目标编译器版本的构建选项说明,先在样例模块验证输出格式。
07.1.1.7.3-003 哪些反模式会导致可组合项无法被跳过?
一句话结论
不稳定参数(可变类、可变集合、捕获可变引用的 lambda)、泛型未约束、在主体中读取无关高频状态,都会让编译器无法生成跳过分支。
概念解释
跳过需要参数稳定且 equals 相等。常见反模式:传 MutableList、data class 含可变字段、lambda 闭包捕获 Activity 或可变 var、直接传未标注第三方类型。状态读取点过大也会让节点被动进入重组候选。
原理流程
参数不稳定 → 跳过检查保守失败
→ 父级重组 → 子节点每次重调
代码或图示
// 反例:可变集合 + 捕获可变状态的回调
@Composable
fun Bad(items: MutableList<Item>, onClick: () -> Unit) { }
常见误区
- 以为引用相等就跳过,类型不稳定时引用相等也不跳过。
- 在子组件内新建 lambda 传给更深节点,每组合成不稳定参数。
追问
- 改造顺序?答:先把数据模型不可变化,再稳定 lambda 捕获,最后用注解承诺契约。
- 第三方类型不稳定怎么办?答:边界映射为本地不可变数据类,不轻易标注 @Stable 承诺不成立的契约。
07.1.1.7.3-004 如何把状态读取限制在最小作用域内以减少重组范围?
一句话结论
把 State 读取下沉到真正消费它的叶子组件,父级只下传稳定参数;拆分大组件,避免在容器顶部读取局部状态。
概念解释
读取状态的 group 是重组作用域边界。父层读取后整段子树进入候选;下沉读取后只有叶子节点订阅。配合稳定参数,无关兄弟节点可被跳过。大函数拆成小组件是缩小作用域的主要手段。
原理流程
反例:Column 顶部读 state.value → 整列候选
改进:Avatar 内部读 state → 仅 Avatar 重组
代码或图示
Column {
Avatar(profile) // Avatar 内部读取所需字段
Actions() // 不订阅该状态
}
常见误区
- 把整个 UiState 在容器读取后拆字段下发,容器仍订阅整个状态对象。
- 组件拆分过粗,一个函数承载多个独立状态的 UI。
追问
- 多个叶子共用同一状态怎么办?答:各自读取同一 State,订阅范围仍按叶子划分;不要在中间层集中读取。
- 读取下沉后参数怎么传?答:传不可变数据对象,保持参数稳定以跳过兄弟节点。
07.1.1.7.3-005 组合阶段在每帧耗时中如何与布局、绘制阶段区分?
一句话结论
Perfetto / Studio Profiler 按泳道区分组合(recompose)、测量布局(measure/layout)与绘制(draw),先定位耗时归属阶段再针对性优化。
概念解释
组合更新节点与状态,布局计算尺寸位置,生成绘制命令。三类问题优化手段不同:重组靠作用域与稳定性,布局靠约束与嵌套层级,绘制靠图层与缓存。不区分阶段容易把布局瓶颈误判为重组问题。
原理流程
帧轨迹:Compose 组合泳道 → Measure/Layout 泳道 → Draw 泳道 → 合成
代码或图示
掉帧帧:组合 8ms / 布局 12ms / 绘制 4ms → 优先查布局嵌套与测量轮次
常见误区
- 所有界面慢都去减少重组计数,实际瓶颈在绘制或主线程任务。
- 忽略系统主线程其他任务对三阶段的挤压。
追问
- 工具入口?答:Perfetto 系统轨迹、Studio Profiler 的 Compose 布局/绘制分析;版本对应能力以官方文档为准。
- 单帧预算多少?答:按目标帧率反推(如 60fps 约 16ms),结合机型档位看分位数。
07.1.1.7.3-006 在组合中频繁分配对象会造成什么后果,如何规避?
一句话结论
高频重组下每次组合新建集合、画笔、回调会推高分配速率,引发 GC 抖动与掉帧;应 remember 缓存派生对象,使用不可变集合并稳定 lambda。
概念解释
组合函数体在重组时重跑,局部新建对象随每次执行分配。列表项、动画节点等高频路径上的分配尤其敏感。规避:remember 缓存派生结果、复用回调、数据类不可变,重对象不在主体构造。
原理流程
重组重跑主体 → 未 remember 对象再次分配
→ 分配速率上升 → GC 频繁 → 帧间隙被占用
代码或图示
val filtered = remember(items) { items.filter { it.active } }
val onClick = remember(item.id) { { vm.select(item.id) } }
常见误区
- 在主体里
listOf(...)新建列表传给子组件,引用每帧变化。 - 每次组合新建自定义回调对象,子节点参数不稳定。
追问
- 如何观察分配?答:Profiler 内存分配计数按调用栈归组,看高频路径上的对象类型。
- 小对象也需要缓存吗?答:轻量值对象开销有限;集合、画笔、监听器、适配器等重对象优先缓存。
07.1.1.7.3-007 稳定类型判定对重组跳过的影响是什么?
一句话结论
参数稳定且 equals 未变时节点可跳过;不稳定类型导致编译器不生成跳过分支,父级重组时该节点每次重调。
概念解释
稳定性是跳过的前提。稳定类型包括基本类型、不可变字段类、不可变集合、稳定 lambda;可变字段与可变集合默认不稳定。跳过判定在编译器生成的节点入口执行,不稳定时直接进入函数体。
原理流程
进入子节点
→ 所有参数稳定且 equals 相等 → 跳过
→ 任一不稳定 → 重新执行
代码或图示
@Immutable
data class Product(val id: String, val title: String)
常见误区
- 把 data class 默认为稳定,字段含可变集合时仍不稳定。
- 标注 @Stable 但类内部可变字段无观察机制,契约不成立。
追问
- 稳定性与 equals 关系?答:稳定类型走 equals 比较;不稳定类型即使引用相同也不跳过。
- 如何批量改造?答:先统一状态模型为不可变数据类,再处理 lambda 与集合参数。
07.1.1.7.3-008 如何用 Layout Inspector 观察重组与状态订阅?
一句话结论
Inspector 展示 Compose 节点树、重组/跳过计数与属性状态,交互后对比计数变化;可定位节点对应的源码可组合函数与参数。
概念解释
选择运行页面后,Inspector 列出组合树节点,点击节点查看函数名、参数与统计。触发点击、滚动、输入后观察哪些节点计数上涨,判断订阅范围是否符合预期。配合源码读取状态读取点交叉验证。
原理流程
连接应用 → 打开目标页面 → 查看初始计数
→ 执行交互 → 刷新/实时观察计数增量
→ 定位异常重调节点 → 回查读取点与参数稳定性
代码或图示
选中节点 → 查看 recompose count 与 skip count → 关联源码函数
常见误区
- 未先记录基线就看绝对计数,无法区分首帧与交互增量。
- Inspector 树节点名混淆,按源码函数名而非布局标题定位。
追问
- 看不到 Compose 树怎么办?答:确认应用为调试构建、设备支持 Inspector,Compose 版本与 Studio 版本兼容。
- 计数与实际代码不一致?答:检查是否有包装组件、slot lambda 导致节点归属不同。
07.1.1.7.3-009 Compose 性能分析应该先看哪些指标?
一句话结论
先看帧时长与掉帧、重组次数/跳过比例、可见项布局耗时、内存分配速率,再下钻到具体阶段与节点,避免凭感觉优化。
概念解释
性能基线包括:启动帧、滚动帧分位数、每帧重组节点数、可跳过比例、测量/绘制耗时、分配对象类型与速率。指标先归类到阶段,再用 Profiler 调用栈定位热点。低端机与高端机分别采样。
原理流程
帧时长 / 掉帧 → 阶段归属 → 节点级重组计数 → 分配与绘制对象
代码或图示
滚动列表:掉帧集中在 measure 泳道 → 查项内嵌套与测量轮次
常见误区
- 只看内存总量,不看分配速率与 GC 频次。
- 在高端机采样,忽略低端机帧预算紧张。
追问
- 指标从哪些工具取?答:Perfetto 轨迹、Studio Profiler、Macrobenchmark 度量、线上性能监控;组合计数主要来自 Inspector/调试构建。
- 阈值如何定?答:按目标机型帧率与页面对比基线设定回归门槛。
07.1.1.7.3-010 Baseline Profile 对 Compose 应用启动与运行有什么收益?
一句话结论
Baseline Profile 预先把关键执行路径编译优化(预编译 profile 规则),改善冷启动、运行时 JIT 编译与滚动流畅度,Compose 常见路径覆盖后收益明显。
概念解释
Baseline Profile 是随包分发的预编译配置,ART 据此在安装/背景编译阶段优化指定路径,减少运行时解释与 JIT 开销。Compose 节点创建、常见组件路径在配置覆盖后启动与首帧更快。它不是加速代码本身,而是减少运行时编译等待。
原理流程
生成 Baseline Profile → 打包进 APK
→ 设备安装后按 profile 预编译关键路径
→ 冷启动 / 常用路径减少 JIT 与解释执行
代码或图示
收益对象:启动链路、首屏组合、核心列表滚动路径
非收益:从未覆盖的冷门路径
常见误区
- 以为 Baseline Profile 能替代代码层面的启动与重组优化。
- 只在开发本地生成,未按发布构建与代表性路径采集。
追问
- Compose 必须单独配吗?答:Compose 运行库有其推荐 profile 覆盖方式,应用 profile 应包含自身关键页面路径,具体集成方式以官方基线配置文档为准。
- 收益如何度量?答:Macrobenchmark 对比带/不带 profile 的启动与滚动指标。
07.1.1.7.3-011 Baseline Profile 如何生成、安装与随包发布?
一句话结论
通过 Macrobenchmark 基准测试跑代表性场景生成 profile 文件,配置构建把 profile 纳入 APK;发布包随安装由 ART 利用,本地调试包一般不生效。
概念解释
生成流程:编写启动与滚动基准用例 → 执行 benchmark 采集轨迹 → 输出 baseline profile 规则文件 → 构建配置引用该文件打包。profile 内容来自真实交互路径,需要覆盖冷启动与核心滚动场景。
原理流程
benchmark 模块跑启动/滚动场景
→ 输出 baseline-prof.txt
→ 主模块构建配置引用 → 打包进发布 APK
代码或图示
模块结构:app(引用 profile)+ benchmark(生成与度量)
常见误区
- profile 文件提交后不随版本路径更新,关键页面变更后规则过期。
- 在模拟机/旧系统上生成,未覆盖目标设备分布。
追问
- profile 与 R8 关系?答:profile 指导 ART 编译,混淆裁剪由 R8 规则负责,两者配合但不替代。
- 如何验证打包成功?答:检查 APK 内 profile 产物与 benchmark 指标对比;具体产物路径以构建工具版本为准。
07.1.1.7.3-012 Macrobenchmark 如何度量 Compose 启动与滚动性能?
一句话结论
Macrobenchmark 在真机/模拟器上循环执行启动或滚动场景,采集帧时长、启动阶段耗时与编译状态,输出可对比的指标基线。
概念解释
基准模块编译为独立 benchmark 构建,每次迭代先重置编译状态再启动应用。启动度量冷启动到首帧/目标页;滚动度量列表帧时长与丢帧。结果输出分位数与摘要,可对比优化前后。Compose 场景通过启动 Activity 与滑动操作驱动。
原理流程
启动 benchmark:冷启动应用 → 等待首帧 → 收集 startup 时间线
滚动 benchmark:定位列表 → 重复滚动 → 收集 frame 时长
代码或图示
StartupTimingMetric()
FrameTimingMetric()
常见误区
- 在开发构建上度量,JIT 与调试开销污染结果。
- 迭代次数不足,单次结果波动大就下结论。
追问
- 如何驱动 Compose 列表滚动?答:benchmark 通过 intent/UI 操作触发滚动;具体手势 API 以 Macrobenchmark 版本为准。
- 指标关注哪些值?答:启动时间分位数、帧 P50/P95/P99、丢帧计数。
07.1.1.7.3-013 Kotlin 2.x 下 Compose 编译器插件如何配置?
一句话结论
Kotlin 2.x 起 Compose 编译器并入 Kotlin 编译器仓库,通过 Kotlin 编译器选项启用 Compose 支持,不再使用旧的独立 compose-compiler 插件坐标;具体 gradle 选项名以目标版本文档为准(待确认)。
概念解释
旧版独立 compose compiler extension 与 Kotlin 版本一一对应;Kotlin 2.x 迁移后配置方式变为 Kotlin 编译器插件/选项。应用模块依赖 Compose 运行库,编译选项启用组合处理。版本不匹配会导致编译错误或运行时行为异常。
原理流程
Kotlin 2.x 工具链
→ 编译器选项启用 Compose
→ 依赖 Compose BOM 对齐运行库版本
代码或图示
// 示例配置结构,具体选项名按目标版本核对
composeCompiler { /* kotlin 2.x 对应配置 */ }
常见误区
- 照搬 Kotlin 1.x 旧插件坐标到 2.x 工程。
- Kotlin 版本与 Compose 库版本组合未查兼容矩阵。
追问
- 如何确认当前配置方式?答:查 Kotlin 2.x Compose 迁移官方说明与构建警告;标「待确认」处在样例工程编译验证。
- 多模块都要开吗?答:包含可组合函数的模块需要编译支持,纯工具模块按是否使用 @Composable 判定。
07.1.1.7.3-014 跨模块使用 Compose 时编译器依赖如何保持一致?
一句话结论
所有含 Compose 的模块使用同一 BOM 对齐运行库版本,编译器插件随 Kotlin 版本统一;模块间只暴露稳定数据模型与可组合 API,避免传递依赖版本漂移。
概念解释
库模块提供可组合组件,App 模块依赖运行库。版本不一致可能出现 API 缺失、类签名不匹配。统一通过 BOM 管理 artifact 版本,Kotlin 版本与编译器配置在各模块一致。组件对外参数优先不可变类型。
原理流程
公共模块:暴露 @Composable 组件 + 不可变模型
→ App 模块:BOM 统一 Compose 版本
→ 编译器版本随 Kotlin 统一
代码或图示
feature-ui → core-compose(组件)→ Compose BOM 统一版本
常见误区
- 某个模块手动指定旧版 compose artifact,绕过 BOM。
- 库模块暴露内部可变集合作为组件参数。
追问
- 模块只放主题与组件怎么办?答:同样需要 Compose 编译支持与运行库依赖声明。
- 版本冲突如何排查?答:Gradle 依赖树查看各 artifact 解析版本,统一回 BOM 管理。
07.1.1.7.3-015 R8 / 混淆对 Compose 生成代码有什么保留要求?
一句话结论
Compose 生成的组合代码由编译器与运行时约定驱动,一般依赖官方默认混淆规则;自定义反射访问、序列化保存类、反射构造的类型需按规则保留,避免裁剪成员。
概念解释
R8 按 Compose 库自带 consumer 规则处理大部分生成代码。应用侧自定义 Saver、Parcelable、反射实例化、注解保留场景可能需要额外 keep 规则。混淆后崩溃多表现为成员丢失、状态恢复失败。
原理流程
release 构建 → R8 裁剪混淆
→ Compose 库规则覆盖运行时约定
→ 自定义反射/序列化类补充 keep 规则
代码或图示
排查方向:崩溃类名/成员缺失 → 反查反射与 Saver 类型 → 补保留规则
常见误区
- 给所有 Compose 类加全量 keep,丧失裁剪收益。
- 只在调试构建验证,release 混淆后才暴露成员丢失。
追问
- 官方规则从哪来?答:库 artifact 携带的 consumer ProGuard 规则,应用无需手工复制。
- 如何验证 release 兼容?答:minify 构建跑关键页面,检查状态保存、反射创建与崩溃符号。
07.1.1.7.3-016 预览(@Preview)中能否直接观察重组统计?
一句话结论
@Preview 主要用于视觉与多配置检查,不提供运行设备上的真实重组计数;重组统计在调试运行的 Inspector 或 Profiler 中观察。
概念解释
预览是编译期/静态渲染环境,展示不同设备、字号、主题下的界面外观;不跑真实交互循环,无法统计重组次数。预览能验证布局溢出与主题,性能行为仍需运行环境度量。
原理流程
Preview:视觉验证(深浅色/字号/尺寸)
运行调试:Inspector 重组计数 + Profiler 帧轨迹
代码或图示
@Preview(showBackground = true)
@Composable
fun CardPreview() { AppTheme { CardSample() } }
常见误区
- 预览渲染快就断言运行时重组性能良好。
- 在预览里模拟高频状态变化观察计数,环境不支持。
追问
- 预览能发现哪些性能相关问题?答:固定尺寸溢出、深嵌套布局、大字号换行等静态布局问题。
- 预览与真机不一致时先核对什么?答:主题包裹、密度字号配置与依赖版本。
07.1.1.7.3-017 哪些 Compose 性能问题属于布局/绘制阶段而非重组阶段?
一句话结论
过度嵌套导致测量轮次多、子项固定过重约束、图层离屏过多、每帧重建绘制对象、复杂路径栅格化,属于布局或绘制问题,减少重组次数无法解决。
概念解释
重组只更新组合描述;布局成本在测量放置,绘制成本在命令生成与栅格化。判断依据:帧轨迹中热点泳道与分配对象类型。布局问题看 measure 深度与子项数量,绘制问题看图层、画笔路径与分配。
原理流程
布局:嵌套层级、测量轮次、约束转换
绘制:图层数量、缓存对象、路径/模糊复杂度
代码或图示
列表滚动掉帧但重组计数低 → 查项内嵌套层级与绘制图层
常见误区
- 所有优化都拆组件、稳参数,不解决布局嵌套与图层问题。
- 把绘制分配误判成重组对象分配。
追问
- 布局阶段如何减层?答:合并等价容器、用内置行列布局、减少不必要嵌套。
- 绘制阶段如何减层?答:合并背景、避免无必要 graphicsLayer、缓存 Brush/Path。
07.1.1.7.3-018 如何建立 Compose 性能基线与回归门槛?
一句话结论
在代表性真机上采集启动、滚动帧分位数与重组/分配指标作为基线,CI 或版本发布时对比关键路径,超过阈值即阻断或告警。
概念解释
基线要覆盖核心页面与低端机档位,区分首帧与交互帧。门槛按分位数(P95/P99)设定,避免平均值掩盖尾部卡顿。Baseline Profile 与 Macrobenchmark 结果纳入版本对比;线上监控补充真实设备分布。
原理流程
采样场景:冷启动 + 核心列表滚动
→ 记录指标分位数基线
→ 每次变更跑 benchmark → 对比回归阈值
代码或图示
门槛示例:启动 P95 不回退超过 x%;滚动 P99 帧时长不超预算
常见误区
- 只在开发机跑单次对比,设备与编译状态不一致。
- 基线包含调试构建,指标偏慢但被当成发布标准。
追问
- 哪些指标适合 CI 门禁?答:Macrobenchmark 稳定可复现的启动与滚动指标;线上分位数用于灰度观察。
- 基线漂移如何处理?答:固定设备/系统镜像,迭代次数标准化,记录工具版本。
07.1.1.7.3-019 Compose BOM 在依赖版本对齐中起什么作用?
一句话结论
Compose BOM 统一管理各组 Compose artifact 的兼容版本,应用只引入 BOM 不写具体版本号,避免库之间版本错配。
概念解释
BOM 映射一组经过互相验证的 Compose 库版本。模块依赖各 compose artifact 时版本由 BOM 决定;需要强制某库版本时才单独覆盖。未用 BOM 时手工拼版本容易出现运行库与组件库不匹配。
原理流程
引入 compose-bom → 各 compose-* 依赖不写版本
→ BOM 解析兼容版本集合
代码或图示
implementation(platform("androidx.compose:compose-bom:2024.x"))
implementation("androidx.compose.ui:ui")
implementation("androidx.compose.material3:material3")
常见误区
- 给单个 artifact 写死版本,绕过 BOM 对齐。
- BOM 版本与 Kotlin/编译器版本不核对兼容矩阵。
追问
- BOM 更新节奏?答:按官方发布周期升级,升级前查版本说明与废弃 API。
- 测试依赖也走 BOM 吗?答:compose-test 等工件同样纳入 BOM 管理。
07.1.1.7.3-020 版本升级时如何排查编译器与运行时不匹配问题?
一句话结论
先核对 Kotlin 版本、Compose BOM 与编译器配置兼容矩阵,再清理构建缓存复现;典型症状是编译报错、节点行为异常或运行时类签名缺失。
概念解释
不匹配常见于 Kotlin 升级后编译器配置未同步、BOM 与 artifact 版本混搭。排查顺序:版本矩阵 → 依赖树 → 清理重建 → 最小样例复现。运行时异常反查符号与库版本,编译错误对照编译器迁移说明。
原理流程
升级后异常
→ 查兼容矩阵(Kotlin / BOM / 编译器)
→ 依赖树确认解析版本 → 清理重建 → 样例复现
代码或图示
症状:未解析的 @Composable 调用 / 运行时 NoSuchMethod
方向:编译器插件版本 vs ui 运行库版本
常见误区
- 直接升级所有依赖到最新,不看官方兼容说明。
- 缓存旧构建产物导致问题反复,未 clean 验证。
追问
- 版本矩阵在哪查?答:官方 Compose 与 Kotlin 发布说明;不确定组合标「待确认」并在样例工程编译验证。
- 多模块混合版本怎么办?答:统一 BOM,移除模块级硬编码版本。
07.1.1.7.3-021 状态对象在模块间传递时稳定性如何保证?
一句话结论
跨模块组件参数使用不可变数据类、不可变集合与稳定 lambda;对外不暴露可变内部状态,第三方类型在边界映射为本地稳定模型。
概念解释
库模块发布的组件 API 稳定性影响使用者跳过重组。参数模型应不可变,回调接口稳定,集合用只读不可变包装。避免把内部 MutableState、可变列表直接作为公共参数暴露。
原理流程
模块边界:不可变数据类 + 只读集合 + 稳定回调
→ 内部实现细节不进入公共 API
代码或图示
data class UiItem(val id: String, val title: String)
@Composable
fun ItemCard(item: UiItem, onClick: (String) -> Unit) { }
常见误区
- 公共参数用
List<MutableItem>,使用者无法保证不可变。 - 回调参数暴露内部可变对象引用。
追问
- 不可变集合库可选吗?答:按技术栈引入不可变集合或在边界拷贝;Kotlin 只读接口在 Compose 视角默认仍需谨慎。
- 注解能补第三方类型稳定吗?答:可以标注,但必须承诺契约成立,否则跳过保证失效。
07.1.1.7.3-022 组合阶段耗时应如何在 Profiler 中定位到具体函数?
一句话结论
在帧轨迹组合泳道中查看耗时调用栈,按可组合函数名归组,找出单次执行重计算或被高频重调的节点,再回查源码读取点与分配对象。
概念解释
Profiler 采样把组合阶段耗时落到调用栈。热点可能是某个函数内的重计算,也可能是节点被反复重调导致累计耗时。结合 Inspector 计数区分「单次重」与「次数多」,优化方向不同。
原理流程
帧轨迹 → 组合泳道 → 调用栈热点函数
→ 对比重组计数 → 单次重算 / 高频重调
代码或图示
热点:OrderListCompose 内 filter+sortedBy 每次组合执行
常见误区
- 只看总时长不下钻调用栈,定位不到具体函数。
- 把库内部组合开销误判为业务代码问题。
追问
- 重计算移到哪?答:数据层/ViewModel 预计算,组合层只渲染;派生结果用 remember 缓存。
- 如何区分采样误差?答:多次采样取稳定热点,结合分配计数与代码路径复核。
07.1.1.7.3-023 懒列表在 Compose 中的回收与复用机制要点是什么?
一句话结论
懒布局只组合可见窗口内的项,滚动时离屏项进入可回收状态,节点与槽位按 key 复用;稳定 key 保证身份匹配,复杂状态应提升到列表外持有。
概念解释
LazyColumn/LazyRow 根据滚动偏移计算可见区间,不可见 item 不参与组合测量。滚动过程中项节点复用,remember 状态随回收策略释放。key 用于跨滚动与增删时匹配身份;内容过重会拉长可见项组合时间。
原理流程
滚动偏移 → 计算可见区间
→ 组合/复用可见项 → 离屏项回收
→ key 匹配复用节点与动画位置
代码或图示
items(items, key = { it.id }, contentType = { it::class }) {
ListRow(it)
}
常见误区
- 用索引作 key,增删后状态与动画错位。
- 把跨滚动需要保留的状态存在项内 remember,回收后丢失。
追问
- contentType 有什么用?答:声明项类型,帮助布局复用同类型节点,减少重建。
- 离屏状态默认保留吗?答:回收策略下不一定保留;需要保留提升到父级/ViewModel。
07.1.1.7.3-024 避免在组合中执行集合排序、过滤等重计算的正确位置是什么?
一句话结论
重计算放在 ViewModel/数据层预先完成,组合层只渲染;必须在界面派生时用 remember 缓存并绑定依赖 key,避免每次重组重复执行。
概念解释
组合主体可能多次执行,排序过滤每次重跑浪费 CPU。数据层输出已排序/过滤结果;界面临时派生用 remember(items, query) 缓存。派生对象保持不可变引用,避免子节点参数不稳定。
原理流程
数据层:加载 → 过滤 → 排序 → 暴露 UiState
组合层:读取渲染;临时派生 remember 缓存
代码或图示
val visible = remember(items, query) {
items.filter { it.matches(query) }.sortedBy { it.title }
}
常见误区
- 主体内
items.sortedBy { ... }每行/每次重组重复跑。 - 派生结果返回新可变集合,子节点无法跳过。
追问
- 派生依赖变化如何刷新?答:remember key 纳入输入;收敛阈值场景用 derivedStateOf。
- 大列表计算放主线程怎么办?答:数据层后台线程预处理,界面只接收结果。
07.1.1.7.3-025 线上如何采集 Compose 重组与卡顿相关指标?
一句话结论
线上以帧时长、掉帧、页面加载与崩溃指标为主;Compose 节点级重组计数属于调试信息,线上一般不直接采集,通过卡顿堆栈、页面轨迹与内存分配间接归因。
概念解释
发布构建不带 Inspector 计数,线上监控采集帧渲染耗时、ANR、分配趋势与页面性能路径。出现卡顿时结合版本、机型、页面堆栈聚类,回退到调试环境复现并用 Inspector/Profiler 定位组合或布局问题。
原理流程
线上:帧时长 / 掉帧 / 卡顿堆栈 / 内存分配趋势
→ 聚类告警 → 调试环境复现 → Inspector + Profiler 下钻
代码或图示
线上指标:页面 jank 率、P99 帧时长、GC 频次
归因:机型 + 页面 + 堆栈 + 版本
常见误区
- 试图在 release 包打开重组统计,依赖与开销不允许。
- 只报崩溃不报卡顿帧,遗漏界面性能问题。
追问
- 自定义性能埋点放哪?答:页面生命周期与关键交互路径,避免在组合主体高频埋点。
- 如何关联 Compose 节点?答:堆栈符号化后映射到页面与组件,调试环境对照节点树。
07.1.1.7.3-026 createComposeRule 的职责是什么,与 ActivityTestRule 有何区别?
一句话结论
createComposeRule 创建 Compose 专用测试规则,负责挂载 setContent 界面、管理测试时钟与语义树、提供节点查找断言入口;面向 Compose 组件,不依赖传统 Activity 布局。
概念解释
Compose 测试规则替代旧的 ActivityTestRule 体系:启动测试宿主、设置内容、同步等待组合与动画、暴露 onNodeXxx 查询。规则处理测试环境的生命周期与帧同步,测试代码直接操作语义节点。
原理流程
@get:Rule val rule = createComposeRule()
→ rule.setContent { 被测组件 }
→ rule.onNodeWith... 查询语义树节点
代码或图示
@get:Rule
val composeRule = createComposeRule()
常见误区
- 用旧 Activity 规则加载 ComposeView,绕开 Compose 测试同步机制。
- 忘记规则提供的等待语义,断言时界面尚未组合完成。
追问
- 测试需要真实 Activity 吗?答:规则提供宿主;要测现有 Activity 中的 Compose 可用 Activity 规则配合 Compose 内容桥接方式。
- 规则依赖哪些 artifact?答:compose-test-junit4/junit5 与 ui-test 工件,版本走 BOM。
07.1.1.7.3-027 setContent 在测试中如何挂载被测界面?
一句话结论
rule.setContent { ... } 在测试宿主中组合被测组件,套用测试主题与依赖,使语义树可被查找断言;每个测试方法可重新设置内容。
概念解释
setContent 接收可组合内容块,规则将其挂到宿主视图。测试中可传入假 ViewModel、固定主题与参数。界面状态在测试方法内通过节点操作驱动,不依赖真实后端。
原理流程
@Test
fun titleShown() {
composeRule.setContent { AppTheme { SampleCard(title = "Hi") } }
composeRule.onNodeWithText("Hi").assertExists()
}
代码或图示
composeRule.setContent {
ProfileScreen(viewModel = fakeViewModel)
}
常见误区
- setContent 内启动真实网络依赖,测试不稳定。
- 多个测试复用同一组合状态,未在每个方法重新挂载。
追问
- 主题缺失会影响断言吗?答:视觉样式不影响语义查找,但建议包裹测试主题保证布局一致。
- 配置变更测试如何挂载?答:通过规则或 Activity 场景触发重建,再验证状态保留。
07.1.1.7.3-028 Compose 语义树(semantics tree)如何驱动断言与操作?
一句话结论
框架把组件的可访问性信息合并成语义树,测试通过 matcher 在树中定位节点,读取语义属性做断言,向节点派发点击、输入等操作。
概念解释
语义树不是视图树镜像:合并父子语义节点,暴露文本、状态、角色、标签等属性。测试断言基于语义而非像素坐标;组件正确暴露语义(角色、选中、禁用)才能被测试与无障碍工具识别。
原理流程
组件组合 → 语义信息合并成语义树
→ matcher 按属性查找节点
→ assert 属性 / perform 操作
代码或图示
节点属性:text、role、selected、enabled、testTag
常见误区
- 按视觉位置或截图颜色断言,语义变化时测试脆弱。
- 自定义组件未暴露语义状态,测试找不到可断言属性。
追问
- 语义树与无障碍树关系?答:同一套语义信息同时服务测试与无障碍,补语义对两者都有益。
- 节点合并导致找不到子节点?答:父级合并了子语义,可用子节点 matcher 或明确取消合并。
07.1.1.7.3-029 testTag 如何在组件上打标并在测试中定位?
一句话结论
用 Modifier.testTag("tag") 给节点打稳定标签,测试用 onNodeWithTag("tag") 定位;标签应唯一、语义稳定,不随文案或状态变化。
概念解释
文本可能随国际化、数据变化,testTag 提供稳定查找锚点。复杂布局、图标按钮、滚动容器尤其需要标签。标签挂在要操作或断言的节点上,配合 testTag 与其他 matcher 组合。
原理流程
IconButton(onClick = {}, Modifier.testTag("favorite-button")) {
Icon(...)
}
代码或图示
composeRule.onNodeWithTag("favorite-button").performClick()
常见误区
- 标签写成业务数据 id,列表多项重复且随数据变化。
- 标签挂在父容器,内部子节点操作定位不到。
追问
- 标签冲突怎么办?答:作用域内唯一;列表内可结合索引/数据 matcher 区分。
- testTag 影响无障碍吗?答:标签主要供测试,必要时另补无障碍角色与描述。
07.1.1.7.3-030 onNodeWithText、onNodeWithTag 等 matcher 如何组合?
一句话结论
matcher 可通过 and/or 组合,按文本、标签、状态、角色等属性过滤;onAllNodes 处理多节点,断言数量配合使用。
概念解释
基础 matcher:withText、withTag、withRole、isSelected、isEnabled、hasClickAction 等。组合 matcher 精确定位;多节点场景用 onAllNodes 配合计数断言。matcher 不匹配时异常信息会列出树中节点辅助排查。
原理流程
onNode(
hasTestTag("item") and hasText("标题") and isSelected()
)
代码或图示
composeRule.onAllNodes(hasText("条目")).assertCountEquals(3)
常见误区
- 多个相似文本节点只用 withText,匹配到多个导致断言失败。
- 忘记状态 matcher,禁用按钮也被点击。
追问
- matcher 找不到节点怎么排查?答:打印语义树(onRoot 输出),检查文本大小写、合并语义与标签。
- 正则文本匹配?答:withText 支持正则/子串匹配变体,具体 API 以测试库版本为准。
07.1.1.7.3-031 常见断言:assertExists、assertIsDisplayed、assertIsNotEnabled 分别验证什么?
一句话结论
assertExists 验证节点存在于语义树;assertIsDisplayed 验证节点可见显示在屏幕上;assertIsNotEnabled 验证禁用状态,另有 selected/checked 等状态断言。
概念解释
存在不等于可见:离屏、被遮挡、布局为零尺寸可能在树中但未显示。可见性断言考虑视图边界与绘制状态。状态断言读取语义属性,比检查文本或样式更可靠。
原理流程
exists:树中有匹配节点
displayed:节点在屏幕可见区域内显示
enabled/disabled:语义状态属性
代码或图示
onNodeWithText("提交").assertIsNotEnabled()
onNodeWithTag("banner").assertIsDisplayed()
常见误区
- 用 exists 代替 displayed,离屏项误判为可见。
- 自定义组件未上报 enabled 语义,状态断言失效。
追问
- 不可见但存在的场景?答:懒列表离屏项、AnimatedVisibility 过渡中、零尺寸节点。
- 断言选中态用什么?答:assertIsSelected / assertIsChecked,按组件语义选择。
07.1.1.7.3-032 performClick 与 performTextInput 如何模拟用户操作?
一句话结论
performClick 向节点派发点击动作;performTextInput 向输入框注入文本并触发值变更,必要时配合 IME 动作(回车、清除)。
概念解释
操作通过语义动作派发,不走真实触摸坐标。文本输入先聚焦节点再注入字符,更新 TextField 状态。需要模拟键盘回车用 performImeAction,清除用 clearText 或对应动作。
原理流程
onNodeWithTag("search").performTextInput("关键词")
onNodeWithTag("submit").performClick()
代码或图示
composeRule.onNodeWithText("输入框").performTextInput("Ann")
常见误区
- 直接改测试状态代替用户输入,未验证输入链路。
- 输入后未等待异步校验,断言读到旧状态。
追问
- 多点手势怎么模拟?答:测试库提供拖拽/手势注入 API;具体方法名按 ui-test 版本核对。
- IME 动作找不到?答:检查输入框是否配置 imeAction,节点是否暴露对应动作。
07.1.1.7.3-033 waitUntil 在异步界面测试中解决什么问题?
一句话结论
waitUntil 轮询等待满足断言条件,解决加载、异步校验、动画中间态导致的时序不确定;避免固定 sleep 带来的慢测试与偶发失败。
概念解释
异步数据到达、按钮状态翻转、列表加载完成都需要等待。waitUntil 周期性查询语义树直到条件成立或超时。配合规则的测试时钟控制,比 Thread.sleep 更可靠且失败时给出超时上下文。
原理流程
waitUntil {
onNodeWithTag("loading").isNotInTree()
}
代码或图示
composeRule.waitUntil(timeoutMillis = 5000) {
composeRule.onAllNodes(hasText("条目")).fetchSemanticsNodes().size == 3
}
常见误区
- 用 sleep 固定等待,快场景拖慢、慢场景仍超时。
- 等待条件写成永不满足的查询,超时栈信息不足。
追问
- 动画完成如何等待?答:等待目标状态出现;测试时钟可控制动画推进,具体方式按测试库能力。
- 超时阈值怎么设?答:按异步源时延设定,测试环境避免依赖真实网络。
07.1.1.7.3-034 如何测试按钮禁用、选中状态等语义状态?
一句话结论
组件在语义树上报 enabled/selected/checked 等状态,测试用对应断言匹配;状态由交互或 ViewModel 状态驱动,操作后断言翻转结果。
概念解释
禁用按钮的点击动作不应触发业务;选中态反映当前选择。测试先构造初始状态,执行操作或传入 ViewModel 状态,再断言语义属性。自定义组件需正确暴露这些状态给语义树。
原理流程
初始状态 → 断言禁用/未选中
→ 触发输入或回调 → 状态翻转
→ 断言启用/选中
代码或图示
onNodeWithTag("submit").assertIsNotEnabled()
onNodeWithText("选项 A").assertIsSelected()
常见误区
- 通过颜色或透明度判断禁用,语义不可靠。
- 组件内部状态未提升,测试无法从外部驱动到目标状态。
追问
- 自定义按钮如何上报状态?答:组件语义属性跟随 enabled/selected 参数;必要时语义修饰符补充。
- 禁用态点击会怎样?答:语义无点击动作,performClick 找不到可执行动作。
07.1.1.7.3-035 输入框测试如何模拟回车、清除与校验错误提示?
一句话结论
先 performTextInput 输入文本,用 IME 动作触发回车/提交;清除用对应文本动作,错误提示通过文本或标签断言出现,异步校验配合 waitUntil。
概念解释
TextField 测试覆盖输入、非法值、错误文案、提交回调。回车动作依赖配置的 imeAction;错误提示在校验状态更新后出现在语义树。测试传入假校验逻辑,不依赖真实后端。
原理流程
输入非法文本 → 触发 IME 动作
→ 校验失败 → 错误文案进入语义树
→ 断言错误提示;合法输入 → 提交回调被调用
代码或图示
onNodeWithTag("email").performTextInput("bad-email")
onNodeWithTag("email").performImeAction()
onNodeWithText("邮箱格式不正确").assertExists()
常见误区
- 只输入不断言错误提示,漏校验分支。
- 清除文本后未等待错误提示消失,残留旧断言。
追问
- 密码框类型影响测试吗?答:语义可能隐藏文本,按标签/角色定位,断言错误提示而非密码内容。
- 提交回调如何捕获?答:传入记录 lambda,断言收到的参数值。
07.1.1.7.3-036 测试中如何注入 ViewModel 或依赖?
一句话结论
setContent 中直接构造假 ViewModel/依赖传入组件,或用测试替身替换仓库层;组件只接收接口与状态流,测试不启动真实 DI 容器与网络。
概念解释
可组合组件通过参数接收 ViewModel 或回调,测试传入 fake 实例驱动固定状态与回调。需要用到 ViewModelProvider 时,测试环境提供自定义 factory 或作用域替换。依赖接口化是可注入的前提,硬编码单例难以替换。
原理流程
组件依赖接口/Fake ViewModel
→ setContent 注入 fake
→ 断言渲染与回调,不碰真实后端
代码或图示
setContent {
val fake = FakeProfileViewModel(UiState("Ann"))
ProfileScreen(viewModel = fake)
}
常见误区
- 组件内部直接 new 真实仓库,测试只能打网络。
- 注入的 fake 状态不可变,无法模拟异步翻转。
追问
- Hilt 测试怎么替换?答:用测试模块绑定 fake 实现,或在组合入口绕过 Hilt 直接传参;按项目 DI 方案选择。
- ViewModel 作用域在测试中如何处理?答:测试宿主提供 ViewModelStore,避免泄漏到真实 Activity 作用域。
07.1.1.7.3-037 深色主题与多字号如何在 Compose 测试中覆盖?
一句话结论
setContent 中包裹测试主题并传入浅色/深色 scheme,字号通过测试配置或主题 Typography 模拟;断言在对应主题下的文本、颜色与布局。
概念解释
测试环境可显式选择主题方案,不依赖系统暗色设置。大字号场景通过字号缩放配置或测试 Typography 验证换行与溢出。视觉颜色一般不作为断言主体,重点验证语义节点与布局结果;截图测试再核对外观。
原理流程
setContent {
AppTheme(darkTheme = true) { Sample() }
}
代码或图示
// 多主题参数化:逐个传入 light/dark scheme 执行同一断言集
常见误区
- 测试继承系统暗色模式,结果随测试设备设置漂移。
- 只测默认字号,遗漏大字号截断问题。
追问
- 字号缩放如何注入?答:测试配置 density/fontScale 或主题 Typography 覆盖;具体可用 API 以测试库版本为准。
- 颜色断言可靠吗?答:语义与结构断言为主,颜色对比走截图/人工走查。
07.1.1.7.3-038 截图对比测试与快照测试在 Compose 中如何组织?
一句话结论
截图测试渲染组件到固定配置的画布并与基准图像素对比;快照测试序列化语义/结构状态做差异比对。两者都需要统一环境(密度、字号、主题、动画静止)。
概念解释
截图基准图在受控环境生成,CI 上重渲染对比像素差异,适合视觉回归。快照测试记录节点属性与文本结构,不依赖像素精度,适合结构断言。动画在截图前应停在固定状态,避免逐帧差异。
原理流程
受控配置渲染 → 生成图像/结构快照
→ 与基准对比 → 差异超阈值失败
代码或图示
基准:固定密度 + 固定主题 + 动画结束态
新构建:同配置重渲染 → 像素/结构 diff
常见误区
- 在不同设备密度上复用同一张基准图,色差与尺寸错位。
- 动画进行中截图,帧状态不确定导致误报。
追问
- 截图测试依赖哪些工件?答:Compose 截图测试库或平台方案;具体 artifact 与 API 按项目选定的测试栈核对。
- 基准图如何更新?答:确认视觉变更后显式生成新基准,禁止 CI 自动覆盖未知差异。
07.1.1.7.3-039 测试中等待动画完成应使用什么手段?
一句话结论
优先等待动画目标状态出现在语义树;可控测试环境可推进测试时钟;避免靠固定 sleep 等动画结束。
概念解释
Compose 测试规则同步帧执行,动画中间态仍在树中。断言最终状态时 waitUntil 检查目标可见性/属性;若动画由测试时钟驱动,可调用时钟推进接口跳到结束态。不同测试库对时钟控制能力不同,需按版本确认。
原理流程
触发动画 → waitUntil 目标状态满足
→ 或测试时钟推进到动画结束
→ 断言最终节点状态
代码或图示
onNodeWithTag("expand").performClick()
waitUntil { onNodeWithTag("extra-content").isDisplayed }
常见误区
- sleep 固定时长,低端机动画未结束或快速场景空等。
- 对循环动画等待「结束」,条件永远不满足。
追问
- 循环动画在测试中怎么办?答:初始不启动循环,或通过状态控制暂停/移除节点。
- 时钟 API 不可用?答:退到等待目标语义状态,覆盖最终结果而非逐帧。
07.1.1.7.3-040 语义节点找不到(找不到 tag / 文本)时如何排查?
一句话结论
先打印根语义树查看实际节点文本、标签与合并情况,再检查组件是否暴露语义、节点是否在可见区、 matcher 条件是否过严。
概念解释
排查顺序:节点是否组合(setContent 是否成功)→ 语义是否被父级合并 → 文本大小写/子串匹配 → testTag 是否挂对节点 → 节点是否离屏或未显示。语义树输出列出所有可见与存在节点,是定位主入口。
原理流程
onRoot().printToLog(...) 输出语义树
→ 找相近节点 → 核对属性
→ 定位缺失原因:未组合 / 被合并 / matcher 过严 / 不可见
代码或图示
composeRule.onRoot().printToLog("semantics")
常见误区
- 反复调整 matcher 而不先看语义树,盲目猜测节点属性。
- 自定义组件内部子节点被合并,父级找不到内部标签。
追问
- 取消语义合并怎么做?答:语义修饰符控制 mergeDescendants;按组件结构选择是否合并。
- 异步未加载导致节点缺失?答:先 waitUntil 加载态结束,再断言目标节点。
07.1.1.7.3-041 单元测试与 instrumentation 测试在 Compose 中的分工是什么?
一句话结论
JVM 单测覆盖状态容器、业务逻辑与纯函数;仪器化测试在设备/模拟器上渲染组件,验证语义交互、布局与主题外观。
概念解释
ViewModel/Reducer/工具类不需要 Compose 运行环境,用普通 JVM 测试。组件渲染、点击输入、列表滚动、主题适配必须在 Android 环境跑 Compose 测试规则。两类测试互补:逻辑下沉可单测,UI 行为走仪器化。
原理流程
JVM 单测:状态流、校验规则、数据映射
仪器化:组件渲染、节点操作、可见性与主题
代码或图示
ViewModel 测试:给定状态 → 断言输出
Compose 测试:setContent → 操作 → 断言语义树
常见误区
- 把可组合函数当纯函数在 JVM 直接调用,缺少组合环境。
- 业务逻辑堆在组件里,只能靠仪器化测试覆盖。
追问
- 组件逻辑如何下沉可测?答:状态计算与校验移到 ViewModel/状态容器,组件只渲染参数与回调。
- 仪器化测试慢怎么办?答:核心链路覆盖,纯逻辑尽量单测分流。
07.1.1.7.3-042 如何测试状态提升后的子组件回调事件?
一句话结论
子组件接收 onXxx 回调参数,测试中传入记录回调的 fake,操作节点后断言回调被调用及携带参数。
概念解释
提升后的子组件不持有状态,事件通过 lambda 上报。测试捕获回调引用,执行点击/输入动作,检查回调触发次数与数据。这验证了子组件正确上报意图,不依赖父级真实状态更新。
原理流程
val events = mutableListOf<String>()
setContent { ItemCard("A", onClick = { events.add("A") }) }
onNodeWithTag("item").performClick()
assertEquals(listOf("A"), events)
代码或图示
var selected: String? = null
setContent { OptionRow(id = "x", onSelect = { selected = it }) }
常见误区
- 断言父级状态变化代替回调验证,子组件事件链路未独立覆盖。
- 捕获 lambda 后未重置,多个测试间事件列表残留。
追问
- 回调携带复杂对象怎么断言?答:比较关键字段或不可变对象 equals;避免引用比较。
- 回调多次触发怎么验证?答:记录调用次数与每次参数序列。
07.1.1.7.3-043 可组合项的副作用注册在测试中如何清理?
一句话结论
DisposableEffect/LaunchedEffect 注册的监听与协程随测试组合离开而清理;测试结束宿主释放时 onDispose 应执行,未释放的平台订阅需在测试中断言反注册。
概念解释
测试规则卸载组合内容时,Effect 清理钩子触发。注册平台监听器、Flow 收集的组件,测试中应验证离开后不再回调。fake 回调可记录是否被反注册,避免泄漏到下一个测试。
原理流程
setContent 挂载 → Effect 注册
→ 测试结束/重新 setContent → onDispose 清理
→ fake 断言订阅已释放
代码或图示
DisposableEffect(unit) {
val sub = manager.observe()
onDispose { sub.cancel() }
}
常见误区
- 测试只覆盖注册路径,不验证清理,泄漏在设备上才暴露。
- 全局单例监听未反注册,跨测试串扰。
追问
- 如何触发离开组合?答:重新 setContent 或卸载宿主;规则生命周期内执行清理回调。
- 协程取消如何验证?答:fake 协程调度器/订阅记录取消状态,断言 isCancelled。
07.1.1.7.3-044 测试懒列表滚动到底部并定位离屏项?
一句话结论
通过滚动动作把目标项滚入可见区,再按 key/tag/文本定位;离屏项不在语义树中,不可直接断言,需先滚动加载到可见窗口。
概念解释
懒列表只组合可见项,测试定位离屏节点会失败。使用列表滚动方法滚动到指定项或底部,等待目标节点 displayed 后断言。大列表测试配合固定数据源,避免异步加载干扰定位。
原理流程
onNodeWithTag("list").performScrollToIndex(last)
→ waitUntil 目标项 displayed
→ 断言节点属性
代码或图示
composeRule.onNodeWithTag("feed-list")
.performScrollToNode(hasTestTag("item-42"))
常见误区
- 直接 onNodeWithText 查找未滚入屏幕的项。
- 滚动后未等待组合完成,断言时机过早。
追问
- 滚动到特定 key 怎么做?答:matcher 匹配 item 标签/数据;滚动 API 按列表类型选择,具体方法名以测试库版本为准。
- 列表分页加载测试?答:滚动到底部等待加载态结束,再断言新页项出现。
07.1.1.7.3-045 如何验证组件在不同尺寸下的布局不溢出?
一句话结论
在测试配置中设置不同宽度/高度约束、密度与字号,渲染组件断言节点可见、无溢出语义;预览覆盖常见设备尺寸,仪器化测试固定关键窄屏/大字场景。
概念解释
布局溢出可能表现为文本截断、节点超出约束、命中区域错误。测试通过不同 Constraints 包裹组件,检查节点 displayed 与关键文本存在。宽屏、窄屏、大字号分别走查,固定尺寸容器重点验证。
原理流程
小宽度约束 → 渲染 → 断言关键内容可见
大字号 → 渲染 → 断言多行布局不截断
代码或图示
setContent {
Box(Modifier.width(320.dp)) { CardSample() }
}
常见误区
- 只在默认密度与字号下测试,遗漏窄屏溢出。
- 用 exists 断言代替 displayed,离屏截断仍被当成通过。
追问
- 溢出如何在测试中检测?答:可见性断言 + 截图对比;具体溢出语义 API 以测试库能力为准。
- 预览覆盖哪些尺寸?答:手机竖屏、平板/折叠宽屏、大字号,按产品目标设备集选择。
07.1.1.7.3-046 @Preview 支持哪些设备、字号、深浅色参数?
一句话结论
Preview 注解可配置屏幕宽高/密度、字号缩放、暗色模式、背景颜色与设备字体;参数组合决定静态渲染环境,但不模拟真实系统动态行为。
概念解释
常用参数:widthDp/heightDp、fontScale、uiMode(深浅色)、showBackground、showSystemUi、locale。多套参数通过多个注解重复添加。动态取色、真实导航与异步数据不在预览模拟范围内。
原理流程
预览按注解参数配置渲染环境,多套设备/主题/字号通过重复注解并列声明。
代码或图示
@Preview(widthDp = 360, heightDp = 640, fontScale = 1.0f)
@Preview(uiMode = UI_MODE_NIGHT_YES)
@Composable
fun SamplePreview() { }
常见误区
- 以为预览能验证性能与动态取色。
- 预览内容依赖未注入的异步数据,渲染为空。
追问
- 区域语言怎么配?答:locale 参数设置预览语言;具体参数名以 Studio 与库版本为准。
- 设备异形屏支持吗?答:预览可给尺寸与边框配置,真实切口适配仍需设备验证。
07.1.1.7.3-047 预览参数注解如何批量生成多套预览?
一句话结论
用重复 @Preview 注解列出多套配置,或封装预览数据方法在预览组合内遍历;团队可约定主题、字号、设备维度的标准预览集合。
概念解释
同一组件挂多个 Preview 注解分别渲染深浅色、字号、尺寸。公共预览容器统一包裹测试主题,避免每个预览重复模板。批量配置适合设计走查,但注解数量过多会拖慢渲染,按关键维度选择。
原理流程
@Preview("light", uiMode = UI_MODE_NIGHT_NO)
@Preview("dark", uiMode = UI_MODE_NIGHT_YES)
@Composable
private fun CardPreview() { AppTheme { CardSample() } }
代码或图示
维度:主题深浅 × 字号 × 窄/宽屏 → 选取组合生成预览
常见误区
- 每个预览各自写死主题与假数据,模板不一致。
- 预览遍历真实数据集,渲染成本过高。
追问
- 预览能传参吗?答:预览方法可带默认参数,但注解配置有限;多变体数据在预览方法内构造。
- 团队预览模板放哪?答:公共预览工具组件,业务组件复用包裹。
07.1.1.7.3-048 预览无法渲染时常见原因有哪些?
一句话结论
依赖注入未提供、异步数据未给默认值、主题资源缺失、编译/编译器版本不兼容、预览环境异常,都会导致预览空白或报错。
概念解释
预览执行的是简化组合环境:无真实后端、无 Hilt 组件注入。组件读取空 ViewModel、缺失字体/颜色资源、崩溃于平台 API 调用,预览就失败。先看预览错误日志,再隔离最小组件定位。
原理流程
预览失败 → 查看错误堆栈
→ 缺默认数据 / 依赖未注入 / 资源缺失 / 版本不兼容
→ 隔离到最小可渲染组件逐步恢复
代码或图示
排查:假数据注入 → 主题包裹 → 移除平台依赖调用
常见误区
- 预览里调用 Context/系统服务取数,预览环境没有对应实例。
- 崩溃只在预览出现,误以为运行时正常而忽略。
追问
- 编译报预览错误?答:核对 Kotlin/Compose 编译器与 Studio 版本兼容矩阵。
- 预览空白无报错?答:检查组件是否依赖未加载的异步状态,给预览默认值。
07.1.1.7.3-049 Compose 测试依赖需要引入哪些 artifact?
一句话结论
仪器化测试需要 Compose 测试规则、UI 测试与 matcher 工件;版本由 BOM 对齐,测试依赖放在测试源集,不进入生产包。
概念解释
典型工件:compose-ui-test-junit4(或 junit5)、ui-test 框架提供规则与 matcher;截图测试另加对应库。依赖只进 androidTest 源集。BOM 管理版本避免与运行库错配。
原理流程
测试工件只进入仪器化测试源集,版本由 BOM 与运行库对齐。
代码或图示
androidTestImplementation(platform(compose-bom))
androidTestImplementation("androidx.compose.ui:ui-test-junit4")
androidTestImplementation("androidx.compose.ui:ui-test-manifest")
常见误区
- 测试工件误加到生产实现依赖。
- 测试库版本与运行库不一致,节点查询行为异常。
追问
- junit5 支持情况?答:按项目测试栈选择对应测试工件;具体 artifact 名以 BOM 与官方文档为准。
- 测试 manifest 作用?答:提供测试宿主 Activity 等配套组件,按库说明引入。
07.1.1.7.3-050 断言可见性时"存在于树中"与"显示在屏幕上"有何区别?
一句话结论
存在(exists)只要求语义树有匹配节点;显示(isDisplayed)要求节点在屏幕可见边界内并绘制可见,离屏、零尺寸、被遮挡节点可能存在但不可见。
概念解释
懒列表离屏项、动画中间隐藏节点、布局为零的容器仍可能保留语义记录。可见性断言考虑视图尺寸与边界。测试按需求选择:检查渲染结果用 displayed,检查节点是否已组合用 exists。
原理流程
exists:语义树匹配成功
displayed:exists + 可见区域内 + 尺寸非零可见
代码或图示
onNodeWithTag("offscreen-item").assertExists() // 离屏也可能通过
onNodeWithTag("banner").assertIsDisplayed() // 必须可见
常见误区
- 滚动场景用 exists 断言,误以为用户能看到。
- 父级隐藏但子节点未从树移除,exists 误判成功。
追问
- 被部分遮挡算 displayed 吗?答:按可见区域判定规则,具体边界以测试库实现为准。
- 隐藏动画节点?答:过渡期间状态特殊,等待动画结束后再断言语义。
07.1.1.7.3-051 如何模拟配置变更(旋转)并验证状态保留?
一句话结论
仪器化测试中触发 Activity 重建(配置变更),验证 rememberSaveable/ViewModel 保留的状态仍在;普通 remember 状态预期重置。
概念解释
配置变更重建宿主,保存容器与 ViewModel 存活,内存 remember 丢失。测试先输入草稿/选中项,触发重建,再断言关键状态恢复。进程回收场景模拟需系统级动作,单测覆盖 SavedState 逻辑即可。
原理流程
输入状态 → 触发配置变更重建
→ 恢复组合 → 断言 Saveable/ViewModel 状态保留
代码或图示
// 测试框架切换配置或重建 Activity,再查询节点文本
常见误区
- 把 remember 状态当成可跨旋转保留,测试预期错误。
- 未清理上一测试的 ViewModelStore,状态串扰。
追问
- 旋转测试在 CI 上稳定吗?答:模拟器可切换方向;关键 Saveable 逻辑可配合状态容器单测覆盖。
- 哪些状态必须保留?答:输入草稿、选中项、滚动位置等界面状态;业务数据归 ViewModel/持久层。
07.1.1.7.3-052 测试中处理协程与异步任务的时钟(TestDispatcher)如何配合?
一句话结论
用 TestDispatcher/TestScope 替代真实调度器,手动推进协程执行与延时,断言异步状态确定发生;组件收集的状态流在测试时钟下可控刷新。
概念解释
真实延迟与线程让测试不确定。测试调度器记录任务,可按步骤推进;StateFlow/fake 仓库立即发状态组合。ViewModel 测试用 TestScope,Compose 测试规则同步帧,两者配合避免等待真实超时。
原理流程
TestDispatcher 启动协程
→ 推进空闲/延时任务
→ 状态更新 → 组合刷新 → 断言
代码或图示
val scope = TestScope(StandardTestDispatcher())
常见误区
- 组件硬编码 GlobalScope,测试无法替换调度器。
- 异步任务未完成就断言,靠 sleep 兜底。
追问
- Compose 测试规则自带时钟吗?答:规则处理组合帧同步;协程调度仍需测试调度器控制延时任务,具体能力按库版本核对。
- Flow 收集怎么测?答:fake 仓库返回可立即发射的 StateFlow,或测试作用域收集断言。
07.1.1.7.3-053 语义属性(role、selected)如何自定义供测试断言?
一句话结论
通过语义修饰符设置 role、描述、选中/勾选状态等属性,组件内部状态同步到语义;测试用对应 matcher 读取这些属性断言。
概念解释
默认组件从控件类型推导角色;自定义布局需要补语义角色与状态。语义属性同时服务无障碍与测试。状态变化时语义跟随参数更新,避免只改视觉不改语义。
原理流程
Modifier.semantics {
role = Role.Button
selected = isSelected
}
代码或图示
onNodeWithRole(Role.Tab).assertIsSelected()
常见误区
- 自定义图标按钮无角色无描述,测试与无障碍都无法识别。
- 视觉选中但语义 selected 未更新,断言失败。
追问
- 哪些属性可补?答:text/description/role/selected/checked/enabled 等,清单以语义 API 版本为准。
- 自定义动作如何暴露?答:语义 action 注册点击/文本动作,测试 perform 调用。
07.1.1.7.3-054 列表项内容重复时如何唯一定位节点?
一句话结论
给每项挂唯一 testTag(含业务 id)或结合位置/数据 matcher;重复文本不可靠,标签稳定且与数据 id 对应。
概念解释
多条目文本相同(如"购买"按钮)时,withText 匹配多个节点。使用项内唯一标签,或先定位项容器再在其内查找子节点。标签不用索引(滚动后变化),用稳定业务 id 派生。
原理流程
items(items, key = { it.id }) {
Row(Modifier.testTag("item-${it.id}")) { ... }
}
代码或图示
onNodeWithTag("item-42").onChild().performClick()
常见误区
- 用列表索引生成标签,滚动复用后错位。
- 只断言第一个匹配节点,其余重复项未覆盖。
追问
- 项内多个同类按钮?答:项容器标签 + 子按钮角色/文本组合定位。
- 动态 id 含特殊字符?答:标签保持合法字符串,避免空格与分隔符冲突。
07.1.1.7.3-055 截图测试的基准图如何在多设备间保持一致?
一句话结论
截图在固定密度、字号、主题、字体与动画静止状态下渲染,基准与对比使用同一配置;不同设备产生不同基准集,禁止跨密度直接比像素。
概念解释
像素对比对环境敏感:密度、字号、字体渲染、抗锯齿、主题都会影响图像。测试环境统一参数,动画停在结束态,网络图片用占位固定资源。设备矩阵按档位生成对应基准,差异阈值按组件类型设定。
原理流程
固定渲染配置 → 生成基准
→ CI 同配置重渲染 → 像素 diff
→ 不同设备/密度 → 独立基准集
代码或图示
配置锁定:density、fontScale、theme、locale、静态数据
常见误区
- 开发机与 CI 字体不同导致基准大面积色差。
- 加载网络位图参与截图,图像不确定。
追问
- 抗锯齿差异如何处理?答:阈值容忍或结构/颜色区域对比;完全像素一致只在同环境可行。
- 基准图存哪?答:测试资源目录随版本管理,更新流程显式评审。
07.1.1.7.3-056 ComposeView 在 Activity / Fragment 中如何承载 Compose 界面?
一句话结论
ComposeView 是嵌入 View 树的容器,在 Activity/Fragment 中获取该视图并调用 setContent 组合 Compose 界面,是旧页面接入 Compose 的入口。
概念解释
ComposeView 是平台 View 子类,可加入传统布局 XML 或代码创建。setContent 提供可组合内容,绑定 Fragment/Activity 生命周期。混合页面中 View 与 Compose 共存于同一视图树。
原理流程
布局中放置 ComposeView
→ view.setContent { AppTheme { Screen() } }
→ Compose 节点渲染到该容器
代码或图示
composeView.setContent {
MaterialTheme { ProfileScreen() }
}
常见误区
- 在 Fragment 销毁后仍持有 ComposeView 引用更新状态。
- 未包主题,组件使用默认配色。
追问
- Activity 直接 setContent 与 ComposeView 区别?答:Activity 扩展 setContent 直接设置内容视图;ComposeView 适合嵌入既有 View 布局。
- 生命周期如何绑定?答:随宿主 View attach/detach 与 Fragment 生命周期,具体清理时机见互操作题目。
07.1.1.7.3-057 AndroidView 如何把传统 View 嵌入 Compose?
一句话结论
AndroidView(factory = { context -> ... }) 在组合中创建并持有传统 View,update 回调在状态变化时更新该 View,实现 Compose 树内嵌 View 组件。
概念解释
factory 只在初始创建时构造 View;update 在重组时同步最新参数到 View。View 的回调通过 lambda 回传 Compose 状态。互操作边界内 View 生命周期随组合 group 管理。
原理流程
AndroidView(
factory = { ctx -> CustomView(ctx) },
update = { view -> view.bind(data) }
)
代码或图示
AndroidView(::MapView) { map -> map.setMarker(point) }
常见误区
- 在 factory 里每次重组更新数据,factory 不重复执行。
- 直接把 Compose 状态对象传给 View 内部持有引用,泄漏组合状态。
追问
- View 状态如何回传?答:View 监听器调用 Compose 传入的回调 lambda,由 Compose 更新状态。
- 嵌套滚动如何配合?答:View 与 Compose 滚动容器的嵌套滚动按平台机制协调,复杂场景单独验证。
07.1.1.7.3-058 View 树中嵌入 Compose 与 Compose 中嵌入 View 的状态如何桥接?
一句话结论
双向桥接通过共享 ViewModel/状态容器与回调接口:View 侧读状态、发事件;Compose 侧 collectAsState 渲染、回调上报,不直接互相持有对方控件。
概念解释
混合页面状态归共同祖先(ViewModel),View 与 Compose 都是渲染层。View 通过监听器/观察者发事件,Compose 通过回调 lambda 上报。跨边界避免直接操作对方控件,状态走单向数据流。
原理流程
ViewModel 状态 → View 绑定 / Compose collectAsState
View 事件 → 回调 → ViewModel
Compose 事件 → 回调 → ViewModel
代码或图示
共享 ViewModel:状态流单向下发,事件双向回调汇聚
常见误区
- Compose 直接引用旧 View 实例改属性,绕过状态源。
- 两边各存一份镜像状态,同步不一致。
追问
- 局部界面状态放哪?答:边界内一方持有即可;需要跨 View/Compose 同步时提升到共享容器。
- 桥接层放什么?答:接口适配器把 View 控件事件转成回调,把状态转成 View 绑定调用。
07.1.1.7.3-059 互操作边界上的生命周期与协程作用域如何同步?
一句话结论
Compose 侧作用域随组合离开取消;View 侧订阅在 detach/onDestroy 反注册;共享协程归 ViewModel viewModelScope,边界两侧都不持有超出生命周期的引用。
概念解释
AndroidView 的 View 在分离时释放资源;Compose rememberCoroutineScope 在离开组合取消。Fragment/Activity 销毁时 ViewModel 协程统一取消。跨边界回调检查宿主是否存活,避免更新已分离视图。
原理流程
组合离开 → Compose 协程取消
View detach → 反注册监听
ViewModel 销毁 → viewModelScope 取消全部共享协程
代码或图示
DisposableEffect(Unit) {
val listener = view.register()
onDispose { view.unregister(listener) }
}
常见误区
- 用 GlobalScope 在互操作页面启动长任务,退出后仍回调。
- View 分离后 Compose 回调仍调用其方法。
追问
- 平台 View 生命周期回调怎么接?答:AndroidView update/释放钩子或 DisposableEffect 对应 attach/detach 时机。
- 共享状态收集在哪取消?答:ViewModel scope 或组合作用域,按状态归属选择。
07.1.1.7.3-060 从旧 View 页面迁移到 Compose 的渐进式路径是什么?
一句话结论
先在新页面用 Compose 实现,旧页面局部嵌入 ComposeView 替换组件,再逐屏迁移;状态与共享逻辑保留在 ViewModel,避免一次性重写整页。
概念解释
互操作允许混合存在:页面骨架与导航保留 View,内部卡片/表单先 Compose 化;旧自定义 View 通过 AndroidView 暂时复用。迁移顺序优先新页面与独立组件,复杂旧控件最后替换。每步可独立回归。
原理流程
新页面 → Compose 实现
旧页面 → ComposeView 嵌入新组件 → 逐屏替换
遗留控件 → AndroidView 复用 → 后续替换
代码或图示
阶段:共存 → 局部替换 → 页面级迁移 → 移除旧容器
常见误区
- 一次性重写整页,回归范围过大。
- 迁移时把 View 层状态直接搬到 Compose 内部,未提升到共享状态容器。
追问
- 旧 RecyclerView 怎么过渡?答:可先在 item 内嵌入 ComposeView 渲染新项,再整体换 Compose 列表。
- 迁移完成如何清理?答:移除对应 AndroidView/ComposeView 容器与旧绑定代码,保留共享 ViewModel。
07.1.1.7.3-061 复用旧自定义 View 时如何暴露状态与回调给 Compose?
一句话结论
在 AndroidView 包装层把 View 的状态绑定到 update 回调,把 View 事件转成 Compose 回调 lambda;适配器隔离旧控件 API,Compose 不直接接触内部实现。
概念解释
旧 View 通常有 setter 与监听器。包装层 factory 创建 View,update 调用 setter 同步数据;监听器回调调用传入的 onXxx。复杂控件可封装成独立 Compose 组件隐藏互操作细节。
原理流程
AndroidView(
factory = { CustomView(it) },
update = { it.bind(model) }
)
代码或图示
// View 内部 onClick → 包装层 onAction 回调 → Compose 状态更新
常见误区
- 包装层直接暴露 View 实例给业务组件,耦合旧实现。
- 监听器重复注册未反注册,多次回调叠加。
追问
- 旧 View 需要生命周期?答:在 DisposableEffect/View detach 钩子注册与释放。
- 复杂控件迁移优先级?答:稳定复用、渲染特殊的控件先保留;通用控件优先 Compose 重写。
07.1.1.7.3-062 Compose 中嵌入 WebView 时如何初始化与注入?
一句话结论
通过 AndroidView 包装 WebView,factory 初始化配置(设置、JS、缓存),update 加载 URL 或内容;生命周期与资源释放按 View 分离处理。
概念解释
WebView 是平台 View,不能用 Compose 组件替代。包装层配置 WebSettings、初始化 JS 桥、加载页面;状态变化时 update 同步 URL。注意 WebView 内存与进程泄漏,离开组合时销毁实例。
原理流程
factory 一次性创建并配置 WebView,update 在绑定变化时加载页面,资源随组合分离释放。
代码或图示
AndroidView(
factory = { ctx -> WebView(ctx).apply { settings.javaScriptEnabled = ... } },
update = { it.loadUrl(url) }
)
常见误区
- 每次重组重新 new WebView,factory 只执行一次。
- 离开页面未销毁 WebView 与移除桥接对象,内存泄漏。
追问
- JS 桥怎么注册?答:addJavascriptInterface 在 factory 初始化,分离时移除;接口对象引用避免持有 Activity 上下文。
- WebView 深色适配?答:跟随主题设置 WebView 兼容模式,具体 API 按系统版本核对。
07.1.1.7.3-063 WebView 与 Compose 之间的 JS 回调如何桥接?
一句话结论
JS 桥接口对象在 WebView 注册,JS 调用桥方法后通过包装层回调通知 Compose 状态;Compose 调 JS 走 evaluateJavascript,单向事件与命令分开处理。
概念解释
JS → 原生:桥接对象方法被调用,转发为包装层 onXxx 回调,更新 Compose 状态。原生 → JS:WebView evaluateJavascript 执行脚本。桥接口不持有 Activity 引用,回调切回主线程处理。
原理流程
JS 调用 bridge.postMessage(data)
→ 桥对象 → 包装层回调 → Compose state 更新
Compose 命令 → evaluateJavascript(script)
代码或图示
webView.addJavascriptInterface(bridge, "NativeBridge")
常见误区
- 桥对象持有 View/Activity 引用,泄漏上下文。
- JS 回调线程未确认,直接更新 UI 节点。
追问
- 消息类型如何校验?答:桥接口解析参数并做类型检查,非法消息忽略上报。
- 桥接口版本兼容?答:页面脚本与原生桥方法约定版本,缺失方法做兜底处理。
07.1.1.7.3-064 互操作边界上的性能代价体现在哪里?
一句话结论
边界存在 View 与 Compose 节点互转、状态绑定回调与跨层布局测量;过度混用、每重组新建 View 绑定、边界节点过多会增加布局与内存开销。
概念解释
AndroidView 持有平台 View 节点,参与传统测量绘制;ComposeView 容器承载 Compose 子树。边界状态同步走回调,频繁绑定产生额外调用。整页混用应评估是否直接迁移到一侧实现。
原理流程
边界节点:View 测量 + Compose 子树测量
→ 状态同步:update 回调每重组执行
→ 内存:两套节点体系共存
代码或图示
优化:减少边界层级,绑定数据稳定,避免每重组新建绑定对象
常见误区
- 在 Compose 列表里每项嵌 AndroidView,复用与内存成本高。
- update 回调里执行重绑定逻辑,重组时重复开销。
追问
- 如何度量边界成本?答:Perfetto 布局/绘制泳道对比纯 Compose 页面,观察节点数与绑定调用。
- 什么情况保留互操作?答:成熟平台控件、WebView、第三方 View 复用;通用 UI 逐步 Compose 化。
07.1.1.7.3-065 RecyclerView 与 Compose 列表混排时注意事项是什么?
一句话结论
跨列表复用边界要稳定 item 类型与 key;RecyclerView item 内嵌 ComposeView 时注意 Compose 子树复用状态,避免每项创建过重 Compose 节点。
概念解释
混排常见过渡方案:RecyclerView 项里放 ComposeView 渲染卡片。Compose 状态随 View 回收策略可能丢失,关键状态提升外部;项内 Compose 节点复用依赖 View 回收机制。长期应统一到 Compose Lazy 列表或纯 View 列表。
原理流程
RecyclerView 回收 item
→ item 内 ComposeView 复用
→ 内部状态按 View 复用边界保留/重建
代码或图示
过渡:RV item → ComposeView → Compose 卡片
目标:统一 LazyColumn 或保留 RV
常见误区
- 混用两套滚动与嵌套滚动机制,手势冲突。
- ComposeView 内持有项状态,回收滚动后错位。
追问
- 项状态保留在哪?答:列表外 ViewModel/适配器数据模型,Compose 只渲染传入参数。
- 复用 ComposeView 注意什么?答:绑定数据走 update 路径,清理旧状态回调。
07.1.1.7.3-066 主题与颜色如何从 View 体系传递到 Compose 组件?
一句话结论
在 ComposeView/AndroidView 边界组装 Compose Theme,颜色从共享主题状态或资源读取;View 侧与 Compose 侧引用同一套色值定义,避免两套硬编码。
概念解释
进入 Compose 子树前包裹 MaterialTheme,scheme 可从应用主题状态、资源映射或 View 侧当前配色构造。旧 View 颜色与 Compose 角色色统一在主题层定义,边界只做映射。主题变化时共享状态更新两侧。
原理流程
应用主题状态/资源
→ View 绑定颜色
→ Compose MaterialTheme(scheme) 包裹子树
代码或图示
composeView.setContent {
val scheme = remember(dark) { buildScheme(dark) }
MaterialTheme(colorScheme = scheme) { MixedContent() }
}
常见误区
- Compose 子树用默认主题,与旧 View 配色不一致。
- 两侧各自写死色值,深色模式切换不同步。
追问
- 旧主题属性如何映射 M3 角色?答:建立角色映射表,surface/onSurface/primary 逐项对应。
- 主题状态放哪?答:共享状态容器/ViewModel,两侧观察同一来源。
07.1.1.7.3-067 AndroidView 的 factory 与 update 回调分别在何时执行?
一句话结论
factory 在 View 首次创建时执行一次,构造平台 View;update 在每次重组(绑定数据变化)时执行,把最新参数同步到已有 View。
概念解释
factory 负责实例化与一次性配置;update 不是每帧必跑,随 Compose 重组执行。View 实例在组合期间复用,离开组合后随节点分离。把初始化放 factory、数据绑定放 update,职责不要颠倒。
原理流程
首次:factory 创建 View → update 首次绑定
重组:update 同步新参数
离开:View 分离回收
代码或图示
AndroidView(
factory = { WebView(it) }, // 一次
update = { it.loadUrl(url) } // 每次绑定
)
常见误区
- 在 factory 里绑定动态数据,后续更新不生效。
- update 里重复注册监听器,未先移除旧监听。
追问
- update 每次重组都跑吗?答:节点重组时执行;参数稳定时节点可跳过,回调频率与重组范围一致。
- View 重建条件?答:组合 group 离开后重新进入;复用期间实例不重建。
07.1.1.7.3-068 互操作中 View 分离(detach)时资源如何释放?
一句话结论
在 View detach、组合离开或宿主销毁时反注册监听、移除 JS 桥、停止动画与释放 WebView/编码器等重资源;释放逻辑成对注册。
概念解释
平台 View 持有系统资源与监听器,分离不等于 GC 自动清理。AndroidView 包装层配合 DisposableEffect 或 View 生命周期钩子释放。WebView、地图、播放器等需显式销毁。释放代码幂等,避免重复调用。
原理流程
注册:factory/effect 中添加监听/桥/资源
→ detach / onDispose → 反注册 + 销毁资源
代码或图示
DisposableEffect(Unit) {
val view = ...
onDispose { view.release() }
}
常见误区
- 只在 Activity onDestroy 释放,页面内 detach 时资源仍驻留。
- WebView 未 destroy,进程内存与桥引用泄漏。
追问
- 释放钩子挂在哪?答:View 的 onDetachedFromWindow 或 Compose onDispose;按资源类型选可靠时机。
- 如何验证释放?答:LeakCanary/内存堆分析观察 View 与桥对象回收。
07.1.1.7.3-069 旧 Activity 中调用 setContent 的条件与边界是什么?
一句话结论
Activity 启用 Compose 时通过 setContent { } 直接把 Compose 作为内容视图;需提供主题与生命周期绑定,不再叠加传统 View 布局容器,混合布局仍可用 ComposeView 嵌入。
概念解释
Activity 扩展 setContent 创建 Compose 承载视图并设置为内容。适合全新 Compose 页面;保留旧布局的页面在 XML 中放 ComposeView。setContent 生命周期跟随 Activity,配置变更按组合与 Saveable 规则处理。
原理流程
Activity onCreate 中 setContent 挂载 Compose 主题与根界面,不再叠加传统内容视图。
代码或图示
override fun onCreate(...) {
super.onCreate(...)
setContent { AppTheme { HomeScreen() } }
}
常见误区
- 同时 setContentView 旧布局又 setContent,视图容器冲突。
- setContent 内直接引用 Activity 上下文做重逻辑,泄漏风险。
追问
- Fragment 用 setContent 吗?答:Fragment 通过 ComposeView 加载;Activity 扩展方法绑定 Activity 作用域。
- 状态栏/旧窗口配置?答:仍在 Activity 窗口层面设置,Compose 只负责内容树。
07.1.1.7.3-070 共享 ViewModel 在 View 与 Compose 混合界面中如何取数?
一句话结论
两侧从同一 ViewModel 取状态:View 观察 LiveData/Flow,Compose collectAsState;事件都回调到 ViewModel 方法,状态源唯一。
概念解释
共享 ViewModel 作用域与页面宿主绑定,View 控件与 Compose 组件都是渲染层。View 侧用观察者订阅状态绑定控件,Compose 侧收集 StateFlow 渲染。避免两边各自拷贝状态副本。
原理流程
ViewModel: UiState + 事件方法
→ View observe → 绑定控件
→ Compose collectAsState → 渲染
事件:两侧 → ViewModel 方法 → 状态更新
代码或图示
// Compose
val uiState by vm.uiState.collectAsState()
// View
vm.uiState.observe(owner) { bind(it) }
常见误区
- View 与 Compose 各持一份本地状态,事件不同步。
- 把 ViewModel 实例通过静态单例传递,作用域混乱。
追问
- 作用域怎么选?答:Activity/Fragment 作用域按页面共享需求;跨页面用导航作用域或单例容器。
- 状态流类型混用?答:ViewModel 暴露 StateFlow/LiveData,两侧分别适配;推荐统一 Flow 源。
07.1.1.7.3-071 互操作布局中旧 View 与 Compose 约束如何对齐?
一句话结论
边界 View 按传统 measureSpec 测量,Compose 子树收到由容器尺寸转换的 Constraints;两侧尺寸通过容器修饰符/布局参数对齐,避免互相假设固定像素。
概念解释
ComposeView 在 ViewGroup 中按 View 布局规则获得尺寸,内部 Compose 约束由该尺寸派生。AndroidView 返回的平台 View 占用 Compose 布局位置,其内部 View 测量结果决定 placeable 尺寸。跨边界不要硬编码 px/dp,用约束与权重对齐。
原理流程
ViewGroup 测量 ComposeView(measureSpec)
→ 转换为 Compose Constraints
→ AndroidView 内 View 测量结果回传为 placeable 尺寸
代码或图示
AndroidView(
factory = { CustomView(it) },
modifier = Modifier.fillMaxWidth()
)
常见误区
- 在 Compose 侧假设旧 View 固定高度,内容变化后溢出。
- 旧布局给 ComposeView 零尺寸约束,Compose 内容不显示。
追问
- 双向 wrap 内容可行吗?答:边界能力受 View 测量协议约束,复杂自适应需在容器层声明尺寸策略。
- 嵌套滚动冲突?答:按平台嵌套滚动机制协调,混合列表单独验证滑动手势。
07.1.1.7.3-072 如何在 Compose 里复用旧的图片加载控件?
一句话结论
通过 AndroidView 包装旧 ImageView/自定义图片控件,update 绑定模型与加载参数,回调(加载完成、点击)转成 Compose 事件;新代码优先用 Compose 图片加载方案。
概念解释
旧控件封装了加载、缓存、圆角处理时可暂时复用。包装层把 URL/占位符/形状传入 setter,加载状态回调给 Compose。图片控件内部线程与缓存不受 Compose 管理,注意释放与复用状态。
原理流程
AndroidView(
factory = { ImageView(it) },
update = { it.bindImage(model) }
)
代码或图示
旧图片控件 → 包装组件暴露 model + onClick 回调
常见误区
- 在 factory 里加载图片,后续 URL 更新不重新触发。
- 控件持有旧上下文引用,页面回收后泄漏。
追问
- 新 Compose 图片方案?答:Coil/Glide 等 Compose 集成工件按项目栈选择;版本坐标以官方库为准。
- 圆角与裁剪在边界怎么处理?答:能在 Compose 修饰符层做的不依赖旧控件内部实现。
07.1.1.7.3-073 WebView 状态保存与进程回收在互操作中要注意什么?
一句话结论
WebView 页面状态不由 Compose remember 保存;配置变更用 WebView saveState/restoreState 处理,进程回收后按需重新加载,桥接对象与生命周期成对释放。
概念解释
WebView 内部历史与表单状态平台化管理。配置变更可保存 WebView 状态;进程死亡后内存状态清空,应恢复 URL 或重新加载。不要把 WebView 实例放进 Saveable,桥接口引用避免持有 Activity。
原理流程
配置变更:webView.saveState(bundle) → 重建后 restoreState
进程回收:状态不可恢复 → 按持久化 URL/表单数据重载
代码或图示
// saveState 返回的 bundle 存入保存容器;恢复时传入 restoreState
常见误区
- 把 WebView 当作普通 Compose 组件靠 remember 保留。
- 进程回收后恢复 WebView 实例引用,实际对象已销毁。
追问
- WebView 多实例内存?答:按页面数量控制实例,离开销毁;必要时独立进程隔离(另见场景题)。
- 表单草稿保存?答:原生侧收集关键表单数据持久化,不依赖 WebView 内部状态跨进程保留。
07.1.1.7.3-074 混合页面返回手势与 Compose 导航如何衔接?
一句话结论
返回事件由宿主导航/Activity 处理,Compose 内部返回拦截(BackHandler)在混合树中注册;旧 View 容器与 Compose 导航共享同一返回栈,避免双重消费。
概念解释
Compose 返回处理挂在组合树的可返回节点上;混合页面中 View 体系返回键与 Compose BackHandler 都可能响应。导航事件统一由宿主分发,子层只声明是否拦截。返回手势在容器层面协调,不跨边界自行消费。
原理流程
系统返回 → 宿主导航分发
→ Compose BackHandler 声明拦截
→ 未拦截 → 旧 View/Activity 回退
代码或图示
BackHandler(enabled = panelOpen) { closePanel() }
常见误区
- Compose 与旧容器各自处理返回,页面退出两次或状态错乱。
- 弹层打开时返回事件未拦截,直接退出页面。
追问
- Navigation 组件混合使用?答:导航状态归共享导航宿主,Compose 目的地与旧 Fragment/Activity 按导航图衔接。
- 手势滑动返回冲突?答:检查边缘手势与内部滚动组件的嵌套滚动竞争。
07.1.1.7.3-075 互操作单元测试如何同时覆盖 View 与 Compose 节点?
一句话结论
仪器化测试先通过 View 断言旧控件状态,再用 Compose 规则查询边界内 Compose 语义节点;共享 ViewModel 在两侧断言同一状态来源。
概念解释
混合页面测试分两段:View 节点用传统视图查找断言,Compose 子树用 onNodeXxx 断言。操作分别触发两侧事件,最终状态以 ViewModel 为准。测试环境保留真实宿主 Activity 以承载两套节点。
原理流程
宿主 Activity 加载混合布局
→ View finder 断言旧控件
→ composeRule 查询 Compose 节点
→ 共享 ViewModel 状态交叉验证
代码或图示
测试:触发 Compose 按钮 → 断言 View 标签更新;反之亦然
常见误区
- 只用 Compose 规则测整页,遗漏旧 View 控件行为。
- 两侧状态各造副本,测试通过但真实页面不同步。
追问
- 边界节点定位?答:ComposeView 在视图树中有 id/标签,规则可附着到该容器;具体 API 按测试库版本核对。
- 纯逻辑仍走 JVM 单测?答:ViewModel 与状态计算独立单测,仪器化只覆盖渲染与事件链路。
07.1.1.7.3-076 ComposeView 嵌套在旧 ViewGroup 中尺寸测量有何坑?
一句话结论
旧 ViewGroup 的 measureSpec 决定 ComposeView 尺寸,WRAP_CONTENT 与 MATCH_PARENT 映射到 Compose 约束不同;不正确的规格会导致 Compose 内容铺满、塌缩或溢出。
概念解释
Compose 约束由 View measureSpec 转换:精确尺寸对应有限 max,WRAP 对应内容测量。旧布局给固定宽度但高度 WRAP,Compose 子树自适应高度;约束无穷大时子项按内容尺寸。嵌套多层容器时约束逐层转换,任一层规格错误都表现为显示异常。
原理流程
ViewGroup measureSpec
→ ComposeView 布局参数
→ Compose Constraints(min/max 宽高)
代码或图示
<ComposeView android:layout_width="match_parent"
android:layout_height="wrap_content" />
常见误区
- 旧布局高度为 0 或 WRAP 但 Compose 内容依赖填满父级。
- 嵌套滚动容器内约束传递不当,子项测量异常。
追问
- 如何调试约束?答:在 Compose 布局日志打印 Constraints,对照旧容器 measureSpec。
- Compose 侧 fillMaxParent 依赖什么?答:父级传入有限最大约束;无穷约束下填满无意义。
07.1.1.7.3-077 旧 View 监听(点击、文本变化)如何转成 Compose 回调?
一句话结论
在 AndroidView 包装层把 View 监听器回调转调 Compose 传入的 onXxx lambda;监听器在 factory 注册、update 绑定最新回调引用,分离时反注册。
概念解释
旧 View 用 OnClickListener、TextWatcher 等接口;包装层持有 Compose 回调引用,事件触发时转发。回调引用可能更新,用 rememberUpdatedState 保持最新。注册与反注册成对,避免旧监听叠加。
原理流程
AndroidView(
factory = { view ->
view.onClick = { onAction(view.extract()) }
},
update = { it.bind(data) }
)
代码或图示
View 事件 → 包装监听 → Compose onXxx 回调 → 状态更新
常见误区
- 监听捕获旧回调闭包,更新后仍调旧实现。
- 多次 update 重复 setClickListener,覆盖或叠加未清理。
追问
- 回调参数类型?答:从 View 提取领域数据再回调,不把 View 实例传给 Compose 层。
- 文本变化防抖?答:在包装层或 ViewModel 层做节流,避免每个字符穿透到 Compose 重组。
07.1.1.7.3-078 互操作场景下内存泄漏的高发点在哪里?
一句话结论
Activity/View 上下文被静态或桥对象持有、WebView/地图/播放器未销毁、监听器未反注册、协程作用域未取消,是互操作页面泄漏的主要来源。
概念解释
跨边界引用容易把短生命周期宿主传入长生命周期对象:JS 桥、单例回调、旧控件缓存。平台重资源控件离开页面必须显式释放。监听器注册在 factory/effect,反注册挂到 detach/onDispose。
原理流程
注册引用 → 离开页面未释放
→ 宿主 View/Activity 被长生命周期持有
→ 堆分析找到泄漏引用链
代码或图示
排查:LeakCanary 观察 Activity/View 泄漏链 → 桥对象 / 监听 / 控件缓存
常见误区
- 只查 Compose remember 泄漏,忽略旧 View 与桥接口引用。
- WebView 作为子 View 留在缓存复用,上下文无法回收。
追问
- 桥对象为什么泄漏?答:JS 桥持有 context 引用,WebView 存活则链不断;桥应持有 Application 或弱引用,按规范实现。
- 如何回归泄漏?答:页面反复进入退出后堆转储分析,观察 Activity 实例数量。
07.1.1.7.3-079 何时应该保留旧 View 而不强行迁移 Compose?
一句话结论
成熟平台控件、高度定制的旧视图、第三方强绑定 View 的 SDK、迁移成本高于收益的复杂交互,可暂时保留;通用展示与表单组件优先 Compose 化。
概念解释
迁移决策看复用成熟度、渲染特殊度、团队成本与收益。旧自定义 View 渲染稳定且难以重写时,AndroidView 包装过渡;强行重写可能引入回归。保留边界需控制数量,避免每页混合两套体系。
原理流程
评估:控件复杂度 / 第三方绑定 / 回归风险 / 复用价值
→ 保留:包装互操作
→ 通用组件:迁移 Compose
代码或图示
保留:地图、播放器、复杂图表、SDK 强 View 控件
迁移:按钮、卡片、表单、列表行
常见误区
- 为统一技术栈重写稳定控件,回归风险被低估。
- 保留边界无清单,长期积累大量互操作包袱。
追问
- 保留控件的演进路径?答:包装成 Compose 友好接口,后续内部逐步替换实现。
- 决策依据记录在哪?答:模块迁移文档标注保留原因与后续替换条件。
07.1.1.7.3-080 Compose 与 View 共用资源(Drawable、颜色)的方式是什么?
一句话结论
颜色与字符串引用资源定义,Compose 通过 ColorResource/stringResource 读取;Drawable 可在互操作边界复用,图形资源统一放共享资源目录,不重复定义两份色值。
概念解释
共享资源(色值、字符串、图标)在资源层单一来源,View 与 Compose 分别读取。Compose 颜色从资源构造,Drawable 在 AndroidView 或 Image 资源引用使用。主题切换时资源随容器配色方案更新,避免 Compose 侧硬编码镜像色值。
原理流程
val color = MaterialTheme.colorScheme.primary
// 资源读取:stringResource(R.string.title)
代码或图示
共享 res/values/colors.xml → View 引用 + Compose 资源读取
常见误区
- Compose 侧硬编码与旧资源相同的色值,主题调整时漏改。
- 同一图标在两套体系各存一份位图。
追问
- VectorDrawable 在 Compose 怎么用?答:ImageVector 资源引用或 painterResource;具体 API 以库版本为准。
- 深色资源如何配合?答:资源限定符目录 + Compose scheme 角色映射,两侧跟随同一暗色状态。
07.1.1.7.3-081 Compose 依赖坐标在 build.gradle 中如何组织?
一句话结论
BOM 平台依赖统一版本,各 ui/material3/animation 等工件不写版本号;测试与预览工件放对应源集,模块只声明需要的 Compose 库。
概念解释
依赖分基础 ui 运行库、material3 组件、动画、图标、测试工具等组。BOM 锁定兼容集合。模块按需引入,避免全量拉取未用库。版本声明集中在版本目录或根配置,业务模块不散落硬编码版本。
原理流程
BOM 作为平台依赖锁定版本,各工件只声明坐标不写版本号,按模块需要引入。
代码或图示
implementation(platform("androidx.compose:compose-bom:2024.x"))
implementation("androidx.compose.ui:ui")
implementation("androidx.compose.material3:material3")
常见误区
- 每个工件单独写版本号,互相错配。
- 引入全套 Compose 库,APK 体积与方法数增加。
追问
- 图标库单独依赖吗?答:material-icons 工件按需引入;自动图标与扩展图标分工件,以官方文档为准。
- 版本目录怎么管?答:BOM 与各 artifact 条目列入 libs 版本目录,模块引用目录别名。
07.1.1.7.3-082 BOM 缺失时手动管理版本有哪些风险?
一句话结论
手动拼版本容易出现 ui 运行库、组件库、动画库之间不兼容,表现为 API 缺失、运行时符号错误或样式异常;升级时需要逐库核对兼容矩阵。
概念解释
BOM 提供经过验证的版本组合。手动选择各库版本可能新旧混搭,编译期缺 API,运行期类方法签名不匹配。缺少统一基线时升级一个库会牵动其他库回归。测试与生产库版本也易错配。
原理流程
无 BOM:各库独立版本 → 兼容关系靠人工核对
有 BOM:平台解析兼容集合 → 工件跟随同一基线
代码或图示
风险:ui 1.x 与 material3 2.x 混搭 → 运行时 NoSuchMethod/样式异常
常见误区
- 只升级 material3 而不跟 ui 运行库版本。
- 测试工件版本比生产旧,节点查询行为不一致。
追问
- 必须强制某库版本怎么办?答:在 BOM 基础上对单库显式覆盖,并验证兼容;不要整体脱离 BOM。
- 如何查看解析版本?答:Gradle 依赖树输出各 artifact 最终版本。
07.1.1.7.3-083 compose compiler 与 Kotlin 版本对应关系如何确认?
一句话结论
Kotlin 2.x 编译器插件随 Kotlin 工具链发布,对应关系查官方 Kotlin/Compose 发布说明;旧 1.x 独立 compiler 工件与 Kotlin 版本一一绑定,不可跨版本混用。
概念解释
编译器处理 @Composable 代码生成,与 Kotlin 语言版本强相关。版本不匹配会编译失败或生成代码与运行库不兼容。确认渠道:官方兼容表、发布说明、构建警告。项目升级 Kotlin 时同步核对编译器配置。
原理流程
Kotlin 版本 → 查官方对应 Compose 编译器支持
→ 配置编译器选项
→ 编译验证通过
代码或图示
不确定组合:先在样例模块编译验证,再全量升级
常见误区
- 照搬旧项目 compiler 坐标到 Kotlin 2.x。
- 升级 Kotlin 后不改编译器配置,出现编译错误。
追问
- 兼容表在哪查?答:JetBrains/Android 官方 Compose 与 Kotlin 发布说明;标「待确认」时以样例编译结果为准。
- 多模块 Kotlin 版本要一致吗?答:统一工具链版本,避免模块间语言与编译器差异。
07.1.1.7.3-084 模块只提供可组合项时需要哪些编译配置?
一句话结论
模块需要启用 Compose 编译支持、声明 ui 运行库依赖;主题/组件库不需要 Activity 宿主,但测试与预览依赖按需加入。
概念解释
库模块暴露 @Composable 函数与组件,编译期需要 Compose 编译器处理;运行时依赖 ui 工件。纯数据模型与工具函数模块不需要 Compose 配置。对外 API 参数使用稳定不可变类型,保证使用者可跳过重组。
原理流程
含 @Composable 模块:编译器支持 + ui 依赖
→ 暴露组件 + 不可变模型
代码或图示
core-compose:组件 + 主题;core-model:纯数据类(无 Compose 依赖)
常见误区
- 库模块只加运行库未启用编译器,@Composable 调用编译失败。
- 模块暴露内部可变状态类型作为公共参数。
追问
- 主题库依赖什么?答:material3 与 ui 工件;颜色/排版定义不依赖业务模块。
- 模块能否反向依赖 App?答:组件库不应依赖 App 层,方向保持单向。
07.1.1.7.3-085 预览能力依赖哪些 artifact,缺失时表现是什么?
一句话结论
预览依赖 ui 运行库与预览工件(compose-ui-tooling);缺失时 @Preview 不渲染,编辑器提示预览不可用或类找不到。
概念解释
预览注解与渲染工具在独立 tooling 工件中,通常放 debugImplementation 或对应源集。生产包不打包预览工具。缺少 tooling 依赖时 Studio 无法加载预览,组件本身运行不受影响。
原理流程
运行库提供组件能力,预览 tooling 工件只进调试源集,供编辑器加载 @Preview。
代码或图示
implementation ui 运行库
debugImplementation compose-ui-tooling
→ Studio 识别 @Preview 渲染
常见误区
- 预览工件误放生产依赖,增大包体。
- 只在某个模块加 tooling,其他模块预览失效。
追问
- 预览与测试工件区别?答:tooling 供编辑器渲染,ui-test 供仪器化测试,二者独立。
- 版本由谁对齐?答:同样走 BOM 管理预览工件版本。
07.1.1.7.3-086 测试依赖与生产依赖如何分离配置?
一句话结论
生产 Compose 库进 implementation,测试规则/ matcher 进 androidTestImplementation,预览工具进 debugImplementation;测试替身与假数据只在测试源集声明。
概念解释
依赖源集决定打包范围:仪器化测试工件不进发布包,预览工具不打包到用户应用。模块间共享的测试工具可单独 test 源集或测试模块提供。配置分离避免测试替身泄漏到生产代码。
原理流程
按源集划分:生产实现、仪器化测试、调试预览各自独立,测试替身不进 main。
代码或图示
implementation:ui、material3、animation
androidTestImplementation:ui-test-junit4、manifest
debugImplementation:ui-tooling 预览
常见误区
- 测试假实现放进 main 源集,生产包携带测试代码。
- 预览工件打成 release 依赖,增大体积。
追问
- 跨模块测试复用?答:抽取测试依赖模块,各 androidTest 源集引用;避免业务模块复制测试工具。
- 截图测试库放哪?答:androidTest 或独立测试模块,不进生产实现。
07.1.1.7.3-087 混淆规则中 Compose 类与反射访问有哪些注意点?
一句话结论
Compose 生成代码遵循库自带 consumer 规则;应用自定义反射、Saver、Parcelable、注解驱动实例化的类型需补充保留规则,release 构建必须验证成员不被裁剪。
概念解释
默认不需要手写全量 keep Compose 类。风险点:反射创建的组件/模型、SavedState 恢复类、序列化字段、JNI 绑定类。混淆后崩溃先查成员是否缺失,补充对应保留规则,而不是关闭整体混淆。
原理流程
release R8 构建
→ 库 consumer 规则覆盖 Compose 运行约定
→ 自定义反射/序列化类补 keep
代码或图示
排查:符号缺失 → 反查反射/Saver 引用链 → 保留类成员
常见误区
- 给所有 Compose 包加 keep,丧失裁剪与混淆收益。
- 只在 debug 验证,release 混淆后字段被裁剪。
追问
- ProGuard 规则从哪来?答:依赖库携带 consumer 规则自动应用;应用自身反射代码写项目规则。
- 如何回归?答:minify release 包跑关键页面、状态恢复与反射创建路径。
07.1.1.7.3-088 常见编译错误:未解析的 @Composable 如何排查?
一句话结论
先查模块是否启用 Compose 编译器、运行库依赖是否声明、BOM/版本是否解析到,再看函数是否漏标注解或导入;最后清理构建缓存验证。
概念解释
未解析常见原因:模块缺编译器配置、缺 ui 依赖、版本未解析、调用方函数未加 @Composable 标注、导入缺失。多模块场景下被调组件所在模块未被依赖。按「配置 → 依赖 → 注解 → 缓存」顺序排查。
原理流程
编译报错未解析 @Composable
→ 模块编译器开关 → 依赖工件 → 导入/注解 → clean 重建
代码或图示
检查:build.gradle 编译器配置 + implementation ui 工件
常见误区
- 只清缓存不核对依赖,错误反复出现。
- 工具函数在非组合模块调用 @Composable,缺少编译器支持。
追问
- 报错指向编译器插件?答:核对 Kotlin 与编译器版本对应关系,清理 Gradle 缓存。
- 跨模块找不到组件?答:确认模块依赖方向与公共导出,组件未 internal/私有。
07.1.1.7.3-089 资源(字符串、颜色、Drawable)在 Compose 中引用方式是什么?
一句话结论
字符串用 stringResource,颜色从资源构造 Color,图标用 painterResource/ImageVector;Compose 不直接操作旧 View 资源 API,按组件读取可组合资源访问器。
概念解释
资源访问器在组合上下文中读取配置(语言、密度、主题)。字符串、颜色、矢量图标通过对应 Resource 函数获取;Drawable 位图在 Image 或互操作边界使用。资源变化(配置切换)时读取点重组刷新。
原理流程
Text(stringResource(R.string.title))
Icon(painterResource(R.drawable.ic_home), contentDescription = null)
代码或图示
颜色:ColorResource 或资源转 Color;深色资源走限定符目录
常见误区
- 在非组合普通函数里调用资源访问器,缺少组合上下文。
- 硬编码字符串/颜色,绕过资源多语言与主题能力。
追问
- 复数/格式化字符串?答:按资源格式化 API 传参数;具体函数签名以版本为准。
- 颜色资源与主题色选择?答:品牌角色色走 ColorScheme,固定资源色走资源读取。
07.1.1.7.3-090 跨模块主题下发与本地覆盖如何避免硬编码?
一句话结论
主题定义集中在共享主题模块,组件模块只读 MaterialTheme/扩展 CompositionLocal;局部覆盖通过 provider 在子树提供,业务组件不写死色值与圆角。
概念解释
多模块协作时,主题 token 由主题模块统一定义,其他模块消费。扩展颜色通过自定义 CompositionLocal 下发。局部覆盖只在包裹子树内 provider,不修改全局主题。组件库提供默认主题适配,不依赖特定 App 色值。
原理流程
theme-module:scheme/typography/shapes/扩展 local
→ feature 模块:读取主题渲染
→ 局部覆盖:子树 Provider
代码或图示
// 组件内:MaterialTheme.colorScheme.primary
// 不出现 Color(0xFF...) 字面量
常见误区
- 组件库内置写死品牌色,换肤时无法覆盖。
- 局部覆盖直接改全局可变单例,污染其他子树。
追问
- 主题模块被依赖方向?答:组件模块依赖主题接口层,App 提供具体实现,避免反向依赖。
- 缺省主题怎么处理?答:组件库带默认 scheme,预览与独立使用可渲染。
07.1.1.7.3-091 多模块 Compose 依赖版本不一致会出现什么问题?
一句话结论
不同模块解析到不同 Compose 工件版本时,可能出现 API 签名不匹配、运行时类缺失、组件样式与行为差异,严重时编译失败或发布包崩溃。
概念解释
Compose 各工件协同发布,模块各自引版本会造成混合基线。即使编译通过,运行库与组件库版本差也可能触发方法缺失。统一 BOM 后依赖树各工件回到兼容集合。
原理流程
模块 A:ui 版本 x;模块 B:material3 版本 y
→ 依赖树解析冲突 → 取某版本 → 另一模块假设的 API 不存在
代码或图示
排查:Gradle 依赖树查看各 compose-* 解析版本 → 统一回 BOM
常见误区
- 库模块声明旧版本,App 覆盖新版本,边界签名错配。
- 测试工件与生产工件版本漂移。
追问
- 冲突解析规则?答:Gradle 取最高版本或按声明顺序,不代表兼容;必须以 BOM 组合为准。
- 如何在 CI 检查?答:依赖树任务校验 Compose 工件版本一致性。
07.1.1.7.3-092 AGP 与 Compose 编译器版本兼容矩阵如何查证?
一句话结论
查 Android Gradle Plugin、Kotlin、Compose BOM/编译器三方官方发布说明与兼容表;本地用样例工程编译验证,不凭经验猜版本组合。
概念解释
AGP 决定构建插件与 API,Kotlin 决定语言与编译器,Compose BOM 决定运行库基线。三者互相约束。升级顺序通常按官方迁移指南:Kotlin → 编译器配置 → Compose 库版本。构建警告会提示不匹配组合。
原理流程
当前 AGP / Kotlin / BOM
→ 官方发布说明查兼容区间
→ 样例模块编译 + 测试验证
代码或图示
不确定处标「待确认」:以目标版本官方文档与实际编译结果为准
常见误区
- 跟随网上旧博客版本号,忽略版本已迭代。
- 一次升级多个维度,出问题无法定位是哪一方不兼容。
追问
- 升级前准备?答:记录当前版本基线,按指南分步升级,每步跑构建与测试。
- 构建警告优先级?答:编译器/AGP 弃用警告先处理,再升运行库。
07.1.1.7.3-093 Compose 生成的代码对方法数与 APK 体积有什么影响?
一句话结论
Compose 编译器为可组合调用生成节点与状态管理代码,基础运行库带来方法数与体积增量;按需引入工件、R8 裁剪与资源优化可控制体积,具体增量以构建分析为准(待确认不编造数值)。
概念解释
每个可组合项生成组合记录代码,运行库包含布局、绘制、动画框架。未使用组件被 R8 裁剪。体积增量与页面数量、引入库数量相关,不能给通用固定数值。通过 APK 分析查看 Compose 相关 dex 与资源占比。
原理流程
源码 @Composable → 编译器生成组合代码
→ 运行库打包 → R8 裁剪未用路径
→ APK 分析统计 Compose 相关体积
代码或图示
评估:app 分析器查看 dex/资源/库占比;对比启用混淆前后
常见误区
- 引用固定体积数字作为承诺,实际取决于依赖与页面规模。
- 一次性引入全部 material/图标工件。
追问
- 哪些库按需引入?答:图标、动画扩展、测试工具等未用不打包;核心 ui 运行库基础存在。
- 体积回归怎么监控?答:CI 记录 APK/AAB 大小分模块占比,超阈值告警。
07.1.1.7.3-094 如何在 CI 上验证 Compose 测试与截图基准?
一句话结论
仪器化测试在 CI 设备/模拟器矩阵跑节点断言;截图测试在固定环境生成或对比基准,失败输出差异图像;构建流程区分单测、仪器化测试与视觉回归。
概念解释
CI 需要可复现的渲染环境:固定密度、字体、系统镜像。测试任务编译 androidTest 并在连接设备上执行;截图基准随仓库管理,差异超阈值失败。环境不一致会导致截图误报,基准集按设备维度组织。
原理流程
CI 构建 → JVM 单测 → 仪器化 Compose 测试
→ 截图对比基准 → 产物报告/差异图上传
代码或图示
门禁:单元测试通过 + 关键页面 Compose 测试通过;视觉回归单独任务
常见误区
- 本地模拟器与 CI 镜像字体/密度不同,截图大面积误报。
- 截图基准自动覆盖,真实视觉回归被吞掉。
追问
- 仪器化测试慢怎么办?答:核心链路入 CI,长尾测试分阶段;纯逻辑下沉单测。
- 基准图更新流程?答:评审确认视觉变更后显式更新基准集。
07.1.1.7.3-095 旧项目接入 Compose 的最低工程条件是什么?
一句话结论
满足最低 AGP/Kotlin/SDK 版本基线,引入 Compose BOM 与 ui 工件、启用编译器配置;工程可保留既有 View 体系,从新页面或局部组件共存接入。
概念解释
接入前核对 minSdk、AGP、Kotlin 版本与官方 Compose 要求。不需要全量重写:依赖配置就绪后,新页面 setContent 或旧布局嵌 ComposeView。团队需掌握组合、状态与互操作基础。构建与测试流水线先跑通混合构建。
原理流程
核对版本基线 → 加 BOM + ui 依赖 + 编译器配置
→ 首个 Compose 页面/组件共存
→ 逐步扩展
代码或图示
条件:minSdk/compileSdk 达到要求;Kotlin 工具链兼容;构建可编译可测试
常见误区
- 版本基线未达标强行接入,编译器与运行库报错。
- 一上来全量替换,缺少混合构建与回滚方案。
追问
- minSdk 要求?答:以目标 Compose BOM 官方说明为准;旧 minSdk 需先升级基线。
- 接入顺序?答:先工具链与依赖,再一个静态页面试点,最后交互复杂页面。
07.1.1.7.3-096 Compose 与 View 动画互操作时状态如何同步?
一句话结论
动画状态归共享状态容器,View 侧动画监听结束回传状态,Compose 侧读取同一状态驱动过渡;边界两侧不各自维护独立动画进度。
概念解释
混合动画常见于旧控件转场、嵌入视图位移。当前动画进度/目标状态放在 ViewModel 或包装状态中,View 动画结束回调更新状态,Compose 读取后切换节点。避免 View 动画与 Compose 动画并行驱动同一属性。
原理流程
触发目标状态
→ View 动画执行 → 结束回调更新状态
→ Compose 收集状态 → 执行对应过渡
代码或图示
避免:View 内部动画进度 + Compose 另一份动画值同步
常见误区
- 两侧各跑动画,位移/透明度叠加不一致。
- 动画结束事件未回传,Compose 状态停留在过渡中间态。
追问
- 手势跟随跨边界?答:输入事件统一到共享状态,两侧按状态渲染;复杂手势优先在一侧体系内完成。
- 动画资源共享?答:插值器/曲线定义统一,View 与 Compose 动画规格对齐节奏。
07.1.1.7.3-097 常见运行时异常:IllegalStateException 节点未附加如何排查?
一句话结论
该类异常通常在组合上下文之外访问节点、持有的引用过期、或互操作 View 在分离后被操作;排查引用持有时机、回调线程与生命周期边界。
概念解释
Compose 节点只在组合生命周期内有效。异步回调、单例缓存、旧 View 引用在节点离开组合后仍访问,会触发状态异常。互操作中 View detach 后方法调用同样报错。检查异常堆栈中的节点/View 引用来源与持有时机。
原理流程
异常堆栈:访问节点/View 的调用点
→ 回溯引用何时持有
→ 是否在离开组合/detach 后回调
代码或图示
排查方向:协程回调、桥对象、缓存引用、异步任务未取消
常见误区
- 在 GlobalScope 回调中更新组合节点。
- 把 AndroidView 的 View 实例传到页面外长期持有。
追问
- 如何复现?答:快速进出页面 + 异步回调竞态,反复操作观察触发路径。
- 修复原则?答:状态回调走共享状态容器,节点引用只在组合作用域内使用;离开时取消任务。
07.1.1.7.3-098 Compose 本地预览与设备行为不一致时如何核对?
一句话结论
依次核对主题包裹、资源配置、依赖版本、密度字号与异步默认值;预览是简化渲染环境,真实交互与平台能力必须在设备/模拟器验证。
概念解释
预览差异来源:预览未注入真实依赖、主题/资源未包裹、版本与调试运行不一致、密度本地化不同、组件依赖未加载的异步状态。先在预览隔离最小复现,再对照设备渲染。动态取色、传感器、平台服务预览无法模拟。
原理流程
预览异常
→ 主题/假数据/资源核对
→ 依赖版本与运行构建核对
→ 设备复验平台相关行为
代码或图示
检查清单:setContent 等价包裹、locale/fontScale、异步初值、库版本
常见误区
- 预览正常就断言设备无问题,平台 API 与真实数据未验证。
- 预览里硬编码假数据,上线后真实状态布局不同。
追问
- 预览布局溢出设备不溢出?答:核对密度与约束,预览尺寸配置与设备屏幕对比。
- 版本差异怎么查?答:预览工具版本与应用运行库版本对齐 BOM。
07.1.1.7.3-099 第三方 Compose 库版本升级需要回归哪些点?
一句话结论
回归核心组件渲染、状态交互、主题适配、动画行为与测试快照;重点查废弃 API、兼容性声明与库自带默认样式变化。
概念解释
升级库版本可能改组件默认外观、参数行为、动画时长与语义。先读发布说明与迁移清单,编译替换废弃调用,再跑仪器化测试与截图基准。核心页面走查深浅色、字号与常见交互。库版本跟随 BOM 节奏,避免单独跨大版本跳跃。
原理流程
读发布说明 → 升级依赖 → 编译修复废弃 API
→ 跑测试 + 截图基准 → 核心页面人工走查
代码或图示
回归清单:渲染样式、状态回调、主题颜色、动画、无障碍语义
常见误区
- 只编译通过就发布,未验证默认样式变化。
- 截图基准未更新,旧视觉与新库默认样式冲突。
追问
- 大版本跳跃怎么处理?答:按迁移指南分步升级,参考库提供的迁移说明;不确定行为标「待确认」设备实测。
- 库与 BOM 关系?答:优先用 BOM 指定版本,单独升级需验证兼容矩阵。
07.1.1.7.3-100 工程化上如何统一团队 Compose 依赖与规范?
一句话结论
通过版本目录统一 BOM 与工件版本,沉淀共享主题/组件库与代码规范,评审组件参数稳定性、状态提升与互操作边界;测试与预览模板复用公共模块。
概念解释
工程化统一内容:依赖版本基线、主题与设计 token、可复用组件、状态单向数据流约定、稳定性与性能审查清单、测试/预览模板。规范在代码评审与 CI 检查中落地,避免各模块自造主题与回调模式。
原理流程
版本目录 + BOM 基线
→ 共享主题/组件/测试工具模块
→ 代码规范评审 + CI 依赖与测试门禁
代码或图示
规范要点:不可变参数、状态提升、读取下沉、复用修饰符、边界隔离
常见误区
- 规范只写文档,评审与 CI 不检查,各模块风格漂移。
- 共享组件库过早抽象,业务变体堆积成配置开关。
追问
- 新成员上手顺序?答:先掌握组合/状态/基础布局,再读共享组件与主题约定。
- 规范演进怎么维护?答:随版本基线更新,废弃 API 与迁移点记录在模块说明中。
参考来源
- Compose 性能与重组优化:重组作用域、稳定性、分配与图层优化。
- Compose 测试:createComposeRule、语义树、matcher 与异步等待。
- Compose 与 View 互操作:ComposeView、AndroidView 与渐进迁移。
- Baseline Profile 与 Macrobenchmark:配置生成、启动与滚动度量。
- Compose BOM 与依赖管理:BOM 对齐、编译器配置与工件组织。
待整理清单
- [ ] 核对 Kotlin 2.x 下 Compose 编译器插件的确切 gradle 配置项名称与开关。
- [ ] 补充目标 BOM 版本下测试工件(junit4/junit5)与截图测试库的准确坐标。
- [ ] 梳理项目实际使用的图片加载库 Compose 集成方式与版本坐标。
- [ ] 统计 Compose 在各模块的方法数与 APK 体积基线,避免引用通用数值。
- [ ] 整理团队共享主题、组件与测试模板模块的落地清单。