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

Android Gradle插件3.x.x引入外部AAR库的正确配置语句咨询

嘿,刚好之前在AGP 3.x.x版本下折腾过AAR引入的配置,给你整理了两种靠谱的实现方式,看你场景选就行:

1. 直接引入本地AAR文件(快速方案)

如果只是临时引入单个AAR,直接把文件放到项目里就行:

  • 先把你的AAR文件拷贝到目标模块的libs目录下(比如app/libs,如果是业务模块就对应模块的libs文件夹)
  • 打开模块级的build.gradle(注意是app或业务模块的,不是项目根目录的那个),添加以下配置:
// 模块级 build.gradle (app 或自定义业务模块)
android {
    // 保留你原本的编译SDK、minSDK等配置
}

repositories {
    flatDir {
        dirs 'libs' // 声明AAR所在的目录
        // 如果有多个目录,可写成 dirs 'libs', '../other-module/libs'
    }
}

dependencies {
    // 替换成你的AAR文件名,**不要加 .aar 后缀**
    implementation(name: 'my-custom-sdk', ext: 'aar')
}

注意:AGP 3.x.x已经废弃了旧的compile关键字,必须用implementation(默认不传递依赖)或者api(需要依赖传递时用)。

2. 将AAR转为本地模块依赖(规范方案)

如果需要长期维护这个AAR,或者要和其他模块共享依赖,推荐转成本地模块:

  • 第一步:在项目根目录右键新建一个Android Library模块(比如命名为my-aar-library),创建后删掉自动生成的src目录(不需要)
  • 第二步:把AAR文件放到这个新模块的libs目录下,然后修改该模块的build.gradle:
// my-aar-library 模块的 build.gradle
configurations.maybeCreate("default")
artifacts.add("default", file('libs/my-custom-sdk.aar'))
  • 第三步:打开项目根目录的settings.gradle,添加这个模块的引用:
include ':app', ':my-aar-library'
  • 第四步:回到主模块(比如app)的build.gradle,在dependencies里添加依赖:
implementation project(':my-aar-library')

这种方式的好处是可以统一管理AAR的版本和依赖,后续更新AAR只需要替换文件即可,不用修改主模块的配置。

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

相关产品推荐
方舟 Agent Plan

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

最近更新时间:2026.05.19 08:16:05