如何通过本地.pom文件在Android Studio中引入.aar及其依赖？

要同时加载本地.aar包和其.pom文件中声明的依赖，核心是让Gradle能正确识别本地Maven仓库的目录结构并读取pom文件，以下是具体步骤：

1. 按Maven规范整理文件目录 #

Gradle遵循Maven的仓库目录结构规则，你需要把.aar和.pom文件放到对应层级的目录中：

• 假设你的pom文件里的groupId是com.example，artifactId是my-library，version是1.0.0
• 目录结构应该是：本地仓库根目录/com/example/my-library/1.0.0/
• 把文件重命名为：my-library-1.0.0.aar和my-library-1.0.0.pom，放到上述目录下

如果不想手动建目录，也可以直接把文件放在项目的libs目录下，后续在仓库配置里做对应处理即可。

2. 配置本地Maven仓库路径 #

根据你使用的Gradle版本，选择对应的配置方式：

Gradle 7.0+（Android Studio Arctic Fox及以上） #

在项目根目录的settings.gradle中添加仓库配置：

dependencyResolutionManagement {
    repositoriesMode.set(RepositoriesMode.FAIL_ON_PROJECT_REPOS)
    repositories {
        google()
        mavenCentral()
        // 本地仓库绝对路径示例
        maven { url = uri("/Users/xxx/local-repo") }
        // 或者用项目相对路径，比如libs目录作为本地仓库
        // maven { url = uri(layout.projectDirectory.dir("libs")) }
    }
}

旧版Gradle（低于7.0） #

在项目根目录的build.gradle中配置：

allprojects {
    repositories {
        google()
        mavenCentral()
        maven { url = uri("/path/to/your/local-repo") }
    }
}

3. 添加依赖引用 #

在模块的build.gradle（比如app/build.gradle）中直接引用坐标即可，无需加@pom或额外指定transitive true（默认transitive就是开启状态）：

dependencies {
    implementation 'com.example:my-library:1.0.0'
}

常见问题排查 #

• 依赖仍未加载：检查pom文件的dependencies标签格式是否正确，确保每个依赖的groupId、artifactId、version都完整无误。
• Gradle找不到文件：核对目录结构和文件名是否完全匹配pom里的坐标信息，比如大小写、版本号是否一致。
• 验证依赖树：执行终端命令./gradlew app:dependencies（Windows用gradlew.bat app:dependencies），查看该依赖的传递依赖是否被正确加载，同时排查是否有冲突或报错信息。
• 避免混用@后缀：不要同时使用@aar或@pom，直接使用坐标引用，Gradle会自动匹配对应的aar和pom文件。

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