Convertir JAD en JAR

Un téléphone ou un émulateur Java ME peut nécessiter un JAR, alors qu’un téléchargement ou une sauvegarde ne contient que son descripteur JAD. La tâche habituelle consiste à trouver le JAR correspondant, et non à convertir le JAD, car le descripteur ne contient pas l’application elle-même.

Qu’est-ce que le format JAD ?

JAD signifie Java Application Descriptor. Il s’agit d’un petit fichier texte brut utilisé par les applications Java ME pour stocker des métadonnées telles que le nom de l’application, sa version, son éditeur, la configuration requise, l’emplacement du JAR et la taille du JAR.

Les anciens téléphones Nokia, Sony Ericsson, Samsung et autres téléphones compatibles Java utilisent des fichiers JAD lors de l’installation ; les émulateurs Java ME et les applications mobiles archivées peuvent également en contenir. Ouvrez un JAD dans un éditeur de texte et recherchez des entrées telles que MIDlet-Jar-URL: game.jar et MIDlet-Jar-Size: 123456. MIDlet-Jar-URL peut contenir un nom de fichier local, une URL relative ou une URL de téléchargement absolue.

Qu’est-ce que le format JAR ?

JAR signifie Java Archive. Il s’agit d’un package basé sur ZIP qui peut contenir des classes Java compilées, des images, des ressources d’application, un manifest à l’emplacement META-INF/MANIFEST.MF et d’autres métadonnées. Pour les logiciels Java ME, le JAR contient la charge utile exécutable ; le JAD est un descripteur d’installation facultatif ou obligatoire, selon l’appareil ou l’émulateur.

Un JAR peut être inspecté avec 7-Zip ou l’utilitaire jar du JDK. L’ouvrir comme un ZIP ne convertit pas un JAD et ne recrée pas les fichiers d’application manquants.

Comment obtenir le JAR correspondant

1. Ouvrez le JAD dans un éditeur de texte et copiez la valeur complète de MIDlet-Jar-URL.
2. Si la valeur est une URL, téléchargez cette ressource depuis le site ou le repository d’origine. S’il s’agit d’un nom de fichier, recherchez-le dans le même téléchargement, le dossier extrait, la sauvegarde de l’appareil ou la distribution d’origine.
3. Vérifiez le fichier téléchargé par rapport à MIDlet-Jar-Size, qui indique la taille attendue en octets. Sous Windows, cliquez avec le bouton droit sur le JAR, sélectionnez Properties et comparez le nombre d’octets.
4. Utilisez 7-Zip ou jar tf application.jar pour confirmer que l’archive contient des fichiers d’application, tels que des fichiers .class et META-INF/MANIFEST.MF.
5. Copiez le JAR sur le téléphone ou dans l’émulateur. Conservez le JAD lorsque l’installateur l’exige ; ne renommez pas le JAR, sauf si la valeur de MIDlet-Jar-URL est modifiée pour correspondre.

Un JAR portant le même nom, mais correspondant à une version d’application ou à une taille en octets différente, peut être incompatible. Lorsque le JAR d’origine est manquant, recherchez le nom de fichier exact, la version et l’éditeur. Les repositories en ligne et les archives web peuvent aider à retrouver la distribution d’origine, mais ils ne convertissent pas un descripteur en application.

Comment créer un nouveau JAR à partir de fichiers d’application

Si vous disposez des classes compilées et des ressources, installez un Java Development Kit et placez ces fichiers dans la structure de répertoires de packages prévue. Depuis le répertoire contenant la sortie de build, exécutez :

jar cf application.jar -C build/classes .

Pour fournir un manifest, créez manifest.mf et exécutez :

jar cfm application.jar manifest.mf -C build/classes .

Cela crée une archive ; cela ne reproduit pas le build Java ME d’origine. Les applications Java ME peuvent nécessiter un preprocessing, une obfuscation, un manifest particulier, une signature, un traitement des ressources ou un outil de build spécifique à l’éditeur. Un JAD listant des noms de classes ou d’autres métadonnées ne peut pas remplacer le code source, les classes compilées, les ressources ou les clés de signature manquants.

Limites de conversion et outils en ligne

Un JAD ne peut généralement pas être converti en JAR fonctionnel. Il s’agit de métadonnées, et non d’un conteneur pour la charge utile de l’application. Aucun convertisseur en ligne réputé ne peut récupérer des classes et des ressources absentes du JAD. Il est donc inutile de téléverser le descripteur vers un service de conversion, et cela peut exposer les métadonnées de l’application.

Si vous ne possédez que des fichiers source, utilisez l’environnement de développement Java ME d’origine ou un processus de build compatible basé sur un JDK plutôt qu’un convertisseur en ligne. Si vous possédez déjà un JAR, utilisez 7-Zip ou la commande jar du JDK pour l’inspecter et le reconditionner ; le reconditionnement peut invalider les signatures et modifier le comportement de l’installation.

Certains téléphones nécessitent les deux fichiers et vérifient que les valeurs du JAD, les données du manifest, la taille du JAR, la version et les informations de signature concordent. Lorsque l’installation signale une erreur de taille, de version ou de sécurité, procurez-vous la paire JAD/JAR d’origine au lieu de modifier les métadonnées à l’aveugle.