===============
gvSIG Educa
===============
---------------------
Vistas Portables
---------------------
Descripción
==============
Este directorio contiene los fuentes de la funcionalidad Vistas Portables.
Requisitos
==============
* Maven 2.6 or higher
* Java JDK 1.5 or higher
Para trabajar con eclipse
--------------------------
Ver `Guía del desarrollador en gvSIG.org `_ y el fichero ``REAME-ECLIPSE.txt``
Contenido
==========
org.gvsig.educa.portableview.lib
---------------------------------
Fuentes de la funcionalidad. Estos proyectos contienen los procesos y lógica principal sin dependencias de interface de usuario.
org.gvsig.educa.portableview.swing
-------------------------------------
Componentes de interface de usuario para gestionar los servicios que ofrece la librería.
org.gvsig.educa.portableview.main
-----------------------------------
Pequeña aplicación que permite ejecutar las funcionalidades y realizar pruebas funcionales.
Ver `Ejecutar aplicación de pruebas`_ para saber como arrancarla.
pom.xml
---------
Archivo de definición de proyecto Maven.
README.txt LEEME.txt
----------------------
Este fichero (en formato reStructureText, para mas información sobre este ver el `portal de gvSIG `_ en la `referencia de docUtils `_)
Compilación
================
Desde el shell
----------------
Ejecute este comando::
org.gvsig.educa.portablewview$ mvn clean install
Desde eclipse
--------------
Ver `Trabajar con un proyecto de la guía de desarrollador en gvSIG.org `_
En algunos proyectos puede que sea necesario user el comando ``mvn eclipse:clean eclipse:eclipse`` e importar como *Standar/Import existing project...* en vez de cargar como *Maven Project*. Esto es debido a que, en algunas circunstancias, parece que el plugin de Maven del eclipse no prepara el *classpath* de forma correcta.
Empaquetado
===============
Esta funcionalidad no tiene ningún proyecto pensado para empaquetar de forma independiente.
Versionado
--------------
Para cambiar el número de versión de los plugins solo es necesario ajustar la etiqueta ``project/version`` del fichero *pom.xml*. Los subproyectos heredarán el valor.
La política de versión es la estándar. Los cambios en los numeroso son:
* tercer número: Arreglo de errores y mejoras menores. Sin cambios en el API.
* segundo número: Arreglo de erroes y mejoras. Pueden haber cambios menores en el API. Los elementos marcados como *deprecated* en versiones anteriores pueden eliminarse. Sin cambios de arquitectura.
* primer número: Cambios mayores.
Crear un tag
------------------
TODO: usar el plugin *release* de maven
Usar el comando *svn copy*. El proceso podría ser:
#. Comprobar que no hay cambios en la copia local::
svn up ; svn status
#. Comprobar que los proyecto compilan y pasan todas las baterías de test::
mvn clean install
#. Actualizar el fichero *pom.xml* con la versión de tag (normalmente quitando el sufijo *-SNAPSHOT*)
#. Crear el directorio para el tag en el servidor::
svn mkdir -m "Create {version} tag folder" https://devel.gvsig.org/svn/gvsig-educa/org.gvsig.educa.portablewview.app/tags/{version}
#. Subir la copia local al directorio del tag en el servidor::
svn copy -m "Create {version} tag" * https://devel.gvsig.org/svn/gvsig-educa/org.gvsig.educa.portablewview.app/tags/{version}
#. Actualizar el *pom.xml* a la siguiente version (y añadirle el sufijo *-SNAPSHOT*)
#. Subir los cambios del *pom.xml*::
svn commit -m "Set new version {version}-SNAPSHOT" pom.xml
i18n
======
Los ficheros de internacionalización se pueden encontrar en los directorios:
+ */org.gvsig.educa.portableview.swing/org.gvsig.educa.portableview.swing.impl/src/main/resources/org/gvsig/educa/portableview/swing/impl/i18n*
+ *org.gvsig.educa.portableview.lib/org.gvsig.educa.portableview.lib.impl/src/main/resources/org/gvsig/educa/portableview/impl/i18n*
La internacionalización está basada en el mecanismo estándar de los *resource bundle*. Para añadir un nuevo idioma es necesario añadir el fichero de propiedades en todos los directorio con el codigo de idioma adecuado.
Ejecutar aplicación de pruebas
=================================
Desde el Shell
----------------
Después del proceso de `Compilación`_ , ejecute estos comandos::
org.gvsig.educa.portablewview$ cd org.gvsig.educa.portablewview.main
org.gvsig.educa.portablewview/org.gvsig.educa.portablewview.main$ mvn exec:java
Desde el eclipse
------------------
Seleccione el proyecto ``org.gvsig.educa.portableview.main`` en el *Project tree* de la *Java perspective*, haga click con el botón derecho y seleccione ``Run as.../Java application``. Seleccione la clase ``Main`` del propio proyecto.
Si tiene problemas al ejecutar, compruebe la nota de la sección `Compilación`_ sobre la importación del proyecto.