Java代码混淆工具ProGuard

Java代码混淆工具ProGuard

由于Java 代码的 class类很容易被反编译，为了保证知识产权有时候需要将代码进行混淆。而ProGuard就提供了混淆Java代码的方法。

简介

描述

ProGuard是Java字节码最受欢迎的优化程序。它能够让Java代码变小90%变快20%。ProGuard通过混淆类名、属性、方法来提供对代码的保护，一次对抗反编译工程。

作用的环境

桌面应用
嵌入式应用
手机应用

功能

当你安装好一个windows桌面版的ProGuard之后，面板上会提示你设置压缩（Shrink）、优化（Optimize） 、混淆（Obfuscate）、预检（Preverify）。

压缩：会检测递归地确定哪些class被使用。所有起的类和方法将会被删除
优化：将非入口的方法、类设置为私有、静态或者不可更改的，没有使用的变量删除一些方法会被横线划掉。
混淆：将那些不是入口点的类、方法重命名。在整个过程中保证入口点确保他们始终能够被原有的名字访问到。
预检：对处理后的代码进行预检，确保加载的class文件是可执行的

工作原理

注：图片来源于官网

Java代码混淆工具ProGuard

下载

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进入到桌面应用

使用时注意事项

注：下面是碰见的问题

版本问题

一定要使用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>

注：

一定要使用6.0以上的版本，否则不支持Java9
我测试的时候使用的springboot项目，需要将proguard 插件的位置放在Spring Boot 插件的前面否则会失败。该问题是我记录的问题，写本文的时候又尝试了一下，前后都没有问题。仅供有问题的人参考一下。

参数说明

injar:输入文件，可以是[jar][war][folder][aar][ear][zip][apk],我injar是target下的class目录

outjar:导出文件，以上的都可以是导出一个jar

proguardInclude:配置文件位置,配置文件中的配置都可以在pom.xml中用标签的方式写，太乱不建议

libs:使用到的java类库。rt.jar是必须的，我看网上都是dt.jar。官网目前介绍的是rt.jar

注：这里声明一个问题。我在使用 war to war 的过程中一直报栈溢出的错误，我在本地更换64位的jdk之后不会报这个错误，但是一直在执行很长时间没有停止，不知道原因。

配置文件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.*  {*;}

注：几点注意，关闭压缩、关闭优化、关闭预检，否则会出现问题。混淆是不生产大小写混合名称，否则会产生歧义。关闭warning 否则不让通过。

配置文件的详细介绍

官网地址 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路径，测试成功

附一张桌面版的截图

Java代码混淆工具ProGuard