XmlClassGuard 简介

XmlClassGuard是一个可混淆任意类的Gradle插件，Android 4大组件、自定义View、任意类，只要你想，都可以将其混淆

为什么要写这个插件？

原生混淆中，Android 四大组件(Activity,Service等)、自定义View等只要在xml文件中用到的类，都不会被混淆，这样就会有以下2个缺点

• 通过反编译，可以轻松看到真实的类名及包名

• 有过上架Google Play 商店的同学应该知道，如果之前的包被下架或封号，想要同套代码再次上架，那99%概率是再次封号，很大一部分原因就是以上说到的类未被混淆， 被Google断定为包重复，从而导致再次封号

针对第二点，如果我们想要再次上架，就必须要更改四大组件、自定义View等的包名+类名，然而，如果手动去完成这项任务，估计会累死一个程序员，于是乎，就有XmlClassGuard，通过插件去完成手工的活，一个任务便可搞定

有什么用？

• 增加aab、apk反编译的难度

• 极大降低aab包查重率，避免上架Google Play因查重率过高，导致下架或封号问题

为什么取名XmlClassGuard?

XmlClassGuard虽然可以混淆任意类，但最主要的目的还是混淆xml文件用到的类，故取名为XmlClassGuard,与AndResGuard、AadResGuard对应

原理

XmlClassGuard不同于AndResGuard(apk资源混淆)、AadResGuard(aab资源混淆)侵入打包流程的方案，XmlClassGuard 需要在打包前执行xmlClassGuard任务，该任务会检索AndroidManifest.xml及navigation、layout 文件夹下的xml，找出xml文件中引用的类，如4大组件及自定义View等，更改其包名+类名，并将更改后的内容同步到其他文件中，说直白点，就是在打包前，在本地更改包名+类名

警告警告⚠️

由于是在本地操作，任务执行是不可逆的，故务必做好代码备份，否则代码将很难还原

上手

1、在build.gradle(root project)中配置

buildscript {
    repositories {
        maven { url 'https://jitpack.io' }
    }
    dependencies {
        classpath "com.github.liujingxing:XmlClassGuard:1.0.0-beta1"
    }
}

2、在 build.gradle(application) 中配置

apply plugin: "xml-class-guard"

//以下均为非必须
xmlClassGuard {
    //用于增量混淆的 mapping 文件
    mappingFile = file("xml-class-mapping.txt")
    //更改manifest文件的package属性，即包名
    packageChange = ["com.ljx.example": "ab.cd"]
    //移动目录
    moveDir = ["com.ljx.example": "ef.gh"]
}

此时就可以在Gradle栏中，找到以下3个任务

任务介绍

XmlClassGuard插件共有3个任务，分别是moveDir、packageChange及xmlClassGuard，下面将一一介绍

1、moveDir

moveDir是一个移动目录的任务，它支持同时移动任意个目录，它会将原目录下的所有文件(包括子目录)移动到另外一个文件夹下，并将移动的结果，同步到其他文件中，配置如下：

xmlClassGuard {
    //移动目录
    moveDir = ["com.ljx.example": "ef.gh",
               "com.ljx.example.test": "ff.gg"]
}

上面代码中moveDir是一个Map对象，其中key代表要移动的目录，value代表目标目录； 上面任务会把com.ljx.example目录下的所有文件，移动到ef.gh 目录下，将com.ljx.example.test目录下的所有文件移动到ff.gg目录下

2、packageChange

packageChange是一个更改manifest文件里package属性的任务，也就是更改app包名的任务(不会更改applicationId) ，改完后，会将更改结果，同步到其他文件中(不会更改项目结构)，配置如下：

xmlClassGuard {
    //更改manifest文件的package属性，即包名
    packageChange = ["com.ljx.example": "ab.cd"]
}

以上packageChange是一个Map对象，key为原始package属性，value为要更改的package属性，原始package属性不匹配，将更改失败

3、xmlClassGuard

xmlClassGuard是一个混淆类的任务，该任务会检索AndroidManifest.xml及navigation、layout 文件夹下的xml文件，找出xml文件中引用到的类，如4大组件及自定义View等，更改其包名+类名，并将更改的结果，同步到其他文件中，最后会将混淆映射写出到mapping文件中，配置如下：

xmlClassGuard {
    //用于增量混淆的 mapping 文件
    mappingFile = file("xml-class-mapping.txt")
}

上面配置的mappingFile可以是一个不存在的文件，混淆结束后，会将混淆映射写出到该文件中，如下：

dir mapping:
    com.ljx.example -> e
    com.ljx.example.activity -> dh

class mapping:
    com.ljx.example.AppHolder -> e.B
    com.ljx.example.activity.MainActivity -> dh.C

dir mapping是混淆的目录列表，class mapping 是具体类的混淆列表，以上内容，也可以手动写入，下次混淆时，便会根据此配置进行增量混淆，如果你需要混淆指定的类com.ljx.example.test.Test，便可以在dir mapping 下写入 com.ljx.example.test -> h,此时再次执行xmlClassGuard任务，便会将com.ljx.example.test目录下的所有类(不包含子目录下的类) 移动到h文件夹中，并将所有类名混淆，再次混淆的后mapping文件如下：

dir mapping:
    com.ljx.example -> e
    com.ljx.example.activity -> dh
    com.ljx.example.test -> h

class mapping:
    com.ljx.example.AppHolder -> e.B
    com.ljx.example.activity.MainActivity -> dh.C
    com.ljx.example.test.Test -> h.D

注：手动输入时，需要注意，混淆后的目录仅支持小写字母，类名仅支持大写字母，位数不限

注意事项⚠️

以上3个任务所作出的更改，仅仅会同步到所有的java文件、kt文件、AndroidManifest.xml文件及navigation和layout文件夹下xml文件；除此之外，如果有其他文件有影响到，则需要手动去更改，如配置混淆的proguard-rules.pro文件，moveDir任务有可能会移动混淆配置里keep的目录，xmlClassGuard也有可能混淆proguard-rules.pro文件keep的类，这些都需要手动去更改