Aplicación gvSIG con fines educativos

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

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 <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.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 <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.portablewview$ mvn clean install

Desde eclipse

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

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, 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.