开源项目常见问题解决方案:fat-aar
1. 项目基础介绍和主要编程语言
fat-aar 是一个开源项目,旨在帮助开发者将依赖项(aar/jar 文件)合并到一个单独的 aar 文件中。这样,在应用模块包含这个 aar 文件时,可以直接引用其依赖项的代码和资源,无需再次导入。该项目主要支持 Android Gradle 插件版本 3.0.0-3.4.2 以及 Gradle 4.6-5.1.1。项目的主要编程语言是 Java 和 Groovy,因为 Android 的构建脚本通常使用 Groovy 编写。
2. 新手在使用这个项目时需要特别注意的3个问题和详细解决步骤
问题一:如何将 fat-aar 插件添加到项目中?
解决步骤:
- 打开项目的根目录下的
build.gradle文件。 - 在
buildscript下的repositories部分添加jcenter()。 - 在
dependencies部分添加以下依赖:classpath 'com.cpdroid:fat-aar:1.1.0' - 保存并同步项目。
问题二:如何在库模块中应用 fat-aar 插件并打包依赖项?
解决步骤:
- 打开库模块的
build.gradle文件。 - 在顶部添加以下应用插件代码:
apply plugin: 'com.android.library' apply plugin: 'com.cpdroid.fat-aar' - 确保
'com.cpdroid.fat-aar'插件是在'com.android.library'插件之后应用。 - 在
dependencies部分使用embedded关键字替代implementation或compile来打包目标依赖项到生成的 aar 文件中:embedded fileTree(dir: 'libs', include: ['*.aar']) embedded project(':moduleA') embedded 'com.gongwen:marqueelibrary:1.1.3' - 运行
gradle assemble任务(通常是assembleRelease),然后复制生成的 aar 文件到应用模块的libs目录。
问题三:如何配置 fat-aar 插件以忽略某些依赖项?
解决步骤:
- 在库模块的
build.gradle文件中,添加fataar配置块:android { compileSdkVersion 28 } fataar { verboseLog true ignoreAndroidSupport true ignoreDependencies 'com.google.code.gson:gson:2.8.2' } dependencies { implementation fileTree(dir: 'libs', include: ['*.jar']) } - 在
fataar配置块中,可以通过设置ignoreAndroidSupport为true来自动忽略 Android 支持包。 - 使用
ignoreDependencies来指定哪些依赖项不会被嵌入到 aar 文件中。按照group:name:version的模式匹配。 - 保存并同步项目。
以上步骤可以帮助新手开发者在使用 fat-aar 插件时避免常见的配置错误和混淆。
创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考



