fat-aar-android 项目常见问题解决方案

项目基础介绍

fat-aar-android 是一个用于将多个依赖项合并到最终的 AAR 文件中的 Gradle 插件。AAR 文件是 Android 库的文件格式，包含了 Android 开发中常用的资源、代码和清单文件等。该项目的主要编程语言是 Groovy 和 Java，其中 Groovy 用于编写 Gradle 插件，Java 用于处理 Android 相关的逻辑。

新手使用注意事项及解决方案

1. 项目不再维护，可能不兼容新版本的 Gradle

问题描述：项目作者已声明不再进行维护，因此可能不兼容新版本的 Gradle。

解决方案：

• 步骤1：尝试使用远程插件引用。在项目的根 build.gradle 文件中添加以下代码：

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

• 步骤2：如果在新版本的 Gradle 中无法正常工作，可以考虑 fork 该项目并自行修改。项目的代码结构并不复杂，可以根据需要进行调整。

2. 依赖项合并失败

问题描述：在使用 embed 关键字合并依赖项时，可能会遇到合并失败的问题。

解决方案：

• 步骤1：确保所有需要合并的依赖项都正确声明为 embed。例如：

  dependencies {
      embed project(':lib-aar')
      embed project(':lib-aar2')
  }
  

• 步骤2：检查依赖项的传递性。如果依赖项本身还有其他依赖，确保这些传递性依赖也正确声明为 embed。例如：

  dependencies {
      embed project(':subLib1')
      embed project(':subLib2')
  }
  

3. 远程依赖项无法正确合并

问题描述：在合并远程依赖项（如 Maven 仓库中的依赖）时，可能会遇到无法正确合并的问题。

解决方案：

• 步骤1：确保远程依赖项的版本号和坐标正确无误。例如：

  dependencies {
      embed 'com.google.guava:guava:20.0'
      embed 'com.facebook.fresco:fresco:1.12.0'
  }
  

• 步骤2：如果远程依赖项包含本地传递性依赖，确保这些依赖也正确声明为 embed。例如：

  dependencies {
      embed project(':subLib1')
      embed project(':subLib2')
  }
  

通过以上步骤，新手用户可以更好地理解和使用 fat-aar-android 项目，解决常见的问题。