Eclipse与Android源码中ProGuard工具的使用（代码混淆）

小铲子 · 发表于 2016-4-25 11:03:58

ProGuardandroid提供的一个免费的工具，它能够移除工程中一些没用的代码，或者使用语义上隐晦的名称来重命名代码中的类、字段和函数等，达到压缩、优化和混淆代码的功能。具体来说，使用ProGuard工具，可以达到下面两个目的：

删除了源文件中没有调用的那部分代码，最大化的精简了字节码文件，使得最终生成的apk文件更小。
使用语义混淆的命名替换了代码中的类、字段和函数等，使得其他人无法反编译获取源代码，起到对代码的保护作用。

我看网上有不少人根据ProGuard工具的作用，直接称呼其为“混淆代码工具”，本文也暂时用这个词简称。

更多的理解，可以参考ProGuard工具的官方文档地址：http://developer.android.com/tools/help/proguard.html

ProGuard工具的集成与使用环境

其实，ProGuard工具是已经集成到我们android系统中的，所以不需要用户手动的去集成。但是有一点需要注意，仅在程序处于Release模式时ProGuard才有效，反之在Debug模式是不能通过ProGuard来混淆代码的。

根据ProGuard的具体使用环境，我分在Eclipse工具和android源码两种编译环境浅谈ProGuard的使用方法。

Eclipse环境中ProGuard的使用

以我电脑的android4.0环境为例，当我们在Eclipse中新建一个项目，或者导入一个已存在项目（保证当前项目没有语法错误）后，在工程的根目录，会自动生成两个ProGuard的混淆文件：proguard-project.txt和project.properties（在老版本的ADT中，只会生成一个叫proguard.cfg的文件）。我们先看下文件project.properties ：

1 2 3 4 5 6 7 8 91011121314

# 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-16

看后面一段注释：To enable ProGuard to shrink and obfuscate your code, uncomment this (available properties: sdk.dir, user.home) ，意指要让ProGuard 来压缩和混淆代码，把这句注释去掉即可！所以，我们只要把下面一句注释取消即可，如下所示：

12	# 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

我们仔细的看下这部分代码：这个地方是通过设置proguard.config属性来指定混淆代码的配置文件为本机SDK目录下面的proguard-android.txt文件，以及制定混淆的个性化配置文件为当前工程（eclipse下）根目录下面的proguard-project.txt文件，而后面这个文件，恰是我们刚才看到的原本在根目录下自动生成的另外一个文件！

其实打开了这个地方，我们就已经可以混淆代码了，不过这里要注意：不能试图通过运行eclipse中的Run as 和 Debug as 菜单来生成混淆代码，必须通过如下图所示的方法将apk导出才行，当然你可以选择“签名”或者“不签名”：

这样一步操作后，算是代码混淆完成了。那么怎么才能检验我们真的混淆了代码了呢？首先，我们能够看到在工程的根目录新生产了一个文件夹proguard，里面有四个文件，其内容如下：

dump.txt : 描述了apk中所有类文件中内部的结构体。（ Describes the internal structure of all the class files in the .apk file ）
mapping.txt : 列出了原始的类、方法和名称与混淆代码见得映射。（ Lists the mapping between the original and obfuscated class, method, and field names. ）
seeds.txt : 列出了没有混淆的类和方法。( Lists the classes and members that are not obfuscated )
usage.txt : 列出congapk中删除的代码。（ Lists the code that was stripped from the .apk ）

同时使用反编译软件对新生成的apk反编译后会发现，里面的类名、方法和变量等，都变成了简单的a、b、c、d等毫无含义的字母，这样就达到了混淆的目的：

但在实际使用过程中，我们会发现当前apk中的有些方法和类，是要供外部使用的，而此时混淆了名称，外部调用就会报错了，那么怎么解决这个问题？此时就要用到我们刚才提到的混淆的个性化配置文件proguard-project.txt，在其中去配置不需要混淆的类、方法和变量等。关于混淆文件的具体配置方法，请看下面的最后一个标题会有详述。

Android源码环境中ProGuard使用

在Google发布的android源码中，面对那么多代码和文件目录，此时该如何混淆代码与配置混淆文件呢？

android中默认是将代码混淆ProGuard关闭的，在alps/build/core/proguard.flags中有下面一句，意指将默认不混淆，不需要代码删除，我们将这一句注释起来，就起到代码混淆编译的作用。

12	# Don't obfuscate. We only need dead code striping.-dontobfuscate

可以说，这句是android工程中代码混淆的总开关，然而，注释了上面的代码后，整个工程就已经是代码混淆了吗？不是的，这里还要关注一个文件alps/build/core/package.mk，在这个文件中有这么一段：