Skip to content

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] 行。

package fr.rdvmedecins.example

import android.os.Bundle
import androidx.activity.ComponentActivity
import androidx.activity.compose.setContent
import androidx.compose.foundation.layout.Column
import androidx.compose.foundation.layout.padding
import androidx.compose.material3.Button
import androidx.compose.material3.MaterialTheme
import androidx.compose.material3.Text
import androidx.compose.runtime.Composable
import androidx.compose.runtime.getValue
import androidx.compose.runtime.mutableIntStateOf
import androidx.compose.runtime.remember
import androidx.compose.runtime.setValue
import androidx.compose.ui.Modifier
import androidx.compose.ui.unit.dp

class MainActivity : ComponentActivity() {
    override fun onCreate(savedInstanceState: Bundle?) {
        super.onCreate(savedInstanceState)
        setContent {
            MaterialTheme {
                Counter(name = "RdvMedecins")
            }
        }
    }
}

@Composable
fun Counter(name: String) {
    var clicks by remember { mutableIntStateOf(0) }
    Column(modifier = Modifier.padding(32.dp)) {
        Text("Hello, $name!")
        Button(onClick = { clicks++ }) {
            Text("Clicked $clicks times")
        }
        if (clicks >= 3) {
            Text("Well done!")
        }
    }
}

下面逐段分析这段代码:

  • 第 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 会被重建