gvsig-educa / org.gvsig.educa.portableview / tags / org.gvsig.educa.portableview-1.0.30 / LEEME.txt @ 1416
History | View | Annotate | Download (5.05 KB)
1 | 256 | llmarques | =============== |
---|---|---|---|
2 | gvSIG Educa |
||
3 | =============== |
||
4 | |||
5 | --------------------- |
||
6 | Vistas Portables |
||
7 | --------------------- |
||
8 | |||
9 | 265 | llmarques | Descripci?n |
10 | 256 | llmarques | ============== |
11 | |||
12 | Este directorio contiene los fuentes de la funcionalidad Vistas Portables. |
||
13 | |||
14 | Requisitos |
||
15 | ============== |
||
16 | |||
17 | * Maven 2.6 or higher |
||
18 | |||
19 | * Java JDK 1.5 or higher |
||
20 | |||
21 | Para trabajar con eclipse |
||
22 | -------------------------- |
||
23 | |||
24 | 265 | llmarques | 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`` |
25 | 256 | llmarques | |
26 | Contenido |
||
27 | ========== |
||
28 | |||
29 | org.gvsig.educa.portableview.lib |
||
30 | --------------------------------- |
||
31 | |||
32 | 265 | llmarques | Fuentes de la funcionalidad. Estos proyectos contienen los procesos y l?gica principal sin dependencias de interface de usuario. |
33 | 256 | llmarques | |
34 | org.gvsig.educa.portableview.swing |
||
35 | ------------------------------------- |
||
36 | |||
37 | 265 | llmarques | Componentes de interface de usuario para gestionar los servicios que ofrece la librer??a. |
38 | 256 | llmarques | |
39 | org.gvsig.educa.portableview.main |
||
40 | ----------------------------------- |
||
41 | |||
42 | 265 | llmarques | Peque?a aplicaci?n que permite ejecutar las funcionalidades y realizar pruebas funcionales. |
43 | 256 | llmarques | |
44 | 265 | llmarques | Ver `Ejecutar aplicaci?n de pruebas`_ para saber como arrancarla. |
45 | 256 | llmarques | |
46 | pom.xml |
||
47 | --------- |
||
48 | |||
49 | 265 | llmarques | Archivo de definici?n de proyecto Maven. |
50 | 256 | llmarques | |
51 | README.txt LEEME.txt |
||
52 | ---------------------- |
||
53 | |||
54 | 265 | llmarques | 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>`_) |
55 | 256 | llmarques | |
56 | |||
57 | 265 | llmarques | Compilaci?n |
58 | 256 | llmarques | ================ |
59 | |||
60 | Desde el shell |
||
61 | ---------------- |
||
62 | |||
63 | Ejecute este comando:: |
||
64 | |||
65 | org.gvsig.educa.portablewview$ mvn clean install |
||
66 | |||
67 | |||
68 | Desde eclipse |
||
69 | -------------- |
||
70 | 265 | llmarques | 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>`_ |
71 | 256 | llmarques | |
72 | 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. |
||
73 | |||
74 | |||
75 | Empaquetado |
||
76 | =============== |
||
77 | |||
78 | 265 | llmarques | Esta funcionalidad no tiene ning?n proyecto pensado para empaquetar de forma independiente. |
79 | 256 | llmarques | |
80 | Versionado |
||
81 | -------------- |
||
82 | |||
83 | 265 | llmarques | 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. |
84 | 256 | llmarques | |
85 | 265 | llmarques | La pol??tica de versi?n es la est?ndar. Los cambios en los numeroso son: |
86 | 256 | llmarques | |
87 | 265 | llmarques | * tercer n?mero: Arreglo de errores y mejoras menores. Sin cambios en el API. |
88 | * 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. |
||
89 | * primer n?mero: Cambios mayores. |
||
90 | 256 | llmarques | |
91 | Crear un tag |
||
92 | ------------------ |
||
93 | |||
94 | TODO: usar el plugin *release* de maven |
||
95 | |||
96 | 265 | llmarques | Usar el comando *svn copy*. El proceso podr?a ser: |
97 | 256 | llmarques | |
98 | #. Comprobar que no hay cambios en la copia local:: |
||
99 | |||
100 | svn up ; svn status |
||
101 | |||
102 | 265 | llmarques | #. Comprobar que los proyecto compilan y pasan todas las bater?as de test:: |
103 | 256 | llmarques | |
104 | mvn clean install |
||
105 | |||
106 | 265 | llmarques | #. Actualizar el fichero *pom.xml* con la versi?n de tag (normalmente quitando el sufijo *-SNAPSHOT*) |
107 | 256 | llmarques | #. Crear el directorio para el tag en el servidor:: |
108 | |||
109 | 265 | llmarques | svn mkdir -m "Create {version} tag folder" https://devel.gvsig.org/svn/gvsig-educa/org.gvsig.educa.portablewview.app/tags/{version} |
110 | 256 | llmarques | |
111 | #. Subir la copia local al directorio del tag en el servidor:: |
||
112 | |||
113 | 265 | llmarques | svn copy -m "Create {version} tag" * https://devel.gvsig.org/svn/gvsig-educa/org.gvsig.educa.portablewview.app/tags/{version} |
114 | 256 | llmarques | |
115 | 265 | llmarques | #. Actualizar el *pom.xml* a la siguiente version (y a?adirle el sufijo *-SNAPSHOT*) |
116 | 256 | llmarques | #. Subir los cambios del *pom.xml*:: |
117 | |||
118 | svn commit -m "Set new version {version}-SNAPSHOT" pom.xml |
||
119 | |||
120 | |||
121 | i18n |
||
122 | ====== |
||
123 | |||
124 | 265 | llmarques | Los ficheros de internacionalizaci?n se pueden encontrar en los directorios: |
125 | 256 | llmarques | |
126 | + */org.gvsig.educa.portableview.swing/org.gvsig.educa.portableview.swing.impl/src/main/resources/org/gvsig/educa/portableview/swing/impl/i18n* |
||
127 | + *org.gvsig.educa.portableview.lib/org.gvsig.educa.portableview.lib.impl/src/main/resources/org/gvsig/educa/portableview/impl/i18n* |
||
128 | |||
129 | 265 | llmarques | 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. |
130 | 256 | llmarques | |
131 | 265 | llmarques | Ejecutar aplicaci?n de pruebas |
132 | 256 | llmarques | ================================= |
133 | |||
134 | Desde el Shell |
||
135 | ---------------- |
||
136 | |||
137 | 265 | llmarques | Despu?s del proceso de `Compilaci?n`_ , ejecute estos comandos:: |
138 | 256 | llmarques | |
139 | 265 | llmarques | org.gvsig.educa.portablewview$ cd org.gvsig.educa.portablewview.main |
140 | org.gvsig.educa.portablewview/org.gvsig.educa.portablewview.main$ mvn exec:java |
||
141 | 256 | llmarques | |
142 | Desde el eclipse |
||
143 | ------------------ |
||
144 | |||
145 | 265 | llmarques | 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. |
146 | 256 | llmarques | |
147 | 265 | llmarques | Si tiene problemas al ejecutar, compruebe la nota de la secci?n `Compilaci?n`_ sobre la importaci?n del proyecto. |