Android Reverse Engineering & API Extraction — Compétence Claude Code

Une compétence Claude Code qui décompile les fichiers Android APK/XAPK/JAR/AAR et extrait les API HTTP utilisées par l'application — points de terminaison Retrofit, appels OkHttp, URL codées en dur, schémas d'authentification — afin que vous puissiez les documenter et les reproduire sans le code source original.

Prise en charge de Kotlin de premier ordre : les applications Android modernes sont en Kotlin/KMP, fortement obfusquées avec R8. Cette compétence récupère les noms de classes Kotlin d'origine à partir des métadonnées que R8 ne peut pas supprimer, et extrait les API de Ktor, Apollo (GraphQL) et Koin — pas seulement la pile classique Retrofit/OkHttp. Voir Récupération des noms Kotlin ci-dessous.

Prise en charge Windows / PowerShell (expérimentale) : les scripts *.ps1 aux côtés des scripts bash sont une contribution communautaire récente, encore en cours de stabilisation. Pour tout problème, veuillez ouvrir un ticket sur ce dépôt (pas sur les forks amont des contributeurs) : les scripts PowerShell sont maintenus ici par @SimoneAvogadro.

Table des matières

• Ce qu'il fait
• Prérequis
• Installation
• Utilisation
• Structure du dépôt
• Références
• Remerciements
• Avertissement
• Licence

Ce qu'il fait

Capacité	Description
Empreinte d'abord (Phase 0)	Trier un APK/XAPK en quelques secondes — détecter le framework (Flutter / React Native / Cordova / Xamarin / native-Kotlin), la pile HTTP, le niveau d'obfuscation et les bibliothèques natives avant de passer du temps sur une décompilation complète
Décompiler	Fichiers APK, XAPK, JAR et AAR à l'aide de jadx et Fernflower/Vineflower (moteur unique ou comparaison côte à côte)
Récupérer les noms Kotlin	Reconstruire les noms de classes d'origine *Repository / *ViewModel / *UseCase à partir de binaires obfusqués par R8 en utilisant les métadonnées Kotlin que R8 ne peut pas supprimer
Extraire les API	Retrofit, OkHttp, Volley et les piles Kotlin/KMP modernes : Ktor, Apollo (GraphQL), Koin DI — points de terminaison, URL codées en dur, en-têtes d'authentification, jetons et schémas de signature de requêtes HMAC
Tracer les flux d'appels	Des Activities/Fragments à travers les ViewModels et les dépôts jusqu'aux appels HTTP
Analyser la structure	Manifest, packages, modèles d'architecture
Gérer l'obfuscation	Extraction de chemins/URL résistante à R8 plus des stratégies pour naviguer dans la sortie ProGuard/R8

Prérequis

Requis :

• Java JDK 17+
• jadx (CLI)

Optionnel (recommandé) :

• Vineflower ou Fernflower — meilleure sortie sur du code Java complexe
• dex2jar — nécessaire pour utiliser Fernflower sur des fichiers APK/DEX

Voir plugins/android-reverse-engineering/skills/android-reverse-engineering/references/setup-guide.md pour des instructions d'installation détaillées.

Installation

Depuis GitHub (recommandé)

Dans Claude Code, exécutez :

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

La compétence sera disponible de façon permanente dans toutes les sessions futures.

Depuis un clone local

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

Puis dans Claude Code :

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

Utilisation

Commande slash

/decompile path/to/app.apk

Cela exécute le flux de travail complet : vérification des dépendances, décompilation et analyse initiale de la structure.

Langage naturel

La compétence s'active sur des phrases comme :

• « Décompile cet APK »
• « Fais de l'ingénierie inverse sur cette application Android »
• « Extrais les points de terminaison API de cette application »
• « Suis le flux d'appels depuis LoginActivity »
• « Analyse cette bibliothèque AAR »

Scripts manuels

Les scripts peuvent également être utilisés de manière autonome :

# 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

Récupération des noms Kotlin (désobfuscation R8)