介绍
之前介绍了如何使用命令行将Jar包根据配置文件进行ProGuard,以及ProGuard的过程,会遇到的问题等。接下来会介绍常用的ProGuard如何配置参数。不常用的可以在官网中查询如何使用。
java -jar proguard.jar @myconfig.pro
Filter
每一个类、属性、方法都会有一个全名,例如java.lang.String
。而我们也可以通过正则表达式来过滤我们所需要的名称。
-
?
:在class中匹配任意的单个字符
例如:mypackage.Test?
可以匹配mypackage.Test1
,mypackage.Test2
,但是不能匹配mypackage.Test12
-
*
:匹配任意class名称中的一部分
例如:mypackage.*Test*
可以匹配mypackage.Test
,也可以匹配mypackage.YouTestApplication
,但是不能匹配mypackage.subpackage.MyTest
-
**
:可以匹配class名称中的任意一部分,可以包括任何数字或者包分隔符。
例如:**.Test
可以匹配除了根目录下所有包名下的Test类。mypackage.**
则可以匹配所有在mypackage
和它子目录的所有类
而Fields和Methods与Java中类似。除了Method的参数中不需要包含它的名字,就和Javap中一样。而匹配规则如下:
-
<init>
:匹配任意构造函数
-<fields>
:匹配任意属性
-<methods>
:匹配任意函数
-*
:匹配任意属性或者函数
Input / Output Options
-
@filename
这种方式,是-include filename
的缩写,该选项的作用是递归读取所给文件中的属性 -
-basedirectory directoryPath
指定配置文件的目录 -
-injars class_path
指定输入Jar包的路径,可以指定多个路径,而输入的Entity可以被过滤 -
-outjars class_path
指定输出Jar包路径,同上而输出的Entity可以被过滤 -
libraryjars class_path
指定要被处理的Jar包。这些文件不会被打包到output jar包中。指定的Library应该至少包含一个Class文件被Application Class文件中使用extended
继承了。 -
-skipnonpubliclibraryclasses
当读取library的时候,跳过non-public的类,以提升处理速度并且减少ProGuard内存占用。默认ProGuard会读取public以及non-public的类。然而,non-public的类通常没有关联的。可以忽略他们,提升ProGuard速度,而且也不会影响output。但是有一些lib,例如JSE run-time,包含了non-public的类,但是它还可以被public的library继承。所以你不能使用这个option。如果因为这个option无法找到那个class的话 ,ProGuard会打印出来Warning的。 -
-dontskipnonpubliclibraryclasses
从4.5版本开始,默认就指定了该属性。该属性制定了不要忽略non-public的类 -
-dontskipnonpubliclibraryclassmembers
指定不要忽略package visible的类成员(Field以及Method)。默认的,ProGuard在解析classes会跳过这些类成员,因为程序通常不会引用它们。有些情况下,程序的包和Library的包相同,从而可以引用包可见的类成员。在这种情况下,实际读取类成员是有用的,以确保处理后的代码保持一致。 -
keepdirectories directory_filter
指定输出路径中需要Keep的目录。默认情况下,目录的Entries会被移除掉,用来减少Jar包的大小。但是有可能程序会有MyClass.class.getResource("")
这种代码出现,如果没有指定一个Directory Filter的话,那么所有的目录都会被Keep住。如果有Filter的话,则会Keep匹配目录。
Keep Options
-
-keep:
Keep住所有继承自Activity、Application的类
-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住所有继承自View类中的public构造函数以及所有以public void set
开始的函数。
-keep public class * extends android.view.View {
public <init>(android.content.Context);
public <init>(android.content.Context, android.util.AttributeSet);
public <init>(android.content.Context, android.util.AttributeSet, int);
public void set*(...);
}
-
-keepclassmembers
Keep住类中的成员。
-keepclassmembers class * implements java.io.Serializable {
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();
}
-keepclassmembers class * implements android.os.Parcelable {
static android.os.Parcelable$Creator CREATOR;
}
-keepclassmembers class **.R$* {
public static <fields>;
}
-
-keepclasseswithmembers
Keep住能匹配到规则的类。如下,会Keep住所有构造函数带有Context、AttributeSet的类。
-keepclasseswithmembers class * {
public <init>(android.content.Context, android.util.AttributeSet);
}
-keepclasseswithmembers class * {
public <init>(android.content.Context, android.util.AttributeSet, int);
}
-
-keepclassmembernames
Keep住类成员。如果它们没有在Shrink阶段被移除的话
-keepclassmembernames class scala.concurrent.forkjoin.ForkJoinPool {
long eventCount;
int workerCounts;
int runControl;
scala.concurrent.forkjoin.ForkJoinPool$WaitQueueNode syncStack;
scala.concurrent.forkjoin.ForkJoinPool$WaitQueueNode spareStack;
}
-
-keepclasseswithmembernames
根据类成员名称来Keep住类。如下,如果有Native函数的类全部都会被Keep住
-keepclasseswithmembernames class * {
native <methods>;
}
网友评论