Android Compose 依赖配置解读

文章目录

[libs.versions.toml 依赖项版本管理](#libs.versions.toml 依赖项版本管理)
project-dir/build.gradle.kts
app-dir/build.gradle.kts

libs.versions.toml 依赖项版本管理

AS 版本：
Android Studio Otter 3 Feature Drop | 2025.2.3

新建一个 Compose 项目

项目创建好后，在 $project-dir$ /gradle 中，有个名为 "libs.versions.toml" 的配置文件，里面配置了 [versions]、[libraries]、[plugins]。

复制代码

[versions]
agp = "8.13.1"
kotlin = "2.0.21"
coreKtx = "1.10.1"
composeBom = "2025.05.01"
...

[libraries]
androidx-core-ktx = { group = "androidx.core", name = "core-ktx", version.ref = "coreKtx" }
androidx-compose-bom = { group = "androidx.compose", name = "compose-bom", version.ref = "composeBom" }
androidx-compose-ui = { group = "androidx.compose.ui", name = "ui" }
androidx-compose-ui-graphics = { group = "androidx.compose.ui", name = "ui-graphics" }
...

[plugins]
android-application = { id = "com.android.application", version.ref = "agp" }
kotlin-android = { id = "org.jetbrains.kotlin.android", version.ref = "kotlin" }
kotlin-compose = { id = "org.jetbrains.kotlin.plugin.compose", version.ref = "kotlin" }
...

composeBom 是一个用来集中管理 Jetpack Compose 所有相关库版本。它内部使用的各个compose 子lib，都是兼容的。使用后，在依赖androidx-compose-ui 等其它相关的 compose lib 时，不需要指定 version

project-dir/build.gradle.kts

复制代码

plugins {
    alias(libs.plugins.android.application) apply false
    alias(libs.plugins.kotlin.android) apply false
    alias(libs.plugins.kotlin.compose) apply false
    ...
}

alias() 别名引用 libs.versions.toml 中 $plugins$ 下的 key，将 key name 中的 "-"替换成 "."

这里的 apply false ，表示在此根目录中不应用，而是在模块内使用时才去应用

app-dir/build.gradle.kts

复制代码

plugins {
    alias(libs.plugins.android.application)
    alias(libs.plugins.kotlin.android)
    alias(libs.plugins.kotlin.compose)
    id("kotlin-kapt")
    ...
}

alias 别名引用 libs.versions.toml 的 $plugins$ 插件

id("kotlin-kapt") , 使用 id 方式应用，因 kapt 属于 kotlin.android 的子插件

复制代码

dependencies {
    implementation(libs.androidx.core.ktx)
    implementation(libs.androidx.lifecycle.runtime.ktx)
    implementation(libs.androidx.activity.compose)
    implementation(platform(libs.androidx.compose.bom))
    implementation(libs.androidx.compose.ui)
    implementation(libs.androidx.compose.ui.graphics)
    implementation(libs.androidx.compose.ui.tooling.preview)
    implementation(libs.androidx.compose.material3)
    implementation(libs.androidx.material3)
	...
    androidTestImplementation(platform(libs.androidx.compose.bom))
    androidTestImplementation(libs.androidx.compose.ui.test.junit4)
    debugImplementation(libs.androidx.compose.ui.tooling)
    debugImplementation(libs.androidx.compose.ui.test.manifest)
}

implementation(platform(libs.androidx.compose.bom)) platform() 是一个专门用来 导入 BOM（物料清单） 的内置函数
platform() 是软约束：如果你手动给某个 Compose 库强行指定了一个更高的版本号，Gradle 会尊重你的选择。

enforcedPlatform() 是硬约束：强制整个项目（包括其他第三方库带进来的间接依赖）必须严格使用 BOM 里规定的版本

android 域配置 :

复制代码

android {
	buildFeatures {
        compose = true
    }
}

此外，在 AS 默认 Kotlin 版本小于2.0的的旧版中，可能看到

复制代码

android {
	composeOptions {
        kotlinCompilerExtensionVersion '1.5.4' // 依赖的 compose complier 编译器版本
    }
}

从 Kotlin 2.0 开始，Compose 编译器已整合进 Kotlin 官方仓库，即应用 alias(libs.plugins.kotlin.compose)，不需要单独指定 compose complier 编译器版本