
Java-Decompiler, Assembler und Disassembler
Krakatau bietet einen Assembler und Disassembler für Java-Bytecode, mit dem du Binär-Classfiles in ein menschenlesbares Textformat umwandeln, Änderungen vornehmen und sie wieder in ein Classfile zurückverwandeln kannst – selbst bei obfuskiertem Code. Du kannst auch eigene Classfiles von Grund auf erstellen, indem du Bytecode manuell schreibst, und Low-Level-Details von Java-Binaries untersuchen und vergleichen. Anders als javap kann der Krakatau-Disassembler selbst stark obfuskierten Code verarbeiten, und die disassemblierte Ausgabe kann wieder zu einem Classfile reassembliert werden.
Krakatau bietet außerdem einen Decompiler zur Umwandlung von Java-Binaries in lesbaren Quellcode. Anders als andere Decompiler wurde der Krakatau-Decompiler speziell für die Arbeit mit obfuskiertem Code entwickelt und kann Tricks problemlos bewältigen, die andere Decompiler scheitern lassen. Allerdings unterstützt der Krakatau-Decompiler einige Java-8+-Funktionen wie Lambdas nicht, sodass er am besten mit älterem Code funktioniert.
Die Assembler-Syntax von Krakatau ist größtenteils eine Obermenge der Jasmin-Syntax mit einigen kleineren Inkompatibilitäten, aber anders als Jasmin bietet Krakatau vollständige Unterstützung für die Java-27-Bytecode-Spezifikation und unterstützt sogar einige undokumentierte Funktionen, die in alten Versionen der JVM zu finden sind. Einen Überblick über die Assembler-Syntax findest du im Tutorial oder in der vollständigen Spezifikation.
Zuerst musst du Rust und Cargo installieren. Klone dann dieses Repo und führe cargo build --release aus. Dadurch entsteht eine Binärdatei unter target/release/krak2, die du direkt aufrufen, zum PATH hinzufügen, per Symlink verknüpfen usw. kannst.
Der Disassembler hat zwei Modi: Standard und Roundtrip. Der Standardmodus ist auf Lesbarkeit und einfache Modifizierbarkeit der resultierenden Assembly-Dateien optimiert. Wenn die Ausgabe reassembliert wird, ergeben sich Classfiles, die aus Sicht der JVM-Spezifikation im Verhalten zum Original äquivalent sind, aber nicht unbedingt bitgenau identisch (beispielsweise können die Constant-Pool-Einträge neu geordnet werden). Der Roundtrip-Modus erzeugt eine Ausgabe, die zu Classfiles reassembliert wird, die bitgenau mit dem Original identisch sind, was jedoch bedeutet, dass die Assembly-Dateien Low-Level-Kodierungsinformationen bewahren, die sie schwerer lesbar machen, etwa die exakte Reihenfolge der Constant-Pool-Einträge. Es wird empfohlen, den Roundtrip-Modus zu verwenden, wenn du mit Code arbeitest, der auf nicht standardkonforme Attribute angewiesen ist, wie CLDC-Code oder Scala-Code.
Beispielverwendung:
krak2 dis --out temp RecordTest.class
krak2 dis --out disassembled.zip --roundtrip r0lling-challenge.jar
Du kannst entweder ein einzelnes Classfile oder eine gesamte Jar-Datei disassemblieren. Wenn der Eingabedateiname auf .jar oder .zip endet, wird er als Jar-Datei behandelt und jede .class-Datei innerhalb des Jars wird disassembliert.
Die Option --out steuert den Ausgabeort. Wenn der Wert von --out ein Verzeichnis ist, wird die Ausgabe in einzelnen Dateien unter diesem Verzeichnis abgelegt. Andernfalls, wenn der Wert von --out auf .jar oder .zip endet, wird die Ausgabe in einer einzelnen Zip-Datei an diesem Ort abgelegt. Wenn der Wert von --out auf .j endet, wird die Ausgabe in diese Datei geschrieben (beachte, dass eine einzelne .j-Datei mehrere Klassen enthalten kann – alle Klassen werden disassembliert und nacheinander in dieselbe Datei geschrieben). Wenn die Option --out vollständig weggelassen wird, werden die disassemblierten Klassen auf die Standardausgabe geschrieben.
Um im oben beschriebenen Roundtrip-Modus zu disassemblieren, übergib die Option --roundtrip (oder kurz -r).
Der Krakatau-Assembler ermöglicht es dir, Java-Bytecode in einem benutzerfreundlichen textbasierten Format zu schreiben und in binäre Java-Classfiles umzuwandeln.
krak2 asm --out temp Krakatau/tests/data/asm/good/strictfp.j
Du kannst entweder eine einzelne .j-Datei oder eine gesamte Jar-Datei assemblieren. Wenn der Eingabedateiname auf .jar oder .zip endet, wird er als Zip-Archiv behandelt und jede .j-Datei darin wird assembliert.
Die Option --out steuert den Ausgabeort. Wenn der Wert von --out ein Verzeichnis ist, wird die Ausgabe in einzelnen Dateien unter diesem Verzeichnis abgelegt. Andernfalls, wenn der Wert von --out auf .jar oder .zip endet, wird die Ausgabe in einer einzelnen Zipdatei an diesem Ort abgelegt. Wenn der Wert von --out auf .class endet, wird die einzelne Ausgabeklassendatei in diese Datei geschrieben (wenn die Eingabe mehrere Klassen enthält, tritt in diesem Fall ein Fehler auf.)
Der v2-Dekompiler befindet sich noch in Arbeit. Für die Dekompilierung müssen Sie derzeit Krakatau v1 verwenden.
Die aktuelle Version von Krakatau ist wahlweise unter der MIT- oder der Apache-2-Lizenz lizenziert. Krakatau v1 und v2 bis einschließlich Commit baa5534ab29dbfb7b62018bed897f52073974f2f waren stattdessen unter GPL3 oder später lizenziert.