【转】ProGuard的做用、使用及bug分析

原文地址:http://blog.csdn.net/forlong401/article/details/23539123.

http://www.trinea.cn/android/proguard-use/

本文主要ProGuard的做用、使用及bug分析。
一、ProGuard做用
ProGuard经过删除无用代码，将代码中类名、方法名、属性名用晦涩难懂的名称重命名从而达到代码混淆、压缩和优化的功能，跟JavaScript的混淆压缩相似。
压缩和优化使得编译后apk包更小。
混淆能够保证代码在被反编译后读懂的难度很大，防止逆向工程。这点也是咱们在应用发布前须要ProGuard的一大缘由。

 

二、ProGuard的使用
(1). 系统应用：
在项目根目录下的Android.mk文件中添加

 

XHTML

LOCAL_PROGUARD_FLAG_FILES := proguard.cfg LOCAL_PROGUARD_ENABLED := full

1 2	LOCAL _PROGUARD_FLAG_FILES := proguard.cfg LOCAL _PROGUARD_ENABLED := full

这样应用不须要单独设置proguard配置文件，在系统编译时会采用系通通一的proguard.cfg对该应用进行proguard，系统proguard.cfg位于系统根目录\build\core内。

 

(2). 非系统应用：
a. 打开ProGuard开关
在项目根目录下的project.properties文件中配置proguard，添加以下代码：

 

XHTML

proguard.config=proguard.cfg

1	proguard .config=proguard.cfg

这样在release模式下打包apk以前，proguard会以proguard.cfg为规则处理应用字节码。关于release模式下面第c部分会进行介绍

 

b. 编写本身的proguard config文件
默认会对全部代码混淆，若是须要部分混淆，能够本身修改proguard.cfg文件
关于proguard config的语法及标准配置可见：Proguard语法及经常使用proguard.cfg代码段

注意下列类不能进行混淆：
(1)、反射用到的类
(2)、在AndroidManifest中配置的类(Activity、Service等的子类及Framework类默认不会进行混淆)
(3)、Jni中调用的类

 

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

 

若是是ant命令打包apk，proguard信息文件会保存于<project_root>/bin/proguard文件夹内；如 果用eclipse export命令打包，会在<project_root>/proguard文件夹内。其中包含如下文件：

mapping.txt表示混淆先后代码的对照表，这个文件很是重要。若是你的代码混淆后会产生bug的话，log提示中是混淆后的代码，但愿定位到源代码的话就能够根据mapping.txt反推。
dump.txt描述apk内全部class文件的内部结构
seeds.txt列出了没有被混淆的类和成员
usage.txt列出了源代码中被删除在apk中不存在的代码

下图为mapping.txt部份内容，以及混淆先后的代码对比：

从中能够看出混淆后代码大多abcdefg..

 

注意：养成保存mapping.txt的习惯。ProGuard会在每次运行时覆盖原来的文件，因此每次发布请保存mapping.txt，方便该版本出现问题时调出日志进行排查。mapping.txt能够根据版本号或是发布时间命名来保存或是放进代码版本控制中。

 

d. ProGuard是否成功检查

能够经过反编译Apk检查proguard是否成功，若是成功代码会相似上面的截图，大部分类名及成员名都是形如a.b.c…。关于反编译请参考：Android Apk 反编译

 

三、ProGuard混淆后bug分析
(1) 代码自己bug
混淆后bug提示信息中代码都是混淆后代码，类a. b. c…，若是须要排查，就得根据mapping.txt文件去反推实际代码中对应的代码段从而解决问题
PS：混淆后代码中的$表示匿名内部类，根据代码中顺序依次为OutClassName$1, OutClassName$2

 

(2) 因混淆而产生的bug
应用可能会由于ProGuard混淆了不应混淆的代码而产生一些bug，其中最多见的就是ClassNotFoundException，还有BadParcelableException等
对于ClassNotFoundException，根据mapping.txt文件反推找到某个类，而后在proguard.cfg中不进行混淆便可

 

Java

-keep class packagename.classname { *; }

1	-keep class packagename.classname { *; }

 

对于android.os.BadParcelableException: Parcelable protocol requires a Parcelable.Creator object called CREATOR，proguard.cfg中添加

 

Java

-keep class * implements android.os.Parcelable { public static final android.os.Parcelable$Creator *; }

1 2 3

-keep class * implements android.os.Parcelable {     public static final android.os.Parcelable$Creator *; }

 

对于android.support.v4  can’t find superclass or interface，can’t find referenced method，proguard.cfg中添加

 

Java

-libraryjars libs/android-support-v4.jar -dontwarn android.support.v4.** -keep class android.support.v4.** { *; } -keep interface android.support.v4.app.** { *; }

1 2 3 4

-libraryjars   libs/android-support-v4.jar -dontwarn android.support.v4.**     -keep class android.support.v4.** { *; }   -keep interface android.support.v4.app.** { *; }

proguard混淆后其余问题可见：http://proguard.sourceforge.net/index.html#manual/troubleshooting.html

 

 

你可能还感兴趣：

Proguard语法及经常使用proguard.cfg代码段

Android性能调优总结

Android系统下载管理DownloadManager功能介绍及使用示例

Android下载管理DownloadManager功能加强和bug修改