Jetpack Compose 基础知识

Jetpack Compose 基础知识

关于此 Codelab

subject上次更新时间:1月 18, 2024
account_circleGoogle 员工编写

1. 准备工作

Jetpack Compose 是一款新型工具包,旨在帮助简化界面开发。该工具包将响应式编程模型与简洁易用的 Kotlin 编程语言相结合,并采用完全声明式的代码编写方式,让您可以通过调用一系列函数来描述界面,这些函数会将数据转换为界面层次结构。当底层数据发生变化时,框架会自动重新执行这些函数,为您更新界面层次结构。

Compose 应用由可组合函数构成。可组合函数即带有 @Composable 标记的常规函数,这些函数可以调用其他可组合函数。使用一个函数就可以创建一个新的界面组件。该注解会告知 Compose 为函数添加特殊支持,以便后续更新和维护界面。借助 Compose,您可以将代码设计成多个小代码块。可组合函数通常简称为“可组合项”。

通过创建可重用的小型可组合项,您可以轻松构建应用中所用界面元素的库。每个可组合项对应于屏幕的一个部分,可以单独修改。

如果您在学习此 Codelab 的过程中需要获得更多支持,请查看以下“跟着做”编码演示视频:

注意:此演示视频中使用的是 Material 2,而 Codelab 已更新为使用 Material 3。请注意,使用不同 Material 版本时,有些步骤是不一样的。

前提条件

  • 有使用 Kotlin 语法(包括 lambda)方面的经验

实践内容

在此 Codelab 中,您将学习:

  • 什么是 Compose
  • 如何使用 Compose 构建界面
  • 如何在可组合函数中管理状态
  • 如何创建高效列表
  • 如何添加动画
  • 如何为应用设置样式和主题

您将构建一个包含初始配置屏幕和一系列动画展开项的应用:

8d24a786bfe1a8f2.gif

所需条件

2. 启动新的 Compose 项目

如需启动新的 Compose 项目,请打开 Android Studio。

如果您位于 Welcome to Android Studio 窗口中,请点击 Start a new Android Studio project。如果您已打开 Android Studio 项目,请从菜单栏中依次选择 File > New > New Project

对于新项目,请从可用模板中选择 Empty Activity

d12472c6323de500.png

点击 Next,然后照常配置项目,并将其命名为 Basics Codelab。请确保您选择的 minimumSdkVersion 至少为 API 级别 21,这是 Compose 支持的最低 API 级别。

选择 Empty Activity 模板后,会在项目中为您生成以下代码:

  • 该项目已配置为使用 Compose。
  • 已创建 AndroidManifest.xml 文件。
  • build.gradle.ktsapp/build.gradle.kts 文件包含 Compose 所需的选项和依赖项。

同步项目后,请打开 MainActivity.kt 并查看代码。

class MainActivity : ComponentActivity() {
    override fun onCreate(savedInstanceState: Bundle?) {
        super.onCreate(savedInstanceState)
        setContent {
            BasicsCodelabTheme {
                // A surface container using the 'background' color from the theme
                Surface(
                    modifier = Modifier.fillMaxSize(),
                    color = MaterialTheme.colorScheme.background
                ) {
                    Greeting("Android")
                }
            }
        }
    }
}

@Composable
fun Greeting(name: String, modifier: Modifier = Modifier) {
    Text(
        text = "Hello $name!",
        modifier = modifier
    )
}

@Preview(showBackground = true)
@Composable
fun GreetingPreview() {
    BasicsCodelabTheme {
        Greeting("Android")
    }
}

在下一个部分,我们将介绍每种方法的用途,以及如何改进这些方法,以创建灵活、可重复使用的布局。

本 Codelab 的解决方案

您可以从 GitHub 获取本 Codelab 的解决方案代码:

$ git clone https://github.com/android/codelab-android-compose

或者,您可以下载代码库 Zip 文件:

您可以在 BasicsCodelab 项目中找到解决方案代码。建议您按照自己的节奏逐步完成 Codelab,必要时再查看解决方案。在此 Codelab 的学习过程中,我们会为您提供需要添加到项目的代码段。

3. Compose 使用入门

了解 Android Studio 为您生成的与 Compose 相关的各种类和方法。

可组合函数

可组合函数是带有 @Composable 注解的常规函数。这类函数自身可以调用其他 @Composable 函数。我们会展示如何为 Greeting 函数添加 @Composable 标记。此函数会生成一段显示给定输入 String 的界面层次结构。Text 是由库提供的可组合函数。

@Composable
fun Greeting(name: String, modifier: Modifier = Modifier) {
    Text(
        text = "Hello $name!",
        modifier = modifier
    )
}

Android 应用中的 Compose

使用 Compose 时,Activity 仍然是 Android 应用的入口点。在我们的项目中,用户打开应用时会启动 MainActivity(如 AndroidManifest.xml 文件中所指定)。您可以使用 setContent 来定义布局,但不同于在传统 View 系统中使用 XML 文件,您将在该函数中调用可组合函数。

class MainActivity : AppCompatActivity() {
   
override fun onCreate(savedInstanceState: Bundle?) {
       
super.onCreate(savedInstanceState)
       
setContent {
           
BasicsCodelabTheme {
               
// A surface container using the 'background' color from the theme
               
Surface(
                 
modifier = Modifier.fillMaxSize(),
                 
color = MaterialTheme.colorScheme.background
               
) {
                   
Greeting("Android")
               
}
           
}
       
}
   
}
}

BasicsCodelabTheme 是为可组合函数设置样式的一种方式。有关详细内容,请参阅设置应用主题部分。如需查看文本在屏幕上的显示效果,您可以在模拟器或设备上运行应用,或使用 Android Studio 预览进行查看。

若要使用 Android Studio 预览,您只需使用 @Preview 注解标记所有无参数可组合函数或采用默认形参的函数,然后构建您的项目即可。现在 MainActivity.kt 文件中已经包含了一个 Preview Composable 函数。您可以在同一个文件中包含多个预览,并为它们指定名称。

@Preview(showBackground = true, name = "Text preview")
@Composable
fun GreetingPreview() {
    BasicsCodelabTheme {
        Greeting(name = "Android")
    }
}

fb011e374b98ccff.png

如果选择 Code eeacd000622ba9b.png,系统可能不会显示预览。请点击 Split 7093def1e32785b2.png 以查看预览。

4. 微调界面

首先,为 Greeting 设置不同的背景颜色。为此,您可以用 Surface 包围 Text 可组合项。Surface 会采用一种颜色,因此请使用 MaterialTheme.colorScheme.primary

@Composable
fun Greeting(name: String, modifier: Modifier = Modifier) {
    Surface(color = MaterialTheme.colorScheme.primary) {
        Text(
            text = "Hello $name!",
            modifier = modifier
        )
    }
}

嵌套在 Surface 内的组件将在该背景颜色之上绘制。

您可以在预览中查看新更改:

c88121ec49bde8c7.png

您可能忽略了一个重要的细节:文字现在是白色的。我们是何时对此进行定义的?

我们并没有对此进行过定义!Material 组件(例如 androidx.compose.material3.Surface)旨在提供应用中可能需要的常见功能(例如为文本选择适当的颜色),让您获得更好的体验。我们之所以说 Material 很实用,是因为它提供在大多数应用中都会用到的实用默认值和模式。Compose 中的 Material 组件是在其他基础组件(位于 androidx.compose.foundation 中)的基础上构建的。如果您需要更高的灵活性,也可以从您的应用组件中访问这些组件。

