4. 第 3 章 - Android 和 Jetpack Compose 简介
4.1. 资料来源
官方文档:https://developer.android.com——尤其是“Jetpack Compose”(https://developer.android.com/compose)、“Thinking in Compose”、“State and Jetpack Compose”、“Introduction to Activities”和“ViewModel Overview”等页面。Kotlin 协程:https://kotlinlang.org/docs/coroutines-overview.html
4.2. 什么是 Android 应用?
Android 应用是一个 .apk 文件(Play 商店使用 .aab),其中包含编译后的代码、资源(图标、文本、图像)和一份清单([AndroidManifest.xml])——它是应用面向系统的“身份证”:包含其标识符、所请求的权限(网络访问等)以及其屏幕列表。
这些屏幕被称为“Activity”([Activity])。Activity 不是由程序本身创建的:而是由系统在用户点按应用图标时创建,然后在其整个生命周期中调用它的方法:创建时调用 [onCreate(...)] ,转入后台时调用 [onPause()] ,销毁时调用 [onDestroy()] ……因此,Android 应用中没有 [main()] 函数——这是与 Flutter 客户端中 [void main()] 的第一个区别。这一生命周期带来了一个重要的后果,下文将详细说明:屏幕旋转会销毁并重新创建 Activity。
Kotlin 代码被编译为 Java 字节码,然后转换为 DEX 格式,并由 Android 虚拟机 [ART] (Android Runtime)执行,ART 会在安装时和运行期间再将其编译为机器码。这里没有 JavaScript 或 [WebView] 引擎:它是一个原生应用,与手机上预装的应用一样。与 Flutter 一样,Jetpack Compose 自行渲染其组件(按钮、输入框等),而不是使用传统的 Android UI 组件([View])——但它使用的是 Android 自带的 UI 库,而不是像 Flutter 那样使用应用内置的渲染引擎。
与 Flutter 不同,这个客户端只面向 Android:同一份代码不会生成 iOS、桌面或 Web 应用。第 5 章说明了要做到这一点需要什么(Kotlin Multiplatform 和 Compose Multiplatform)。
4.3. Compose 开发模型:一切皆函数
在 Jetpack Compose 中,UI 由带有 @Composable 注解的 Kotlin 函数描述。@Composable 函数不返回任何东西:它通过调用其他 @Composable 函数来发出(EMIT)界面——[Text(...)]、[Button(...)]、[Column(...)]……完整的界面就是这些嵌套调用所构成的树。
这与 Flutter 是同一种声明式模型(“界面是状态的函数”),只有一个形式上的区别:Flutter 用一个类([Widget])来描述每个元素,其 [build(...)] 方法返回一棵对象树,而 Compose 只使用函数。Compose 编译插件会对这些函数进行转换,使它们在所读取的状态发生变化时可以被选择性地重新执行:这称为“重组”。
外观和布局设置(边距、大小、对齐方式、背景色、点击等)不是树中的元素,不像 Flutter 的 [Padding] 或 [Center] 组件,而是“修饰符”(modifier),它们被链式连接并作为参数传递:[Modifier.padding(16.dp).fillMaxWidth()]。单位 [dp] (与密度无关的像素)相当于 Flutter 的逻辑像素:无论屏幕的实际密度如何,1 dp 都对应于分辨率为每英寸 160 点的屏幕上的一个像素。
4.4. 状态与重组:既没有 StatefulWidget,也没有 setState
Flutter 在声明类时就要区分 [StatelessWidget] 和与其 [StatefulWidget] 关联的 [State] 类,并且需要调用 [setState(() { ... })] 才能让状态变化显示出来。Compose 完全不需要这些:
- 局部变量直接在函数内部声明:[var clicks by remember { mutableStateOf(0) }];
- [mutableStateOf(...)] 创建一个可观察状态:Compose 会自动登记每个读取(READ)它的 @Composable 函数,并在值发生变化时重新执行(“重组”)这些函数——而且只重新执行这些函数。变化之后无需调用任何东西:只需 [clicks++] 即可。这与 Vue.js 中 [ref(...)]/[reactive(...)] 的工作方式相同,而不是 [setState(...)] 的工作方式;
- [remember { ... }] 在函数的多次执行之间保存一个值。没有它,每次调用时状态都会被重新创建,并重置为零;
- [rememberSaveable { ... }] 做同样的事情,并且另外在 Activity 被销毁再重建时(屏幕旋转;见下文)保留该值;
- 关键字 [by] (属性委托;参见 Kotlin 课程)使您可以写 [clicks] 而不是 [clicks.value]。
同样的机制也适用于共享状态:一个普通类,其属性声明为 [by mutableStateOf(...)] ,则所有读取这些属性的函数都会自动观察到它。客户端的服务就是这样编写的([SettingsService]、[AuthService]、[TranslationsService];见第 4 章):Flutter 版本需要继承 [ChangeNotifier] 并在每次修改后手动调用 [notifyListeners()] ,而这里无需任何通知。
4.5. 共享状态:CompositionLocal,相当于 provider
为了让一个服务对整棵 @Composable 函数树可用,而不必逐层作为参数传递,Compose 提供了 [CompositionLocal]:先声明一个“键”([val LocalAuth = staticCompositionLocalOf<AuthService> { ... }]),在树的顶部为其赋值([CompositionLocalProvider(LocalAuth provides auth) { ... }]),然后任何后代函数都可以用 [LocalAuth.current] 读取(READ)它。这正是 Flutter 版本中 [provider] 包([MultiProvider] / [context.read<...>()])、Vue.js 中 [provide]/[inject] 或 React 的 [Context] 所起的作用。Compose 不需要与 [context.watch<...>()] 对应的东西:变化订阅由可观察状态本身处理。
4.6. 没有模板语言:条件与列表
与 Flutter 一样,条件渲染和列表都使用标准的语言结构来编写:条件使用 Kotlin 的 [if] 表达式,列表使用 [forEach] 循环。由于 @Composable 函数与任何其他函数没有区别,[if (auth.isLoggedIn) { ... }] 会发出或不发出其内容——这里不存在构建组件列表([children: [...]])或 Dart 的“collection if”语法的对应物。
4.7. 协程:Kotlin 风格的 async/await
Android 应用只有一个线程负责渲染 UI 并响应用户:主线程。它绝对不能等待;事实上,Android 禁止在该线程上进行任何网络访问(异常 [NetworkOnMainThreadException])。因此,服务器调用必须“在后台”进行。Kotlin 为此提供了协程:
- [suspend] 函数可以在不阻塞执行它的线程的情况下暂停——相当于 Dart 的 [async] 或 TypeScript 函数。调用 [suspend] 函数就等于等待它:没有 [await] 关键字;等待是隐式的;
- [withContext(Dispatchers.IO) { ... }] 在专为 I/O 保留的线程上执行一个代码块,然后带着结果返回原线程。这使您可以使用“阻塞式”网络库([OkHttp])而完全不会阻塞界面;
- 协程通过 [launch { ... }] 在与某个生命周期绑定的作用域([CoroutineScope])内启动:[viewModelScope] (ViewModel 的协程,在其销毁时取消)或 [rememberCoroutineScope()] (@Composable 函数的协程,在其从屏幕上消失时取消)。不再像 Flutter 中那样存在修改已销毁屏幕的状态的风险([if (mounted)] 检查):协程会随之一起被取消。
4.8. 生命周期:屏幕旋转与 ViewModel
默认情况下,当用户旋转手机(或更改系统语言,或切换到深色模式)时,Android 会销毁 Activity,并创建一个适应新配置的新 Activity。存储在旧 Activity 中的一切——包括其 @Composable 函数的状态——都会丢失。Flutter 没有这个问题:旋转屏幕只会改变屏幕尺寸。
Android 提供了两种解决方案,客户端都使用了:
- [rememberSaveable { ... }] 用于小型 UI 状态(正在输入的文本、所选医生等):Android 在销毁前保存它们,并将其恢复到新的 Activity 中;
- [ViewModel] 用于屏幕的状态和逻辑(从服务器加载的列表、显示的日历等):这是 Android 在 Activity 重建期间保留(KEEPS)并传递给新 Activity 的对象。只有在永久退出该屏幕时它才会被销毁。本文档中的客户端把 Flutter 版本保存在 [_AppRootState] 类中的所有状态都放进了 ViewModel([AppViewModel])。
必须与应用同生命周期的对象(服务)不是在 Activity 或 ViewModel 中创建,而是在应用的 [Application] 类中创建,该类在进程启动时只创建一次。
4.9. 第一个简单示例
下面是一个小型 Compose 应用:一段文本、一个统计点击次数的按钮,以及一条只在第三次点击之后才出现的消息。要试用它,只需替换用 [Empty Activity] 模板创建的项目(见第 1 章)中 [MainActivity.kt] 文件的内容,并修改 [package] 行。
下面逐段分析这段代码:
- 第 19 行:[class MainActivity : ComponentActivity()]——Activity,即由系统启动的屏幕。[ComponentActivity] 是专为 Compose 准备的基类;
- 第 20 行:[onCreate(...)]——在 Activity 创建时由 Android 调用。这是应用代码的起点,取代了 Flutter 的 [main()];
- 第 22 行:[setContent { ... }]——用代码块中描述的界面替换屏幕内容:相当于 Flutter 中的 [runApp(...)] ;
- 第 23 行:[MaterialTheme { ... }]——为代码块内调用的所有内容提供 Material 3 主题(颜色、字体、形状)——相当于 Flutter 的 [MaterialApp] 的作用,但不含导航;
- 第 30–31 行:[@Composable fun Counter(name: String)]——一个带有一个参数的 `@Composable` 函数。按照惯例,其名称以大写字母开头,与类名一样:它代表一个界面元素;
- 第 32 行:[var clicks by remember { mutableIntStateOf(0) }]——一个局部状态:[mutableIntStateOf] 是 [mutableStateOf] 针对整数优化的变体;
- 第 33 行:[Column(modifier = Modifier.padding(32.dp)) { ... }]——把其子元素上下排列,边距为 32 dp。[Row] 则会把它们并排排列;
- 第 35 行:[Button(onClick = { clicks++ })]——点击处理程序是一个简单的 lambda。[clicks++] 修改状态:Compose 立即重组读取(READ)该状态的 [Counter], 按钮文本随之更新;
- 第 38–40 行:一个标准的 Kotlin [if]——文本“Well done!”只有从第三次点击开始才会被发出,因而才会显示。
4.10. 小结:Flutter 到 Jetpack Compose 的对应关系
- [void main()] + [runApp(...)] → Activity([ComponentActivity])+ [setContent { ... }]
- [StatelessWidget]/[StatefulWidget] (类)→ [@Composable] 函数
- 来自 [State<T>] 的字段 + [setState(...)] → [remember { mutableStateOf(...) }] (自动重组)
- [ChangeNotifier] + [notifyListeners()] → 属性为 [by mutableStateOf(...)] 的类(无需通知)
- 包 [provider] ([MultiProvider]、[context.read]/[watch])→ [CompositionLocal] ([CompositionLocalProvider]、[LocalXxx.current])
- 组件构造函数参数(输入)、作为参数传递的函数(输出)→ @Composable 函数的参数、lambda
- [build(BuildContext)] → @Composable 函数的函数体
- 组件 [Padding]、[Center]、[SizedBox]…… → 修饰符([Modifier.padding(...)]……)
- [Future<T>] + [async]/[await] → [suspend] 函数 + 协程
- 包 [http] → 库 [OkHttp]
- 手写的 [fromJson(...)] 构造函数 → [@Serializable] ([kotlinx.serialization])类
- 包 [shared_preferences] → Android 的 [SharedPreferences] (Flutter 包名称的来源 API)
- [showDialog(...)] → 一个 [AlertDialog(...)] 函数,只要某个状态需要就一直显示
- [LayoutBuilder] / [MediaQuery] → [BoxWithConstraints] / [LocalConfiguration]
- [pubspec.yaml] + [flutter pub get] → [build.gradle.kts] + [libs.versions.toml] + Gradle
- Flutter 中没有对应物:[ViewModel] 和 [rememberSaveable],它们的存在是因为屏幕旋转时 Activity 会被重建