环境搭建与 BOM

源：Compose 设置

在使用 Jetpack Compose 之前，需要确保您的开发环境已正确配置。

1. Android Studio 要求

推荐版本

建议使用最新稳定版的 Android Studio Koala 或更高版本，以获得最佳的实时预览（Preview）体验。

2. 配置 Gradle

libs.versions.toml (Version Catalog)

[versions]
composeBom = "2024.06.00"
# ...

[libraries]
androidx-compose-bom = { group = "androidx.compose", name = "compose-bom", version.ref = "composeBom" }
androidx-material3 = { group = "androidx.compose.material3", name = "material3" }
# ...

build.gradle.kts (Module: app)

android {
    buildFeatures {
        compose = true
    }
}

dependencies {
    // 引入 Compose BOM
    implementation(platform(libs.androidx.compose.bom))
    
    implementation(libs.androidx.material3)
    implementation(libs.androidx.ui)
    implementation(libs.androidx.ui.tooling.preview)
    debugImplementation(libs.androidx.ui.tooling)
}

3. 为什么使用 BOM？

什么是 BOM？

BOM (Bill of Materials) 是一个 Maven 仓库元数据文件，它定义了一组库及其相互兼容的版本号。

使用 BOM 的好处：

1. 版本一致性：不再需要手动协调 ui、material3、foundation 等库的版本。
2. 简化依赖：只需在 BOM 中指定版本，具体的库定义无需再写版本号。

4. Kotlin 兼容性检查

注意事项

Compose 编译器与 Kotlin 版本是强绑定的。

Kotlin 版本	编译器扩展版本 (Compose Compiler)
1.9.23	1.5.11
2.0.0	已经在 Kotlin 插件中内置

从 Kotlin 2.0 开始，Compose 编译器已经并入 Kotlin 仓库，不再需要单独配置版本号。