Krakatau 提供了 Java 字节码的汇编器和反汇编器,允许你将二进制 class 文件转换为人类可读的文本格式,进行修改,然后再转换回 class 文件,即使对于混淆过的代码也是如此。你还可以通过手动编写字节码从头创建自己的 class 文件,并可以检查和比较 Java 二进制文件的底层细节。与 javap 不同,Krakatau 反汇编器甚至能处理高度混淆的代码,并且反汇编输出可以重新汇编为 class 文件。
Krakatau 还提供了一个反编译器,用于将 Java 二进制文件转换为可读的源代码。与其他反编译器不同,Krakatau 反编译器专门为处理混淆代码而设计,可以轻松应对那些会破坏其他反编译器的技巧。然而,Krakatau 反编译器不支持某些 Java 8+ 特性(如 lambda),因此它在较旧的代码上效果最佳。
Krakatau 的汇编器语法主要是 Jasmin 语法的超集,存在一些轻微的不兼容之处,但与 Jasmin 不同,Krakatau 完全支持 Java 27 字节码规范,甚至支持旧版本 JVM 中发现的一些未记录的特性。有关汇编器语法的概述,请参阅教程或完整规范。
首先,你需要安装 Rust 和 Cargo。然后克隆此仓库并运行 cargo build --release。这将在 target/release/krak2 中生成一个二进制文件,你可以直接调用它、将其添加到 PATH、创建符号链接等。
反汇编器有两种模式:默认模式和往返模式。默认模式针对可读性和便于修改生成的汇编文件进行了优化。当输出被重新汇编时,生成的 class 文件从 JVM 规范的角度来看在行为上与原始文件等效,但不一定逐位完全相同(例如,常量池条目可能被重新排序)。往返模式生成的输出在重新汇编后将得到与原始文件逐位完全相同的 class 文件,但这意味着汇编文件保留了底层编码信息,使其更难阅读,例如常量池条目的确切顺序。当处理依赖非标准属性的代码(如 CLDC 代码或 Scala 代码)时,建议使用往返模式。
示例用法:
krak2 dis --out temp RecordTest.class
krak2 dis --out disassembled.zip --roundtrip r0lling-challenge.jar
你可以反汇编单个 class 文件或整个 jar 文件。如果输入文件名以 .jar 或 .zip 结尾,它将被视为 jar 文件,jar 内的每个 .class 文件都将被反汇编。
--out 选项控制输出位置。如果 --out 的值是一个目录,输出将放置在该目录下的各个文件中。否则,如果 --out 的值以 .jar 或 .zip 结尾,输出将放置在该位置的单个 zip 文件中。如果 --out 的值以 .j 结尾,输出将写入该文件(注意,单个 .j 文件可以包含多个类——所有类都将被反汇编并按顺序写入同一个文件)。如果完全省略 --out 选项,反汇编后的类将写入标准输出。
要如上所述以往返模式进行反汇编,请传递 --roundtrip 选项(或简写 -r)。
Krakatau 汇编器允许你以人类友好的基于文本的格式编写 Java 字节码,并将其转换为二进制 Java class 文件。
krak2 asm --out temp Krakatau/tests/data/asm/good/strictfp.j
你可以汇编单个 .j 文件或整个 jar 文件。如果输入文件名以 .jar 或 .zip 结尾,它将被视为 zip 归档文件,其中的每个 .j 文件都将被汇编。
--out 选项控制输出位置。如果 --out 的值是一个目录,输出将放置在该目录下的各个文件中。否则,如果 --out 的值以 .jar 或 .zip 结尾,输出将放置在该位置的一个 zipfile 中。如果 --out 的值以 .class 结尾,单个输出 classfile 将写入该文件(如果输入包含多个类,在这种情况下会报错。)
v2 反编译器仍在开发中。目前进行反编译需要使用 Krakatau v1。
当前版本的 Krakatau 采用 MIT 或 Apache 2 许可证(由你选择)。Krakatau v1 以及截至提交 baa5534ab29dbfb7b62018bed897f52073974f2f 的 v2 版本则采用 GPL3 或更高版本许可证。