Android多模块库模块转KTS报Unresolved reference: android及共享配置示例咨询
Unresolved reference: android 报错解决与共享库模块Kotlin DSL配置示例
核心报错原因
绝大多数该类报错,是因为未正确应用Android Library插件,导致Kotlin DSL脚本无法识别android扩展块。如果是使用共享脚本的场景,额外存在共享脚本未引入对应插件依赖的问题。
分步解决方案
1. 单库模块的基础Kotlin DSL配置
首先确保库模块自身的build.gradle.kts头部正确声明插件,示例:
plugins { // 必须先声明Android Library插件,才能解锁android扩展 id("com.android.library") id("kotlin-android") } // 之后就能正常使用android块了 android { namespace = "com.example.your.library" compileSdk = 34 defaultConfig { minSdk = 24 testInstrumentationRunner = "androidx.test.runner.AndroidJUnitRunner" consumerProguardFiles("consumer-rules.pro") } buildTypes { release { isMinifyEnabled = false proguardFiles( getDefaultProguardFile("proguard-android-optimize.txt"), "proguard-rules.pro" ) } } compileOptions { sourceCompatibility = JavaVersion.VERSION_1_8 targetCompatibility = JavaVersion.VERSION_1_8 } kotlinOptions { jvmTarget = "1.8" } } dependencies { // 模块依赖正常声明即可 }
注意:不要直接照搬Groovy的语法,比如Groovy里的
minifyEnabled false转Kotlin DSL要写成isMinifyEnabled = false。
2. 共享Android库模块的Kotlin DSL脚本配置
你需要的跨模块共享配置,最适合用**预编译脚本插件(Precompiled Script Plugin)**实现,放在buildSrc目录下即可全局复用,示例如下:
第一步:配置buildSrc的依赖
先创建buildSrc/build.gradle.kts,引入和项目版本完全一致的AGP、Kotlin插件依赖:
plugins { `kotlin-dsl` } repositories { google() mavenCentral() } dependencies { // 版本必须和项目根目录声明的AGP、Kotlin版本完全匹配 implementation("com.android.tools.build:gradle:8.1.2") implementation("org.jetbrains.kotlin:kotlin-gradle-plugin:1.9.10") }
第二步:编写共享的库模块配置脚本
在buildSrc/src/main/kotlin/下创建脚本,比如命名为android-library-convention.gradle.kts,写入所有库模块通用的配置:
// 这里必须先声明要应用的插件,才能在脚本内使用android扩展 plugins { id("com.android.library") id("kotlin-android") } // 通用配置抽离到这里,所有库模块自动生效 android { compileSdk = 34 defaultConfig { minSdk = 24 testInstrumentationRunner = "androidx.test.runner.AndroidJUnitRunner" } compileOptions { sourceCompatibility = JavaVersion.VERSION_1_8 targetCompatibility = JavaVersion.VERSION_1_8 } kotlinOptions { jvmTarget = "1.8" } }
第三步:在具体库模块中复用共享配置
每个库模块的build.gradle.kts只需要应用这个共享插件,再写自己独有的配置即可:
// 比如lib_network模块的build.gradle.kts plugins { // 直接引用刚才创建的共享脚本名(去掉后缀的.gradle.kts) id("android-library-convention") } android { // 只写当前模块独有的配置,比如命名空间 namespace = "com.example.lib.network" } dependencies { // 只写当前模块独有的依赖 implementation("com.squareup.okhttp3:okhttp:4.11.0") }
其他排查项
- 检查AGP版本,7.0及以上版本才完整支持Kotlin DSL的Android配置,低于该版本建议先升级
- 不要在根目录的
build.gradle.kts里用subprojects/allprojects遍历配置android块时,未提前给子项目应用com.android.library插件,这种写法本身就容易报错,推荐用上面的预编译脚本插件替代 - 如果是从Groovy迁移过来的,确认没有把原来的
apply plugin: 'com.android.library'放在android块之后,插件必须先应用才能识别扩展
内容的提问来源于stack exchange,提问作者Dhananjay Suresh
相关产品推荐
相关产品推荐

