XmlClassGuard混淆任意类,上架GooglePlay的杀手锏利器

·  阅读 7337
XmlClassGuard混淆任意类,上架GooglePlay的杀手锏利器

1、前言

各位同学,好久不见,这次给大家带来一个非常实用的插件XmlClassGuard,它可混淆Android 4大组件、自定义View等任意类,也许你会质疑这有什么用,但有过上架Google Paly的同学,估计看到标题就已迫不及待的想要了解XmlClassGuard了,简单理解,如果你的app被Google Play下架或封号,想要重新上架,就必须手动改一堆的包名+类名,这工作量少则2-3天,多则一个礼拜,甚至更久且容易改错;然而使用XmlClassGuard的话,仅需执行一个任务,30s内就可搞定,且不出错,简单的说,XmlClassGuard就是来解放你双手,助你成功上架Google Play的。

ok,接下来直接进入主题!!

加我微信 ljx-studio 拉你进XmlClassGuard交流群(备注来意,否则不通过)

2、XmlClassGuard 简介

  • XmlClassGuard是一个可混淆Android 4大组件、自定义View等任意类的插件

  • XmlClassGuard可以看作是ProGuard的补充,跟ProGuard没有任何关系,也不会有任何冲突

  • 可快速更改manifest文件里的package属性,并同步到其他文件中

  • 可快速移动n个目录到其他目录中,并同步到其他文件中

  • 可查找constraint_referenced_ids属性的值,并自动添加到AabResGuard的白名单中

  • XmlClassGuard最主要的功能是混淆xml文件用到的类,故取名为XmlClassGuard,与AndResGuardAabResGuard对应

3、有什么用?

  • 弥补ProGuard不混淆4大组件等类的问题

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

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

关于第三点,有过上架Google Play 商店的同学应该知道,如果之前的包被下架或封号,想要同套代码再次上架,那99%概率是再次封号,很大一部分原因就是上述说到的类未被混淆,很容易被Google断定为包重复,从而导致再次封号,因此,如果想要再次上架,就必须要更改四大组件、自定义View等的包名+类名以降低查重率,然而,如果手动去完成这项任务,估计会累死一个程序员,于是乎,就有了XmlClassGuard,通过插件去完成手工的活,一个任务便可搞定

4、原理

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

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

5、上手

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

buildscript {
    repositories {
        maven { url 'https://jitpack.io' }
    }
    dependencies {
        classpath "com.github.liujingxing:XmlClassGuard:1.1.1"
    }
}
复制代码

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

apply plugin: "xml-class-guard"

//以下均为非必须
xmlClassGuard {
    /*
     * 是否查找约束布局的constraint_referenced_ids属性的值,并添加到AabResGuard的白名单中,
     * true的话,要求你在XmlClassGuard前依赖AabResGuard插件,默认false
     */
    findConstraintReferencedIds = true
    //用于增量混淆的 mapping 文件
    mappingFile = file("xml-class-mapping.txt")
    //更改manifest文件的package属性,即包名
    packageChange = ["com.ljx.example": "ab.cd"]
    //移动目录
    moveDir = ["com.ljx.example": "ef.gh"]
}
复制代码

此时就可以在Gradle栏中,找到以下4个任务

image.png

6、任务介绍

XmlClassGuard插件共有4个任务,分别是findConstraintReferencedIdsmoveDirpackageChangexmlClassGuard,这4个任务之间没有任何关系,下面将一一介绍

6.1、findConstraintReferencedIds

该任务需要配合AabResGuard插件使用,如果你未使用AabResGuard插件,可忽略。

这里简单介绍下,由于约束布局constraint_referenced_ids属性的值,内部是通过getIdentifier方法获取具体的id,这就要求我们把constraint_referenced_ids属性的值添加进AabResGurad的白名单中,否则打包时,id会被混淆,打包后,constraint_referenced_ids属性会失效,UI将出现异常。

