鸿蒙代码配置混淆

目录：

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的类和方法进行重命名。
• 一般来说，开启混淆后，代码越乱越无规律越好，但有些代码是不能被混淆的，否则程序运行就会出错，所以就需要我们熟悉混淆指令，当开启混淆的时候，使用混淆指令告诉编译器某些代码不能被混淆。

三、混淆指令

命令	含义
-keep	防止类和成员被移除或者被重命名
-keepnames	防止类和成员被重命名
-keepclassmembers	防止成员被移除或者被重命名
-keepclasseswithmembernames	防止拥有该成员的类和成员被重命名
-keepclasseswithmembers	防止拥有该成员的类和成员被移除或者被重命名

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

3、10 有些类或者类成员是不能被重命名的，keepclasseswithmembernames会防止类和成员被重命名。如下实例，本地方法不能被重命名。

-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