迁移至Kotlin DSL后settings.gradle出现Unstable @Incubating Lint警告

问题场景 #

将项目从Groovy迁移至Kotlin DSL后，settings.gradle.kts中的以下配置触发Android Studio Lint警告“Unstable @Incubating”：

repositoriesMode.set(RepositoriesMode.FAIL_ON_PROJECT_REPOS)
repositories {
    google()
    mavenCentral()
    maven {
        url = uri("https://jitpack.io")
    }
}

当前使用AGP 8.1.3，通过IDE模板创建的全新Kotlin DSL项目同样存在该配置及警告，但Groovy版本的项目无此警告。疑问：这是Kotlin DSL的问题，还是Lint未对Groovy版本进行检测？

问题解析与解决 #

这既不是Kotlin DSL本身的问题，也不是Lint漏检Groovy版本，核心原因是Gradle对两种DSL的注解处理逻辑不同：

• RepositoriesMode.FAIL_ON_PROJECT_REPOS这个API本身标注了@Incubating（孵化中），属于官方明确提示的不稳定API，后续版本可能发生变更甚至被移除。
• Kotlin DSL是静态类型语言，IDE能精准识别并传递注解信息给Lint工具，因此触发了合规性警告；而Groovy DSL是动态类型，Lint对注解的检测敏感度更低，没触发警告，但Groovy版本使用该API同样存在不稳定风险。

消除警告的方案 #

• 抑制警告：在settings.gradle.kts顶部添加注解，忽略该不稳定API的警告：

  @Suppress("UnstableApiUsage")
  plugins {
      // 你的插件配置
  }
  // 后续的repositoriesMode配置
  

• 等待API稳定：后续Gradle版本将该API标记为稳定后，警告会自动消失。
• 替代方案：若项目不需要严格限制仓库配置，可考虑使用其他稳定的仓库模式，但目前FAIL_ON_PROJECT_REPOS是官方推荐的最佳实践，因此更建议用抑制注解的方式处理。

内容的提问来源于stack exchange，提问作者Bitwise DEVS