07.1.1.7.2 布局、绘制、动画与主题
所属:全栈开发面试题库 / 07 端侧与桌面开发 / 07.1 原生移动开发 / 07.1.1 Android / 07.1.1.7 Jetpack Compose 深入
本节要解决的问题
本节覆盖 Modifier 链语义、测量与自定义布局、绘制阶段与图层、动画 API 选型,以及 Material 3 主题体系。面试重点是修饰符顺序陷阱、测量约束协议、图层离屏条件与动画状态管理。版本基线:Compose BOM 2024.x、Kotlin 2.x、Android 14 / compileSdk 34;版本敏感行为标「待确认」并写明验证点。
07.1.1.7.2-001 Modifier 在 Compose 中是什么,由哪些部分组成?
一句话结论
Modifier 是描述节点布局、修饰、绘制与行为的链式声明对象,每个修饰符节点负责一个阶段的能力,链由外到内依次作用于同一组件。
概念解释
Modifier 本身是接口,Modifier 单例表示空修饰链。常见修饰符分属测量布局(padding、size、align)、绘制(background、clip、drawBehind)、行为(clickable、pointerInput)与图层(graphicsLayer)等类别,串联后在各阶段按顺序执行。
原理流程
Modifier.a.then(Modifier.b)
→ 测量 / 布局阶段:a 先于 b
→ 绘制阶段:链顺序决定背景、裁剪、前景的叠加层级
代码或图示
Modifier
.padding(16.dp)
.background(Color.Gray)
.clickable { }
常见误区
- 把 Modifier 当成普通样式对象集合,忽略它在各阶段的执行顺序。
- 认为所有修饰符都作用于绘制阶段,实际 padding 影响测量与尺寸。
追问
- 修饰符链存在哪里?答:作为节点关联的修饰数据随组合树保存,重组时按链复用。
- 空 Modifier 有什么意义?答:作为参数默认值,表示不追加任何能力。
07.1.1.7.2-002 Modifier 链的执行顺序为什么是从外到内?
一句话结论
链上先声明的修饰符包在外侧,先参与测量约束转换与背景绘制;后声明的位于内侧,作用于内容本身。
概念解释
Modifier 链类似包裹层:外层 padding 先收缩可用约束,内层内容再在剩余空间测量;绘制时外层背景先画,内层前景后画。调换顺序会改变可用尺寸与叠加层级,这是 Compose 布局最常见的顺序坑。
原理流程
链: outer → inner
测量: outer 转换约束 → inner 收到转换后的约束
绘制: outer 背景 → inner 内容 → outer 前景装饰
代码或图示
Modifier.padding(12.dp).background(Color.Blue)
// 背景绘制在 padding 内侧区域;调换顺序背景铺满后再内缩
常见误区
- 认为修饰符可任意调换,视觉结果不变。
- 把链顺序理解成从内到外执行,导致 padding/background 预期错位。
追问
- 哪些阶段顺序敏感?答:测量布局、绘制叠加、手势命中区域都受链顺序影响;图层修饰符还影响离屏渲染边界。
- 如何记住顺序?答:把每个修饰符想象成一层包裹,先写的先包上去。
07.1.1.7.2-003 padding 与 background 的顺序不同,视觉结果有何差异?
一句话结论
padding 在 background 之前:背景只画在内容内缩后的区域;background 在前:背景铺满整个尺寸,padding 只撑开布局间隙,背景不内缩。
概念解释
padding 既是布局约束转换,也影响绘制边界。顺序决定背景色覆盖范围:先 padding 等于在内侧铺底,先 background 等于整体铺底再留边距。边框、背景色的视觉范围必须靠顺序控制。
原理流程
padding → background:背景位于内缩区域
background → padding:背景整体铺满,外侧留透明边距
代码或图示
Modifier.padding(8.dp).background(Color.Red) // 红块内缩
Modifier.background(Color.Red).padding(8.dp) // 红块铺满,外边距透明
常见误区
- 期望背景包含内边距却把 padding 写在 background 前。
- 用 padding 制造视觉边框,实际尺寸与命中区域随之改变。
追问
- 需要背景铺满但内容内缩怎么办?答:背景修饰符在前,内容区用单独的内层 padding 或布局容器处理。
- 边框修饰符顺序如何?答:border 绘制边界,与背景、clip 的顺序同样影响可见范围,需按包裹层次理解。
07.1.1.7.2-004 Modifier.then 如何拼接修饰符,顺序如何保留?
一句话结论
Modifier.then(other) 把 other 追加到链尾,返回保留拼接顺序的新链;空 Modifier 与 then 组合时按实际节点拼接,不丢失已有修饰。
概念解释
then 是链的基础拼接操作,工厂方法内部最终都通过 then 串联。顺序保持调用先后:this 在前、other 在后。拼接结果可继续链式调用,形成不可变的修饰节点序列。
原理流程
Modifier A.then(B) → [A, B]
.then(C) → [A, B, C]
代码或图示
val base = Modifier.padding(4.dp)
val extended = base.then(Modifier.background(Color.White))
常见误区
- 以为 then 会合并同类修饰符去重,重复节点仍按顺序保留。
- 跨组件传递时把链顺序搞反,导致外侧能力被内层覆盖。
追问
- 条件追加修饰符怎么写?答:
if (flag) Modifier.padding(8.dp) else Modifier,再用 then 或链式拼接。 - then 与直接链式调用等价吗?答:链式方法内部仍是 then 拼接,语义一致。
07.1.1.7.2-005 如何编写一个自定义 Modifier?
一句话结论
实现 Modifier 工厂方法:用 Modifier.layout 自定义测量布局,用 Modifier.drawBehind 等扩展绘制,或实现 Modifier.Node 接口挂载阶段回调;通过 then 挂到链上。
概念解释
简单自定义修饰符可组合内置 layout/draw 方法;需要在节点生命周期(进入、离开、绑定)做事时实现 Modifier.Node。layout 块内测量子项并放置,draw 块在 DrawScope 中绘制。
原理流程
自定义工厂 → 内部 layout { measurable, constraints -> ... }
→ 测量子项 → 上报尺寸 → placement 放置
→ 绘制扩展挂到 DrawScope
代码或图示
fun Modifier.firstBaselinePadding() = this.layout { measurable, constraints ->
val placeable = measurable.measure(constraints)
layout(placeable.width, placeable.height) {
placeable.place(0, 0)
}
}
常见误区
- 在 layout 块里直接 new 视图对象,破坏节点体系。
- 测量返回尺寸超过传入约束,违反布局协议。
追问
- 自定义修饰符需要 remember 状态吗?答:需要跨阶段保留对象时用 composed{} 包裹;纯无状态计算不需要。
- Node 接口有哪些生命周期?答:onAttach/onDetach、测量绘制回调等,具体方法签名以目标版本 API 为准(待确认时核对文档)。
07.1.1.7.2-006 composed{} 修饰符与普通工厂方法有何区别?
一句话结论
Modifier.composed { remember { ... }.modifier } 允许修饰符链在组合上下文中持有 remember 状态与 Effect,普通工厂方法只构造无状态修饰节点。
概念解释
普通 Modifier 工厂是纯声明式拼接;composed 进入组合上下文,可以在其中 remember 画笔、监听器等对象,再返回基于这些对象的修饰符。代价是多一层组合节点,状态需要随链生命周期管理。
原理流程
composed {
val brush = remember { ... }
Modifier.drawBehind { ... brush ... }
}
代码或图示
fun Modifier.rememberedRipple() = composed {
val state = remember { RippleState() }
Modifier.clickable { state.activate() }
}
常见误区
- 在普通工厂方法里直接 remember,脱离组合上下文不可用。
- composed 块内注册不释放的资源,节点离开时无人清理。
追问
- composed 有性能代价吗?答:引入额外组合层与状态槽位,简单无状态修饰符不必使用。
- 状态如何释放?答:remember 槽位随节点离开组合回收;外部订阅仍需 Effect 或节点 onDetach 清理。
07.1.1.7.2-007 Modifier 链上的 measure 与 draw 阶段分别按什么顺序执行?
一句话结论
测量布局阶段按链外到内转换约束并放置子项;绘制阶段同样按链顺序叠加,先声明的背景在底层,后声明的前景在上层。
概念解释
同一修饰符可能参与多个阶段:layout 修饰符改测量与放置,draw 修饰符改绘制命令。链顺序在各阶段一致传递,但不是每个节点都参与全部阶段。理解两阶段顺序才能解释尺寸变化与图层叠加。
原理流程
测量: outer 约束转换 → inner 测量 → 自内向上返回尺寸
绘制: outer.drawBehind → 子内容 → inner.drawBehind/前景 → 外层前景
代码或图示
链: padding(测量) → background(绘制底层) → content → 边框(绘制上层)
常见误区
- 用绘制修饰符调整尺寸,实际尺寸只由测量布局阶段决定。
- 以为绘制顺序与链顺序相反,背景被前景盖住。
追问
- 手势命中按什么顺序?答:pointerInput/clickable 命中区域受链上尺寸与 clip 影响,事件分发顺序另见指针输入章节。
- 图层修饰符插在哪?答:graphicsLayer 把节点包成图层,位置决定离屏边界与合成顺序。
07.1.1.7.2-008 Modifier.weight 只能在 Row/Column 中使用吗?
一句话结论
weight 由 Row/Column 的行列作用域提供,普通 Modifier 上不可用;它在测量阶段把父级剩余空间按权重分配给子项。
概念解释
weight 不是通用修饰符,而是 RowScope/ColumnScope 的扩展方法。调用点必须处于对应作用域内,编译期就能发现误用。权重先按固定内容测量,再把剩余空间按 weight 比例分配。
原理流程
RowScope: Modifier.weight(1f)
→ 父级测量:先算固定尺寸子项 → 剩余宽度按权重分配
代码或图示
Row {
Text("A", Modifier.weight(1f))
Text("B", Modifier.weight(2f))
}
常见误区
- 在 Box 或自定义布局上调用 weight,作用域不存在导致编译失败。
- 权重总和为零时行为异常,需保证至少一项有权重且父级可分配剩余空间。
追问
- weight 与 fillMaxSize 区别?答:weight 在父级行列内按比例瓜分剩余空间;fillMaxSize 直接填满传入约束。
- 自定义布局如何实现类似权重?答:在自定义 Layout 的 measure 协议中自行按比例分配约束。
07.1.1.7.2-009 Modifier.padding 与 Modifier.offset 的坐标系有何不同?
一句话结论
padding 改变测量约束与占用尺寸,参与布局;offset 只改变绘制与放置的偏移量,不改变组件自身测量尺寸,占用空间仍按原尺寸计算。
概念解释
padding 是布局修饰符:子项收到收缩后的约束,组件整体尺寸包含内边距。offset(Dp 版本)在放置阶段平移子项,不影响约束与测量;absoluteOffset 用于在布局坐标中直接偏移,不参与 RTL 镜像换算。
原理流程
padding: 约束收缩 → 子项尺寸 + 内边距 = 组件占用尺寸
offset: 原尺寸不变 → placement 坐标平移
代码或图示
Modifier.padding(12.dp) // 参与布局
Modifier.offset(x = 4.dp) // 仅平移绘制与放置
常见误区
- 用 offset 制造间距,导致后续元素仍按原尺寸占位,出现重叠或空隙。
- 忽略 RTL:offset 在水平方向是否镜像取决于修饰符版本,absoluteOffset 不镜像。
追问
- 动画位移用哪个?答:动画连续位移优先 graphicsLayer 偏移避免触发重布局;固定布局位移用 offset。
- padding 负值合法吗?答:padding 传负值在协议上不推荐,可能违反约束;偏移需求用 offset。
07.1.1.7.2-010 Modifier.zIndex 与绘制顺序如何生效?
一句话结论
zIndex 在同一父布局内提升子项绘制层级,值大的后绘制、盖在上方;它不改变测量布局位置,只调整兄弟节点间的合成顺序。
概念解释
普通兄弟节点按链/布局顺序绘制;zIndex 给节点一个层级排序键,同层内再按原顺序。跨父级容器的层级不能靠 zIndex 穿透,图层叠加还受 graphicsLayer 与父级裁剪影响。
原理流程
父级放置子项 → 按 zIndex 排序绘制
→ zIndex 大 → 后绘制 → 视觉在上层
代码或图示
Box {
Card(Modifier.zIndex(1f))
Fab(Modifier.zIndex(2f)) // 盖在 Card 上方
}
常见误区
- 以为 zIndex 可以跨容器提升到其他兄弟组之上。
- 父级 clip 或图层隔离导致 zIndex 提升后仍被裁切。
追问
- zIndex 与 graphicsLayer 关系?答:zIndex 通常作用于节点绘制排序;图层分离后合成顺序还受 layer 位置影响。
- 嵌套 Box 层级如何处理?答:每层 Box 独立排序,需要跨层覆盖时调整容器结构。
07.1.1.7.2-011 修饰符链过长会带来什么性能问题?
一句话结论
链上每个节点参与测量、绘制或状态处理;过长的链增加遍历、约束转换与绘制命令开销,高频重组节点上还会重复构造修饰对象。
概念解释
修饰符链在布局与绘制阶段逐节点执行。冗余背景、重复 padding、多个图层修饰符叠加会放大单帧成本。复杂链应拆成有语义的复用工厂,无状态节点避免每次重组新建对象。
原理流程
每帧遍历链 → 逐节点转换约束 / 追加绘制命令
→ 节点过多 → 测量绘制成本线性上升
代码或图示
// 反例:同一组件堆叠十几个无差别修饰符
Modifier.padding(4.dp).padding(8.dp).background(...).clip(...)
常见误区
- 只关注组件函数体执行,忽略修饰符链本身的布局绘制成本。
- 在高频列表项上挂重绘制修饰符,滚动时逐帧重复。
追问
- 如何精简?答:合并等价 padding、抽离通用容器、去掉无用图层与背景修饰。
- 链长度如何观察?答:Perfetto 布局阶段轨迹与 Studio 布局检查器辅助定位重节点。
07.1.1.7.2-012 Modifier 与 layoutId 在懒列表中的角色是什么?
一句话结论
layoutId 把稳定标识绑定到懒列表项节点,供 item 动画与状态复用识别身份;Modifier 仍负责该项的布局、绘制与行为修饰。
概念解释
懒布局按可见项组合,移动或增删时需要身份对应。Modifier.layoutId 提供布局层标识,配合懒列表的 key 机制用于节点复用与动画定位。普通 Modifier 不承担身份标识职责。
原理流程
items(key = id) {
Row(Modifier.layoutId(id)) { ... }
}
→ 复用 / 动画按 layoutId + key 匹配节点
代码或图示
items(items, key = { it.id }) { item ->
ListRow(Modifier.layoutId(item.id))
}
常见误区
- 用索引当 layoutId,列表增删后身份错位。
- 把 layoutId 当成跨页面导航标识,它只服务当前布局。
追问
- layoutId 与 item key 重复吗?答:key 是组合身份,layoutId 是布局节点标识;二者通常取同一业务 id。
- 自定义布局如何使用 layoutId?答:在 measure 时读取子项 layoutId 做差异化放置。
07.1.1.7.2-013 如何合并两个 Modifier 而不丢失语义?
一句话结论
用 Modifier.then 按顺序拼接:基础链在前、追加链在后;需要条件合并时先判断空链,避免反向拼接导致顺序语义丢失。
概念解释
跨组件传递的基础修饰符与局部追加修饰符合并时,顺序决定谁在外层。通用容器应保留调用方传入的 Modifier 参数,再追加内部默认修饰,保证外部定制不被覆盖。
原理流程
fun Box(modifier: Modifier = Modifier) =
Column(modifier.then(internalPadding)) { ... }
代码或图示
@Composable
fun Avatar(modifier: Modifier = Modifier) {
Image(modifier.then(Modifier.size(48.dp)))
}
常见误区
- 把传入 modifier 放在内部修饰之后,外部背景被内部覆盖。
- 合并时新建空链丢弃已有节点。
追问
- 链式调用与 then 选择?答:固定内部顺序用链式;接收外部 modifier 作为参数时用 then 前置拼接。
- 多个外部修饰符合并顺序约定?答:按调用方声明顺序保留,不要自动重排同类修饰符。
07.1.1.7.2-014 Modifier.size 与 fillMaxSize 的约束语义有何区别?
一句话结论
size(dp) 设置固定期望尺寸并在约束范围内取适配值;fillMaxSize 要求填满父级传入的最大约束;还有 width/height、sizeIn 等按约束协商。
概念解释
测量阶段修饰符把约束转换给子项,再决定自身上报尺寸。固定尺寸受 min/max 约束钳制;fillMax 以父级最大约束为目标;sizeIn 只设置尺寸上下限。约束不满足时以约束边界为准。
原理流程
size(48.dp): 期望 48,被约束钳制
fillMaxSize: 期望 = 父级最大约束
sizeIn(min=.., max=..): 限制尺寸区间
代码或图示
Modifier.size(72.dp)
Modifier.fillMaxWidth()
Modifier.sizeIn(minHeight = 40.dp)
常见误区
- 固定尺寸超出父级约束,组件被压缩而不是溢出。
- 以为 fillMaxSize 一定填满屏幕,它填满的是父级传入约束。
追问
- wrapContent 如何表达?答:子项按内容测量,修饰符不施加强制尺寸;对齐由父级放置决定。
- 尺寸修饰符顺序影响约束吗?答:多个尺寸修饰符按链顺序转换约束,先后可能产生不同钳制结果。
07.1.1.7.2-015 点击修饰符 clickable 的事件分发顺序如何与链顺序配合?
一句话结论
clickable 在链上确定可点击区域(受尺寸、clip 影响),点击命中后触发槽位回调;手势修饰符链顺序决定多个 pointerInput 之间的事件竞争与拦截关系。
概念解释
可点击区域由链上测量尺寸与裁剪修饰符决定。多个指针输入修饰符按链顺序参与手势检测,外层可先拦截消费事件。clickable 自带涟漪与语义状态,直接挂在内容链上。
原理流程
触摸事件 → 按 pointerInput 链顺序检测
→ 命中可点击区域 → clickable 触发 onClick
代码或图示
Modifier
.clip(CircleShape)
.clickable { onAction() }
常见误区
- clip 写在 clickable 之后,点击区域仍为矩形,圆角外仍可命中。
- 嵌套可点击区域时不明确拦截顺序,出现双重触发。
追问
- 涟漪绘制在哪个阶段?答:由 clickable 内部绘制层处理,受链上图层与裁剪影响。
- 自定义手势如何竞争?答:pointerInput 按顺序等待或检测,需要上层拦截时把对应修饰符前置。
07.1.1.7.2-016 Modifier.align 在 Box 与 Column 中分别依赖什么?
一句话结论
Box 内 align(Alignment) 相对父级 Box 对齐子项;Column/Row 作用域提供 align(AlignmentHorizontally/Vertically) 在交叉轴对齐,主轴对齐由父级布局决定。
概念解释
align 是作用域扩展方法,可用对齐方式取决于父级布局作用域。Box 内控制子项在剩余空间的位置;Column 内控制水平交叉轴对齐。脱离对应作用域编译期不可用。
原理流程
BoxScope.align(Alignment.Center)
ColumnScope.align(Alignment.CenterHorizontally)
代码或图示
Box {
Text("居中", Modifier.align(Alignment.TopEnd))
}
常见误区
- 在 Row 上调用 Box 对齐方式,作用域不匹配。
- 把 align 当尺寸修饰符,期望改变占用大小。
追问
- 对齐与 weight 冲突吗?答:weight 分配主轴空间,align 控制交叉轴/剩余空间位置,可配合使用。
- 自定义布局如何实现对齐?答:在 placement 阶段按对齐规则计算子项偏移。
07.1.1.7.2-017 修饰符参数为空时(Modifier)表示什么?
一句话结论
Modifier 单例是空链节点,表示不追加任何布局、绘制或行为能力;它常作为组件参数默认值,让调用方可选传修饰符。
概念解释
空链在 then 拼接时直接被跳过,不产生额外节点。组件签名默认 modifier: Modifier = Modifier,调用方按需叠加。空链不等于默认铺满尺寸,无尺寸修饰时由子项内容与父级约束决定。
原理流程
fun Panel(modifier: Modifier = Modifier)
→ 未传:空链,内部再叠加自身修饰
代码或图示
@Composable
fun Title(text: String, modifier: Modifier = Modifier) {
Text(text, modifier = modifier)
}
常见误区
- 把空 Modifier 理解成 match_parent 或铺满约束。
- 组件内部把传入 modifier 丢弃,无法外部定制尺寸与对齐。
追问
- 空链与 then 空对象优化?答:拼接时识别空节点,避免产生无意义节点对象。
- 参数类型为什么不用可空 Modifier? 答:空链单例替代 null,调用更简洁。
07.1.1.7.2-018 自定义 Modifier 中如何读取布局尺寸?
一句话结论
在 layout 块内拿到子项 placeable 的 width/height,结合传入约束计算自身尺寸;需要尺寸回调给外部时用 onSizeChanged 修饰符。
概念解释
测量阶段可读取子项 placeable 尺寸与 Constraints;绘制阶段 DrawScope 可拿到当前绘制区域大小。需要把最终尺寸发给状态层,用 onSizeChanged 回调,不要在布局测量中直接写状态。
原理流程
layout { measurable, constraints ->
val placeable = measurable.measure(constraints)
// 读取 placeable.width / height
layout(w, h) { placeable.place(0, 0) }
}
代码或图示
Modifier.onSizeChanged { size ->
viewWidth = size.width
}
常见误区
- 在测量阶段直接修改外部状态,破坏布局协议稳定性。
- 把子项未测量的尺寸当已知值使用。
追问
- 尺寸变化回调在什么线程?答:布局阶段在主线程;回调里更新状态应避免触发同步重布局循环。
- 绘制区尺寸从哪取?答:DrawScope.size 提供当前节点绘制边界。
07.1.1.7.2-019 Modifier 链上的 clip 与 graphicsLayer 顺序有何影响?
一句话结论
clip 决定绘制与命中区域的裁剪轮廓;graphicsLayer 把内容合成到独立图层,顺序决定裁剪发生在图层内还是图层外,直接影响离屏渲染与边角效果。
概念解释
先 clip 再建图层:图层内被裁剪;先图层再 clip:图层整体离屏后再裁剪。圆角、阴影、alpha 组合时常需要调整顺序避免锯齿或阴影被裁掉。图层顺序还影响合成成本。
原理流程
clip → graphicsLayer:图层内容已裁轮廓
graphicsLayer → clip:图层先离屏,后裁剪整体矩形/轮廓
代码或图示
Modifier
.graphicsLayer { shadowElevation = 8f }
.clip(RoundedCornerShape(16.dp))
常见误区
- 阴影与圆角顺序颠倒,阴影沿矩形外轮廓被裁。
- 高频节点上叠加多个图层修饰符,造成不必要离屏渲染。
追问
- 如何判断是否产生离屏层?答:Studio 绘制调试与 Perfetto 图层信息;graphicsLayer 改 alpha/阴影/裁剪/变换时通常需要独立图层。
- clip 影响点击区域吗?答:影响,裁剪轮廓外不参与命中。
07.1.1.7.2-020 为什么建议把装饰性修饰符写在内容性修饰符之前?
一句话结论
装饰性背景、边框、图层写在外侧,内容尺寸与对齐写在内侧;先装饰后内容符合包裹层次,避免装饰被内容约束挤压或覆盖。
概念解释
可复用组件约定:接收外部 modifier 后叠加默认装饰(背景、圆角、内边距),内容子项再处理自身对齐。顺序稳定后,外部传入的尺寸/对齐作用于整体,内部装饰作用于整体边界。
原理流程
外部 modifier(尺寸/对齐)
→ 内部装饰(背景/clip/padding)
→ 内容子项
代码或图示
@Composable
fun Card(modifier: Modifier = Modifier) {
Surface(modifier.clip(...).background(...)) {
Content()
}
}
常见误区
- 内部 padding 写在背景前,背景内缩;装饰层包住内容才正确。
- 内容对齐修饰符前置到组件外层,作用对象错误。
追问
- 约定顺序有官方参考吗?答:Material 组件内部普遍按「外部 modifier → 容器装饰 → 内容」组织;具体以组件源码为准。
- 反序能工作吗?答:多数场景能渲染,但尺寸、背景与命中区域会偏离预期。
07.1.1.7.2-021 Modifier.animateContentSize 如何随内容尺寸过渡?
一句话结论
它监听组件尺寸变化,用动画在旧尺寸与新尺寸之间插值过渡,避免内容突变导致布局跳变;动画在布局尺寸阶段生效。
概念解释
内容增删导致节点尺寸改变时,animateContentSize 先记录旧尺寸,目标尺寸更新期间逐步插值。它只动画化自身容器尺寸,不替代子项进入退出动画。可配置动画规格。
原理流程
内容变化 → 目标尺寸改变
→ animateContentSize 从旧值插值到新值
→ 每帧报告中间尺寸,父级按中间尺寸布局
代码或图示
Text(longText, Modifier.animateContentSize())
常见误区
- 用它动画化子项出现消失,实际进入退出应由 AnimatedVisibility 处理。
- 容器约束固定时无尺寸可过渡,动画不显现。
追问
- 与自定义 layout 动画冲突吗?答:尺寸动画改变上报尺寸,自定义布局需按新尺寸放置;注意避免相互触发循环。
- 动画卡顿原因?答:尺寸变化触发重布局,复杂子树每帧重测会掉帧,应配合图层优化。
07.1.1.7.2-022 pointerInput 修饰符中等待多指手势的行为如何与链配合?
一句话结论
pointerInput 在链上按顺序参与指针事件检测,块内挂入手势检测器并等待;外层修饰符可先消费事件,内层检测器收不到对应手势。
概念解释
pointerInput 块是协程式手势等待入口,可检测拖拽、点击、多指缩放等。多个检测器嵌套在同一块内按竞争规则处理;跨修饰符节点按链顺序分发。key 变化时取消旧手势监听重新等待。
原理流程
pointerInput(key) {
detectTransformGestures { ... }
}
→ 链上先后顺序决定事件传递与拦截
代码或图示
Modifier.pointerInput(Unit) {
detectTapGestures(onTap = { /* ... */ })
}
常见误区
- key 传入高频变化对象,手势监听反复取消重建。
- 内外两层都等待同一手势,出现预期外竞争。
追问
- 手势监听何时取消?答:pointerInput 离开组合或 key 变化时协程取消。
- 与 clickable 共存如何排序?答:按需要的拦截层次放置;clickable 处理单点点击语义,复杂自定义手势用 pointerInput。
07.1.1.7.2-023 Modifier 链节点在组合树中如何复用?
一句话结论
修饰链作为节点关联数据随组合保留,重组时复用既有链节点;参数未变的节点不重建,只有结构或参数变化时更新对应修饰。
概念解释
组合树记录节点与其修饰链。重组遍历时按位置与参数比对,稳定修饰链复用;remember 在 composed 节点中缓存状态。节点离开组合时链与状态一并回收。
原理流程
重组 → 定位节点 → 比对修饰参数
→ 未变:复用链节点
→ 变化:更新对应修饰
代码或图示
节点
├─ modifier chain(复用 / 更新)
└─ layout / draw 节点
常见误区
- 每次重组手动新建整条链并担心性能,实际稳定链可复用。
- 在链工厂里持有可变状态却不 remember,节点复用时状态丢失。
追问
- 链对象何时分配?答:首次组合与参数结构变化时;普通链方法调用构造轻量节点对象,高频列表仍应减少冗余修饰。
- 复用判定依据?答:修饰类型与参数值,稳定性规则影响跳过范围。
07.1.1.7.2-024 同一修饰符被重复添加会发生什么?
一句话结论
重复修饰符按链顺序叠加生效,不会自动去重:padding 累加、背景逐层覆盖、图层重复创建;需要合并同类能力时应显式计算或合并节点。
概念解释
Compose 不假设两个同类修饰符可合并。连续 padding 叠加出更大间距;多个背景以后者绘制为准但节点仍在;重复 graphicsLayer 产生多个图层。公共组件应避免内部与外部重复挂同类修饰。
原理流程
padding(8).padding(8) → 总内边距 16
background(A).background(B) → B 覆盖 A,但两个绘制节点都在
代码或图示
Modifier.padding(4.dp).padding(4.dp) // 累加,不是取一次
常见误区
- 以为重复 clickable 只保留一个,实际多层手势修饰并存。
- 复用基础链后又追加同类 padding,间距超出预期。
追问
- 如何避免重复?答:组件只在一处设置尺寸装饰,外部 modifier 负责定制;需要合并时写显式工厂方法。
- 重复图层性能影响?答:额外离屏合成节点,滚动列表中尤其需要排查。
07.1.1.7.2-025 编写可复用修饰符时如何避免在组合中分配对象?
一句话结论
无状态修饰符用纯工厂方法组合内置节点;需要复用画笔/路径等对象时在 composed 中 remember 缓存,避免每次重组 new 重对象。
概念解释
修饰符工厂被调用时会创建链节点,轻量参数对象开销小;画笔、路径、渐变、过滤器等重对象应缓存复用。lambda 与集合参数保持稳定,避免每次组合新建不稳定引用。
原理流程
纯工厂:直接返回 Modifier.xxx
重对象:composed { remember { 重对象 } }.drawBehind { 使用 }
代码或图示
fun Modifier.ring(color: Color) = this.drawBehind {
drawCircle(color = color, radius = size.minDimension / 2)
}
常见误区
- 在 drawBehind 块内每次绘制新建 Path/Brush,滚动时分配抖动。
- 工厂方法返回新建可变列表作为参数,破坏稳定性。
追问
- 缓存对象何时释放?答:remember 槽位随节点离开组合回收;持有系统资源的对象需在 onDispose 释放。
- 如何验证分配?答:Profiler 分配计数与滚动帧分配对比。
07.1.1.7.2-026 Compose 布局三阶段(measure / layout / draw)如何划分?
一句话结论
measure 测量子项得到尺寸,layout 确定子项放置偏移,draw 生成绘制命令;三阶段在帧内依次推进,节点可分别参与其中阶段。
概念解释
Compose 布局协议先约束向下、尺寸向上,再由父级放置子项;绘制阶段按链与层级生成画布命令。组合阶段在三阶段之前完成节点更新,性能问题要区分属于组合、布局还是绘制。
原理流程
组合:更新节点与状态
→ measure:约束测量,上报尺寸
→ layout:placement 放置
→ draw:绘制命令提交
代码或图示
父级 Constraints → 子项 measure → placeable
→ layout { placeable.place(x, y) }
→ drawBehind / drawContent
常见误区
- 把所有界面慢都归为重组,实际可能是测量或绘制阶段瓶颈。
- 在 draw 阶段修改布局状态,造成阶段越界。
追问
- 三阶段能在一帧内多次走吗?答:约束协商与懒布局可能多次测量;放置与绘制按帧提交。
- 工具上如何区分?答:Perfetto 分泳道查看 Measure/Layout/Draw 耗时。
07.1.1.7.2-027 Constraints 约束对象携带哪些信息,子项测量受何限制?
一句话结论
Constraints 包含最小/最大宽度与高度(minWidth、maxWidth、minHeight、maxHeight),子项上报尺寸必须落在约束区间内。
概念解释
约束由父级测量子项时传入,规定可接受尺寸范围。max 为无穷大表示不限制宽度/高度;min 非零时子项不能小于该尺寸。子项违反约束协议会导致布局错误或断言。
原理流程
Constraints(minWidth=0, maxWidth=Inf, minHeight=.., maxHeight=..)
→ measurable.measure(constraints)
→ placeable.width/height 必须满足 min ≤ size ≤ max
代码或图示
val placeable = measurable.measure(
constraints.copy(minWidth = 0, maxWidth = 100)
)
常见误区
- 子项尺寸超出 max 约束,父级布局放置时越界。
- 忽略 min 约束,上报尺寸小于父级要求。
追问
- 约束如何复制修改?答:用 constraints.copy(...) 调整单项,其余保留。
- 无穷大约束下测量注意什么?答:子项内容自定尺寸,不要在无限高约束里强制铺满。
07.1.1.7.2-028 自定义 Layout 的 measure 协议要返回什么?
一句话结论
measure 块先测量子项,再通过 layout(width, height, alignmentLines?) 上报自身尺寸并给出放置 lambda,子项在其中 placeable.place(...)。
概念解释
自定义布局必须为每个子项传入约束测量,拿到 placeable;根据全部子项尺寸计算自身宽高,满足父级约束;放置 lambda 中指定每个子项偏移。可附带对齐线供父级读取。
原理流程
measure { measurables, constraints ->
val placeables = measurables.map { it.measure(childConstraints) }
val layoutWidth = ...
layout(layoutWidth, layoutHeight) {
placeables.forEach { it.place(x, y) }
}
}
代码或图示
Layout(content) { measurables, constraints ->
val placeables = measurables.map { it.measure(constraints) }
val w = placeables.maxOfOrNull { it.width } ?: 0
val h = placeables.maxOfOrNull { it.height } ?: 0
layout(w, h) { placeables.forEach { it.place(0, 0) } }
}
常见误区
- 忘记测量子项就放置,placeable 不存在。
- 上报尺寸超出父级约束或未考虑 min 约束。
追问
- 子项可以测量多次吗?答:协议允许在不同约束下重复测量,但会增加成本,自定义布局应尽量一次测量到位。
- 对齐线怎么返回?答:layout 可选 alignmentLines 参数,map 行名到位置。
07.1.1.7.2-029 Layout 可组合项与 Box/Column 在测量行为上有何差异?
一句话结论
Layout 是通用自定义测量放置入口,约束分配与子项排列完全由代码决定;Box/Row/Column 是内置规则布局,提供权重、对齐、行列排列等固定语义。
概念解释
内置布局封装了成熟测量策略与对齐规则;Layout 不假设排列方向,需要手动遍历 measurables 计算。简单堆叠用内置组件,特殊流式、网格、自定义对齐才用 Layout。
原理流程
Row/Column:按主轴排列 + 权重 + 交叉轴对齐
Layout:自行定义约束、尺寸合成、placement 坐标
代码或图示
Column { /* 内置纵向排列 */ }
Layout(content = { /* 自定义排列 */ }) { ... }
常见误区
- 用 Layout 重写 Row 已有能力,代码复杂且容易遗漏对齐与权重。
- 在 Layout 里硬编码行列规则,没有考虑约束与权重。
追问
- 流式布局用什么?答:自定义 Layout 或现成 FlowRow;网格按行列规则选择对应组件。
- 内置布局能否扩展?答:通过自定义修饰符与子组件组合,测量规则仍由内置容器提供。
07.1.1.7.2-030 为什么布局测量通常要遵循"约束向下传递、尺寸向上返回"?
一句话结论
父级先把可用约束传给子项测量,子项上报实际尺寸,父级再综合所有子项尺寸决定自身大小并放置;这是 Compose 与 View 布局共同的两阶段协议。
概念解释
约束向下保证子项不超出父级可用空间;尺寸向上让父级知道子项占多大。先测量后放置,父级不能在未测量子项前确定自身尺寸。协议统一后嵌套容器才能正确协商大小。
原理流程
父级 constraints → 子项 measure → placeable 尺寸
→ 父级合成自身尺寸 → 放置子项
代码或图示
Constraints ↓
placeable.size ↑
常见误区
- 先放置后测量,偏移计算拿到错误尺寸。
- 子项无视约束自报任意尺寸,造成溢出。
追问
- Compose 与 View 测量协议差异?答:思想一致(measureSpec 对应 Constraints),Compose 约束对象化、子项可多次测量;细节以框架实现为准。
- 自身尺寸依赖子项对齐线怎么办?答:测量阶段读取子项 alignmentLines 后再合成。
07.1.1.7.2-031 SubcomposeLayout 解决什么问题,工作流程是什么?
一句话结论
它允许先子组合部分内容、测量结果回来后再决定剩余内容的组合与布局,解决"子项尺寸决定父级结构"的场景(如动态标签、按需分组)。
概念解释
普通布局先组合全部内容再测量;SubcomposeLayout 提供 subcompose(slotId, content) 入口:先组合指定槽位内容并测量,拿到尺寸后再组合其他槽位。代价是分阶段组合,复杂度高于普通 Layout。
原理流程
SubcomposeLayout 作用域
→ subcompose(slotA, contentA) → 测量得到 placeableA
→ 根据 A 尺寸决定 slotB 结构 → subcompose(slotB)
→ 统一放置
代码或图示
SubcomposeLayout { constraints ->
val main = subcompose(MainSlot) { MainContent() }
val mainPlaceable = main.map { it.measure(constraints) }
// 依据 mainPlaceable 再组合剩余槽位
layout(width, height) { /* place */ }
}
常见误区
- 能用普通 Layout 解决却用 SubcomposeLayout,引入分阶段组合成本。
- 槽位内容在错误阶段组合,节点生命周期与状态保留异常。
追问
- 哪些内置组件基于它?答:部分自适应布局与折叠容器内部使用;具体组件清单以官方源码为准。
- 性能注意点?答:分阶段组合增加首帧成本,避免在高频滚动节点中滥用。
07.1.1.7.2-032 Intrinsic 测量(minIntrinsic / maxIntrinsic)用于什么场景?
一句话结论
固有尺寸测量在不考虑传入约束时计算子项最小/最大内容尺寸,用于父级需要先知道内容自然大小再安排约束的场景,如等高子项、文本换行参考。
概念解释
普通 measure 依赖约束;intrinsic 测量回答"内容最少占多大、最多能占多大"。Row 需要让所有子项高度对齐到最高内容时,通过 maxIntrinsicHeight 获取自然高度。自定义布局可读取子项固有尺寸。
原理流程
measurable.minIntrinsicWidth(height)
measurable.maxIntrinsicHeight(width)
→ 父级依据固有尺寸调整约束再正式测量
代码或图示
val intrinsicH = measurable.maxIntrinsicHeight(constraints.maxWidth)
常见误区
- 把 intrinsic 结果当成最终 placeable 尺寸,它只是自然大小参考。
- 复杂自定义内容不实现固有尺寸计算,返回值为默认估计。
追问
- 哪些组件支持固有尺寸?答:文本、行列等内置组件实现;自定义 Layout 按需提供实现。
- 固有测量有性能成本吗?答:额外一轮内容测量,避免在每帧高频路径滥用。
07.1.1.7.2-033 Row/Column 权重如何在剩余空间中分配?
一句话结论
先测量无权重子项的固定内容,父级可用主轴空间减去固定占用后,按 weight 比例分配给有权重子项;权重子项在分配约束内测量。
概念解释
weight 分配的是剩余空间,不是固定等分总宽。fill 参数控制权重子项是否在超出剩余空间时占满;多行/多列场景下交叉轴按对齐规则放置。分配结果仍受子项内容约束钳制。
原理流程
主轴可用空间 W
→ 无权重子项固定占用 S
→ 剩余 W-S 按权重比例分给权重子项
代码或图示
Row {
Box(Modifier.weight(1f))
Box(Modifier.weight(1f))
Box(Modifier.width(80.dp))
}
常见误区
- 权重子项内容超过分配空间时不换行/裁剪,导致溢出。
- 父级主轴约束为无穷大时权重无剩余空间可分。
追问
- weight=0 与无权重区别?答:权重为 0 不参与瓜分剩余空间,行为接近固定尺寸。
- 权重分配后子项高度如何定?答:交叉轴由父级对齐与子项内容决定,行高取规则结果。
07.1.1.7.2-034 自定义布局中子项 placement 坐标系如何确定?
一句话结论
放置坐标以父级布局区域左上角为原点,placeable.place(x, y) 指定子项相对原点的偏移;坐标单位是像素,受密度与布局尺寸换算影响。
概念解释
layout 上报自身宽高后,放置 lambda 在该区域内计算每个子项偏移。RTL 场景水平偏移需按方向换算;对齐线、基线参与定位。子项不能被放置到父级尺寸区域之外作为视觉溢出(允许绘制溢出但布局占位不变)。
原理流程
layout(width, height) {
placeable.place(offsetX, offsetY) // 父级左上原点
}
代码或图示
layout(w, h) {
placeable.place(16, (h - placeable.height) / 2)
}
常见误区
- 用 Dp 值直接当像素坐标,忘记 density 换算。
- RTL 下水平偏移未镜像,标签位置反向错误。
追问
- 基线放置用什么?答:placeable placeWithBaseline 或基线对齐 API,具体方法名以目标版本为准。
- 绘制溢出与布局占位区别?答:放置决定占用区域;绘制可超出边界,但命中与后续布局仍按占位计算。
07.1.1.7.2-035 对齐线(alignment line)如何在父子布局间传递?
一句话结论
子项在测量阶段通过 alignmentLines 暴露命名基准线(如文本基线),父级读取后据此对齐多个子项;父级可再把自身对齐线向上传递。
概念解释
对齐线是布局层的命名坐标映射,解决基线对齐等需求。父级在测量子项后查询对应行位置,放置时统一偏移。自定义布局可在 layout() 参数中返回自己的对齐线集合。
原理流程
子项暴露 alignmentLines[FirstBaseline] = y
→ 父级读取行位置 → 按基线对齐放置
→ 父级 layout(..., alignmentLines = mapOf(...))
代码或图示
layout(w, h, alignmentLines = mapOf(FirstBaseline to baselineY)) {
placeable.place(0, baselineY - placeable[FirstBaseline])
}
常见误区
- 在放置阶段才查询对齐线,测量阶段未读取导致父级尺寸计算错误。
- 自定义子项不暴露基线,父级回退到默认估计值。
追问
- 内置文本组件暴露哪些线?答:首/末基线等,具体行名以 Compose 布局 API 为准。
- 对齐线与 zIndex 有关吗?答:无关,对齐线只参与布局定位。
07.1.1.7.2-036 ConstraintLayout 在 Compose 中的定位与 DSL 约束方式是什么?
一句话结论
Compose 版 ConstraintLayout 通过约束锚点(linkTo、createRefs)描述子项相对兄弟与父级的位置关系,适合复杂相对定位,替代深层嵌套嵌套容器。
概念解释
View 体系 ConstraintLayout 在 Compose 中有对应可组合实现。子项引用通过 createRefs() 创建,约束绑定到父级边界或兄弟锚点,可设置 bias、margin、约束尺寸。简单行列仍优先 Row/Column/Box。
原理流程
createRefs() 得到子项引用
→ linkTo(parent/兄弟, start=..., end=..., bias=...)
→ 测量阶段按约束解析位置与尺寸
代码或图示
ConstraintLayout {
val (title, button) = createRefs()
Text("标题", Modifier.constrainAs(title) { top.linkTo(parent.top) })
Button(onClick = {}, Modifier.constrainAs(button) {
top.linkTo(title.bottom)
end.linkTo(parent.end)
})
}
常见误区
- 能用 Row/Column 解决却引入 ConstraintLayout,增加约束解析成本。
- 约束形成环,子项尺寸与位置无法解析。
追问
- Compose ConstraintLayout 依赖坐标是什么?答:androidx.constraintlayout compose 工件;具体版本随 BOM/库声明,以官方文档为准。
- 约束尺寸有哪几种?答:固定尺寸、wrapContent、matchConstraints(填满约束区间),与 View 体系概念对应。
07.1.1.7.2-037 测量阶段为什么不能随意修改子项返回的尺寸?
一句话结论
placeable 尺寸是子项在给定约束下的测量结果,父级只能在放置时选择偏移与裁剪;篡改尺寸会破坏布局协议,导致重叠、溢出与不一致。
概念解释
测量协议要求父级尊重子项 placeable 的宽高,自身尺寸综合子项结果计算。父级可以在约束层影响子项(传入不同约束),但不能把 placeable 拉伸到未测量的尺寸。需要不同尺寸应重新测量。
原理流程
子项 measure(constraints) → placeable 尺寸确定
→ 父级读取尺寸合成布局 → placement 只选位置
代码或图示
val p = measurable.measure(constraints)
// 使用 p.width / p.height,不要强行改写成其他值
常见误区
- 放置时把子项按父级宽度拉伸,视觉变形或命中区域错误。
- 未重新测量就假设子项能适应新约束。
追问
- 需要子项适应新约束怎么办?答:用新 Constraints 再次 measure 得到新 placeable。
- 尺寸不一致如何排查?答:检查父级约束转换与 placeable 读取点。
07.1.1.7.2-038 一个子项被测量多次的原因有哪些?
一句话结论
父级在不同约束下反复测量子项(权重分配、固有尺寸计算、自适应布局)、布局重试或 Subcompose 分阶段组合,都可能导致子项多次 measure。
概念解释
单次测量不足以确定父级尺寸时,父级会先取固有尺寸、再按不同约束复测。复杂自定义布局、权重与对齐线协商也会产生复测。多次测量增加布局阶段耗时,列表滚动时尤其明显。
原理流程
首次约束测量 → 固有尺寸查询 → 调整约束复测
→ 子项 measure 被调用多次
代码或图示
maxIntrinsicHeight 查询 → 正式 measure
权重两轮分配 → 子项复测
常见误区
- 子项内部在 measure 中分配重对象,多次测量放大分配抖动。
- 自定义布局对每个子项重复多轮无必要测量。
追问
- 如何观察测量次数?答:Perfetto 布局阶段轨迹、Studio 布局检查器;自定义子项可在 measure 块打计数日志调试。
- 多次测量一定是问题吗?答:协议允许,关键看是否超出必要轮次与单帧成本。
07.1.1.7.2-039 自定义 Layout 的性能关注点在哪里?
一句话结论
关注测量轮次、子项遍历复杂度、尺寸计算中的对象分配,以及放置阶段的对齐线/基线计算;避免在测量块内做重计算和新建集合。
概念解释
自定义布局每帧对可见子项执行测量与放置。O(n²) 排列、每次遍历新建列表/数组、测量块内排序过滤都会放大成本。可缓存排序与派生值,约束计算保持纯轻量。
原理流程
每帧:遍历 measurables → 测量 → 计算尺寸 → 放置
→ 优化:减少测量轮次、复用缓存、避免块内分配
代码或图示
Layout({ items.forEach { Item(it) } }) { measurables, constraints ->
// 轻量计算;重排序在数据层提前完成
}
常见误区
- 在 measure 块里排序、过滤、查数据库,每帧重复执行。
- 为每个子项新建数据对象参与计算。
追问
- 列表类自定义布局注意什么?答:只处理可见项,离屏回收;全量遍历会失去懒布局收益。
- 如何验证布局成本?答:Perfetto 测量阶段耗时与分配计数对比基线。
07.1.1.7.2-040 布局阶段读取状态为什么可能触发额外布局?
一句话结论
在测量/放置回调中读取 State 并订阅,状态变化会标记节点需要重新布局;若回调内写入状态还可能造成布局循环。
概念解释
布局回调属于组合执行路径之外的阶段。在其中读取 State 可以建立订阅,但更常见的问题是:布局阶段依据状态算位置,状态一变就触发重布局。布局回调内写入状态属于阶段越界,应在组合主体或事件中更新。
原理流程
layout 块读取 state.value → 订阅该节点布局
→ state 变化 → 标记重新布局
布局回调内写 state → 可能循环触发布局
代码或图示
// 反例:布局回调里改状态
layout(w, h) { offset = state.value }
常见误区
- 在 measure/placement 中改外部状态,造成一帧内反复重布局。
- 把布局计算依赖放在未稳定的状态上,节点无法跳过。
追问
- 动画驱动布局偏移怎么做?答:动画值在组合层读取并通过修饰符传递,布局阶段只消费当前值。
- 如何定位布局循环?答:Studio 抛出的布局循环警告与 Perfetto 重复布局轨迹。
07.1.1.7.2-041 如何在布局回调中拿到父级可用宽度?
一句话结论
测量回调通过 Constraints 的 maxWidth 得到父级可用最大宽度,minWidth 得到最小要求;自定义布局据此决定子项约束与自身上报宽度。
概念解释
constraints 参数携带父级允许的尺寸区间。可用宽度受 padding、修饰符链转换后收缩;maxWidth 为 Infinity 表示主轴方向不受限。子项约束由父级按区间派生。
原理流程
measure { measurables, constraints ->
val available = constraints.maxWidth
// 用 available 切分子项约束
}
代码或图示
val childConstraints = constraints.copy(
minWidth = 0,
maxWidth = constraints.maxWidth / 2
)
常见误区
- 把 maxWidth 当成屏幕宽度,它是当前父级可用约束。
- 忽略 Infinity 情况,用无穷值做除法或固定像素换算。
追问
- 可用宽度在绘制阶段还能拿到吗?答:DrawScope.size 给当前节点绘制尺寸,语义与测量约束不同。
- 修饰符链如何改变约束?答:外层 padding/size 修饰符先转换约束再传入内层。
07.1.1.7.2-042 子组合(subcomposition)与普通组合在状态保留上有何区别?
一句话结论
子组合由父级在布局阶段按需创建,其 remember 状态归属子组合 group;子组合被移除后状态回收,保留规则同样遵循组合树生命周期。
概念解释
普通组合在初始组合阶段一次性建立;子组合(SubcomposeLayout、懒列表槽位)在运行时按布局需要创建或回收。状态能否保留取决于 group 是否仍在组合树中,懒布局离屏回收可能释放子组合状态。
原理流程
父级布局阶段 → subcompose 创建子 group
→ 子组合移除 → group 离开 → remember 回收
代码或图示
SubcomposeLayout {
val slot = subcompose(SlotId) { Content() }
}
常见误区
- 以为懒列表离屏项的内部 remember 一定保留,实际回收策略可能清除。
- 在子组合里保存跨滚动需要的状态,应提升到父级或 ViewModel。
追问
- 子组合状态与主组合订阅共享吗?答:快照订阅按各自 group 登记,状态对象可共享,订阅归属执行 group。
- 懒列表状态保留机制?答:key 与回收策略相关,复杂状态提升到列表外持有更稳妥。
07.1.1.7.2-043 自定义布局如何处理子项的对齐与间距?
一句话结论
测量后根据对齐规则计算每个子项的放置偏移,间距通过约束或 placement 偏移实现;多子项对齐参考基线、对齐线或统一尺寸基准。
概念解释
父级在放置阶段遍历 placeables,按主轴/交叉轴规则算 x、y。间距可在测量时预留,或在 placement 累加偏移;对齐需求读取子项基线与对齐线。规则应写成可复用的布局算法。
原理流程
测量全部子项 → 确定父级尺寸
→ 按对齐 + 间距计算每个 placeable 偏移
→ place(...)
代码或图示
var x = 0
placeables.forEach { p ->
p.place(x, 0)
x += p.width + gap
}
常见误区
- 间距只加在 placement 偏移上,父级上报尺寸未包含最后一段间距。
- 交叉轴对齐未考虑基线,文本与图标底部参差。
追问
- 对齐方式参数化怎么做?答:布局工厂接收 Alignment/Arrangement 参数,测量放置时查表计算。
- RTL 间距方向?答:水平排列需按布局方向翻转累加起点。
07.1.1.7.2-044 Constraints 传播到自定义子组件时要注意什么?
一句话结论
父级派生子项约束时不能超出自身约束区间,子项上报尺寸必须满足约束;宽高独立约束时注意无穷大约束下子项内容尺寸的处理。
概念解释
Constraints 复制修改后传给子项,min/max 不能突破父级边界。垂直方向 Infinite 时子项按内容高度测量;固定高度容器要给有限高度约束。错误约束会导致子项铺满或内容溢出。
原理流程
父级 constraints
→ copy 派生子项约束(仍在区间内)
→ 子项 measure → 尺寸合法
代码或图示
val childC = constraints.copy(
maxWidth = constraints.maxWidth.coerceAtMost(childMax)
)
常见误区
- 给子项传入比父级更大的 maxWidth,布局协议越界。
- 无限高约束里要求子项填满父级高度,约束不支持。
追问
- 约束全等复制何时使用?答:子项应占满父级可用空间时直接透传。
- 约束异常如何调试?答:在 measure 块打印 constraints 与 placeable 尺寸对照。
07.1.1.7.2-045 懒布局(Lazy)与普通 Layout 在测量策略上的差异是什么?
一句话结论
普通 Layout 一次性组合并测量全部子项;懒布局只组合、测量可见窗口内的项,离屏项不参与当前帧测量,滚动时按需复用与回收。
概念解释
懒列表/网格通过滚动偏移计算可见区间,只准备可见 item 的子组合与 placeable。普通 Column 全量组合,项多时首帧成本高。懒布局的 item 状态复用、key 与回收机制围绕可见窗口工作。
原理流程
普通:全量子项 measure → 全部放置
懒布局:计算可见区间 → 仅可见项组合测量 → 离屏回收
代码或图示
LazyColumn {
items(items, key = { it.id }) { RowItem(it) }
}
常见误区
- 在懒列表里用普通 Column 包全部数据,失去懒加载收益。
- 离屏项内部保留关键状态,回收后丢失。
追问
- 懒布局能算全量固有高度吗?答:可见测量为主,固有尺寸能力有限;固定行高可辅助估算。
- 性能优化方向?答:稳定 key、稳定类型、减少项内重修饰与分配,详见性能篇。
07.1.1.7.2-046 Compose 绘制阶段的顺序与层级如何确定?
一句话结论
绘制按节点树深度与链顺序进行:先画底层背景与祖先内容,再画当前节点子内容,最后画前景装饰;zIndex 与图层改变兄弟排序与合成层级。
概念解释
每个节点的绘制命令由链上 drawBehind、子内容、drawBefore/After 等组成。祖先先于后代绘制,兄弟按布局顺序或 zIndex 排序。独立图层在合成阶段按层级合并。
原理流程
祖先 drawBehind → 子树内容 → 当前节点前景
→ 兄弟节点按 zIndex/顺序 → 图层合成
代码或图示
drawBehind (底层)
→ content
→ drawAfter (上层)
常见误区
- 前景装饰写在 drawBehind,被内容盖住。
- 依赖绘制顺序叠加半透明效果,却错误使用独立图层打乱合成。
追问
- 绘制顺序在哪查看?答:Studio 布局/绘制调试与节点树层级;Perfetto 绘制轨迹。
- 跨容器层级如何提升?答:调整节点树结构或图层排序,zIndex 不跨父级穿透。
07.1.1.7.2-047 Canvas 可组合项与 drawBehind 修饰符有何分工?
一句话结论
Canvas 是独立的可组合绘制节点,给定内容 lambda 直接在其边界内绘制;drawBehind 挂在现有节点链上,在内容底层追加绘制。
概念解释
需要一块独立绘制区域、自带尺寸约束时用 Canvas;在已有组件背景下画自定义图形用 drawBehind。两者都提供 DrawScope,绘制坐标以各自节点边界为基准。Canvas 可通过 modifier 指定尺寸。
原理流程
Canvas(modifier) { DrawScope 绘制 }
Modifier.drawBehind { DrawScope 绘制在内容底层 }
代码或图示
Canvas(Modifier.size(100.dp)) {
drawCircle(Color.Blue, radius = size.minDimension / 2)
}
常见误区
- 在普通组件上需要独立画布却用 drawBehind,绘制受节点裁剪与尺寸约束影响。
- Canvas 未给尺寸约束,默认填满父级最大约束。
追问
- 绘制在前景用什么?答:drawWithCache/drawAfter 等修饰符;Canvas 本身是背景式独立节点。
- 两者坐标系一致吗?答:都以自身绘制区域左上为原点,size 对应边界尺寸。
07.1.1.7.2-048 DrawScope 提供哪些坐标变换与绘制原语?
一句话结论
DrawScope 提供 size、布局方向、绘制原语(圆、矩形、路径、线、图片)与变换(平移、旋转、缩放、剪切),以及画笔/刷子参数。
概念解释
绘制原语接收坐标、尺寸、颜色/Brush、alpha 等参数;变换通过 translate、rotate、scale 包裹绘制块,作用域内坐标被变换。变换不改变布局,只影响绘制命令。
原理流程
DrawScope.size → 原语坐标基准
→ transform { translate/rotate/scale } → 内部绘制按变换后坐标
代码或图示
drawBehind {
rotate(degrees = 45f) {
drawRect(Color.Red, topLeft = center)
}
}
常见误区
- 变换坐标与布局坐标混用,定位偏移。
- 每次绘制新建 Brush/Path,造成分配抖动。
追问
- 变换状态会泄漏到后续绘制吗?答:变换块作用域结束恢复;栈式变换需正确包裹。
- 高密度下坐标如何换算?答:DrawScope 内单位为像素;Dp 转 px 通过 density 扩展完成。
07.1.1.7.2-049 drawWithCache 相比 drawBehind 有什么缓存收益?
一句话结论
drawWithCache 在绘制缓存对象(Brush、Path、过滤器),只在尺寸/输入变化时重建,绘制帧内直接复用;drawBehind 每次绘制都执行 lambda。
概念解释
drawWithCache 分两层:onDrawWithCache 中 remember 派生绘制对象,绘制回调使用缓存值。当尺寸、状态输入变化时缓存失效重建。适合依赖尺寸构造渐变、路径的场景,避免每帧 new 对象。
原理流程
drawWithCache {
val brush = Brush.linearGradient(...) // 缓存
onDrawBehind { drawRect(brush) }
}
代码或图示
Modifier.drawWithCache {
val path = Path().apply { addRect(size.toRect()) }
onDrawBehind { drawPath(path, Color.Gray) }
}
常见误区
- 在 drawBehind 里构造复杂渐变/路径,每帧分配。
- 缓存对象引用未依赖尺寸变化,尺寸改变后路径过期。
追问
- 缓存何时重建?答:DrawScope 尺寸等依赖变化时;具体缓存键规则以实现为准。
- 与 remember 区别?答:drawWithCache 绑定绘制阶段生命周期,remember 绑定组合槽位。
07.1.1.7.2-050 graphicsLayer 创建的硬件层在什么条件下被离屏渲染?
一句话结论
当节点需要独立 alpha、缩放/旋转、阴影、裁剪或滤镜等合成效果时,Compose 可能把内容渲染到独立图层(离屏缓冲)再参与合成。
概念解释
graphicsLayer 配置层参数:scaleX/Y、rotation、alpha、shadowElevation、shape/clip、变换。这些效果要求内容先在层缓冲绘制,再与其他层合成。简单位置偏移尽量用图层属性而非重布局,降低成本。
原理流程
节点设置 layer 参数
→ 内容离屏渲染到 layer 缓冲
→ 按变换/透明度/阴影合成到屏幕
代码或图示
Modifier.graphicsLayer {
alpha = 0.8f
scaleX = 1.05f
shadowElevation = 8f
}
常见误区
- 大量列表项各自开图层,离屏缓冲内存与合成成本上升。
- 误以为 graphicsLayer 一定提升性能,不当使用反而增加离屏开销。
追问
- 如何确认产生离屏层?答:Studio 渲染调试的图层高亮、Perfetto 合成阶段信息。
- 动画首选什么层属性?答:偏移/缩放/透明度等 layer 属性可由合成器处理,避免每帧重布局。
07.1.1.7.2-051 layer 上的 clip、alpha、shadow 分别作用于哪个阶段?
一句话结论
clip 决定图层内容裁剪轮廓,alpha 在合成阶段控制整体透明度,shadowElevation 依据图层形状在合成时投射阴影;三者都作用于图层内容整体。
概念解释
layer.clip 配合 shape 裁剪层缓冲;alpha 是图层合成透明度,不同于逐个绘制命令的 alpha;阴影基于 layer 形状与抬升高度在层外绘制。顺序上裁剪影响阴影边界与内容可见范围。
原理流程
离屏绘制 → clip 裁剪层内容
→ 合成:alpha 混合 → shadow 按 shape 投射
代码或图示
Modifier.graphicsLayer {
shape = RoundedCornerShape(12.dp)
clip = true
shadowElevation = 4f
}
常见误区
- 用 alpha 逐个 draw 命令调透明,与图层 alpha 叠加导致双重透明。
- 阴影需要圆角轮廓时未设置 shape,阴影按矩形计算。
追问
- clip 与 Modifier.clip 关系?答:layer clip 是图层级裁剪,普通 clip 也可修饰绘制;位置顺序影响边界。
- 阴影颜色可否自定义?答:受主题与平台阴影能力约束,具体参数以目标版本 API 为准。
07.1.1.7.2-052 绘制缓存失效由哪些因素触发?
一句话结论
节点尺寸、输入状态、画笔参数或图层属性变化使绘制命令失效,触发重绘;布局尺寸变化、状态读取更新、主题切换都会标记对应绘制节点脏。
概念解释
Compose 按节点层级失效:内容变化标记绘制重跑,尺寸变化触发重布局与重绘。缓存的 Brush/Path 依赖尺寸,尺寸变化需重建。主题颜色变化通过状态订阅触发相关节点重绘。
原理流程
状态 / 尺寸 / 主题变化
→ 标记节点绘制脏
→ 下一帧重跑绘制命令 → 复用有效缓存
代码或图示
colorScheme 变化 → 读取主题色的节点重绘
size 变化 → drawWithCache 缓存重建
常见误区
- 以为背景颜色会自动跟随主题,节点未读取主题状态则不订阅。
- 缓存路径写死旧尺寸,缩放后图形错位。
追问
- 如何定位重复重绘?答:Studio 绘制高亮与 Perfetto Draw 泳道,观察哪些节点每帧重跑。
- 静态内容如何减少重绘?答:稳定参数、缓存画笔、避免高频状态读取到绘制节点。
07.1.1.7.2-053 drawIntoCanvas 可以调用哪些底层画布能力?
一句话结论
它让绘制块拿到平台 Canvas 对象,可调用底层绘制、PictureLayer、保存图层、滤镜等较低级能力,通常用于桥接既有自定义绘制代码。
概念解释
普通 DrawScope 原语覆盖常用图形;drawIntoCanvas 暴露 canvas 实例,可直接调用平台画布方法、保存/恢复图层、应用原生效果。能力更接近 View 体系 onDraw,但仍运行在 Compose 绘制节点上下文中。
原理流程
drawIntoCanvas { canvas ->
// 调用底层 Canvas API
}
代码或图示
Modifier.drawBehind {
drawIntoCanvas { canvas ->
canvas.saveLayer(bounds, paint)
// ...
canvas.restore()
}
}
常见误区
- 直接持有底层 canvas 引用跨帧使用,下一帧画布可能已变。
- 忘记 saveLayer 配对 restore,状态污染后续绘制。
追问
- 何时需要底层 API?答:复用成熟自定义 View 绘制逻辑、特殊滤镜或原生效果;能用 DrawScope 原语就不用底层桥接。
- 平台差异怎么处理?答:底层 Canvas 行为依赖渲染平台,版本兼容需在目标机型实测。
07.1.1.7.2-054 自定义绘制中 Path 与 Brush 的常见性能陷阱是什么?
一句话结论
每帧新建 Path/Brush/filter、路径反复重构、复杂布尔运算与大半径模糊会增加分配与栅格化成本;应缓存可复用对象并在尺寸变化时重建。
概念解释
路径与渐变对象构造不便宜,滚动动画中每帧 new 会造成 GC 抖动。路径轮廓复杂、抗锯齿区域大时栅格化耗时高。缓存配合 drawWithCache,按尺寸/输入失效;避免在绘制块里做大路径运算。
原理流程
绘制帧
→ 复用缓存 Path/Brush(无变化)
→ 变化时重建一次 → 后续帧复用
代码或图示
val brush = remember(themeColor) {
Brush.linearGradient(listOf(colorA, colorB))
}
常见误区
- drawBehind 内
Path().apply { ... }每帧执行。 - 列表项内画复杂路径却无缓存,滚动时掉帧。
追问
- 路径数据结构如何复用?答:缓存 Path 对象,尺寸变化时 rewind 后重设轮廓。
- 大模糊效果成本?答:离屏缓冲与模糊半径成正比,低端机需降级。
07.1.1.7.2-055 透明度合成(alpha)为什么可能触发离屏层?
一句话结论
整体半透明内容需要先在独立缓冲绘制,再按 alpha 与背景混合;直接在屏幕上逐个命令绘制无法正确控制整体混合,因此形成离屏渲染。
概念解释
图层 alpha 作用于整组内容:子元素互相叠加后再统一透明。若只靠每个画笔带 alpha,元素间先按不透明叠加,视觉结果不同。离屏层增加缓冲内存与合成成本,大量半透明列表项需谨慎。
原理流程
设置图层 alpha < 1
→ 内容离屏绘制到层缓冲
→ 整体按 alpha 混合到背景
代码或图示
Modifier.graphicsLayer { alpha = 0.5f }
常见误区
- 对整页大容器设半透明,造成大面积离屏缓冲。
- 用图层 alpha 叠加多层,合成成本翻倍。
追问
- 不透明时还需要图层吗?答:仅变换/裁剪时按需;alpha 为 1 可减少不必要层。
- 半透明性能怎么优化?答:降低离屏面积、减少嵌套半透明层、静态半透明可预合成。
07.1.1.7.2-056 阴影在 Compose 中如何通过 elevation 与 shape 产生?
一句话结论
阴影由图层抬升高度(shadowElevation)配合图层形状产生,平台按轮廓在层外绘制阴影;圆角/自定义形状需要 layer shape 才能投射对应轮廓阴影。
概念解释
elevation 决定阴影扩散与偏移,shape 决定阴影轮廓。普通背景矩形与圆角 Shape 阴影不同;未设置 shape 时阴影按默认轮廓。阴影绘制依赖图层离屏与平台渲染能力。
原理流程
graphicsLayer { shadowElevation = 8f; shape = RoundedCornerShape(12.dp) }
→ 平台按 shape 轮廓绘制阴影
代码或图示
Surface(
shadowElevation = 4.dp,
shape = RoundedCornerShape(16.dp)
) { /* ... */ }
常见误区
- 圆角内容只 clip 不设 layer shape,阴影仍是矩形。
- 阴影修饰符顺序在裁剪之后,阴影被裁掉。
追问
- 阴影颜色与主题有关吗?答:平台默认阴影颜色可受主题/暗色模式影响,具体可调参数以版本 API 为准。
- 自定义路径阴影支持吗?答:受图层 shape 能力约束,复杂轮廓阴影可能需绘制层自行实现。
07.1.1.7.2-057 绘制阶段读取状态与重组阶段读取状态有何区别?
一句话结论
组合主体读取 State 订阅组合节点并可触发重组;绘制回调中读取主要用于本帧绘制取值,订阅与失效规则按节点绘制订阅处理,二者不要混用。
概念解释
界面结构变化(文本、显隐)在组合层读取;颜色、角度等绘制输入在绘制回调中读取。绘制阶段读取的值驱动重绘,不重建组合节点。把布局状态放在绘制回调读取会跳过结构更新。
原理流程
组合读取 → 订阅组合 group → 状态变化触发重组
绘制读取 → 提供绘制输入 → 节点标记重绘
代码或图示
Text(state.title) // 组合层读取
Modifier.drawBehind {
drawCircle(state.color) // 绘制输入读取
}
常见误区
- 在 drawBehind 里改状态,阶段越界。
- 结构显隐依赖绘制读取,节点不重建导致旧内容残留。
追问
- 绘制读取如何订阅失效?答:框架对绘制阶段读取做追踪;复杂组合状态应回到组合主体读取。
- 动画值属于哪类?答:动画 State 在组合层读取驱动修饰符/图层,绘制回调消费当前值。
07.1.1.7.2-058 如何避免每一帧重建画笔与路径对象?
一句话结论
把 Brush、Path、Paint 等对象在 remember 或 drawWithCache 中缓存,只在颜色、尺寸等依赖变化时重建;绘制帧内只引用复用对象。
概念解释
动画与滚动每帧执行绘制 lambda,局部新建对象直接进入分配统计。缓存键跟随输入主题色、尺寸;路径复用同一对象 rewind 重设。列表项内对象应在项级别缓存而非每帧构造。
原理流程
remember(deps) { 构造重对象 }
→ 绘制帧内复用
→ deps 变化才重建
代码或图示
val dashPath = remember(size) {
Path().apply { addRoundRect(...) }
}
常见误区
- 在 drawBehind lambda 内构造,缓存不生效。
- 缓存对象被外部原地修改,多帧共享状态错乱。
追问
- 缓存对象跨组合安全吗?答:只读复用安全;可变路径在重建时整体替换或在同步阶段重置。
- 分配如何验证?答:Profiler 查看每帧分配计数,对比优化前后。
07.1.1.7.2-059 绘制顺序与 Modifier 链顺序、zIndex 的关系是什么?
一句话结论
链顺序决定单节点内背景/前景叠加与兄弟修饰先后;zIndex 只在同一父级兄弟间调整排序;图层建立后合成顺序再受 layer 排列影响。
概念解释
修饰符链从外到内参与绘制:drawBehind 在前、内容居中、drawAfter 在后。zIndex 重排兄弟节点绘制先后。跨父级容器的顺序不能用 zIndex 穿透,需要调整树结构或图层策略。
原理流程
单节点:链顺序 → 背景 → 内容 → 前景
兄弟:默认布局顺序,zIndex 大的后绘制
跨容器:按父级层级合成
代码或图示
Box {
A(Modifier.zIndex(1f))
B(Modifier.zIndex(2f)) // 后绘制
}
常见误区
- 用链上 drawAfter 期望跨兄弟盖在其他容器之上。
- 父级 clip 后子节点 zIndex 提升仍被裁切。
追问
- 图层顺序与 zIndex 冲突时谁优先?答:先按树层级与 zIndex 确定节点顺序,再在图层合成中应用;具体合成规则以渲染实现为准。
- 悬浮层放哪?答:独立覆盖容器或弹窗层级,避免依赖兄弟 zIndex。
07.1.1.7.2-060 Compose 与传统 View onDraw 在绘制模型上有何区别?
一句话结论
View 在持有 canvas 的 onDraw 中命令式绘制,实例常驻;Compose 绘制节点由组合树驱动,绘制命令按节点与链生成,状态变化后增量失效重绘。
概念解释
View 自定义绘制需要管理 View 实例、canvas 状态与 invalidate;Compose 不需要 new 绘制对象,修饰符与 Canvas 声明绘制意图,框架决定何时重绘。Compose 绘制仍落到平台渲染管线,但模型是声明式节点描述。
原理流程
View: 实例.onDraw(canvas) → 命令式绘制 → invalidate 触发重绘
Compose: 节点 + 绘制 lambda → 状态/尺寸失效 → 重跑绘制命令
代码或图示
// Compose:声明式
Modifier.drawBehind { drawCircle(color) }
常见误区
- 把 View onDraw 里的可变状态模式搬进 Compose 绘制 lambda。
- 以为 Compose 每个节点对应一个平台 View 实例。
追问
- 旧自定义 View 怎么复用?答:通过 AndroidView 嵌入互操作;新绘制逻辑优先用 DrawScope 原语。
- 绘制状态如何管理?答:可观察输入走 State,绘制回调消费值,不在 canvas 外保留可变绘制状态。
07.1.1.7.2-061 animate*AsState 系列 API 适用于什么场景?
一句话结论
animateXxxAsState 把目标值变化自动插值为动画 State,适合单个属性(颜色、偏移、透明度、尺寸)从旧值平滑过渡到新值的场景。
概念解释
给定目标值与动画规格,API 返回 State,当前帧读取动画值。目标值变化时启动动画,到达目标后停止。封装了协程与状态管理,调用方只需读取动画结果应用到修饰符。
原理流程
目标值变化
→ animate*AsState 启动插值动画
→ 返回 animationState.value → 修饰符消费
代码或图示
val alpha by animateFloatAsState(
targetValue = if (visible) 1f else 0f,
animationSpec = tween(300)
)
常见误区
- 用它管理多个相互关联的动画状态,多属性联动应改用 Transition。
- 直接把动画值写回状态源,形成循环。
追问
- 支持哪些类型?答:Float、Dp、Color、Int、Size、Offset 等;自定义类型需提供 TwoWayConverter,具体清单以库版本为准。
- 动画取消时机?答:节点离开组合或目标切换时取消旧动画。
07.1.1.7.2-062 Animatable 与 animate*AsState 在可控性上有何差异?
一句话结论
Animatable 是协程驱动的可控动画容器,可手动 snapTo、animateTo、停在任意状态;animate*AsState 面向声明式目标值自动过渡,控制接口较少。
概念解释
Animatable 持有当前值与目标值,方法挂在协程作用域中调用,适合手势跟随、逐帧控制、动画中断切换。animate*AsState 在组合内自动管理生命周期,适合简单属性过渡。两者底层动画机制相通。
原理流程
animate*AsState:目标值 → 自动启动/停止
Animatable:scope.launch { animatable.animateTo(...) / snapTo(...) }
代码或图示
val offset = remember { Animatable(0.dp) }
scope.launch {
offset.animateTo(100.dp, spring())
}
常见误区
- 在非协程上下文直接调用 Animatable 方法。
- 用 Animatable 做普通属性过渡,代码比 animate*AsState 更重。
追问
- Animatable 状态如何保留?答:remember 持有实例;配置变更保留策略按 remember/ Saveable 规则。
- 手势吸附用哪个?答:Animatable 配合拖拽手势,可随时 snap 到跟手位置再弹回。
07.1.1.7.2-063 Transition(updateTransition)如何管理多个动画状态?
一句话结论
updateTransition 以状态枚举为目标,统一管理多个子动画(label、颜色、偏移等)同时过渡,保证多属性节奏一致。
概念解释
Transition 接收目标状态,内部各 transition.animateXxx 绑定同一状态机;状态切换时所有子动画并行推进。适合卡片展开折叠、界面切换等多属性联动。相比多个独立 animate*AsState,状态与同步更集中。
原理流程
updateTransition(targetState = uiMode)
→ 各属性 animateXxx(transition)
→ 目标状态切换 → 全部子动画同步过渡
代码或图示
val transition = updateTransition(if (expanded) Expanded else Collapsed)
val height by transition.animateDp { it.height }
常见误区
- 多个独立动画各自规格不同,状态切换时节奏错乱。
- 目标状态用不稳定对象,Transition 反复重置。
追问
- Transition 与 AnimatedVisibility 关系?答:后者内部基于 Transition 管理进入退出;自定义联动用 updateTransition。
- 子动画规格可以不同吗?答:可以逐属性指定 spec,但目标状态切换统一触发。
07.1.1.7.2-064 AnimatedVisibility 的进入/退出动画如何定制?
一句话结论
通过 enter/exit 参数指定入场(淡入、缩放、展开)与出场组合动画,内容在可见性切换时进入或离开组合。
概念解释
AnimatedVisibility 在显隐过渡期间保留内容组合,退出动画结束后才真正移除节点。可组合 enter/exit 动画(fadeIn、expandVertically、slideIn 等),也可自定义 Transition。状态中间值由内部 Transition 管理。
原理流程
可见性 true → enter 动画执行 → 内容保留
false → exit 动画执行 → 完成后离开组合
代码或图示
AnimatedVisibility(
visible = show,
enter = fadeIn() + expandVertically(),
exit = fadeOut() + shrinkVertically()
) {
DetailCard()
}
常见误区
- 退出动画期间期待子节点已销毁,实际仍在组合中。
- 把内容直接包在条件 if 里,没有退出过渡。
追问
- 动画完成回调如何拿?答:可观察 Transition 状态或使用回调参数,具体 API 版本以文档为准。
- 列表项移除动画用什么?答:懒列表 item 隐式动画与 AnimatedVisibility 配合,注意回收时机。
07.1.1.7.2-065 rememberInfiniteTransition 如何实现循环动画?
一句话结论
它创建无限循环过渡容器,子动画用 infiniteRepeatable 规格在指定模式下反复执行,适合呼吸、旋转、流光等持续效果。
概念解释
rememberInfiniteTransition 持有循环状态,animateFloat 等绑定到该容器;动画规格用 infiniteRepeatable 定义重复模式(restart/reverse)与初始目标。离开组合时循环停止。
原理流程
val infinite = rememberInfiniteTransition()
val alpha by infinite.animateFloat(
initialValue = 0.3f, targetValue = 1f,
animationSpec = infiniteRepeatable(tween(800), RepeatMode.Reverse)
)
代码或图示
val rotation by infinite.animateFloat(
0f, 360f,
infiniteRepeatable(tween(2000), RepeatMode.Restart)
)
常见误区
- 页面不可见时循环动画仍在跑,应结合可见性暂停或移除节点。
- 重复动画频繁触发整树重组,动画值应作用于图层修饰符。
追问
- 循环可以暂停吗?答:容器随组合离开停止;条件性移除节点或用状态控制目标值。
- 与普通 Transition 区别?答:无明确终止目标,按 repeatable 规格循环执行。
07.1.1.7.2-066 animationSpec 中 spring、tween、keyframes 各适合什么场景?
一句话结论
spring 基于物理弹力、适合跟随与回弹;tween 按时长与缓动插值、适合确定时长过渡;keyframes 按时间点设定关键值、适合多段非线性节奏。
概念解释
spring 由 stiffness/dampingRatio 决定,无固定时长,越接近目标越慢,适合弹性交互;tween 指定 durationMillis 与 easing;keyframes 在多个时间点设置值,中间按插值连接。还有 snapping、repeatable 等规格。
原理流程
spring:物理力 → 速度/位置收敛
tween:时长 + easing → 线性时间插值
keyframes:时间点值表 → 分段插值
代码或图示
val spec = spring<Dp>(stiffness = Spring.StiffnessMedium)
val tweenSpec = tween<Float>(durationMillis = 300, easing = FastOutSlowInEasing)
常见误区
- 所有场景用 tween,缺少手势跟随的自然回弹感。
- keyframes 关键值设置矛盾,动画跳跃。
追问
- spring 参数如何调?答:stiffness 越高越快,dampingRatio 小于 1 产生回弹;按手感在设备上实测。
- 规格可以嵌套 repeatable 吗?答:infiniteRepeatable 包裹基础规格实现循环。
07.1.1.7.2-067 Easing 缓动函数如何影响动画节奏?
一句话结论
Easing 把线性时间进度映射为插值进度,决定加速、减速曲线;不同 easing 改变动画的起始顿挫与收尾手感。
概念解释
tween 规格中 easing 接收 0~1 时间进度,返回 0~1 插值进度。常用 FastOutSlowIn(先快后慢)、LinearOutSlowIn(减速进入)、CubicBezier 自定义曲线。错用 easing 会让动画显得生硬或拖沓。
原理流程
时间进度 t ∈ [0,1]
→ easing(t) → 插值进度
→ 按进度在起始值与目标值之间取值
代码或图示
tween<Float>(durationMillis = 250, easing = LinearOutSlowInEasing)
常见误区
- 自定义 CubicBezier 控制点超出合理区间,进度越界。
- 长动画用线性 easing,匀速移动缺乏层次。
追问
- Easing 只作用于 tween 吗?答:spring 走物理模型不用 easing;keyframes 分段插值也可结合曲线。
- 如何预览曲线?答:Studio 动画预览与官方曲线参考,设备上核对实际帧率手感。
07.1.1.7.2-068 Animatable 如何通过协程控制动画启动、停止与跳变?
一句话结论
在协程中调用 animateTo 启动过渡、snapTo 立即设值、停止动画由协程取消实现;Animatable 内部挂起直到动画完成或被中断。
概念解释
animateTo 挂起协程执行到目标值;snapTo 不动画直接更新;取消所在协程即停止当前动画。可在动画中根据手势动态改目标值,实现跟手与回弹切换。需要 remember 持有实例并绑定组合作用域。
原理流程
scope.launch {
animatable.snapTo(current) // 跳变
animatable.animateTo(target) // 过渡
}
// 协程取消 → 动画停止
代码或图示
val anim = remember { Animatable(0f) }
LaunchedEffect(visible) {
if (visible) anim.animateTo(1f) else anim.animateTo(0f)
}
常见误区
- 在主线程同步调用 animateTo,阻塞等待动画完成。
- 协程作用域丢失,页面退出后动画继续更新。
追问
- 动画中断时值停在哪?答:停在中断时的当前值,协程收到取消异常;后续可从当前值继续。
- 如何监听动画结束?答:animateTo 返回结果(结束原因),或读取动画状态;具体 API 以版本为准。
07.1.1.7.2-069 动画状态在配置变更后是否保留?
一句话结论
普通 remember 持有 Animatable/动画实例在配置变更后默认不保留;需要恢复动画位置可用 rememberSaveable 包装可保存状态,或提升到 ViewModel。
概念解释
动画当前值属于界面状态。旋转屏幕重建组合时,remember 槽位默认清空,动画回到初值;动画进度若需跨配置变更保留,应保存可序列化的当前值与目标值,恢复后从该值继续。
原理流程
remember { Animatable(...) } → 配置变更后重置
rememberSaveable 保存动画关键值 → 恢复后重建实例并对齐
代码或图示
val progress = rememberSaveable { mutableStateOf(0f) }
常见误区
- 期待旋转后动画无缝继续,实例随组合重建。
- 把运行中的协程引用保存进 Saveable,不可序列化。
追问
- 业务动画状态放哪?答:跨页面存活的动画模型提升到 ViewModel;纯展示动画留在组合层。
- 进程回收后呢?答:只有保存的数值可恢复,运行中协程与动画对象不保留。
07.1.1.7.2-070 动画过程中如何避免触发整棵组合树重组?
一句话结论
动画值应作用于修饰符/图层属性,读取位置下沉到叶子节点;避免在父层读取动画值再下发,减少重组范围与重布局。
概念解释
高频动画每帧更新 State,读取该 State 的节点进入重组候选。把动画值限定在消费它的组件内,用 graphicsLayer 属性做合成层动画,避免每帧触发测量布局。动画对象稳定、拆分小组件有助于跳过无关子树。
原理流程
动画 State 每帧更新
→ 读取点越小 → 仅叶子节点重组
→ layer 属性动画 → 不重布局,合成层处理
代码或图示
val scale by animateFloatAsState(target)
Icon(Modifier.graphicsLayer { scaleX = scale; scaleY = scale })
常见误区
- 在大容器顶部读取动画值,整棵子树每帧重组。
- 动画驱动 padding/尺寸变化,每帧重布局整段子树。
追问
- 哪些动画应走图层?答:平移、缩放、透明度、旋转;尺寸与位置流布局仍需布局阶段。
- 如何验证重组范围?答:Layout Inspector 重组计数与 Perfetto 帧轨迹对照。
07.1.1.7.2-071 AnimatedContent / Crossfade 如何在两个界面间过渡?
一句话结论
它们在两个内容状态之间切换时保留过渡上下文:Crossfade 做淡入淡出交叉,AnimatedContent 可定制进出/滑动动画并管理内容状态映射。
概念解释
Crossfade 接收目标内容块,新旧内容叠加透明度渐变;AnimatedContent 以状态为键切换内容,支持 enter/exit 与内容尺寸动画,可在过渡期间同时存在新旧子树。两者都把动画状态封装在组件内部。
原理流程
目标状态变化
→ 旧内容退出 + 新内容进入
→ 过渡完成 → 旧内容离开组合
代码或图示
AnimatedContent(targetState = page) { screen ->
ScreenContent(screen)
}
常见误区
- 把两个页面直接 if 切换,没有保留过渡上下文。
- 在 AnimatedContent 内容键中使用不稳定对象,内容反复重建。
追问
- 如何指定不同状态间的滑动方向?答:通过 transitionSpec 定义 enterTogether/exitTogether,方向随目标状态变化;具体 API 以版本为准。
- 过渡期间旧内容状态保留吗?答:按内容 key 与组合策略决定,需要保留的状态应提升到外部。
07.1.1.7.2-072 animateContentSize 与显式布局动画如何配合?
一句话结论
animateContentSize 只动画化容器尺寸;子项显式动画负责自身位置、透明度与外观,两者可叠加但尺寸动画仍会触发布局阶段计算。
概念解释
内容增删先改变目标尺寸,animateContentSize 插值容器宽高;子项进入退出由 AnimatedVisibility 控制。组合使用时注意尺寸动画每帧上报中间尺寸,子树按中间尺寸重新布局,复杂子树需要优化。
原理流程
内容变化 → 目标尺寸改变
→ animateContentSize 插值容器尺寸
→ 子项按中间尺寸布局 + 自身进出动画
代码或图示
Column(Modifier.animateContentSize()) {
if (expanded) ExtraContent()
}
常见误区
- 以为尺寸动画走图层合成,实际仍参与布局测量放置。
- 子树过重时尺寸动画每帧重测,造成掉帧。
追问
- 替代方案?答:固定高度容器内用偏移/裁剪动画,避免每帧重布局;按视觉效果选择。
- 动画规格如何配置?答:animateContentSize 可传 animationSpec,与其他动画节奏对齐。
07.1.1.7.2-073 动画取消时协程与状态如何收尾?
一句话结论
动画协程随作用域取消而停止,动画值停在当前位置;需要清理的监听、订阅在 DisposableEffect 中释放,状态值保留在持有容器中供下次继续。
概念解释
LaunchedEffect/rememberCoroutineScope 取消时动画协程收到取消异常,animateTo 中断。Animatable 当前值保留;节点离开组合时状态槽位回收。退出动画资源(平台控制器、监听)必须在 onDispose 释放。
原理流程
离开组合 / key 变化 → 取消动画协程
→ 动画停在当前值
→ onDispose 释放外部资源
代码或图示
DisposableEffect(Unit) {
val anim = platformAnimator()
onDispose { anim.cancel() }
}
常见误区
- 协程取消后仍回调更新已离开的节点。
- 平台动画控制器未取消,后台继续运行耗电。
追问
- 取消异常如何处理?答:协程内用 finally 收尾,不要吞掉取消异常继续执行。
- 动画值需要恢复吗?答:保留当前值即可;需要持久化的进度按状态保存规则处理。
07.1.1.7.2-074 嵌套动画的层级与父子动画作用域如何划分?
一句话结论
父级 Transition 管理整体状态切换,子动画各自绑定父 Transition;手势驱动动画由独立 Animatable 跟随,层级按状态归属与作用域划分,避免跨作用域直接改值。
概念解释
一个页面级 Transition 协调多个子属性;局部组件内部可有自己的循环或跟随动画。父子动画不共享协程作用域,子动画通过参数接收目标值。嵌套 AnimatedVisibility 的进出动画与父级过渡独立计算。
原理流程
父级 updateTransition(页面状态)
→ 子属性 animateXxx(transition)
→ 局部组件内部 Animatable 处理手势/循环
代码或图示
val pageTransition = updateTransition(tab)
val topBarColor by pageTransition.animateColor { ... }
常见误区
- 多个动画各自启动协程,状态切换时节奏不同步。
- 子组件直接修改父级动画值,绕过状态归属。
追问
- 动画状态提升到哪一层?答:归属需要驱动它的最近祖先;跨组件同步的动画模型放共同祖先或 ViewModel。
- 嵌套过渡时长如何统一?答:父 Transition 规格控制主干,子项局部规格只做细节差异。
07.1.1.7.2-075 偏移动画(offset)应使用 graphicsLayer 还是布局偏移?
一句话结论
纯视觉跟随/位移动画优先 graphicsLayer 偏移(合成层处理,不触发重布局);需要参与布局占位、影响后续兄弟位置时才用布局 offset/animateContentSize。
概念解释
graphicsLayer translationX/Y 改变合成位置,节点测量尺寸不变;Modifier.offset 改变 placement 偏移,仍在布局阶段。高频跟手动画走图层可避免每帧重新测量子树。图层偏移不改变命中区域(受节点实际边界约束)。
原理流程
图层动画:layer.translationX → 合成位移,布局尺寸不变
布局偏移:placeable 放置坐标 → 参与布局结果
代码或图示
Modifier.graphicsLayer { translationX = offset.value }
常见误区
- 动画位移用布局 offset,列表项每帧重排。
- 期望图层偏移后改变触摸区域,实际命中仍按原节点边界。
追问
- 滑动删除菜单用哪种?答:跟手拖拽常结合布局测量与图层位移;具体实现按菜单占位需求选型。
- 图层偏移是否影响兄弟节点?答:不影响,兄弟布局按原占位计算。
07.1.1.7.2-076 动画帧率掉帧的常见原因有哪些?
一句话结论
每帧重布局/重测量、重组范围过大、离屏层过多、绘制分配抖动、主线程被其他任务阻塞,以及动画在低端机上栅格化成本过高,都会导致动画掉帧。
概念解释
动画帧要在帧预算内完成组合、布局、绘制与合成。动画值驱动布局变化会反复测量子树;大量独立图层增加合成压力;每帧 new 对象触发 GC。定位时先看 Perfetto 各泳道耗时归属。
原理流程
动画每帧更新 State
→ 组合重组 → 布局测量 → 绘制 → 合成
→ 任一阶段超帧预算 → 掉帧
代码或图示
排查顺序:重组范围 → 布局重算 → 图层数量 → 绘制分配 → 主线程阻塞
常见误区
- 把动画掉帧都归因为动画库,实际是子树重组或绘制瓶颈。
- 动画在页面不可见时仍持续运行。
追问
- 如何测量动画帧率?答:Perfetto 帧轨迹、Studio 动画检查、设备帧率统计;对比目标机型。
- 优化手段?答:图层属性动画、下沉读取点、缓存绘制对象、减少离屏层。
07.1.1.7.2-077 关键帧(keyframes)与弹簧(spring)在可预测性上的取舍是什么?
一句话结论
keyframes 时长与轨迹确定、便于设计还原;spring 物理自然、可回弹跟随,但收敛时间受初始速度与参数影响,不完全固定。
概念解释
可预测的交接动画用 keyframes/tween,保证时长与中间状态符合设计稿;手势驱动与弹性反馈用 spring,根据速度自然收敛。需要既自然又有上限时长时,可组合弹簧与阈值配置。
原理流程
keyframes:时间点确定 → 每段轨迹可控
spring:物理模型 → 速度决定路径,可能回弹
代码或图示
spring<Dp>(dampingRatio = Spring.DampingRatioMediumBouncy)
常见误区
- 弹簧阻尼过低导致回弹过久,交接动画显得拖沓。
- 关键帧数值与设计曲线不一致,动画节奏跑偏。
追问
- spring 能设固定时长吗?答:收敛到稳定值的时间由物理参数决定;需要硬时长约束时评估 tween/keyframes。
- 手势中断后切换弹簧如何衔接?答:Animatable 保留当前速度与位置,animateTo 按新目标继续物理收敛。
07.1.1.7.2-078 动画完成回调如何在 Compose 中监听?
一句话结论
animateTo 返回结束状态可在协程中判断;Transition 可读取动画状态枚举;组件级动画提供状态回调参数,按 API 层级选择监听方式。
概念解释
协程式动画完成点在 animateTo 返回后;多状态 Transition 通过 currentState/targetState 判断是否到位。AnimatedVisibility 等封装组件提供完成回调。不要在绘制帧回调里监听完成事件。
原理流程
scope.launch {
val result = animatable.animateTo(target)
// result 包含结束原因
}
代码或图示
LaunchedEffect(visible) {
anim.animateTo(if (visible) 1f else 0f)
onAnimationEnd()
}
常见误区
- 在动画值读取处判断完成,每帧重复触发回调。
- 回调引用旧参数,应配合 rememberUpdatedState。
追问
- 动画被取消也算完成吗?答:结束原因区分完成与中断,回调逻辑需分别处理。
- 组件封装回调找不到时?答:退到 Transition 状态监听或 Animatable 协程结果。
07.1.1.7.2-079 状态改变时希望立即跳变而非过渡,该怎么处理?
一句话结论
用 snap 动画规格或 Animatable.snapTo 直接设值;animate*AsState 传 snap() 规格,目标切换时无插值立即到位。
概念解释
默认规格会从旧值过渡到新值;snap 规格把动画时长视为零,状态更新后直接显示目标值。适合初始状态恢复、配置切换、不需要过渡的场景。spring/tween 都不提供即时跳变语义。
原理流程
target 变化 → snap 规格 → 当前值直接等于目标值
Animatable.snapTo(value) → 跳变并取消进行中动画
代码或图示
val color by animateColorAsState(
targetValue = target,
animationSpec = snap()
)
常见误区
- 用极短 tween 模拟跳变,仍可能产生一帧过渡。
- 恢复状态时走动画,画面从旧值闪到新值。
追问
- 哪些 API 支持 snap?答:动画规格体系通用;Animatable 有 snapTo 方法,具体签名以版本 API 为准。
- 跳变后需要布局刷新吗?答:值变化触发对应节点更新,按读取位置决定重组/重绘。
07.1.1.7.2-080 列表项进入/退出动画与 AnimatedVisibility 的边界是什么?
一句话结论
懒列表项的增删回收由列表布局管理,AnimatedVisibility 负责项内内容的进出;整项移除动画依赖列表 item 动画能力,二者不要混用替代。
概念解释
AnimatedVisibility 包裹的内容在过渡期间保留组合;懒列表移除 item 时节点回收由列表控制。项内展开/折叠用 AnimatedVisibility;列表项新增/删除的整体移动与淡出由懒布局动画规范提供,key 稳定是动画对位前提。
原理流程
项内内容显隐 → AnimatedVisibility 控制
整项增删 → 懒列表 item 动画 + key 匹配节点
代码或图示
LazyColumn {
items(items, key = { it.id }) { item ->
RowItem(item) // 列表项动画由布局处理
}
}
常见误区
- 用 AnimatedVisibility 包裹整个列表项期待移除动画,回收时机不匹配。
- 列表无稳定 key,移动时动画错位。
追问
- 项内布局动画用什么?答:animateContentSize、偏移/图层动画配合项内状态。
- 退出动画结束后回收时机?答:列表布局与组件动画协商,具体回收策略以懒布局实现为准。
07.1.1.7.2-081 Material 3 主题由哪几部分组成?
一句话结论
M3 主题由 ColorScheme(颜色)、Typography(排版)、Shapes(形状)三部分组成,通过 Theme 可组合项统一向下提供给组件。
概念解释
颜色方案定义主色、辅助色、表面、文本等角色;排版定义各级文字样式;形状定义小/中/大三档圆角。组件从主题读取对应 token,不硬编码具体色值与圆角。主题可整体替换或局部覆盖。
原理流程
MaterialTheme(
colorScheme = lightColorScheme(),
typography = Typography,
shapes = Shapes
) { AppRoot() }
代码或图示
MaterialTheme(colorScheme = scheme, typography = typo, shapes = shape) {
Surface { /* 页面 */ }
}
常见误区
- 组件内直接写死颜色/圆角,绕过主题 token。
- 只覆盖颜色不统一形状与排版,风格不一致。
追问
- 主题三层结构与 M2 差异?答:角色命名与配色体系不同,迁移时逐项映射;详见迁移题目。
- 自定义主题包在哪?答:应用入口 Theme 可组合项,全局包裹根界面。
07.1.1.7.2-082 dynamicColorScheme 动态取色的工作条件与适用版本是什么?
一句话结论
动态取色从系统壁纸提取配色生成 ColorScheme,仅在支持的设备与系统版本上可用;低版本或不支持时需回退到静态品牌色方案。
概念解释
Android 12 及以上系统提供动态配色能力,Compose 通过动态颜色方案工厂生成 light/dark scheme。设备不支持、用户未开启取色或低版本时,必须提供兜底静态 scheme。具体可用 API 与系统版本边界以官方文档为准(待确认时核对目标 compileSdk)。
原理流程
检测系统支持动态色
→ 生成 dynamicLight/darkColorScheme
→ 不支持 → 使用静态品牌 ColorScheme
代码或图示
val scheme = if (isDynamicColorSupported) {
dynamicLightColorScheme(context)
} else {
lightColorScheme(/* 品牌色 */)
}
常见误区
- 假设所有设备都能取到动态色,低版本崩溃或颜色缺失。
- 深色模式仍直接用浅色动态方案。
追问
- 如何检测支持条件?答:按系统版本与可用工厂返回值判断;具体 API 名随库版本变化,需在目标版本实测。
- 动态色与品牌色冲突时谁优先?答:按产品策略决定,可保留品牌主色、动态取色仅作用于辅助/表面色。
07.1.1.7.2-083 深色主题在 Compose 中如何切换与检测?
一句话结论
通过深浅两套 ColorScheme 与主题状态切换,宿主可读取系统暗色模式标记决定默认方案;主题状态提升到应用层级,组件读取主题颜色角色。
概念解释
Compose 不强制自动跟随系统,Theme 可组合项接收当前 scheme。系统暗色模式可通过配置/上下文判断,应用内也可提供手动覆盖。切换时根 Theme 传入新 scheme,读取主题色的节点重组重绘。
原理流程
读取暗色模式状态
→ 选择 darkColorScheme / lightColorScheme
→ MaterialTheme 包裹根界面
代码或图示
val dark = isSystemDark(context)
val scheme = if (dark) DarkColorScheme else LightColorScheme
MaterialTheme(colorScheme = scheme) { App() }
常见误区
- 组件里硬编码深色颜色,主题切换后不跟随。
- 只换颜色不检查表面对比与图片资源适配。
追问
- 主题状态放哪?答:应用级状态容器/ViewModel,组合层 collectAsState 接收;手动覆盖优先级高于系统设置。
- 检测系统暗色用什么?答:配置 uiMode 或 Compose 提供的本地状态;具体 API 以版本为准。
07.1.1.7.2-084 Typography 字体系统如何定义与覆盖?
一句话结论
Typography 按角色(display/headline/title/body/label 等)定义字号、字重、行高与字体族,组件按文字角色引用,覆盖时替换整套或个别文字样式。
概念解释
M3 排版角色对应不同用途,每个 TextStyle 持有 fontSize、fontWeight、lineHeight、fontFamily 等。应用可定义自定义 Typography 传入主题;组件内 Text 不传样式时使用主题对应角色。字体族可绑定自定义字体资源。
原理流程
Typography(
titleLarge = TextStyle(fontSize = 20.sp, fontWeight = FontWeight.SemiBold),
bodyMedium = TextStyle(...)
)
代码或图示
val AppTypography = Typography(
bodyLarge = TextStyle(fontFamily = AppFont, fontSize = 16.sp)
)
常见误区
- 在每个 Text 上硬编码 sp 与字重,主题字体无法统一替换。
- 只改字号不设行高,多行文本拥挤或截断。
追问
- 自定义字体如何接入?答:字体资源绑定 fontFamily,Typography 角色引用;字体加载方式按 Compose 字体文档配置。
- 字号缩放影响?答:系统 fontScale 会放大 sp 尺寸,排版需验证大字号下换行与溢出。
07.1.1.7.2-085 Shapes 形状系统的档位如何映射到组件?
一句话结论
Shapes 提供 small/medium/large 三档圆角,组件按自身尺寸与角色选择档位;按钮、卡片、弹窗分别映射不同形状令牌,业务组件不写死圆角。
概念解释
形状档位是语义化圆角集合,M3 组件内部按类型取对应 shape。应用可调整三档圆角半径,或为特定组件传入自定义 Shape。连续圆角、矩形、圆形通过 Shape 实现。
原理流程
Shapes(small = RoundedCornerShape(8.dp),
medium = RoundedCornerShape(12.dp),
large = RoundedCornerShape(20.dp))
代码或图示
Button(shape = MaterialTheme.shapes.medium) { ... }
常见误区
- 每个组件重复写圆角 dp,调整品牌形状时要全量改。
- 大卡片用小档位圆角,视觉比例失衡。
追问
- 自定义非圆角形状?答:实现 Shape 接口或 GenericShape 定义轮廓,传入组件 shape 参数。
- 形状与裁剪关系?答:shape 常配合 clip/图层裁剪生效,阴影轮廓也依赖 shape。
07.1.1.7.2-086 自定义品牌色如何覆盖 ColorScheme?
一句话结论
用浅色/深色 scheme 工厂传入品牌主色与辅助角色,或在默认 scheme 基础上 copy 覆盖个别角色;浅色与深色必须分别定义保证对比。
概念解释
ColorScheme 角色固定,品牌色映射到 primary/secondary/tertiary 等角色。copy 可保留未覆盖角色。自定义品牌色不能只覆盖一套方案,深色模式下表面与文本对比需重新核对。
原理流程
val BrandLight = lightColorScheme(
primary = Color(0xFFxxxxxx),
onPrimary = Color.White
)
val BrandDark = darkColorScheme(primary = ...)
代码或图示
val scheme = lightColorScheme().copy(primary = BrandPrimary)
常见误区
- 品牌色只定义浅色,深色直接复用导致对比不足。
- 直接改硬编码 Color,主题切换时不更新。
追问
- 角色之间有什么约束?答:onX 用于对应 X 背景上的文本/图标颜色,需满足对比度;具体角色关系见 M3 颜色规范。
- 品牌渐变色怎么办?答:不属于 scheme 单色角色,通过扩展主题或组件 token 提供。
07.1.1.7.2-087 主题色通过哪些 CompositionLocal 向组件下发?
一句话结论
MaterialTheme 内部把 colorScheme、typography、shapes 绑定到对应 CompositionLocal,组件读取 MaterialTheme.colorScheme 等访问器取当前主题值。
概念解释
主题值沿组合树向下继承,读取点订阅主题变化。访问器是对 LocalColorScheme 等本地值的封装。自定义主题属性也可通过自定义 CompositionLocal 同机制下发。
原理流程
MaterialTheme 提供 LocalColorScheme / LocalTypography / LocalShapes
→ 组件 MaterialTheme.colorScheme.primary
代码或图示
val color = MaterialTheme.colorScheme.primary
常见误区
- 绕过主题直接读 Local 私有实例,版本升级易失效。
- 在局部覆盖 provider 后未告知组件读取约定。
追问
- 主题变化如何触发重绘?答:读取 local.current 的节点建立订阅,scheme 切换时重绘。
- 如何扩展主题?答:自定义 CompositionLocal 包装扩展值,在 Theme 中 provide。
07.1.1.7.2-088 如何同时为浅色与深色定义扩展颜色?
一句话结论
定义两套扩展颜色容器(light/dark),在 Theme 中按当前模式选择,通过自定义 CompositionLocal 下发;扩展类型应稳定并区分 onX 对比色。
概念解释
M3 scheme 之外的品牌语义色(如成功、警告、渐变起点)需要自建扩展。浅色与深色分别给值,Theme 根据暗色状态选择对应容器提供。扩展颜色同样要考虑文本/图标对比角色。
原理流程
data class ExtendedColors(val success: Color, val onSuccess: Color)
val LocalExtended = staticCompositionLocalOf<ExtendedColors> { error("未提供") }
代码或图示
CompositionLocalProvider(
LocalExtended provides (if (dark) DarkExtended else LightExtended)
) { App() }
常见误区
- 扩展色只定义一套,深色模式下刺眼或对比不足。
- 扩展容器持有可变状态,破坏主题不可变性。
追问
- 扩展类型稳定性?答:颜色值不可变即可;含可变字段需标注或拆成不可变数据类。
- 如何在组件读取?答:
LocalExtended.current.success,与主题访问器模式一致。
07.1.1.7.2-089 字号缩放(fontScale)对主题排版有何影响?
一句话结论
系统字号放大时 sp 单位尺寸随之放大,主题排版角色按比例增大;需验证大字号下文本换行、组件高度与布局溢出,必要时限制最小/最大字号。
概念解释
sp 密度受 fontScale 影响,Text 与排版样式使用 sp。大字号导致单行文本变宽、组件高度增加,固定尺寸容器可能截断。可访问性要求适配大字号,不应简单禁用缩放。
原理流程
fontScale > 1 → sp 字号放大
→ 文本宽度/行高增加
→ 布局重排,验证不截断、不重叠
代码或图示
Text(text, style = MaterialTheme.typography.bodyMedium)
常见误区
- 用 dp 设置文字大小,不随系统字号缩放。
- 固定高度 + 大字号导致文本裁剪。
追问
- 如何测试大字号?答:预览配置 fontScale 或开发者选项调大字号,走查关键页面。
- 多行文本策略?答:允许换行与自适应高度,固定单行场景明确省略策略。
07.1.1.7.2-090 Theme 包裹层级与组件局部覆盖颜色如何配合?
一句话结论
根 Theme 提供全局方案,局部 CompositionLocalProvider 或组件参数可覆盖子树颜色/形状;覆盖只影响包裹区域,离开作用域恢复全局值。
概念解释
主题按组合层级就近覆盖:弹窗、选中态、特殊卡片可在子树提供局部 scheme 或传入组件颜色参数。局部覆盖不应破坏角色对比约定。多层 provider 嵌套时内层优先。
原理流程
根 MaterialTheme(全局 scheme)
→ 局部 Provider(覆盖局部角色)
→ 子组件读到局部值
代码或图示
CompositionLocalProvider(
LocalColorScheme provides LocalScheme
) { HighlightCard() }
常见误区
- 在深层组件里改全局主题引用,影响无关子树。
- 局部覆盖颜色但未配套 onX 文本色,对比错误。
追问
- 组件级颜色优先级?答:显式参数 > 局部 provider > 全局主题;按层就近取值。
- 局部覆盖需要保留全局哪些角色?答:未覆盖角色可从全局 scheme copy 继承。
07.1.1.7.2-091 颜色对比度与可访问性在主题设计中如何考虑?
一句话结论
文本/图标色与背景色需满足可访问性对比度下限,深浅两套方案分别核对;状态色(禁用、选中、错误)也要保证可辨识。
概念解释
颜色角色成对定义(background 与 onBackground),主题设计时检查对比度,避免浅色背景配浅色文本。不只看主色,按钮、输入框、错误提示、禁用态都要覆盖。大字号与普通字号阈值不同。
原理流程
取背景色 + 前景色
→ 计算对比度
→ 不达标 → 调整角色颜色
代码或图示
primary 背景 → onPrimary 文本
surface 背景 → onSurface 文本
常见误区
- 只在浅色模式核对对比,深色模式下表面色过亮。
- 用颜色作为唯一状态提示,缺少图标/文案辅助。
追问
- 对比度工具有哪些?答:官方颜色规范与在线对比度计算器;预览中分别检查深浅主题。
- 品牌色对比不足怎么办?答:调整 onX 文本色或改用符合对比的表面承载品牌色。
07.1.1.7.2-092 Material 3 主题与自定义组件共享 token 的方式是什么?
一句话结论
自定义组件从 MaterialTheme 读取颜色、排版、形状角色,或通过扩展 CompositionLocal 提供自有 token;组件不持有硬编码样式常量。
概念解释
团队自有组件库应与 M3 主题对接:常规角色读 MaterialTheme,品牌扩展读本地扩展颜色。token 集中在主题层定义,组件只消费。这样换肤、深浅切换可统一生效。
原理流程
主题层:定义 scheme / typography / shapes / extended
→ 组件层:读取 token 渲染
代码或图示
@Composable
fun TeamCard(modifier: Modifier = Modifier) {
val bg = MaterialTheme.colorScheme.surface
// ...
}
常见误区
- 组件库内部写死颜色常量,主题切换不生效。
- 每个组件各自定义一套圆角/字号,品牌调整分散。
追问
- 组件库如何独立预览主题?答:Preview 包裹自定义 Theme 传入多套 token。
- 非 M3 组件怎么复用?答:扩展 CompositionLocal 下发自定义样式容器。
07.1.1.7.2-093 动态取色不可用时如何回退到品牌色?
一句话结论
初始化主题时判断动态色可用性,不可用或用户关闭时使用静态浅色/深色品牌 scheme;回退路径要在低版本与不支持设备上实测。
概念解释
回退不是简单给一个浅色值,而是完整静态 scheme(含深浅两套)。检测逻辑放在 Theme 组装处,避免组件内分支判断。品牌主色可始终保留,动态色只覆盖表面/辅助角色。
原理流程
isSupported && enabled → dynamic scheme
→ 否则 → static BrandLight / BrandDark
代码或图示
val scheme = when {
dynamicAvailable -> dynamicLightColorScheme(context)
else -> BrandLightScheme
}
常见误区
- 回退 scheme 缺少深色方案,暗色模式崩溃或配色错误。
- 在组件运行时反复检测支持能力,产生额外分支。
追问
- 用户关闭动态色怎么办?答:跟随系统设置状态,回退静态方案;状态变化时主题重组。
- 版本边界如何确认?答:核对目标 compileSdk 与库版本文档,标「待确认」处实测机型。
07.1.1.7.2-094 形状圆角在不同尺寸组件上如何选择档位?
一句话结论
小控件用 small 档、卡片/中等容器用 medium、大容器/弹窗用 large;按组件视觉比例选择,避免大卡片配极小圆角或小按钮配大圆角。
概念解释
形状档位与组件角色对应,M3 规范给出映射建议。自定义尺寸组件可按高度估算档位,或传入显式 Shape。圆角半径应与组件尺寸成比例,连续圆角等特殊形状单独定义。
原理流程
按钮/输入框 → shapes.small
卡片/菜单 → shapes.medium
弹窗/大面板 → shapes.large
代码或图示
Card(shape = MaterialTheme.shapes.large) { ... }
常见误区
- 所有组件统一用同一个圆角 dp,大小比例失调。
- 圆角写死在组件内,品牌形状调整无法统一。
追问
- 圆形按钮用什么?答:CircleShape;胶囊形用完全圆角 RoundedCornerShape(50%)。
- 档位半径在哪定义?答:应用 Shapes 主题,全局调整三档值。
07.1.1.7.2-095 主题中排版与形状应如何避免硬编码到业务组件?
一句话结论
业务组件只引用主题 token(typography 角色、shapes 档位、colorScheme 角色),具体数值集中在主题定义;组件参数只做必要的局部覆盖。
概念解释
硬编码 sp、dp 圆角、Color 散落在组件里会让换肤与品牌调整失控。通用样式进入主题,组件内保留少量显式覆盖参数并带默认主题值。审查时关注组件源码中的字面量颜色与尺寸。
原理流程
组件:MaterialTheme.colorScheme.xxx / shapes.medium
→ 主题层:具体数值定义
代码或图示
Text(
text = title,
style = MaterialTheme.typography.titleMedium
)
常见误区
- 为了方便在组件里写
Color(0xFF...)与12.dp。 - 主题 token 命名与业务语义脱节,覆盖时找不到角色。
追问
- 遗留硬编码如何梳理?答:扫描组件中的 Color/dp/sp 字面量,按角色归入主题。
- 局部特殊样式放哪?答:组件参数显式传入,默认值取主题,不写入主题常量。
07.1.1.7.2-096 夜间模式跟随系统与手动覆盖如何实现?
一句话结论
主题模式状态保存用户选择(跟随系统/浅色/深色),优先级高于系统配置;状态提升到应用级,Theme 按选择解析最终 scheme。
概念解释
三态模式:跟随系统、强制浅色、强制深色。选择结果持久化到本地设置,启动时读取;组合层观察模式状态,切换时根 Theme 换 scheme。组件不直接读系统模式做分支。
原理流程
设置状态:Mode.FollowSystem / Light / Dark
→ 解析当前暗色标记
→ 选择 Light/Dark scheme → MaterialTheme
代码或图示
val mode by settings.themeMode.collectAsState()
val dark = when (mode) {
Light -> false; Dark -> true; FollowSystem -> systemDark
}
常见误区
- 手动选择未持久化,重启回到系统跟随。
- 组件内直接判断系统暗色,绕过手动覆盖。
追问
- 状态放哪?答:应用级状态容器/Repository,ViewModel 暴露 Flow;组合层收集。
- 切换时需要保留界面状态吗?答:组合节点保留,只换主题色;RememberSaveable 处理界面状态。
07.1.1.7.2-097 自定义主题属性(如品牌渐变)应如何扩展 ColorScheme?
一句话结论
ColorScheme 只承载颜色角色;渐变、阴影等级等扩展属性自建不可变容器,通过自定义 CompositionLocal 提供,与主题深浅方案配套。
概念解释
渐变由两个以上颜色与方向组成,不是单色角色。扩展数据类持有渐变/派生颜色,浅色深色各一套,Theme 组装时 provide。扩展容器保持不可变,字段为颜色等稳定类型。
原理流程
data class BrandGradient(val start: Color, val end: Color)
val LocalBrandGradient = staticCompositionLocalOf<BrandGradient> { ... }
代码或图示
CompositionLocalProvider(LocalBrandGradient provides gradient) {
App()
}
常见误区
- 试图给 ColorScheme 随意加字段,框架角色固定不可扩展。
- 扩展容器持有可变 List,稳定性与主题更新不可靠。
追问
- 渐变在组件怎么用?答:读取扩展容器构造 Brush,配合 drawWithCache 缓存。
- 深浅扩展如何切换?答:与 scheme 同层按暗色状态选择对应扩展实例。
07.1.1.7.2-098 主题切换时 Compose 状态如何避免重建丢失?
一句话结论
主题切换只替换 token 值,组合树与 remember 状态保留;需要跨配置变更存活的界面状态用 rememberSaveable,业务状态在 ViewModel,不依赖主题实例保存。
概念解释
换主题不应重建整棵组合树:根 Theme 更新 scheme,读取 token 的节点重绘。remember 内存状态在组合保留期间不丢失;配置变更重建时,Saveable 与 ViewModel 负责恢复。不要把状态挂在主题对象实例上。
原理流程
scheme 变化 → 主题 local 更新 → 读取节点重绘
→ 组合树保留 → remember 状态保留
代码或图示
MaterialTheme(colorScheme = newScheme) { RootContent() }
常见误区
- 切换主题时 key 绑定主题对象,导致整树重建、状态清空。
- 把草稿状态存在主题扩展容器里,换主题被替换。
追问
- 如何验证状态保留?答:切换深浅色后检查输入草稿、滚动位置、选中项;配置变更场景走 Saveable 验证。
- 主题实例本身需要 remember 吗?答:scheme 是值对象,组装在主题函数中;状态数据不存其中。
07.1.1.7.2-099 Material 2 与 Material 3 主题在迁移时的主要差异是什么?
一句话结论
M3 颜色角色、排版档位、形状体系与组件样式重新设计,迁移时需逐项映射 M2 角色到 M3 scheme,更新组件库版本并核对深浅对比。
概念解释
M2 颜色角色(primary/secondary 等)语义与 M3 不同,M3 引入 surface 系列与新文本角色;排版档位名称与默认值变化;形状档位映射调整。迁移通常在同一套组件库版本升级下逐步替换,混合使用需边界清晰。
原理流程
M2 theme → 映射颜色/排版/形状到 M3
→ 升级组件依赖 → 逐页面核对样式与对比
代码或图示
M2: colors + typography + shapes
M3: colorScheme + typography + shapes(角色重定义)
常见误区
- 直接复制 M2 色值到 M3 角色,语义错配。
- 组件库版本与主题版本不匹配,样式回退或缺失。
追问
- 能否局部混用 M2/M3 组件?答:技术上可共存,但主题角色与样式可能不一致;长期应统一,边界清单以官方迁移文档为准。
- 迁移版本基线?答:目标 Compose BOM 2024.x 对应 M3 组件库;具体兼容矩阵查官方发布说明(待确认时核对)。
07.1.1.7.2-100 如何在预览中同时验证深浅色与多套主题?
一句话结论
用多个 @Preview 注解分别指定深浅模式、字号与主题包裹,并排预览各方案;预览中检查颜色对比、排版换行与形状一致性。
概念解释
Preview 可配置背景深浅、字号缩放、设备字体;自定义主题在预览内容中包裹 AppTheme 并传入不同 scheme。多套品牌主题用重复预览方法生成。预览不能替代真机走查,复杂布局仍需设备验证。
原理流程
@Preview(uiMode = UI_MODE_NIGHT_YES)
@Preview(uiMode = UI_MODE_NIGHT_NO)
@Composable
fun ThemePreview() { AppTheme(dark = ...) { CardSample() } }
代码或图示
@Preview(fontScale = 1.0f)
@Preview(fontScale = 1.3f)
@Composable
private fun SamplePreview() { AppTheme { Sample() } }
常见误区
- 只预览浅色默认字号,遗漏深色与大字号溢出。
- 预览中绕过自定义 Theme,看到的样式与真机不一致。
追问
- 预览能否验证动态取色?答:动态色依赖系统环境,预览只能模拟静态 scheme;动态行为需真机验证。
- 多设备预览配置什么?答:Preview 参数指定屏幕密度、字号、暗色模式;设备清单按需添加。
参考来源
- Compose 布局与修饰符:Modifier 链、约束与自定义 Layout。
- Compose 自定义绘制:DrawScope、drawBehind、drawWithCache 与图层。
- Compose 动画:animate*AsState、Animatable、Transition 与无限循环动画。
- Material 3 主题(ColorScheme/Typography/Shapes):主题组成、动态取色与深浅色方案。
- Compose 性能:图层与绘制优化:graphicsLayer、离屏渲染与动画性能建议。
待整理清单
- [ ] 核对目标 BOM 版本中 dynamicColorScheme 的系统版本边界与不可用回退 API。
- [ ] 补充 M2 到 M3 颜色角色逐项映射表与组件库兼容版本矩阵。
- [ ] 整理自定义 Shape / GenericShape 的轮廓实现示例。
- [ ] 收集动画在低端机上的掉帧案例与图层优化对照数据。
- [ ] 补充扩展主题 CompositionLocal 的团队约定与预览模板。