Fat-AAR 安装与配置完全指南

---

项目基础介绍及编程语言

Fat-AAR 是一个由 Kezong 开发的 Gradle 插件，旨在帮助 Android 开发者将依赖项合并到最终的 .aar 文件中，使之适用于 AGP 3.0 及以上版本。这个项目尤其适合那些需要打包多个模块或依赖为单一 SDK 分发的场景。项目的主要编程语言包括 Groovy 和少量的 Java。

关键技术和框架

• Gradle 插件: 通过自定义 Gradle 插件实现自动化依赖合并。
• Android Archive (.aar): 项目专注于处理这种特定的二进制格式，用于封装Android库的资源、代码等。
• 依赖管理: 有效管理本地与远程依赖的嵌入逻辑，支持选择性嵌入和transitive依赖控制。

准备工作和详细安装步骤

步骤一：环境要求

确保你的开发环境满足以下条件：

• Android Studio: 最新版推荐，以获得最佳兼容性。
• Gradle: 根据 Fat-AAR 支持列表，选择兼容的Gradle版本，避免如Gradle 8.0及以上版本可能存在的兼容性问题。
• JDK: 至少JDK 1.8，尽管项目已修复对JDK 1.8的兼容性问题（至v1.3.8）。

步骤二：引入Fat-AAR插件

1. 修改根目录下的 build.gradle：

   buildscript {
       repositories {
           mavenCentral()
       }
       dependencies {
           classpath 'com.github.kezong:fat-aar:1.3.8'
       }
   }
   

2. 应用插件到你的library模块： 打开你的库模块（通常是 app 或专门的库模块）的 build.gradle 文件，并加入以下内容：

   apply plugin: 'com.kezong.fat-aar'
   

步骤三：声明依赖的嵌入

在同个模块的 build.gradle 文件中的 dependencies 块，使用 embed 替代传统的 implementation 或 api，以便将依赖包含进最终的 .aar 文件。例如：

dependencies {
    implementation fileTree(dir: 'libs', include: ['*.jar'])
    embed project(':dependencyModule')
    // 添加对远程依赖的嵌入示例
    embed 'com.google.guava:guava:20.0'
}

步骤四：处理变体和配置

如果你的应用有不同构建类型或产品味道（flavors），确保正确地声明和嵌入对应的依赖。如果涉及本地依赖或特殊配置，可能需要调整 fataar 配置块，比如控制transitive属性。

步骤五：测试与验证

完成上述步骤后，同步Gradle项目，并执行一个编译任务，比如 assembleRelease，检查生成的 .aar 文件是否包含了所需的所有依赖。

注意事项

• 在较新版本的Gradle或Android Gradle插件上可能会遇到兼容性问题，此时考虑回滚至兼容版本或查找社区提供的解决方案。
• 使用 fat-aar 后，发布时应考虑到潜在的依赖冲突和增大后的 .aar 文件大小。
• 由于原作者不再进行维护，对于高级特性的需求可能需要自行研究或社区贡献。

通过遵循上述步骤，即便是初级开发者也能成功集成并利用Fat-AAR插件来简化Android库的分发过程。