Android中的Proguard使用
介绍
之前介绍了如何使用命令行将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>;
}
