Proguard 简述

前一段时间PM让我搞代码混淆，开始我一头雾水，不清楚是搞什么的。（代码混淆就是对编译的class文件中的一些处理，也就是防止class文件反编译后产生可读性很强的源文件）。

 

接到任务后到网上狂找这方面的东东，有以下工具（jocky，proguard，retroguard......）

 

我只使用了两种jocky和proguard，主要说一下proguad。下面是我翻译的proguard的帮助文档。本人E文不是很好，如果有不解的地方可以参考一下原帮助文档。

 

 

ProGuard是一个免费的java类文件压缩,优化,混淆器.它探测并删除没有使用的类,字段,方法和属性.它删除没有用的说明并使用字节码得到最大优化.它使用无意义的名字来重命名类,字段和方法.
 
ProGuard的使用是为了:
 
1.创建紧凑的代码文档是为了更快的网络传输,快速装载和更小的内存占用.
2.创建的程序和程序库很难使用反向工程.
3.所以它能删除来自源文件中的没有调用的代码
4.充分利用java6的快速加载的优点来提前检测和返回java6中存在的类文件.
 
参数：
 
-include {filename}    从给定的文件中读取配置参数
 
-basedirectory {directoryname}    指定基础目录为以后相对的档案名称
 
-injars {class_path}    指定要处理的应用程序jar,war,ear和目录
 
-outjars {class_path}    指定处理完后要输出的jar,war,ear和目录的名称
 
-libraryjars {classpath}    指定要处理的应用程序jar,war,ear和目录所需要的程序库文件
 
-dontskipnonpubliclibraryclasses    指定不去忽略非公共的库类。
 
-dontskipnonpubliclibraryclassmembers    指定不去忽略包可见的库类的成员。
 
 
保留选项
-keep {Modifier} {class_specification}    保护指定的类文件和类的成员
 
-keepclassmembers {modifier} {class_specification}    保护指定类的成员，如果此类受到保护他们会保护的更好
 
-keepclasseswithmembers {class_specification}    保护指定的类和类的成员，但条件是所有指定的类和类成员是要存在。
 
-keepnames {class_specification}    保护指定的类和类的成员的名称（如果他们不会压缩步骤中删除）
 
-keepclassmembernames {class_specification}    保护指定的类的成员的名称（如果他们不会压缩步骤中删除）
 
-keepclasseswithmembernames {class_specification}    保护指定的类和类的成员的名称，如果所有指定的类成员出席（在压缩步骤之后）
 
-printseeds {filename}    列出类和类的成员-keep选项的清单，标准输出到给定的文件
 
压缩
-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    混淆时不会产生形形色色的类名
 
-keepattributes {attribute_name,...}    保护给定的可选属性，例如LineNumberTable, LocalVariableTable, SourceFile, Deprecated, Synthetic, Signature, and InnerClasses.
 
-renamesourcefileattribute {string}    设置源文件中给定的字符串常量

 

 

因为我们开发的是webwork+spring+hibernate的架构的项目，所有需要很详细的配置。（经过n次失败后总结）

 

Example:

    -injars <project>.jar

    -outjars <project>_out.jar

 

    -libraryjars <java.home>/lib/rt.jar

    -libraryjars <project.home>/webroot/WEB-INF/lib/webwork.jar

    .......

 

    # 保留实现Action接口类中的公有的，友好的，私有的属性 和 公有的，友好的方法。其它的全部压缩，优化，混淆。

    # 因为配置文件中的类名是一个完整的类名，如果经过处理后就有可能找不到这个类。

    # 属性是jsp页面所需要的，如果经过处理jsp页面就无法得到action中的数据。

    -keep public class * implements com.opensymphony.xwork.Action{

        public protected private <fields>;

        public protected <methods>;

    }

 

    # 保留实现了Serializable接口类中的公有的，友好的，私有的成员（属性和方法）

    # 这个配置主要是对应实体类的配置。

    -keep public class * implements java.io.Serializable{

        public protected private *;

    }

 

    ......

 

   # 关于配置的解释已说了很多了，下面的配置自已可以尝试。

 

然后在命行端输入：proguard ＠配置文件

 

（proguard是我自已写的批处理，你也可以自已写一下。）

 

 

总结：

    proguard在处理web application方面还行，但不是很完美。如果的框架设计的不是很好的话配置加多不说，处理效果也是很好。

 

在简单说一个jocky，它在处理桌面的程序应该时较完美的。如果处理应用了spring框架的程序我想是不可能的。

 

 

如果有错的方面还请各位指出。有好的想法也可以交流。