El otro día se me acercó un compañero a ver si podía orientarle sobre por dónde podía empezar si quería contribuir de alguna manera al desarrollo de gvSIG 2.0. Me quede pensando un momento y le pregunté….

¿Pero qué quieres hacer?

Después me di cuenta que él mismo no tenía muy claro realmente qué es lo que quería hacer. Quería empezar a hacer algo con la versión 2 de gvSIG pero no tenía nada claro aun el qué.

Hay bastante documentación sobre cómo desarrollar con y para la versión 2.0 de gvSIG, pero todos los que se acercan se plantean…

¿Por dónde empiezo?

En general al acercarse al desarrollo con o para la versión 2.0 de gvSIG podemos identificar tres escenarios:

• Contribuir al núcleo de gvSIG
• Contribuir a un proyecto que no forma parte del núcleo de gvSIG
• Creación de plugins propios

Para simplificar aquí he utilizado el termino “núcleo de gvSIG” aunque realmente tendría que hablar del “workspace principal de gvSIG”, pero de momento nos quedaremos con lo de núcleo de gvSIG.

Lo primero que haría sería empezar por leer, y probablemente seguir, la Guía de inicio rápido del desarrollador y las Normas de codificación y desarrollo pero después según el escenario en que me encuentre lo mejor seria poder seguir con la documentación más adecuada para él.

Contribuir al núcleo de gvSIG

¿Qué quiere decir eso de “Contribuir al núcleo de gvSIG”?

Pues me refiero a cuando tengo o me gustaría realizar alguna mejora o corrección de algún bug de lo que serian los proyectos que forman parte del “workspace principal de gvSIG”. Si quiero aportarla al proyecto, tendré que poder probar que funciona y saber qué tengo que hacer para aportarla. Será interesante leer:

• Guía para desarrolladores de gvSIG 2.0.0y más concretamente los apartados:
  • Maven
  • Trabajar con el núcleo de gvSIG.
  • Normas de codificación y desarrollo

  Se trata de una pequeña guía que te introduce los conceptos principales sobre el desarrollo en la versión 2.0 de gvSIG, qué herramientas usar, cómo configurarlas, y cómo hacer para montar el workspace principal de gvSIG, descargar los fuentes, compilarlos, ejecutar la aplicación y hasta crear los instalables de esta si nos fuese necesario.

• Contribuciones y parches al código de gvSIG .Este documento nos guiará en el proceso a seguir para contribuir nuestro código al proyecto.
• Wiki del proyecto admin en el redmine de gvSIG, aquí nos indicará los pasos a seguir para solicitar un usuario en la web o el gestor de tickets de gvSIG, así como qué tenemos que hacer para solicitar luego que nos añadan como miembros de alguno de los proyectos que forman gvSIG.

Después de leer esta documentación, probablemente estemos en condiciones de compilar el “núcleo de gvSIG” para poder introducir nuestras mejoras, y sabremos cómo hemos de hacer para que estas sean integradas en el núcleo para próximas revisiones.

Contribuir a un proyecto que no forma parte del núcleo de gvSIG

Lo primero que nos puede venir a la cabeza es la pregunta de que es eso de proyectos que no forman parte del núcleo de gvSIG… bueno… el workspace principal de gvSIG consta de una serie de proyectos que constituyen el núcleo sobre el que se monta toda la aplicación, pero no todos los plugins que se distribuyen con la aplicación están en este workspace. Cada vez más plugins tienen su propio proyecto independiente y su propio ciclo de vida. Con su grupo de desarrollo y criterios para aceptar nuevos desarrolladores o contribuciones, algunas veces más laxos que sobre el workspace principal. Algunos de esos plugins son:

• Catalog
• Gazetteer
• ARC IMS
• Oracle
• Layout document
• ECW
• MrSID
• WMS
• WCS
• Scripting

Algunos tienen ya su propio proyecto en la infraestructura de desarrollo de gvSIG y siguen una vida independiente del núcleo de gvSIG. Si estamos interesados en contribuir en alguno de ellos podemos consultar en la pagina infraestructura de desarrollo de gvSIG la ficha del proyecto y ponernos en contacto con alguno de sus responsables para gestionar con él la forma en que queremos desarrollar. Si no, siempre podemos trabajar como se describe en Contribuciones y parches al código de gvSIG.

Si vamos a ser desarrolladores de un proyecto puede ser interesante leer:

• Contribuciones y parches al código de gvSIG
• Normas de codificación y desarrollo
• Wiki del proyecto admin en el redmine de gvSIG

Ya comentado en el apartado anterior, y además:

• Guía para “commiters” de gvSIG, sobre todo prestando especial atención al apartado Enlazar los commits y los tickets .
• Añadir un paquete al repositorio de paquetes de gvSIG, que nos dará las pautas a seguir para poder añadir el paquete de instalación de nuestro plugin al repositorio de paquetes de gvSIG y que esté disponible para el todos los usuarios.

Creación de plugins propios

Y por ultimo comentar esta parte… porque la creación de nuestros propios plugins y que estén disponibles para el resto de la comunidad de usuarios de gvSIG también es una forma de contribuir al proyecto.

Para este caso aconsejo sobre todo la Guía de inicio rápido del desarrollador, pero nos ayudará también leer algunos de los documentos comentados en los apartados anteriores como:

• Normas de codificación y desarrollo
• Wiki del proyecto admin en el redmine de gvSIG
• Añadir un paquete al repositorio de paquetes de gvSIG

Y más específicamente nos vendrá bien leer:

• Crear un proyecto para gvSIG de la Guía para desarrolladores de gvSIG 2.0.0
• Proyectos oficiales en gvSIG que nos guiara sobre cuáles son las directrices para que nuestro desarrollo sea un proyecto oficial gvSIG. Recomiendo leerlo antes de abordar un desarrollo para la versión 2 de gvSIG, ya que aunque a priori no vayamos a solicitar que nuestro proyecto sea un proyecto oficial, hay bastantes cosas que son simples de seguir cuando vas a crear tu proyecto pero pueden ser muy costosas una vez ya esta confeccionado, así que merece la pena leerlo para intentar seguir las lineas que ahí se piden al inicio del desarrollo, aunque sea solo como buenas prácticas de desarrollo.

Para acabar

La documentación que he ido referenciando es documentación sobre cómo trabajar, pero no se trata de documentación de referencia sobre las librerías que conforman gvSIG. De esta hay menos, pero si alguien quiere leer algo puede encontrarla en el apartado de Documentación de desarrollo del proyecto gvSIG-desktop en la web http://www.gvsig.org . De ahí, por su especial relevancia es recomendable leer:

• org.gvsig.tools
• org.gvsig.fmap.geom
• org.gvsig.fmap.dal

Y bien, para acabar estas letras, simplemente comentar que la documentación puede no estar todo lo completa que nos gustaría y que aunque la sigáis, podéis tener problemas, pero no os desaniméis, preguntar por las listas de desarrollo las dudas que tengáis o si tenéis algún problema para hacerlo por las listas no dudéis en escribir correo a los responsables de desarrollo de los proyectos con los que tengáis problemas.

¡Ah!, se me olvidaba, también podéis contribuir aportando documentación al proyecto, o traduciendo la existente a otros idiomas.

Hasta la próxima