Android分享：代码混淆那些事

1) 前言

  ProGuard是一个开源的Java代码混淆器。它能够混淆Android项目里面的java代码，对的，你没看错，仅仅是java代码。它是没法混淆Native代码，资源文件drawable、xml等。php

2) ProGuard做用

• 压缩: 移除无效的类、属性、方法等html

• 优化: 优化字节码，并删除未使用的结构java

• 混淆: 将类名、属性名、方法名混淆为难以读懂的字母，好比a,b,clinux

3) 混淆注意事项

1. 不能混淆

• 在AndroidManifest中配置的类，好比四大组件android

• JNI调用的方法git

• 反射用到的类github

• WebView中JavaScript调用的方法app

• Layout文件引用到的自定义Viewide

• 一些引入的第三方库（通常都会有混淆说明的）
  这里推荐两个开源项目，里面收集了一些第三方库的混淆规则工具

  • android-proguard-snippets

  • android-proguard-cn

不难理解，混淆以后，类名会变成a,b,c这种，经过包名+类名天然就会找不到该类了，天然就会出现ClassNotFoundException异常。这里推荐一篇文章：
http://www.itnose.net/detail/6043297.html

2. Log处理

咱们都知道，使用Log的时候，须要用到TAG，然而TAG咱们通常都会写成：
private static final String TAG = MainActivity.class.getSimpleName()

这时候MainActivity如何被混淆的话，log输出信息就会变成V/a:xxxxxxx，因此为了让log输出信息维持原状，能够将TAG处理成固定的字符串：
private static final String TAG = "MainActivity"

正好Android Studio里面的Live Templates

能让你轻轻松松的声明TAG

关于Log处理，推荐一篇文章：https://www.zybuluo.com/shark0017/note/163330

3. Crash信息处理

代码混淆的时候记得加上在混淆文件里面记得加上这句：
# keep住源文件以及行号
-keepattributes SourceFile,LineNumberTable

不然你看到的崩溃信息就会变成这样子（图片来自bugly）

这里推荐bugly的一篇文章： http://bugly.qq.com/bbs/forum.php?mod=viewthread&tid=26&extra=page%3D1

4）ProGuard使用

1. 经常使用语法

保留

• -keep {Modifier} {class_specification} 保护指定的类文件和类的成员

• -keepclassmembers {modifier} {class_specification} 保护指定类的成员，若是此类受到保护他们会保护的更好

• -keepclasseswithmembers {class_specification} 保护指定的类和类的成员，但条件是全部指定的类和类成员是要存在。

• -keepnames {class_specification} 保护指定的类和类的成员的名称（若是他们不会压缩步骤中删除）

• -keepclassmembernames {class_specification} 保护指定的类的成员的名称（若是他们不会压缩步骤中删除）

• -keepclasseswithmembernames {class_specification} 保护指定的类和类的成员的名称，若是全部指定的类成员出席（在压缩步骤以后）

• -printseeds {filename} 列出类和类的成员-keep选项的清单，标准输出到给定的文件

压缩

• -dontshrink 不压缩输入的类文件

• -printusage {filename}

• -whyareyoukeeping {class_specification}

优化

• -dontoptimize 不优化输入的类文件

• -assumenosideeffects {class_specification} 优化时假设指定的方法，没有任何反作用

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

混淆

• -dontobfuscate 不混淆输入的类文件

• -obfuscationdictionary {filename} 使用给定文件中的关键字做为要混淆方法的名称

• -overloadaggressively 混淆时应用侵入式重载

• -useuniqueclassmembernames 肯定统一的混淆类的成员名称来增长混淆

• -flattenpackagehierarchy {package_name} 从新包装全部重命名的包并放在给定的单一包中

• -repackageclass {package_name} 从新包装全部重命名的类文件中放在给定的单一包中

• -dontusemixedcaseclassnames 混淆时不会产生形形色色的类名

• -keepattributes {attribute_name,…} 保护给定的可选属性，例如LineNumberTable, LocalVariableTable, SourceFile, Deprecated, Synthetic, Signature, and InnerClasses.

• -renamesourcefileattribute {string} 设置源文件中给定的字符串常量

通配符匹配规则

更详细的语法请戳:http://proguard.sourceforge.net/manual/usage.html#classspecification

2. Android Studio中使用方法

按照上面的语法规则编写proguard-rules.pro后，须要在build.gradle中配置，须要混淆的时候，设置minifyEnabled为true便可

buildTypes {
    debug {
        minifyEnabled false
    }
    release {
        signingConfig signingConfigs.release
        minifyEnabled true
        proguardFiles 'proguard-rules.pro'
    }
}

3. ProGuard的输出文件说明

混淆后，会在/build/proguard/目录下输出下面的文件

• dump.txt 描述apk文件中全部类文件间的内部结构。

• mapping.txt 列出了原始的类，方法，和字段名与混淆后代码之间的映射。

• seeds.txt 列出了未被混淆的类和成员

• usage.txt 列出了从apk中删除的代码
  当咱们须要处理crash log的时候，就能够经过mapping.txt的映射关系找到对应的类，方法，字段等。方法以下：

sdk\tools\proguard\bin 目录下有个retrace工具能够将混淆后的报错堆栈解码成正常的类名
window下为retrace.bat，linux和mac为retrace.sh，

使用方法以下：

1. 将crash log保存为yourfilename.txt

2. 拿到版本发布时生成的mapping.txt

3. 执行命令retrace.bat -verbose mapping.txt yourfilename.txt

  因此咱们每次打包版本都须要保存最新的mapping.txt文件。若是要使用到第三方的crash统计平台，好比bugly，还须要咱们上传APP版本对应的mapping.txt.每次都要保存最新的mapping文件，那不就很麻烦？放心，gradle会帮到你，只须要在bulid.gradle加入下面的一句。每次咱们编译的时候，都会自动帮你保存mapping文件到本地的。

android {
applicationVariants.all { variant ->
        variant.outputs.each { output ->
            if (variant.getBuildType().isMinifyEnabled()) {
                variant.assemble.doLast{
                        copy {
                            from variant.mappingFile
                            into "${projectDir}/mappings"
                            rename { String fileName ->
                                "mapping-${variant.name}.txt"
                            }
                        }
                }
            }
        }
        ......
    }
}

5) 参考

https://blog.gmem.cc/proguard-study-note
http://developer.android.com/intl/zh-cn/tools/help/proguard.html

6) 后话

  打个小广告，推荐下本身的：Android-Dev-Favorites，里面收集了Android开发的干货，而且会不按期更新哦。