鸿蒙代码配置混淆

目录：

1、前言

2、ProGuard

3、混淆指令

4、给鸿蒙项目配置混淆

5、给出一个常见的混淆配置

6、总结

一、前言

Java代码会被编译成字节码，字节码非常容易被反编译，一旦字节码被反编译，源码也就泄露了。为了很好的保护源代码，需要对编译好后的字节码文件进行混淆。代码经过混淆后，包体积会变小，并且源码都被处理过，进一步保障了应用的安全。本文将首先介绍混淆原理以及混淆命令，然后教大家如何在鸿蒙项目里面配置混淆。

二、ProGuard

ProGuard就是用来混淆代码的，主要有以下4个功能。

• 压缩(Shrink)：检测并移除代码中无用的类、字段、方法和特性。可以使用下面的指令关闭压缩

# 关闭压缩 -dontshrink 

• 优化(Optimize)：对字节码进行优化，移除无用的指令。可以使用下面的指令关闭优化

# 关闭优化 -dontoptimize -optimizationpasses n 表示proguard对代码进行迭代优化的次数 

• 混淆(Obfuscate)：使用a，b，c，d这样简短而无意义的名称，对类、字段和方法进行重命名。可以使用下面的指令关闭混淆

# 关闭混淆 -dontobfuscate 

• 预检(Preveirfy)：在Java平台上对处理后的代码进行预检，确保加载的字节码文件是可执行的。
• 总之，Proguard是一个Java类文件压缩器、优化器、混淆器、预校验器。压缩环节会检测以及移除没有用到的类、字段、方法以及属性。优化环节会分析以及优化方法的字节码。混淆环节会用无意义的短变量去重命名类、变量、方法。这些步骤让代码更精简，更高效，也更难被逆向（破解）。
• 那么有一个问题，ProGuard怎么知道这个代码没有被用到呢？这里引入一个Entry Point（入口点）概念，Entry Point表示在混淆过程中不会被处理的类或方法。在压缩的步骤中，ProGuard会从上述的Entry Point开始递归遍历，搜索哪些类和类的成员在使用，对于没有被使用的类和类的成员，就会在压缩段丢弃，在接下来的优化过程中，那些非Entry Point的类、方法都会被设置为private、static或final，不使用的参数会被移除，此外，有些方法会被标记为内联的，在混淆的步骤中，ProGuard会对非Entry Point的类和方法进行重命名。
• 一般来说，开启混淆后，代码越乱越无规律越好，但有些代码是不能被混淆的，否则程序运行就会出错，所以就需要我们熟悉混淆指令，当开启混淆的时候，使用混淆指令告诉编译器某些代码不能被混淆。

三、混淆指令

3、1 先看如下如下的命令，一个星号表示只是保持该包下的类名，而子包下的类名还是会被混淆。

-keep class com.poetry.jianjia.bean.* 

3、2 两个星号表示把本包和所含子包下的类名都保持。

-keep class com.poetry.jianjia.bean.** 

3、3 用以上方法保持类后，虽然类名未混淆，但类里面的方法和变量命名还是会变，如果既想保持类名，又想保持里面的内容不被混淆，就需要加上{*;}

-keep class com.poetry.jianjia.bean.**{*;} 

3、4 在此基础上，还可以使用extends、implements等关键字来保护特定类不被混淆，如下例子表示实现Serializable接口的类名不被混淆

-keep class * implements java.io.Serializable 

3、5 如果想保留内部类不被混淆则需要用$符号，如下例子MainAbilitySlice内部类InnerClass中的所有public内容不被混淆。

-keepclassmembers class com.poetry.jianjia.slice.MainAbilitySlice$InnerClass{ public *; } 

3、6 如果只是希望类里面的特定内容不被混淆，就可以使用

<init>; //匹配所有构造方法 <fields>; //匹配所有变量 <methods>; //匹配所有方法 

3、7 可以在<fields>或<methods>前面加上private 、public、native等来进一步指定不被混淆的内容，如下例子，Banner类中所有的共有方法不被混淆。

-keep class com.poetry.jianjia.Banner { public <methods>; } 

3、8 类中可以有重载方法，如果希望某个重载方法不被混淆，可以加上方法参数，如下例子，带有一个字符串参数的构造方法不被混淆

-keep class com.poetry.jianjia.Banner { public <init>(java.lang.String); } 

3、9 有时类名可以被混淆，但是希望该类下的特定方法不被混淆，那就不能用keep了，keep不会混淆类名，而需要用keepclassmembers。如下例子，实现了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(); }

-keepclasseswithmembernames class * { native <methods>; } 

3、11 保持枚举不被混淆

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

