Document Actions
Trabajar con el núcleo de gvSIG
Compilar gvSIG desde eclipse
Introduccion
Aqui podra encontrar como compilar gvsig-desktop 2.1.0 a partir de los fuentes usando eclipse. Para ello veremos:
- Como instalar un JDK
- Como instalar eclipse
- Como configurar el JDK en eclipse.
- Como instalar y configurar un plugin de acceso a SVN en eclipse
- Como instalar y configurar el plugin m2e en eclipse.
- Como compilar descargar, compilar y ejecutar gvSIG
Ademas de instalar un jdk, eclipse y el plugin de eclipse m2e, a mi me gusta tener maven disponible desde la linea de comandos por si he de ejecutarlo, asi que recomiendo instalarlo tambien.
Con todo esto, simplemente descargaremos los fuentes y los compilaremos. Vamos a ir viendo como podriamos hacerlo.
Instalar el JDK (linux)
Tip
Estas instrucciones son para instalar la JDK en un sistema Linux con ubuntu. En otros sistemas linux puede no ser exactamente asi.
Lo primero sera verificar que tenemos instalado un JDK en el sistema. Para ello teclearemos:
$ java -version java version "1.7.0_21" OpenJDK Runtime Environment (IcedTea 2.3.9) (7u21-2.3.9-0ubuntu0.11.10.1) OpenJDK 64-Bit Server VM (build 23.7-b01, mixed mode) $
En caso de que nos diga que no encuentra el comando es que no tendremos instalada o configurada un JRE.
Probaremos:
$ javac -version javac 1.7.0_21 $
Para verificar si tenemos una JDK.
En mi caso, yo habia instalado "openjdk-7-jdk - OpenJDK Development Kit (JDK)" mediante el comando:
$ sudo apt-get install openjdk-7-jdk
Una vez instalada la JDK nos cercioraremos de que esta como la JVM por defecto en el sistema. En mi caso utilizando el comando:
$ sudo update-alternatives --config java Existen 2 opcioens para la alternativa java (que provee /usr/bin/java). Selección Ruta Prioridad Estado ------------------------------------------------------------ 0 /usr/lib/jvm/java-6-openjdk/jre/bin/java 1061 modo automático 1 /usr/lib/jvm/java-6-openjdk/jre/bin/java 1061 modo manual * 2 /usr/lib/jvm/java-7-openjdk/jre/bin/java 1051 modo manual Pulse <Intro> para mantener el valor por omisión [*] o pulse un número de selección:
Instalacion de maven
La instalacion de maven para que este disponible desde la linea de comandos no es necesaria para la compilacion de gvSIG si se va a usar eclipse, a pesar de lo cual, como en algun momento puede ser interesante ejecutarlo desde la consola recomiendo instalarlo. Si solo vas a utilizar el eclipse para compilar puedes saltarte esta seccion.
Para instalar maven, y dado que en mi sistema no venia por defecto un maven version 3, que es el recomendado para usar con gvSIG, me he dirigido a la web de maven para descargarlo.
En el momento de instalarlo, la version para descargar que habia era la "3.0.5". La he descargado desde:
http://maven.apache.org/download.cgi
Tip
Para sistemas MS Windows puede dejarlo en "Archivos de programa/maven".
Y simplemente la he descomprimido en $HOME/applications/maven y he añadido al PATH la carpeta "$HOME/applications/maven/bin".
Instalar eclipse
Para instalar eclipse, me he dirigido a la web:
www.eclipse.org
Y desde ahi he descargado la ultima version de eclipse para mi sistema. En concreto:
http://www.eclipse.org/downloads/download.php?file=/technology/epp/downloads/release/kepler/R/eclipse-java-kepler-R-linux-gtk-x86_64.tar.gz
Simplemente lo he descomprimido en $HOME/applications/eclipse .
Configurar el JDK para eclipse
Tip
En mi sistema linux la JDK a usar esta instalada en:
- /usr/lib/jvm/java-7-openjdk
Una vez con un eclipse, a mi disposicion, lo primero es indicarle que use la JDK que hayamos preparado con anterioridad. Eclipse, puede ecjecutarse con un JRE ya que lleva embebido su propio compilador de java, pero con este no es suficiente ya que maven intentare acceder al JDK para compilar. Asi que nos dirigiremos a:
Window -> Preferences -> Java -> installed JREs
Y alli añadiremos nuestra JDK si no se ecnuentra en la lista y la marcaremos como jdk a usar.
Despues iremos a:
Window -> Preferences -> Java -> installed JREs -> Execution Enviroments
Y tambien la seleccionaremos.
Configurar el cliente de SVN
Para poder descargarnos los fuentes de gvSIG tendremos que instalar en eclipse un plugin que nos permita acceder a repositorios de SVN. Yo suelo usar el "subversive". Vamos a ver como tendriamos que hacer para instalarlo y configurarlo.
Lo primero iremos a:
Help -> install new software
Ahi, en el primer desplegable seleccionaremos:
-- All Available Sites --
Y en la siguiente caja de texto teclearemos "subv" para que nos busque entre los plugins disponibles. En la lista que nos presenta seleccionaremos:
Subversive SVN Team Provider
Le daremos en siguiente, y seguiremos los pasos que nos va indicando. Al final a mi me pidio reiniciar eclipse, cosa que hice.
Una vez tenemos instalado el plugin para acceso al SVN, pasaremos a crear la perpectiva de "SVN Repository Exploring".
Window -> Open perspective -> Others...
Al hacer esto nos pedira que instalemos el conector que queremos usar para acceder al SVN. Yo suelo utilizar el "SVN Kit", en este caso la version 1.7.9 que se corresponde con el SVN del sistema version 1.7 que es el que tengo instalado.
Terminado esto ya tendremos instalado y configurado el acceso a SVN desde eclipse.
Instalar el plugin de maven para eclipse (m2e)
Procederemos a instalar el plugin de eclipse "m2e". Para ello seleccionaremos en el menu:
Help -> Install new software
Cuando nos muestre la ventana para instalar nuevo software en eclipse, en el desplegable etiquetado como "Work with" seleccionaremos la opcion correspondiente a la version de nuestro eclipse, en mi caso "Kepler".
En la caja de texto que hay en cima de la tabla entraremos "maven" para filtrar los paquetes, y de la lista resultante seleccionaremos:
m2e conector for mavenarchiver pom properties
Y haremos click en "siguiente".
Una vez haya terminado de instalarlo probablemente nos solicite reiniciar eclipse, cosa que haremos.
una vez instalado el plugin de maven para eclipse, necesitaremos instalar el conector de SVN para m2e. Para ello, pulsaremos con el boton derecho sobre el explorador de paquetes y seleccionaremos la opcion "Importar". En la ventana de importacion abriremos la carpeta que dice "Maven", seleccionaremos la opcion "Checkout maven projects from SCM" y haremos click en el boton "Siguiente".
En la nueva ventana que aparece, veremos un texto que dice algo como "Find more SCM connectors in the m2e markeplace". Pulsaremos sobre el enlace para instalar el conector para SVN.
En la nueva ventama que nos aparecera introduciremos "scm" en la casilla de filtro (find) y seleccionaremos "m2e-subversive" y haremos click en el boton "Instalar".
Concluida la instalacion de este plugin tendremos instalado y configurado minimamente el plugin de maven para eclipse para poder trabajar.
Compilar gvSIG
Una vez tenemos instalado y configurado nuestro JDK, eclipse, y plugin de maven para ecliose, podemos pasar a compilar la aplicacion gvSIG desktop.
Para ello, lo primero que tendremos que hacer es descargarnos los fuentes. Yo he creado un workspace nuevo para ello.
En la vista del explorador de paquetes haremos click con el boton derecho sobre el fondo y seleccionaremos la opcion "Importar".
En la ventana de importacion abriremos la carpeta que dice "Maven", seleccionaremos la opcion "Checkout maven projects from SCM" y haremos click en el boton "Siguiente".
En la ventana "Checkout as maven project from SCM" seleccionaremos en "SCM Url", en el primer desplegable "svn" y en la caja de texto introduciremos:
https://devel.gvsig.org/svn/gvsig-desktop/trunk/org.gvsig.desktop
Y haremos click en el boton "Finalizar".
Al hacer click en "Finalizar" nos presentara una ventana informandonos que no es capaz de verificar el certificado de la web "https://devel.gvsig.org", lo aceptaremos haciendo click en "Trusk Always".
Una vez hecho esto se procedera a la descarga del proyecto desde el svn de gvSIG. Esto puede tardar un ratito.
Una vez terminado de descargarse los fuentes, automaticamente procedera a configurar e importar los proyectos maven en el workspace.
Esta operacion tambien puede tardar un rato ya que se descargara todas las dependencias de maven que precise.
Una vez terminado tendremos el proyecto configurado y listo para compilar.
Para compilar nos limitaremos a seleccionar el proyecto
org.gvsig.desktop
En el explorador de paquetes y haremos click con boton derecho, seleccionando la opcion
Run As -> 5 Maven install
Y esto compilara y dejara listo para ejecutar la aplicacion. Si todo ha ido bien, en la consola tendra que aparecer un mensaje algo como:
[INFO] BUILD SUCCESS
Ejecutar gvSIG
Si ya tenemos gvSIG compilado para ejecutarlo solo tenemos que crear una entrada en los "launchers" de eclipse. Para esto, pulsaremos en la opcion "Run configurations"
Y crearemos una entrada nueva de tipo aplicacion java. Indicaremos:
- Name: "gvSIG"
- Main -> Project: org.gvsig.andami
- Main -> Main class: org.gvsig.andami.Launcher
- Arguments -> Others: Seleccionaremos el boton "Workspace" y la carpeta org.gvsig.desktop/target/product.
Una vez entrados estos valores pulsaremos en "Aplicar" y en "Run" para ejecutar la aplicacion.
Algunas consideraciones y pequeños trucos
Cuando compila gvSIG desktop usando "mvn install" se realizan una serie de acciones como son:
- Compilar los test
- Ejecutar los test
- Empaquetar los test
- Empaquetar los fuentes
- Generar y empaquetar los javadocs
- Comprobar la compatibilidad binaria con el API de java 1.5
Aunque estas acciones es necesario ejecutarlas por lo menos la primera vez, puede que no siempre nos interese hacerlo. En el fichero "maven-howto.rst" que hay en el raiz del proyecto "org.gvsig.desktop" indica como indicar en la linea de comandos que no queremos que se ejecuten estas acciones.
Si evitamos que se ejecuten cada vez que compilamos un proyecto ganaremos tiempo. Eso si, no olvidemos ejecutarlas de vez en cuando para mantener los binarios y los archivos adicionales que generan estas acciones sincronizados.
En eclipse, puede ser interesante crear un "Launcher" que suelo llamar algo como "Maven install (quick)" indicando estas acciones y que se ejecute sobre el proyecto que tengo seleccionado en el explorador de paquetes.
