ProGuard使用笔记
最近要混淆一部分jar包, 找到了ProGuard, 开始想省事直接用GUI, 结果看的很凌乱, 网上也是配置项的内容居多, 最终还是选择用配置项.
官方文档http://proguard.sourceforge.net/
错误总结:http://sd7y.iteye.com/blog/2047896
使用配置项的命令 java -jar proguard.Jar @配置文件
如java -jar proguard.Jar @aaa
下面是对源代码中的boilerplate.pro进行的一个注释, 算是一个配置文件的模板样例吧, E文不好, 如注释有误请指正
GUI使用方法(建议使用配置文件方式):
在命令行中输入java -jar proguardgui.jar, 打开界面如下
附上网上找来的选项解释
ProGuard的作用:
1.创建紧凑的代码文档是为了更快的网络传输,快速装载和更小的内存占用.
2.创建的程序和程序库很难使用反向工程.
3.所以它能删除来自源文件中的没有调用的代码
4.充分利用java6的快速加载的优点来提前检测和返回java6中存在的类文件.
参考文档:
官方文档http://proguard.sourceforge.net/
错误总结:http://sd7y.iteye.com/blog/2047896
使用配置项的命令 java -jar proguard.Jar @配置文件
如java -jar proguard.Jar @aaa
下面是对源代码中的boilerplate.pro进行的一个注释, 算是一个配置文件的模板样例吧, E文不好, 如注释有误请指正
# Keep - Applications. Keep all application classes, along with their 'main' methods.
# 保留所有公共类中的main方法
-keepclasseswithmembers public class * {
public static void main(java.lang.String[]);
}
# Keep - Applets. Keep all extensions of java.applet.Applet.
# 保留所有继承自java.appent.Applet的类
-keep public class * extends java.applet.Applet
# Keep - Servlets. Keep all extensions of javax.servlet.Servlet.
# 保留所有继承自javax.servlet.Servlet的类
-keep public class * extends javax.servlet.Servlet
# Keep - Midlets. Keep all extensions of javax.microedition.midlet.MIDlet.
# 保留所有继承自javax.microedition.midlet.MIDlet的类
-keep public class * extends javax.microedition.midlet.MIDlet
# Keep - Xlets. Keep all extensions of javax.tv.xlet.Xlet.
# 保留所有继承自javax.tv.xlet.Xlet的类
-keep public class * extends javax.tv.xlet.Xlet
# Keep - Library. Keep all public and protected classes, fields, and methods.
# 保留所有public和protected的类, 属性和方法
-keep public class * {
public protected <fields>;
public protected <methods>;
}
# Also keep - Enumerations. Keep the special static methods that are required in enumeration classes.
# 保留枚举中的指定的静态方法
-keepclassmembers enum * {
public static **[] values();
public static ** valueOf(java.lang.String);
}
# Also keep - Serialization code. Keep all fields and methods that are used for serialization.
# 保留所有序列化相关内容
-keepclassmembers class * extends java.io.Serializable {
static final long serialVersionUID;
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();
}
# Also keep - BeanInfo classes. Keep all implementations of java.beans.BeanInfo.
# 保留实现了java.beans.BeanInfo接口的类
-keep class * implements java.beans.BeanInfo
# Also keep - Bean classes. Keep all specified classes, along with their getters and setters.
# 保留get/set/is方法
-keep class * {
void set*(***);
void set*(int,***);
boolean is*();
boolean is*(int);
*** get*();
*** get*(int);
}
# Also keep - Database drivers. Keep all implementations of java.sql.Driver.
# 保留实现了java.sql.Driver接口的类
-keep class * implements java.sql.Driver
# Also keep - Swing UI L&F. Keep all extensions of javax.swing.plaf.ComponentUI, along with the special 'createUI' method.
# 保留继承自javax.swing.plaf.ComponentUI类中的createUI方法
-keep class * extends javax.swing.plaf.ComponentUI {
public static javax.swing.plaf.ComponentUI createUI(javax.swing.JComponent);
}
# Also keep - RMI interfaces. Keep all interfaces that extend the java.rmi.Remote interface, and their methods.
# 保留继承自java.rmi.Remote的全部接口及方法
-keep interface * extends java.rmi.Remote {
<methods>;
}
# Also keep - RMI implementations. Keep all implementations of java.rmi.Remote,
# including any explicit or implicit implementations of Activatable, with their
# two-argument constructors.
# 保留实现了java.rmi.Remote接口, 包括Activatable任何显式或隐式实现(在方法有两个参数的时候)
-keep class * implements java.rmi.Remote {
<init>(java.rmi.activation.ActivationID,java.rmi.MarshalledObject);
}
# Keep names - Native method names. Keep all native class/method names.
# 保留任何类中的native方法
-keepclasseswithmembernames class * {
native <methods>;
}
# Keep names - _class method names. Keep all .class method names. This may be
# useful for libraries that will be obfuscated again with different obfuscators.
# 保留所有方法名以class结尾的方法, 这可能导致已被混效过的将被再次混淆
-keepclassmembernames class * {
java.lang.Class class$(java.lang.String);
java.lang.Class class$(java.lang.String,boolean);
}
# Remove - System method calls. Remove all invocations of System methods without side effects whose return values are not used.
# 删除所有调用了java.lang.System中指定方法, 但是没有使用其返回值的语句
-assumenosideeffects public class java.lang.System {
public static long currentTimeMillis();
static java.lang.Class getCallerClass();
public static int identityHashCode(java.lang.Object);
public static java.lang.SecurityManager getSecurityManager();
public static java.util.Properties getProperties();
public static java.lang.String getProperty(java.lang.String);
public static java.lang.String getenv(java.lang.String);
public static java.lang.String mapLibraryName(java.lang.String);
public static java.lang.String getProperty(java.lang.String,java.lang.String);
}
# Remove - Math method calls. Remove all invocations of Math methods without side effects whose return values are not used.
# 删除所有调用了java.lang.Math中指定方法, 但是没有使用其返回值的语句
-assumenosideeffects public class java.lang.Math {
public static double sin(double);
public static double cos(double);
public static double tan(double);
public static double asin(double);
public static double acos(double);
public static double atan(double);
public static double toRadians(double);
public static double toDegrees(double);
public static double exp(double);
public static double log(double);
public static double log10(double);
public static double sqrt(double);
public static double cbrt(double);
public static double IEEEremainder(double,double);
public static double ceil(double);
public static double floor(double);
public static double rint(double);
public static double atan2(double,double);
public static double pow(double,double);
public static int round(float);
public static long round(double);
public static double random();
public static int abs(int);
public static long abs(long);
public static float abs(float);
public static double abs(double);
public static int max(int,int);
public static long max(long,long);
public static float max(float,float);
public static double max(double,double);
public static int min(int,int);
public static long min(long,long);
public static float min(float,float);
public static double min(double,double);
public static double ulp(double);
public static float ulp(float);
public static double signum(double);
public static float signum(float);
public static double sinh(double);
public static double cosh(double);
public static double tanh(double);
public static double hypot(double,double);
public static double expm1(double);
public static double log1p(double);
}
# Remove - Number method calls. Remove all invocations of Number methods without side effects whose return values are not used.
# 删除所有调用了[在java.lang包中继承自java.lang.Number]中指定方法, 但是没有使用其返回值的语句
-assumenosideeffects public class java.lang.* extends java.lang.Number {
public static java.lang.String toString(byte);
public static java.lang.Byte valueOf(byte);
public static byte parseByte(java.lang.String);
public static byte parseByte(java.lang.String,int);
public static java.lang.Byte valueOf(java.lang.String,int);
public static java.lang.Byte valueOf(java.lang.String);
public static java.lang.Byte decode(java.lang.String);
public int compareTo(java.lang.Byte);
public static java.lang.String toString(short);
public static short parseShort(java.lang.String);
public static short parseShort(java.lang.String,int);
public static java.lang.Short valueOf(java.lang.String,int);
public static java.lang.Short valueOf(java.lang.String);
public static java.lang.Short valueOf(short);
public static java.lang.Short decode(java.lang.String);
public static short reverseBytes(short);
public int compareTo(java.lang.Short);
public static java.lang.String toString(int,int);
public static java.lang.String toHexString(int);
public static java.lang.String toOctalString(int);
public static java.lang.String toBinaryString(int);
public static java.lang.String toString(int);
public static int parseInt(java.lang.String,int);
public static int parseInt(java.lang.String);
public static java.lang.Integer valueOf(java.lang.String,int);
public static java.lang.Integer valueOf(java.lang.String);
public static java.lang.Integer valueOf(int);
public static java.lang.Integer getInteger(java.lang.String);
public static java.lang.Integer getInteger(java.lang.String,int);
public static java.lang.Integer getInteger(java.lang.String,java.lang.Integer);
public static java.lang.Integer decode(java.lang.String);
public static int highestOneBit(int);
public static int lowestOneBit(int);
public static int numberOfLeadingZeros(int);
public static int numberOfTrailingZeros(int);
public static int bitCount(int);
public static int rotateLeft(int,int);
public static int rotateRight(int,int);
public static int reverse(int);
public static int signum(int);
public static int reverseBytes(int);
public int compareTo(java.lang.Integer);
public static java.lang.String toString(long,int);
public static java.lang.String toHexString(long);
public static java.lang.String toOctalString(long);
public static java.lang.String toBinaryString(long);
public static java.lang.String toString(long);
public static long parseLong(java.lang.String,int);
public static long parseLong(java.lang.String);
public static java.lang.Long valueOf(java.lang.String,int);
public static java.lang.Long valueOf(java.lang.String);
public static java.lang.Long valueOf(long);
public static java.lang.Long decode(java.lang.String);
public static java.lang.Long getLong(java.lang.String);
public static java.lang.Long getLong(java.lang.String,long);
public static java.lang.Long getLong(java.lang.String,java.lang.Long);
public static long highestOneBit(long);
public static long lowestOneBit(long);
public static int numberOfLeadingZeros(long);
public static int numberOfTrailingZeros(long);
public static int bitCount(long);
public static long rotateLeft(long,int);
public static long rotateRight(long,int);
public static long reverse(long);
public static int signum(long);
public static long reverseBytes(long);
public int compareTo(java.lang.Long);
public static java.lang.String toString(float);
public static java.lang.String toHexString(float);
public static java.lang.Float valueOf(java.lang.String);
public static java.lang.Float valueOf(float);
public static float parseFloat(java.lang.String);
public static boolean isNaN(float);
public static boolean isInfinite(float);
public static int floatToIntBits(float);
public static int floatToRawIntBits(float);
public static float intBitsToFloat(int);
public static int compare(float,float);
public boolean isNaN();
public boolean isInfinite();
public int compareTo(java.lang.Float);
public static java.lang.String toString(double);
public static java.lang.String toHexString(double);
public static java.lang.Double valueOf(java.lang.String);
public static java.lang.Double valueOf(double);
public static double parseDouble(java.lang.String);
public static boolean isNaN(double);
public static boolean isInfinite(double);
public static long doubleToLongBits(double);
public static long doubleToRawLongBits(double);
public static double longBitsToDouble(long);
public static int compare(double,double);
public boolean isNaN();
public boolean isInfinite();
public int compareTo(java.lang.Double);
public byte byteValue();
public short shortValue();
public int intValue();
public long longValue();
public float floatValue();
public double doubleValue();
public int compareTo(java.lang.Object);
public boolean equals(java.lang.Object);
public int hashCode();
public java.lang.String toString();
}
# Remove - String method calls. Remove all invocations of String methods without side effects whose return values are not used.
# 删除所有调用了java.lang.String中指定方法, 但是没有使用其返回值的语句
-assumenosideeffects public class java.lang.String {
public static java.lang.String copyValueOf(char[]);
public static java.lang.String copyValueOf(char[],int,int);
public static java.lang.String valueOf(boolean);
public static java.lang.String valueOf(char);
public static java.lang.String valueOf(char[]);
public static java.lang.String valueOf(char[],int,int);
public static java.lang.String valueOf(double);
public static java.lang.String valueOf(float);
public static java.lang.String valueOf(int);
public static java.lang.String valueOf(java.lang.Object);
public static java.lang.String valueOf(long);
public boolean contentEquals(java.lang.StringBuffer);
public boolean endsWith(java.lang.String);
public boolean equalsIgnoreCase(java.lang.String);
public boolean equals(java.lang.Object);
public boolean matches(java.lang.String);
public boolean regionMatches(boolean,int,java.lang.String,int,int);
public boolean regionMatches(int,java.lang.String,int,int);
public boolean startsWith(java.lang.String);
public boolean startsWith(java.lang.String,int);
public byte[] getBytes();
public byte[] getBytes(java.lang.String);
public char charAt(int);
public char[] toCharArray();
public int compareToIgnoreCase(java.lang.String);
public int compareTo(java.lang.Object);
public int compareTo(java.lang.String);
public int hashCode();
public int indexOf(int);
public int indexOf(int,int);
public int indexOf(java.lang.String);
public int indexOf(java.lang.String,int);
public int lastIndexOf(int);
public int lastIndexOf(int,int);
public int lastIndexOf(java.lang.String);
public int lastIndexOf(java.lang.String,int);
public int length();
public java.lang.CharSequence subSequence(int,int);
public java.lang.String concat(java.lang.String);
public java.lang.String replaceAll(java.lang.String,java.lang.String);
public java.lang.String replace(char,char);
public java.lang.String replaceFirst(java.lang.String,java.lang.String);
public java.lang.String[] split(java.lang.String);
public java.lang.String[] split(java.lang.String,int);
public java.lang.String substring(int);
public java.lang.String substring(int,int);
public java.lang.String toLowerCase();
public java.lang.String toLowerCase(java.util.Locale);
public java.lang.String toString();
public java.lang.String toUpperCase();
public java.lang.String toUpperCase(java.util.Locale);
public java.lang.String trim();
}
# Remove - StringBuffer method calls. Remove all invocations of StringBuffer methods without side effects whose return values are not used.
# 删除所有调用了java.lang.StringBuffer中指定方法, 但是没有使用其返回值的语句
-assumenosideeffects public class java.lang.StringBuffer {
public java.lang.String toString();
public char charAt(int);
public int capacity();
public int codePointAt(int);
public int codePointBefore(int);
public int indexOf(java.lang.String,int);
public int lastIndexOf(java.lang.String);
public int lastIndexOf(java.lang.String,int);
public int length();
public java.lang.String substring(int);
public java.lang.String substring(int,int);
}
# Remove - StringBuilder method calls. Remove all invocations of StringBuilder methods without side effects whose return values are not used.
# 删除所有调用了java.lang.StringBuilder中指定方法, 但是没有使用其返回值的语句
-assumenosideeffects public class java.lang.StringBuilder {
public java.lang.String toString();
public char charAt(int);
public int capacity();
public int codePointAt(int);
public int codePointBefore(int);
public int indexOf(java.lang.String,int);
public int lastIndexOf(java.lang.String);
public int lastIndexOf(java.lang.String,int);
public int length();
public java.lang.String substring(int);
public java.lang.String substring(int,int);
}
# Remove debugging - Throwable_printStackTrace calls. Remove all invocations of Throwable.printStackTrace().
# 删除debug信息, 移除所有调用了Throwable.printStackTrace()方法的语句
-assumenosideeffects public class java.lang.Throwable {
public void printStackTrace();
}
# Remove debugging - Thread_dumpStack calls. Remove all invocations of Thread.dumpStack().
# 删除debug信息, 移除所有调用了Thread.dumpStack()方法的语句
-assumenosideeffects public class java.lang.Thread {
public static void dumpStack();
}
# Remove debugging - All logging API calls. Remove all invocations of the logging API whose return values are not used.
# 删除所有调用java.util.logging的方法
-assumenosideeffects public class java.util.logging.* {
<methods>;
}
# Remove debugging - All Log4j API calls. Remove all invocations of the Log4j API whose return values are not used.
# 删除所有调用org.apache.log4j.**的方法
-assumenosideeffects public class org.apache.log4j.** {
<methods>;
}
#不混淆public和protected的属性和方法
-keep public class * {
public protected <fields>;
public protected <methods>;
}
#无混淆的基本语句：
#确定统一的混淆类的成员名称来增加混淆
-useuniqueclassmembernames
#不压缩输入的类文件
-dontshrink
#混淆时不会产生形形色色的类名(不会改变类名?)
-dontusemixedcaseclassnames
#不优化输入的类文件
-dontoptimize
#忽略警告
-ignorewarnings
-verbose
#org包内的不警告
-dontwarn org.*
#保留Exceptions(抛出异常), InnerClasses(内部类), Signature(签名),Deprecated(弃用?),
#SourceFile(源文件), LineNumberTable(行号?), *Annotation*(注释), EnclosingMethod(匿名方法)
-keepattributes Exceptions,InnerClasses,Signature,Deprecated,SourceFile,LineNumberTable,*Annotation*,EnclosingMethod
#保留公共类
-keep public class *
#保留org包
-keep class org.* {*; }
#保留android的R文件?
-keep class **.R$* {
*;
}
-keep class **.$* {
*;
}
-keepclasseswithmembernames class * {
public <methods>;
public <fields>;
}
-keepclasseswithmembernames class * {
public <methods>;
private <methods>;
protected <methods>;
public <fields>;
private <fields>;
protected <fields>;
}
GUI使用方法(建议使用配置文件方式):
在命令行中输入java -jar proguardgui.jar, 打开界面如下
- ProGuard(首页)可加载已有的配置文件
- input/output(输入输出配置)
- Shrinking(压缩代码),可以删除一些无用代码
- Obfuscator(混淆)
- Optimization(性能优化),用处不大
- Information(信息参数)
- Process(处理)执行操作, 保存配置等
附上网上找来的选项解释
ProGuard的作用:
1.创建紧凑的代码文档是为了更快的网络传输,快速装载和更小的内存占用.
2.创建的程序和程序库很难使用反向工程.
3.所以它能删除来自源文件中的没有调用的代码
4.充分利用java6的快速加载的优点来提前检测和返回java6中存在的类文件.
#参数：
#--------------------------------------------------------------
#从给定的文件中读取配置参数
-include{filename}
#指定基础目录为以后相对的档案名称
-basedirectory{directoryname}
#指定要处理的应用程序jar,war,ear和目录
-injars{class_path}
#指定处理完后要输出的jar,war,ear和目录的名称
-outjars{class_path}
#指定要处理的应用程序jar,war,ear和目录所需要的程序库文件
-libraryjars{classpath}
#指定不去忽略非公共的库类。
-dontskipnonpubliclibraryclasses
#指定不去忽略包可见的库类的成员。
-dontskipnonpubliclibraryclassmembers
#保留选项：
#--------------------------------------------------------------
#保护指定的类文件和类的成员
-keep{Modifier}{class_specification}
#保护指定类的成员，如果此类受到保护他们会保护的更好
-keepclassmembers{modifier}{class_specification}
#保护指定的类和类的成员，但条件是所有指定的类和类成员是要存在。
-keepclasseswithmembers{class_specification}
#保护指定的类和类的成员的名称（如果他们不会压缩步骤中删除）
-keepnames{class_specification}
#保护指定的类的成员的名称（如果他们不会压缩步骤中删除）
-keepclassmembernames{class_specification}
#保护指定的类和类的成员的名称，如果所有指定的类成员出席（在压缩步骤之后）
-keepclasseswithmembernames{class_specification}
#列出类和类的成员-keep选项的清单，标准输出到给定的文件
-printseeds{filename}
#压缩：
#--------------------------------------------------------------
#不压缩输入的类文件
-dontshrink
#
-printusage{filename}
#
-whyareyoukeeping{class_specification}
#优化：
#--------------------------------------------------------------
#不优化输入的类文件
-dontoptimize
#优化时假设指定的方法，没有任何副作用
-assumenosideeffects{class_specification}
#优化时允许访问并修改有修饰符的类和类的成员
-allowaccessmodification
#混淆：
#--------------------------------------------------------------
#不混淆输入的类文件
-dontobfuscate
#
-printmapping{filename}
#重用映射增加混淆
-applymapping{filename}
#使用给定文件中的关键字作为要混淆方法的名称
-obfuscationdictionary{filename}
#混淆时应用侵入式重载
-overloadaggressively
#确定统一的混淆类的成员名称来增加混淆
-useuniqueclassmembernames
#重新包装所有重命名的包并放在给定的单一包中
-flattenpackagehierarchy{package_name}
#重新包装所有重命名的类文件中放在给定的单一包中
-repackageclass{package_name}
#混淆时不会产生形形色色的类名
-dontusemixedcaseclassnames
#保护给定的可选属性，例如LineNumberTable,LocalVariableTable,SourceFile,
#Deprecated,Synthetic,Signature,andInnerClasses.
-keepattributes{attribute_name,...}
#设置源文件中给定的字符串常量
-renamesourcefileattribute{string}
参考文档:
- android 混淆 proguard http://blog.csdn.net/lrenjun/article/details/8064856
- android 导出签名APK--混淆文件proguard.cfg详解 http://blog.csdn.net/sobeautiy/article/details/9092479
- Proguard 学习笔记(一) http://blog.csdn.net/sunyujia/article/details/2160141
- 开源混淆工具ProGuard配置详解及配置实例 http://www.kaiyuanba.cn/html/1/131/138/7820.htm
- proguard 使用 http://blog.csdn.net/lpdx111/article/details/7659218