这次我们来看一套 Jetpack Compose 声明式 UI 开发的完整中文教程整理。它的价值不在概念多少,而在把环境搭建、基础组件、状态管理、导航、动画和复杂效果处理串成一条完整路线。如果你是一个从传统 XML + View 转向 Compose 的安卓开发者,或者刚接触 Kotlin UI 开发但被版本配置和重组逻辑卡住,这篇文章可以直接收藏。
你将从这篇文章里得到三样东西:一套可以直接照抄的 Compose 工程配置;一条从简单布局到复杂动画效果的验证路径;一份常见报错和性能排查清单。文章里的代码都是常见稳定写法,不依赖某个特定开源包,也不涉及任何付费工具,完整体验从“创建项目”到“效果跑通”的完整流程。
先说读者定位。这套内容适合两类人:一是刚转 Compose 的入门者,需要快速搭出界面并理解状态与重组;二是已经能写简单页面、但想把动画、手势、自定义绘制这些复杂效果处理逻辑梳理清楚的人。如果你完全没写过 Kotlin,建议先用 Android 官方的 Kotlin 语法手册过一遍基本语法,再回来看这篇会有更好的效率。
1. Jetpack Compose 核心能力速览
| 能力项 | 说明 |
|---|---|
| 项目类型 | Android 声明式 UI 开发框架 |
| 官方来源 | Android Jetpack 组件之一,Google 主导开发 |
| 主要功能 | 组件布局、状态管理、列表、导航、主题、动画、手势、自定义绘制 |
| 核心语言 | Kotlin |
| 开发工具 | Android Studio(建议优先使用较新稳定版) |
| 最低系统版本 | 常见的 Compose 版本要求 minSdk 21 或以上,具体以开发时依赖为准 |
| 运行平台 | Android 手机、平板、模拟器;部分能力支持桌面与 Web |
| 启动方式 | Android Studio 创建工程后直接运行 |
| 是否支持 API | 支持,Compose 的 UI 测试通过 createComposeRule() 完成 |
| 是否支持批量任务 | 不直接涉及,但可以结合 Gradle 批量构建多产物 |
| 适合场景 | 新项目 UI、MVVM 架构工程、多端复用 Kotlin 业务逻辑、动画密集型页面 |
从表格可以快速判断:Compose 不是某个第三方库,而是一整套 UI 开发范式。它对开发者最大的影响不只是“换个方式写界面”,而是把状态、布局、绘制和动画统一收进 Kotlin 语法体系。
需要模型API调用? 免费领10W Token,多模型网关一键接入 Claude、DeepSeek 等主流模型。
2. 适用场景与使用边界
2.1 适合什么场景
- 新项目从零开始,避免再维护 XML 布局文件。
- 页面状态变化频繁的场景,例如聊天列表、动态流、实时数据面板。Compose 通过状态驱动 UI 更新,比手动
findViewById后更新控件更直接。 - 动画与手势效果较多的页面,例如卡片翻转、拖拽排序、渐变过渡。
- 团队以 Kotlin 为主,希望减少 View 体系中的样板代码。
- 需要支持深色模式、动态主题或多设备尺寸适配的项目。
2.2 不适合什么场景
- 老旧的巨型项目里已经高度复用了一套自定义 View,逐个迁移成本较高,不建议一次性全面重写。
- 对 Debug 包体积和首次构建速度非常敏感的团队。Compose 工程首次构建比传统 View 项目慢,Debug 包通常更大,需要在发布开启 R8 和资源压缩。
- 完全无 Kotlin 基础、也没有时间补语法的临时任务,建议先补基础再切框架。
2.3 版权、隐私与边界提醒
这套教程如果是“搬运 + 中文讲解”的视频内容,阅读和整理时应尊重原作者版权,学习笔记可以自己记录,但不能把别人录制的课程直接转卖或盗用成自己的商业内容。使用图片、头像、音频等素材时,需要确认有授权;在模拟器或真机验证功能时,也应使用自己的测试数据,避免把用户隐私数据直接写在日志或输出文件中。
3. 环境准备与前置条件
标题里提到的“完整指南”,第一步不是写代码,而是准备环境。Compose 的坑大多集中在版本匹配上。
3.1 基础环境清单
- 操作系统:Windows 10/11、macOS、Linux 均可,Android 开发不受系统强限制。
- 开发工具:Android Studio。尽量用较新稳定版,旧版本可能在创建 Compose 项目时缺少模板。
- JDK:Android Studio 自带 JBR 即可,命令行构建时统一使用
JAVA_HOME指向 Studio 的 JDK 目录。 - Android SDK:在 SDK Manager 中安装对应平台的 SDK Platform,版本以创建项目时的目标 API 为准。
- Kotlin 版本:建议使用 Kotlin 2.0 或更新版本,并配套 compose 编译器插件。
- Gradle:新建项目时使用 Android Studio 推荐的 Gradle 版本,不要手动乱改。
- 模拟器或真机:建议准备一个 Pixel 系列模拟器镜像,或者一台开启开发者模式与 USB 调试的真机。
3.2 版本匹配原则
从现有稳定实践看,Kotlin 2.0 之后,Compose 编译器不再需要单独填写 kotlinCompilerExtensionVersion,而是通过 org.jetbrains.kotlin.plugin.compose 插件解决版本一致性。Kotlin 2.0 之前,需要手动匹配 Kotlin 版本与 Compose 编译器扩展版本。这是一条判断经验:编译报错中说找不到 Compose 编译器时,优先检查 Kotlin 和 Compose 编译器扩展版本是否匹配,而不是先怀疑代码写错。
3.3 磁盘和端口
Compose 工程依赖较多,首次 Gradle 同步会下载依赖,建议预留至少 5GB 磁盘空间。Android Studio 中的 ADB 服务默认端口是 5037,模拟器控制台端口一般是 5554、5555,如果这些端口被占用,模拟器可能无法启动。启动模拟器或真机调试时,先确认没有其他 ADB 进程卡住。
4. 创建与配置一个 Compose 工程
4.1 创建项目
打开 Android Studio,选择 New Project,模板选择 Empty Activity。这里要注意:模板里如果生成的是 MainActivity、build.gradle.kts 和 ui/theme 目录,说明当前 Studio 已经集成 Compose 模板。直接保留默认工程结构即可。
4.2 Gradle 配置示例
下面是 Kotlin 2.0 时代常见的工程配置写法,以应用模块的 build.gradle.kts 为例:
kotlin复制plugins {
id("com.android.application")
id("org.jetbrains.kotlin.android")
id("org.jetbrains.kotlin.plugin.compose")
}
android {
namespace = "com.example.composedemo"
compileSdk = 34
defaultConfig {
applicationId = "com.example.composedemo"
minSdk = 24
targetSdk = 34
versionCode = 1
versionName = "1.0"
}
buildFeatures {
compose = true
}
compileOptions {
sourceCompatibility = JavaVersion.VERSION_17
targetCompatibility = JavaVersion.VERSION_17
}
}
dependencies {
val composeBom = platform("androidx.compose:compose-bom:2024.06.00")
implementation(composeBom)
implementation("androidx.core:core-ktx:1.13.1")
implementation("androidx.lifecycle:lifecycle-runtime-ktx:2.8.3")
implementation("androidx.activity:activity-compose:1.9.0")
implementation("androidx.compose.ui:ui")
implementation("androidx.compose.ui:ui-graphics")
implementation("androidx.compose.ui:ui-tooling-preview")
implementation("androidx.compose.material3:material3")
debugImplementation("androidx.compose.ui:ui-tooling")
debugImplementation("androidx.compose.ui:ui-test-manifest")
}
如果你打开的是使用 Kotlin 2.0 之前的旧模板,则可能在 android 块内看到类似下面的配置:
kotlin复制composeOptions {
kotlinCompilerExtensionVersion = "1.5.10"
}
这个写法在 Kotlin 2.0 后不再需要。判断方法很简单:项目插件里是否加了 org.jetbrains.kotlin.plugin.compose。加了,就删掉 composeOptions;没加,就保留并确保版本匹配。上面给出的版本号是示例,实际操作时要改成当前渠道可获取的稳定版本。
4.3 入口代码与预览
项目中默认生成的 MainActivity 会调用 setContent,这是 Compose 的声明式入口,不需要再 setContentView(R.layout.activity_main)。
kotlin复制class MainActivity : ComponentActivity() {
override fun onCreate(savedInstanceState: Bundle?) {
super.onCreate(savedInstanceState)
setContent {
ComposeDemoTheme {
Greeting(name = "Jetpack Compose")
}
}
}
}
@Composable
fun Greeting(name: String) {
var count by remember { mutableStateOf(0) }
Column(
modifier = Modifier
.fillMaxWidth()
.padding(16.dp),
horizontalAlignment = Alignment.CenterHorizontally
) {
Text(text = "Hello $name")
Button(onClick = { count++ }) {
Text(text = "点击了 $count 次")
}
}
}
@Preview(showBackground = true)
@Composable
fun GreetingPreview() {
ComposeDemoTheme {
Greeting(name = "Preview")
}
}
点击 Android Studio 右上角的 Split 或 Design 预览面板,可以看到这段代码直接渲染出界面。预览不会启动模拟器,适合开发组件时快速迭代。如果预览不显示,常见原因是 ui-tooling-preview 依赖缺失,或者某个 Composable 使用了不支持的资源类型,例如 Context 相关调用。
5. 声明式 UI 与 View 体系的差异
理解 Compose 的一个重要突破口是“声明式”三个字。传统 View 体系下,你写 findViewById、setOnClickListener、setText,每一步都告诉系统怎么操作控件。Compose 不一样:你描述的是“界面应该长什么样”,状态变化后,框架自动处理哪些区域需要重新绘制。
这个差异带来两个直接影响。第一,代码量减少,尤其是列表和动态更新场景,不再需要 notifyDataSetChanged 这类手动刷新逻辑。第二,状态作用域变清晰,一个 Composable 函数里用 remember 或外部 ViewModel 持有的状态,比在 Fragment 和 Activity 之间传来传去更直观。
注意一个问题:Compose 的“重组”不是整个页面重新跑一遍。它只会重新执行那些读取了变化状态的 Composable 函数块,框架层面有跳过机制。初学者最容易踩的坑,是看到一个页面刷新排布紊乱,就以为需要手动调 requestLayout。实际上这类问题通常来自状态提升位置放错,或者是列表中项 key 使用不当,导致复用时的局部状态错乱。
6. 核心概念与完整指南路线
这套“完整指南”可以按下面路线分步过关。每一块都独立可测,把前一块跑通后再进入下一块,整体可控。
6.1 基础组件与布局
先熟悉五类基础组件:文本、按钮、图片、输入框、容器。常用容器是 Column、Row、Box,分别对应竖直排列、水平排列和堆叠布局。
Modifier 是 Compose 中最值得投入时间学习的部分。它是一串链式调用的描述符,顺序会影响最终布局效果。例如:
kotlin复制Modifier
.fillMaxWidth()
.padding(16.dp)
.background(Color.Gray)
.clickable { /* 点击事件 */ }
这段代码中,padding 写在 background 前,背景会被 padding 撑开;交换顺序后,背景会先占据整个宽度,再向内部缩进,视觉效果完全不同。做界面时,遇到某个组件位置不符合预期,先把 Modifier 顺序检查一遍,很多时候比改边距更快。
6.2 状态管理与重组
状态管理是 Compose 和 View 体系差异最大的区域。从一个简单计数器开始:
kotlin复制@Composable
fun CounterScreen() {
var count by remember { mutableStateOf(0) }
Text(text = "当前计数:$count")
Button(onClick = { count++ }) {
Text("增加")
}
}
remember { mutableStateOf(0) } 创建了一个 Compose 可观察状态,count 每次变化,读取它的 Text 就会重组。这里要注意:
remember只在当前组合位置存活,Activity 重建或配置变更时会丢失。- 需要跨配置变更存活时,使用
rememberSaveable。 - 状态需要被多个 Composable 共享时,执行“状态提升”,把状态提升到它们共同的父级,用参数传入,用回调通知修改。
by需要导入androidx.compose.runtime.getValue和androidx.compose.runtime.setValue。
适合把状态提升到 ViewModel 的场景,直接用 collectAsState() 或 collectAsStateWithLifecycle() 收集数据流。collectAsStateWithLifecycle 在生命周期感知方面更稳,推荐在正式工程里使用。
6.3 列表与滚动
长列表用 LazyColumn 和 LazyRow。它们只会组合当前可见的项,和传统 RecyclerView 类似,但 API 简洁得多。
kotlin复制@Composable
fun MessageList(items: List<String>) {
LazyColumn(
modifier = Modifier.fillMaxSize(),
contentPadding = PaddingValues(16.dp),
verticalArrangement = Arrangement.spacedBy(8.dp)
) {
items(items, key = { it }) { message ->
Card {
Text(
text = message,
modifier = Modifier
.fillMaxWidth()
.padding(16.dp)
)
}
}
}
}
这里给 items 传入 key,是为了帮助 Compose 在数据增删时正确跟踪每一项。如果不传 key,系统会使用项的位置作为标识;列表需要保持局部状态时,缺失 key 会导致状态错位。数据量大时,还应该配合 derivedStateOf 只统计可见区域变化,避免每次数据变化都做全局计算。
6.4 导航
页面跳转在 Compose 中优先使用 Navigation Compose。在 build.gradle.kts 中增加:
kotlin复制implementation("androidx.navigation:navigation-compose:2.7.7")
然后定义导航图:
kotlin复制@Composable
fun AppNavHost() {
val navController = rememberNavController()
NavHost(
navController = navController,
startDestination = "home"
) {
composable("home") {
HomeScreen(
onNavigateToDetail = {
navController.navigate("detail")
}
)
}
composable("detail") {
DetailScreen()
}
}
}
传参会常见两种方式:直接在 route 里拼路径参数,或者使用类型安全的序列化 route。更推荐在进入正式架构时用 navigation 2.8 及以上版本的 Type-Safe Navigation,通过自定义 Route 类替代字符串拼参数,能减少运行时类型错误。导航返回、深色模式切换、底部栏隐藏这些场景,和 Navigation 的 BackStack 配合时,要考虑 popBackStack 和 launchSingleTop 的使用。
6.5 主题与深色模式
默认模板会生成一个 ui/theme 包,包含 Color.kt、Type.kt、Theme.kt。Material3 下建议优先使用 ColorScheme 而不是旧的 Colors。
kotlin复制MaterialTheme(
colorScheme = if (isSystemInDarkTheme()) darkColorScheme() else lightColorScheme(),
typography = Typography(),
content = { /* 页面内容 */ }
)
多设备适配时,可以查看窗口尺寸类别,在不同折叠状态或平板上调整 Column 与 Row 的方向。不要把屏幕宽度写死成 dp,改用 BoxWithConstraints 获取约束后做可变布局。
6.6 生命周期与协程
Compose 里的生命周期不是 Activity 的 onPause,而是组合的生命周期。常用工具:
LaunchedEffect:进入组合时启动协程,适合做一次性请求或延时。DisposableEffect:离开组合时清理资源,适合注册监听器、取消网络请求。rememberCoroutineScope:获取一个和组合范围绑定的协程作用域,适合在按钮点击时启动协程。
kotlin复制@Composable
fun TimerScreen() {
val scope = rememberCoroutineScope()
var time by remember { mutableStateOf(0) }
LaunchedEffect(Unit) {
while (true) {
delay(1000)
time++
}
}
Text(text = "计时:$time 秒")
}
6.7 动画与复杂效果处理
这是标题里“效果处理程序”最重要的部分。Compose 的动画 API 基本覆盖了显式动画、隐式动画和无限动画三类。
单个属性变化,使用 animateFloatAsState:
kotlin复制var expanded by remember { mutableStateOf(false) }
val angle by animateFloatAsState(
targetValue = if (expanded) 180f else 0f,
animationSpec = tween(300)
)
Image(
painter = painterResource(id = R.drawable.ic_arrow),
contentDescription = null,
modifier = Modifier
.rotate(angle)
.clickable { expanded = !expanded }
)
多属性同时变化,使用 animate*AsState 系列组合起来即可。更加灵活的显式控制可以使用 Animatable:
kotlin复制val scale = remember { Animatable(1f) }
scope.launch {
scale.animateTo(1.5f, tween(200))
scale.animateTo(1f, tween(200))
}
列表项增删动效,在不同版本里 API 有变化。较新版本使用 Modifier.animateItem(),旧版本使用 animateItemPlacement()。如果你用的是较新的依赖,遇到 animateItemPlacement 找不到,直接改成 animateItem 即可。
手势处理也用 Modifier 链实现:
kotlin复制Modifier.pointerInput(Unit) {
detectTapGestures(
onDoubleTap = { /* 双击 */ },
onLongPress = { /* 长按 */ }
)
}
更多复杂效果,例如水波纹、拖拽排序、自定义 Canvas 绘制,都建立在 Modifier 链和 draw 阶段之上。自制卡片翻转效果时,综合使用 GraphicsLayer 的 rotationY、cameraDistance 和 animateFloatAsState 即可完成,不需要引入额外第三方库。
6.8 自定义绘制
Canvas 和 Modifier.drawWithContent 是自定义绘制的两大入口。普通图形直接用 Canvas:
kotlin复制Canvas(modifier = Modifier.size(100.dp)) {
val gradientBrush = Brush.linearGradient(
colors = listOf(Color.Red, Color.Blue)
)
drawCircle(brush = gradientBrush, radius = size.minDimension / 2)
}
从教程路线看,完成前 6 个小节的验证后,Android 端 UI 开发已经能覆盖 90% 的常规业务场景。再加上 6.7 和 6.8 的动画和绘制能力,就具备做复杂交互页面的基础。
7. 功能测试与效果验证
7.1 预览测试
使用 @Preview 可以让 Composable 不启动模拟器直出渲染效果。预览时建议控制参数,比如传入一份固定测试数据,而不是从网络请求里拿数据。遇到预览无法加载时,检查 ui-tooling-preview 依赖,并尽量让预览内容不依赖 context.resources 之外的运行时对象。
7.2 真机与模拟器验证
页面基本跑通后,上真机验证指路手势、返回键和输入法弹出行为。模拟器上触摸手感不完全等同真机,但用于验证布局和动画足够。验证流程建议:
- 冷启动应用,记录从点击图标到首页可点的时间。
- 连续点击计数按钮,观察界面刷新是否流畅。
- 旋转屏幕,检查状态是否因为
rememberSaveable和 ViewModel 而正常保留。 - 进入列表页快速滑动,用 Android Studio 的 Layout Inspector 观察重组范围。
- 切换深色模式,确认主题色没有硬编码不跟随的情况。
7.3 UI 自动化测试
Compose 提供了配套 UI 测试 API。下面是一个简单的计数测试:
kotlin复制import androidx.compose.ui.test.junit4.createComposeRule
import androidx.compose.ui.test.onNodeWithText
import androidx.compose.ui.test.performClick
import org.junit.Rule
import org.junit.Test
class CounterTest {
@get:Rule
val composeTestRule = createComposeRule()
@Test
fun clickButton_increasesCount() {
composeTestRule.setContent {
CounterScreen()
}
composeTestRule.onNodeWithText("点击了 0 次").assertExists()
composeTestRule.onNodeWithText("增加").performClick()
composeTestRule.onNodeWithText("点击了 1 次").assertExists()
}
}
运行时确保 debugImplementation("androidx.compose.ui:ui-test-manifest") 已加入,否则测试可能找不到宿主 Activity。测试只关注结果:点击一次后文本变化,而不去关心内部怎么按顺序调用函数,这也是声明式 UI 对可测试性的一个改善。
8. 资源占用与性能观察
Compose 的性能问题和传统 View 不同,它关心的不是布局层级太多,而是重组频率过高、状态读取范围过大、列表项创建成本过高等问题。
8.1 观察重组
使用 Layout Inspector 系工具查看重组范围。打开 Android Studio,Debug 模式运行应用,在 Layout Inspector 的 Compose 面板里可以看到哪些 Composable 在当前帧被重组。这比靠感觉猜效率高。
检查重点:
- 点击某个按钮后,是只有目标 Composable 重组,还是一整块页面所有组件都重组。
- 滚动列表时,不可见项是否也发起了重组。
- 动画执行期间,是否有不必要的状态读取。
8.2 常见优化手段
- 状态尽量下放。只给真正需要读取状态的 Composable 传值。
- 使用
derivedStateOf。例如列表滚动到底部才显示悬浮按钮,尽量计算布尔值变化,而不是每次滚动都更新整个集合。 - 使用
remember保存耗时结果,避免每次重组都重新执行相同计算。 - 大图标用
painterResource支持懒加载,减少解码耗时。 - 列表中的 Composable 尽量保持稳定,参数对象做好 equals 逻辑。
- 发布包开 R8 和资源压缩,减少 Debug 依赖带来的体积膨胀。
- 对冷启动敏感的应用,可以生成 Baseline Profile 配置文件,减少首次启动解释执行的开销。
8.3 Debug 与 Release 的差异
Debug 模式下运行性能差异很大,因为 Compose 会额外渲染组合跟踪信息。如果在模拟器里发现动画不流畅,先用真机 Release 包验证。不要直接在 Debug 包上给项目性能下结论。这也是“搬运”类教程里容易遗漏的细节,但放到真实项目里非常关键。
9. 常见问题与排查方法
| 问题现象 | 可能原因 | 排查方式 | 解决方案 |
|---|---|---|---|
| 预览面板显示空白 | 缺少 ui-tooling-preview 依赖 |
检查 build.gradle.kts dependencies |
添加 debugImplementation 与 preview 依赖,并点击 Refresh Preview |
编译报错 Compose compiler 相关 |
Kotlin 版本与 Compose 编译器插件不匹配 | 查看 Kotlin 插件与 composeOptions 配置 |
使用 Kotlin 2.0 并添加 org.jetbrains.kotlin.plugin.compose 插件,或匹配旧版扩展版本 |
找不到 MaterialTheme |
缺少 Material3 依赖 | 检查 import 与依赖 | 添加 implementation("androidx.compose.material3:material3") |
rememberSaveable 报错 |
保存的类型不可用 | 查看测试是否使用自定义 Parcelable | 改存 String、Int 或使用自定义 Saver |
| 页面状态重建后丢失 | 使用 remember 而非 rememberSaveable |
旋转屏幕测试 | 把需要保存的状态改为 rememberSaveable,重要数据放到 ViewModel |
| 列表快速滑动状态错乱 | 没有传 key 或 key 不稳定 |
检查 items 方法参数 |
给 items 传入稳定且唯一的 key |
| 导航点击无反应 | 路由字符串不一致或 NavHost 未包住页面 | 检查 startDestination 和 navigate 路径 |
统一 route 命名,注意大小写 |
| 动画结束位置不对 | 状态布尔值取反时机错误 | 打印状态值变动 | 检查 targetValue 的表达式逻辑 |
| 首次 Gradle 同步长时间卡住 | 依赖下载慢或网络不通 | 查看 Gradle 日志 | 使用可访问的镜像仓库,或等待同步完成后重启 IDE |
| 模拟器启动失败 | 端口被占用或磁盘空间不足 | 检查 5554/5555/5037 端口 | 释放端口或更换模拟器镜像,重启 ADB |
| Debug 包很卡 | 组合跟踪性能开销 | 切 Release 包验证 | 使用真机 Release 包观察,优化重组范围 |
排查时有一个通用原则:先看编译期报错,再看运行期崩溃,最后看 UI 表现。很多 Compose 问题会在编译期因为版本不匹配直接暴露,先把版本统一,再讨论业务逻辑。
10. 最佳实践与学习建议
10.1 工程结构建议
不要把所有 Composable 写在一个文件里。按功能拆包:
code复制com.example.project/
MainActivity.kt
data/ // 数据模型与仓库
ui/theme/ // Color, Type, Theme
ui/components/ // 通用组件
ui/screens/ // 页面级 Composable
ui/navigation/ // 导航图定义
页面级 Composable 尽量只做布局和状态绑定,不在 Composable 里写网络请求和文件读写。网络请求进 ViewModel,Composable 只负责展示状态和分发事件,这样写出来的代码更利于后续维护和测试。
10.2 分层与状态提升
状态提升遵循“谁使用,谁持有,谁的父级更大谁提升”。一个 TextField 的输入值,通常由页面级 Composable 持有,因为提交按钮也可能要读这个值。一个只在子级内部生效的开合状态,可以留在子级内部,不必一路提升到顶层。是否提升的判断标准:有没有多个子级同时读取和改写这个状态。如果没有,留在原地即可。
10.3 跟随教程的学习顺序
如果是一套从零到一的中文讲解,我建议按下面顺序执行,不跳步:
- 搭建工程,跑通 Greeting。
- 写一个注册页:输入框、按钮、校验提示、键盘处理。
- 写一个列表页:数据列表、下拉刷新、点击条目进入详情。
- 给详情页加入转场动画。
- 用 ViewModel 替换本地状态。
- 最后实验自定义 Canvas 和手势效果。
前四步完成,声明式 UI 的核心使用场景基本覆盖。第五步补架构能力。第六步属于扩展,可以做也可以后置。
10.4 合规与工程化红线
- 文章中或工程里使用的示例图片、音频、人脸素材,必须来自可商用源或自行制作。
- 记录教程和整理笔记时,如果后续要公开发布或制作付费内容,需要获取原作者的明确授权。
- Android 上请求相机、文件读写、媒体访问等敏感权限时,必须在应用内完整说明用途,并在测试环境验证授权流程。
- 不要把测试用的真实用户数据库直接提交到 Git 仓库,尤其是账号、手机号、设备标识这类信息。
对 Compose 本身来说,没有太多“安全边界”类的技术隐患;真正的风险集中在素材授权、数据隐私和打包发布环节。
11. 总结与下一步
这套 Jetpack Compose 完整指南,值得先做的事非常简单:今天就在 Android Studio 里建一个新项目,把第 4 节的一段代码跑起来。然后按顺序补上状态、列表、导航、动画,每一步都能独立验证,整个过程不需要外部服务器,也不需要额外硬件。
最容易踩的坑是版本配置。只要记住 Kotlin 2.0 后用 org.jetbrains.kotlin.plugin.compose,旧项目才需要维护 composeOptions,大部分编译问题都能解决。运行期遇到卡顿,先切 Release 真机再判断,不要被 Debug 包带偏。
下一步建议直接接入 Navigation Compose 和 ViewModel,把一个单页面 Demo 扩展成三到五个页面的完整应用。这篇内容相当于一条主线,后面根据业务需要再补 Hilt、Room、DataStore 和网络层即可。把声明式 UI 这条主线先打通,后续所有 Jetpack 生态组件都能往里面挂。
