Convertir JAR a EXE

Un usuario de Windows puede necesitar un EXE cuando una aplicación Java debe iniciarse mediante doble clic o distribuirse a personas que no tienen experiencia con la línea de comandos de Java. El resultado suele ser un lanzador o instalador de Windows, no una conversión del bytecode de Java a código máquina nativo.

Qué es el formato JAR

Un JAR (Java Archive) es un paquete basado en ZIP que contiene archivos .class compilados, bibliotecas de dependencias, imágenes, archivos de configuración y metadatos. Los compiladores de Java, IDE como IntelliJ IDEA y Eclipse, y herramientas de compilación como Maven y Gradle crean archivos JAR.

Un JAR ejecutable tiene una entrada de manifest como Main-Class: com.example.Main y puede iniciarse con java -jar app.jar. El equipo necesita un runtime de Java compatible; un JDK también proporciona el runtime necesario, mientras que un JRE independiente puede ser suficiente para distribuciones antiguas de Java. Algunos JAR son bibliotecas en lugar de aplicaciones y no tienen un punto de entrada para iniciarse.

Qué es el formato EXE

Un EXE es un archivo Windows Portable Executable utilizado para aplicaciones, lanzadores, instaladores y servicios. Un lanzador EXE puede proporcionar inicio mediante doble clic, un icono, información de versión de Windows, gestión de la línea de comandos, comprobaciones de versión de Java y una configuración de la ventana de consola.

Un EXE wrapper sigue iniciando el programa Java mediante una JVM. Una imagen de aplicación o un instalador puede incluir un runtime de Java privado, por lo que los usuarios no necesitan instalar Java por separado. El resultado sigue siendo específico de Windows y no se ejecuta de forma nativa en macOS o Linux.

Cómo crear un EXE a partir de un JAR

Usar Launch4j para un lanzador ligero

1. Instala Launch4j desde la distribución oficial del proyecto y verifica primero la aplicación con java -jar app.jar.
2. Abre Launch4j y establece Basic → Output file en una ruta como dist\MyApp.exe.
3. Establece Basic → Jar en app.jar. Si el JAR no tiene una entrada Main-Class en el manifest, especifica el punto de entrada en Basic → Main class.
4. En JRE, establece el intervalo de versiones de Java requerido. Para distribuir un runtime privado, establece JRE → Bundled JRE path en un directorio como runtime y entrega ese directorio junto al EXE.
5. Opcionalmente, selecciona un archivo .ico en Header → Icon, añade información de versión y selecciona el modo de consola adecuado.
6. Compila el EXE y pruébalo en un sistema Windows limpio. Sin un runtime incluido, ese sistema debe tener instalado un runtime de Java compatible.

Launch4j crea un lanzador; no corrige las dependencias que faltan, no convierte el bytecode de Java en código nativo ni proporciona automáticamente un runtime completo. Las rutas relativas y el directorio del runtime incluido deben coincidir con la estructura entregada a los usuarios.

Usar jpackage para una aplicación autónoma

jpackage se incluye con las versiones modernas de JDK y crea imágenes de aplicaciones e instaladores de Windows. Es preferible cuando la aplicación debe incluir su propio runtime y metadatos de instalación.

1. Compila y prueba la aplicación; después, coloca el JAR principal y los JAR de dependencias necesarios en un directorio de entrada como dist. Una tarea de distribución de Maven o Gradle puede producir este directorio.
2. Confirma la clase principal. Utiliza la entrada del manifest cuando esté presente o proporciónala explícitamente con --main-class.
3. Ejecuta el empaquetado en Windows. Los tipos de instalador como exe y msi requieren los prerrequisitos de empaquetado de Windows compatibles con la versión de JDK, normalmente WiX; una imagen de aplicación no requiere una herramienta de instalación.
4. Ejecuta un comando similar a:
   jpackage --type exe --input dist --name MyApp --main-jar app.jar --main-class com.example.Main --dest release --win-shortcut --win-menu
5. Usa --icon app.ico para un icono y --app-version 1.0.0 para la versión mostrada. Prueba tanto la instalación como el inicio en un equipo Windows sin el JDK de desarrollo.

Para obtener un directorio de aplicación portable en lugar de un instalador, usa --type app-image. La imagen resultante incluye un runtime privado y normalmente es mucho más grande que un wrapper de Launch4j.

Limitaciones de compatibilidad y calidad

• La aplicación necesita un punto de entrada válido, todas las dependencias requeridas y módulos de Java compatibles. Un lanzador no puede corregir clases faltantes, rutas de recursos no válidas ni una versión incompatible de Java.
• Prueba con la versión de Java y la arquitectura de CPU destinadas a los usuarios. JNI u otras bibliotecas nativas pueden requerir compilaciones independientes de 32 y 64 bits, así como binarios específicos de Windows.
• Incluir un runtime aumenta el tamaño de la distribución, pero elimina la dependencia de un runtime de Java instalado por separado. Comprueba la licencia del proveedor del runtime y su política de actualizaciones de seguridad antes de redistribuirlo.
• Los EXE e instaladores recién compilados que no estén firmados pueden activar Microsoft Defender u otras advertencias de seguridad. Firmar digitalmente el lanzador y el instalador con un certificado apropiado reduce las advertencias, pero no garantiza que desaparezcan.
• Para obtener un ejecutable realmente nativo en lugar de un lanzador de JVM, utiliza una herramienta como GraalVM Native Image cuando la aplicación lo admita. La reflexión, la carga dinámica de clases, JNI y algunas funciones de los frameworks pueden requerir configuración o no funcionar.

Servicios de conversión en línea

No existe un servicio genérico de confianza en línea que pueda inferir el punto de entrada, las dependencias, el runtime, las bibliotecas nativas y los requisitos de empaquetado de Windows de una aplicación Java a partir de un JAR subido. Los sitios de conversión de archivos pueden cambiar el nombre de un JAR o desempaquetarlo, pero eso no crea un EXE funcional. Utiliza herramientas locales como Launch4j o jpackage para software propietario o ejecutable; subir el JAR también puede exponer código fuente, credenciales integradas u otros datos confidenciales.