Skip to content
MG1937Public

About

ASC is a super FAST and lightweight Android decompiler designed for Agents/Mobile Researchers.

Topics

Resources

Stars

2.4k stars

Watchers

7 watching

Forks

Repository files navigation

Droid ASC: R8 Compiler Optimization as a DeCompiler Primitive

https://blackhat.com/europe/arsenal/schedule/index.html#droid-asc-r8-compiler-optimization-as-a-decompiler-primitive-54834

When decompiling massive Android APKs, the standard procedure is to wait. We wait for tools to eat gigabytes of RAM, fully inflate the artifacts, and spend tens of minutes building heavy global indexes and cross references... All of this is just to guarantee fast code searches later, but here is the contradiction. A compiled artifact is already highly structured, modern decompilers never utilize this, they waste massive amounts of time and memory reconstructing a bloated database of code relationships over already structured data. This engineering approach defies common sense. When I can directly extract any code relationship from the APK in milliseconds, does this preprocessing still hold any value?

Instead of forcing decompilers into heavy preprocessing, we choose to query the compiled artifact directly as a database. We built a stateless, zero-overhead engine that extracts and searches code on demand in milliseconds. In this briefing, we will explore the underlying engineering required to bypass traditional bottlenecks. We will demonstrate how to abandon full inflate by probing directly within the Deflate bitstream, building dense Huffman lookup tables to extract core metadata without touching irrelevant data blocks. Furthermore, we will explain optimization details of the R8 compiler, especially how deterministic constant relocation and instruction deduplication leave behind highly concentrated physical layouts, we weaponize this compiler behavior to execute lightning-fast cross DEX code searches. To map these raw bytecode offsets back to methods, we engineered an O(1) instruction locating primitive, achieving constant-time method resolution without building heavy mapping tables. Finally, upon hitting a target, Droid ASC extracts only the specific bytecodes and its dependencies, dynamically reconstructing a minimal and self consistent DEX entirely in memory for instant decompilation.

We will demonstrate this architecture live against a 352MB commercial APK. Droid ASC executes global cross reference searches in 1.79 seconds and decompiles target classes in 177 milliseconds using only 141MB of RAM. By treating the artifact as a read only database and operating with zero preprocessing, we return the decompiler to its core essence. It is no longer a bloated indexing tool, but a lightning fast, on demand decompilation engine that fundamentally redefines how we analyze compiled code.

Benchmark

Benchmark

ASC_Benchmark.mp4

Raw absolute values, measured with 10 threads across four APK targets of increasing size:

Global string xref search

Tool TelegramX (59MB) WhatsApp (130MB) Grab (228MB) Lark (352MB)
ASC 322ms 418ms 806ms 1.597s
JADX 20s 32s 2m14s 8m2s

ASC is 62x to 302x faster than JADX for global string xref search.

Single-class decompile

Tool TelegramX (59MB) WhatsApp (130MB) Grab (228MB) Lark (352MB)
ASC 157ms 141ms 165ms 303ms
JADX 6s 15s 37s 1m32s

ASC is 38x to 304x faster than JADX for single-class decompile.

CLI memory usage

Tool TelegramX (59MB) WhatsApp (130MB) Grab (228MB) Lark (352MB)
ASC 36MB 36MB 58MB 141MB
JADX 1,016MB 2.1GB 7.1GB 13.2GB

ASC uses 28x to 125x less memory than JADX for CLI operation.

Disk cache usage

Tool TelegramX (59MB) WhatsApp (130MB) Grab (228MB) Lark (352MB)
ASC 0MB 0MB 0MB 0MB
JADX 119MB 30MB 127MB 322MB

ASC stays fully in memory with zero disk cache, while JADX writes up to 322MB.

Note: JADX runs out of memory on the largest target (Lark) during the global search (~49% searched), while ASC completes every target.

As the benchmark shows, ASC is 62x faster than JADX on ~50MB APKs, and 302x faster on ~300MB APKs, with a tiny memory footprint. Agents can pair with ASC to analyze dozens or even hundreds of APKs at once, even on weak machines. The JADX MCP has a harder time here: JADX alone uses several GB just to preload, which makes switching between hundreds of APKs impractical.

Install

# from PyPI
pip install droidasc

# or from source
pip install .

After installation, the droidasc CLI command is available globally:

usage: droidasc [-h] {getclass,listclass,getmanifest,findrefs} ...

ASC tooling entry (v0.1.2.post1).

positional arguments:
  {getclass,listclass,getmanifest,findrefs}
    getclass            Locate the target class in APK, extract one DEX in
                        memory, then decompile.
    listclass           List classes across all DEX entries; use --prefix to
                        filter by package/class prefix.
    getmanifest         Decode AndroidManifest.xml from APK and print it as
                        XML.
    findrefs            Find code references for string/type/method/field
                        across all DEX entries in APK.

options:
  -h, --help            show this help message and exit

examples:
  droidasc app.apk --gui
  droidasc getclass app.apk Lcom/poc/Main; -o Main.java
  droidasc getclass app.apk com.poc.Main --threads 16
  droidasc listclass app.apk -o classes.txt
  droidasc listclass app.apk --prefix com.poc
  droidasc getmanifest app.apk -o AndroidManifest.xml
  droidasc findrefs app.apk string token -o string_refs.txt
  droidasc findrefs app.apk type com.poc.Main
  droidasc findrefs app.apk method onCreate --class com.poc.Main
  droidasc findrefs app.apk method notify --class MainActivity --fuzzy-class -o method_refs.txt
  droidasc findrefs app.apk field apiKey -o field_refs.txt
  droidasc findrefs app.apk extends java.lang.Object
  droidasc findrefs app.apk extends android.app.Activity -o subclasses.txt
  droidasc findrefs app.apk impl android.os.IInterface -o impls.txt

-V/--version prints the installed package version.

findrefs searches for code references (string/type/method/field) across all DEX entries; -o writes results to the selected file instead of stdout, and --threads N controls the worker pool. extends/impl locate classes that extend a target class or implement a target interface, respectively.

listclass prints Dalvik class descriptors in APK/DEX definition order, one per line. With -o, output is written to the selected file instead of stdout. --prefix com.poc filters by Lcom/poc; an already normalized prefix such as Lcom/poc is kept unchanged.

You can also use python main.py as before — it delegates to the same entry point.

Sponsors

Sponsor Amount
HTTChina 5000¥
c01ns 11.9¥
gguowang AND cococount 2¥
Ylarod 50.11¥

Thank you to all sponsors for your support!

ASC is built with the hope that it can genuinely help everyone improve their reverse engineering workflow — from speeding up the tedious parts to making the impossible feel routine.

Acknowledgements

Thanks to the Androguard project for providing the Android reverse-engineering and DEX analysis foundation used by Droid ASC.

About

ASC is a super FAST and lightweight Android decompiler designed for Agents/Mobile Researchers.

Topics

Resources

Stars

2.4k stars

Watchers

7 watching

Forks

Releases

Packages

Contributors

Languages