Crear un JAR ejecutable con dependencias incluidas en Java

21
20323

Este artículo me lo han pedido una gran cantidad de veces. Alguna vez escribí sobre como incluir dependencias dentro de un JAR, pero aquel método no me gusta. Tiende a fallar a veces.

Cuando escribí aquel artículo aún no sabía o no tenía la costumbre de utilizar Maven en mis proyectos. Maven es un gestor de repositorios, extremadamente útil, que hará de tu vida programando en Java una experiencia mucho más sencilla.

Veamos un ejemplo de por qué y para qué se debe utilizar Maven. Cuando se crea un proyecto en Maven, este se diferencia de un proyecto Java común y corriente por la construcción interna del árbol de proyectos. 

Diferencias entre un crear un proyecto Maven y un proyecto Java en Netbeans

Cuando se crea un proyecto en Maven, en la raíz se encuentra un archivo llamado pom.xml. En dicho archivo se establecen algunos parámetros básicos del proyecto, como el nombre, la versión, la clase principal, entre otros. También se establecen las dependencias y repositorios que se van a utilizar. Esta característica es especialmente útil, puesto que solo basta con escribir el nombre del repositorio o la dependencia que necesitas y Maven lo descargará e instalará automáticamente.

Por ejemplo, la librería PanamaHitek_Arduino puede ser descargada e instalada fácilmente agregando las solamente unas cuantas líneas de texto al archivo pom. Lo mismo aplica a casi cualquier repositorio de Java hoy por hoy.

Si queremos agregar la librería JFreeCharts, para hacer gráficas, agregamos lo siguiente al pom:

Maven es muy sencillo de utilizar. Facilita tu vida y te permite llevar un orden en los repositorios que utilizas.

Creando JAR ejecutable con Maven

Otra característica importante de Maven es la capacidad de crear ficheros JAR ejecutables a través de la inclusión de todas las dependencias dentro de un solo archivo. Para ello basta con agregar las siguientes instrucciones al archivo pom:

Solo basta con modificar las líneas de NOMBRE_DEL_PROYECTO y establecer correctamente la clase principal. Estas instrucciones deben agregarse al final del archivo pom.xml, justo antes de la etiqueta </project>. Luego de eso, solo basta con hacer click derecho en el proyecto y seleccionar «Clean and Build» en Netbeans. Al hacer la compilación, aparecerán 2 archivos JAR, uno sin dependencias y el otro con dependencias.

Por supuesto que el archivo con dependencias pesa mucho más que uno sin dependencias. La ventaja de esto es que se podrá ejecutar donde sea, en cualquier sistema operativo sin necesidad de estar creando carpetas y descargando ficheros.

Si quieren ver un ejemplo del uso de este método, les recomiendo el proyecto ArduinoSwitch, una sencilla aplicación para encender un LED en Arduino desde Java. Lo pueden encontrar en nuestro repositorio de Github.

Cuando  se descarga el proyecto y se compila, habrá dos archivos en la carpeta proyecto\ArduinoSwitch\Java\ArduinoSwitch\target. Estos son ArduinoSwitch.jarArduinoSwitch-jar-with-dependencies.jar.

JAR ejecutable con MAVEN
Resultado de aplicar el método descrito en este post

Espero que la información presentada sea de utilidad para ustedes. Cualquier comentario, duda o sugerencia me la hacen llegar a través de la caja de comentarios.

0 0 votes
Article Rating
Suscríbete
Notify of
guest

21 Comments
newest
oldest most voted
Inline Feedbacks
View all comments
Grobby
Grobby
5 months ago

Fiuu, me salvaste el semestre, muchas gracias por el aporte

Alex
Alex
1 year ago

Gracias por compartir esta info, me ayudo a resolver el problema que tenia de no tener mi jar con dependencias, funciono a la perfeccion tu guia. Mil gracias!!

Sergio Vivar
Sergio Vivar
1 year ago

Genial. Tenía tiempo buscando la manera de crear un jar ejecutable con dependencias incluidas con Maven y este dato me funcionó. Muchas gracias.

Rubén
Rubén
1 year ago

