如何在Android Studio项目中通过Gradle版本目录导入本地库？

确保你的项目使用Gradle 7.0及以上版本（已支持Version Catalog），按以下步骤操作：

1. 配置Version Catalog文件（gradle/libs.versions.toml） #

在项目根目录的gradle文件夹下找到或创建libs.versions.toml文件，添加对应配置：

方式一：直接绑定版本到库定义 #

[libraries]
library-name = { name = "library-name-1.23.0", ext = "aar" }

方式二：版本与库定义分离（推荐，便于统一管理版本） #

[versions]
library-name = "1.23.0"

[libraries]
library-name = { name = "library-name-${versions.library-name}", ext = "aar" }

2. 配置本地仓库路径 #

在settings.gradle.kts（或Groovy版settings.gradle）的dependencyResolutionManagement区块中，添加本地libs目录作为仓库，让Gradle能定位到你的AAR文件：

Kotlin DSL（settings.gradle.kts） #

dependencyResolutionManagement {
    repositories {
        // 保留原有的远程仓库（如mavenCentral()）
        mavenCentral()
        // 添加本地flatDir仓库
        flatDir {
            dirs("libs")
        }
    }
}

Groovy DSL（settings.gradle） #

dependencyResolutionManagement {
    repositories {
        // 保留原有的远程仓库
        mavenCentral()
        // 添加本地flatDir仓库
        flatDir {
            dirs 'libs'
        }
    }
}

3. 在模块中引用库 #

在需要使用该库的模块（如app模块）的构建文件中，替换原有的依赖声明：

Kotlin DSL（build.gradle.kts） #

dependencies {
    // 替换原implementation(name: 'library-name-1.23.0', ext: 'aar')
    implementation(libs.libraryName)
}

Groovy DSL（build.gradle） #

dependencies {
    // 替换原implementation(name: 'library-name-1.23.0', ext: 'aar')
    implementation libs.libraryName
}

注意：Version Catalog会自动将toml文件中的连字符命名（如library-name）转换为驼峰式（libraryName）用于代码引用。

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