Android Gradle构建报错求助：版本目录与依赖转换问题

错误1：版本目录libs中，一个目录定义只能导入单个外部目录 #

原因 #

该错误源于Gradle版本目录（Version Catalog）的格式违规，常见场景包括：

• libs.versions.toml的[libraries]或[bundles]块中，某条目用dir属性指定了多个目录路径（dir仅支持单个目录）
• settings.gradle的dependencyResolutionManagement配置里，对同一个catalog重复导入了多个外部目录

解决方法 #

1. 检查libs.versions.toml：
   找到所有含dir的条目，确保每个dir仅对应单个路径，示例：

   # 错误写法
   [libraries]
   custom-lib = { dir = ["libs/module1", "libs/module2"] }
   
   # 正确写法
   [libraries]
   custom-lib1 = { dir = "libs/module1" }
   custom-lib2 = { dir = "libs/module2" }
   

2. 检查settings.gradle：
   确保每个catalog仅关联一个文件/目录，示例：

   // 错误写法
   dependencyResolutionManagement {
       versionCatalogs {
           libs {
               from(files("libs1.versions.toml"))
               from(files("libs2.versions.toml"))
           }
       }
   }
   
   // 正确写法：拆分到不同catalog，或合并到一个toml文件
   dependencyResolutionManagement {
       versionCatalogs {
           libs {
               from(files("libs.versions.toml"))
           }
           extraLibs {
               from(files("extra-libs.versions.toml"))
           }
       }
   }
   

错误2：无法将dagger.hilt.android.plugin:2.36转换为Dependency类型 #

原因 #

dagger.hilt.android.plugin是Hilt插件的ID，而非合法的Maven依赖坐标，直接将其作为classpath依赖会导致Gradle无法识别为有效Dependency类型。正确的Hilt Gradle插件坐标为com.google.dagger:hilt-android-gradle-plugin:版本号。

解决方法 #

修改根项目build.gradle（或build.gradle.kts）的插件配置：

1. 先在libs.versions.toml中定义Hilt版本：

   [versions]
   hilt = "2.36"
   
   [plugins]
   hilt-android = { id = "com.google.dagger.hilt.android", version.ref = "hilt" }
   

2. 再在根build.gradle中通过plugins块引入：

   plugins {
       id 'com.android.application' version '...' apply false
       id 'com.google.dagger.hilt.android' version libs.versions.hilt apply false
   }
   

   若使用传统buildscript块：

   buildscript {
       dependencies {
           classpath "com.google.dagger:hilt-android-gradle-plugin:${libs.versions.hilt.get()}"
       }
   }
   

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