Gradle For Android（四）Gradle 编译中神秘的混淆

在 Gradle For Android（二） 多渠道打包与签名配置中说过在平常开发中进行打包apk的一些往事，打包测试、打包上传应用商店，这些都避免不了。固然在这过程当中，除了签名打包，固然少不了代码的混淆了。代码混淆，说白了就是代码压缩、代码混淆以及资源压缩的优化。依靠 ProGuard，将全部类名、方法名重命名为无心义的简单名称，增长了逆向工程难度。依靠Gradle插件，移除了没有使用的资源，减小了apk大小 。

Gradle For Android 导读

• Gradle For Android （一） 基础定义与依赖管理篇
• Gradle For Android（二） 多渠道打包与签名配置
• Gradle For Android（三）Gradle优化与灵活的使用技巧

正文：

1、Android Gradle 混淆中的配置

通常，在咱们的application moudle中的gradle配置项buildTypes中,例如以下：

release { //release类型
            minifyEnabled false
            // 启用混淆
            proguardFiles getDefaultProguardFile('proguard-android.txt'), 'proguard-rules.pro'
        }复制代码

这里minifyEnabled表示启动混淆，通常启动混淆编译速度会比较慢，所以在编译debug版本的时候通常默认不开启。proguard-rules.pro这个表示该module默认的混淆文件，咱们能够直接将混淆内容写在这里。另外，这里也要说下shrinkResources 这个字段，当为true的时候，表示打开资源压缩，编译时会去掉没被使用的资源文件。

修改后的配置代码以下：

buildTypes {//表示构建类型 通常有release debug 两种

        debug{
            buildConfigField 'String','STATE_TEST','"debug"'//buildConfigField
            resValue "string", "test_value", "AGradle_debug"//resValue
        }

        release { //release类型
            minifyEnabled true  // 启用混淆
            shrinkResources true  // 资源压缩
            proguardFiles getDefaultProguardFile('proguard-android.txt'), 'proguard-rules.pro'

            buildConfigField 'String','STATE_TEST','"release"' //buildConfigField
            resValue "string", "test_value", "AGradle_release" //resValue
        }

    }复制代码

2、混淆规则举例

这里贴下网上认为比较"通用"的混淆规则以下：

#指定压缩级别
-optimizationpasses 5

#不跳过非公共的库的类成员
-dontskipnonpubliclibraryclassmembers

