Android开发中使用ProGuard

关注

转载最新推荐文章于 2026-07-20 07:18:38 发布 1.1k 阅读 AI 写同款· GEO 优化 ›

Android开发规范：APP常用混淆proguard模板 ** get*();文章所有资料全部已经打包整理好，另外小编手头上整理了大量Android架构师全套学习资料，Android核心高级技术PDF文档+全套高级学习资料+视频+2021 BAT 大厂面试真题解析资料展示：《Android学习笔记总结+移动架构视频+大厂面试真题+项目实战源码》，点击传送门即可获取！文章所有资料全部已经打包整理好，另外小编手头上整理了大量Android架构师全套学习资料，阅读详情

-injars androidtest.jar【jar包所在地址】
-outjars out【输出地址】

-libraryjars 'D:\android-sdk-windows\platforms\android-9\android.jar' 【引用的库的jar，用于解析injars所指定的jar类】

-optimizationpasses 5
-dontusemixedcaseclassnames 【混淆时不会产生形形色色的类名】
-dontskipnonpubliclibraryclasses 【指定不去忽略非公共的库类。】
-dontpreverify 【不预校验】

-verbose
-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 * extends android.app.backup.BackupAgentHelper
-keep public class * extends android.preference.Preference
-keep public class com.android.vending.licensing.ILicensingService

-keep public abstract interface com.asqw.android.Listener{
public protected <methods>; 【所有方法不进行混淆】
}
-keep public class com.asqw.android{
public void Start(java.lang.String); 【对该方法不进行混淆】
}

-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);
}

-keepclassmembers class * extends android.app.Activity {【保护指定类的成员，如果此类受到保护他们会保护的更好】
public void *(android.view.View);
}

-keepclassmembers enum * {
public static **[] values();
public static ** valueOf(java.lang.String);
}

-keep class * implements android.os.Parcelable {【保护指定的类文件和类的成员】
public static final android.os.Parcelable$Creator *;
}

今天被同事问到怎么在release版本里面所有的log都去掉的时候，竟然只能回忆起用ProGuard做过这个，完全忘记怎么做的了，特立此存照。文章里面使用的例子放在 Android-Maven-ProGuard-Sample-App

ProGuard简介

在移动设备上面开发应用程序，性能是一个很关键的指标。你的老板走过来要你提高性能的时候，你的第一反应有可能是抓起熟悉的工具花几个小时profile自己的应用，找出那些时间都花在哪里了。在使用这么终极的手段之前，千万不要忘记了先试试ProGuard。

做Android之前就是Java程序员的可能早就已经对ProGuard很熟悉了。简单的来说，ProGuard就是一个Java的class文件处理器，主要的功能类似奥运会口号：

让你的程序变得更小更快
让你的程序变得更难被反向工程

尽管ProGuard不是专用于Android开发的，但是在Android的SDK里面已经包括了这个工具，路径是ANDROID_HOME/tools/proguard，文档可以在http://proguard.sourceforge.net看到。

让程序变得更小更快的好处是不言而喻的。ProGuard通过对bytecode进行优化，优化手段包括去掉无用的代码，去掉内联方法的调用，对类的继承结构进行优化，把所有能加上的final和static加上，以及对算术运算进行Peephole optimization等等。

让程序变得更难被反向工程就不一定是每个人都需要的了。一般情况下，对Android的反向工程是把Dalvik的bytecode转换成Java的bytecode，然后使用传统的Java反向工具转成成Java源代码。如果你的项目是开源的，显然也没有必要防止别人反向。但是如果是下面几种情况，你就很可能需要它了：

你在源文件里面有一些不想被别人看到的信息，如密码等
你的代码里面有自己或者公司的赖以生存的知识产权
你的甲方有明确的要求
你的程序按license等方式收费，你不想被别人把licens检查的部分去掉重新编译个版本

ProGuard可以帮助通过对类，方法和成员名称进行混淆，同时通过去掉结构化的信息，如文件名或者行号表等，来使得代码从理论上变得不可被反向工程。

如此看来，ProGuard真是美好事物一枚。但是ProGuard也不是随手一点药到病除的，也有一点学习曲线。

启用ProGuard

如果你使用Eclipse的ADT，每个新建的项目都会生成一个proguard.cfg文件在项目的根目录。你对ProGuard的所有设定就是在这个文件里面完成的。要想在项目里面启用Proguard，只需要把同样在项目根目录的default.properties里面加上：

