如何避免手动添加AAR已包含的依赖？Android Gradle依赖管理问题

问题核心 #

直接通过implementation(name: 'myLibrary', ext: 'aar')引入本地AAR时，Gradle无法自动解析AAR内部的依赖——因为这种本地引入方式不会读取AAR对应的POM文件（传递依赖信息存储在POM中），导致必须手动补全依赖，造成冗余。

问题1：让AAR依赖自动被消费项目解析的方案 #

方案1：将AAR发布到本地Maven仓库（推荐） #

通过Gradle把AAR连同自动生成的POM文件一起发布到本地Maven仓库，这样引入时Gradle会自动读取POM中的传递依赖配置。

在AAR所在模块的build.gradle中添加发布配置：

plugins {
    id 'com.android.library'
    id 'maven-publish'
}

android {
    // 你的库基础配置（compileSdk、defaultConfig等）
}

afterEvaluate {
    publishing {
        publications {
            release(MavenPublication) {
                from components.release
                groupId 'com.yourcompany' // 自定义组ID
                artifactId 'myLibrary'    // 库名称
                version '1.0.0'           // 版本号
            }
        }
        repositories {
            mavenLocal() // 发布到本地Maven仓库
        }
    }
}

执行命令./gradlew publishToMavenLocal，将AAR和POM文件发布到本地仓库。

然后在消费项目中引入：

dependencies {
    implementation 'com.yourcompany:myLibrary:1.0.0'
}

此时Gradle会自动解析并引入AAR的所有传递依赖，无需手动添加。

方案2：手动生成并关联POM文件 #

如果不想发布到Maven仓库，可以手动创建POM文件声明传递依赖，再在Gradle中关联该文件。

1. 在AAR所在目录（如libs）创建myLibrary.pom文件，示例内容：

<?xml version="1.0" encoding="UTF-8"?>
<project xmlns="http://maven.apache.org/POM/4.0.0">
    <modelVersion>4.0.0</modelVersion>
    <groupId>com.yourcompany</groupId>
    <artifactId>myLibrary</artifactId>
    <version>1.0.0</version>
    <packaging>aar</packaging>
    <dependencies>
        <dependency>
            <groupId>com.intuit.sdp</groupId>
            <artifactId>sdp-android</artifactId>
            <version>1.1.1</version>
            <scope>compile</scope>
        </dependency>
    </dependencies>
</project>

2. 在消费项目的build.gradle中修改依赖配置，关联POM文件：

repositories {
    flatDir {
        dirs 'libs'
    }
}

dependencies {
    implementation group: 'com.yourcompany', name: 'myLibrary', version: '1.0.0', ext: 'aar'
}

Gradle会自动读取同目录下的POM文件，解析传递依赖。

问题2：AAR传递依赖最佳实践 #

1. 精准控制依赖暴露范围 #

• 用api声明需要暴露给消费项目的依赖：如果AAR中的某个依赖是消费项目也需要用到的API，用api声明；如果只是AAR内部使用，用implementation，避免不必要的依赖传递。
• 隔离内部依赖：测试依赖、仅内部工具类的依赖，使用testImplementation或implementation，防止传递到消费项目。

2. 统一依赖版本管理 #

在项目根目录的build.gradle中用ext块定义统一版本变量，AAR模块和消费项目都引用该变量，避免版本冲突：

ext {
    sdpVersion = '1.1.1'
}

AAR模块中：

implementation "com.intuit.sdp:sdp-android:$sdpVersion"

3. 主动排除冲突依赖 #

如果传递依赖出现版本冲突，可以在引入AAR时排除特定依赖，再手动引入兼容版本：

implementation('com.yourcompany:myLibrary:1.0.0') {
    exclude group: 'com.intuit.sdp', module: 'sdp-android'
}

4. 优先用Maven仓库管理AAR #

无论是本地Maven还是远程私有Maven仓库，都比直接引入本地AAR更便于传递依赖管理，同时支持版本迭代、依赖缓存等功能。

5. 定期检查依赖树 #

用Gradle命令查看依赖树，排查冗余或冲突：

./gradlew app:dependencies --configuration implementation

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