然而,项目中可能很多地方都用到constraint_referenced_ids属性,并且值非常多,要一个个找出来并手动添加到AabResGuard的白名单中,无疑是一项繁琐的工作,于是乎,findConstraintReferencedIds任务就派上用场了,它是在打包时,自动查找constraint_referenced_ids属性并添加进AabResGuard的白名单中,非常实用的功能,你仅需要在XmlClassGurad的配置findConstraintReferencedIds为true即可,如下:

//以下均为非必须
xmlClassGuard {
    /*
     * 是否查找约束布局的constraint_referenced_ids属性的值,并添加到AabResGuard的白名单中,
     * true的话,要求你在XmlClassGuard前依赖AabResGuard插件,默认false
     */
    findConstraintReferencedIds = true
}
复制代码

findConstraintReferencedIds任务不需要手动执行,打包(aab)时会自动执行

6.2、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目录下

6.3、packageChange

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

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

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

6.4、xmlClassGuard

xmlClassGuard是一个混淆类的任务,该任务会检索AndroidManifest.xmlnavigation、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
复制代码

image.png

dir mapping是混淆的目录列表,class mapping是具体类的混淆列表

6.5、混淆任意类

xmlClassGuard任务是支持增量混淆的,如果你需要混淆指定的类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
复制代码

手动输入混淆规则,需要注意以下几条规则

mapping_rule.jpg

6.6、每次混淆产生不一样的结果

默认情况下,每次混淆,都将产生一样的结果,混淆的包名根据哈希算法得出,混淆的类名,从大写字母A开启,依次递增,如:A B C ... Y Z BA BB .. ZY ZZ BAA...(可以看做26进制的字符串)

如果你需要每次混淆产生不一样的结果,只需做两步

  • 对于包名,需要你配置每一个

  • 对于类名,可以每一个都去配置,但类太多时,配置每一个,就显得繁琐,此时仅需要配置一个即可

如我们修改一下上面的mapping文件,如下

dir mapping:
    com.ljx.example -> hh
    com.ljx.example.activity -> jk
    com.ljx.example.test -> et

class mapping:
    com.ljx.example.AppHolder -> hh.Z
复制代码

此时执行xmlClassGuard任务,就会产生不一样的结果,如下:

dir mapping:
	com.ljx.example -> hh
	com.ljx.example.activity -> jk
	com.ljx.example.test -> et

class mapping:
	com.ljx.example.AppHolder -> hh.Z
	com.ljx.example.activity.MainActivity -> jk.BA
	com.ljx.example.test.Test -> et.BC
复制代码

可以看到,包名完全是根据自定义生成的结果,而类名便从Z开始,依次递增Z BA BC ..., 这里可以把包名看成26进制的字符串依次递增

7、注意事项⚠️

  • 混淆的类,要避免与其他类同名,否则类名替换时,会出现误杀情况

  • 类混淆后,类的包名(路径)也会被混淆,所以,如果你用到一些三方库,有配置包名的地方,记得手动更改

  • XmlClassGuard不会更改proguard-rules.pro文件的内容,所以,类混淆后,如果该文件内容有混淆前的类或目录,也记得手动更改

  • XmlClassGuard只会帮你更改包名+类名,并同步带其他文件中,不会更改你的任何代码逻辑,如混淆后,出现部分功能不正常问题,需要你自己查找原因,如果是XmlClassGuard的问题,欢迎提issuePR

8、打赏

如果它对你帮助很大,并且你很想支持库的后续开发和维护,那么你可以扫下方二维码随意打赏我,就当是请我喝杯咖啡或是啤酒,开源不易,感激不尽

donations.png

9、推荐阅读

RxHttp 让你眼前一亮的Http请求框架 (基础篇)

RxHttp ,比Retrofit 更优雅的协程体验 (RxHttp + Await)

RxHttp + Flow 三步搞定任意请求

RxHttp 完美适配Android 10/11 上传/下载/进度监听

RxHttp 全网Http缓存最优解

1.jpg

分类:
Android
收藏成功!
已添加到「」, 点击更改