简介

Java代码是非常容易反编译的。为了很好的保护Java源代码,我们往往会对编译好的class文件进行混淆处理。

ProGuard是一个混淆代码的开源项目。它的主要作用就是混淆,当然它还能对字节码进行缩减体积、优化等,但那些对于我们来说都算是次要的功能。

官网地址:http://proguard.sourceforge.net/

原理

Java 是一种跨平台的、解释型语言,Java 源代码编译成中间”字节码”存储于 class 文件中。由于跨平台的需要,Java 字节码中包括了很多源代码信息,如变量名、方法名,并且通过这些名称来访问变量和方法,这些符号带有许多语义信息,很容易被反编译成 Java 源代码。为了防止这种现象,我们可以使用 Java 混淆器对 Java 字节码进行混淆。

混淆就是对发布出去的程序进行重新组织和处理,使得处理后的代码与处理前代码完成相同的功能,而混淆后的代码很难被反编译,即使反编译成功也很难得出程序的真正语义。被混淆过的程序代码,仍然遵照原来的档案格式和指令集,执行结果也与混淆前一样,只是混淆器将代码中的所有变量、函数、类的名称变为简短的英文字母代号,在缺乏相应的函数名和程序注释的况下,即使被反编译,也将难以阅读。同时混淆是不可逆的,在混淆的过程中一些不影响正常运行的信息将永久丢失,这些信息的丢失使程序变得更加难以理解。

混淆器的作用不仅仅是保护代码,它也有精简编译后程序大小的作用。由于以上介绍的缩短变量和函数名以及丢失部分信息的原因, 编译后 jar 文件体积大约能减少25% ,这对当前费用较贵的无线网络传输是有一定意义的。

语法


1. -include {filename}    从给定的文件中读取配置参数   
2. -basedirectory {directoryname}    指定基础目录为以后相对的档案名称   
3. -injars {class_path}    指定要处理的应用程序jar,war,ear和目录   
4. -outjars {class_path}    指定处理完后要输出的jar,war,ear和目录的名称   
5. -libraryjars {classpath}    指定要处理的应用程序jar,war,ear和目录所需要的程序库文件   
6. -dontskipnonpubliclibraryclasses    指定不去忽略非公共的库类。   
7. -dontskipnonpubliclibraryclassmembers    指定不去忽略包可见的库类的成员。  
8.    
9. 保留选项   
10. -keep {Modifier} {class_specification}    保护指定的类文件和类的成员   
11. -keepclassmembers {modifier} {class_specification}    保护指定类的成员,如果此类受到保护他们会保护的更好  
12. -keepclasseswithmembers {class_specification}    保护指定的类和类的成员,但条件是所有指定的类和类成员是要存在。   
13. -keepnames {class_specification}    保护指定的类和类的成员的名称(如果他们不会压缩步骤中删除)   
14. -keepclassmembernames {class_specification}    保护指定的类的成员的名称(如果他们不会压缩步骤中删除)   
15. -keepclasseswithmembernames {class_specification}    保护指定的类和类的成员的名称,如果所有指定的类成员出席(在压缩步骤之后)   
16. -printseeds {filename}    列出类和类的成员-keep选项的清单,标准输出到给定的文件   
17.    
18. 压缩   
19. -dontshrink    不压缩输入的类文件   
20. -printusage {filename}   
21. -dontwarn   如果有警告也不终止  
22. -whyareyoukeeping {class_specification}       
23.    
24. 优化   
25. -dontoptimize    不优化输入的类文件   
26. -assumenosideeffects {class_specification}    优化时假设指定的方法,没有任何副作用   
27. -allowaccessmodification    优化时允许访问并修改有修饰符的类和类的成员   
28.    
29. 混淆   
30. -dontobfuscate    不混淆输入的类文件   
31. -printmapping {filename}   
32. -applymapping {filename}    重用映射增加混淆   
33. -obfuscationdictionary {filename}    使用给定文件中的关键字作为要混淆方法的名称   
34. -overloadaggressively    混淆时应用侵入式重载   
35. -useuniqueclassmembernames    确定统一的混淆类的成员名称来增加混淆   
36. -flattenpackagehierarchy {package_name}    重新包装所有重命名的包并放在给定的单一包中   
37. -repackageclass {package_name}    重新包装所有重命名的类文件中放在给定的单一包中   
38. -dontusemixedcaseclassnames    混淆时不会产生形形色色的类名   
39. -keepattributes {attribute_name,...}    保护给定的可选属性,例如LineNumberTable, LocalVariableTable, SourceFile, Deprecated, Synthetic, Signature, and   
40.    
41. InnerClasses.   
42. -renamesourcefileattribute {string}    设置源文件中给定的字符串常量



Android Eclipse开发环境与ProGuard

在Android 2.3以前,混淆Android代码只能手动添加proguard来实现代码混淆,非常不方便。而2.3以后,Google已经将这个工具加入到了SDK的工具集里。具体路径:SDK\tools\proguard。当创建一个新的Android工程时,在工程目录的根路径下,会出现一个proguard的配置文件proguard.cfg。也就是说,我们可以通过简单的配置,在我们的elipse工程中直接使用ProGuard混淆Android工程。


