/ExcludeAar

一个用于排除AAR包中冗余或者冲突类的gradle脚本(Jar包也适用)

Primary LanguageJava

排除AAR(Jar)包中冗余或者冲突类的gradle脚本

引入aar的冲突无所不在,通过远程依赖maven的包可以通过exclude关键字搭配modulegroup去除某个组,没办法去除具体的类。

那么如果是单独的aar包,想要排除aar下classes.jar包里的某个单独的包或者类怎么办?

需要接入的jar包已经带了腾讯X5核心,当前依赖的已经包含X5核心,冲突又该如何解决呢?

当前的gradle脚本可以解决。

1 效果展示

如excludelib/libs/exampleAAR.aar,左边是未去除的包结构,右边是去除com.baidu之后的:

aar排除

如excludelib/libs/exampleJAR.jar:

jar排除展示

2 如何使用

(1)将需要排除的aar或者jar包放在excludelib/libs下。

(2)更改excludelib/build.gradle

//需要排除的aar或者jar。(替换成需要排除的)
artifacts.add("exclude", file('libs/exampleAAR.aar'))
artifacts.add("exclude", file('libs/exampleJAR.jar'))

(3)设置排除规则 如果您需要排除aar,那么请更改excludelib/excludeAar.gradle;如果您需要排除jar,那么请更改excludelib/excludeJar.gradle

//需要排除的包名
def excludePackages = ['com.baidu']
//需要排除的类(需要全类名)
def excludeClasses = []

(4)运行排除任务

运行排除

排除后生成的aar在excludelib/build/excludeaar下,排除后生成的jar位于excludelib/build/excludejar。

然后就可以愉快的使用啦~

3 如何实现的

aar排除步骤:

1、获取到需要排除的原始AAR包

2、解压AAR包(zipTree配合Task Copy)

3、解压AAR包中的class.jar(zipTree配合Task Copy)

4、按照排除规则对解压的class.jar重新打包(Task Jar)

5、重新打包成AAR包(Task Zip)

jar排除步骤

1、获取到需要排除的原始jar包

2、解压jar包(zipTree配合Task Copy)

3、按照排除规则对解压的jar重新打包(Task Jar)

解压AAR/JAR包

task unZipAar(type: Copy) {
    def zipFile = getDefaultAar()
    def outputDir = unZipAarFile
    from zipTree(zipFile)
    into outputDir
}

主要原理:zipTree配合Copy,实现解压。

Copy Task官方讲解:https://docs.gradle.org/current/dsl/org.gradle.api.tasks.Copy.html

ziptree源码主要解析:创建一个新的file tree包含原来zip的内容,可以配合Copy实现解压。

public interface Project{
    /**
    * <p>Creates a new {@code FileTree} which contains the contents of the given ZIP file.
     * You can combine this method with the {@link #copy(groovy.lang.Closure)}
     * method to unzip a ZIP file
     * @param zipPath The ZIP file. Evaluated as per {@link #file(Object)}.
     * @return the file tree. Never returns null.
     */
    FileTree zipTree(Object zipPath);
}

按照排除规则对解压的jar重新打包(这个是重点)

task zipJar(type: Jar) {
    baseName = 'classes'
    from unZipJarFile
    destinationDir unZipAarFile
    exclude getExcludePackageRegex(excludePackages)
    exclude getExcludeClassRegex(excludeClasses)
}

这个步骤就是把之前解压的classes.jar文件,按照排除规则用Task Jar重新打包成jar文件。

Task Jar官方讲解:https://docs.gradle.org/current/dsl/org.gradle.jvm.tasks.Jar.html

Property/Method Description
baseName 压缩后的jar文件名。
from(sourcePaths) 需要压缩的目录。
destinationDir 压缩后存放的目录。
exclude(excludes) 需要排除的文件。

重新打包成AAR包

task excludeAar(type: Zip) {
    group 'ex'
    description '生成一个排除之后的aar包'
    baseName excludeAarName
    extension "aar"
    from unZipAarFile
    destinationDir excludeAarFile
}

对classes.jar处理完成的aar重打包,主要用到Task Zip。

Task Zip官方讲解:https://docs.gradle.org/current/dsl/org.gradle.api.tasks.bundling.Zip.html

Property/Method Description
group setGroup(String group) 将当前的Task设置到指定组。
description setDescription(@Nullable String description) Task描述。
baseName 压缩后的aar文件名。
extension 压缩后的文件扩展名。
from(sourcePaths) 需要压缩的目录。
destinationDir 压缩后存放的目录。

当前项目fork于https://github.com/Siy-Wu/ExcludeAar,非常感谢Siy-Wu。