Proguard语法及常用proguard.cfg代码段

最新推荐文章于 2024-07-31 15:17:36 发布

candyguy242

最新推荐文章于 2024-07-31 15:17:36 发布

阅读量526

点赞数

分类专栏： Android 开发及核心技术

Android 开发及核心技术专栏收录该内容

88 篇文章

订阅专栏

本文深入探讨了ProGuard的使用方法，包括其常用语法、标准proguard.cfg文件内容、常见代码段以及与日志管理的结合。详细介绍了如何通过ProGuard优化代码、避免混淆关键代码和类，并在不同日志级别下实现有效的日志控制。

摘要生成于 C知道，由 DeepSeek-R1 满血版支持，前往体验 >

关于ProGuard的作用、使用及bug分析可见 ProGuard的作用、使用及bug分析。

1、ProGuard的常用语法
-libraryjars class_path 应用的依赖包，如android-support-v4
-keep [,modifier,...] class_specification 不混淆某些类
-keepclassmembers [,modifier,...] class_specification 不混淆类的成员
-keepclasseswithmembers [,modifier,...] class_specification 不混淆类及其成员
-keepnames class_specification 不混淆类及其成员名
-keepclassmembernames class_specification 不混淆类的成员名
-keepclasseswithmembernames class_specification 不混淆类及其成员名
-assumenosideeffects class_specification 假设调用不产生任何影响，在proguard代码优化时会将该调用remove掉。如system.out.println和Log.v等等
-dontwarn [class_filter] 不提示warnning

关于proguard更多语法可见：http://proguard.sourceforge.net/index.html#manual/usage.html

2、标准proguard.cfg文件内容
参考android标准，修改如下：

# see http://sourceforge.net/tracker/?func=detail&aid=2787465&group_id=54750&atid=474707
-optimizations !code/simplification/arithmetic
-optimizations !code/simplification/cast
-allowaccessmodification

# To prevent name conflict in incremental obfuscation.
-useuniqueclassmembernames

# dex does not like code run through proguard optimize and preverify steps.
-dontoptimize
-dontpreverify

# Don't obfuscate. We only need dead code striping.
# -dontobfuscate

# Add this flag in your package's own configuration if it's needed.
#-flattenpackagehierarchy

# Some classes in the libraries extend package private classes to chare common functionality
# that isn't explicitly part of the API
-dontskipnonpubliclibraryclasses -dontskipnonpubliclibraryclassmembers

# For enumeration classes, see http://proguard.sourceforge.net/manual/examples.html#enumerations
-keepclassmembers enum * {
    public static **[] values();
    public static ** valueOf(java.lang.String);
}

# For native methods, see http://proguard.sourceforge.net/manual/examples.html#native
-keepclasseswithmembernames class * {
    native <methods>;
}

# class$ methods are inserted by some compilers to implement .class construct,
# see http://proguard.sourceforge.net/manual/examples.html#library
-keepclassmembernames class * {
    java.lang.Class class$(java.lang.String);
    java.lang.Class class$(java.lang.String, boolean);
}

# Keep classes and methods that have the guava @VisibleForTesting annotation
-keep @com.google.common.annotations.VisibleForTesting class *
-keepclassmembers class * {
@com.google.common.annotations.VisibleForTesting *;
}

# Keep serializable classes and necessary members for serializable classes
# Copied from the ProGuard manual at http://proguard.sourceforge.net.
-keepnames class * implements java.io.Serializable
-keepclassmembers class * implements java.io.Serializable {
    static final long serialVersionUID;
    private static final java.io.ObjectStreamField[] serialPersistentFields;
    !static !transient <fields>;
    private void writeObject(java.io.ObjectOutputStream);
    private void readObject(java.io.ObjectInputStream);
    java.lang.Object writeReplace();
    java.lang.Object readResolve();
}

# Please specify classes to be kept explicitly in your package's configuration.
# -keep class * extends android.app.Activity
# -keep class * extends android.view.View
# -keep class * extends android.app.Service
# -keep class * extends android.content.BroadcastReceiver
# -keep class * extends android.content.ContentProvider
# -keep class * extends android.preference.Preference
# -keep class * extends android.app.BackupAgent

-keep class * implements android.os.Parcelable {
  public static final android.os.Parcelable$Creator *;
}

