Crear un JAR ejecutable con dependencias incluidas en Java

9
11610

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.

9 Comentarios

  1. 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 funcionó a la perfección, el .jar lo ejecuta y lo abre bien, estuve comparando los dos proyectos (el de arduino y el mío) y no encuentro diferencias, en mi proyecto ya también tengo declarada la clase principal y todo, alguien sabe que pueda ser?

    Nota: pasa los mismo cuando intento crear los archivos .jar de otros proyectos hechos con java sin maven. Se crea el .jar pero no se abre la aplicación.
    Gracias por su tiempo.

    • Posiblemente es porque tienes que establecer el nombre de la clase principal para que Java sepa que fichero debe ejecutar al principio del tiempo de ejecución

      • 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 imágenes que utilicé dentro de un paquete llamado Imagenes en el proyecto de netBeans, pero al parecer esas imágenes no se agregaron al archivo .jar. Hay una forma especial de agregar las imágenes al proyecto de NetBeans para que se guarden en el archivo .jar?

        Saludos.

  2. 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.

    • Tu proyecto debe tener una clase principal, la primera que se ejecuta al iniciar el código. Esa clase está dentro de un paquete. Normalmente a los paquetes se les asigna la nomenclatura com.nombre_del_proyecto. Si tu proyecto se llama, por ejemplo, «Proyecto», creas un paquete llamado com.proyecto y ahí dentro colocas la clase principal. Recomiendo que la llames MainClass.

      Entonces, en el POM estableces que tu clase principal es com.proyecto.MainClass

  3. 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

    • Si quieres saber el error que está deteniendo la ejecución de tu aplicación te recomiendo que vayas a la carpeta donde tienes el JAR generado, presiones CONTROL + CLIC DERECHO DEL MOUSE sobre la carpeta y abras una ventana de Power Shell. Luego ejecutas el JAR utilizando el comando java -jar archivo.jar

      Al hacer eso estarás ejecutando tu JAR desde la consola y si se produce algún error en tiempo de ejecución podrás verlo en la propia consola de Power Shell.

Dejar respuesta

Please enter your comment!
Please enter your name here