ddc — Rust में DEX → Java डीकंपाइलर

अंग्रेज़ी | 简体中文

ddc Android DEX बाइटकोड को वापस पठनीय Java में डीकंपाइल करता है — वास्तविक दुनिया के ऐप के पैमाने पर, डेटाबेस की तरह क्वेरी करने योग्य, और javac-सत्यापित: सात वास्तविक दुनिया के APKs में यह जो 909,689 फ़ाइलें उत्पन्न करता है, उनमें से हर एक साफ़ तरीके से पार्स होती है।

मुख्य विशेषताएँ

• तेज़ — एक 226 MB / 20-dex APK (weibo, 98k क्लासेस) उच्च गुणवत्ता पर ~13s में पूरी तरह डीकंपाइल हो जाती है, एक 62 MB ऐप (Telegram) ~4.5s में; पैथोलॉजिकल क्लासेस रन को हैंग करने के बजाय डेडलाइन-बाउंड मॉनिटर किए गए थ्रेड्स पर चलते हैं।
• कंपाइल होता है — सभी सात बेंचमार्क APKs का पूरा आउटपुट (reqable, Telegram, WhatsApp, weibo, weixin, qq, lark — 0.91M फ़ाइलें) शून्य सिंटैक्स त्रुटियों के साथ javac पास करता है; केस-वेरिएंट नाम जोड़ी (X/Cua बनाम X/cua) की हर क्लास अपनी अलग फ़ाइल के रूप में संरक्षित रहती है, अंतिम के द्वारा चुपचाप ओवरराइट होने के बजाय।
• प्रगतिशील डीकंपाइलेशन — 15 क्वेरी सबकमांड (strings, क्रॉस-रेफ़रेंस, पदानुक्रम, manifest, संसाधन, प्रति-मेथड डीकंपाइल) मिलीसेकंड में उत्तर देते हैं: पहले मेटाडेटा क्वेरी करें, मांग पर डीकंपाइल करें, पूरा रन पूरी तरह छोड़ दें।
• DEX 035–041, पूर्ण — मल्टी-dex APKs, XAPK/APKS/APKM कंटेनर, invoke-custom; लैम्ब्डा और स्ट्रिंग कॉन्कैट वापस असली Java में मोड़े जाते हैं ((a) -> …, Cls::name, a + b)।
• पठनीय आउटपुट — v12 के बजाय jadx-शैली के स्थानीय नाम (str, getName() → name, Kotlin Intrinsics पैरामीटर स्ट्रिंग्स); IntDef लिटरल्स बॉक्स से बाहर अपने कॉन्स्टेंट्स के रूप में प्रदर्शित होते हैं (setVisibility(8) → View.GONE; एक अंतर्निहित android-37 डोमेन तालिका, --symbols ओवरराइड करता है); Kotlin नल-चेक शोर हटा दिया जाता है और सिंथेटिक access$NNN ब्रिज उनके कॉल साइट्स पर इनलाइन हो जाते हैं।
• पुनरुत्पादनीय आउटपुट — कोई टाइमस्टैम्प नहीं; दो रन साफ़ तरीके से डिफ़ होते हैं।
• मानव-आकार का आउटपुट, डिफ़ॉल्ट रूप से (cure): हर फ़ाइल एक सेमांटिक-संरक्षणकारी सोर्स-लेवल पास से गुज़रती है जो रजिस्टर-कॉपी चेन को इनलाइन करता है, if/else असाइनमेंट को टर्नरीज़ में मोड़ता है, for-each को पुनर्प्राप्त करता है, डेड स्टोर्स और कंपाइलर आर्टिफ़ैक्ट्स को हटाता है — समान javac-गेट परिणामों के साथ वास्तविक कॉर्पोरा पर −15% आउटपुट लाइनें। यह पास सटीक है, इसलिए इसमें समय लगता है: weibo (110k फ़ाइलें) 21 s ऑप्टिमाइज़्ड लेता है बनाम --fast के साथ 10 s (सरलीकरण छोड़ें, फ़ॉर्मेटिंग रखें)।
• HTTP REST + MCP, अंतर्निहित (xyz-rust): ddc serve हर क्वेरी को REST रूट के रूप में उजागर करता है (क्वेरी पैराम्स के साथ GET या JSON बॉडी के साथ POST) साथ ही GET /openapi.json और /mcp पर एक स्ट्रीमेबल MCP एंडपॉइंट — एक MCP क्लाइंट को http://addr/mcp पर इंगित करें; ddc http केवल REST है (कोई /mcp नहीं); ddc mcp stdio|http इनपुट और आउटपुट स्कीमा के साथ समान कमांड को MCP टूल्स के रूप में चलाता है। क्वेरी कमांड --format auto|text|table|markdown|md|json|jsonl लेते हैं (auto: टर्मिनल पर तालिका, पाइप किए जाने पर स्थिर टेक्स्ट रूप)।
• द्विभाषी CLI — संदेश स्वचालित रूप से स्थानीयकृत होते हैं (DDC_LANG=zh|en बाध्य करता है; अंग्रेज़ी फ़ॉलबैक)।
• jdc-core पर निर्मित, जो jcdc के साथ साझा किया गया मशीन-न्यूट्रल कोर है।

