Kotlin DSL约定插件中minSdk版本应用异常问题排查

架构老林

2026-6-14

问题解答

1. 编译app模块时为何会同时编译Wear OS模块？

Gradle的任务依赖机制会自动构建依赖链上的所有模块：如果你的app模块通过dependencies声明直接或间接依赖了Wear OS模块（比如依赖了同时被Wear模块引用的共享库，或者误添加了Wear模块的依赖），编译app时会触发Wear模块的构建以满足依赖需求。
若执行的是全局构建任务（比如./gradlew build），Gradle会遍历项目中所有模块执行对应任务，而非仅针对app模块。
Android Studio的默认构建行为：如果使用"Make Project"而非"Make Module 'app'"，IDE会触发全项目所有模块的构建，导致Wear模块被编译。

2. 为何在约定插件中设置minSdk无效，而直接在模块的build.gradle.kts中设置即可生效？

可能的原因及排查方向：

插件应用错误：Wear OS模块可能误应用了ApplicationsConventionPlugin（对应minSdk=26）而非WearableApplicationsConventionPlugin。检查Wear模块的build.gradle.kts，确认插件引用是否正确：
```
// 正确的Wear模块插件引用
plugins {
    id("your-project.wearable-applications")
}
```
配置执行顺序问题：如果模块的build.gradle.kts中直接设置了minSdk，且该配置在约定插件应用之后执行，会覆盖插件中的设置。确保约定插件先于模块自定义配置生效（通常插件应在plugins块中声明，模块配置在其后）。

插件内配置写法错误：检查约定插件中设置minSdk的代码是否正确作用于android.defaultConfig，错误写法会导致配置不生效。正确示例：

fun Project.configureWearableKotlinAndroid() {
    plugins.apply("com.android.application")
    plugins.apply("org.jetbrains.kotlin.android")

    android {
        defaultConfig {
            minSdk = 30 // 确保此处配置正确
            targetSdk = 34
            // 其他必要配置
        }
    }
}