Android 移动端设计
精通 Material Design 3(Material You)和 Jetpack Compose,构建现代、自适应、与 Android 生态系统无缝集成的 Android 应用。
何时使用此技能
- 按照 Material Design 3 设计 Android 应用界面
- 构建 Jetpack Compose UI 和布局
- 实现 Android 导航模式(Navigation Compose)
- 为手机、平板和折叠屏创建自适应布局
- 使用 Material 3 主题和动态颜色
- 构建无障碍 Android 界面
- 实现 Android 特定手势和交互
- 设计适配不同屏幕配置的界面
详细章节:核心概念
原 SKILL.md 中 9201 字节的章节已移至 references/details.md,以适应 Codex 的 8 KB 技能主体大小限制。
快速开始组件
@Composable
fun ItemListCard(
item: Item,
onItemClick: () -> Unit,
modifier: Modifier = Modifier
) {
Card(
onClick = onItemClick,
modifier = modifier.fillMaxWidth(),
shape = RoundedCornerShape(12.dp)
) {
Row(
modifier = Modifier
.padding(16.dp)
.fillMaxWidth(),
verticalAlignment = Alignment.CenterVertically
) {
Box(
modifier = Modifier
.size(48.dp)
.clip(CircleShape)
.background(MaterialTheme.colorScheme.primaryContainer),
contentAlignment = Alignment.Center
) {
Icon(
imageVector = Icons.Default.Star,
contentDescription = null,
tint = MaterialTheme.colorScheme.onPrimaryContainer
)
}
Spacer(modifier = Modifier.width(16.dp))
Column(modifier = Modifier.weight(1f)) {
Text(
text = item.title,
style = MaterialTheme.typography.titleMedium
)
Text(
text = item.subtitle,
style = MaterialTheme.typography.bodyMedium,
color = MaterialTheme.colorScheme.onSurfaceVariant
)
}
Icon(
imageVector = Icons.Default.ChevronRight,
contentDescription = null,
tint = MaterialTheme.colorScheme.onSurfaceVariant
)
}
}
}
最佳实践
- 使用 Material 主题:通过
MaterialTheme.colorScheme获取颜色以自动支持深色模式 - 支持动态颜色:在 Android 12+ 上启用动态颜色以实现个性化
- 自适应布局:使用
WindowSizeClass实现响应式设计 - 内容描述:为所有交互元素添加
contentDescription - 触摸目标:无障碍触摸目标的最小尺寸为 48dp
- 状态提升:提升状态以使组件可重用和可测试
- 正确使用
remember:恰当使用remember和rememberSaveable - 预览注解:添加
@Preview并配置不同参数
常见问题
- 重组问题:避免传递不稳定的 lambda;使用
remember - 状态丢失:使用
rememberSaveable处理配置变更 - 性能问题:长列表使用
LazyColumn代替Column - 主题泄漏:确保
MaterialTheme包裹所有可组合项 - 导航崩溃:正确处理返回按钮和深层链接
- 内存泄漏:在
DisposableEffect中取消协程