Converti JAR in APK

Un dispositivo Android, un emulatore o un sistema di distribuzione aziendale può richiedere un .apk installabile quando il software disponibile è un .jar Java. Di solito si tratta di un'attività di porting e build Android, non di una modifica dell'estensione del file.

Cosa contiene un file JAR

Un JAR (Java Archive) è un contenitore basato su ZIP utilizzato dagli sviluppatori Java per librerie, applicazioni desktop, strumenti da riga di comando e alcuni software Java ME meno recenti. Normalmente contiene file Java .class, risorse e metadati in META-INF; Maven, Gradle, Eclipse, IntelliJ IDEA e lo strumento jar del JDK producono comunemente file JAR.

Un JAR desktop eseguibile dichiara spesso una Main-Class in META-INF/MANIFEST.MF e si avvia tramite un runtime Java standard. Un JAR di libreria fornisce codice riutilizzabile senza un punto di ingresso dell'applicazione. Nessuno dei due tipi fornisce intrinsecamente componenti Android, risorse Android, un AndroidManifest.xml utilizzabile o una configurazione di firma Android.

Cosa contiene un file APK

Un APK è un pacchetto applicativo Android. Contiene bytecode DEX per Android Runtime (ART), un manifest Android, risorse compilate, librerie native opzionali e firme del pacchetto.

I suoi vantaggi pratici consistono nel fatto che Android può installarlo direttamente, verificare il relativo certificato di firma e identificare le attività, i servizi, le autorizzazioni dichiarate e i dispositivi supportati. Per le nuove pubblicazioni pubbliche su Google Play, utilizza invece un Android App Bundle (.aab); Google Play genera APK specifici per dispositivo a partire dal bundle.

Controlla il JAR prima di tentare una build

Con un JDK installato, elenca i contenuti dell'archivio:

jar tf input.jar

Cerca META-INF/MANIFEST.MF, le directory dei package Java, le risorse e le dipendenze. Un JAR che utilizza Swing, AWT, JavaFX, un metodo main() desktop, percorsi di file locali senza restrizioni o librerie desktop specifiche della piattaforma non può essere trasformato in un'app Android funzionante semplicemente riconfezionandolo.

Un JAR che è solo una libreria generica può essere utilizzabile in un progetto Android. Un'applicazione desktop completa normalmente richiede che il relativo codice sorgente venga adattato per Android.

Creare un APK Android dal codice sorgente

1. Installa Android Studio e installa la piattaforma SDK richiesta tramite Tools → SDK Manager.
2. Crea un progetto Android tramite File → New → New Project. Seleziona Java se il codice esistente è Java; è supportato anche Kotlin, ma non è necessario per la migrazione.
3. Sposta il codice Java riutilizzabile nel modulo dell'app, generalmente in app/src/main/java. Sostituisci un punto di ingresso desktop main() con un'istanza di Activity, un servizio, un receiver o un altro componente Android dichiarato.
4. Sostituisci il codice dell'interfaccia utente desktop con viste Android, layout o Jetpack Compose; Android non fornisce Swing, AWT o JavaFX come fa un runtime Java desktop.
5. Adatta l'archiviazione, il networking, le notifiche, le attività in background e le autorizzazioni alle API Android. Ad esempio, l'accesso alla rete richiede <uses-permission android:name="android.permission.INTERNET" /> nel manifest del progetto.
6. Imposta l'ID dell'applicazione, la versione SDK minima, la versione SDK di destinazione, le icone, le risorse e i componenti del manifest. Esegui i test su un emulatore e su dispositivi reali con le versioni Android supportate.
7. Crea un APK di debug con ./gradlew assembleDebug su macOS/Linux o gradlew.bat assembleDebug su Windows. L'output abituale è app/build/outputs/apk/debug/app-debug.apk.
8. Crea un APK di release da Build → Generate Signed Bundle / APK → APK. Firmalo con un keystore sotto il tuo controllo e conserva il keystore, l'alias e le password.

Utilizzare un JAR compatibile come libreria

Copia un JAR di libreria in app/libs e aggiungilo alle dipendenze Gradle del modulo dell'app:

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

Android Gradle Plugin converte i file di classe Java compatibili in DEX durante la build. Aggiungi separatamente le dipendenze di terze parti richieste tramite Gradle; non presumere che ogni dipendenza utilizzata dal JAR originale sia incorporata in esso o funzioni su Android.

File JAR Java ME e convertitori online

I giochi e le applicazioni Java ME meno recenti utilizzano comunemente un .jar insieme a un descrittore .jad opzionale. J2ME Loader può eseguirne molti tramite emulazione, ma non converte il programma originale in un APK nativo autonomo. Una versione Android nativa richiede il codice sorgente e una riscrittura per Android.

Nessun servizio online affidabile può convertire in modo consistente un JAR arbitrario in un APK funzionale, perché i punti di ingresso Android, l'interfaccia utente, le autorizzazioni, le dipendenze e le sostituzioni delle API sono specifici dell'applicazione. Evita i convertitori “one-click” basati sul caricamento di file, soprattutto per il codice proprietario; non possono creare in sicurezza un'app manutenibile né consentire di mantenere il controllo esclusivo della chiave di firma della release.

Limiti di compatibilità e release

ART esegue DEX, non normali file di classe JVM. D8 può tradurre bytecode compatibile, ma non rende disponibili su Android le API desktop di Java SE. I JAR compilati per una versione di file di classe Java non supportata potrebbero dover essere ricreati dal codice sorgente; alcune funzionalità del linguaggio e alcune librerie richiedono il desugaring Android o sostituzioni specifiche per Android.

La reflection, le classi caricate dinamicamente, la riduzione del codice, le librerie native e le architetture CPU specifiche del dispositivo richiedono una configurazione esplicita della build e attività di test. Il codice decompilato può talvolta aiutare a recuperare un progetto perduto, ma potrebbe essere incompleto, difficile da manutenere e soggetto a limitazioni imposte dalla licenza software.

Un'app installata può essere aggiornata solo con lo stesso ID applicazione e la stessa chiave di firma. La modifica di uno dei due fa sì che Android consideri l'APK un'applicazione diversa anziché un aggiornamento.