Convertir JS a JAR

Un dispositivo o programa basado en Java puede requerir un paquete .jar, mientras que el código fuente disponible es un archivo JavaScript .js. La solución correcta depende de si solo necesita archivar el script o si necesita reescribirlo y ejecutarlo mediante un motor JavaScript compatible con Java.

Qué es el formato JS

Un archivo .js normalmente contiene código fuente JavaScript utilizado por navegadores web, Node.js, Electron, aplicaciones de Adobe, sistemas de compilación o Windows Script Host. JavaScript se ejecuta en un motor como V8, SpiderMonkey, JavaScriptCore o GraalJS.

JavaScript y Java son lenguajes diferentes. Cambiar .js por .jar, cambiar el nombre del archivo o colocarlo en un archivo ZIP no lo compila en archivos de clase Java. Los scripts de navegador también pueden depender de API como document y window, mientras que los scripts de Node.js pueden depender de require, paquetes de npm o API específicas de Node.

Qué es el formato JAR

Un JAR, o Java ARchive, es un paquete basado en ZIP para archivos de clase Java, bibliotecas, recursos y metadatos. Las aplicaciones y bibliotecas Java utilizan JAR porque agrupan muchos archivos en un único paquete distribuible, admiten compresión y pueden incluir un manifiesto en META-INF/MANIFEST.MF. Los JAR también pueden firmarse para garantizar la integridad y verificar al editor.

Un JAR puede contener JavaScript como un recurso ordinario, pero un JAR que solo contiene un script no es ejecutable automáticamente. Un JAR ejecutable necesita una clase de entrada Java compilada y una entrada de manifiesto como Main-Class; esa clase debe iniciar o interpretar el JavaScript.

Empaquetar el archivo JS en un JAR

Utilice la utilidad jar incluida con un JDK cuando el requisito sea simplemente un archivo JAR que contenga el script original.

1. Instale un JDK como Eclipse Temurin, Oracle JDK u otra distribución compatible; un JRE por sí solo no proporciona las herramientas normales de empaquetado.
2. Coloque script.js y sus recursos en un directorio del proyecto, conservando las rutas a las que hace referencia el script.
3. Abra un terminal en el directorio del proyecto y ejecute jar --create --file app.jar script.js. Añada directorios o archivos según sea necesario, por ejemplo jar --create --file app.jar script.js lib config.
4. Compruebe el archivo con jar --list --file app.jar.

En versiones antiguas del JDK, el comando equivalente es jar cf app.jar script.js. Este proceso conserva el código fuente JavaScript y lo empaqueta; no hace que java -jar app.jar ejecute el script.

Crear un envoltorio Java ejecutable

Para distribuir una aplicación Java que ejecute el script, cree un proyecto Java con una clase de inicio. La clase de inicio carga script.js desde el JAR, crea un contexto del motor JavaScript, proporciona los argumentos u objetos del host necesarios y evalúa el script.

GraalJS puede integrarse mediante la API GraalVM Polyglot y sus dependencias Java. Añada las dependencias necesarias del SDK de GraalVM y del motor JavaScript mediante Maven o Gradle, escriba la clase de inicio, compílela y empaquete la clase de inicio, el script, los recursos y las dependencias. La configuración de GraalJS varía según la versión de GraalVM y de las dependencias, por lo que debe utilizar las versiones de dependencias compatibles con el runtime seleccionado en lugar de copiar un ejemplo obsoleto de Nashorn.

Nashorn se eliminó de las distribuciones estándar del JDK a partir de JDK 15. El código que depende de Nashorn debe utilizar una distribución de compatibilidad mantenida por separado o migrarse a otro motor; un JDK actual normalmente no incluye Nashorn.

En IntelliJ IDEA, una opción habitual de empaquetado de escritorio es File → Project Structure → Artifacts → JAR → From modules with dependencies. Seleccione la clase de inicio como clase principal, elija si las dependencias deben extraerse en un fat JAR o mantenerse junto a la aplicación y compile el artefacto. Una compilación con Maven o Gradle suele ser más reproducible en proyectos con muchas dependencias. Ejecute un paquete configurado correctamente con java -jar app.jar.

Si el archivo original es una aplicación Node.js, normalmente la opción técnicamente correcta es mantenerlo como un proyecto de Node.js. Un envoltorio Java puede iniciar node como un proceso externo, pero el sistema de destino aún necesita Node.js y el resultado no es una conversión a bytecode Java.

Opciones en línea y de escritorio

No existe un convertidor en línea fiable que traduzca de forma confiable JavaScript arbitrario a clases Java equivalentes o a un JAR ejecutable autónomo. Las herramientas de archivado en línea a veces pueden crear un paquete similar a ZIP, pero no pueden inferir un punto de entrada Java, instalar un motor JavaScript, resolver dependencias de npm o del navegador ni probar el comportamiento en tiempo de ejecución.

Para un archivo individual no sensible, un creador de ZIP en línea puede utilizarse únicamente si el destinatario acepta un archivo normal y usted verifica su contenido posteriormente; cambiar el nombre de un .zip descargado a .jar no sustituye a su creación con el JDK. Utilice el comando local jar del JDK, IntelliJ IDEA, Maven o Gradle para código fuente y proyectos con varios archivos, y no cargue scripts propietarios en un servicio en línea.

Comprobaciones de compatibilidad

Pruebe el script en el runtime exacto previsto para el JAR. Las variables globales del navegador no existen en Node.js ni en GraalJS, los módulos de Node.js no funcionan automáticamente en GraalJS y el acceso al host Java puede requerir una configuración explícita. Confirme las rutas relativas, los permisos de archivo, la codificación de caracteres, las bibliotecas nativas, el acceso a la red, las variables de entorno y todas las dependencias de terceros.

Un JAR que solo contiene script.js es un archivo. Un paquete ejecutable requiere una clase de inicio Java, un motor JavaScript compatible, una entrada de manifiesto Main-Class válida y una distribución de dependencias que funcione en el JDK de destino.