Převod souboru JAR do EXE

Uživatel Windows může potřebovat EXE, když je nutné Java application spouštět dvojitým kliknutím nebo ji distribuovat lidem, kteří nemají zkušenosti s příkazovým řádkem Java. Výsledkem je obvykle Windows launcher nebo installer, nikoli převod Java bytecode do nativního strojového kódu.

Co je formát JAR

JAR (Java Archive) je balíček založený na formátu ZIP, který obsahuje zkompilované soubory .class, dependency libraries, obrázky, konfigurační soubory a metadata. Java compilers, IDE, jako jsou IntelliJ IDEA a Eclipse, a build tools, jako jsou Maven a Gradle, vytvářejí soubory JAR.

Spustitelný JAR obsahuje v manifestu položku, například Main-Class: com.example.Main, a lze jej spustit pomocí java -jar app.jar. Počítač potřebuje kompatibilní Java runtime; JDK také poskytuje požadovaný runtime, zatímco samostatný JRE může být dostačující pro starší Java distributions. Některé JARy jsou libraries, nikoli applications, a nemají entry point ke spuštění.

Co je formát EXE

EXE je soubor Windows Portable Executable používaný pro applications, launchers, installers a services. EXE launcher může poskytovat spuštění dvojitým kliknutím, ikonu, informace o verzi Windows, zpracování příkazového řádku, kontroly verze Java a nastavení okna konzole.

Wrapper EXE stále spouští Java program prostřednictvím JVM. Application image nebo installer může obsahovat privátní Java runtime, takže uživatelé nemusí Java instalovat samostatně. Výstup zůstává specifický pro Windows a nespouští se nativně v macOS ani Linuxu.

Jak vytvořit EXE z JAR

Použití Launch4j pro odlehčený launcher

1. Nainstalujte Launch4j z oficiální distribuce projektu a nejprve ověřte application pomocí java -jar app.jar.
2. Otevřete Launch4j a nastavte Basic → Output file na cestu, například dist\MyApp.exe.
3. Nastavte Basic → Jar na app.jar. Pokud JAR nemá položku Main-Class v manifestu, zadejte entry point v části Basic → Main class.
4. V části JRE nastavte požadovaný rozsah verzí Java. Chcete-li distribuovat privátní runtime, nastavte JRE → Bundled JRE path na adresář, například runtime, a dodejte tento adresář vedle EXE.
5. Volitelně vyberte soubor .ico v části Header → Icon, přidejte informace o verzi a zvolte příslušný režim konzole.
6. Vytvořte EXE a otestujte jej v čistém systému Windows. Bez přibaleného runtime musí mít tento systém nainstalovaný kompatibilní Java runtime.

Launch4j vytváří launcher; neopravuje chybějící dependencies, nemění Java bytecode na nativní kód ani automaticky neposkytuje kompletní runtime. Relativní cesty a adresář s přibaleným runtime musí odpovídat rozložení dodanému uživatelům.

Použití jpackage pro samostatně fungující application

jpackage je součástí moderních vydání JDK a vytváří Windows application images a installers. Je vhodnější, když application má obsahovat vlastní runtime a installation metadata.

1. Sestavte a otestujte application, poté umístěte hlavní JAR a požadované dependency JARs do vstupního adresáře, například dist. Distribution task nástroje Maven nebo Gradle může tento adresář vytvořit.
2. Ověřte hlavní class. Pokud je k dispozici, použijte položku v manifestu, nebo ji zadejte explicitně pomocí --main-class.
3. Packaging spusťte v systému Windows. Typy installerů, jako jsou exe a msi, vyžadují prerequisites pro Windows packaging podporované danou verzí JDK, obvykle WiX; application image nástroj pro instalaci nevyžaduje.
4. Spusťte příkaz podobný tomuto:
   jpackage --type exe --input dist --name MyApp --main-jar app.jar --main-class com.example.Main --dest release --win-shortcut --win-menu
5. Pro ikonu použijte --icon app.ico a pro zobrazenou verzi --app-version 1.0.0. Otestujte instalaci i spuštění na počítači s Windows bez vývojového JDK.

Pro portable application directory namísto installeru použijte --type app-image. Výsledný image obsahuje privátní runtime a je obvykle mnohem větší než wrapper Launch4j.

Omezení kompatibility a kvality

• Application potřebuje platný entry point, všechny required dependencies a kompatibilní Java modules. Launcher nedokáže opravit chybějící classes, neplatné cesty k resources ani nekompatibilní verzi Java.
• Testujte s vydáním Java a CPU architecture určenými pro uživatele. JNI nebo jiné native libraries mohou vyžadovat samostatné 32bitové a 64bitové buildy a Windows-specific binaries.
• Přibalení runtime zvětšuje velikost distribuce, ale odstraňuje závislost na samostatně nainstalovaném Java runtime. Před redistribucí ověřte licenci dodavatele runtime a jeho zásady bezpečnostních aktualizací.
• Nově sestavené nepodepsané EXE a installers mohou vyvolat Microsoft Defender nebo jiná bezpečnostní upozornění. Podepsání launcheru a installeru kódem pomocí vhodného certificate počet upozornění snižuje, ale nezaručuje, že se neobjeví.
• Pro skutečně nativní executable namísto JVM launcheru použijte nástroj, jako je GraalVM Native Image, pokud jej application podporuje. Reflection, dynamic class loading, JNI a některé features frameworku mohou vyžadovat konfiguraci nebo nemusí fungovat.

Online conversion services

Neexistuje spolehlivá obecná online service, která by z nahraného JAR dokázala odvodit entry point Java application, dependencies, runtime, native libraries a požadavky na Windows packaging. Archive-conversion sites mohou JAR přejmenovat nebo rozbalit, ale tím nevytvoří funkční EXE. Pro proprietary nebo executable software používejte local tools, jako jsou Launch4j nebo jpackage; nahrání JAR může také odhalit source, embedded credentials nebo jiná důvěrná data.