=============== 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 `_ 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 `_ or at `docUtils reference `_) 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 `_ 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.