You need to enable JavaScript to run this app. Android多模块库模块转KTS报Unresolved reference: android及共享配置示例咨询
优惠活动
大模型
产品
解决方案
定价
更多

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

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.11.13 05:06:04