开源项目ExcludeAar详解及新手指南

开源项目ExcludeAar详解及新手指南

项目基础介绍

项目名称: ExcludeAar
编程语言: 主要使用Groovy脚本，兼容Java，适用于Android开发环境
功能概述: ExcludeAar是一款专为Android开发者设计的Gradle插件，旨在解决库依赖中常见的类(class)和SO库冲突问题。它能够有效地从aar或jar文件中排除指定的包、类和SO库，确保项目的干净构建和避免运行时错误。

新手注意事项及解决方案

1. 配置问题

注意点:

新手在初次集成项目时可能会遇到配置Gradle插件不成功的问题。

解决步骤:

• 确认依赖: 确保在build.gradle(项目级别) 文件里加入了JitPack仓库以及插件的依赖：

  allprojects {
      repositories {
          maven { url 'https://jitpack.io' }
      }
  }
  
  classpath 'com.github.ssiyy:ExcludeAar:v1.0.1'
  

• 应用插件: 在各个模块的build.gradle文件中应用插件，并设置必要的配置:

  apply plugin: 'exclude_plugin'
  
  excludePluginExt {
      aars {
          ... // 添加具体的aar处理规则
      }
  }
  

2. 过滤规则设置错误

注意点:

错误的过滤规则可能导致所需类或库未被正确排除或误排除。

解决步骤:

• 精确匹配: 检查excludePackages, excludeClasses, excludeSos, 和 excludeSoAbis 的设置，确保它们是正确的全限定名或路径。
• 调试验证: 在应用规则后，通过构建日志验证哪些文件被排除，确认符合预期。

3. 执行自定义过滤任务

注意点:

配置完成后，如果没有执行对应的过滤任务，可能不会实际产生过滤效果。

解决步骤:

• 手动触发任务: 构建前，确保已手动执行或让构建脚本自动触发如unZipAar等前置任务来解压和过滤aar/jar文件。
• 查看文档: 参考项目文档或示例，了解如何触发这些自定义的 Gradle 任务，例如可能需要通过命令行运行 ./gradlew yourCustomTaskName 或者在IDE中找到并执行该任务。

以上就是使用ExcludeAar项目时新手应当注意的几个关键点及其解决方案，遵循上述指导可以帮助您更顺利地集成和利用此工具解决依赖冲突问题。