3、12 反射用到的类不能被混淆。
3、13 配置文件中的类不能被混淆，配置文件中声明的Ability默认不会被混淆，在配置文件中声明的类不需要额外的配置混淆。
3、14 使用gson、fastjson等框架解析服务端数据时，所写的json对象类不能混淆，否则无法将json解析成对应的对象。
3、15 第三方开源库会大量的使用注解、反射、泛型，使用第三方开源库或者引用其他第三方的SDK包时，如果有特别要求，也需要在混淆文件中加入对应的混淆规则。

四、给鸿蒙项目配置混淆

4、1 我们已经熟悉了混淆指令，那如何给鸿蒙项目配置混淆呢？在最新版的编译器里面创建项目，编译器会帮我们创建一个proguard-rules.pro文件，proguard-rules.pro文件是什么呢？鸿蒙使用proguard进行混淆，proguard-rules.pro文件就是用来配置混淆规则的，将不能被混淆的代码配置在proguard-rules.pro文件中。请注意，老版本的编译器不支持混淆，使用老版本的编译器创建项目，编译器不会创建proguard-rules.pro文件。

4、2 编译器除了帮我们创建proguard-rules.pro文件外，还在build.gradle文件中添加了新代码，打开build.gradle文件

编译器在buildTypes闭包里面添加release闭包，release表示正式包。release闭包下面又有一个proguardOpt闭包，proguardOpt就是用来配置混淆的。proguardEnabled表示是否开启混淆，true表示开始混淆，false表示不开启混淆。rulesFiles则表示配置混淆的规则文件。
可以看出，默认情况下，是不开启混淆的，出于保护源码的原因，当我们打正式包的时候，是需要开启混淆的。其实，我们也可以给测试包配置混淆，如下代码。我们手动添加了一个debug闭包，debug表示测试包，不要在测试包里面开启混淆，当你在测试包开启混淆，断点调试的时候将看不到变量的值。

buildTypes { // release表示正式包 release { // 配置混淆 proguardOpt { // 正式包开启混淆 proguardEnabled true // 混淆规则配置在proguard-rules.pro文件中 rulesFiles 'proguard-rules.pro' } } // debug表示测试包 debug { // 配置混淆 proguardOpt { // 测试包不开启混淆 proguardEnabled false // 混淆规则配置在proguard-rules.pro文件中 rulesFiles 'proguard-rules.pro' } } } 

4、3 如果使用最新版编译器打开老版本编译器创建的项目，那么项目中不会有proguard-rules.pro文件，同时build.gradle文件中也不会有proguardOpt。这时就需要我们自己手动创建proguard-rules.pro文件，并且在build.gradle文件添加上述代码。
4、4 综上，如何给鸿蒙项目配置混淆？只需两步，第一，将proguardEnabled 设置为true，第二，在proguard-rules.pro文件中使用混淆指令配置混淆规则。

五、给出一个常见的混淆配置

# 代码混淆压缩比，在0~7之间 -optimizationpasses 5 # 混合时不使用大小写混合，混合后的类名为小写 -dontusemixedcaseclassnames # 指定不去忽略非公共库的类 -dontskipnonpubliclibraryclasses # 不做预校验，preverify是proguard的四个步骤之一，去掉这一步能够加快混淆速度。 -dontpreverify -verbose # 避免混淆泛型 -keepattributes Signature #google推荐算法 -optimizations !code/simplification/arithmetic,!code/simplification/cast,!field/*,!class/merging/* # 保留注解、内部类、泛型、匿名类 -keepattributes *Annotation*,InnerClasses,Signature,EnclosingMethod # 重命名抛出异常时的文件名称 -renamesourcefileattribute SourceFile # 抛出异常时保留代码行号 -keepattributes SourceFile,LineNumberTable -dontwarn javax.annotation.** # 保留本地native方法不被混淆 -keepclasseswithmembernames class * { native <methods>; } # 保留枚举类不被混淆 -keepclassmembers enum * { public static **[] values(); public static ** valueOf(java.lang.String); } -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(); } # OkHttp3 -dontwarn okhttp3.logging.** -keep class okhttp3.internal.**{*;} -dontwarn okio.** # gson -keep class sun.misc.Unsafe { *; } -keep class com.google.gson.stream.** { *; } # 在我的示例代码中，com.poetry.jianjia.bean这个包下面的类实现了Serialized接口， # 实现了Serialized接口的类不能被混淆，请把com.poetry.jianjia.bean这个包名替换成你自己的包名 -keep class com.poetry.jianjia.bean.**{*;} 

六、总结

本文主要介绍混淆原理以及混淆命令，并且教大家如何在鸿蒙项目里面配置混淆，大家最好熟悉下混淆指令。在实际开发中，经常性的会遇到这种问题，在测试包里面没有问题，但在正式包里面就出现了问题，这种情况往往是因为在正式包开启了混淆，但没有在proguard-rules.pro文件中配置混淆规则。

作者：裴云飞1
想了解更多内容，请访问51CTO和华为合作共建的鸿蒙社区：https://harmonyos.51cto.com