इंस्टॉल

macOS (Homebrew):

brew install ejfkdev/tap/ddc

Windows (Scoop) — बकेट को एक बार जोड़ें, फिर नाम से इंस्टॉल करें (scoop एक सादे user/repo/app रूप को हल नहीं करता — issue #3):

scoop bucket add ejfkdev https://github.com/ejfkdev/scoop-bucket
scoop install ddc

# or install straight from the manifest URL, no bucket needed:
scoop install https://raw.githubusercontent.com/ejfkdev/scoop-bucket/main/bucket/ddc.json

cargo-binstall (कोई भी प्लेटफ़ॉर्म — संकलन करने के बजाय पहले से बने रिलीज़ बाइनरी को प्राप्त करता है):

cargo binstall ddc-cli

बाइनरीज़: प्रत्येक रिलीज़ में linux-amd64, linux-arm64, windows-amd64, windows-arm64, macos-amd64 और macos-arm64 के लिए रॉ बाइनरीज़ (कोई आर्काइव नहीं) शामिल होती हैं — गैर-macOS बिल्ड UPX-कंप्रेस्ड होते हैं।

सोर्स से (Rust stable):

git clone https://github.com/ejfkdev/ddc && cd ddc
cargo build --release

उपयोग

ddc app.apk                          # full decompile → app-out/
ddc app.apk -c com.example.Foo       # one class to stdout
ddc app.apk -o - | less              # everything to stdout

ddc info app.apk                      # app context (label via arsc, package,
                                      # version, md5) + per-dex counts
ddc mainactivity app.apk             # entry point: package + launcher
ddc findrefs app.apk string token    # every const-string "token" site
ddc getmethod app.apk Foo.toString   # one method, all overloads
ddc pkg app.apk --app -o own/        # the app's own code only

पूर्ण विकल्प और उदाहरण: ddc --help (वर्कफ़्लो के अनुसार समूहित सबकमांड मेनू)। संपूर्ण संदर्भ — प्रत्येक विकल्प का अर्थ, प्रत्येक सबकमांड का आउटपुट प्रारूप और व्यवहार — docs/cli.md (中文) में उपलब्ध है।

प्रदर्शन

सात वास्तविक-दुनिया के APK, रिलीज़ बिल्ड, कूलडाउन के बाद मापा गया (Apple Silicon, 6P+12E)। 39-APK सत्यापन कॉर्पस (4.08M डीकंपाइल की गई फ़ाइलें, प्रति-APK वॉल टाइम / शिखर RSS / javac पार्स गेट) docs/validation.md (中文) में है।

पूर्ण डीकंपाइल — 7 वास्तविक-दुनिया के APK

APK	आकार	पूर्ण डीकंपाइल	शिखर RSS
reqable	34 MB	0.57s	162 MB
Telegram	62 MB	4.50s	786 MB
WhatsApp	139 MB	13.6s (99,483 फ़ाइलें — केस-वेरिएंट क्लास जोड़े सभी संरक्षित)	944 MB
weibo	226 MB	13.5s	1173 MB
weixin	268 MB	32.7s	1401 MB
lark	398 MB	16.1s	2226 MB
qq	374 MB	37.1s	2268 MB

उन्हीं APK पर क्वेरी सबकमांड (सेल: समय / शिखर RSS; strings -f <package> --with-locations, पैकेज स्ट्रिंग और मेथड onCreate पर findrefs, प्रत्येक ऐप के लॉन्चर क्लास पर hierarchy/disasm/getclass):

क्वेरी सबकमांड — 13 कमांड × 7 APK