一,开启
当您使用 Android Gradle 插件 3.4.0 或更高版本构建项目时,该插件不再使用 ProGuard 来执行编译时代码优化,而是与 R8 编译器协同工作来处理以下编译时任务
android {
buildTypes {
release {
// Enables code shrinking, obfuscation, and optimization for only
// your project's release build type.
minifyEnabled true
// Enables resource shrinking, which is performed by the
// Android Gradle plugin.
shrinkResources true
// Includes the default ProGuard rules files that are packaged with
// the Android Gradle plugin. To learn more, go to the section about
// R8 configuration files.
proguardFiles getDefaultProguardFile(
'proguard-android-optimize.txt'),
'proguard-rules.pro'
}
}
...
}
自定义要保留的资源
tools:keep="@layout/l_used*_c,@layout/l_used_a,@layout/l_used_b*"
tools:discard="@layout/unused2" />
二,关键字
keep {Modifier} {class_specification} 保护指定的类文件和类的成员
keepclassmembers {modifier} {class_specification} 保护指定类的成员,如果此类受到保护他们会保护的更好
keepclasseswithmembers {class_specification} 保护指定的类和类的成员,但条件是所有指定的类和类成员是要存在。
keepnames {class_specification} 保护指定的类和类的成员的名称(如果他们不会压缩步骤中删除)
keepclassmembernames {class_specification} 保护指定的类的成员的名称(如果他们不会压缩步骤中删除)
keepclasseswithmembernames {class_specification} 保护指定的类和类的成员的名称,如果所有指定的类成员出席(在压缩步骤之后)
printseeds {filename} 列出类和类的成员-keep选项的清单,标准输出到给定的文件
dontobfuscate 不混淆输入的类文件
obfuscationdictionary {filename} 使用给定文件中的关键字作为要混淆方法的名称
overloadaggressively 混淆时应用侵入式重载
useuniqueclassmembernames 确定统一的混淆类的成员名称来增加混淆
flattenpackagehierarchy {package_name} 重新包装所有重命名的包并放在给定的单一包中
repackageclass {package_name} 重新包装所有重命名的类文件中放在给定的单一包中
dontusemixedcaseclassnames 混淆时不会产生形形色色的类名
keepattributes {attribute_name,...} 保护给定的可选属性,例如LineNumberTable, LocalVariableTable, SourceFile, Deprecated, Synthetic, Signature, and InnerClasses.
renamesourcefileattribute {string} 设置源文件中给定的字符串常量
三,哪些不可混淆
UI,自定义控件
序列化对象
webview调用的JavaScript
JNI
反射
枚举enum
第三方库
Gson的java bean
Parcelable 的子类和 Creator 静态成员变量不混淆
四,输出报告
dump.txt 描述apk文件中所有类文件间的内部结构。
mapping.txt 列出了原始的类,方法,和字段名与混淆后代码之间的映射。(R8 会将此文件保存在 /build/outputs/mapping// 目录中。)
seeds.txt 列出了未被混淆的类和成员
usage.txt 列出了从apk中删除的代码。
要输出 R8 在构建项目时应用的所有规则的完整报告,请将以下代码添加到模块的 proguard-rules.pro 文件中:
// You can specify any path and filename.
-printconfiguration tmp/full-r8-config.txt
五,多模块
子模块配置:
release {
consumerProguardFiles 'proguard-rules.pro'
}
只要app模块开了混淆,子模块无论是否打开混淆都是默认开启的
子模块的混淆规则是无法影响app模块的的。所以建议,在子模块里尽量只放和子模块相关的混淆规则,一些公有的混淆方式请放在app或者公有的模块中。
参考: