===================
gvSIG Educa Batoví
===================
------------------------------------------------------------
Personalización de gvSIG para los OLPC del proyecto Ceibal
------------------------------------------------------------
Descripción
==============
Este fichero es un índice del contenido de este directorio
Requisitos
==============
* S.O Linux
* 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
=========
REAME.txt/LEEME.txt
--------------------
Este fichero. Está en formato reStructureText. Para mas información ver el `portal de gvSIG `_ o en la `referencia de docUtils `_)
docs
---------
Directorio con documentos realitivos al proyecto
org.gvsig.educa.batovi.activity
-----------------------------------
Scripts para generar una *actividad* de *sugar* con una personalización de gvSIG a partir de una instalción de gvSIG v2.0
org.gvsig.educa.batovi.app
-------------------------------
Plugins especiales para el proyecto Batoví (Personalización del UI, etc..)
org.gvsig.educa.batovi.mapviewer
-----------------------------------
Aplicación minimalista que permite instalar y visualizar *mapas temáticos*. Incluye scripts para empaquetar en forma de *actividad* de *sugar*
Compilación
================
Para aquellos proyectos que contengan código. El resto contendrán un fichero *LEEME.txt* con las instrucciónes necesárias.
Desde el shell
----------------
Ejecute este comando::
{proyecto}$ 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
===============
Dependiendo del proyecto es aplicable o no:
* El proyecto de *org.gvsig.edica.batovi.activity* es un empaquetado en si mismo.
* El proyecto de *org.gvsig.educa.batovi.app* contiene plugins y usa el mecanismo estándar de empaquetado de gvSIG.
* El proyecto de *org.gvsig.educa.batovi.mapviewer* contiene su empaquteador en *org.gvsig.educa.batovi.mapviewer/org.gvsig.educa.batovi.mapviewer.activity*
Versionado
--------------
Para cambiar el número de versión de los plugins solo es necesario ajustar la etiqueta ``project/version`` del fichero *pom.xml* de los proyectos:
* *org.gvsig.educa.batovi.app*
* *org.gvsig.educa.batovi.mapviewer*
Los subproyectos heredarán el valor.
La política de versión es la estándar. Los cambios en los numeros 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.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 internacionalización se pueden encontrar en los directorios:
+ *org.gvsig.educa.batovi.mapviewer/org.gvsig.educa.batovi.mapviewer/src/main/resources*
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.