[TOC]
Java代码混淆工具ProGuard
由于Java 代码的 class类很容易被反编译，为了保证知识产权有时候需要将代码进行混淆。而ProGuard就提供了混淆Java代码的方法。
简介
描述
ProGuard是Java字节码最受欢迎的优化程序。它能够让Java代码变小90%变快20%。ProGuard通过混淆类名、属性、方法来提供对代码的保护，一次对抗反编译工程。
作用的环境
- 桌面应用
- 嵌入式应用
- 手机应用
功能
当你安装好一个windows桌面版的ProGuard之后，面板上会提示你设置压缩（Shrink）、优化（Optimize） 、混淆（Obfuscate）、预检（Preverify）。
- 压缩：会检测递归地确定哪些class被使用。所有起的类和方法将会被删除
- 优化：将非入口的方法、类设置为私有、静态或者不可更改的，没有使用的变量删除一些方法会被横线划掉。
- 混淆：将那些不是入口点的类、方法重命名。在整个过程中保证入口点确保他们始终能够被原有的名字访问到。
- 预检：对处理后的代码进行预检，确保加载的class文件是可执行的
工作原理
注：图片来源于官网
下载
https://sourceforge.net/projects/proguard/
下载解压后，有多种方式可以运行，以windows下为例
可以运行proguardgui.bat文件运行桌面应用
在lib下找到proguard.jar，通过执行
java -jar proguard.jar @ input
# 注：这个方法未尝试成功，报如下错误
Error: Can't read [C:\Program Files (x86)\Java\jdk1.8.0_172\jre\jmods\java.base.jmod(;;;;;;!**.jar;!module-info.class)] (No such file or directory: C:\Program Files (x86)\Java\jdk1.8.0_172\jre\jmods\java.base.jmod)
- 在lib下找到proguardgui.jar，通过执行
java -jar proguardgui.jar进入到桌面应用
使用时注意事项
<font color="red">注：下面是碰见的问题</font>
版本问题
一定要使用6.0以上的ProGuard 版本，因为不同的ProGuard版本支持不同的Java版本，目前Proguard6.0 支持 Java9。我再调试过程中遇见的问题是
# log4j部分的lib库使用了Java9,一直报错如下。
Can't read [D:\proguardConfig\lib\log4j-api-2.10.0.jar] (Can't process class [META-INF/versions/9/org/apache/logging/log4j/util/ProcessIdUtil.class] (Unsupported class version number [53.0] (maximum 52.0, Java 1.8)))
JDK位数问题
尽量使用64位的JDK，否则可能会出现栈溢出的错误
Exception in thread "main" java.lang.OutOfMemoryError: Java heap space
Java的字节码验证问题
重新混淆后的class类，在使用tomcat启动项目的时候会报，原因是不符合字节码不符合规范
# java7 在JAVA_OPTS中加入
-XX:-UseSplitVerifier
# java8 中上面的选项被移除了使用如下参数
-noverify
# --------------------------
# 增加之后会跳过字节码的验证，当然程序还能够正常运行的，不需要担心
关于使用类似于Hibernate的对象关系映射框架
model类一定不能混淆，包括类名、属性、以及get set方法。使用如下配置可以做到
-keep class test.model.* {*;}
# class test.model.* 保存model包下的所有类名
# {*;} 保存每个类下的所有属性与方法
# 可以不用保留住类名，要保留的最重要的东西是类中定义的mapping
# 关于配置下面还会有介绍
在Maven项目中 使用ProGuard
注：项目使用的是Maven打包的所以最终使用这个当例子，桌面版的也很简单，就是简单通过可视化界面自动生成了配置文件。
引入Proguard 插件
- pom.xml
<plugin>
<groupId>com.github.wvengen</groupId>
<artifactId>proguard-maven-plugin</artifactId>
<executions>
<execution>
<phase>package</phase>
<goals><goal>proguard</goal></goals>
</execution>
</executions>
<configuration>
<proguardVersion>6.1.0beta1</proguardVersion>
<injar>classes</injar>
<outjar>test.jar</outjar>
<obfuscate>true</obfuscate>
<proguardInclude>proguard.conf</proguardInclude>
<libs>
<lib>C:/Program Files (x86)/Java/jdk1.8.0_172/jre/lib/rt.jar</lib>
<lib>C:/Program Files (x86)/Java/jdk1.8.0_172/jre/lib/jce.jar</lib>
</libs>
</configuration>
<dependencies>
<dependency>
<groupId>net.sf.proguard</groupId>
<artifactId>proguard-base</artifactId>
<version>6.1.0beta1</version>
</dependency>
</dependencies>
</plugin>
注：
<font color="red">一定要使用6.0以上的版本，否则不支持Java9</font>
<font color="red">我测试的时候使用的springboot项目，需要将proguard 插件的位置放在Spring Boot 插件的前面否则会失败。该问题是我记录的问题，写本文的时候又尝试了一下，前后都没有问题。仅供有问题的人参考一下。</font>
- 参数说明
injar:输入文件，可以是[jar][war][folder][aar][ear][zip][apk],我injar是target下的class目录
outjar:导出文件，以上的都可以是导出一个jar
proguardInclude:配置文件位置,配置文件中的配置都可以在pom.xml中用标签的方式写，太乱不建议
libs:使用到的java类库。rt.jar是必须的，我看网上都是dt.jar。官网目前介绍的是rt.jar
<font color="red">注：这里声明一个问题。我在使用 war to war 的过程中一直报栈溢出的错误，我在本地更换64位的jdk之后不会报这个错误，但是一直在执行很长时间没有停止，不知道原因。</font>
- 配置文件proguard.conf
-target 1.8 ##指定java版本号
-dontshrink ##默认是开启的，这里关闭shrink，即不删除没有使用的类/成员
-dontoptimize ##默认是开启的，这里关闭字节码级别的优化
-useuniqueclassmembernames ##对于类成员的命名的混淆采取唯一策略
-adaptclassstrings ## 混淆类名之后，对使用Class.forName('className')之类的地方进行相应替代
-dontusemixedcaseclassnames ## 混淆时不生成大小写混合的类名，默认是可以大小写混合
-dontpreverify
-ignorewarnings
-dontskipnonpubliclibraryclasses ## 不加这个会报错Error: Can't find common super class of [java/lang/StringBuffer] and [org/eclipse/swt/internal/win32/TCHAR]
-keep class com.cisco.bgp.model.* {*;}
<font color="red">注：几点注意，关闭压缩、关闭优化、关闭预检，否则会出现问题。混淆是不生产大小写混合名称，否则会产生歧义。关闭warning 否则不让通过。</font>
- 配置文件的详细介绍
官网地址 https://www.guardsquare.com/en/products/proguard/manual/usage#iooptions
- 运行mvn命令
mvn package
#以上是我遇到的一些问题，如果还有问题可以再运行mvn package +X 看看具体的信息进行修改
- 显示结果
[proguard] Preparing output jar [C:\Workflow\BGP\target\test.jar]
[proguard] Copying resources from program directory [C:\Workflow\BGP\target\classes] (filtered)
[INFO] ------------------------------------------------------------------------
[INFO] BUILD SUCCESS
[INFO] ------------------------------------------------------------------------
[INFO] Total time: 14.467 s
[INFO] Finished at: 2019-03-12T10:11:01+08:00
[INFO] ------------------------------------------------------------------------
- 输出文件
如果没有指定injar outjar他会在target目录下生成如下四个文件
gs-rest-service-0.1.0_proguard_base.jar
gs-rest-service-0.1.0.jar.original
proguard_map.txt # 存放混淆前后类、方法的对应关系
proguard_seed.txt # 存放保持不变的类
如果指定injar outjar他会在指定目录下生成如下三个文件
test.jar # 指定的输出文件
proguard_map.txt # 存放混淆前后类、方法的对应关系
proguard_seed.txt # 存放保持不变的类
- 导入war包
由于war to war的过程中一直有问题，我只能讲jar包的里面的类导入到war包中
1. 用解压工作打开混淆后的jar，将混淆后的class类文件夹提取出来
2. 用解压工具打开war包，将war包原有的类文件删除
3. 将提取出的混淆后的class文件夹拖入到war包中
4. 放到tomcat web路径，测试成功
附一张桌面版的截图
