Android中org.jetbrains.kotlin.android与kotlin-gradle-plugin的区别及与kotlin-android的关联

1. org.jetbrains.kotlin.android vs org.jetbrains.kotlin:kotlin-gradle-plugin #

• 定位差异
  • org.jetbrains.kotlin:kotlin-gradle-plugin 是通用型Kotlin Gradle插件，适配所有基于Gradle构建的Kotlin项目——不管是后端服务、桌面应用还是Android项目，它只负责核心的Kotlin代码编译、依赖管理等基础构建逻辑。
  • org.jetbrains.kotlin.android 是Android专属的Kotlin Gradle插件，它是通用插件的扩展版本，在通用功能之上，额外添加了Android平台特有的构建支持：比如和Android Gradle插件协同处理Activity、ViewModel等组件的Kotlin编译，优化Jetpack Compose的Kotlin代码构建，适配Android多渠道（flavor、buildType）的编译逻辑，处理Kotlin代码与Android资源（如R类）的关联等。
• 引入方式差异
  • 通用插件一般在项目根目录的build.gradle/build.gradle.kts中全局声明（供子模块使用）：

    plugins {
        id("org.jetbrains.kotlin") version "1.9.20" apply false
    }
    

  • Android专属插件则在Android模块（如app模块）的构建脚本中引入，必须配合Android插件使用：

    plugins {
        id("com.android.application")
        id("org.jetbrains.kotlin.android")
    }
    

• 功能覆盖范围
  • 通用插件仅提供基础Kotlin编译能力，不涉及Android平台的任何特有逻辑。
  • Android专属插件除了基础编译，还会处理Android特有的构建需求，比如协程在Android项目中的构建支持、Kotlin代码与Android打包流程的整合等。

2. 与kotlin-android的关系 #

kotlin-android是org.jetbrains.kotlin.android的旧版插件ID。在Kotlin 1.6.x版本之前，Android开发者一直使用kotlin-android来引入Android专属的Kotlin插件，写法如下：

plugins {
    id("com.android.application")
    id("kotlin-android")
}

从Kotlin 1.6.x开始，JetBrains统一了官方插件的ID命名规范，将所有Kotlin相关插件的ID调整为org.jetbrains.kotlin.*格式，所以kotlin-android就成了org.jetbrains.kotlin.android的别名，两者指向的是同一个插件。目前官方推荐使用新ID，旧ID虽然还能兼容，但属于过渡性写法，后续可能会被移除。

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