在这种情况下,Surface 会了解,当该背景设置为 primary 颜色后,其上的任何文本都应使用 onPrimary 颜色,此颜色也在主题中进行了定义。如需了解详情,请参阅设置应用主题部分。

修饰符

大多数 Compose 界面元素(例如 SurfaceText)都接受可选的 modifier 参数。修饰符会指示界面元素如何在其父布局中放置、显示或表现。您可能已经注意到,Greeting 可组合项已有一个默认修饰符,该修饰符随后会传递给 Text

例如,padding 修饰符会在其修饰的元素周围应用一定的空间。您可以使用 Modifier.padding() 创建内边距修饰符。您还可串联多个修饰符以添加它们,因此在本例中,我们可为默认修饰符添加内边距修饰符:modifier.padding(24.dp)

现在,为界面上的 Text 添加内边距:

import androidx.compose.foundation.layout.padding
import androidx.compose.ui.unit.dp
// ...

@Composable
fun Greeting(name: String, modifier: Modifier = Modifier) {
   
Surface(color = MaterialTheme.colorScheme.primary) {
       
Text(
           
text = "Hello $name!",
           
modifier = modifier.padding(24.dp)
       
)
   
}
}

ef14f7c54ae7edf.png

有数十种修饰符可用于实现对齐、添加动画、设置布局、使可点击或可滚动以及转换等效果。有关完整列表,请查看 Compose 修饰符列表。您将在后续步骤中使用其中的部分修饰符。

5. 重复使用可组合项

您添加到界面的组件越多,创建的嵌套层级就越多。如果函数变得非常大,可能会影响可读性。通过创建可重用的小型组件,可以轻松构建应用中所用界面元素的库。每个组件对应于屏幕的一个部分,可以单独修改。

最佳实践是,您的函数应包含一个修饰符参数,系统默认为该参数分配空修饰符。将此修饰符转发到您在函数内调用的第一个可组合项。这样,调用点就可以在可组合函数之外调整布局指令和行为了。

创建一个名为 MyApp 的可组合项,该组合项中包含问候语。

@Composable
fun MyApp(modifier: Modifier = Modifier) {
    Surface(
        modifier = modifier,
        color = MaterialTheme.colorScheme.background
    ) {
        Greeting("Android")
    }
}

这样一来,由于现在可以重复使用 MyApp 可组合项,您就可以省去 onCreate 回调和预览,从而避免重复编写代码。

在预览中,调用 MyApp 并移除预览的名称。

您的 MainActivity.kt 文件应如下所示:

package com.example.basicscodelab

import android.os.Bundle
import androidx.activity.ComponentActivity
import androidx.activity.compose.setContent
import androidx.compose.foundation.layout.fillMaxSize
import androidx.compose.foundation.layout.padding
import androidx.compose.material3.MaterialTheme
import androidx.compose.material3.Surface
import androidx.compose.material3.Text
import androidx.compose.runtime.Composable
import androidx.compose.ui.Modifier
import androidx.compose.ui.tooling.preview.Preview
import androidx.compose.ui.unit.dp
import com.example.basicscodelab.ui.theme.BasicsCodelabTheme

class MainActivity : ComponentActivity() {
   
override fun onCreate(savedInstanceState: Bundle?) {
       
super.onCreate(savedInstanceState)
       
setContent {
           
BasicsCodelabTheme {
               
MyApp(modifier = Modifier.fillMaxSize())
           
}
       
}
   
}
}

@Composable
fun MyApp(modifier: Modifier = Modifier) {
   
Surface(
       
modifier = modifier,
       
color = MaterialTheme.colorScheme.background
   
) {
       
Greeting("Android")
   
}
}

@Composable
fun Greeting(name: String, modifier: Modifier = Modifier) {
   
Surface(color = MaterialTheme.colorScheme.primary) {
       
Text(
           
text = "Hello $name!",
           
modifier = modifier.padding(24.dp)
       
)
   
}
}

@Preview(showBackground = true)
@Composable
fun GreetingPreview() {
   
BasicsCodelabTheme {
       
MyApp()
   
}
}

6. 创建列和行

Compose 中的三个基本标准布局元素是 ColumnRowBox 可组合项。

518dbfad23ee1b05.png

它们是接受可组合内容的可组合函数,因此您可以在其中放置项目。例如,Column 中的每个子级都将垂直放置。

// Don't copy over
Column {
    Text("First row")
    Text("Second row")
}

现在尝试更改 Greeting,使其显示包含两个文本元素的列,如以下示例中所示:

bf27ee688c3231df.png

请注意,您可能需要移动周围的内边距。

将您的结果与此解决方案进行比较:

import androidx.compose.foundation.layout.Column
// ...

@Composable
fun Greeting(name: String, modifier: Modifier = Modifier) {
   
Surface(color = MaterialTheme.colorScheme.primary) {
       
Column(modifier = modifier.padding(24.dp)) {
           
Text(text = "Hello ")
           
Text(text = name)
       
}
   
}
}

Compose 和 Kotlin

可组合函数可以像 Kotlin 中的其他函数一样使用。这会使界面构建变得非常有效,因为您可以添加语句来影响界面的显示方式。

例如,您可以使用 for 循环向 Column 中添加元素:

@Composable
fun MyApp(
    modifier: Modifier = Modifier,
    names: List<String> = listOf("World", "Compose")
) {
    Column(modifier) {
        for (name in names) {
            Greeting(name = name)
        }
    }
}

a7ba2a8cb7a7d79d.png

您尚未设置可组合项的尺寸,也未对可组合项的大小添加任何限制,因此每一行仅占用可能的最小空间,预览时的效果也是如此。让我们更改预览效果,以模拟小屏幕手机的常见宽度 320dp。按如下所示向 @Preview 注解添加 widthDp 参数:

@Preview(showBackground = true, widthDp = 320)
@Composable
fun GreetingPreview() {
    BasicsCodelabTheme {
        MyApp()
    }
}

a5d5f6cdbdd918a2.png

修饰符在 Compose 中使用得非常广泛,现在我们来练习更高级的用法:尝试使用 fillMaxWidthpadding 修饰符复制以下布局。

a9599061cf49a214.png

现在,将您的代码与解决方案进行比较:

import androidx.compose.foundation.layout.fillMaxWidth

@Composable
fun MyApp(
   
modifier: Modifier = Modifier,
   
names: List<String> = listOf("World", "Compose")
) {
   
Column(modifier = modifier.padding(vertical = 4.dp)) {
       
for (name in names) {
           
Greeting(name = name)
       
}
   
}
}

@Composable
fun Greeting(name: String, modifier: Modifier = Modifier) {
   
Surface(
       
color = MaterialTheme.colorScheme.primary,
       
modifier = modifier.padding(vertical = 4.dp, horizontal = 8.dp)
   
) {
       
Column(modifier = Modifier.fillMaxWidth().padding(24.dp)) {
           
Text(text = "Hello ")
           
Text(text = name)
       
}
   
}
}

请注意:

  • 修饰符可以包含重载,因而具有相应的优势,例如您可以指定不同的方式来创建内边距。
  • 若要向一个元素添加多个修饰符,您只需要将它们链接起来即可。

