Android 项目的代码混淆的使用说明

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。如下所示：

[java] view plain copy

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 文件代码解读）

[java] view plain copy

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.      public void *(android.webkit.WebView,java.lang.String,android.graphics.Bitmap);  
70.      public boolean *(android.webkit.WebView,java.lang.String);  
71. }  
72. -keepclassmembers class * extends android.webkit.WebChromeClient {  #如果你的项目中用到了webview的复杂操作 ，最好加入  
73.      public void *(android.webkit.WebView,java.lang.String);  
74. }  
75. #对WebView的简单说明下：经过实战检验,做腾讯QQ登录，如果引用他们提供的jar，若不加防止WebChromeClient混淆的代码，oauth认证无法回调，反编译基代码后可看到他们有用到WebChromeClient，加入此代码即可。  
76.   
77. -keepclassmembernames class com.cgv.cn.movie.common.bean.** { *; }  #转换JSON的JavaBean，类成员名称保护，使其不被混淆  
78.   
79. ##################################################################  
80. # 下面都是项目中引入的第三方 jar 包。第三方 jar 包中的代码不是我们的目标和关心的对象，故而对此我们全部忽略不进行混淆。  
81. ##################################################################  
82. -libraryjars  libs/android-support-v4.jar  
83. -dontwarn android.support.v4.**  
84. -keep class android.support.v4.** { *; }    
85. -keep interface android.support.v4.** { *; }  
86. -keep public class * extends android.support.v4.**   
87. -keep public class * extends android.app.Fragment  
88.   
89. -libraryjars libs/gson-2.3.1-sources.jar  
90. -libraryjars libs/gson-2.3.1.jar  
91. -dontwarn com.google.gson.**      
92. -keep class sun.misc.Unsafe { *; }  
93. -keep class com.google.gson.** { *; }  
94.   
95. -libraryjars libs/alipaySDK-20150602.jar  
96. -dontwarn com.alipay.**      
97. -dontwarn com.ta.utdid2.**      
98. -dontwarn com.ut.device.**      
99. -keep class com.alipay.** { *; }  
100. -keep class com.ta.utdid2.** { *; }  
101. -keep class com.ut.device.** { *; }  
102.   
103. -libraryjars libs/android-async-http-1.4.6.jar  
104. -dontwarn com.loopj.android.http.**  
105. -keep class com.loopj.android.http.** { *; }  
106.   
107. -libraryjars libs/baidumapapi_v2_4_1.jar  
108. -dontwarn com.baidu.**  
109. -keep class com.baidu.** {*; }  
110. -keep class assets.** {*; }  
111. -keep class vi.com.gdi.bgl.** {*; }  
112.   
113. -libraryjars libs/libammsdk.jar  
114. -dontwarn com.tencent.**  
115. -keep class com.tencent.** { *; }  
116.   
117. -libraryjars libs/locSDK_4.1.jar  
118. -dontwarn com.baidu.location.**  
119. -keep class com.baidu.location.** { *; }  
120.   
121. -libraryjars libs/mframework.jar  
122. -dontwarn m.framework.**  
123. -keep class m.framework.** { *; }  
124.   
125. -libraryjars libs/mta-sdk-1.6.2.jar  
126. -dontwarn com.tencent.stat.**  
127. -keep class com.tencent.stat.** { *; }  
128.   
129. -libraryjars libs/nineoldandroids-library-2.4.0.jar  
130. -dontwarn com.nineoldandroids.**  
131. -keep class com.nineoldandroids.** { *; }  
132.   
133. -libraryjars libs/open_sdk_r4889.jar  
134. -dontwarn com.tencent.**  
135. -keep class com.tencent.** { *; }   
136.   
137. -libraryjars libs/ShareSDK-Core-2.5.9.jar  
138. -dontwarn cn.sharesdk.framework.**  
139. -keep class cn.sharesdk.framework.** { *; }   
140.   
141. -libraryjars libs/ShareSDK-ShortMessage-2.5.9.jar  
142. -dontwarn cn.sharesdk.system.text.**  
143. -keep class cn.sharesdk.system.text.** { *; }   
144.   
145. -libraryjars libs/ShareSDK-SinaWeibo-2.5.9.jar  
146. -dontwarn cn.sharesdk.sina.weibo.**  
147. -keep class cn.sharesdk.sina.weibo.** { *; }   
148.   
149. -libraryjars libs/ShareSDK-Wechat-2.5.9.jar  
150. -dontwarn cn.sharesdk.wechat.friends.**  
151. -keep class cn.sharesdk.wechat.friends.** { *; }   
152.   
153. -libraryjars libs/ShareSDK-Wechat-Core-2.5.9.jar  
154. -dontwarn cn.sharesdk.wechat.utils.**  
155. -keep class cn.sharesdk.wechat.utils.** { *; }   
156.   
157. -libraryjars libs/ShareSDK-Wechat-Favorite-2.5.9.jar  
158. -dontwarn cn.sharesdk.wechat.favorite.**  
159. -keep class cn.sharesdk.wechat.favorite.** { *; }   
160.   
161. -libraryjars libs/ShareSDK-Wechat-Moments-2.5.9.jar  
162. -dontwarn cn.sharesdk.wechat.moments.**  http://write.blog.csdn.net/postedit?ref=toolbar&ticket=ST-255186-iDAf6mlLvGKJPR9Lm5C0-passport.csdn.net
163. -keep class cn.sharesdk.wechat.moments.** { *; }   
164.   
165. -libraryjars libs/universal-image-loader-1.9.2-SNAPSHOT-with-sources.jar  
166. -dontwarn com.nostra13.universalimageloader.**  
167. -keep class com.nostra13.universalimageloader.** { *; }   
168.   
169. -libraryjars libs/weibosdkcore.jar  
170. -dontwarn com.sina.weibo.sdk.**  
171. -keep class com.sina.weibo.sdk.** { *; }  

