使用 Gradle 引入 AAR 库的两种方式

一、什么是AAR 文件

AAR 文件是 Android 的一个归档格式，类似于 JAR 文件，但它除了包含编译后的代码外，还包含资源文件、AndroidManifest.xml 文件等。这使得 AAR 文件可以更完整地封装一个 Android 库

二、使用 Gradle 引入 AAR 库的两种方式

1、第一种方式

将 AAR 文件放入项目的 libs 目录：确保你的 AAR 文件位于 libs 目录中，如果没有这个目录，可以手动创建一个。

在 build.gradle 文件中添加依赖：

dependencies {
    implementation files('libs/XXX-release.aar')
}

这种方式的优点是简单直接，不需要额外配置，只要文件路径正确即可

2、第二种方式

使用 implementation(name: 'XXX-release', ext: 'aar') 引入 AAR 文件
这种方式使用了 Gradle 的 DSL 语法，通常用于指定依赖项的名称和扩展名。相比于前一种方式，这种方式更灵活，但需要在 repositories 块中配置 AAR 文件所在的目录。

1、将 AAR 文件放入项目的某个目录（例如 libs 目录）。

2、在 build.gradle 文件的 repositories 块中配置 AAR 文件所在的目录：

repositories {
    flatDir {
        dirs 'libs'
    }
}

3、在 dependencies 块中添加依赖：

dependencies {
    implementation(name: 'XXX-release', ext: 'aar')
}

这种方式的优点是更灵活，适用于项目中有多个 AAR 文件或需要将库文件放在不同的目录中。

三、Gradle 8.0 及以上版本的变化

在 Gradle 8.0 及以上版本中，flatDir 方法不再支持直接引用本地 AAR 文件。这意味着通过 implementation(name: 'XXX-release', ext: 'aar') 的方式可能会出现不兼容的情况。

解决方法：

使用 fileTree 引入：

这种方式可以解决大多数本地依赖的问题，适用于将多个 AAR 文件放在 libs 目录下的场景：

dependencies {
    implementation fileTree(dir: 'libs', include: ['*.aar'])
}

注意：如果是moudle中引入aar，在app项目中需要调用moudle中的aar资源，则需将 

implementation fileTree(dir: 'libs', include: ['*.aar'])改为api  fileTree(dir: 'libs', include: ['*.aar'])

注：还有一种将 AAR 文件发布到本地 Maven 仓库方法，这里不做介绍