Converti JAR in EXE

Un utente Windows potrebbe aver bisogno di un EXE quando un'applicazione Java deve essere avviata con un doppio clic o distribuita a persone che non hanno esperienza con la riga di comando di Java. Il risultato è solitamente un launcher o un installer per Windows, non una conversione del bytecode Java in codice macchina nativo.

Che cos'è il formato JAR

Un JAR (Java Archive) è un pacchetto basato su ZIP che contiene file .class compilati, librerie di dipendenze, immagini, file di configurazione e metadati. I compilatori Java, gli IDE come IntelliJ IDEA ed Eclipse e gli strumenti di build come Maven e Gradle creano file JAR.

Un JAR eseguibile contiene una voce nel manifest come Main-Class: com.example.Main e può essere avviato con java -jar app.jar. Il computer necessita di un runtime Java compatibile; anche un JDK fornisce il runtime richiesto, mentre un JRE autonomo può essere sufficiente per le distribuzioni Java più datate. Alcuni JAR sono librerie anziché applicazioni e non dispongono di un punto di ingresso da avviare.

Che cos'è il formato EXE

Un EXE è un file Windows Portable Executable utilizzato per applicazioni, launcher, installer e servizi. Un launcher EXE può fornire l'avvio con doppio clic, un'icona, informazioni sulla versione di Windows, la gestione della riga di comando, controlli della versione di Java e un'impostazione per la finestra della console.

Un wrapper EXE avvia comunque il programma Java tramite una JVM. Un'immagine dell'applicazione o un installer può includere un runtime Java privato, così gli utenti non devono installare Java separatamente. L'output rimane specifico per Windows e non viene eseguito nativamente su macOS o Linux.

Come creare un EXE da un JAR

Utilizzare Launch4j per un launcher leggero

1. Installare Launch4j dalla distribuzione ufficiale del progetto e verificare prima l'applicazione con java -jar app.jar.
2. Aprire Launch4j e impostare Basic → Output file su un percorso come dist\MyApp.exe.
3. Impostare Basic → Jar su app.jar. Se il JAR non contiene una voce Main-Class nel manifest, specificare il punto di ingresso in Basic → Main class.
4. Nella sezione JRE, impostare l'intervallo di versioni Java richiesto. Per distribuire un runtime privato, impostare JRE → Bundled JRE path su una directory come runtime e distribuire tale directory accanto all'EXE.
5. Facoltativamente, scegliere un file .ico nella sezione Header → Icon, aggiungere le informazioni sulla versione e selezionare la modalità console appropriata.
6. Creare l'EXE e testarlo su un sistema Windows pulito. Senza un runtime incluso, il sistema deve avere installato un runtime Java compatibile.

Launch4j crea un launcher; non corregge le dipendenze mancanti, non converte il bytecode Java in codice nativo e non fornisce automaticamente un runtime completo. I percorsi relativi e la directory del runtime incluso devono corrispondere alla struttura distribuita agli utenti.

Utilizzare jpackage per un'applicazione autonoma

jpackage è incluso nelle versioni moderne del JDK e crea immagini di applicazioni e installer per Windows. È preferibile quando l'applicazione deve includere il proprio runtime e i metadati di installazione.

1. Creare e testare l'applicazione, quindi inserire il JAR principale e i JAR delle dipendenze richieste in una directory di input come dist. Un'attività di distribuzione Maven o Gradle può produrre questa directory.
2. Confermare la classe principale. Utilizzare la voce del manifest quando presente oppure fornirla esplicitamente con --main-class.
3. Eseguire il packaging su Windows. I tipi di installer come exe e msi richiedono i prerequisiti di packaging Windows supportati dalla versione del JDK, comunemente WiX; un'immagine dell'applicazione non richiede uno strumento per installer.
4. Eseguire un comando simile a:
   jpackage --type exe --input dist --name MyApp --main-jar app.jar --main-class com.example.Main --dest release --win-shortcut --win-menu
5. Utilizzare --icon app.ico per un'icona e --app-version 1.0.0 per la versione visualizzata. Testare sia l'installazione sia l'avvio su un computer Windows privo del JDK di sviluppo.

Per una directory dell'applicazione portatile anziché un installer, utilizzare --type app-image. L'immagine risultante include un runtime privato ed è normalmente molto più grande di un wrapper Launch4j.

Limitazioni di compatibilità e qualità

• L'applicazione necessita di un punto di ingresso valido, di tutte le dipendenze richieste e di moduli Java compatibili. Un launcher non può correggere classi mancanti, percorsi di risorse non validi o una versione Java incompatibile.
• Testare con la versione Java e l'architettura della CPU previste per gli utenti. Le librerie JNI o altre librerie native potrebbero richiedere build separate a 32 e 64 bit e binari specifici per Windows.
• L'inclusione di un runtime aumenta le dimensioni della distribuzione, ma elimina la dipendenza da un runtime Java installato separatamente. Verificare la licenza del fornitore del runtime e la relativa politica sugli aggiornamenti di sicurezza prima della ridistribuzione.
• Gli EXE e gli installer appena creati e non firmati potrebbero attivare Microsoft Defender o altri avvisi di sicurezza. La firma del launcher e dell'installer con un certificato appropriato riduce gli avvisi, ma non garantisce che siano assenti.
• Per un eseguibile realmente nativo anziché un launcher JVM, utilizzare uno strumento come GraalVM Native Image quando l'applicazione lo supporta. Reflection, caricamento dinamico delle classi, JNI e alcune funzionalità dei framework potrebbero richiedere una configurazione o potrebbero non funzionare.

Servizi di conversione online

Non esiste un servizio online generico affidabile in grado di dedurre da un JAR caricato il punto di ingresso, le dipendenze, il runtime, le librerie native e i requisiti di packaging Windows di un'applicazione Java. I siti di conversione degli archivi potrebbero rinominare o decomprimere un JAR, ma questo non crea un EXE funzionante. Utilizzare strumenti locali come Launch4j o jpackage per software proprietario o eseguibile; il caricamento del JAR potrebbe inoltre esporre il codice sorgente, credenziali incorporate o altri dati riservati.