Converti JAD in JAR

Un telefono o un emulatore Java ME può richiedere un JAR, mentre un download o un backup contiene solo il relativo descrittore JAD. Il compito abituale è individuare il JAR corrispondente, non convertire il JAD, perché il descrittore non contiene l'applicazione vera e propria.

Che cos'è il formato JAD

JAD significa Java Application Descriptor. È un piccolo file di testo semplice utilizzato dalle applicazioni Java ME per memorizzare metadati quali il nome dell'applicazione, la versione, il fornitore, la configurazione richiesta, il percorso del JAR e le dimensioni del JAR.

I telefoni Nokia, Sony Ericsson, Samsung e altri telefoni abilitati per Java meno recenti utilizzano i file JAD durante l'installazione; anche gli emulatori Java ME e le applicazioni mobili archiviate possono includerli. Apri un JAD in un editor di testo e cerca voci come MIDlet-Jar-URL: game.jar e MIDlet-Jar-Size: 123456. MIDlet-Jar-URL può contenere un nome di file locale, un URL relativo o un URL di download assoluto.

Che cos'è il formato JAR

JAR significa Java Archive. È un pacchetto basato su ZIP che può contenere classi Java compilate, immagini, risorse dell'applicazione, un manifest in META-INF/MANIFEST.MF e altri metadati. Per il software Java ME, il JAR contiene il payload eseguibile; il JAD è un descrittore di installazione facoltativo o obbligatorio, a seconda del dispositivo o dell'emulatore.

Un JAR può essere esaminato con 7-Zip o con l'utilità jar del JDK. Aprirlo come ZIP non converte un JAD né ricrea i file dell'applicazione mancanti.

Come ottenere il JAR corrispondente

1. Apri il JAD in un editor di testo e copia il valore completo di MIDlet-Jar-URL.
2. Se il valore è un URL, scarica quella risorsa dal sito o repository originale. Se è un nome di file, cercalo nello stesso download, nella cartella estratta, nel backup del dispositivo o nella distribuzione originale.
3. Confronta il file scaricato con MIDlet-Jar-Size, che specifica le dimensioni previste in byte. In Windows, fai clic con il pulsante destro del mouse sul JAR, seleziona Properties e confronta il numero di byte.
4. Utilizza 7-Zip o jar tf application.jar per confermare che l'archivio contenga i file dell'applicazione, ad esempio file .class e META-INF/MANIFEST.MF.
5. Copia il JAR nel telefono o nell'emulatore. Conserva il JAD quando l'installer lo richiede; non rinominare il JAR a meno che il valore di MIDlet-Jar-URL non venga modificato di conseguenza.

Un JAR con lo stesso nome ma con una versione dell'applicazione o una dimensione in byte diversa potrebbe essere incompatibile. Quando il JAR originale manca, cerca il nome file, la versione e il fornitore esatti. I repository online e gli archivi web possono aiutare a individuare la distribuzione originale, ma non convertono un descrittore in un'applicazione.

Come creare un nuovo JAR dai file dell'applicazione

Se disponi delle classi e delle risorse compilate, installa un Java Development Kit e inserisci tali file nella struttura di directory dei pacchetti prevista. Dalla directory contenente l'output della build, esegui:

jar cf application.jar -C build/classes .

Per fornire un manifest, crea manifest.mf ed esegui:

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

Questo crea un archivio; non riproduce la build Java ME originale. Le applicazioni Java ME possono richiedere preprocessing, offuscamento, un manifest specifico, la firma, l'elaborazione delle risorse o uno strumento di build specifico del fornitore. Un JAD che elenca nomi di classi o altri metadati non può sostituire il codice sorgente, le classi compilate, le risorse o le chiavi di firma mancanti.

Limiti della conversione e strumenti online

In genere un JAD non può essere convertito in un JAR funzionante. È costituito da metadati, non da un contenitore per il payload dell'applicazione. Nessun convertitore online affidabile può recuperare classi e risorse assenti dal JAD, quindi caricare il descrittore su un servizio di conversione è inutile e potrebbe esporre i metadati dell'applicazione.

Se possiedi solo file sorgente, utilizza l'ambiente di sviluppo Java ME originale o un processo di build compatibile basato su JDK, invece di un convertitore online. Se possiedi un JAR esistente, usa 7-Zip o il comando jar del JDK per esaminarlo e riconfezionarlo; il riconfezionamento può invalidare le firme e modificare il comportamento dell'installazione.

Alcuni telefoni richiedono entrambi i file e verificano che i valori del JAD, i dati del manifest, le dimensioni del JAR, la versione e le informazioni sulla firma siano coerenti. Quando l'installazione segnala un errore relativo alle dimensioni, alla versione o alla sicurezza, procurati la coppia JAD/JAR originale invece di modificare i metadati alla cieca.