1. 简介
本文档的 PDF 版本在 这里。
本文档的代码在 这里。
本文档由 Anthropic 的 Claude AI 生成。它改编自课程 “Flutter 移动框架分步入门”,包括其大纲、25 个示例、服务器和案例研究,并更换了所使用的工具:
- 在 [Flutter] 课程中,应用使用 [Dart] 编写,所用框架自行绘制屏幕上的每一个像素,同一份代码可生成 [Android] 应用、[iOS] 应用,或 Web 应用;
- 在本课程中,应用是一个 [Android] 原生应用,使用 [Kotlin] (自 2019 年起 Google 推荐用于 Android 的语言)编写,并使用 [Jetpack Compose],即 Android 的声明式 UI 库。
不过,服务器保持不变:它仍是用 [RdvMedecins] JSON 服务器,使用 [NestJS] 编写,已被 React、Vue.js、Angular 和 Flutter 客户端使用过。而各个界面也是这些课程的读者所熟悉的:带验证码的登录、医生日程、预约窗口、患者门户、医生和客户管理、账户创建,以及法语和英语支持。
这 25 个示例的编号与 [Flutter] 课程(以及 React、Vue.js 和 Angular 课程)相同:熟悉其中任何一个框架的读者都能在相应的位置找到每个概念。当 [Flutter] 的某个概念在 [Compose] 中没有直接对应物时,示例会演示 [Android] 中采用的做法(用普通类编写的表单、用 [strings.xml] 资源存放文本、用深层链接取代网址等)。
关于这个主题已有一门课程:客户端/服务器示例——Kotlin Android / NestJS(2026),它从一开始就给出完整的客户端。本文档的方法有所不同:我们先通过小示例分步学习 [Compose] ,再着手完整的客户端;服务器被视为黑盒,我们只关心它的 API 和 JSON。
默认读者已掌握 [Kotlin] 语言的基础知识(类、数据类、可空性、lambda、扩展函数、集合):这些内容在 Kotlin 课程中讲述。与 [Compose] 特别相关的语言特性(函数作为参数、尾随 lambda、[by] 委托、密封接口、协程)将在示例中用到时逐一回顾。
Claude 编写了全部代码,编译了它,并在获得审阅者许可的情况下,在审阅者电脑上的 [Android] 模拟器上运行了它;截图是在这些运行过程中拍摄的。
1.1. Android 和 Compose 在客户端/服务器应用中的角色
该应用由两部分组成,它们之间只通过 HTTP 请求通信:

