Empaquetamiento de aplicaciones de escritorio (standalone) con Maven
Introducción
Actualmente he tenido la necesidad de empaquetar una aplicación de escritorio construida con Maven y me he dado cuenta de que ninguna de las alternativas de empaquetamiento que este me ofrece era la que se ajustaba a mis necesidades.
Más concretamente, lo que no se ajustaba a mis necesidades es el modo en que Maven coloca las dependencias de tu proyecto a la hora de crear el paquete a distribuir.
Maven, mete todos los .class de las dependencias de tu proyecto dentro del propio Jar de tu aplicación. (assembly jar-with-dependencies).
Que queréis que os diga, a mi eso no me gusta. Prefiero tener mi jar (con el método main) por un lado con el MANIFEST modificado de tal forma que haga referencia los jars que necesita para ejecutarse.
Más concretamente, me gusta tener un directorio dist en donde dentro está mi jar (con el método main) y las dependencias en un directorio dist/lib.
Pues bien, en este ejemplo vamos a ver como conseguir ese método, siendo fácilmente adaptable a otro tipo de necesidades que tengáis.
Ejemplo, Aplicación básica de escritorio con dependencias:
A continuación vamos a ver como conseguir lo anteriormente expuesto, para ello nuestra aplicación de escritorio será muy básica y tendrá dos dependencias.
Eso si, el esfuerzo para una aplicación con miles de clases y decenas dependencias sería practicamente igual.. quizás sería necesario algún pequeño reajuste, pero vamos poco más.
El código fuente de este tutorial puede ser descargado desde aquí (proyecto Eclipse con Maven 2).
Entorno
El siguiente ejemplo está construido en el siguiente entorno:
HP Pavilion.
Windows Vista Home Premium.
Eclipse Ganymede.
Java 6.
Maven 2.
Plugin Maven 4QE para Eclipse.
Mi aplicación de escritorio con su bonito método main:
Está autocomentada, pero bueno, resalto que usa las librerías commons-lang y commons-io de Apache.
package com.autentia.tutoriales.maven.standalone;
import java.io.File;
import org.apache.commons.lang.WordUtils;
import org.apache.commons.io.FileUtils;
public class MavenStandaloneExample {
/**
* Dado un archivo de texto imprime su contenido capitalizado, es decir, la primera letra de
* cada palabra en mayúsculas.
* @param args Un sólo parámetro con la ruta completa al archivo de texto a capitalizar.
*/
public static void main(String[] args) {
try {
File file = new File(args[0]);
String fileContent = FileUtils.readFileToString(file);
System.out.println(WordUtils.capitalizeFully(fileContent));
} catch (java.lang.ArrayIndexOutOfBoundsException ex){
System.out.println("Debe especificar el nombre de un archivo");
} catch (java.io.IOException ex){
System.out.println("Se ha producido un error al tratar el archivo especificado.");
System.out.println("Verique que exista y que tenga permisos de lectura.");
}
}
}
Archivo de configuración de Maven 2: pom.xml:
A continuación exponemos el archivo de configuración de Maven, se presupone que el lector ya tiene nociones de Maven.
4.0.0com.autentia.tutorialesmaven_standalone_app_examplejar1.0-SNAPSHOTmaven_standalone_app_examplehttp://www.adictosaltrabajo.commavenStandaloneExamplemaven-compiler-plugin1.51.5UTF-8org.apache.maven.pluginsmaven-jar-plugincom.autentia.tutoriales.maven.standalone.MavenStandaloneExampletruelibCarlos García PérezAutentia Real Business Solutionshttp://www.autentia.comorg.apache.maven.pluginsmaven-assembly-pluginmaven_assembly_conf.xmlpackagesinglecommons-langcommons-lang2.3commons-iocommons-io1.4
Archivo de configuración del assembly (maven_assembly_conf.xml):
Si os gusta mi forma de organizar el proyecto teneis un esqueleto fácilmente adaptable a vuestras necesidades.
En Autentia llevamos años trabajando con Maven para gestionar nuestros proyectos, si algún día necesitais ayuda o formación al respecto espero nos tengáis en cuenta.
Un saludo, espero que os haya parecido útil este tutorial.
Carlos García Pérez. Creador de MobileTest, un complemento educativo para los profesores y sus alumnos.