Aplicación gvSIG con fines educativos

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

gvSIG Educa

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

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

Portable View

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

Description

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

This folder contains the sources of the Portable View functionality.

Requirements

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

* Maven 2.6 or higher

* Java JDK 1.5 or higher

For eclipse

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

See `developer guide at gvSIG.org <http://www.gvsig.org/plone/projects/gvsig-desktop/docs/devel/gvsig-devel-guide/2-1-0/introduccion>`_ and the file ``REAME-ECLIPSE.txt``

Contents

==========

org.gvsig.educa.portableview.lib

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

Functionality sources. This project just contain the main process and the logic without any dependency with User Interface.

org.gvsig.educa.portableview.swing

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

User Interface components to access a manage the application services.

org.gvsig.educa.portableview.main

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

Little test application which allow run the main functionality of application.

See `Execute little test application`_ to know how run it.

pom.xml

---------

Maven project definition file

README.rst

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

This file (in reStructureText format, for more info this format look at `gvSIG portal <https://gvsig.org/web/projects/gvsig-desktop/docs/devel/guia-para-documentar/el-formato-restructuredtext>`_  or at `docUtils reference <http://docutils.sourceforge.net/rst.html>`_)

Compilation

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

From shell

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

Execute this command::

    org.gvsig.educa.portableview$ mvn clean install

From eclipse

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

See `work in a proyect of the developer guide at gvSIG.org <https://gvsig.org/web/projects/gvsig-desktop/docs/devel/gvsig-devel-guide/2.0.0/trabajar-con-un-proyecto>`_

In some project, could be better use ``mvn eclipse:clean eclipse:eclipse``  than import project as a *Maven project*. Maven plugin of eclipse does not set classpath correctly in some project.

Packing

========

This functionality has no stand-alone packing process.

Version

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

To changes version number just set in in ``project/version`` tag of *pom.xml* in this folder. Sub-projects will inherit it.

Version polity is the standard in project. Changes in version number:

* third number: Bug fixes and minors improvements. API must have no changes from previous version.

* second number: Bug fixes and mayor improvements. API can have minor changes. Previously deprecated classes could be removed. No architectural changes.

* first number: Mayor changes.

Create a tag

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

TODO: use *maven release* plugin

Use svn copy command to copy version in server. Process could be like this:

#. Check that there ins no changes in workspace::

   svn up ; svn status

#. Check that project compiles and passes all test.

   mvn clean install

#. Update *pom.xml* to set version of tag (usually removing *-SNAPSHOT*)

#. create tag folder on server::

   svn mkdir -m "Create {version} tag folder" https://devel.gvsig.org/svn/gvsig-educa/org.gvsig.educa.portablewview/tags/{version}

#. Copy current workcopy to tag folder::

   svn copy -m "Create {version} tag" * https://devel.gvsig.org/svn/gvsig-educa/org.gvsig.educa.portablewview/tags/{version}

#. Update *pom.xml* to next version

#. Commit *pom.xml* changes::

   svn commit -m "Set new version {version}-SNAPSHOT" pom.xml

i18n

======

The files for internationalization can be found in this folders:

+ *org.gvsig.educa.portablewview.app.viewer/src/main/resources-plugin*

+ *org.gvsig.educa.portablewview.app.editor/src/main/resources-plugin*

The internationalization of this application is based on standard java resource bundle mechanism. So, to add a new language just add the file with the language code to every related folder.

Execute little test application

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

From shell

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

After compile the application, execute this command::

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

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

Form eclipse

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

Select ``org.gvsig.educa.portableview.main`` project in *Project tree* using *Java perspective*, click with right mouse button and select ``Run as.../Java application``. Select ``Main`` class for project.