Pausa caffè #148. Come trasformare qualsiasi programma Java in un file EXE autonomo

Fonte: Mccue.dev Oggi imparerai come creare un file EXE eseguibile da un programma Java per eseguirlo sul sistema operativo Windows. Fare doppio clic per avviare è uno dei modi più semplici per aprire un programma. Se la persona a cui desideri mostrare la tua applicazione ha già installata la versione corretta di Java, può fare doppio clic sul file jar per eseguirlo. Se non è installato Java, ci sono modi per creare un programma di installazione eseguibile, come jpackage . Successivamente, per eseguire il codice devi solo fare clic su questo programma di installazione. Puoi anche utilizzare Native Image per trasformare il codice in un file eseguibile che non richiede alcuna installazione aggiuntiva. In questo articolo ci concentreremo su un approccio abbastanza semplice che funziona per qualsiasi applicazione, indipendentemente dalle dipendenze incluse o dalle funzionalità JVM utilizzate. Il codice di cui parleremo oggi può essere trovato nel repository GitHub e i file eseguibili con il programma sono pubblicati qui .

Pila usata

Java9+

Esperto di

NodoJS

Passaggio 1: compila e impacchetta il tuo codice in un jar

Questo programma di base creerà una semplice finestra con testo che potrai modificare facendo clic su uno dei pulsanti dell'interfaccia.

package example;

import org.apache.commons.text.WordUtils;

import javax.swing.*;
import java.awt.*;

public class Main {
    public static void main(String[] args) {
        var label = new JLabel("Hello, World!");
        label.setFont(new Font("Serif", Font.PLAIN, 72));

        var uppercaseButton = new JButton("Uppercase");
        uppercaseButton.addActionListener(e ->
            label.setText(WordUtils.capitalize(label.getText()))
        );

        var lowercaseButton = new JButton("lowercase");
        lowercaseButton.addActionListener(e ->
            label.setText(WordUtils.uncapitalize(label.getText()))
        );

        var panel = new JPanel();
        panel.setLayout(new BoxLayout(panel, BoxLayout.Y_AXIS));
        panel.add(label);
        panel.add(uppercaseButton);
        panel.add(lowercaseButton);

        var frame = new JFrame("Basic Program");
        frame.add(panel);
        frame.pack();
        frame.setVisible(true);
        frame.setDefaultCloseOperation(WindowConstants.EXIT_ON_CLOSE);
    }
}

Il nostro obiettivo ora è impacchettare il codice insieme alle sue dipendenze in un jar. I file JAR sono normali archivi ZIP con poca struttura aggiuntiva. Per un progetto Maven la configurazione sarà simile a questa. Qui il plugin "shade" gestirà l'inclusione del codice da tutte le tue dipendenze nel jar. In questo caso, l'unica dipendenza esterna è org.apache.commons/commons-text . Sposteremo quindi questo file jar in una nuova directory target/ dove sarà separato dagli altri file.

Passaggio 2: creare un Java Runtime Environment (JRE)

Per eseguire il file jar che abbiamo già creato, dobbiamo collegarlo all'ambiente runtime Java. Per questo useremo jlink . Poiché l'ecosistema Java non utilizza moduli, probabilmente non ne hai sentito parlare o non hai utilizzato jlink. In breve, jlink può creare “immagini eseguibili personalizzate”. Ad esempio, stai creando un server web. Non hai bisogno di AWT o Swing, quindi includerli nel tuo codice sarà ridondante. Con jlink puoi creare un JRE che non includa affatto il modulo java.desktop . Questo sistema funziona meglio se la tua applicazione e tutte le sue dipendenze includono file module-info.java compilati , che indicano a jlink esattamente quali moduli desideri includere. Puoi anche definire manualmente l'elenco dei moduli richiesti utilizzando jdeps . E anche senza un progetto modulare, possiamo clonare efficacemente la nostra installazione Java in una directory utilizzando jlink. Includere ciascun modulo individualmente garantisce che le librerie come org.apache.commons/commons-text funzioneranno come previsto. Dobbiamo solo capire di quali moduli abbiamo bisogno.

Passaggio 3: combinare Jar e JRE in un eseguibile

Avendo un file jar contenente il codice e tutte le sue dipendenze, oltre al JRE, non resta che combinarli. Per fare ciò dobbiamo fare quanto segue:

1. Comprimi la directory contenente JRE e jar della tua applicazione.
2. Allega uno script stub all'inizio di questo file zip, che estrarrà i dati in una directory temporanea ed eseguirà il codice.

Esiste una libreria JavaScript per questo chiamata caxa . Il suo scopo è trasformare i progetti NodeJS in eseguibili e può anche raggruppare qualsiasi installazione NodeJS sul sistema. Fortunatamente, puoi saltare questo passaggio specificando il flag --no-include-node . Questo creerà un file eseguibile denominato "applicazione". Se lo stai creando per Windows, devi specificare "application.exe". Quando l'eseguibile viene eseguito, {{caxa}} verrà sostituito con la directory temporanea in cui è stato distribuito il file zip. Tieni presente che durante la creazione di file eseguibili vengono utilizzati anche meccanismi come la firma del codice e gli aggiornamenti automatici. Tuttavia, queste cose richiedono uno studio più approfondito, che è difficile da inserire in un’unica pubblicazione.