Android Academy · 课时

您的第一个可组合函数

Q: 「您的第一个可组合函数」这节课中我会学到什么？

创建并预览一个可组合函数 你通过在浏览器中直接运行的动手代码来练习 Android Academy，全天候 AI 导师会在你学习这节课的过程中回答你的问题。

创建并预览一个可组合函数

您的第一个可组合函数 是 CoddyKit 上的免费 Android Academy 课时。这是第 2 节课，共 4 节。你可以在下方免费阅读本课时的完整内容 — 然后在浏览器中使用内置代码编辑器和全天候 AI 导师进行实践。这是 Android Academy 学习路径的一部分，你的进度在网页和 CoddyKit 应用中同步。 Android Academy 课程共包含 4 节课。

您的第一个可组合函数

可组合函数就是一个带有 @Composable 标记的 Kotlin 函数。让我们编写一个按姓名向用户问候的函数。

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

@Composable 注解

@Composable 注解告诉编译器，此函数可以生成用户界面并调用其他可组合函数。没有它，您就无法调用 Text、Button 或其他用户界面函数。

命名约定

生成用户界面的可组合函数应使用PascalCase 名词命名，例如 Greeting 或 ProfileCard，这与类相似。这样表示“此函数用于绘制某些内容”，而不是“此函数返回一个值”。

参数驱动用户界面

可组合函数与其他函数一样接受参数。这些参数就是您的输入。不同的参数会生成不同的用户界面。

@Composable
fun Greeting(name: String) {
    Text(text = "Welcome, $name")
}
// Greeting("Sam") and Greeting("Mia") render different text

调用可组合函数

可组合函数只能从其他可组合函数中调用。您可以通过嵌套调用来组合屏幕。

@Composable
fun WelcomeScreen() {
    Greeting(name = "Ada")
    Greeting(name = "Grace")
}

使用 setContent 承载

要实际显示可组合函数，Activity 会在 onCreate 中调用 setContent { }。这个 lambda 是 Compose 用户界面的根。

class MainActivity : ComponentActivity() {
    override fun onCreate(savedInstanceState: Bundle?) {
        super.onCreate(savedInstanceState)
        setContent {
            WelcomeScreen()
        }
    }
}

可组合函数返回 Unit

请注意，可组合函数不会返回用户界面对象。它们的返回类型是 Unit，并会在调用时以副作用的形式生成用户界面。构建用户界面依靠的是调用，而不是返回值。

默认参数

Kotlin 的默认参数在这里非常实用。为参数提供默认值后，调用方就可以省略该参数。

@Composable
fun Greeting(name: String = "Guest") {
    Text(text = "Hello, $name!")
}
// Greeting() shows "Hello, Guest!"

复用可组合函数

由于可组合函数本质上是函数，因此它们可以复用。定义一次 Greeting，然后用不同的姓名在任意位置调用它。这是避免重复用户界面代码的方法。

保持小巧

优秀的可组合函数应当小巧且专注。一个可组合函数应描述一个具有逻辑意义的用户界面片段。通过组合小型可组合函数来构建更大的屏幕。

整合起来

下面是一个完整的、连接到活动的第一个可组合函数。在设备上运行后，会显示“Hello, Compose!”。

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

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

快速检查

@Composable 注解允许函数执行什么操作？

回顾

您已经编写了第一个可组合函数。请记住：

使用 @Composable 标记用户界面函数。
使用 PascalCase 命名。
参数是决定用户界面形态的输入。
setContent { } 在活动中承载可组合函数。

常见问题解答

「您的第一个可组合函数」课时是免费的吗？

是的 — 「您的第一个可组合函数」的完整文本可在网页上免费阅读。要进行交互式练习（内置代码编辑器和全天候 AI 导师）并解锁 Android Academy 课程的其余内容，请升级到 CoddyKit PRO。 Android Academy 课程共包含 4 节课。

「您的第一个可组合函数」这节课中我会学到什么？

创建并预览一个可组合函数你通过在浏览器中直接运行的动手代码来练习 Android Academy，全天候 AI 导师会在你学习这节课的过程中回答你的问题。

学习 Android Academy 需要有经验吗？

无需任何先前经验。CoddyKit 上的 Android Academy 课程适合初学者到高级学习者，你可以从这里开始或从头开始，按照自己的节奏学习。这是第 2 节课，共 4 节。

「您的第一个可组合函数」课时需要多长时间？

大多数 CoddyKit 课程大约需要 5–10 分钟。每节课都很精短且互动，所以你能稳步进步，并在网页和应用中从离开的地方继续。

我能在这节 Android Academy 课中编写并运行代码吗？

能。每节 Android Academy 课都包含内置代码编辑器，你可以在浏览器中直接编写并运行真实代码，并获得即时 AI 反馈 — 无需本地设置。

此课程中的所有课时

← 返回 Android Academy