Skip to content

Latest commit

 

History

History
163 lines (134 loc) · 7.03 KB

README.zh.md

File metadata and controls

163 lines (134 loc) · 7.03 KB
Raw

Kotlin IntelliJ Idea Plugin Android Studio Plugin

其他语言版本: English, 简体中文.

Install from Plugin Marketplace

AndProguard 简介

  • AndProguard 是一个帮助混淆源文件的插件，支持多种语言Java/Kotlin/Xml，支持批量混淆。
  • AndProguard 执行时会查找所有能修改的元素执行重命名，包括Java/Kotlin中的：类名、文件名、方法/函数名、字段/属性名、参数名和局部变量名， Xml中的属性名和文件名。
  • 它的原理是基于官方插件的重命名功能，在修改元素时会自动处理所有引用的修改；AndProguard 是在此基础上功能扩展。

AndProguard 能做什么？

  • 应用加固，增加 aab、apk 反编译的难度。
  • 降低 aab 包查重率，避免上架Google Play因查重率过高，导致下架或封号问题。

警告⚠️

  • AndProguard 是在本地操作，且任务执行是不可逆的，故务必做好代码备份或在版本分支工具管理下操作，否则代码将很难还原
  • 重命名会关联到build目录下的无效引用，故执行前务必清理build目录：执行 Build-Clean Project， 否则会出现阻塞任务的窗口

简单使用

只需选择想要混淆的文件或文件夹，右键菜单选择 AndProguard 或 ViewBinding：

AndProguard ViewBinding

  • AndProguard 支持对 Java/Kotlin/Xml 文件或文件夹使用。
  • ViewBinding 仅支持对 Xml 文件或文件夹使用，修改 Xml 时会自动处理 ViewBinding 引用。

设置

AndProguard

  • 自定义命名规则（Custom naming）：支持自定以类名，方法名，变量名等等命名规则。
  • 白名单（Exclude package）：填写包名，多个包名使用符号;衔接，对文件夹执行任务时会忽略填写的目录。
  • 是否跳过数据类（Skip data）：执行任务时会跳过 Java 中的 getter或setter 方法和对应的字段， 以及 Kotlin 中的 Data 类的构造方法内的成员参数。

自定义命名规则

1 标识 []：四位标识确定随机字符的范围

[ 0 | 1 0 | 1 0 | 1 0 | 1 ]
* 大写字母 小写字母 数字 下划线 *
* A-Z a-z 0-9 _ *

2 长度 ()：随机字符或组合的重复次数

闭区间表示 (start, end) 或固定长度表示 (length)

3 简单示例：

[1000](1)[0100](3,9) （大驼峰伪单词）表示大写字母开头，后接3至9位小写字母

4 复用组合 {}：

{[1000](1)[0100](3,9)}(2,3) 表示2至3个大驼峰伪单词

5 固定字符串 <>：

{[1000](1)[0100](3,9)}(1,2)<Activity> 表示1至2个大驼峰伪单词，后接 Activity

注意事项

  • AndProguard 不侵入打包流程，无法混淆编译后的 Class 文件，需要在打包前执行。
  • 自定义命名规则务必保证符合命名规范，否则替换名字将会不执行或出现不可预知的错误。
  • 复用规则{}不宜嵌套过深，会影响执行效率。

混淆示例

