Convertir JAR en APK

Un appareil Android, un émulateur ou un système de déploiement d’entreprise peut nécessiter un .apk installable lorsque le logiciel dont vous disposez est un .jar Java. Il s’agit généralement d’une tâche de portage et de build Android, et non d’un simple changement d’extension de fichier.

Contenu d’un fichier JAR

Un JAR (Java Archive) est un conteneur basé sur ZIP utilisé par les développeurs Java pour les bibliothèques, les applications de bureau, les outils en ligne de commande et certains anciens logiciels Java ME. Il contient normalement des fichiers Java .class, des ressources et des métadonnées sous META-INF ; Maven, Gradle, Eclipse, IntelliJ IDEA et l’outil jar du JDK produisent couramment des fichiers JAR.

Un JAR de bureau exécutable déclare souvent une Main-Class dans META-INF/MANIFEST.MF et démarre via un runtime Java standard. Un JAR de bibliothèque fournit du code réutilisable sans point d’entrée d’application. Aucun de ces types ne fournit intrinsèquement de composants Android, de ressources Android, de fichier AndroidManifest.xml utilisable ou de configuration de signature Android.

Contenu d’un fichier APK

Un APK est un package d’application Android. Il contient du bytecode DEX destiné à Android Runtime (ART), un manifest Android, des ressources compilées, des bibliothèques natives facultatives et des signatures de package.

Ses avantages pratiques sont qu’Android peut l’installer directement, vérifier son certificat de signature et identifier les activités, services, permissions et appareils pris en charge qu’il déclare. Pour les nouvelles soumissions publiques sur Google Play, utilisez plutôt un Android App Bundle (.aab) ; Google Play génère des APK spécifiques à chaque appareil à partir du bundle.

Vérifier le JAR avant de tenter un build

Avec un JDK installé, listez le contenu de l’archive :

jar tf input.jar

Recherchez META-INF/MANIFEST.MF, les répertoires de packages Java, les ressources et les dépendances. Un JAR utilisant Swing, AWT, JavaFX, une méthode main() de bureau, des chemins de fichiers locaux sans restriction ou des bibliothèques de bureau spécifiques à une plateforme ne peut pas devenir une application Android fonctionnelle par simple reconditionnement.

Un JAR qui est uniquement une bibliothèque polyvalente peut être utilisable dans un projet Android. Une application de bureau complète nécessite normalement que son code source soit adapté à Android.

Créer un APK Android à partir du code source

1. Installez Android Studio et installez la plateforme SDK requise via Tools → SDK Manager.
2. Créez un projet Android via File → New → New Project. Sélectionnez Java si le code existant est en Java ; Kotlin est également pris en charge, mais n’est pas requis pour la migration.
3. Déplacez le code Java réutilisable dans le module de l’application, généralement dans app/src/main/java. Remplacez un point d’entrée de bureau main() par une Activity, un service, un receiver ou un autre composant Android déclaré.
4. Remplacez le code d’interface utilisateur de bureau par des vues Android, des layouts ou Jetpack Compose ; Android ne fournit pas Swing, AWT ou JavaFX comme le fait un runtime Java de bureau.
5. Adaptez le stockage, les communications réseau, les notifications, les tâches en arrière-plan et les permissions aux API Android. Par exemple, l’accès réseau nécessite <uses-permission android:name="android.permission.INTERNET" /> dans le manifest du projet.
6. Définissez l’ID de l’application, la version minimale du SDK, la version cible du SDK, les icônes, les ressources et les composants du manifest. Effectuez des tests sur un émulateur et sur de vrais appareils utilisant les versions d’Android que vous prenez en charge.
7. Créez un APK de debug avec ./gradlew assembleDebug sur macOS/Linux ou gradlew.bat assembleDebug sur Windows. Le résultat se trouve généralement dans app/build/outputs/apk/debug/app-debug.apk.
8. Créez un APK de release via Build → Generate Signed Bundle / APK → APK. Signez-le avec un keystore que vous contrôlez et conservez le keystore, l’alias et les mots de passe.

Utiliser un JAR compatible comme bibliothèque

Copiez un JAR de bibliothèque dans app/libs et ajoutez-le aux dépendances Gradle du module de l’application :

implementation(files("libs/library.jar"))

Le Android Gradle Plugin convertit les fichiers de classes Java compatibles en DEX pendant le build. Ajoutez séparément les dépendances tierces requises via Gradle ; ne partez pas du principe que toutes les dépendances utilisées par le JAR d’origine y sont intégrées ou fonctionnent sur Android.

Fichiers JAR Java ME et convertisseurs en ligne

Les anciens jeux et applications Java ME utilisent couramment un .jar accompagné éventuellement d’un descripteur .jad. J2ME Loader peut en exécuter beaucoup par émulation, mais il ne convertit pas le programme d’origine en un APK natif autonome. Une version Android native nécessite le code source et une réécriture pour Android.

Aucun service en ligne sérieux ne peut convertir de manière fiable un JAR arbitraire en APK fonctionnel, car les points d’entrée Android, l’interface utilisateur, les permissions, les dépendances et les remplacements d’API sont propres à chaque application. Évitez les convertisseurs « en un clic » fondés sur l’envoi de fichiers, en particulier pour du code propriétaire ; ils ne peuvent pas créer de manière sûre une application maintenable ni vous laisser le contrôle exclusif de votre clé de signature de release.

Limites de compatibilité et de release

ART exécute du DEX, et non des fichiers de classes JVM ordinaires. D8 peut traduire du bytecode compatible, mais ne rend pas les API Java SE de bureau disponibles sur Android. Les JAR compilés pour une version de fichier de classes Java non prise en charge peuvent nécessiter une recompilation à partir du code source ; certaines fonctionnalités du langage et certaines bibliothèques nécessitent le desugaring Android ou des remplacements spécifiques à Android.

La réflexion, les classes chargées dynamiquement, la réduction du code, les bibliothèques natives et les architectures CPU spécifiques aux appareils nécessitent une configuration explicite du build et des tests. Le code décompilé peut parfois aider à récupérer un projet perdu, mais il peut être incomplet, difficile à maintenir et soumis aux restrictions de la licence du logiciel.

Une application installée ne peut être mise à jour qu’avec le même ID d’application et la même clé de signature. La modification de l’un ou de l’autre amène Android à considérer l’APK comme une application différente plutôt que comme une mise à jour.