- 1:运行在手机上的 [Android] 应用向服务器发送 HTTP 请求,例如 [GET /api/schedule?doctorId=1&day=2026-10-05];
- 2:服务器返回 JSON 数据:该医生在那一天的日程。服务器不生成任何页面;
- 3:[Compose] 利用这些数据更新手机的屏幕。
这正是 [React]、[Vue.js]、[Angular] 和 [Flutter] 客户端的架构:唯一的区别在于由什么来生成显示内容。[Jetpack Compose] 基于与 [React] 和 [Flutter] 相同的概念:
- 屏幕由函数来描述:带 [@Composable] 注解的函数通过调用其他 [@Composable] 函数来描述界面的一部分(文本、按钮、列、整个屏幕),它们构成一棵树;
- 界面是状态的函数:当某个被观察的数据(“状态”,[mutableStateOf])发生变化时,[Compose] 会重新执行读取它的函数(这就是重组),并更新屏幕。我们从不编写修改屏幕的代码:我们把屏幕描述为状态的函数;
- 一门现代语言 [Kotlin],编译后运行在 [Android] 的虚拟机上:它的 lambda、扩展函数和协程使这种写法十分自然。
与 [Flutter] 不同,[Compose] 专用于 [Android] (存在适用于其他平台的变体 [Compose Multiplatform],但本课程不涉及)。另一方面,该应用是一个“普通的” [Android] 应用:它直接使用 Google 的库([Jetpack])和系统服务(应用语言、Activity 生命周期、密码管理器等)。
与 [Flutter] 一样,[Compose] 并不是一个用于与服务器通信的“一体化”框架:HTTP 客户端、导航和共享状态都由库来提供。本课程使用 Google 推荐的库([Jetpack]:Navigation、ViewModel、DataStore、AppCompat)以及 [Kotlin] 生态中使用最广泛的库([OkHttp]、[kotlinx.serialization])。
1.2. 所用工具
这些示例是使用下列工具编写和测试的:
- [Android Studio] (Quail 版本 2026.1),Google 的开发环境:编辑器、[Android] SDK、模拟器。它自带 JDK([JBR] 25),用于运行 [Gradle];
- [Gradle] 9.6 以及 [Android] Gradle 插件(AGP)9.4,用于编译应用。[Android] 9 插件本身已内置对 [Kotlin] 2.2 的支持;
- 一个 [Android] 模拟器(Pixel 8,[Android] 17,API 37),或一部连接到电脑的真实 [Android] 手机;
- 数据库管理系统 [MySQL] (或 [MariaDB]),例如 [Laragon] 在 [Windows] 下附带的那个,以及 [Node.js]:从介绍 JSON 服务器的章节开始,运行该服务器需要它们;
- 命令行工具 [curl],用于显示原始的 HTTP 响应。
每个项目使用的库都声明在 [gradle/libs.versions.toml] 文件中:"BOM"、[Compose] 2026.02(Material 3)、[Navigation Compose] 2.9、[Lifecycle] 2.9(ViewModel)、[DataStore] 1.1、[AppCompat] 1.7、[OkHttp] 4.12、[kotlinx.serialization] 1.9、[AndroidSVG] 1.4。
1.3. 截图
本文档中的截图是通过“插桩”测试(项目文件夹 [app/src/androidTest])自动生成的:这些测试在模拟器上运行,启动每个示例,像用户一样与之交互(输入文本、点击按钮),然后截取整个屏幕。状态栏中的时钟固定在 10:00([Android] 的“演示模式”)。
1.4. 示例
本文档中的代码分为三个文件夹:
这些示例构成一个单一的 [Android Studio] 项目和一个单一的 [Android] 应用:每个示例是一个 Activity(一个屏幕),存放在各自的包中([fr.stahe.examples.ex01]、[fr.stahe.examples.ex02]……),并有一个菜单(即启动 Activity)可让你启动所有示例:
在 [Android Studio] 中打开 [examples_kotlin] 文件夹([File / Open]);[Gradle] 随后会下载所需的库。使用 [Run] 按钮(绿色三角形)启动应用:菜单出现,每一行打开一个示例。你也可以在控制台中使用 SDK [Android] 中的 [adb] 工具直接启动某个示例:
示例 22 到 25 会查询 JSON [RdvMedecins] 服务器:你需要按照专门章节的说明安装并运行它。
1.5. 文档内容
- 入门(示例 01 到 09):一个 Activity、[@Composable] 函数、状态([remember]、[mutableStateOf])、事件、输入框、reducer、验证、可复用表单、格式化;
- 组件(10 到 16):参数、带参数的函数、组合(参数中的内容)、生命周期和副作用、[CompositionLocal]、可复用的行为(动画、[remember...] 函数)、确认窗口;
- 导航(17 和 18):[Navigation Compose]、类型化路由、参数、深层链接、守卫;
- 异步操作与共享状态(19 和 20):协程、[Flow]、防抖、过期响应、[ViewModel]、[DataStore];
- 国际化(21):资源 [strings.xml]、复数、应用语言;
- 服务器,一个黑盒:安装 JSON 服务器、它的 API、[curl] 示例;
- 与服务器通信(22–25):[OkHttp]、服务器地址、令牌 Cookie、API 访问层、视图模型、服务器错误;
- 案例研究:[Android] 版 [RdvMedecins] 应用客户端;
- 部署:已签名的应用(APK)、生产服务器。
每个示例都附有完整的带注释代码及其运行截图。代码本身有大量注释:这些注释是课程的一部分。