DEXrs

Important

Branch v2-rewrite contains a complete rewrite of this library including a Python binding. Installation is as follows:

Crate:

# add to project
cargo add --git https://github.com/MatrixEditor/dexrs --branch dev/v2-rewrite
# install lib
cargo install --git https://github.com/MatrixEditor/dexrs --branch dev/v2-rewrite

Python Binding

pip install -v git+https://github.com/MatrixEditor/dexrs@dev/v2-rewrite

DEXrs is an exploratory project in Rust aimed at developing a decompiler for Android executable files (DEX files).

What this project already covers:

A (blazingly fast) DEX file parser using lazy parsing
A simple disassembler for Dalvik byte code
A simplistic Smali decompiler

Roadmap

Basic Java decompiler
Bytecode modification and DEX rebuild

Installation

Install DEXrs using Cargo:

cargo install --git https://github.com/MatrixEditor/dexrs dexrs

Usage

Disassembling DEX files

Here’s a quick example of how to disassemble a DEX file:

let mut f = File::open("classes.dex").expect("file not found");
// parse DEX input and verify its contents
let mut dex = Dex::read(&mut f, true)?;

let class = dex.get_class_def(0)?;
if let Some(method) = class.get_direct_method(0) {
    for insn in method.disasm(&mut dex)? {
        println!("    {:#06x}: {:?}", insn.range.start, insn);
    }
}

Decompilation to Smali

use dexrs::smali::SmaliWrite;

let mut f = File::open("classes.dex").expect("file not found");
let mut dex = Dex::read(&mut f, true)?;

let class = dex.get_class_def(0)?;
let mut stdout = std::io::stdout();
stdout.write_class(&class, &mut dex)?;

License

This project is licensed under the MIT license

License

MatrixEditor/dexrs

ErrorLooks like something went wrong!

About

Topics

Resources

License

Uh oh!

Stars

Watchers

Forks

Releases

Uh oh!

Languages

Error
Looks like something went wrong!