# The support library contains references to newer platform versions.
# Don't warn about those in case this app is linking against an older
# platform version.  We know about them, and they are safe.
# See proguard-android.txt in the SDK package.
-dontwarn android.support.**

# see http : / /sourceforge .net /tracker / ?func =detail &aid =2787465 &group _id =54750 &atid =474707

-optimizations !code /simplification /arithmetic

-optimizations !code /simplification /cast

-allowaccessmodification

# To prevent name conflict in incremental obfuscation .

-useuniqueclassmembernames

# dex does not like code run through proguard optimize and preverify steps .

-dontoptimize

-dontpreverify

# Don 't obfuscate. We only need dead code striping.

# -dontobfuscate

# Add this flag in your package's own configuration if it 's needed.

#-flattenpackagehierarchy

# Some classes in the libraries extend package private classes to chare common functionality

# that isn't explicitly part of the API

-dontskipnonpubliclibraryclasses -dontskipnonpubliclibraryclassmembers

# For enumeration classes , see http : / /proguard .sourceforge .net /manual /examples .html #enumerations

-keepclassmembers enum * {

public static * * [ ] values ( ) ;

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

}

# For native methods , see http : / /proguard .sourceforge .net /manual /examples .html #native

-keepclasseswithmembernames class * {

native <methods> ;

}

# class$ methods are inserted by some compilers to implement .class construct,

# see http://proguard.sourceforge.net/manual/examples.html#library

-keepclassmembernames class * {

java.lang.Class class$(java.lang.String);

java.lang.Class class$(java.lang.String, boolean);

}

# Keep classes and methods that have the guava @VisibleForTesting annotation

-keep @com.google.common.annotations.VisibleForTesting class *

-keepclassmembers class * {

@com.google.common.annotations.VisibleForTesting *;

}

# Keep serializable classes and necessary members for serializable classes

# Copied from the ProGuard manual at http://proguard.sourceforge.net.

-keepnames class * implements java.io.Serializable

-keepclassmembers class * implements java.io.Serializable {

static final long serialVersionUID;

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

!static !transient <fields> ;

private void writeObject (java .io .ObjectOutputStream ) ;

private void readObject (java .io .ObjectInputStream ) ;

java .lang .Object writeReplace ( ) ;

java .lang .Object readResolve ( ) ;

}

# Please specify classes to be kept explicitly in your package 's configuration.

# -keep class * extends android.app.Activity

# -keep class * extends android.view.View

# -keep class * extends android.app.Service

# -keep class * extends android.content.BroadcastReceiver

# -keep class * extends android.content.ContentProvider

# -keep class * extends android.preference.Preference

# -keep class * extends android.app.BackupAgent

-keep class * implements android.os.Parcelable {

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

}

# The support library contains references to newer platform versions.

# Don't warn about those in case this app is linking against an older

# platform version . We know about them , and they are safe .

# See proguard -android .txt in the SDK package .

-dontwarn android .support . * *

源文件见<android_root>/build/core/proguard.flags , 将14行 -dontobfuscate解除注释。

3、常用proguard.cfg代码段

不混淆某类的构造方法，需指定构造函数的参数类型，如JSONObject

- keepclassmembers class cn . trinea . android . common . service . impl . ImageCache {

public <init> ( int ) ;

}

不混淆某个包所有类或某个类class、某个接口interface, 不混淆指定类则把**换成类名

1	- keep class cn . trinea . android . common . * * { * ; }

不混淆指某个方法，*可换成指定的方法或类名

- keepclassmembers class cn . trinea . android . common . service . impl . ImageCache {

public boolean get ( java . lang . String , android . view . View ) ;

}

不混淆Parcelable的子类，防止android.os.BadParcelableException

- keep class * implements android . os . Parcelable {

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

}

添加android-support-v4.jar依赖包

- libraryjars libs / android - support - v4 . jar

- dontwarn android . support . v4 . * *

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

- keep interface android . support . v4 . app . * * { * ; }

4、proguard与log level结合解决debug模式Log问题
常见的Android debug日志的打法是定义一个静态变量DEBUG_STATUS，如果为true，则打印log，否则不打印。对于release模式该变量为false，debug模式变量为true。这里介绍一个更好的方法，不用担心正式发布时一不小心错改了该变量。

proguard的作用就是在release模式压缩、优化、混淆代码，其中的压缩和优化就包括去除不必要的代码，我们可以利用这一特性解决debug日志的问题，在proguard.cfg中添加