Convertir APK en JAD

Qu’est-ce que le format APK ?

APK est le format de package installable pour les applications Android, produit par Android Studio, Gradle et les outils de packaging Android. Les distributions Android peuvent fournir un APK unique ou plusieurs split APKs ; les builds de développeur, les sauvegardes d’appareils et les dépôts tiers contiennent couramment des fichiers APK.

Un APK est un conteneur basé sur ZIP qui inclut normalement un AndroidManifest.xml compilé ou binaire, du bytecode Dalvik/ART dans classes.dex, des ressources, des bibliothèques natives et des informations de signature. Android utilise le manifeste, le code DEX, les ressources et les APIs du framework pour installer et exécuter l’application.

Qu’est-ce que le format JAD ?

JAD est un descripteur d’application Java en texte brut utilisé par les téléphones et les émulateurs Java ME. Il décrit un JAR d’application Java ME distinct et contient généralement MIDlet-Name, MIDlet-Version, MIDlet-Vendor, MIDlet-1, MicroEdition-Configuration, MicroEdition-Profile, MIDlet-Jar-URL et MIDlet-Jar-Size.

Le JAR contient les fichiers de classes et les ressources Java ME ; le JAD fournit les métadonnées d’installation et identifie ce JAR. Un JAD n’est pas une application exécutable et ne peut pas fonctionner sans code Java ME compatible.

Pourquoi la conversion directe ne fonctionne pas

Il n’existe pas de véritable conversion d’APK vers JAD. Android utilise le bytecode DEX, les APIs du framework Android, les composants d’application Android et le runtime Dalvik/ART. Java ME utilise des fichiers de classes Java, les APIs CLDC/MIDP et le cycle de vie des MIDlet. Un descripteur ne peut pas traduire le bytecode, les layouts Android, les permissions, les bibliothèques natives ou les dépendances du framework d’une plateforme à l’autre.

Renommer app.apk en app.jad, extraire le contenu de l’APK dans un JAR ou copier les valeurs du manifeste Android dans un JAD crée un package Java ME invalide ou non fonctionnel. Aucun convertisseur en ligne réputé ne peut transformer une application Android en MIDlet fonctionnel ; les services qui prétendent le faire se contentent généralement de renommer, d’extraire ou de repackager les fichiers sans traduire le programme.

Comment créer un JAD à partir d’un JAR Java ME existant

Cette procédure s’applique uniquement si vous disposez déjà d’un JAR Java ME valide, notamment s’il se trouve par hasard dans un APK. Un JAR quelconque contenu dans un APK n’est pas automatiquement une application Java ME ; vérifiez la présence de classes MIDlet et d’attributs de manifeste Java ME.

1. Inspectez l’APK avec 7-Zip ou les outils de la plateforme Android. Sur un système disposant de unzip, listez son contenu avec unzip -l app.apk et extrayez-le avec unzip app.apk -d app_unpacked. L’extraction ne convertit pas le code Android.
2. Utilisez Apktool lorsque vous devez inspecter les ressources Android, le manifeste ou le code DEX désassemblé : apktool d app.apk -o app_decoded. Apktool décode les fichiers Android et produit du smali, mais ne produit ni JAR ni JAD Java ME.
3. Si un JAR Java ME approprié est présent, utilisez un utilitaire local de conversion JAR vers JAD tel que JADMaker, ou créez manuellement le descripteur dans un éditeur de texte brut. Les outils de packaging Java ME SDK ou Wireless Toolkit peuvent également générer des descripteurs dans le cadre d’un build Java ME.
4. Pour une création manuelle, enregistrez un fichier texte à côté du JAR avec le même nom de base, par exemple example.jad à côté de example.jar :

MIDlet-Name: Example
MIDlet-Version: 1.0
MIDlet-Vendor: Example Vendor
MIDlet-1: Example,,com.example.ExampleMIDlet
MicroEdition-Configuration: CLDC-1.1
MicroEdition-Profile: MIDP-2.0
MIDlet-Jar-URL: example.jar
MIDlet-Jar-Size: 123456

Remplacez les valeurs d’exemple par les métadonnées prises en charge par le JAR. La classe indiquée dans MIDlet-1 doit exister dans le JAR et implémenter le point d’entrée MIDlet requis. MIDlet-Jar-Size doit correspondre exactement à la taille du JAR en octets, sans séparateurs. L’URL peut être un nom de fichier local pour le sideloading ou une URL de serveur pour l’installation réseau.

Un générateur JAR vers JAD en ligne n’est acceptable que pour un JAR Java ME déjà valide et non sensible ; il ne peut pas convertir un APK. Un générateur de bureau est plus sûr pour les fichiers signés ou propriétaires, car le téléversement de l’archive expose son contenu. Vérifiez les champs générés et la taille du JAR avant de transférer les deux fichiers vers le téléphone ou l’émulateur.

Limitations de compatibilité

Un APK Android peut nécessiter des versions du framework Android, des permissions, des services Google, des bibliothèques natives, des fonctionnalités tactiles ou du matériel qui n’ont aucun équivalent Java ME. Même une décompilation du code source ne produirait pas un MIDlet portable sans une réécriture importante utilisant les APIs CLDC/MIDP et un nouveau build Java ME.

Pour l’installation ou l’archivage Android, conservez l’APK signé d’origine ou tous les split APKs requis. Pour un appareil Java ME, procurez-vous la version JAR/JAD d’origine correspondante ou un port Java ME développé séparément ; un descripteur généré seul ne peut pas rendre l’application Android compatible.