Android रिवर्स इंजीनियरिंग और API निष्कर्षण — Claude Code स्किल

एक Claude Code स्किल जो Android APK/XAPK/JAR/AAR फ़ाइलों को डीकंपाइल करती है और ऐप द्वारा उपयोग किए जाने वाले HTTP APIs को निकालती है — Retrofit endpoints, OkHttp calls, हार्डकोडेड URLs, प्रमाणीकरण पैटर्न — ताकि आप मूल स्रोत कोड के बिना उन्हें दस्तावेज़ित और पुनरुत्पादित कर सकें।

प्रथम-श्रेणी Kotlin समर्थन: आधुनिक Android ऐप्स Kotlin/KMP हैं, जो R8 के साथ भारी रूप से अस्पष्टीकृत हैं। यह स्किल R8 द्वारा हटाए नहीं जा सकने वाले मेटाडेटा से मूल Kotlin क्लास नामों को पुनर्प्राप्त करती है, और Ktor, Apollo (GraphQL) और Koin से APIs निकालती है — न कि केवल क्लासिक Retrofit/OkHttp स्टैक से। नीचे Kotlin नाम पुनर्प्राप्ति देखें।

Windows / PowerShell समर्थन (प्रायोगिक): bash स्क्रिप्ट्स के साथ-साथ *.ps1 स्क्रिप्ट्स एक हालिया सामुदायिक योगदान हैं, जो अभी भी स्थिर किए जा रहे हैं। किसी भी समस्या के लिए कृपया इस रिपॉज़िटरी पर issue खोलें (योगदानकर्ताओं के अपस्ट्रीम फ़ोर्क्स पर नहीं): PowerShell स्क्रिप्ट्स यहाँ @SimoneAvogadro द्वारा अनुरक्षित हैं।

विषय-सूची

• यह क्या करता है
• आवश्यकताएँ
• इंस्टॉलेशन
• उपयोग
• रिपॉज़िटरी संरचना
• संदर्भ
• आभार
• अस्वीकरण
• लाइसेंस

यह क्या करता है

क्षमता	विवरण
पहले फ़िंगरप्रिंट (Phase 0)	सेकंडों में APK/XAPK का ट्राइएज करें — पूर्ण डीकंपाइल पर समय खर्च करने से पहले फ़्रेमवर्क (Flutter / React Native / Cordova / Xamarin / native-Kotlin), HTTP स्टैक, अस्पष्टीकरण स्तर और नेटिव लाइब्रेरीज़ का पता लगाएँ
डीकंपाइल	jadx और Fernflower/Vineflower का उपयोग करके APK, XAPK, JAR, और AAR फ़ाइलें (एकल इंजन या साथ-साथ तुलना)
Kotlin नाम पुनर्प्राप्त करें	R8-अस्पष्टीकृत बाइनरीज़ से मूल *Repository / *ViewModel / *UseCase क्लास नामों को Kotlin मेटाडेटा का उपयोग करके पुनर्निर्मित करें जिसे R8 हटा नहीं सकता
APIs निकालें	Retrofit, OkHttp, Volley और आधुनिक Kotlin/KMP स्टैक: Ktor, Apollo (GraphQL), Koin DI — endpoints, हार्डकोडेड URLs, auth हेडर, टोकन और HMAC अनुरोध-हस्ताक्षर योजनाएँ
कॉल फ़्लो ट्रेस करें	Activities/Fragments से ViewModels और repositories के माध्यम से HTTP कॉल्स तक
संरचना का विश्लेषण करें	Manifest, पैकेज, आर्किटेक्चर पैटर्न
अस्पष्टीकरण संभालें	R8-प्रतिरोधी पथ/URL निष्कर्षण और ProGuard/R8 आउटपुट को नेविगेट करने की रणनीतियाँ

आवश्यकताएँ

आवश्यक:

• Java JDK 17+
• jadx (CLI)

वैकल्पिक (अनुशंसित):

• Vineflower या Fernflower — जटिल Java कोड पर बेहतर आउटपुट
• dex2jar — APK/DEX फ़ाइलों पर Fernflower का उपयोग करने के लिए आवश्यक

विस्तृत इंस्टॉलेशन निर्देशों के लिए plugins/android-reverse-engineering/skills/android-reverse-engineering/references/setup-guide.md देखें।

इंस्टॉलेशन

GitHub से (अनुशंसित)

Claude Code के अंदर, चलाएँ:

/plugin marketplace add SimoneAvogadro/android-reverse-engineering-skill
/plugin install android-reverse-engineering@android-reverse-engineering-skill

स्किल सभी भविष्य के सत्रों में स्थायी रूप से उपलब्ध रहेगी।

स्थानीय क्लोन से