Muchísimas gracias por la info me sirvió de mucho c:

Juan B
Juan B
1 year ago

Hola, disculpen tengo una pregunta, NetBeans sí se me genera el .jar con dependencias incluidas, he abierto el .jar con winrar, y veo que las imágenes y las clases se encuentran dentro del .jar. Sin embargo, cuando lo quiero ejecutar sale el siguiente error: A Java exception has ocurred. En una ventana que tiene como título: Java Virtual Machine Loader. El detalle es que aplicación en netbeans se ejecuta bien, no se genera ningún error, solo cuando quiero abrir el ejecutable. Tengo el jdk y el jre 1.8. NetBeans 11.1. En el proyecto, en propiedades-> fuentes tengo 1.8 y UTF-8… Read more »

Juan B
Juan B
1 year ago
Reply to  Juan B

Hola a todos, solo para informar que ya encontré el problema, les pido una disculpa por disponer de su tiempo, lo que pasa es que a veces cuando estás cansado por más que el error esté en frente de ti no lo ves. En mi caso tenía varias horas revisando y no lo encontraba, hasta que sucumbí a la desesperación y quise preguntar xD. El problema obviamente estaba en las imágenes que agregué al proyecto. Estuvo de manera concreta en las ruta que hacía referencia una imagen, se me fue una diagonal «/» de más. El detalle era que esa… Read more »

Ricardo Rojo
Ricardo Rojo
1 year ago

Muchas Gracias!!!!

Darwiniq
Darwiniq
2 years ago

Muchas gracias por tu aporte, fue de utilidad.

Manuel
Manuel
2 years ago

Es mi primera vez trabajando con java with Maven y cuando intento ponerle un ícono a un label no me encuentra el path donde está la imágen que quiero poner como ícono. ¿Hay alguna forma especial de hacerlo? Ya busqué pero ninguna cosa me ha funcionado.

Juan C
Juan C
2 years ago

Buenas tardes, me surgió el mismo problema de Eduardo, NetBeans sí me genera los archivos .jar, pero cuando los ejecuto no me abre la aplicación. Luego de tratar de ejecutar el .jar, lo quiero volver a construir desde NetBeans pero me marca error porque el archivo está abierto, eso se soluciona cuando finalizo el proceso del .jar desde el administrador de tareas o reiniciando la pc. Traté de correrlo desde la ventana de comandos, pero no pasa nada, ni lo abre ni marca error, luego descargué el archivo de ejemplo de encender y apagar un led con arduino, y todo… Read more »

Juan C
Juan C
2 years ago

Hola, al parecer era un problema con una clase que descargué para ajustar automáticamente las dimensiones de las imágenes al tamaño de las etiquetas que las contenían. Cuando quité esa librería el .jar ya abrió. En lugar de la librería usé un método propio de la clase ImageIcon (no sabía que existía ese método) y funcionó, el .jar continuó abriendo sin problemas. El problema que surgió después es que cuando ejecuto el .jar las imágenes no las abre, a menos que ponga el .jar en la carpeta de source del proyecto de netBeans. Lo que yo hice fue guardar las… Read more »

Fénix Muñoz García
Fénix Muñoz García
3 years ago

Hola, me queda la duda de cómo establecer correctamente el nombre de la clase main ¿qué debo poner ahí? Disculpa si mi pregunta suena algo absurda, pero soy muy nuevo programando, soy químico no programador.
Gracias de antemano.

Fénix Muñoz García
Fénix Muñoz García
3 years ago

Va, eso ya salió, e, problema ahora es que si tengo conectado arduino me tira un error y crea un archivo .log, si lo ejecuto sin conectar el arduino se abre el programa, luego le conecto el arduino pero ya no ejecuta las órdenes que le di.

Eduardo
Eduardo
3 years ago

buenas noches,tengo un pequeña duda pues agrego todo como dices pero al crearme esos dos ficheros no se me abre la aplicacion, dime si tiene alguna otra sugerencia que aparte de eso deba agregar ,soy nuevo trabajando con maven,saludos y disculpe las molestias causadas