Android Compose 依赖配置解读

文章目录

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 编译器版本

相关推荐
雨白14 小时前
单例设计模式:从 Java/Kotlin 实现到 Android 实战
android
hai_android18 小时前
一行 asLiveData,背后是一座生命周期的桥
android·java·kotlin
阿杰m19 小时前
Android源码第二十三章:Telephony、RIL 与 IMS——来电怎么到应用?
android
booboosui19 小时前
没人认领 .md:安卓把报告交给了音乐播放器打开
android
用户60709759149061 天前
AOSP 14 OTA 升级指导(四):update_engine 内部机制——Action 流水线与写盘
android
恋猫de小郭1 天前
Jetpack Compose 1.13 发布,憋了这么久终有交代了
android·前端·flutter
JMchen1231 天前
【Android 性能优化实战 60 讲】12 异步 Inflate 实战与痛击:源码拆解原生瓶颈,手写增强版布局预加载框架
android·性能优化·实战·启动优化·异步inflate·x2c
好的佩奇2 天前
蓝牙之设备角色与连接
android·flutter·蓝牙
雨白2 天前
Android 消息机制剖析:从 Handler 投递到 Looper 循环的全链路
android
GY-932 天前
【Android】数据分层和依赖注入
android