unidbg

Allows you to emulate an Android ARM32 and/or ARM64 native library, and an experimental iOS ARM32 emulation.

This is an educational project to learn more about the ELF file format and ARM assembly.

License

• unidbg uses software libraries from Apache Software Foundation.
• unidbg developers Idea enterprise licenses are supported by Jetbrains.
• IntelliJ IDEA can be used to edit unidbg sources.
• 

Usage

VM options: -Djava.library.path=prebuilt/os -Djna.library.path=prebuilt/os
Where os may: linux64, win32, win64, osx64

Simple tests under src/test directory

• src/test/java/com/bytedance/frameworks/core/encrypt/TTEncrypt.java

---

• src/test/java/com/sun/jna/JniDispatch32.java
  

---

• src/test/java/com/sun/jna/JniDispatch64.java
  

---

• src/test/java/org/telegram/messenger/Utilities32.java
  

---

• src/test/java/org/telegram/messenger/Utilities64.java
  

More tests

• src/test/java/com/github/unidbg/android/QDReaderJni.java

Features

• Emulation of the JNI Invocation API so JNI_OnLoad can be called.
• Support JavaVM, JNIEnv.
• Emulation of syscalls instruction.
• Support ARM32 and ARM64 bit ELF.
• Inline hook, thanks to HookZz.
• Import hook, thanks to xHook.
• Support simple debugger, gdb stub, instruction trace, memory read/write trace.

TODO

• Working iOS emulation.
• Add more iOS syscall.

Thanks

• unicorn
• HookZz
• xHook
• AndroidNativeEmu
• usercorn
• keystone
• capstone
• idaemu
• jelf
• whale
• kaitai_struct
• fishhook