You need to enable JavaScript to run this app.
优惠活动
大模型
产品
解决方案
定价
更多

Android开发新手求助:我的依赖与插件为何与教程、官网差异大?

Room依赖配置(适配2.6+版本)

你遇到的问题确实是Room 2.6+版本更新带来的依赖结构变化,以下是正确的配置步骤:

  • 项目级build.gradle.kts(或build.gradle)添加KSP插件依赖:

    plugins {
        id("com.android.application") version "8.2.0" apply false
        id("org.jetbrains.kotlin.android") version "1.9.20" apply false
        id("com.google.devtools.ksp") version "1.9.20-1.0.14" apply false
    }
    

    注意:KSP版本必须和你的Kotlin版本严格匹配。

  • 模块级build.gradle.kts(或build.gradle)应用插件并添加Room依赖:

    plugins {
        id("com.android.application")
        id("org.jetbrains.kotlin.android")
        id("com.google.devtools.ksp") // 启用KSP
    }
    
    dependencies {
        // Room核心运行时依赖
        implementation("androidx.room:room-runtime:2.6.1")
        // Kotlin扩展(可选,简化Room操作)
        implementation("androidx.room:room-ktx:2.6.1")
        // 编译期处理器,必须用ksp而非implementation
        ksp("androidx.room:room-compiler:2.6.1")
    }
    

关键说明

  1. 为什么不能用implementation "androidx.room:room-compiler-processing:2.6.1"?
    room-compiler-processing是Room内部使用的底层库,不需要开发者直接引用。官网推荐的编译期依赖是room-compiler,配合KSP(或annotationProcessor)使用,因为注解处理器是编译阶段工具,不需要打包到APK中,用implementation会导致不必要的依赖冗余,且无法触发编译期代码生成。

  2. 版本差异的原因
    Room 2.6+重构了注解处理器架构,引入了room-compiler-processing来统一处理注解逻辑,因此依赖配置和旧版本(2.5及以下)有明显区别,官网文档已经同步更新了最新配置方式。

内容的提问来源于stack exchange,提问作者Ved

相关产品推荐
方舟 Agent Plan

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

最近更新时间:2026.06.23 17:47:05