>>>>>>>>>>>>>>>>>>>>>>>>>>>>>> 2024-02-26 10:36:06 [Refactor Start] <<<<<<<<<<<<<<<<<<<<<<<<<<<<<<
============================== FirstActivity.java ==============================
[Parameter] savedInstanceState >>> zzsgywjb
[Variable] tvConxx >>> nezKgxdj
[Class] FirstActivity >>> UvhcjqGtckkpxbAetfyjuwr
============================== ThirdActivity.java ==============================
[Class] ThirdActivity >>> NcimvcglhWqqfexwtro
============================== SecondActivity.java ==============================
[Parameter] savedInstanceState >>> xhvehlRkvb
[Class] SecondActivity >>> SycwDmiajalvcmGwxspx
[Field] binding >>> vjmr
============================== EnumDemo.java ==============================
[Parameter] a >>> opvcpopgt
[Parameter] b >>> lfwaaousoUvwfmjvzy
[Class] EnumDemo >>> FzhqrTflkkxroxw
============================== ClassDemo.java ==============================
[Parameter] entityDemo >>> opozAebppg
[Parameter] entityDemoKt >>> ijedrFpsvx
[Method] entityDemo >>> cjflcxKnsqqa
[Parameter] interfaceDemo >>> yjwsnfiyzJlzdnrpzw
[Parameter] name >>> oxiqqxfZkqbno
[Parameter] age >>> zguasnucyYciupkict
[Parameter] name >>> hlis
[Parameter] age >>> bzjyOapgflcxi
[Parameter] entityDemo >>> sizyvghy
[Variable] aaa >>> lzlaiBuxmhtg
[Variable] bbb >>> oypjhhs
[Parameter] e >>> eklrdbIuauwkmt
[Variable] ccc >>> vgubr
[Variable] ddd >>> qbdgu
[Parameter] e >>> orkrhqn
[Variable] eee >>> fzqiavzovViqk
[Variable] fff >>> yauuslwddZhnogd
[Variable] ggg >>> umr
[Variable] ooo >>> eakdibwaShqojdo
[Variable] rrr >>> lqrhniMqflbxx
[Variable] hhh >>> utyvFufr
[Variable] iii >>> rzomEfjsoozia
[Variable] i >>> lxcxmc
[Variable] jjj >>> adiNfyjdajt
[Variable] list >>> cveonh
[Parameter] string >>> vsuzxdyjMzzqofn
[Variable] kkk >>> chaikbajHcfwbhux
[Variable] lll >>> lddxNqvldph
[Parameter] a >>> mrqiMpakrtqxx
[Method] innerMethodDemo >>> lcyosluklldq
[Parameter] ppp >>> iuluslj
[Method] methodDemo >>> wexfmEtpxzsBfqwnszxlm
[Parameter] lock >>> dla
[Reference] classDemo >>> jgvpwsoioIbmyqtakd
[Reference] classDemo >>> lkxu
[Reference] classDemo >>> inddngxwp
[Class] ClassDemo >>> RnlguqpppYzxsppqppk
[Field] context >>> lcqdcrflVuoelmv
[Field] age >>> vkpccnxqJbzjlgli
[Field] entityDemoKt >>> ejtdaygAcdws
============================== EntityDemo.java ==============================
[Parameter] id >>> meeghjaEgfhxthzn
[Parameter] name >>> sfqutsana
[Parameter] age >>> yoiekssRelhaq
[Reference] entityDemo >>> taa
[Reference] entityDemo >>> egcwzwtlaGrynpus
[Reference] entityDemo >>> xyxsuTtiv
[Class] EntityDemo >>> UunqipwmuaYrkk
[Field] age >>> whvifOxvjyj
============================== InterfaceDemo.java ==============================
[Parameter] an >>> uovaypz
[Method] forNothing >>> amkxcWoqiicuCpnjamni
[Class] InterfaceDemo >>> AwxfhxejkPxloxxhynuDdugh
============================== ReferenceDemo.java ==============================
[Variable] lkxu >>> ckznnvYnxhqzd
[Method] methodDemo >>> tgacbnwj
[Class] ReferenceDemo >>> CehrwPadepg
[Field] inddngxwp >>> wnwhxwiwy
============================== AnnotationDemo.java ==============================
[Class] AnnotationDemo >>> CqgkjxPjkauewbv
[Field] submit_edu >>> oapkdogv
[Field] submit_city >>> tihall
============================== InterfaceDemo2.java ==============================
[Parameter] an >>> iet
[Method] forJavaReference >>> cjzgwnMfmirpsoi
[Method] forKotlinReference >>> gszzibbq
[Class] InterfaceDemo2 >>> SxazzuodjgNcrs
>>>>>>>>>>>>>>>>>>>>>>>>>>>>>> 2024-02-26 10:36:11 [Refactor End] <<<<<<<<<<<<<<<<<<<<<<<<<<<<<<