Converti APK in JAD

Cos’è il formato APK

APK è il formato di pacchetto installabile per le applicazioni Android, prodotto da Android Studio, Gradle e dagli strumenti di packaging Android. Le distribuzioni Android possono fornire un singolo APK o più split APK; le build degli sviluppatori, i backup dei dispositivi e i repository di terze parti contengono comunemente file APK.

Un APK è un contenitore basato su ZIP che normalmente include un AndroidManifest.xml compilato o binario, bytecode Dalvik/ART in classes.dex, risorse, librerie native e informazioni sulla firma. Android utilizza il manifest, il codice DEX, le risorse e le API del framework per installare ed eseguire l’applicazione.

Cos’è il formato JAD

JAD è un Java Application Descriptor in testo semplice utilizzato dai telefoni e dagli emulatori Java ME. Descrive un’applicazione Java ME JAR separata e contiene comunemente MIDlet-Name, MIDlet-Version, MIDlet-Vendor, MIDlet-1, MicroEdition-Configuration, MicroEdition-Profile, MIDlet-Jar-URL e MIDlet-Jar-Size.

Il JAR contiene file di classe e risorse Java ME; il JAD fornisce i metadati di installazione e identifica tale JAR. Un JAD non è un’applicazione eseguibile e non può funzionare senza codice Java ME compatibile.

Perché la conversione diretta non funziona

Non esiste una vera conversione da APK a JAD. Android utilizza bytecode DEX, API del framework Android, componenti delle applicazioni Android e il runtime Dalvik/ART. Java ME utilizza file di classe Java, API CLDC/MIDP e il ciclo di vita dei MIDlet. Un descrittore non può tradurre bytecode, layout Android, autorizzazioni, librerie native o dipendenze del framework tra queste piattaforme.

Rinominare app.apk in app.jad, estrarre il contenuto dell’APK in un JAR o copiare i valori del manifest Android in un JAD crea un pacchetto Java ME non valido o non funzionante. Nessun convertitore online affidabile può trasformare un’applicazione Android in un MIDlet funzionante; i servizi che dichiarano di farlo generalmente rinominano, estraggono o reimpacchettano i file senza tradurre il programma.

Come creare un JAD da un JAR Java ME esistente

Questa procedura si applica solo quando si dispone già di un JAR Java ME valido, incluso uno che potrebbe essere contenuto in un APK. Un JAR qualsiasi all’interno di un APK non è automaticamente un’applicazione Java ME; verificare la presenza di classi MIDlet e degli attributi del manifest Java ME.

1. Esaminare l’APK con 7-Zip o con gli strumenti della piattaforma Android. Su un sistema dotato di unzip, elencarne i contenuti con unzip -l app.apk ed estrarli con unzip app.apk -d app_unpacked. L’estrazione non converte il codice Android.
2. Utilizzare Apktool quando è necessario esaminare le risorse Android, il manifest o il codice DEX disassemblato: apktool d app.apk -o app_decoded. Apktool decodifica i file Android e produce smali, ma non produce un JAR o un JAD Java ME.
3. Se è presente un JAR Java ME adatto, utilizzare un’apposita utility locale da JAR a JAD come JADMaker, oppure creare manualmente il descrittore in un editor di testo semplice. Anche gli strumenti di packaging di Java ME SDK o Wireless Toolkit possono generare descrittori come parte di una build Java ME.
4. Per la creazione manuale, salvare un file di testo accanto al JAR con lo stesso nome di base, ad esempio example.jad accanto a 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

Sostituire i valori di esempio con i metadati supportati dal JAR. La classe indicata in MIDlet-1 deve esistere nel JAR e implementare il punto di ingresso MIDlet richiesto. MIDlet-Jar-Size deve corrispondere alla dimensione esatta del JAR in byte, senza separatori. L’URL può essere un nome file locale per il sideloading oppure un URL di un server per l’installazione tramite rete.

Un generatore online da JAR a JAD è accettabile solo per un JAR Java ME valido e non sensibile; non può convertire un APK. Un generatore desktop è più sicuro per i file firmati o proprietari, perché il caricamento dell’archivio ne espone i contenuti. Verificare i campi generati e la dimensione del JAR prima di trasferire entrambi i file sul telefono o sull’emulatore.

Limitazioni di compatibilità

Un APK Android può richiedere versioni del framework Android, autorizzazioni, servizi Google, librerie native, funzionalità touchscreen o hardware che non hanno equivalenti in Java ME. Anche la decompilazione del codice sorgente non produrrebbe un MIDlet portabile senza una riscrittura sostanziale basata sulle API CLDC/MIDP e una nuova build Java ME.

Per l’installazione o l’archiviazione Android, conservare l’APK originale firmato o tutti gli split APK richiesti. Per un dispositivo Java ME, ottenere la versione originale corrispondente JAR/JAD o un porting Java ME sviluppato separatamente; il solo descrittore generato non può rendere l’applicazione Android compatibile.