Android:混淆文件proguard.cfg详解

在android项目中，一般都要使用代码混淆，在项目的根目录下，

红色圈中部分是代码混淆的文件。
下面给出proguard.cfg文件的内容：

#指定代码的压缩级别
-optimizationpasses 5
 #混淆时不会产生形形色色的类名  是否使用大小写混合
-dontusemixedcaseclassnames
 #指定不去忽略非公共的类库 是否混淆第三方jar
-dontskipnonpubliclibraryclasses
#不预校验  混淆时是否做预校验
-dontpreverify
#混淆时是否记录日志
-verbose 
-ignorewarnings
#优化 混淆时所采用的算法
-optimizations !code/simplification/arithmetic,!field/*,!class/merging/*
#不进行混淆、原样输出 保持哪些类不被混淆
-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 public class com.android.vending.licensing.ILicensingService
#保护指定的类和类的成员的名称，如果所有指定的类成员出席（在压缩步骤之后）
# 保持 native 方法不被混淆
-keepclasseswithmembernames class * {
    native <methods>;
}
#保护指定的类和类的成员，但条件是所有指定的类和类成员是要存在。
#保持自定义控件类不被混淆
-keepclasseswithmembers class * {
    public <init>(android.content.Context, android.util.AttributeSet);
}

-keepclasseswithmembers class * {
    public <init>(android.content.Context, android.util.AttributeSet, int);
}
-keepclasseswithmembers class * {  
    public <init>(android.content.Context);  
}
#保护指定类的成员，如果此类受到保护他们会保护的更好 
-keepclassmembers class * extends android.app.Activity { 
public void *(android.view.View); 
}
#保持枚举 enum 类不被混淆
-keepclassmembers enum * {
    public static **[] values();
    public static ** valueOf(java.lang.String);
}

#保护指定的类文件和类的成员
#保持 Parcelable 不被混淆
-keep class * implements android.os.Parcelable {
  public static final android.os.Parcelable$Creator *;
}

-assumenosideeffects class android.util.Log {
    public static *** d(...);
    public static *** i(...);
}
-keepclassmembers class **.R$* {
    public static <fields>;
}
#引用的库的jar，添加进来
-libraryjars libs/android-support-v4.jar
-libraryjars libs/android-viewbadger.jar
-libraryjars libs/baidumapapi_v3_2_0.jar
-libraryjars libs/cyberplayer-sdk.jar
-libraryjars libs/jpush-sdk-release1.7.2.jar
-libraryjars libs/ksoap2-android.jar
-libraryjars libs/locSDK_3.3.jar
-libraryjars libs/universal-image-loader-1.9.4-with-sources.jar
-libraryjars libs/picasso-2.4.0.jar
-libraryjars libs/umeng-analytics-v5.2.4.jar
-libraryjars libs/HMSDK.jar
-libraryjars libs/KJFrameForAndroid_v2.245.jar

-dontwarn com.huamaitel.**
-keep class com.huamaitel.** { *;}

-dontwarn javax.security.sasl.**
-keep class javax.security.sasl.** { *;}

-dontwarn android.support.v4.**
-keep class android.support.v4.** { *;}

-dontwarn com.baidu.**
-keep class com.baidu.** { *;}

-dontwarn cn.jpush.**
-keep class cn.jpush.** { *;}

-dontwarn com.umeng.**
-keep class com.umeng.** { *;}
-dontwarn u.aly.**
-keep class u.aly.** { *;}

-dontwarn com.squareup.**
-keep class com.squareup.** { *;}

-dontwarn org.ksoap2.**
-keep class org.ksoap2.** { *;}
-dontwarn org.kobjects.**
-keep class org.kobjects.** { *;}
-dontwarn org.kxml2.**
-keep class org.kxml2.** { *;}
-dontwarn org.xmlpull.**
-keep class org.xmlpull.** { *;}

-dontwarn com.nostra13.universalimageloader.**
-keep class com.nostra13.universalimageloader.** { *;}

-keep class vi.com.gdi.bgl.** {*;}

-dontwarn com.readystatesoftware.**
-keep class com.readystatesoftware.** { *;}

-dontwarn org.kymjs.**
-keep class org.kymjs.** {*;}

#下面几行 是环信即时通信的代码混淆
-keep class com.easemob.** {*;}
-keep class org.jivesoftware.** {*;}
-keep class org.apache.** {*;}
-dontwarn  com.easemob.**

这是我在项目中使用到的整个代码混淆的内容。

什么是代码混淆

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

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

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

代码混淆的方法

根据 SDK 的版本不同有 2 中不同的代码混淆方式，以上的 proguard.cfg 参数详解中所涉及到的信息是在较低版本 SDK 下的混淆脚本，事实上在高版本的 SDK 下混淆的原理和参数也与低版本的相差无几，只是在不同 SDK 版本的环境下引入混淆脚本的方式有所不同。具体方法如下：

• 低版本

低版本 SDK 下，项目中同时包含 proguard.cfg 和 project.properties 文件，则只需在 project.properties 文件末尾添加 proguard.config=proguard.cfg 再将项目 Export 即可。
我的项目中的proguard.properties文件内容如下：

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

# Project target.

target=android-19
proguard.config=proguard.cfg
android.library=false

• 高版本

高版本 SDK 下，项目中同时包含 proguard-project.txt 和 project.properties 文件，这时需要在 proguard-project.txt 文件中进行如下信息的配置，然后再将项目 Export 即可。

# To enable ProGuard in your project, edit project.properties
# to define the proguard.config property as described in that file.
#
# Add project specific ProGuard rules here.
# By default, the flags in this file are appended to flags specified
# in ${sdk.dir}/tools/proguard/proguard-android.txt
# You can edit the include path and order by changing the ProGuard
# include property in project.properties.
#
# For more details, see
#   http://developer.android.com/guide/developing/tools/proguard.html

# Add any project specific keep options here:

# If your project uses WebView with JS, uncomment the following
# and specify the fully qualified class name to the JavaScript interface
# class:
#-keepclassmembers class fqcn.of.javascript.interface.for.webview {
#   public *;
#}

下面给出代码混淆时候可能遇到的问题：

加入第三方jar包之后常出现的几个异常
proguard returned with error code 1.See console
情况1：
Proguard returned with error code 1. See console
Error: C:/Documents (系统找不到指定文件)
后来发现是因为将整个工程放到了桌面上，而桌面的目录是C:/Documents and Settings/Administrator/桌面，在这里面有空格，而proguard进行发编译的时候是不允许有空格的
如果换了正确路径还不好用的话，直接删除proguard就好了
注意：SDK和程序路径最好不要有空格符

情况2：
Proguard returned with error code 1. See console
异常：
java.lang.ArrayIndexOutOfBoundsException
解决办法：将proguard.cfg中的”-dontpreverify”改成“-dontoptimize”
参考文章：http://groups.google.com/group/android-developers/browse_thread/thread/eca3b0f5ce6ad00f

我把项目中生成的proguard文件夹（此时文件夹是空的）删掉，然后再重新运行项目，就OK 了。

情况3：
[2011-10-21 13:22:32 - ZMKSMarket_Build_v1.0] Proguard returned with error code 1. See console
[2011-10-21 13:22:32 - ZMKSMarket_Build_v1.0] java.io.IOException: Can’t read [proguard.ClassPathEntry@106082] (No such file or directory)
[2011-10-21 13:22:32 - ZMKSMarket_Build_v1.0] at proguard.InputReader.readInput(InputReader.java:230)
[2011-10-21 13:22:32 - ZMKSMarket_Build_v1.0] at proguard.InputReader.readInput(InputReader.java:200)
[2011-10-21 13:22:32 - ZMKSMarket_Build_v1.0] at proguard.InputReader.readInput(InputReader.java:178)
[2011-10-21 13:22:32 - ZMKSMarket_Build_v1.0] at proguard.InputReader.execute(InputReader.java:100)
[2011-10-21 13:22:32 - ZMKSMarket_Build_v1.0] at proguard.ProGuard.readInput(ProGuard.java:195)
[2011-10-21 13:22:32 - ZMKSMarket_Build_v1.0] at proguard.ProGuard.execute(ProGuard.java:78)
[2011-10-21 13:22:32 - ZMKSMarket_Build_v1.0] at proguard.ProGuard.main(ProGuard.java:499)
抛出这样的异常的原因是第三方jar的引用路径不对，没有找到这个需要忽略混淆的jar包。
参考：http://stackoverflow.com/questions/4884456/android-proguard-java-io-ioexception-cant-read-proguard-classpathentry

情况4：
1，android-support-v4.jar报错的话，要加上下面的代码
-ignorewarnings
-dontwarn android.support.v4.**
-keep class android.support.v4.* { ; }
-keep interface android.support.v4.app.* { ; }
-keep public class * extends android.support.v4.**
-keep public class * extends android.app.Fragment
2，所有的*.jar包都要加上
-libraryjars libs/*.jar
3，混淆代码除了可以更安全还有一个好处是：你的APK文件变得更小，大概为混淆之前的1/2吧。

参考地址：http://www.cnblogs.com/sunzn/archive/2013/03/06/2946952.html
http://blog.csdn.net/fhl13017599952/article/details/24265831