native-obfuscator

Java .class 到 .cpp 转换器，用于 JNI

目前仅完全支持 Java 8。Java 9+ 和 Android 支持完全处于实验阶段

警告：建议使用黑名单/白名单，因为这个工具会显著降低代码速度（例如不要混淆完整的 Minecraft .jar）

另外，这个工具并不特别混淆你的代码；它只是将其转译为本地代码。记得使用像 VMProtect、Themida 或 obfuscator-llvm（如果使用 clang）这样的保护器

---

运行此工具，你需要安装以下工具：

1. JDK 8

   • Windows：

     我建议下载 Oracle JDK 8，不过你需要在 Oracle 上有登录凭证。

   • Linux/MacOS：

     搜索"你的发行版安装 jdk 8"，并安装所需的包

2. CMake

   • Windows：

     从 CMake 下载最新版本

   • Linux/MacOS：

     搜索"你的发行版安装 cmake"并安装所需的包（默认 - apt/yum/brew install cmake）

3. C++/C 编译器工具链

   • Windows：

     从 Microsoft 下载 MSVS 的免费版本 并在选项中选择 Visual C++ 编译器

     或者如果你有经验的话安装 mingw。

   • Linux/MacOS：

     搜索"你的发行版安装 g++"

---

一般用法：

用法: native-obfuscator [-ahV] [--debug] [-b=<blackListFile>]
                         [--custom-lib-dir=<customLibraryDirectory>]
                         [-l=<librariesDirectory>] [-p=<platform>]
                         [--plain-lib-name=<libraryName>] [-w=<whiteListFile>]
                         <jarFile> <outputDirectory>
将 .jar 文件转译为 .cpp 文件并生成输出 .jar 文件
      <jarFile>           要转译的 Jar 文件
      <outputDirectory>   输出目录
  -a, --annotations       使用注解来忽略/包含本地混淆
  -b, --black-list=<blackListFile>
                          包含转译黑名单类/方法列表的文件
      --custom-lib-dir=<customLibraryDirectory>
                          LoaderUnpack 的自定义库目录
      --debug             启用生成调试 .jar 文件（不可执行）
  -h, --help              显示此帮助消息并退出。
  -l, --libraries=<librariesDirectory>
                          依赖库的目录
  -p, --platform=<platform>
                          目标平台：hotspot - 标准独立 HotSpot JRE，
                            std_java - 标准 Java，android - 用于 Android 构建（无 DefineClass）
      --plain-lib-name=<libraryName>
                          LoaderPlain 的普通库名称
  -V, --version           打印版本信息并退出。
  -w, --white-list=<whiteListFile>
                          包含转译白名单类/方法列表的文件

参数：

<jarFile> - 要混淆的输入 .jar 文件

<outputDirectory> - 创建 C++/新 .jar 文件的输出目录

-l <librariesDirectory> - 依赖库所在的目录，可选但建议使用

-p <platform> - 运行库的 JVM 平台

有三个选项可用：

• hotspot：将使用 HotSpot JVM 内部结构，应该可以与大多数混淆器一起使用（甚至包括堆栈跟踪检查）
• std_java：只使用所有 JVM 都应该可用的少量 JVM 内部结构
• android：为 Android 构建库时使用此方法。不使用 JVM 内部结构，也不使用 DefineClass 来隐藏方法（依赖堆栈进行字符串/名称混淆的混淆器将无法工作，因为某些方法不会被隐藏）

-a - 启用注解处理

要使用注解将方法/类列入黑名单/白名单作为 native，你可以将以下库添加到你的项目中：

com.github.radioegor146.native-obfuscator:annotations:master-SNAPSHOT

另外，你需要将 JitPack 添加到你的仓库中。

你可以添加 @Native 注解来将类/方法包含在本地混淆过程中，并添加 @NotNative 注解来忽略标记为 @Native 的类中的方法

白名单/黑名单的优先级高于注解。

-w <whiteList> - 如果需要，指向方法和类白名单 .txt 文件的路径

-b <blackList> - 如果需要，指向方法和类黑名单 .txt 文件的路径

它们都应该采用以下形式：

<类>
<类>#<方法名>#<方法描述符>
mypackage/myotherpackage/Class1
mypackage/myotherpackage/Class1#doSomething!()V
mypackage/myotherpackage/Class1$SubClass#doOther!(I)V

它使用类的内部名称和方法描述符进行过滤（你可以通过搜索"java 内部类名称"或"java 方法描述符"了解更多信息）

此外，你可以使用通配符匹配器，如：

mypackage/myotherpackage/*
mypackage/myotherpackagewithnested/**
mypackage/myotherpackage/*/Class1
mypackage/myotherpackagewithnested/**/Class1
mypackage/myotherpackage/Class*

* 匹配类/包名中的单个条目（由 / 分隔）

** 匹配类/包名中的所有条目

--plain-lib-name - 如果你将 .jar 与结果本地库分开发布，或者你将其用于 Android，你可以指定它在使用时将尝试搜索的本地库的名称。

--custom-lib-dir - 如果你想在 jar 内设置自定义目录来存储库

如果你想将你的 .jar 与本地库一起发布，你应该省略该参数，并在构建本地文件后，以以下形式添加它们

x64-windows.dll
x64-linux.so
x86-windows.dll
x64-macos.dylib
arm64-linux.so
arm64-windows.dll

到此工具将在 stdout 中打印的 .jar 文件目录（默认为 native0/ 或自定义，如果存在 --custom-lib-dir）

基本用法：

1. 使用 java -jar native-obfuscator.jar <输入 jar> <输出目录> 转译你的代码
2. 在生成的 cpp 目录中运行 cmake .
3. 如有必要，对 .cpp 代码进行修改
4. 在生成的 cpp 目录中运行 cmake --build . --config Release 来构建 .so/.dll 文件
5. 将 build/libs/ 中的生成的 .dll/.so 复制到上一段中指定的路径。
6. 运行创建的 .jar java -jar <输出 jar> 并享受成果！

---

自行构建工具

1. 运行 gradlew assemble 强制 gradle 在构建后不运行测试

---

测试

你需要将 Krakatau 安装到你的 PATH 中，因为测试套件在某些测试中使用 krak2

1. 运行 gradlew build 来组装并运行完整的测试套件

此工具使用来自 huzpsb/JavaObfuscatorTest 的测试

---

如果遇到任何问题，请随时打开一个 issue 或在 re146.dev 联系我

随时间变化的 Stargazers