第一步:安装 Android Studio
- 🌐 访问 developer.android.com/studio 下载最新稳定版。
- 📦 根据操作系统选择安装包 (Windows / macOS / Linux)。
- ⚙️ 安装时建议勾选 Android Virtual Device (AVD) 组件。
- ✅ 首次启动会自动下载 SDK 和基础工具,请保持网络畅通。
💡 提示:如果下载速度慢,可以使用国内镜像或提前下载 SDK 包。
第二步:配置 Kotlin 插件
Android Studio 从 Arctic Fox 版本开始内置 Kotlin 插件,但建议检查更新:
- 打开 Settings / Preferences (Ctrl+Alt+S / Cmd+,)。
- 选择 Plugins → 搜索 “Kotlin”。
- 确保 Kotlin 插件已启用,版本为 1.9.x 或更高 (Compose 稳定要求)。
- 如果未安装,点击 “Install” 并重启 IDE。
| 📌 组件 | 版本要求 (推荐) | 说明 |
| Kotlin 插件 | 1.9.22+ | Compose 编译器兼容 |
| Android Gradle Plugin | 8.2+ | 与 Studio 版本匹配 |
| Compose BOM | 2024.02.00+ | 统一库版本管理 |
第三步:创建第一个 Compose 项目
- 点击 New Project → 选择 “Empty Compose Activity”。
- 项目名称:
MyFirstComposable,包名:com.example.myfirstcomposable。
- Minimum SDK:API 24 (Android 7.0) 以上。
- 确保勾选 “Use Kotlin DSL” 和 “Use Compose”。
📄 项目结构预览
🖥️ 第一个 Composable 代码 (MainActivity.kt)
package com.example.myfirstcomposable
import android.os.Bundle
import androidx.activity.ComponentActivity
import androidx.activity.compose.setContent
import androidx.compose.material3.*
import androidx.compose.runtime.Composable
import androidx.compose.ui.Modifier
import androidx.compose.ui.tooling.preview.Preview
class MainActivity : ComponentActivity() {
override fun onCreate(savedInstanceState: Bundle?) {
super.onCreate(savedInstanceState)
setContent {
MyFirstComposableTheme {
Greeting("Android")
}
}
}
}
@Composable
fun Greeting(name: String, modifier: Modifier = Modifier) {
Text(
text = "Hello, $name! 欢迎来到 Compose 世界 🎉",
modifier = modifier,
style = MaterialTheme.typography.headlineMedium
)
}
@Preview(showBackground = true)
@Composable
fun GreetingPreview() {
MyFirstComposableTheme {
Greeting("小开发者")
}
}
🚀 点击运行按钮 (▶) 选择模拟器或真机,即可看到 “Hello, Android!” 的 Composable 界面。
📋 环境搭建速查表
| 步骤 | 关键操作 | 验证方式 |
| 1. 安装 Studio | 下载安装包,运行安装向导 | 启动后出现 Welcome 界面 |
| 2. Kotlin 插件 | Plugins → 搜索 Kotlin → 启用/更新 | 新建项目时模板包含 Kotlin |
| 3. 创建 Compose 项目 | New Project → Empty Compose Activity | MainActivity 内出现 setContent |
| 4. 运行项目 | 选择 AVD 或 USB 设备 → Run | 模拟器显示 “Hello, Android!” |