I have recently published my libGDX game Rainbow Diamonds for desktop computers. One problem I had was how to obfuscate the desktop JAR file for distribution, and this is how I solved it.<\/p>\n\n\n\n
I’m using openjdk 11.0.13<\/em> distributed as part of Android Studio.<\/p>\n\n\n\n After a few searches on internet, I found this post on esotericsoftware.com<\/a>. Please, check it out as that is the base solution for my custom one.<\/p>\n\n\n As the solution is based on ProGuard, we need a file to specify how we want to trafsform our code. I use a file named proguard-desktop.txt<\/strong><\/em>, placed in the desktop\/<\/strong><\/em> project folder with the following content:<\/p>\n\n\n\n Note:<\/strong> The previous file can vary depending on your project needs.<\/em><\/p>\n\n\n Then, we will a create a ProGuard task to obfuscate the code. Let’s declare it in \/desktop\/build.gradle<\/em><\/strong> (note that is the gradle file of the Desktop project). After the dist<\/em> task, we insert our new one:<\/p>\n\n\n\n The declared task has three main sections: From the official doc<\/a>, I extract the following information about this param:<\/p>\n …The specified library jars should at least contain the class files that are extended<\/em> by application class files. … This means that you explicitly have to specify the run-time jar that your code will use …<\/p>\n<\/blockquote>\n So we need to provide the classes our project classes are extending from. So, for an standard project, we need to provide at least the base Java classes (java.lang.Object, lava.lang.String, etc.). If you are using Java 8 or older versions, this classes are distributed in JAR files within the JRE. So you can use something like this:<\/p>\n\n\n But if you are using a newer Java version (like me), you no longer have those JARs in your JRE, as from Java 9 these classes are distributed in a Java module file. This file is located at First, I recommend to make the following steps with a copy of the modules file. If you damage the original modules file probably you will get an unusable JRE.<\/p>\n\n\n\n After the classes extraction we have all the classes of the modules<\/em> file in the temp\/<\/em> folder. The problem now is that the folder structure we have is not directly packajable in a JAR file, as all of the classes are classified in a first folder with the module name they bellong.<\/p>\n\n\n\n For example, suppossing we are in the temp\/<\/em> folder, the So now we need to put all the classes of the different modules in a common folder structure. Basically if we have something like this in the temp\/ folder right now:<\/p>\n\n\n\n we need to remove the first level of folders, having a final file structure like this:<\/p>\n\n\n\n If you like, I have created a script to make all this tedious work. You can find it here<\/a>.<\/p>\n\n\n\n Inside the temp\/<\/strong><\/em> folder, we can execute the following command to package all the classes in a new JAR file.<\/p>\n\n\n\n And now we have the JAR file with the required classes to be used to obfuscate our code.<\/p>\n\n\n\n <\/p>\n\n\n\n This a very long tutorial about how I solved the original question (How to obfuscate my libGDX JAR for desktop distribution?<\/em>). Probably this is not the only one option, and I don’t know if it is definetly the right way of solve this. But at least it’s a working solution and I hope it is a little bit easy for you if you have the same problem and don’t know exactly how to continue.<\/p>\n\n\n\n Thanks for reading this and good luck for your projects!<\/p>\n","protected":false},"excerpt":{"rendered":" I have recently published my libGDX game Rainbow Diamonds for desktop computers. One problem I had was how to obfuscate the desktop JAR file for distribution, and this is how I solved it. I’m using openjdk 11.0.13 distributed as part Seguir leyendo libGDX + ProGuard: How to obfuscate the Desktop JAR file<\/span>ProGuard rules<\/h3>\n\n\n
-verbose\n-dontusemixedcaseclassnames\n-dontskipnonpubliclibraryclasses\n-keepattributes Signature,InnerClasses,SourceFile,LineNumberTable\n\n-dontwarn com.badlogic.**\n-dontwarn org.lwjgl.**\n-dontwarn org.objectweb.**\n\n-keep class com.badlogic.**\n-keep class org.lwjgl.**\n-keep class org.objectweb.**\n\n-keepclassmembers class com.badlogic.** { *; }\n-keepclassmembers class org.lwjgl.** { *; }\n-keepclassmembers class org.objectweb.** { *; }\n\n-keepclasseswithmembernames class * {\n native <methods>;\n}\n\n-keep public class your.game.package.name.desktop.DesktopLauncher {\n public static void main(java.lang.String[]);\n}\n\n-keepclassmembers,allowoptimization enum * {\n public static **[] values();\n public static ** valueOf(java.lang.String);\n}\n<\/code><\/pre>\n\n\n\nProGuard gradle task<\/h3>\n\n\n
task obfuscate(dependsOn: dist, type: proguard.gradle.ProGuardTask) {\n\n \/\/ Files\n def inputFile = dist.outputs.files.singleFile.path\n def outputJar = dist.destinationDirectory.file(<your_desired_jar_name.jar>)\n def outputJarFilePath = outputJar.get().asFile.path\n\n \/\/ Task configuration\n configuration files(\"proguard-desktop.txt\")\n libraryjars(<jar_with_base_classes>)\n injars files(inputFile)\n outjars files(outputJarFilePath)\n}<\/code><\/pre>\n\n\n\n
<\/p>\n\n\n\n\n
We indicate the task type and dependency, as this task requires the build from the dist<\/em> task. <\/li>\n\n\n\n
We use the output from the dist<\/em> task as the input for our (obfuscate<\/em>) task. This way we will create a new obfuscated jar (place the desired name in <your_desired_jar_name.jar><\/code>) in the same folder as the dist<\/em> did.<\/li>\n\n\n\n
We use the options configuration<\/code>, libraryjars<\/code>, injars<\/code> and outjars<\/code>. You can see all the available options on its reference page<\/a>.<\/li>\n<\/ul>\n\n\nTask configuration<\/h4>\n
\n
We use the file proguard-desktop.txt<\/em> we created in the first step of this guide.<\/li>\n
The input of the task is the output JAR from the dist<\/em> task.<\/li>\n
This is the obfuscated JAR the task will create.<\/li>\n
This param can be confused, so I will try to explain it in the next section.<\/li>\n<\/ul>\n <\/h3>\n
libraryjars<\/h3>\n
\n
libraryjars files(\"<path_to_your_jre>\/lib\/rt.jar\", \"<path_to_your_jre>\/lib\/jce.jar\")<\/code><\/pre>\n\n\n\n<JRE_LOCATION>\/lib\/modules<\/code>. Well, My first try was trying to directly use that file path as libraryjars<\/em> param, but at least for me it didn’t work. So I decided to create a JAR with the classes stored in \/lib\/modules<\/em> file.<\/p>\n\n\n\nCreating the modules JAR<\/h3>\n\n\n\n
Copying the modules file<\/h4>\n\n\n\n
mkdir MODULES_JAR\ncp <JRE>\/lib\/modules MODULES_JAR\ncd MODULES_JAR<\/code><\/pre>\n\n\n\nExtracting the classes<\/h4>\n\n\n\n
jimage extract --dir=temp modules\ncd temp<\/code><\/pre>\n\n\n\nPreparing the JAR classes<\/h4>\n\n\n\n
java.lang.Object<\/code> class is located in java.base\/<\/strong>java\/lang\/Object.class<\/em>, but it should be just in java\/lang\/Object.class<\/em>, as said its package declaration.<\/p>\n\n\n\ntemp\/\n |- java.base\/\n | |- java\/\n | |- lang\/\n | |- Object.class\n | |- String.class\n | |- ...\n |- java.logging\/\n | |- java\/\n | |- util\/\n | |- logging\/\n | |- ConsoleHandler.class\n | |- ...\n |- ...<\/code><\/pre>\n\n\n\ntemp\/\n |- java\/\n | |- lang\/\n | |- Object.class\n | |- String.class\n | |- ...\n \n |- java\/\n | |- util\/\n | |- logging\/\n | |- ConsoleHandler.class\n | |- ...\n |- ...<\/code><\/pre>\n\n\n\nPackaging the classes<\/h4>\n\n\n\n
jar --create --file=..\/modulesclasses.jar . <\/code><\/pre>\n\n\n\nFinal ProGuard task<\/h3>\n\n\n\n
task obfuscate(dependsOn: dist, type: proguard.gradle.ProGuardTask) {\n\n \/\/ Files\n def inputFile = dist.outputs.files.singleFile.path\n def outputJar = dist.destinationDirectory.file(<your_desired_jar_name.jar>)\n def outputJarFilePath = outputJar.get().asFile.path\n\n \/\/ Task configuration\n configuration files(\"proguard-desktop.txt\")\n libraryjars(<your_path>\/MODULES_JAR\/modulesclasses.jar)\n injars files(inputFile)\n outjars files(outputJarFilePath)\n}<\/code><\/pre>\n\n\n\nFinal comments<\/h2>\n\n\n\n