具体混淆的步骤非常简单。首先,我们需要在工程描述文件project.properties中,添加一句话,启用ProGuard。如下所示:


1. # This file is automatically generated by Android Tools.  
2. # Do not modify this file -- YOUR CHANGES WILL BE ERASED!  
3. #  
4. # This file must be checked in Version Control Systems.  
5. #  
6. # To customize properties used by the Ant build system edit  
7. # "ant.properties", and override values to adapt the script to your  
8. # project structure.  
9. #  
10. # To enable ProGuard to shrink and obfuscate your code, uncomment this (available properties: sdk.dir, user.home):  
11. proguard.config=${sdk.dir}/tools/proguard/proguard-android.txt:proguard-project.txt  
12.   
13. # Project target.  
14. target=android-19



这样,Proguard就可以使用了。当我们正常通过Android Tools导出Application Package时(或者使用ant执行release打包),Proguard就会自动启用,优化混淆你的代码。

导出成功后,你可以反编译看看混淆的效果。一些类名、方法名和变量名等,都变成了一些无意义的字母或者数字。证明混淆成功!


实例(proguard 文件代码解读)

1. -optimizationpasses 7  #指定代码的压缩级别 0 - 7  
2. -dontusemixedcaseclassnames  #是否使用大小写混合  
3. -dontskipnonpubliclibraryclasses  #如果应用程序引入的有jar包,并且想混淆jar包里面的class  
4. -dontpreverify  #混淆时是否做预校验(可去掉加快混淆速度)  
5. -verbose #混淆时是否记录日志(混淆后生产映射文件 map 类名 -> 转化后类名的映射  
6. -optimizations !code/simplification/arithmetic,!field/*,!class/merging/*  #淆采用的算法  
7.   
8. -keep public class * extends android.app.Activity  #所有activity的子类不要去混淆  
9. -keep public class * extends android.app.Application  
10. -keep public class * extends android.app.Service  
11. -keep public class * extends android.content.BroadcastReceiver  
12. -keep public class * extends android.content.ContentProvider  
13. -keep public class * extends android.app.backup.BackupAgentHelper  
14. -keep public class * extends android.preference.Preference  
15. -keep public class com.android.vending.licensing.ILicensingService #指定具体类不要去混淆  
16.   
17. -keepclasseswithmembernames class * {  
18. native <methods>;  #保持 native 的方法不去混淆  
19. }  
20.   
21. -keepclasseswithmembers class * {  
22. public <init>(android.content.Context, android.util.AttributeSet);  #保持自定义控件类不被混淆,指定格式的构造方法不去混淆  
23. }  
24.   
25. -keepclasseswithmembers class * {  
26. public <init>(android.content.Context, android.util.AttributeSet, int);  
27. }  
28.   
29. -keepclassmembers class * extends android.app.Activity {   
30. public void *(android.view.View); #保持指定规则的方法不被混淆(Android layout 布局文件中为控件配置的onClick方法不能混淆)  
31. }  
32.   
33. -keep public class * extends android.view.View {  #保持自定义控件指定规则的方法不被混淆  
34. public <init>(android.content.Context);  
35. public <init>(android.content.Context, android.util.AttributeSet);  
36. public <init>(android.content.Context, android.util.AttributeSet, int);  
37. public void set*(...);  
38. }  
39.   
40. -keepclassmembers enum * {  #保持枚举 enum 不被混淆  
41. public static **[] values();  
42. public static ** valueOf(java.lang.String);  
43. }  
44.   
45. -keep class * implements android.os.Parcelable {  #保持 Parcelable 不被混淆(aidl文件不能去混淆)  
46. public static final android.os.Parcelable$Creator *;  
47. }  
48.   
49. -keepnames class * implements java.io.Serializable #需要序列化和反序列化的类不能被混淆(注:Java反射用到的类也不能被混淆)  
50.   
51. -keepclassmembers class * implements java.io.Serializable { #保护实现接口Serializable的类中,指定规则的类成员不被混淆  
52. static final long serialVersionUID;  
53. private static final java.io.ObjectStreamField[] serialPersistentFields;  
54. static !transient <fields>;  
55. private void writeObject(java.io.ObjectOutputStream);  
56. private void readObject(java.io.ObjectInputStream);  
57.     java.lang.Object writeReplace();  
58.     java.lang.Object readResolve();  
59. }  
60.   
61. -keepattributes Signature  #过滤泛型(不写可能会出现类型转换错误,一般情况把这个加上就是了)  
62.   
63. -keepattributes *Annotation*  #假如项目中有用到注解,应加入这行配置  
64.   
65. -keep class **.R$* { *; }  #保持R文件不被混淆,否则,你的反射是获取不到资源id的  
66.   
67. -keep class **.Webview2JsInterface { *; }  #保护WebView对HTML页面的API不被混淆  
68. -keepclassmembers class * extends android.webkit.WebViewClient {  #如果你的项目中用到了webview的复杂操作 ,最好加入  
69.  <span style="margin: 0px; padding: 0px; border: none; color: black; background-