Blog Detail

Android--混淆配置（比较详细的混淆规则）

• 2025-06-13 21:57:16
• Posted By : admin
• 南京世界杯

android studio自带java语言的ProGuard工具，主要用来压缩、优化、混淆，然后配合Gradle构建工具实现混淆。

在app module中统一配置混淆规则

我们可以直接在app module中build.gradle文件配置所有module需要混淆的规则。这样，其他module中就无需开启混淆。 首先在build.gradle 中将混淆的开关打开，即 minifyEnabled 置为 true

buildTypes {

release {

minifyEnabled true //开启混淆

zipAlignEnabled true //压缩优化

shrinkResources true //移出无用资源

proguardFiles getDefaultProguardFile('proguard-android.txt'), 'proguard-rules.pro' //默认的混淆文件以及我们指定的混淆文件

}

}

如果是model混淆，子模块混淆文件的指定是通过consumerProguardFiles这个属性来指定的，并不是proguardFiles 属性，而且我们无需配置其他的选项，只需要配置consumerProguardFiles属性就可以。该属性表示在打包的时候会自动寻找该module下我们指定的混淆文件对代码进行混淆。配置如下：

buildTypes {

release {

//minifyEnabled true //是否开启混淆，其实子模块中这个已经没有作用了，由主模块控制

consumerProguardFiles 'proguard-rules.pro' //子模块要用这个命令才能生效

}

然后就要去proguard-rules.pro写入我们的混淆的规则（如文件其名），防止重要的类被混淆移除了。

先特别介绍的是与保持相关元素不参与混淆的规则相关的几种命令：-keep 防止类和成员被移除或者被重命名 -keepnames 防止类和成员被重命名 -keepclassmembers 防止成员被移除或者被重命名 -keepclasseswithmembers 防止拥有该成员的类和成员被移除或者被重命名 -keepclasseswithmembernames 防止拥有该成员的类和成员被重命名

混淆规则：

1、有一些固定的混淆规则不需要更改：

#指定代码的压缩级别 -optimizationpasses 5

#包明不混合大小写 -dontusemixedcaseclassnames

#不去忽略非公共的库类 -dontskipnonpubliclibraryclasses

#优化 不优化输入的类文件 -dontoptimize

#预校验 -dontpreverify

#混淆时是否记录日志 -verbose

# 混淆时所采用的算法 -optimizations !code/simplification/arithmetic,!field/*,!class/merging/*

#保护注解 -keepattributes *Annotation*

2、理解通配符

-keep class cn.hadcn.test.** -keep class cn.hadcn.test.* 很多同学都搞不懂下面两个的区别，一颗星表示只是保持该包下的类名，而子包下的类名还是会被混淆；两颗星表示把本包和所含子包下的类名都保持；用以上方法保持类后，你会发现类名虽然未混淆，但里面的具体方法和变量命名还是变了，这时如果既想保持类名，又想保持里面的内容不被混淆，我们就需要以下方法了：

-keep class cn.hadcn.test.* {*;}

3、保证指定包名下的所有类及子包中所有的类不被混淆

例子1：com.lib.manager 包下面的类不混淆 -keep class com.lib.manager.**{*;} 例子2：v4包下面的所有类不混淆 -keep class android.support.v4.** { *; }

4、保证指定的类不被混淆

例子1：YiBaWiFiActivity 类不被混淆, YiBaWiFiActivity 完整包名：com.yiba.wifi.sdk.lib.activity.YiBaWiFiActivity -keep class com.yiba.wifi.sdk.lib.activity.YiBaWiFiActivity{*;} 例子2：v4 包下面的 ActivityCompat 类不被混淆 -keep class android.support.v4.app.ActivityCompat{*;}

5、不混淆指定类的子类

-keep class * extends pp.lib.User { *; } User 类的子类不混淆

6、指定接口不混淆

Callback 是一个接口，完整包名为：com.lib.impl.Callback

-keep interface com.lib.impl.Callback{ * ; }

7、指定接口的实现类不混淆

Callback 是一个接口，完整包名为：com.lib.impl.Callback . 所有的实现类都不会混淆。

-keep class * implements com.lib.impl.Callback { *; }

8、指定类的内部类不混淆

PhoneUtil 的源码如下：

package com.lib.manager;

import android.content.Context;

import android.os.AsyncTask;

/**

* Created by yiba_zyj on 2017/4/5.

*/

public class PhoneUtil {

public final static int APPID = 100 ;

public PhoneUtil( Context context ){

}

class MyTask extends AsyncTask {

@Override

protected Object doInBackground(Object[] params) {

return null;

}

}

}

PhoneUtil 有一个常量、一个构造函数、一个内部类。

混淆规则：

-keep class com.lib.manager.PhoneUtil$* { * ; }

9、构造函数不混淆

PhoneUtil 的源码如所示：

package com.lib;

/**

* Created by yiba_zyj on 2017/4/7.

*/

public class PhoneUtil {

public static final String aa = "1222" ;

public void run(){

}

}

混淆规则：PhoneUtil 的无参构造函数不混淆 。PhoneUtil 里面没有用到的 属性和方法将会被移除。

-keep class com.lib.PhoneUtil { public (); } 那么有参的构造函数的混淆规则是怎么样的？

混淆规则：PhoneUtil 的 参数为 Context 的构造函数不混淆

-keep class com.lib.PhoneUtil { public ( android.content.Context ); }

10、指定类的属性和方法不被混淆

原始类 PhoneUtil 代码如下，完整的包名为：com.lib.manager.PhoneUtil

package com.lib.manager;

import android.content.Context;

import android.util.DisplayMetrics;

import android.view.WindowManager;

/**

* Created by yiba_zyj on 2017/4/5.

*/

public class PhoneUtil {

public static final int AppID = 100 ;

/**

* 获得屏幕高度

* @param context

* @return

*/

public static int getScreenWidth(Context context) {

WindowManager wm = (WindowManager) context

.getSystemService(Context.WINDOW_SERVICE);

DisplayMetrics outMetrics = new DisplayMetrics();

wm.getDefaultDisplay().getMetrics(outMetrics);

return outMetrics.widthPixels;

}

/**

* 获得屏幕宽度

* @param context

* @return

*/

public static int getScreenHeight(Context context) {

WindowManager wm = (WindowManager) context

.getSystemService(Context.WINDOW_SERVICE);

DisplayMetrics outMetrics = new DisplayMetrics();

wm.getDefaultDisplay().getMetrics(outMetrics);

return outMetrics.heightPixels;

}

}

PhoneUtil 类中包含1个常量及2个方法.类中的变量不被混淆： -keep class com.lib.manager.PhoneUtil{ public static final int AppID ; } 混淆后的效果如下：

package com.lib.manager;

public class PhoneUtil {

public static final int AppID = 100;

public PhoneUtil() {

}

}

可以看到混淆后的类中，AppID 常量被保存下来了，getScreenWidth 、 getScreenHeight 这两个方法被移除了。 为什么会有方法被移除？ 因为在混淆时，Android 会默认移除没有使用的的方法和资源，保证apk 合理的被压缩。保留类中的方法不被混淆 -keep class com.lib.manager.PhoneUtil{ public static int getScreenWidth(android.content.Context); } 混淆后的方法如下：

//

// Source code recreated from a .class file by IntelliJ IDEA

// (powered by Fernflower decompiler)

//

package com.lib.manager;

import android.content.Context;

import android.util.DisplayMetrics;

import android.view.WindowManager;

public class PhoneUtil {

public PhoneUtil() {

}

public static int getScreenWidth(Context var0) {

WindowManager var1 = (WindowManager)var0.getSystemService("window");

DisplayMetrics var2 = new DisplayMetrics();

var1.getDefaultDisplay().getMetrics(var2);

return var2.widthPixels;

}

}

11、不混淆类中所有的 public 方法

# 匹配所有的方法

-keep class cn.hadcn.test.One { public ; } 表示One类下的所有public方法都不会被混淆

12、不混淆类中所有的 public 字段

-keep class pp.lib.PhoneUtil{ public ; } 表示 PhoneUtil 类中所有的 public 属性将保留，其他类型的字段

13、不混淆构造函数

-keep class pp.lib.PhoneUtil{ (***) ; (*** , *** ) ; } 不混淆 PhoneUtil 类中所有 一个参数 和 两个参数的 的构造函数。

13、不混淆 bean 对象里面的 set 、get 方法

User 对象如下图所示：

package pp.lib;

/**

* Created by ${zhaoyanjun} on 2017/4/10.

*/

public class User {

private String name ;

private String age ;

public String getName() {

return name;

}

public void setName(String name) {

this.name = name;

}

public String getAge() {

return age;

}

public void setAge(String age) {

this.age = age;

}

}

混淆规则：不混淆 User 类中所有的 set 和 get 方法，*** 代表 通配符

-keep class pp.lib.User{ void set*( *** ) ; *** get*() ; }

常见不混淆的类和属性

不混淆四大组件 和 Application

因为四大组件和 Application 需要在 AndroidManifest.xml 中注册，不能混淆，否则就会报类找不到异常。

-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

特殊情况：

如果 BroadcastReceiver 是动态注册的，则是可以加入混淆的。

不混淆任何包含native方法的类的类名以及native方法名 -keepclasseswithmembernames class * { native ; }

不混淆任何一个View中的setXxx()和getXxx()方法，因为属性动画需要有相应的setter和getter的方法实现，混淆了就无法工作了。 -keepclassmembers public class * extends android.view.View { void set*(***); *** get*(); }

不混淆Activity中参数是View的方法，因为有这样一种用法，在XML中配置android:onClick=”buttonClick”属性，当用户点击该按钮时就会调用Activity中的buttonClick(View view)方法，如果这个方法被混淆的话就找不到了。 -keepclassmembers class * extends android.app.Activity { public void *(android.view.View); }

不混淆枚举中的values()和valueOf()方法

-keepclassmembers enum * { public static **[] values(); public static ** valueOf(java.lang.String); }

不混淆Parcelable实现类中的CREATOR字段，毫无疑问，CREATOR字段是绝对不能改变的，包括大小写都不能变，不然整个Parcelable工作机制都会失败。 -keepclassmembers class * implements android.os.Parcelable { public static final android.os.Parcelable$Creator CREATOR; }

不混淆R文件中的所有静态字段，我们都知道R文件是通过字段来记录每个资源的id的，字段名要是被混淆了，id也就找不着了。 登录后复制 -keepclassmembers class **.R$* { public static ; }

其他的常见不被混淆

一般以下情况都会不混淆：

1.使用了自定义控件那么要保证它们不参与混淆。

2.使用了枚举要保证枚举不被混淆。

3.对第三方库中的类不进行混淆。

4.运用了反射的类也不进行混淆。

5.使用了 Gson 之类的工具要使 JavaBean 类即实体类不被混淆。

6.在引用第三方库的时候，一般会标明库的混淆规则的，建议在使用的时候就把混淆规则添加上去，免得到最后才去找。

7.有用到 WebView 的 JS 调用也需要保证写的接口方法不混淆，原因和第一条一样。

8.Parcelable 的子类和 Creator 静态成员变量不混淆，否则会产生 Android.os.BadParcelableException 异常。

9.供第三放调用的Interface接口不进行混淆。

附一份配置：

# 指定代码的压缩级别 0 - 7(指定代码进行迭代优化的次数，在Android里面默认是5，这条指令也只有在可以优化时起作用。)

-optimizationpasses 5

# 混淆时不会产生形形色色的类名(混淆时不使用大小写混合类名)

-dontusemixedcaseclassnames

# 指定不去忽略非公共的库类(不跳过library中的非public的类)

-dontskipnonpubliclibraryclasses

# 指定不去忽略包可见的库类的成员

-dontskipnonpubliclibraryclassmembers

#不进行优化，建议使用此选项，

-dontoptimize

# 不进行预校验,Android不需要,可加快混淆速度。

-dontpreverify

# 屏蔽警告

-ignorewarnings

# 指定混淆是采用的算法，后面的参数是一个过滤器

# 这个过滤器是谷歌推荐的算法，一般不做更改

-optimizations !code/simplification/arithmetic,!field/*,!class/merging/*

# 保护代码中的Annotation不被混淆

-keepattributes *Annotation*

# 避免混淆泛型, 这在JSON实体映射时非常重要

-keepattributes Signature

# 抛出异常时保留代码行号

-keepattributes SourceFile,LineNumberTable

#优化时允许访问并修改有修饰符的类和类的成员，这可以提高优化步骤的结果。

# 比如，当内联一个公共的getter方法时，这也可能需要外地公共访问。

# 虽然java二进制规范不需要这个，要不然有的虚拟机处理这些代码会有问题。当有优化和使用-repackageclasses时才适用。

#指示语：不能用这个指令处理库中的代码，因为有的类和类成员没有设计成public ,而在api中可能变成public

-allowaccessmodification

#当有优化和使用-repackageclasses时才适用。

-repackageclasses ''

# 混淆时记录日志(打印混淆的详细信息)

# 这句话能够使我们的项目混淆后产生映射文件

# 包含有类名->混淆后类名的映射关系

-verbose

# ----------------------------- 默认保留 -----------------------------

# 保持哪些类不被混淆

#继承activity,application,service,broadcastReceiver,contentprovider....不进行混淆

-keep public class * extends android.app.Activity

-keep public class * extends android.app.Application

-keep public class * extends android.support.multidex.MultiDexApplication

-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

-keep public class * extends android.view.View

-keep class android.support.** {*;}## 保留support下的所有类及其内部类

-keep public class com.google.vending.licensing.ILicensingService

-keep public class com.android.vending.licensing.ILicensingService

#表示不混淆上面声明的类，最后这两个类我们基本也用不上，是接入Google原生的一些服务时使用的。

#----------------------------------------------------

# 保留继承的

-keep public class * extends android.support.v4.**

-keep public class * extends android.support.v7.**

-keep public class * extends android.support.annotation.**

#表示不混淆任何包含native方法的类的类名以及native方法名，这个和我们刚才验证的结果是一致

-keepclasseswithmembernames class * {

native ;

}

#这个主要是在layout 中写的onclick方法android:onclick="onClick"，不进行混淆

#表示不混淆Activity中参数是View的方法，因为有这样一种用法，在XML中配置android:onClick=”buttonClick”属性，

#当用户点击该按钮时就会调用Activity中的buttonClick(View view)方法，如果这个方法被混淆的话就找不到了

-keepclassmembers class * extends android.app.Activity{

public void *(android.view.View);

}

#表示不混淆枚举中的values()和valueOf()方法，枚举我用的非常少，这个就不评论了

-keepclassmembers enum * {

public static **[] values();

public static ** valueOf(java.lang.String);

}

#表示不混淆任何一个View中的setXxx()和getXxx()方法，

#因为属性动画需要有相应的setter和getter的方法实现，混淆了就无法工作了。

-keep public class * extends android.view.View{

*** get*();

void set*(***);

public (android.content.Context);

public (android.content.Context, android.util.AttributeSet);

public (android.content.Context, android.util.AttributeSet, int);

}

-keepclasseswithmembers class * {

public (android.content.Context, android.util.AttributeSet);

public (android.content.Context, android.util.AttributeSet, int);

}

#表示不混淆Parcelable实现类中的CREATOR字段，

#毫无疑问，CREATOR字段是绝对不能改变的，包括大小写都不能变，不然整个Parcelable工作机制都会失败。

-keep class * implements android.os.Parcelable {

public static final android.os.Parcelable$Creator *;

}

# 这指定了继承Serizalizable的类的如下成员不被移除混淆

-keepclassmembers class * implements java.io.Serializable {

static final long serialVersionUID;

private static final java.io.ObjectStreamField[] serialPersistentFields;

private void writeObject(java.io.ObjectOutputStream);

private void readObject(java.io.ObjectInputStream);

java.lang.Object writeReplace();

java.lang.Object readResolve();

}

# 保留R下面的资源

-keep class **.R$* {

*;

}

#不混淆资源类下static的

-keepclassmembers class **.R$* {

public static ;

}

# 对于带有回调函数的onXXEvent、**On*Listener的，不能被混淆

-keepclassmembers class * {

void *(**On*Event);

void *(**On*Listener);

}

# 保留我们自定义控件（继承自View）不被混淆

-keep public class * extends android.view.View{

*** get*();

void set*(***);

public (android.content.Context);

public (android.content.Context, android.util.AttributeSet);

public (android.content.Context, android.util.AttributeSet, int);

}

-keep class com.example.odm.garbagesorthelper.widget.** { *; }

#

#----------------------------- WebView(项目中没有可以忽略) -----------------------------

#

#webView需要进行特殊处理

#在app中与HTML5的JavaScript的交互进行特殊处理

#我们需要确保这些js要调用的原生方法不能够被混淆，于是我们需要做如下处理：

#

#---------------------------------实体类---------------------------

#--------(实体Model不能混淆，否则找不到对应的属性获取不到值)-----

#

-keep class com.example.odm.garbagesorthelper.model.entity.** { *; }

-dontwarn com.example.odm.garbagesorthelper.model.entity.**

#对含有反射类的处理

-keep class com.example.odm.garbagesorthelper.utils.** { *; }

#

# ----------------------------- 其他的 -----------------------------

#

# 删除代码中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(...);

}

# 保持测试相关的代码

-dontnote junit.framework.**

-dontnote junit.runner.**

-dontwarn android.test.**

-dontwarn android.support.test.**

-dontwarn org.junit.**

#

# ----------------------------- 第三方库、框架、SDK -----------------------------

#logger

-dontwarn com.orhanobut.logger.**

-keep class com.orhanobut.logger.**{*;}

-keep interface com.orhanobut.logger.**{*;}

# Gson

-keep class com.google.gson.stream.** { *; }

-keepattributes EnclosingMethod

-dontwarn com.google.gson.**

-keep class com.google.gson.**{*;}

-keep interface com.google.gson.**{*;}

#gson

#如果用到Gson解析包的，直接添加下面这几行就能成功混淆，不然会报错。

##---------------Begin: proguard configuration for Gson ----------

# Gson uses generic type information stored in a class file when working with fields. Proguard

# removes such information by default, so configure it to keep all of it.

-keepattributes Signature

# For using GSON @Expose annotation

-keepattributes *Annotation*

# Gson specific classes

-dontwarn sun.misc.**

#-keep class com.google.gson.stream.** { *; }

# Prevent proguard from stripping interface information from TypeAdapterFactory,

# JsonSerializer, JsonDeserializer instances (so they can be used in @JsonAdapter)

-keep class * implements com.google.gson.TypeAdapterFactory

-keep class * implements com.google.gson.JsonSerializer

-keep class * implements com.google.gson.JsonDeserializer

# Application classes that will be serialized/deserialized over Gso

# OkHttp3

-dontwarn okhttp3.logging.**

-keep class okhttp3.internal.**{*;}

-dontwarn okio.**

# Retrofit

-dontwarn retrofit2.**

-keep class retrofit2.** { *; }

#-keepattributes Signature-keepattributes Exceptions

# Platform calls Class.forName on types which do not exist on Android to determine platform.

-dontnote retrofit2.Platform

# Platform used when running on Java 8 VMs. Will not be used at runtime.

-dontwarn retrofit2.Platform$Java8

# Retain generic type information for use by reflection by converters and adapters.

-keepattributes Signature

# Retain declared checked exceptions for use by a Proxy instance.

-keepattributes Exceptions

# RxJava RxAndroid

-dontwarn sun.misc.**

-keepclassmembers class rx.internal.util.unsafe.*ArrayQueue*Field* {

long producerIndex;

long consumerIndex;

}

-keepclassmembers class rx.internal.util.unsafe.BaseLinkedQueueProducerNodeRef {

rx.internal.util.atomic.LinkedQueueNode producerNode;

}

-keepclassmembers class rx.internal.util.unsafe.BaseLinkedQueueConsumerNodeRef {

rx.internal.util.atomic.LinkedQueueNode consumerNode;

}

#LiveEventBus

-dontwarn com.jeremyliao.liveeventbus.**

-keep class com.jeremyliao.liveeventbus.** { *; }

-keep class androidx.lifecycle.** { *; }

-keep class androidx.arch.core.** { *; }

#glide

-keep public class * implements com.bumptech.glide.module.GlideModule

-keep public enum com.bumptech.glide.load.resource.bitmap.ImageHeaderParser$** {

**[] $VALUES;

public *;

}

#utilcodex

-keep class com.blankj.utilcode.util.** { *; }

#

-keep class site.gemus.** { *; }

#XUI

-keep class com.xuexiang.xui.** { *; }

#讯飞SDK

-libraryjars libs/Msc.jar

-libraryjars src/main/jniLibs/Msc.jar

-keep class com.iflytek.**{*;}

-keepattributes Signature

#RxPermission

-keep class com.tbruyelle.rxpermissions2.** { *; }

#XBanner

-keep class com.stx.xhb.androidx.XBanner.** { *; }

#Bugly SDK

-dontwarn com.tencent.bugly.**

-keep public class com.tencent.bugly.**{*;}

-keep class android.support.**{*;}

———————————————— 转载于：https://blog.csdn.net/chaoyu168/article/details/126904071