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

崔榕椒Malcolm

于 2024-09-13 22:02:37 发布

阅读量279

点赞数 3

本文链接：https://blog.csdn.net/gitblog_09522/article/details/142227179

版权

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

fat-aar-android A gradle plugin that merge dependencies into the final aar file works with AGP 3.+ 项目地址: https://gitcode.com/gh_mirrors/fa/fat-aar-android

项目基础介绍及编程语言

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插件

修改根目录下的 build.gradle：

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

应用插件到你的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'
}