说明一下，第三方jar包中如果有.so文件，不用去理会，引入的第三方jar文件不要混淆，否则可能会报异常。

文件

在release模式下打包apk时会自动运行ProGuard，这里的release模式指的是通过ant release命令或eclipse project->android tools->export signed(unsigned) application package生成apk。
在debug模式下为了更快调试并不会调用proguard。

如果是ant命令打包apk，proguard信息文件会保存于工程代码下的/bin/proguard文件夹内；

如果用eclipse export命令打包，会在/proguard文件夹内。其中包含以下文件：

mapping.txt
表示混淆前后代码的对照表，这个文件非常重要。如果你的代码混淆后会产生bug的话，log提示中是混淆后的代码，希望定位到源代码的话就可以根据mapping.txt反推。
每次发布都要保留它方便该版本出现问题时调出日志进行排查，它可以根据版本号或是发布时间命名来保存或是放进代码版本控制中。

dump.txt
描述apk内所有class文件的内部结构。

seeds.txt
列出了没有被混淆的类和成员。

usage.txt
列出了源代码中被删除在apk中不存在的代码。

不能混淆的代码

顾名思义，不能混淆代码如果被混淆了，就会出现错误。

1、需要反射的代码

2、系统接口

3、Jni接口

4、需要序列号和反序列化的代码（即实现Serializable接口的JavaBean）

5、与服务端进行元数据交互的JavaBean（JSON、XML中对应的类）

……

常见错误

1) Proguard returned with error code 1. See console

  > 更新proguard版本
  > android-support-v4 不进行混淆
  > 添加缺少相应的库

2) 使用gson包解析数据时，出现 missing type parameter 异常

  > 在 proguard-project.txt 中添加
    -dontobfuscate
    -dontoptimize
  > 在 proguard-project.txt 中添加
    # removes such information by default, so configure it to keep all of it.
    -keepattributes Signature 
    # Gson specific classes
    -keep class sun.misc.Unsafe { *; }
    #-keep class com.google.gson.stream.** { *; }
    # Application classes that will be serialized/deserialized over Gson
    -keep class com.google.gson.examples.android.model.** { *; }

3) 类型转换错误

  > 在 proguard-project.txt 中添加
    -keepattributes Signature

4) 空指针异常

  > 混淆过滤掉相关类与方法

5) java.lang.reflect.UndeclaredThrowableException

  > -keep interface com.dev.impl.**

6) Error: Unable to access jarfile ..libproguard.jar

  > 路径问题

7) java.lang.NoSuchMethodError

  > 这也是最常见的问题，因为找不到相关方法，方法被混淆了，混淆过滤掉相关方法便可。

android studio 中的混淆基本一样配置写在proguard-rlus.pro中

本文是忘记从哪些大神博客中copy出来的放在qq笔记中，现在突然想起就发了出来