Aplicación gvSIG con fines educativos » Interfaz de usuario

===============

gvSIG Educa

===============

---------------------

Mapas Temátcios

---------------------

Descripción

==============

Este directorio contine los fuentes de la funcionalidad Mapa Temáticos.

Requisitos

==============

* Maven 2.6 or higher

* Java JDK 1.5 or higher

Para trabajar con eclipse

--------------------------

Ver `Guía del desarrollador en gvSIG.org <https://gvsig.org/web/projects/gvsig-desktop/docs/devel/gvsig-devel-guide/2.0.0/>`_ y el fichero ``REAME-ECLIPSE.txt``

Contenido

==========

org.gvsig.educa.thematicmap.lib

---------------------------------

Fuentes de la funcionalidad. Estos proyectos contienén los procesos y lógica principal sin dependencias de interface de usuario.

org.gvsig.educa.thematicmap.swing

-------------------------------------

Componentes de interface de usuario para gestionar los servicios que ofrece la librería.

org.gvsig.educa.thematicmap.main

-----------------------------------

Pequeña aplicación que permite ejecutar las funcionalidades y realizar pruebas funcionales.

Ver `Ejecutar applicación de pruebas`_ para saber como arracarla.

pom.xml

---------

Archivo de definición de proyecto Maven.

prepare-workspace.xml y README-ECLIPSE.txt

-----------------------------------------------

Instrucciones y utilidades para compilar con eclipse.

README.txt LEEME.txt

----------------------

Este fichero (en formato reStructureText, para mas información sobre este ver el `portal de gvSIG <https://gvsig.org/web/projects/gvsig-desktop/docs/devel/guia-para-documentar/el-formato-restructuredtext>`_  en la `referencia de docUtils  <http://docutils.sourceforge.net/rst.html>`_)

Compilación

================

Desde el shell

----------------

Ejecute este comando::

    org.gvsig.educa.thematicmap$ mvn clean install

Desde eclpse

--------------

Ver `Trabajar con un proyecto de la guía de desarrollador en gvSIG.org <https://gvsig.org/web/projects/gvsig-desktop/docs/devel/gvsig-devel-guide/2.0.0/trabajar-con-un-proyecto>`_

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, parace el el plugin de Maven del eclipse no prepara el *classpath* de forma correcta.

Empaquetado

===============

Esta funcionalidad no tiene ningún proyecto pensado para empaquetaser 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 version es la estándar. Los cambios en los númeroso 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 baterias de test::

   mvn clean install

#. Actualizar el fichero *pom.xml* con la version 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.thematicmap.app/tag/{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.thematicmap.app/tag/{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 internacionalizacion se pueden enecontrar en los directorios:

+ */org.gvsig.educa.thematicmap.swing/org.gvsig.educa.thematicmap.swing.impl/src/main/resources/org/gvsig/educa/thematicmap/swing/impl/i18n*

+ *org.gvsig.educa.thematicmap.lib/org.gvsig.educa.thematicmap.lib.impl/src/main/resources/org/gvsig/educa/thematicmap/impl/i18n*

La internacionalización está basada en el mecanismo estándar de los *resource bundle*. Para añadir un nuevo idioma sólo es necesario añadir el fichero de propiedades en todos los directorio con el codigo de idioma adecuado.

Ejecutar applicación de pruebas

=================================

Desde el Shell

----------------

Después del proceso de `Compilación`_ , ejecute estos comandos::

    org.gvsig.educa.thematicmap$ cd org.gvsig.educa.thematicmap.main

    org.gvsig.educa.thematicmap/org.gvsig.educa.thematicmap.main$ mvn exec:java

Desde el eclipse

------------------

Seleccione el proyecto ``org.gvsig.educa.thematicmap.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.