git clone https://github.com/SimoneAvogadro/android-reverse-engineering-skill.git

फिर Claude Code में:

/plugin marketplace add /path/to/android-reverse-engineering-skill
/plugin install android-reverse-engineering@android-reverse-engineering-skill

उपयोग

स्लैश कमांड

/decompile path/to/app.apk

यह पूर्ण वर्कफ़्लो चलाता है: निर्भरता जाँच, डीकंपाइलेशन, और प्रारंभिक संरचना विश्लेषण।

प्राकृतिक भाषा

स्किल इन वाक्यांशों पर सक्रिय होती है:

• "इस APK को डीकंपाइल करें"
• "इस Android ऐप को रिवर्स इंजीनियर करें"
• "इस ऐप से API endpoints निकालें"
• "LoginActivity से कॉल फ़्लो का पालन करें"
• "इस AAR लाइब्रेरी का विश्लेषण करें"

मैनुअल स्क्रिप्ट्स

स्क्रिप्ट्स को स्टैंडअलोन भी उपयोग किया जा सकता है:

# Check dependencies
bash plugins/android-reverse-engineering/skills/android-reverse-engineering/scripts/check-deps.sh

# Install a missing dependency (auto-detects OS and package manager)
bash plugins/android-reverse-engineering/skills/android-reverse-engineering/scripts/install-dep.sh jadx
bash plugins/android-reverse-engineering/skills/android-reverse-engineering/scripts/install-dep.sh vineflower

# Fingerprint an APK/XAPK BEFORE decompiling (Phase 0 triage):
# framework, HTTP stack, obfuscation level, native libs, notable SDKs
bash plugins/android-reverse-engineering/skills/android-reverse-engineering/scripts/fingerprint.sh app.apk

# Decompile APK with jadx (default)
bash plugins/android-reverse-engineering/skills/android-reverse-engineering/scripts/decompile.sh app.apk

# Decompile XAPK (auto-extracts and decompiles each APK inside)
bash plugins/android-reverse-engineering/skills/android-reverse-engineering/scripts/decompile.sh app-bundle.xapk

# Decompile with Fernflower
bash plugins/android-reverse-engineering/skills/android-reverse-engineering/scripts/decompile.sh --engine fernflower library.jar

# Run both engines and compare
bash plugins/android-reverse-engineering/skills/android-reverse-engineering/scripts/decompile.sh --engine both --deobf app.apk

# Find API calls — defaults to a full scan across every supported stack
bash plugins/android-reverse-engineering/skills/android-reverse-engineering/scripts/find-api-calls.sh output/sources/
bash plugins/android-reverse-engineering/skills/android-reverse-engineering/scripts/find-api-calls.sh output/sources/ --retrofit
bash plugins/android-reverse-engineering/skills/android-reverse-engineering/scripts/find-api-calls.sh output/sources/ --urls

# Modern Kotlin/KMP stacks and obfuscation-resistant extraction
bash plugins/android-reverse-engineering/skills/android-reverse-engineering/scripts/find-api-calls.sh output/sources/ --ktor    # Ktor client
bash plugins/android-reverse-engineering/skills/android-reverse-engineering/scripts/find-api-calls.sh output/sources/ --apollo  # Apollo / GraphQL
bash plugins/android-reverse-engineering/skills/android-reverse-engineering/scripts/find-api-calls.sh output/sources/ --paths   # quoted path literals that survive R8 inlining

Kotlin नाम पुनर्प्राप्ति (R8 deobfuscation)

अधिकांश वास्तविक-दुनिया के Kotlin/KMP ऐप्स R8 के माध्यम से शिप होते हैं, इसलिए डीकंपाइल किए गए क्लास a.b.c के रूप में निकलते हैं। R8 JVM प्रतीकों का नाम बदल देता है लेकिन Kotlin मेटाडेटा स्ट्रिंग्स को हटा नहीं सकता — Kotlin रनटाइम (reflection, coroutines) को रनटाइम पर मूल पूर्ण-योग्य नामों की आवश्यकता होती है। यह स्किल उन @DebugMetadata / @Metadata एनोटेशन्स को खनन करके एक obfuscated → real क्लास-नाम मैप पुनर्निर्मित करती है। एक सामान्य ऐप पर यह उन सभी *Repository / *ViewModel / *UseCase / *Impl क्लासों का ~100 % पुनर्प्राप्त करती है जिन्हें आप वास्तव में पढ़ना चाहते हैं।

# 1. Build the mapping from the decompiled sources
bash plugins/android-reverse-engineering/skills/android-reverse-engineering/scripts/recover-kotlin-names.sh output/sources/ output/names/
#    → output/names/mapping.tsv, mapping.json, by_package/