#混淆时采用的算法
-optimizations !code/simplification/arithmetic,!field/*,!class/merging/*

#把混淆类中的方法名也混淆了
-useuniqueclassmembernames

#优化时容许访问并修改有修饰符的类和类的成员 
-allowaccessmodification

#将文件来源重命名为“SourceFile”字符串
-renamesourcefileattribute SourceFile
#保留行号
-keepattributes SourceFile,LineNumberTable

#保持全部实现 Serializable 接口的类成员
-keepclassmembers class * implements java.io.Serializable {
    static final long serialVersionUID;
    private static final java.io.ObjectStreamField[] serialPersistentFields;
    private void writeObject(java.io.ObjectOutputStream);
    private void readObject(java.io.ObjectInputStream);
    java.lang.Object writeReplace();
    java.lang.Object readResolve();
}

#Fragment不须要在AndroidManifest.xml中注册，须要额外保护下
-keep public class * extends android.support.v4.app.Fragment
-keep public class * extends android.app.Fragment

# 保持测试相关的代码
-dontnote junit.framework.**
-dontnote junit.runner.**
-dontwarn android.test.**
-dontwarn android.support.test.**
-dontwarn org.junit.**复制代码

"通用"，固然真正实现通用，除了上面的混淆规则，须要根据项目须要添加自定义的混淆规则

例如：

• 第三方库混淆规则。这个比较常见，直接接入官方说明文档。

• model实体类，典型在转化json的时候，必须保证model不被混淆，所以需加入--keep public class

JNI中调用的类以及方法不可被混淆

• WebView中JavaScript调用的接口不混淆

• AndroidMainfest、四大组件以及Application的子类不混淆

• Parcelable的子类和Creator静态成员变量不混淆，不然会产生Android.os.BadParcelableException异常

• Layout布局使用的View构造函数、android:onClick等。

3、混淆结果的检测

在开启混淆后，经过混淆配置打包后，会在目录：

 
  
  /outputs/mapping/ <渠道名> / <编译类型> /.. 
 
   
 
   

 复制代码

如图所示：

gradle.png

下面大概说明下：

• dump.txt ：描述APK文件中全部类的内部结构
• mapping.txt ：提供混淆先后类、方法、类成员等的对照表
• seeds.txt：列出没有被混淆的类和成员
• usage.txt： 列出被移除的代码

咱们能够根据 seeds.txt 文件检查未被混淆的类和成员中是否已包含全部指望保留的，再根据 usage.txt 文件查看是否有被误移除的代码。建议读者都试下去查看下，必须有收获~

4、自定义混淆规则

(一) proguard 参数

• include {filename} 从给定的文件中读取配置参数

• basedirectory {directoryname} 指定基础目录为之后相对的档案名称

• injars {class_path} 指定要处理的应用程序jar,war,ear和目录

• outjars {class_path} 指定处理完后要输出的jar,war,ear和目录的名称

• libraryjars {classpath} 指定要处理的应用程序jar,war,ear和目录所须要的程序库文件

• dontskipnonpubliclibraryclasses 指定不去忽略非公共的库类。

• dontskipnonpubliclibraryclassmembers 不跳过非公共的库的类成员

上面部分参数，平常移动开发的应用混淆中也不是常用到的，若是读者想进一步深刻了解每一个参数实际做用，能够去官网进行查阅，这里笔者不作太多说明哈。

######（二）keep 参数

• keep {Modifier（属性，例如public，如下说明一致）} {class_specification(具体类或者成员的位置，如下说明一致)} 防止类和成员被移除或者被重命名

• keepclassmembers {modifier} {class_specification} 防止成员被移除或者被重命名

• keepnames {class_specification} 防止成员被重命名）

• keepclassmembernames {class_specification} 防止拥有该成员的类和成员被移除或者被重命名

• keepclasseswithmembernames {class_specification} 防止拥有该成员的类和成员被重命名

（三）混淆的必须知道的一些规则

一、通常规则形式：

[命令] [类] {
    [成员] 
}复制代码

类：表明相关指定条件的类，例如

• 具体的类
• 访问修饰符（public、protected、private）
• 通配符*，匹配任意长度字符，但不含包名分隔符(.)
• 通配符**，匹配任意长度字符，而且包含包名分隔符(.)
• extends，便可以指定类的基类
• implement，匹配实现了某接口的类
• $，内部类

成员：表明指定类后符合指定条件的成员变量，例如

• 匹配全部构造器
• 匹配全部域
• 匹配全部方法
• 通配符*，匹配任意长度字符，但不含包名分隔符(.)
• 通配符**，匹配任意长度字符，而且包含包名分隔符(.)
• 通配符***，匹配任意参数类型
• …，匹配任意长度的任意类型参数。好比void test(…)就能匹配任意 void test(String a) 或者是 void test(int a, String b) 这些方法。
• 访问修饰符（public、protected、private）

举个例子，假如须要将name.huihui.test包下全部继承Activity的public类及其构造函数都保持住，能够这样写：

-keep public class name.huihui.test.** extends Android.app.Activity {
    
  
  
  

 
  
  } 

 复制代码

二、经常使用自定义混淆规则

• 不混淆某个类

-keep public class name.huihui.example.Test { *; }复制代码

• 不混淆某个包全部的类

-keep class name.huihui.test.** { *; }复制代码

• 不混淆某个类的子类

-keep public class * extends name.huihui.example.Test { *; }复制代码

• 不混淆全部类名中包含了“model”的类及其成员

-keep public class **.*model*.** {*;}复制代码

• 不混淆某个接口的实现

-keep class * implements name.huihui.example.TestInterface { *; }复制代码

• 不混淆某个类的构造方法

-keepclassmembers class name.huihui.example.Test { 
  public 
  
  
  

 
  
  (); } 

 复制代码

• 不混淆某个类的特定的方法

-keepclassmembers class name.huihui.example.Test { 
  public void test(java.lang.String); 
}复制代码

5、自定义资源保持规则

前面说的经过shrinkResources true开启资源压缩后，未被使用的资源默认不会被打包进去。若是开发者是自定义保留指定的资源文件，能够在res/raw/ 路径下建立一个 xml 文件，例如 keep.xml，进行自定义混淆规则。

通常属性有：

• tools:keep 定义哪些资源须要被保留（资源之间用“,”隔开）
• tools:discard 定义哪些资源须要被移除（资源之间用“,”隔开）
• tools:shrinkMode 开启严格模式

例如：

 

  
  
  

 复制代码

最后感谢@ 光源coder提供的混淆手册，总结的不错~

但愿对有些开发者有帮助~具体查看能够github上的demo，也欢迎加入开发交流群哈，详情看我的简介。下一篇是对gradle的混淆说明，欢迎读者阅读~

DEMO

Gradle For Android（四）Gradle编译中神秘的混淆

傻小孩b mark共勉，写给在成长路上奋斗的你