proguard.config=proguard.cfg

当然，如果你蛋疼到要自己去移动cfg文件的位置，也要记得去改等号后面的部分。然后，在所有的release版本的build里，你的Proguard就已经生效了。对于使用Eclipse的同学来说，release的build就是指通过选择Android Tools>Export Signed/Unsigned Application Package来进行。

因为在大多数开发中我们都会使用Ant或者是Maven来对项目进行管理，所以一般不会直接用Eclipse来进行release版本的编译，所以通常我们还要掌握如何在不使用ADT的情况下使用ProGuard。对于Maven而言，可以通过使用Maven Android plugin来完成。同时，由于ProGuard已经完全集成到Android的工具链里面了，所以Android的Ant任务里面也有一个专门的private任务叫做-obfuscate，会把激活并使用ProGuard作为release这个target的一部分，所以使用Ant的话只要一个ant release就可以了。

当ProGuard执行以后，会产生几个特别重要的文件：

mapping.txt：保存了混淆后的名字和混淆前名字的对应关系。对于每次release的build，都要记得保存这个文件，要不然如果你收到release版本上报出的defect的时候，就等着哭吧。
seeds.txt：ProGuard找到的你的程序的entrypoint列表。
usage.txt：ProGuard觉得没有用所以移除了的一堆类，域和方法的list。要想学习写作“完美”的ProGuard规则的同学就要经常来这个文件看看自己定下的rule对ProGuard的行为究竟有什么样的影响。如果你有用的类出现在list里面了，说明你削得太猛了，反之亦然。

需要注意的是这些文件的输出目录。在使用Ant ProGuard target的时候，输出目录是bin/proguard/，但是如果是通过ADT(右键project>Android Tools>Export）的话，输出目录会是proguard/。

还有一个常见的困惑就是ProGuard是怎么找到那些需要处理的文件的。一般情况下，ProGuard希望你用-injars或者是-libraryjars来告诉它。但是对Android开发而言，Ant任务和ADT都会自动的查看你的libs，output和项目的classpath目录。

从执行过程的日志来看，ProGuard对类文件的操作分为三个步骤：shrink，optimize，obfuscate。每个步骤都是可选的，可以通过使用-dontshrink、-dontoptimize和-dontobfuscate来分别关掉。一般来说，不用因为结果“不如人意”就随意的关掉某个步骤。完整的进行三个步骤，然后不断的改变规则，直到达到最佳效果，是使用ProGuard的最佳方式。

编写ProGuard规则

ProGuard和很多工具一样，其强大之处在于选项够多。作为Android开发者使用，首先心里要明白，没有一个唯一的最佳配置规则。在此基础上，去掌握一些对Android程序而言通常是适用的规则。然后，就像在文章里面已经反复强调过的一样，以这些规则为起点，反复的调整你的规则，找出一个对自己的程序最适用的规则。

当然，因为选项太多，ProGuard给初学者的感觉难免是千头万绪，无从下手。因此，我们可以从一个例子程序入手来找到对ProGuard的“感觉”。

这个例子本身没有任何特别之处，MyButton类继承自Button但是没有添加新的方法，可以通过它来观察ProGuard如何对继承结构进行压缩。Click的handler除开显示toast之外也没有特别的功能，可以通过它来观察ProGuard对方法名的混淆。AMPSampleActivity里面还专门有一个没有被调用的方法，可以通过它来观察ProGuard对这种情况的处理。下面是程序的入口Activity的实现：

我们期望ProGuard做的事情包括：

保留AMPSampleActivity类，因为它是我们在XML里面指定的程序入口
保留StringUtils类和它的repeat方法
保留myClickHandler方法
保留MyButton类
去掉unusedMethod
除开XML里面引用的类（AMPSampleActivity和MyButton），其他的类名都需要被混淆
除开XML里面引用的方法名（myClickHandler），其他的方法名都要被混淆
完成一些对Android而言通常适用的优化（下面会仔细展开）

ProGuard的规则是“白名单”的，也就是说ProGuard只会对你特别指定的类刀下开恩。这也就是说，对任何程序，我们都至少要写一条规则，来保留程序的入口类。因为是Android程序，我们可以这么写：

-keep public class * extends android.app.Activity

这里我们可以看到ProGuard的rule用的语法基本上遵循了Java本身的语法（extends等等），但是它支持使用通配符。规则中的-keep告诉ProGuard不要删除也不要混淆任何从android.app.Activity继承的类。

很简单，不是吗？如果你这个时候运行程序，会看到：

    org.lenciel.android/org.lenciel.android.AMPSampleActivity}: 
    ➥ android.view.InflateException: Binary XML file line #6: Error inflating 
    ➥ class org.lenciel.android.MyButton

为什么在inflate我们自定义的view的时候crash了呢？这是因为自定义的view是在XML里面被用到的，而不是在Java代码里面。因此ProGuard会认为这是没有用的代码而试着删除它。要保证这些自定义的view不被误删，就需要定义如下的规则：

-keepclasseswithmembers class * {
    public <init>(android.content.Context, android.util.AttributeSet); 
} 
 
-keepclasseswithmembers class * {
    public <init>(android.content.Context, android.util.AttributeSet, int); 
}

这两条规则告诉ProGuard不要对定义了可能被LayoutInflater调用的构造函数的任何类进行优化。我们这里使用了-keepclasseswithmembers而不是-keep。

再次运行，会遇到下面的错误：

java.lang.IllegalStateException: Could not find a method 
   ➥ myClickHandler(View) in the activity class org.lenciel.android.AMPSampleActivity for onClick handler on 
   ➥ view class org.lenciel.android.MyButton

去查看usage.txt你会发现myClickHandler又被干掉了。为什么在第一条规则里面我们告诉ProGuard不要动AMPSampleActivity里面的任何东西，还是会有这种情况发生？这是使用-keep的一个常见的误会。我们用-keep告诉ProGuard保留一个类的时候，没有提供任何类的“body”信息的话，ProGuard仅仅会保留这个类的名字。它仍然会对这个类内部的所有东西进行优化和混淆。要保留方法，我们需要这么写：

-keep public class * extends android.app.Activity { 
    methods; 
}

但是这样写显然又太过于慷慨了。下面这条规则会好很多：

-keepclassmembers class * extends android.app.Activity {
    public void *(android.view.View); 
}

这条规则告诉ProGuard，如果一个Activity在shrink阶段没有被去掉，那么就保留那些public的，没有返回值的，传入了android.view.View作为参数的方法。

可以看到，使用ProGuard存在一个不断调优的过程。他山之石，可以攻玉，已经有很多人使用ProGuard来优化Android程序了，于是也有了一些被普遍采用的规则和选项，我们下面来个简单说明。

常用规则和选项

前面看到的规则对于例子程序就足够了。但是如果我们的程序使用了Service怎么办？和Activity一样，Service也是在manifest xml里面定义的，因此我们需要对proguard.cfg做一定的扩展。

下面的规则是针对Android程序一般来说都比较有效的。

一般来说，下面的Android framework class都是需要保留的：

-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 * extends android.app.backup.BackupAgentHelper 
-keep public class * extends android.preference.Preference 
-keep public class com.android.vending.licensing.ILicensingService

虽然你的程序可能一开始没有使用其中的一些类，但是定义好全部这些规则也是有好处的：它可以避免你在使用ProGuard编出的版本crash之后去搞半天才发现有某个类似的规则需要更新但是你忘记了。

第二个有用的规则是保留static的CREATOR域，这个是Android用来parcel对象的。这个域由于是在运行的时候Instrospection的，所以ProGuard会认为它是无用的域并把它去掉。下面这条rule可以防止这样的事情发生：

-keepclassmembers class * implements android.os.Parcelable {
    static android.os.Parcelable$Creator CREATOR; 
}

在程序中如果你调用了native的code，比如你用JNI来调用了c的lib，由于在Java代码里面是一份方法的签名，而没有方法的实现，它必须被链接到native code上。这也就意味着这些函数名不能被ProGuard加以混淆了，不然链接的过程就会失败。下面的规则可以保证ProGuard不去动native的方法名：

-keepclasseswithmembernames class * { 
     native methods; 
}

我们这里使用的-keepclasseswithmembernames是告诉ProGuard，被调用过的方法留着，没有调用过的都去掉。

前面的规则看起来都一目了然。下面这个可能要费解一些：

-keepclassmembers enum * {   
     public static **[] values(); 
     public static ** valueOf(java.lang.String); 
}

这个规则是让ProGuard不要去动任何Enum的values和valueOf方法。这些方法之所以特殊是因为Java自己是通过发射机制来调用它们的。这可能也是Google不建议使用Java enum的原因吧：它们比final class fields的性能要低不少。如果你已经遵照Google的教诲停止使用Enum，那你也不需要这条规则了，恭喜。

下面来看看常用的选项：

-dontusemixedcaseclassnames 
-dontskipnonpubliclibraryclasses 
-dontpreverify 
-verbose

第一个选项可以避免像Windows这样不区分大小写的操作系统不会因为类似A.class和a.class写到同一个文件里面就驾崩。

第二个选项是因为ProGuard默认不会处理任何非public的类。但是有时候我们会遇到public的类继承自内部的非public的类。所以打开这个选项可以更好的覆盖。

第三个选项是告诉ProGuard不要做preverify（预检验），因为这个只对J2ME或者是Java6的平台有用。

最后一个选项，你们懂的。

前面我们提到过ProGuard有一个优化代码（optimize）的过程。大多数时候ProGuard都会火力全开的对所有的代码做优化。这些优化操作有些时候是相当aggressive的，比如合并类的时候ProGuard会试着既从纵向上合并也从横向上合并，以便得到尽量少的类文件，也就可以得到尽量小的APK。同时它还会试着优化循环和代数运算。默认的ADT生成的ProGuard选项关掉了很多的优化选项：

-optimizations !code/simplification/arithmetic,!field/*,!class/merging/*

Google并没有提供他们这么配置的依据。我们可以试着先禁用这个选项，看看程序运行起来会不会有问题。如果遇到了问题再试着慢慢的减弱优化，来“探底”。

同时ProGuard的优化是可以“递归”的，也就是优化完的结果可以作为下次优化的输入继续优化。你可以指定它反复进行多少次。但ProGuard如果发现已经没有什么可以优化，会自动停下来，不一定跑到你指定的次数。一般设置成5就够了：

-optimizationpasses 5

如果处理混淆后版本的错误报告

如果你发布了混淆的版本，有一个问题你就得面对：用户提交的问题单里面产生自这些类和方法都完全打乱过后的版本。为了展示这种问题，在Demo程序里面专门加了这么一个类：

public class Bomb {
    public void explode() {
        throw new RuntimeException("Boom!");
    }
}

在onCreate方法里面它会被引爆：

public void onCreate(Bundle savedInstanceState) {
    super.onCreate(savedInstanceState);
    setContentView(R.layout.main);
    String toast = StringUtils.repeat("Hello ProGuard! ", 3);
    Toast.makeText(this, toast, Toast.LENGTH_SHORT).show();
    new Bomb().explode();
}

如果你运行程序，就会看到下面的错误：

java.lang.RuntimeException: Unable to start activity ...MainActivity}: 
java.lang.RuntimeException: Boom!
...
Caused by: java.lang.RuntimeException: Boom!
   at org.lenciel.android.MainActivity.onCreate(Unknown Source)
   at android.app.Instrumentation.callActivityOnCreate(
   ➥ Instrumentation.java:1047)
   at android.app.ActivityThread.performLaunchActivity(
   ➥ ActivityThread.java:2627)
   ... 11 more

可以看到在错误出现位置的stack trace既没有行号也没有文件名。这是因为相关的信息都被ProGuard优化掉了。如果我们想避免这种情况，就要在proguard.cfg里面加上下面的选项：

-keepattributes SourceFile,LineNumberTable

显然，有了行号和文件名，还是解决不了方法被混淆的问题。我们这个例子程序里面方法很少，而onCreate方法因为是Override的，所以ProGuard不会去动它。如果是正式的工程，最好的办法还是用retrace工具来根据mapping.txt还原整个日志。

$ retrace proguard/mapping.txt stacktrace.txt

收录于

Android

标签

#android #class #优化 #java #methods

运维面试常见问题对数据库表中一列或多列的值进行排序的一种结构，使用索引可快速访问数据库表中的特定信息。优缺点：优点：利用索引可以加速对数据的检索，索引是可以唯一的，创建索引允许指定单个列或者多个列缺点：减慢了数据录入速度，同时也增加了数据库的尺寸大小。阅读详情