=============== 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 `_ 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 `_ en la `referencia de docUtils `_) 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 `_ 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.