Android混淆大全,一篇就够了
Proguard介绍
Android SDK自带了混淆工具Proguard。它位于SDK根目录\tools\proguard下面。 ProGuard是一个免费的Java类文件收缩,优化,混淆和预校验器。它可以检测并删除未使用的类,字段,方法和属性。它可以优化字节码,并删除未使用的指令。它可以将类、字段和方法使用短无意义的名称进行重命名。最后,预校验的Java6或针对Java MicroEdition的所述处理后的码。 如果开启了混淆,Proguard默认情况下会对所有代码,包括第三方包都进行混淆,可是有些代码或者第三方包是不能混淆的,这就需要我们手动编写混淆规则来保持不能被混淆的部分。
项目中如果含有多个module时,在主app中设置了混淆其他module都会混淆。 在App module build.gradle中
android
{
......
defaultConfig
{
......
}
buildTypes
{
release
{
minifyEnabled
true
zipAlignEnabled
true
shrinkResources
true
proguardFiles
getDefaultProguardFile('proguard-android.txt'), 'proguard-rules.pro'
}
}
......
}
上面这几个功能都是默认打开的,要关闭他们只需配置对应的规则即可。 混淆后默认会在工程目录app/build/outputs/mapping/release下生成一个mapping.txt文件,这就是混淆规则,我们可以根据这个文件把混淆后的代码反推回源本的代码,所以这个文件很重要,注意保护好。原则上,代码混淆后越乱越无规律越好,但有些地方我们是要避免混淆的,否则程序运行就会出错。
Proguard作用
Android中的“混淆”可以分为两部分,一部分是 Java 代码的优化与混淆,依靠 proguard 混淆器来实现;另一部分是资源压缩,将移除项目及依赖的库中未被使用的资源(资源压缩严格意义上跟混淆没啥关系,但一般我们都会放一起讲)。
基本指令
> -ignorewarning:是否忽略警告
> -optimizationpasses n:指定代码的压缩级别
(在
0~7之间,默认为
5)
> -dontusemixedcaseclassnames:是否使用大小写混合
(windows大小写不敏感,建议加入
)
> -dontskipnonpubliclibraryclasses:是否混淆非公共的库的类
> -dontskipnonpubliclibraryclassmembers:是否混淆非公共的库的类的成员
> -dontpreverify:混淆时是否做预校验
(Android不需要预校验,去掉可以加快混淆速度
)
> -verbose:混淆时是否记录日志
(混淆后会生成映射文件
)
> -obfuscationdictionary dictionary_path:指定外部模糊字典
> -classobfuscationdictionary dictionary_path:指定
class模糊字典
> -packageobfuscationdictionary dictionary_path:指定package模糊字典
> -optimizations
!code
/simplification
/arithmetic
,!field
/,!class/merging
/,!code
/allocation
/variable:混淆时所采用的算法
(谷歌推荐算法
)
> -libraryjars
libs(*.jar
;):添加支持的
jar(引入libs下的所有jar包
)
> -renamesourcefileattribute SourceFile:将文件来源重命名为“SourceFile”字符串
> -keepattributes Annotation:保持注解不被混淆
> -keep
class * extends java
.lang
.annotation
.Annotation
{*;}:保持注解不被混淆
> -keep interface
* extends java
.lang
.annotation
.Annotation
{ *; }:保持注解不被混淆
> -keepattributes Signature:保持泛型不被混淆
> -keepattributes EnclosingMethod:保持反射不被混淆
> -keepattributes Exceptions:保持异常不被混淆
> -keepattributes InnerClasses:保持内部类不被混淆
> -keepattributes SourceFile
,LineNumberTable:抛出异常时保留代码行号
> -keep
[,modifier,
...] class_specification:指定需要保留的类和类成员(作为公共类库,应该保留所有可公开访问的
public方法)
> -keepclassmembers
[,modifier,
...] class_specification:指定需要保留的类成员
:变量或者方法
> -keepclasseswithmembers
[,modifier,
...] class_specification:指定保留的类和类成员,条件是所指定的类成员都存在(既在压缩阶段没有被删除的成员,效果和keep差不多)
> -keepnames class_specification
:指定要保留名称的类和类成员,前提是在压缩阶段未被删除,仅用于模糊处理。
[-keep
> allowshrinking class_specification 的简写
]
> -keepclassmembernames class_specification:指定要保留名称的类成员,前提是在压缩阶段未被删除,仅用于模糊处理。
[-keepclassmembers
> allowshrinking class_specification 的简写
]
> -keepclasseswithmembernames class_specification:指定要保留名称的类成员,前提是在压缩阶段后所指定的类成员都存在,仅用于模糊处理。
[-keepclasseswithmembers
> allowshrinking class_specification 的简写
]
> -printseeds
[filename
]:指定详尽列出由各种
-keep选项匹配的类和类成员。列表打印到标准输出或给定文件。 该列表可用于验证是否真的找到了预期的类成员,特别是如果您使用通配符。
保持元素不参与混淆的规则的命令格式:
[保持命令] [类] {
[成员]
}
**类
**
代表类相关的限定条件,它将最终定位到某些符合该限定条件的类。它的内容可以使用:
具体的类
访问修饰符(
public、
protected、
private)
通配符
*,匹配任意长度字符,但不含包名分隔符
(.)
通配符
**,匹配任意长度字符,并且包含包名分隔符
(.)
extends,即可以指定类的基类
implement,匹配实现了某接口的类
$,内部类
**成员
**
代表类成员相关的限定条件,它将最终定位到某些符合该限定条件的类成员。它的内容可以使用:
<init
> 匹配所有构造器
<fields
> 匹配所有域
<methods
> 匹配所有方法
通配符
*,匹配任意长度字符,但不含包名分隔符
(.)
通配符
**,匹配任意长度字符,并且包含包名分隔符
(.)
通配符
***,匹配任意参数类型
…,匹配任意长度的任意类型参数。
比如
void test(…
)就能匹配任意
void test(String a
) 或者是
void test(int a
, String b
) 这些方法。
访问修饰符(
public、
protected、
private)
# 保持继承了BaseActivity的
public修饰的类名不被混淆
-keep
public class * extends com
.xing
.weijian
.base
.BaseActivity
# 内部类使用 $ 号,保持 TabFragment 中 内部类 OnFragmentData的所有
public 修饰的都不被混淆掉
-keepclassmembers
class com.xing
.weijian
.TabFragment$OnFragmentData
{
public *;
}
<init
> # 匹配所有构造函数
<fields
> # 匹配所有成员变量
<methods
> # 匹配所有的方法
可以在它们前面添加
private ,public 进行进一步更精细的限制范围
,比如保持 User 类中 所有
public 方法不被混淆:
-keep
class com.xing
.weijian
.bean
.User
{
public <methods
>;
}
也可以在方法中加入参数进行限定:比如 保持 User 类的
public 修饰,参数是 String 类型的方法不被混淆:
-keep
class com.xing
.weijian
.bean
.User
{
public <methods
>(String
);
}
内部类使用 $ 号,保持 TabFragment 中 内部类 OnFragmentData的所有
public 修饰的都不被混淆掉
-keepclassmembers
class com.xing
.weijian
.TabFragment$OnFragmentData
{
public *;
}
jni 方法不能混淆,因为这个方法需要和 native 方法保持一致
-keepclasseswithmembernames
class * { # 保持native方法不被混淆
native
<methods
>;
}
不混淆某个类
-keep public class com.android.proguard.example.Test { *
; }
不混淆某个包所有的类
-keep class com.android.proguard.example.** { *
; }
不混淆某个类的子类
-keep public class * extends com.android.proguard.example.Test { *
; }
不混淆所有类名中包含了“model”的类及其成员
-keep public class **.*model*.** {*
;}
不混淆某个接口的实现
-keep class * implements com.android.proguard.example.TestInterface { *
; }
不混淆某个类的构造方法
-keepclassmembers class com.android.proguard.example.Test {
public <init>
();
}
不混淆某个类的特定的方法
-keepclassmembers class com.android.proguard.example.Test {
public void
test(java.lang.String
);
}
不混淆某个类的内部类
-keep class com.android.proguard.example.Test$* {
*
;
}
keep 与 keepclassmembers , keepclasseswithmembers
配置混淆规则
#
--------------------------------------------基本指令区
--------------------------------------------#
-ignorewarning # 是否忽略警告
-optimizationpasses
5 # 指定代码的压缩级别
(在
0~7之间,默认为
5)
-dontusemixedcaseclassnames # 是否使用大小写混合
(windows大小写不敏感,建议加入
)
-dontskipnonpubliclibraryclasses # 是否混淆非公共的库的类
-dontskipnonpubliclibraryclassmembers # 是否混淆非公共的库的类的成员
-dontpreverify # 混淆时是否做预校验
(Android不需要预校验,去掉可以加快混淆速度
)
-verbose # 混淆时是否记录日志
(混淆后会生成映射文件
)
#指定外部模糊字典
-obfuscationdictionary dictionary1
.txt
#指定
class模糊字典
-classobfuscationdictionary dictionary1
.txt
#指定package模糊字典
-packageobfuscationdictionary dictionary2
.txt
#混淆时所采用的算法
(谷歌推荐算法
)
-optimizations
!code
/simplification
/arithmetic
,!field
,!class/merging
,!code
/allocation
/variable
#添加支持的
jar(引入libs下的所有jar包
)
-libraryjars
libs(*.jar
;)
#将文件来源重命名为“SourceFile”字符串
-renamesourcefileattribute SourceFile
#保持注解不被混淆
-keepattributes
*Annotation
*
-keep
class * extends java
.lang
.annotation
.Annotation
{*;}
#保持泛型不被混淆
-keepattributes Signature
#保持反射不被混淆
-keepattributes EnclosingMethod
#保持异常不被混淆
-keepattributes Exceptions
#保持内部类不被混淆
-keepattributes Exceptions
,InnerClasses
#抛出异常时保留代码行号
-keepattributes SourceFile
,LineNumberTable
#
------------------------------------默认保留区
--------------------------------------#
#保持基本组件不被混淆
-keep
public class * extends android
.app
.Fragment
-keep
public class * extends android
.app
.Activity
-keep
public class * extends android
.app
.Application
-keep
public class * extends android
.app
.Service
-keep
public class * extends android
.content
.BroadcastReceiver
-keep
public class * extends android
.content
.ContentProvider
-keep
public class * extends android
.app
.backup
.BackupAgentHelper
-keep
public class * extends android
.preference
.Preference
#保持 Google 原生服务需要的类不被混淆
-keep
public class com.google
.vending
.licensing
.ILicensingService
-keep
public class com.android
.vending
.licensing
.ILicensingService
#Support包规则
-dontwarn android
.support
.**
-keep
public class * extends android
.support
.v4
.**
-keep
public class * extends android
.support
.v7
.**
-keep
public class * extends android
.support
.annotation
.**
#保持 native 方法不被混淆
-keepclasseswithmembernames
class * {
native
<
;methods
>
;;
}
#保留自定义控件
(继承自View
)不被混淆
-keep
public class * extends android
.view
.View
{
*** get
*();
void set
*(***);
public <
;init
>
;(android
.content
.Context
);
public <
;init
>
;(android
.content
.Context
, android
.util
.AttributeSet
);
public <
;init
>
;(android
.content
.Context
, android
.util
.AttributeSet
, int);
}
#保留指定格式的构造方法不被混淆
-keepclasseswithmembers
class * {
public <
;init
>
;(android
.content
.Context
, android
.util
.AttributeSet
);
public <
;init
>
;(android
.content
.Context
, android
.util
.AttributeSet
, int);
}
#保留在Activity中的方法参数是view的方法
(避免布局文件里面onClick被影响
)
-keepclassmembers
class * extends android
.app
.Activity
{
public void *(android
.view
.View
);
}
#保持枚举
enum 类不被混淆
-keepclassmembers
enum * {
public static **[] values();
public static ** valueOf(java
.lang
.String
);
}
#保持
R(资源
)下的所有类及其方法不能被混淆
-keep
class **.R$
* { *; }
#保持 Parcelable 序列化的类不被混淆
(注:aidl文件不能去混淆
)
-keep
class * implements android
.os
.Parcelable
{
public static final android
.os
.Parcelable$Creator
*;
}
#需要序列化和反序列化的类不能被混淆
(注:Java反射用到的类也不能被混淆
)
-keepnames
class * implements java
.io
.Serializable
#持 Serializable 序列化的类成员不被混淆
-keepclassmembers
class * implements java
.io
.Serializable
{
static final
long serialVersionUID
;
private static final java
.io
.ObjectStreamField
[] serialPersistentFields
;
!static !transient
<
;fields
>
;;
!private <
;fields
>
;;
!private <
;methods
>
;;
private void writeObject(java
.io
.ObjectOutputStream
);
private void readObject(java
.io
.ObjectInputStream
);
java
.lang
.Object
writeReplace();
java
.lang
.Object
readResolve();
}
#保持 BaseAdapter 类不被混淆
-keep
public class * extends android
.widget
.BaseAdapter
{ *; }
#保持 CusorAdapter 类不被混淆
-keep
public class * extends android
.widget
.CusorAdapter
{ *; }
#
-------------------------------------webView区
---------------------------------------#
#WebView处理,项目中没有使用到webView忽略即可
#保持Android与JavaScript进行交互的类不被混淆
-keep
class **.AndroidJavaScript
{ *; }
-keepclassmembers
class * extends android
.webkit
.WebViewClient
{
public void *(android
.webkit
.WebView
,java
.lang
.String
,android
.graphics
.Bitmap
);
public boolean
*(android
.webkit
.WebView
,java
.lang
.String
);
}
-keepclassmembers
class * extends android
.webkit
.WebChromeClient
{
public void *(android
.webkit
.WebView
,java
.lang
.String
);
}
#网络请求相关
-keep
public class android.net
.http
.SslError
#
-------------------------------------删除代码区
--------------------------------------#
删除代码中Log相关的代码
-assumenosideeffects
class android.util
.Log
{
public static boolean
isLoggable(java
.lang
.String
, int);
public static int v(...);
public static int i(...);
public static int w(...);
public static int d(...);
public static int e(...);
}
#
---------------------------------1.实体类
---------------------------------
#
--------------------------------------------------------------------------
#
---------------------------------2.与JS交互的类
-----------------------------
#
--------------------------------------------------------------------------
#
---------------------------------3.反射相关的类和方法
-----------------------
#
--------------------------------------------------------------------------
#
---------------------------------2.第三方依赖
--------------------------------
#
--------------------------------------------------------------------------