Android Build Filter Gradle Plugin 常见问题解决方案

Android Build Filter Gradle Plugin 常见问题解决方案

项目基础介绍

Android Build Filter Gradle Plugin 是一个用于在 Android 构建过程中移除特定 Jar 包、AAR 包以及构建冗余 class 文件的 Gradle 插件。该插件可以帮助开发者清理构建产物中不必要的文件，优化项目构建结果。项目主要使用的编程语言是 Java。

新手常见问题及解决方案

问题一：如何添加和使用 Android Build Filter Gradle Plugin？

解决步骤：

1. 在项目的 build.gradle 文件中添加插件依赖。

   buildscript {
       repositories {
           maven { url 'https://jitpack.io' }
       }
       dependencies {
           classpath 'com.github.yanbober:android-build-filter-gradle-plugin:1.0.1'
       }
   }
   

2. 应用插件。

   apply plugin: 'buildfilter'
   

问题二：如何配置需要移除的 class 文件？

解决步骤：

1. 在对应模块的 build.gradle 文件中配置 buildClassFilter。

   buildClassFilter {
       sourceExcludes = ['YOUR CLASS', '**/BuildConfig*']
       jarExcludes = ['cn/sina/sdk/BuildConfig.class']
   }
   

   其中 sourceExcludes 用于指定项目中源码生成或 IDE 自动生成的 class 文件，而 jarExcludes 用于指定项目依赖的 AAR 或 Jar 包中需要移除的 class 文件。

问题三：如何检查和验证移除的文件？

解决步骤：

1. 构建项目后，在配置 buildClassFilter 的模块对应构建输出目录中查找校验文件。
2. 在 build/buildClassFilter/ 目录下可以找到 build-class-filter-report.md 文件，该文件中包含了被移除的文件列表和详细信息。
3. 检查报告文件中列出的被删除的 class 文件是否与预期一致，以及这些文件的移除是否对其他 class 文件产生影响。

通过以上步骤，新手开发者可以顺利地集成和使用 Android Build Filter Gradle Plugin，优化项目构建过程。