Introducción#

Este manual es una guía básica para poder descargar, compilar y ejecutar sinadura partiendo del código fuente. A día de hoy, Junio de 2011, el repositorio de trabajo es un repositorio interno gestionado por el equipo de desarrollo. Estamos evaluando las distintas forjas existentes para poder trabajar directamente en una de ellas.

Estructura del proyecto#

Dentro del svn se han publicado varios sub-proyectos, relacionados con el proyecto principal. Esto son:

• MITyCLibOCSP-sinadura (modificación de un proyecto del Ministerio de Industria, Turismo y Comercio para la validación OCSP)
• MITyCLibTSA-sinadura (modificación de un proyecto del Ministerio de Industria, Turismo y Comercio para la validación TSA)
• MITyCLibXADES-sinadura (modificación de un proyecto del Ministerio de Industria, Turismo y Comercio para la validación XADES)
• launch4j-maven-plugin (modificación del proyecto launch4j para generar el .exe de windows)
• sinaduraCore (el proyecto con los servicios de firma, validación y carga de certificados)
• sinaduraDesktop (el cliente swt de firma digital)

Cada proyecto está divido en una carpeta de tags, branches y la rama principal trunk. La rama de branches se usa para que los desarrolladores de la comunidad puedan trabajar de manera individual en las nuevas funcionalidades. Las otras dos ramas son para marcar versiones y para realizar el merge de las distintas funcionalidades desarrolladas.

Mostramos a continuación una imagen descriptiva de la estructura

De estos proyectos, cuatro de ellos son los que se usan a saber:

• MITyCLibOCSP-sinadura
• MITyCLibTSA-sinadura
• sinaduraCore
• sinaduraDesktop

El proyecto launch4j-maven-plugin se utiliza para generar el .exe desde las tareas de maven El proyecto MITyCLibXADES-sinadura se utiliza durante el desarrollo para temas de debug y porque hay una parte de la validación XADES relacionada con las multiples cadenas de certificados que igual hay que modificar en un futuro.

Requisitos previos#

Disponer de un equipo con Maven y la JDK 1.6+ Acceso a internet y al repositorio maven de sinadura, donde hemos expuesto las versiones de las librerías necesarias que no se encontraban en los repositorios centrales de maven.

Trabajando con eclipse#

Para poder usar eclipse como IDE de desarrollo hay que tener instalados los plugins de subversion subeclipse y de maven m2. Si disponemos de estos componentes, los proyectos descargados del subversion se integran con éstos y la configuración resulta sencilla.

Para desacargar la rama principal del proyecto hay que acceder al svn de sinadura y descargarse los módulos

Descargando las fuentes#

Lo primero que hay que hacer es acceder a la vista de svn del eclipse

Después crearemos un nuevo repositorio apuntando a la siguiente url, https://svn.zylk.net:446/svn/sinadura-repo/sinadura/

y navegaremos por la estructura de carpetas a cada una de las ramas que queremos descargar. En el caso general, la rama trunk será de lectura y si perteneces a la comunidad de desarrollo dispondrás de una rama dentro de la carpeta branches sobre la que poder realizar commits.

Instalando y compilando los módulos#

Una vez descargados los proyectos y configurados, debería existir una árbol de proyectos equivalente al siguiente.

si el eclipse está configurado de manera que ejecute las tareas de maven automaticamente bastará con ejecutar el main de sinadura para ver la aplicación. Si no habrá que instalar (mvn install) cada uno de los proyectos en el repositorio local de maven para poder ejecutar.

Para ejecuta el main de sinaduraDesktop desde el eclipse basta con situarse sobre la clase Sinadura.java del proyecto sinaduraDesktop y ejecutar como proyecto java

Tal como se ha comentado en la introducción los proyectos principales son sinaduraCore y sinaduraDesktop, aunque de momento es necesario descargar también MITyCLibOCSP-sinadura y MITyCLibTSA-sinadura para poder ejecutar el programa ya que de momento no hemos creado una versión estable de los mismos en el repositorio de maven de sinadura que se pueda utilizar directamente sin necesidad de construirlos en el repositorio local de maven del desarrollador.

Generando los empaquetados#

Trabajando desde linea de comandos#

Descargando las fuentes#

Instalando y compilando los módulos#

Generando los empaquetados#