有多种方式可以实现此结果,因此,如果您的代码与此代码段不同,并不表示您的代码就是错的。不过,为了继续完成此 Codelab,仍请复制并粘贴此代码。

添加按钮

接下来,您将添加一个用于展开 Greeting 的可点击元素,因此需要先添加对应的按钮。您的目标是要创建以下布局:

ff2d8c3c1349a891.png

Button 是 material3 软件包提供的一种可组合项,它采用可组合项作为最后一个参数。由于尾随 lambda 可以移到括号之外,因此您可以向按钮添加任何内容作为子级,例如 Text

// Don't copy yet
Button(
    onClick = { } // You'll learn about this callback later
) {
    Text("Show less")
}

为了实现这一点,您需要学习如何在行尾放置可组合项。由于没有 alignEnd 修饰符,因此您需要在开始时为该可组合项赋予一定的 weightweight 修饰符会让元素填满所有可用空间,使其“具有弹性”,也就是会推开其他没有权重的元素(即“无弹性”元素)。该修饰符还会使 fillMaxWidth 修饰符变得多余。

现在尝试添加该按钮,并按照上述图片中所示放置该按钮。

下面列出了对应的解决方案代码:

import androidx.compose.foundation.layout.Row
import androidx.compose.material3.ElevatedButton
// ...

@Composable
fun Greeting(name: String, modifier: Modifier = Modifier) {
   
Surface(
       
color = MaterialTheme.colorScheme.primary,
       
modifier = modifier.padding(vertical = 4.dp, horizontal = 8.dp)
   
) {
       
Row(modifier = Modifier.padding(24.dp)) {
           
Column(modifier = Modifier.weight(1f)) {
               
Text(text = "Hello ")
               
Text(text = name)
           
}
           
ElevatedButton(
               
onClick = { /* TODO */ }
           
) {
               
Text("Show more")
           
}
       
}
   
}
}

7. Compose 中的状态

在本部分中,您将向屏幕中添加一些互动。到目前为止,您已经创建了一些静态布局,但现在要让它们响应用户更改,以达到下面的效果:

6675d41779cac69.gif

在开始了解如何使按钮可点击以及如何调整内容大小之前,您需要在某个位置存储某个值,用于指示每项内容是否展开(即内容的状态)。由于我们需要为每条问候语设定这两个值之一,因此其逻辑位置位于 Greeting 可组合项中。我们来看看此 expanded 布尔值及其在代码中的使用方式:

// Don't copy over
@Composable
fun Greeting(name: String) {
    var expanded = false // Don't do this!

    Surface(
        color = MaterialTheme.colorScheme.primary,
        modifier = Modifier.padding(vertical = 4.dp, horizontal = 8.dp)
    ) {
        Row(modifier = Modifier.padding(24.dp)) {
            Column(modifier = Modifier.weight(1f)) {
                Text(text = "Hello, ")
                Text(text = name)
            }
            ElevatedButton(
                onClick = { expanded = !expanded }
            ) {
                Text(if (expanded) "Show less" else "Show more")
            }
        }
    }
}

请注意,我们还添加了 onClick 操作和动态按钮文本。稍后会进一步介绍。

但是,此设置无法按预期发挥作用。为 expanded 变量设置不同的值不会使 Compose 将其检测为状态更改,因此不会产生任何效果。

更改此变量不会触发重组的原因是 Compose 并未跟踪此更改。此外,每次调用 Greeting 时,都会将该变量重置为 false。

如需向可组合项添加内部状态,可以使用 mutableStateOf 函数,该函数可让 Compose 重组读取该 State 的函数。

import androidx.compose.runtime.mutableStateOf
// ...

// Don't copy over
@Composable
fun Greeting() {
   
val expanded = mutableStateOf(false) // Don't do this!
}

但是,不能只是mutableStateOf 分配给可组合项中的某个变量。如前所述,重组可能会随时发生,这会再次调用可组合项,从而将状态重置为值为 false 的新可变状态。

如需在重组后保留状态,请使用 remember 记住可变状态。

import androidx.compose.runtime.mutableStateOf
import androidx.compose.runtime.remember
// ...

@Composable
fun Greeting(...) {
   
val expanded = remember { mutableStateOf(false) }
   
// ...
}

remember 可以起到保护作用,防止状态在重组时被重置。

请注意,如果从屏幕的不同部分调用同一可组合项,则会创建不同的界面元素,且每个元素都会拥有自己的状态版本。您可以将内部状态视为类中的私有变量

可组合函数会自动“订阅”状态。如果状态发生变化,读取这些字段的可组合项将会重组以显示更新。

更改状态和响应状态更改

您可能已经注意到,为了更改状态,Button 具有一个名为 onClick 的形参,但它不接受值,而接受函数

您可以通过为“onClick”指定 lambda 表达式,定义点击时将执行的操作。例如,切换展开状态的值,并根据该值显示不同的文本。

ElevatedButton(
    onClick
= { expanded.value = !expanded.value },
) {
   
Text(if (expanded.value) "Show less" else "Show more")
}

请在交互模式下运行应用以查看行为。

374998ad358bf8d6.png

点击该按钮后,expanded 会切换,从而触发对按钮内文本的重组。每个 Greeting 都具有自己的展开状态,因为它们属于不同的界面元素。

93d839b53b7d9bea.gif

到目前为止的代码:

@Composable
fun Greeting(name: String, modifier: Modifier = Modifier) {
    val expanded = remember { mutableStateOf(false) }
    Surface(
        color = MaterialTheme.colorScheme.primary,
        modifier = modifier.padding(vertical = 4.dp, horizontal = 8.dp)
    ) {
        Row(modifier = Modifier.padding(24.dp)) {
            Column(modifier = Modifier.weight(1f)) {
                Text(text = "Hello ")
                Text(text = name)
            }
            ElevatedButton(
                onClick = { expanded.value = !expanded.value }
            ) {
                Text(if (expanded.value) "Show less" else "Show more")
            }
        }
    }
}

展开内容

现在,我们来根据请求实际展开内容。添加一个依赖于状态的额外变量:

@Composable
fun Greeting(name: String, modifier: Modifier = Modifier) {

    val expanded = remember { mutableStateOf(false) }

    val extraPadding = if (expanded.value) 48.dp else 0.dp
// ...

您无需在重组后记住 extraPadding,因为它仅执行简单的计算。

现在我们可以将新的内边距修饰符应用于 Column:

@Composable
fun Greeting(name: String, modifier: Modifier = Modifier) {
    val expanded = remember { mutableStateOf(false) }
    val extraPadding = if (expanded.value) 48.dp else 0.dp
    Surface(
        color = MaterialTheme.colorScheme.primary,
        modifier = modifier.padding(vertical = 4.dp, horizontal = 8.dp)
    ) {
        Row(modifier = Modifier.padding(24.dp)) {
            Column(
                modifier = Modifier
                    .weight(1f)
                    .padding(bottom = extraPadding)
            ) {
                Text(text = "Hello ")
                Text(text = name)
            }
            ElevatedButton(
                onClick = { expanded.value = !expanded.value }
            ) {
                Text(if (expanded.value) "Show less" else "Show more")
            }
        }
    }
}

如果您在模拟器上运行或在交互模式下运行,您应该会看到每项内容均可单独展开:

6675d41779cac69.gif

8. 状态提升

在可组合函数中,被多个函数读取或修改的状态应位于共同祖先实体中,此过程称为状态提升。“提升”意为“提高”或“升级”。

使状态可提升,可以避免复制状态和引入 bug,有助于重复使用可组合项,并大大降低可组合项的测试难度。相反,不需要由可组合项的父级控制的状态则不应该被提升。可信来源属于该状态的创建者和控制者。

例如,让我们来为应用创建一个初始配置界面。

5d5f44508fcfa779.png

将以下代码添加到 MainActivity.kt

import androidx.compose.foundation.layout.Arrangement
import androidx.compose.material3.Button
import androidx.compose.runtime.getValue
import androidx.compose.runtime.setValue
import androidx.compose.ui.Alignment
// ...

@Composable
fun OnboardingScreen(modifier: Modifier = Modifier) {
   
// TODO: This state should be hoisted
   
var shouldShowOnboarding by remember { mutableStateOf(true) }

   
Column(
       
modifier = modifier.fillMaxSize(),
       
verticalArrangement = Arrangement.Center,
       
horizontalAlignment = Alignment.CenterHorizontally
   
) {
       
Text("Welcome to the Basics Codelab!")
       
Button(
           
modifier = Modifier.padding(vertical = 24.dp),
           
onClick = { shouldShowOnboarding = false }
       
) {
           
Text("Continue")
       
}
   
}
}

@Preview(showBackground = true, widthDp = 320, heightDp = 320)
@Composable
fun OnboardingPreview() {
   
BasicsCodelabTheme {
       
OnboardingScreen()
   
}
}

此代码包含多个新功能:

  • 您已经添加了一个名为 OnboardingScreen 的新可组合项以及一个新的预览。构建项目时,您会发现您可以同时拥有多个预览。我们还添加了一个固定高度,以验证内容是否正确对齐。
  • 可以配置 Column,使其在屏幕中心显示其内容。
  • shouldShowOnboarding 使用的是 by 关键字,而不是 =。这是一个属性委托,可让您无需每次都输入 .value
  • 点击该按钮时,会将 shouldShowOnboarding 设为 false,尽管您并未从任何位置读取该状态。

现在,我们即可将这个新的初始配置屏幕添加到应用。我们希望该屏幕在应用启动时显示,然后在用户按“继续”时隐藏。

在 Compose 中,您不会隐藏界面元素,因为不会将它们添加到组合中,因此它们也不会添加到 Compose 生成的界面树中。您只需要使用简单的 Kotlin 条件逻辑就可以做到这一点。例如,如需显示初始配置屏幕或问候语列表,您需要执行以下操作:

// Don't copy yet
@Composable
fun MyApp(modifier: Modifier = Modifier) {
    Surface(modifier) {
        if (shouldShowOnboarding) { // Where does this come from?
            OnboardingScreen()
        } else {
            Greetings()
        }
    }
}

但是,我们无法访问 shouldShowOnboarding。很明显,我们需要与 MyApp 可组合项共享在 OnboardingScreen 中创建的状态。

我们不会以某种方式与状态的父级共享状态值,而是会提升该状态,也就是将该状态移到需要访问它的共同祖先实体中。

首先,将 MyApp 的内容移到名为 Greetings 的新可组合项中。此外,调整预览以改为调用 Greetings 方法:

@Composable
fun MyApp(modifier: Modifier = Modifier) {
     Greetings()
}

@Composable
private fun Greetings(
    modifier: Modifier = Modifier,
    names: List<String> = listOf("World", "Compose")
) {
    Column(modifier = modifier.padding(vertical = 4.dp)) {
        for (name in names) {
            Greeting(name = name)
        }
    }
}

@Preview(showBackground = true, widthDp = 320)
@Composable
fun GreetingsPreview() {
    BasicsCodelabTheme {
        Greetings()
    }
}

为新的顶级 MyApp 可组合项添加预览,以便测试其行为:

@Preview
@Composable
fun MyAppPreview() {
    BasicsCodelabTheme {
        MyApp(Modifier.fillMaxSize())
    }
}

现在,添加相应的逻辑来显示 MyApp 中的不同屏幕,并提升状态。

@Composable
fun MyApp(modifier: Modifier = Modifier) {

    var shouldShowOnboarding by remember { mutableStateOf(true) }

    Surface(modifier) {
        if (shouldShowOnboarding) {
            OnboardingScreen(/* TODO */)
        } else {
            Greetings()
        }
    }
}

我们还需要与初始配置屏幕共享 shouldShowOnboarding,但我们不会直接传递它。与其让 OnboardingScreen 更改状态,不如让它在用户点击“Continue”按钮时通知我们。

如何向上传递事件?通过向下传递回调来传递。回调是这样一类函数,它们以实参的形式传递给其他函数,并在事件发生时执行。

尝试向初始配置屏幕添加定义为 onContinueClicked: () -> Unit 的函数参数,以便您可以从 MyApp 更改状态。

解决方案:

@Composable
fun MyApp(modifier: Modifier = Modifier) {

    var shouldShowOnboarding by remember { mutableStateOf(true) }

    Surface(modifier) {
        if (shouldShowOnboarding) {
            OnboardingScreen(onContinueClicked = { shouldShowOnboarding = false })
        } else {
            Greetings()
        }
    }
}

@Composable
fun OnboardingScreen(
    onContinueClicked: () -> Unit,
    modifier: Modifier = Modifier
) {

    Column(
        modifier = modifier.fillMaxSize(),
        verticalArrangement = Arrangement.Center,
        horizontalAlignment = Alignment.CenterHorizontally
    ) {
        Text("Welcome to the Basics Codelab!")
        Button(
            modifier = Modifier
                .padding(vertical = 24.dp),
            onClick = onContinueClicked
        ) {
            Text("Continue")
        }
    }

}

通过向 OnboardingScreen 传递函数而不是状态,可以提高该可组合项的可重用性,并防止状态被其他可组合项更改。一般而言,这可以让事情变得简单。一个很好的例子就是,现在需要如何修改初始配置屏幕预览来调用 OnboardingScreen

@Preview(showBackground = true, widthDp = 320, heightDp = 320)
@Composable
fun OnboardingPreview() {
    BasicsCodelabTheme {
        OnboardingScreen(onContinueClicked = {}) // Do nothing on click.
    }
}

onContinueClicked 分配给空 lambda 表达式就等于“什么也不做”,这非常适合于预览。

看起来已经越来越像一个真正的应用了,非常棒!

25915eb273a7ef49.gif

MyApp 可组合项中,我们首次使用了 by 属性委托,以避免每次都使用值。我们不妨也在 expanded 属性的 Greeting 可组合项中使用 by(而非 =)。务必要将 expandedval 更改为 var

到目前为止的完整代码:

package com.example.basicscodelab

import android.os.Bundle
import androidx.activity.ComponentActivity
import androidx.activity.compose.setContent
import androidx.compose.foundation.layout.Arrangement
import androidx.compose.foundation.layout.Column
import androidx.compose.foundation.layout.Row
import androidx.compose.foundation.layout.fillMaxSize
import androidx.compose.foundation.layout.padding
import androidx.compose.material3.Button
import androidx.compose.material3.ElevatedButton
import androidx.compose.material3.MaterialTheme
import androidx.compose.material3.Surface
import androidx.compose.material3.Text
import androidx.compose.runtime.Composable
import androidx.compose.runtime.getValue
import androidx.compose.runtime.mutableStateOf
import androidx.compose.runtime.remember
import androidx.compose.runtime.setValue
import androidx.compose.ui.Alignment
import androidx.compose.ui.Modifier
import androidx.compose.ui.tooling.preview.Preview
import androidx.compose.ui.unit.dp
import com.codelab.basics.ui.theme.BasicsCodelabTheme

class MainActivity : ComponentActivity() {
   
override fun onCreate(savedInstanceState: Bundle?) {
       
super.onCreate(savedInstanceState)
       
setContent {
           
BasicsCodelabTheme {
               
MyApp(modifier = Modifier.fillMaxSize())
           
}
       
}
   
}
}

@Composable
fun MyApp(modifier: Modifier = Modifier) {

   
var shouldShowOnboarding by remember { mutableStateOf(true) }

   
Surface(modifier) {
       
if (shouldShowOnboarding) {
           
OnboardingScreen(onContinueClicked = { shouldShowOnboarding = false })
       
} else {
           
Greetings()
       
}
   
}
}

@Composable
fun OnboardingScreen(
   
onContinueClicked: () -> Unit,
   
modifier: Modifier = Modifier
) {

   
Column(
       
modifier = modifier.fillMaxSize(),
       
verticalArrangement = Arrangement.Center,
       
horizontalAlignment = Alignment.CenterHorizontally
   
) {
       
Text("Welcome to the Basics Codelab!")
       
Button(
           
modifier = Modifier.padding(vertical = 24.dp),
           
onClick = onContinueClicked
       
) {
           
Text("Continue")
       
}
   
}
}

@Composable
private fun Greetings(
   
modifier: Modifier = Modifier,
   
names: List<String> = listOf("World", "Compose")
) {
   
Column(modifier = modifier.padding(vertical = 4.dp)) {
       
for (name in names) {
           
Greeting(name = name)
       
}
   
}
}

@Preview(showBackground = true, widthDp = 320, heightDp = 320)
@Composable
fun OnboardingPreview() {
   
BasicsCodelabTheme {
       
OnboardingScreen(onContinueClicked = {})
   
}
}

@Composable
fun Greeting(name: String, modifier: Modifier = Modifier) {

   
var expanded by remember { mutableStateOf(false) }

   
val extraPadding = if (expanded) 48.dp else 0.dp

   
Surface(
       
color = MaterialTheme.colorScheme.primary,
       
modifier = modifier.padding(vertical = 4.dp, horizontal = 8.dp)
   
) {
       
Row(modifier = Modifier.padding(24.dp)) {
           
Column(
               
modifier = Modifier
               
.weight(1f)
               
.padding(bottom = extraPadding)
           
) {
               
Text(text = "Hello, ")
               
Text(text = name)
           
}
           
ElevatedButton(
               
onClick = { expanded = !expanded }
           
) {
               
Text(if (expanded) "Show less" else "Show more")
           
}
       
}
   
}
}

@Preview(showBackground = true, widthDp = 320)
@Composable
fun GreetingPreview() {
   
BasicsCodelabTheme {
       
Greetings()
   
}
}

@Preview
@Composable
fun MyAppPreview() {
   
BasicsCodelabTheme {
       
MyApp(Modifier.fillMaxSize())
   
}
}

9. 创建高效延迟列表

现在,我们来让名称列表更真实。到目前为止,您已经在 Column 中显示了两条问候语。但是,它可以处理成千上万条问候语吗?

更改 Greetings 形参中的默认列表值以使用其他列表构造函数,这使您可以设置列表的大小并使用其 lambda 中包含的值来填充列表(这里的 $it 代表列表索引):

names: List<String> = List(1000) { "$it" }

这会创建 1000 条问候语,即使屏幕上放不下这些问候语。显然,这样做效果并不好。您可以尝试在模拟器上运行此代码(警告:此代码可能会使模拟器卡住)。

为显示可滚动列,我们需要使用 LazyColumnLazyColumn 只会渲染屏幕上可见的内容,从而在渲染大型列表时提升效率。

在其基本用法中,LazyColumn API 会在其作用域内提供一个 items 元素,并在该元素中编写各项内容的渲染逻辑:

import androidx.compose.foundation.lazy.LazyColumn
import androidx.compose.foundation.lazy.items
// ...

@Composable
private fun Greetings(
   
modifier: Modifier = Modifier,
   
names: List<String> = List(1000) { "$it" }
) {
   
LazyColumn(modifier = modifier.padding(vertical = 4.dp)) {
       
items(items = names) { name ->
           
Greeting(name = name)
       
}
   
}
}

284f925eb984fb56.gif

10. 保留状态

我们的应用存在两个问题:

保留初始配置界面状态

如果您在设备上运行应用,点击按钮,然后旋转,系统会再次显示初始配置界面。remember 函数仅在可组合项包含在组合中时起作用。旋转屏幕后,整个 activity 都会重启,所有状态都将丢失。当发生任何配置更改或者进程终止时,也会出现这种情况。

您可以使用 rememberSaveable,而不使用 remember。这会保存每个在配置更改(如旋转)和进程终止后保留下来的状态。

现在,将 shouldShowOnboarding 中的 remember 替换为 rememberSaveable

    import androidx.compose.runtime.saveable.rememberSaveable
   
// ...

   
var shouldShowOnboarding by rememberSaveable { mutableStateOf(true) }

运行应用,旋转屏幕,更改为深色模式,或者终止进程。除非您之前退出了应用,否则系统不会显示初始配置界面。

保持列表项的展开状态

如果您展开某个列表项并滚动列表直至该项不在视野范围内,或者旋转设备并返回到展开的项,您会看到该项现已恢复为初始状态。

解决方法是也为展开状态使用 rememberSaveable:

   var expanded by rememberSaveable { mutableStateOf(false) }

到目前为止,您已经编写了 120 行左右的代码,您可以显示一个包含大量内容项的高效滚动列表,并且每项内容都有自己的状态。此外,如您所见,您不需要编写额外的代码就可以让应用完美呈现深色模式。稍后您将学习主题设置。

11. 为列表添加动画效果

在 Compose 中,有多种方式可以为界面添加动画效果:从用于添加简单动画的高阶 API 到用于实现完全控制和复杂过渡的低阶方法,不一而足。您可以在该文档中了解相关信息。

在本部分中,您将使用一个低阶 API,但不用担心,它们也可以非常简单。下面我们来为已经实现的尺寸变化添加动画效果:

9efa14ce118d3835.gif

为此,您将使用 animateDpAsState 可组合项。该可组合项会返回一个 State 对象,该对象的 value 会被动画持续更新,直到动画播放完毕。该可组合项需要一个类型为 Dp 的“目标值”。

创建一个依赖于展开状态的动画 extraPadding

import androidx.compose.animation.core.animateDpAsState

@Composable
private fun Greeting(name: String, modifier: Modifier = Modifier) {

   
var expanded by rememberSaveable { mutableStateOf(false) }

   
val extraPadding by animateDpAsState(
       
if (expanded) 48.dp else 0.dp
   
)
   
Surface(
       
color = MaterialTheme.colorScheme.primary,
       
modifier = modifier.padding(vertical = 4.dp, horizontal = 8.dp)
   
) {
       
Row(modifier = Modifier.padding(24.dp)) {
           
Column(modifier = Modifier
               
.weight(1f)
               
.padding(bottom = extraPadding)
           
) {
               
Text(text = "Hello, ")
               
Text(text = name)
           
}
           
ElevatedButton(
               
onClick = { expanded = !expanded }
           
) {
               
Text(if (expanded) "Show less" else "Show more")
           
}

       
}
   
}
}

运行应用并查看该动画的效果。

animateDpAsState 接受可选的 animationSpec 参数供您自定义动画。让我们来做一些更有趣的尝试,比如添加基于弹簧的动画:

import androidx.compose.animation.core.Spring
import androidx.compose.animation.core.spring

@Composable
private fun Greeting(name: String, modifier: Modifier = Modifier) {

   
var expanded by rememberSaveable { mutableStateOf(false) }

   
val extraPadding by animateDpAsState(
       
if (expanded) 48.dp else 0.dp,
       
animationSpec = spring(
           
dampingRatio = Spring.DampingRatioMediumBouncy,
           
stiffness = Spring.StiffnessLow
       
)
   
)

   
Surface(
   
// ...
           
Column(modifier = Modifier
               
.weight(1f)
               
.padding(bottom = extraPadding.coerceAtLeast(0.dp))

   
// ...

   
)
}

请注意,我们还要确保内边距不会为负数,否则可能会导致应用崩溃。这会引入一个细微的动画 bug,我们稍后会在收尾部分进行修复。

spring 规范不接受任何与时间有关的参数。它仅依赖于物理属性(阻尼和刚度),使动画更自然。立即运行该应用,查看新动画的效果:

9efa14ce118d3835.gif

使用 animate*AsState 创建的任何动画都是可中断的。这意味着,如果目标值在动画播放过程中发生变化,animate*AsState 会重启动画并指向新值。中断在基于弹簧的动画中看起来尤其自然:

d5dbf92de69db775.gif

如果您想探索不同类型的动画,请尝试为 spring 提供不同的参数,尝试使用不同的规范(tweenrepeatable)和不同的函数(animateColorAsState不同类型的动画 API)。

此部分的完整代码

package com.example.basicscodelab

import android.os.Bundle
import androidx.activity.ComponentActivity
import androidx.activity.compose.setContent
import androidx.compose.animation.core.Spring
import androidx.compose.animation.core.animateDpAsState
import androidx.compose.animation.core.spring
import androidx.compose.foundation.layout.Arrangement
import androidx.compose.foundation.layout.Column
import androidx.compose.foundation.layout.Row
import androidx.compose.foundation.layout.fillMaxSize
import androidx.compose.foundation.layout.padding
import androidx.compose.foundation.lazy.LazyColumn
import androidx.compose.foundation.lazy.items
import androidx.compose.material3.Button
import androidx.compose.material3.ElevatedButton
import androidx.compose.material3.MaterialTheme
import androidx.compose.material3.Surface
import androidx.compose.material3.Text
import androidx.compose.runtime.Composable
import androidx.compose.runtime.getValue
import androidx.compose.runtime.mutableStateOf
import androidx.compose.runtime.saveable.rememberSaveable
import androidx.compose.runtime.setValue
import androidx.compose.ui.Alignment
import androidx.compose.ui.Modifier
import androidx.compose.ui.tooling.preview.Preview
import androidx.compose.ui.unit.dp
import com.codelab.basics.ui.theme.BasicsCodelabTheme

class MainActivity : ComponentActivity() {
   
override fun onCreate(savedInstanceState: Bundle?) {
       
super.onCreate(savedInstanceState)
       
setContent {
           
BasicsCodelabTheme {
               
MyApp(modifier = Modifier.fillMaxSize())
           
}
       
}
   
}
}

@Composable
fun MyApp(modifier: Modifier = Modifier) {

   
var shouldShowOnboarding by rememberSaveable { mutableStateOf(true) }

   
Surface(modifier) {
       
if (shouldShowOnboarding) {
           
OnboardingScreen(onContinueClicked = { shouldShowOnboarding = false })
       
} else {
           
Greetings()
       
}
   
}
}

@Composable
fun OnboardingScreen(
   
onContinueClicked: () -> Unit,
   
modifier: Modifier = Modifier
) {

   
Column(
       
modifier = modifier.fillMaxSize(),
       
verticalArrangement = Arrangement.Center,
       
horizontalAlignment = Alignment.CenterHorizontally
   
) {
       
Text("Welcome to the Basics Codelab!")
       
Button(
           
modifier = Modifier.padding(vertical = 24.dp),
           
onClick = onContinueClicked
       
) {
           
Text("Continue")
       
}
   
}

}

@Composable
private fun Greetings(
   
modifier: Modifier = Modifier,
   
names: List<String> = List(1000) { "$it" }
) {
   
LazyColumn(modifier = modifier.padding(vertical = 4.dp)) {
       
items(items = names) { name ->
           
Greeting(name = name)
       
}
   
}
}

@Preview(showBackground = true, widthDp = 320, heightDp = 320)
@Composable
fun OnboardingPreview() {
   
BasicsCodelabTheme {
       
OnboardingScreen(onContinueClicked = {})
   
}
}

@Composable
private fun Greeting(name: String, modifier: Modifier = Modifier) {

   
var expanded by rememberSaveable { mutableStateOf(false) }

   
val extraPadding by animateDpAsState(
       
if (expanded) 48.dp else 0.dp,
       
animationSpec = spring(
           
dampingRatio = Spring.DampingRatioMediumBouncy,
           
stiffness = Spring.StiffnessLow
       
)
   
)
   
Surface(
       
color = MaterialTheme.colorScheme.primary,
       
modifier = modifier.padding(vertical = 4.dp, horizontal = 8.dp)
   
) {
       
Row(modifier = Modifier.padding(24.dp)) {
           
Column(modifier = Modifier
               
.weight(1f)
               
.padding(bottom = extraPadding.coerceAtLeast(0.dp))
           
) {
               
Text(text = "Hello, ")
               
Text(text = name)
           
}
           
ElevatedButton(
               
onClick = { expanded = !expanded }
           
) {
               
Text(if (expanded) "Show less" else "Show more")
           
}
       
}
   
}
}

@Preview(showBackground = true, widthDp = 320)
@Composable
fun GreetingPreview() {
   
BasicsCodelabTheme {
       
Greetings()
   
}
}

@Preview
@Composable
fun MyAppPreview() {
   
BasicsCodelabTheme {
       
MyApp(Modifier.fillMaxSize())
   
}
}

12. 设置应用的样式和主题

到目前为止,您还没有为任何可组合项设置过样式,但已经获得了一个不错的默认效果,包括支持深色模式!下面我们来了解一下 BasicsCodelabThemeMaterialTheme

如果您打开 ui/theme/Theme.kt 文件,您会看到 BasicsCodelabTheme 在其实现中使用了 MaterialTheme

// Do not copy
@Composable
fun BasicsCodelabTheme(
    darkTheme: Boolean = isSystemInDarkTheme(),
    // Dynamic color is available on Android 12+
    dynamicColor: Boolean = true,
    content: @Composable () -> Unit
) {
    // ...

    MaterialTheme(
        colorScheme = colorScheme,
        typography = Typography,
        content = content
    )
}

MaterialTheme 是一个可组合函数,体现了 Material Design 规范中的样式设置原则。样式设置信息会逐级向下传递到位于其 content 内的组件,这些组件会读取该信息来设置自身的样式。您在界面中已经使用了 BasicsCodelabTheme,如下所示:

    BasicsCodelabTheme {
       
MyApp(modifier = Modifier.fillMaxSize())
   
}

由于 BasicsCodelabThemeMaterialTheme 包围在其内部,因此 MyApp 会使用该主题中定义的属性来设置样式。从任何后代可组合项中都可以检索 MaterialTheme 的三个属性:colorSchemetypographyshapes。使用它们设置其中一个 Text 的标题样式:

            Column(modifier = Modifier
               
.weight(1f)
               
.padding(bottom = extraPadding.coerceAtLeast(0.dp))
           
) {
               
Text(text = "Hello, ")
               
Text(text = name, style = MaterialTheme.typography.headlineMedium)
           
}

上例中的 Text 可组合项会设置新的 TextStyle。您可以创建自己的 TextStyle,也可以使用 MaterialTheme.typography 检索由主题定义的样式(首选)。此结构支持您访问由 Material 定义的文本样式,例如 displayLarge, headlineMedium, titleSmall, bodyLarge, labelMedium 等。在本例中,您将使用主题中定义的 headlineMedium 样式。

下面我们构建应用来查看采用新样式的文本:

673955c38b076f1c.png

通常来说,最好是将颜色、形状和字体样式放在 MaterialTheme 中。例如,如果对颜色进行硬编码,将会很难实现深色模式,并且需要进行大量修正工作,而这很容易造成错误。

不过,有时除了选择颜色和字体样式,您还可以基于现有的颜色或样式进行设置。

为此,您可以使用 copy 函数修改预定义的样式。将数字加粗:

import androidx.compose.ui.text.font.FontWeight
// ...
Text(
   
text = name,
   
style = MaterialTheme.typography.headlineMedium.copy(
       
fontWeight = FontWeight.ExtraBold
   
)
)

这样一来,如果您需要更改 headlineMedium 的字体系列或其他任何属性,就不必担心出现细微偏差了。

现在,预览窗口中的结果应如下所示:

b33493882bda9419.png

设置深色模式预览

目前,我们的预览仅会显示应用在浅色模式下的显示效果。使用 UI_MODE_NIGHT_YESGreetingPreview 添加额外的 @Preview 注解:

import android.content.res.Configuration.UI_MODE_NIGHT_YES

@Preview(
   
showBackground = true,
   
widthDp = 320,
   
uiMode = UI_MODE_NIGHT_YES,
   
name = "GreetingPreviewDark"
)
@Preview(showBackground = true, widthDp = 320)
@Composable
fun GreetingPreview() {
   
BasicsCodelabTheme {
       
Greetings()
   
}
}

系统随即会添加一个深色模式的预览。

2c94dc7775d80166.png

微调应用的主题

您可以在 ui/theme 文件夹内的文件中找到与当前主题相关的所有内容。例如,我们到目前为止所使用的默认颜色均在 Color.kt 中定义。

首先,我们来定义新的颜色。将以下代码添加到 Color.kt 中:

val Navy = Color(0xFF073042)
val
Blue = Color(0xFF4285F4)
val
LightBlue = Color(0xFFD7EFFE)
val
Chartreuse = Color(0xFFEFF7CF)

现在,将这些颜色分配给 Theme.kt 中的 MaterialTheme 的调色板:

private val LightColorScheme = lightColorScheme(
    surface
= Blue,
    onSurface
= Color.White,
    primary
= LightBlue,
    onPrimary
= Navy
)

如果您返回 MainActivity.kt 并刷新预览,预览颜色实际上并不会改变!这是因为,您的预览将默认使用动态配色。您可以在 Theme.kt 中查看使用 dynamicColor 布尔值参数添加动态配色的逻辑。

如需查看非自适应版本的配色方案,请在 API 级别低于 31(对应引入了自适应配色的 Android S)的设备上运行您的应用。您会看到新颜色:

493d754584574e91.png

Theme.kt 中,定义针对深色的调色板:

private val DarkColorScheme = darkColorScheme(
    surface
= Blue,
    onSurface
= Navy,
    primary
= Navy,
    onPrimary
= Chartreuse
)

现在,当我们运行应用时,会看到深色的实际效果:

84d2a903ffa6d8df.png

Theme.kt 的最终代码

import android.app.Activity
import android.os.Build
import androidx.compose.foundation.isSystemInDarkTheme
import androidx.compose.material3.MaterialTheme
import androidx.compose.material3.darkColorScheme
import androidx.compose.material3.dynamicDarkColorScheme
import androidx.compose.material3.dynamicLightColorScheme
import androidx.compose.material3.lightColorScheme
import androidx.compose.runtime.Composable
import androidx.compose.runtime.SideEffect
import androidx.compose.ui.graphics.Color
import androidx.compose.ui.graphics.toArgb
import androidx.compose.ui.platform.LocalContext
import androidx.compose.ui.platform.LocalView
import androidx.core.view.ViewCompat

private val DarkColorScheme = darkColorScheme(
   
surface = Blue,
   
onSurface = Navy,
   
primary = Navy,
   
onPrimary = Chartreuse
)

private val LightColorScheme = lightColorScheme(
   
surface = Blue,
   
onSurface = Color.White,
   
primary = LightBlue,
   
onPrimary = Navy
)

@Composable
fun BasicsCodelabTheme(
   
darkTheme: Boolean = isSystemInDarkTheme(),
   
// Dynamic color is available on Android 12+
   
dynamicColor: Boolean = true,
   
content: @Composable () -> Unit
) {
   
val colorScheme = when {
       
dynamicColor && Build.VERSION.SDK_INT >= Build.VERSION_CODES.S -> {
           
val context = LocalContext.current
           
if (darkTheme) dynamicDarkColorScheme(context) else dynamicLightColorScheme(context)
       
}
       
darkTheme -> DarkColorScheme
       
else -> LightColorScheme
   
}
   
val view = LocalView.current
   
if (!view.isInEditMode) {
       
SideEffect {
           
(view.context as Activity).window.statusBarColor = colorScheme.primary.toArgb()
           
ViewCompat.getWindowInsetsController(view)?.isAppearanceLightStatusBars = darkTheme
       
}
   
}

   
MaterialTheme(
       
colorScheme = colorScheme,
       
typography = Typography,
       
content = content
   
)
}

13. 收尾!

在此步骤中,您将实际运用已掌握的知识,并通过几条提示来学习几个新的概念。您将创建以下内容:

8d24a786bfe1a8f2.gif

用图标替换按钮

  • IconButton 可组合项与子级 Icon 结合使用。
  • 使用 material-icons-extended 制品中提供的 Icons.Filled.ExpandLessIcons.Filled.ExpandMore。将以下代码行添加到 app/build.gradle.kts 文件中的依赖项中。
implementation("androidx.compose.material:material-icons-extended")
  • 修改内边距以修正对齐问题。
  • 为无障碍功能添加内容说明(请参阅下面的“使用字符串资源”)。

使用字符串资源

应该为“Show more”和“show less”提供内容说明,您可以通过简单的 if 语句进行添加:

contentDescription = if (expanded) "Show less" else "Show more"

不过,硬编码字符串的方式并不可取,应该从 strings.xml 文件中获取字符串。

您可以通过对每个字符串使用“Extract string resource”(在 Android Studio 中的“Context Actions”中提供)来自动执行此操作。

或者,打开 app/src/res/values/strings.xml 并添加以下资源:

<string name="show_less">Show less</string>
<string name="show_more">Show more</string>

展开

“Composem ipsum”文字会在显示后消失,触发每张卡片的大小变化。

  • 将新的 Text 添加到 Greeting 中当内容展开时显示的 Column 中。
  • 移除 extraPadding 并改为将 animateContentSize 修饰符应用于 Row。这会自动执行创建动画的过程,而手动执行该过程会很困难。此外,也不需要再使用 coerceAtLeast

添加高度和形状

  • 您可以结合使用 shadow 修饰符和 clip 修饰符来实现卡片外观。不过,有一种 Material 可组合项也可以做到这一点:Card。您可以通过调用 CardDefaults.cardColors 并覆盖想要更改的颜色,以此来更改 Card 的颜色。

最终代码

package com.example.basicscodelab

import android.content.res.Configuration.UI_MODE_NIGHT_YES
import android.os.Bundle
import androidx.activity.ComponentActivity
import androidx.activity.compose.setContent
import androidx.compose.animation.animateContentSize
import androidx.compose.animation.core.Spring
import androidx.compose.animation.core.spring
import androidx.compose.foundation.layout.Arrangement
import androidx.compose.foundation.layout.Column
import androidx.compose.foundation.layout.Row
import androidx.compose.foundation.layout.fillMaxSize
import androidx.compose.foundation.layout.padding
import androidx.compose.foundation.lazy.LazyColumn
import androidx.compose.foundation.lazy.items
import androidx.compose.material.icons.Icons.Filled
import androidx.compose.material.icons.filled.ExpandLess
import androidx.compose.material.icons.filled.ExpandMore
import androidx.compose.material3.Button
import androidx.compose.material3.Card
import androidx.compose.material3.CardDefaults
import androidx.compose.material3.Icon
import androidx.compose.material3.IconButton
import androidx.compose.material3.MaterialTheme
import androidx.compose.material3.Surface
import androidx.compose.material3.Text
import androidx.compose.runtime.Composable
import androidx.compose.runtime.getValue
import androidx.compose.runtime.mutableStateOf
import androidx.compose.runtime.saveable.rememberSaveable
import androidx.compose.runtime.setValue
import androidx.compose.ui.Alignment
import androidx.compose.ui.Modifier
import androidx.compose.ui.res.stringResource
import androidx.compose.ui.text.font.FontWeight
import androidx.compose.ui.tooling.preview.Preview
import androidx.compose.ui.unit.dp
import com.example.basicscodelab.ui.theme.BasicsCodelabTheme

class MainActivity : ComponentActivity() {
   
override fun onCreate(savedInstanceState: Bundle?) {
       
super.onCreate(savedInstanceState)
       
setContent {
           
BasicsCodelabTheme {
               
MyApp(modifier = Modifier.fillMaxSize())
           
}
       
}
   
}
}

@Composable
fun MyApp(modifier: Modifier = Modifier) {
   
var shouldShowOnboarding by rememberSaveable { mutableStateOf(true) }

   
Surface(modifier, color = MaterialTheme.colorScheme.background) {
       
if (shouldShowOnboarding) {
           
OnboardingScreen(onContinueClicked = { shouldShowOnboarding = false })
       
} else {
           
Greetings()
       
}
   
}
}

@Composable
fun OnboardingScreen(
   
onContinueClicked: () -> Unit,
   
modifier: Modifier = Modifier
) {
   
Column(
       
modifier = modifier.fillMaxSize(),
       
verticalArrangement = Arrangement.Center,
       
horizontalAlignment = Alignment.CenterHorizontally
   
) {
       
Text("Welcome to the Basics Codelab!")
       
Button(
           
modifier = Modifier.padding(vertical = 24.dp),
           
onClick = onContinueClicked
       
) {
           
Text("Continue")
       
}
   
}
}

@Composable
private fun Greetings(
   
modifier: Modifier = Modifier,
   
names: List<String> = List(1000) { "$it" }
) {
   
LazyColumn(modifier = modifier.padding(vertical = 4.dp)) {
       
items(items = names) { name ->
           
Greeting(name = name)
       
}
   
}
}

@Composable
private fun Greeting(name: String, modifier: Modifier = Modifier) {
   
Card(
       
colors = CardDefaults.cardColors(
           
containerColor = MaterialTheme.colorScheme.primary
       
),
       
modifier = modifier.padding(vertical = 4.dp, horizontal = 8.dp)
   
) {
       
CardContent(name)
   
}
}

@Composable
private fun CardContent(name: String) {
   
var expanded by rememberSaveable { mutableStateOf(false) }

   
Row(
       
modifier = Modifier
           
.padding(12.dp)
           
.animateContentSize(
               
animationSpec = spring(
                   
dampingRatio = Spring.DampingRatioMediumBouncy,
                   
stiffness = Spring.StiffnessLow
               
)
           
)
   
) {
       
Column(
           
modifier = Modifier
               
.weight(1f)
               
.padding(12.dp)
       
) {
           
Text(text = "Hello, ")
           
Text(
               
text = name, style = MaterialTheme.typography.headlineMedium.copy(
                   
fontWeight = FontWeight.ExtraBold
               
)
           
)
           
if (expanded) {
               
Text(
                   
text = ("Composem ipsum color sit lazy, " +
                       
"padding theme elit, sed do bouncy. ").repeat(4),
               
)
           
}
       
}
       
IconButton(onClick = { expanded = !expanded }) {
           
Icon(
               
imageVector = if (expanded) Filled.ExpandLess else Filled.ExpandMore,
               
contentDescription = if (expanded) {
                   
stringResource(R.string.show_less)
               
} else {
                   
stringResource(R.string.show_more)
               
}
           
)
       
}
   
}
}

@Preview(
   
showBackground = true,
   
widthDp = 320,
   
uiMode = UI_MODE_NIGHT_YES,
   
name = "GreetingPreviewDark"
)
@Preview(showBackground = true, widthDp = 320)
@Composable
fun GreetingPreview() {
   
BasicsCodelabTheme {
       
Greetings()
   
}
}

@Preview(showBackground = true, widthDp = 320, heightDp = 320)
@Composable
fun OnboardingPreview() {
   
BasicsCodelabTheme {
       
OnboardingScreen(onContinueClicked = {})
   
}
}

@Preview
@Composable
fun MyAppPreview() {
   
BasicsCodelabTheme {
       
MyApp(Modifier.fillMaxSize())
   
}
}

14. 恭喜

恭喜!您已经学完了 Compose 的基础知识!

本 Codelab 的解决方案

您可以从 GitHub 获取本 Codelab 的解决方案代码:

$ git clone https://github.com/android/codelab-android-compose

或者,您可以下载代码库 Zip 文件:

后续操作

请查看 Compose 开发者在线课程中的其他 Codelab:

深入阅读