TechManual

Guía de instalación #

Configuración de smartcards en Linux #

Configurar las smartcards en linux

Añadir idiomas #

Como añadir nuevos idiomas

Documento Funcional #

Análisis de la solución

Documento de Diseño #

Diseño del sistema

JavaDoc #

Descargar el fichero adjunto javadoc_firma.tar

Descarga y uso de las fuentes #

El desarrollo del proyecto Sinadura hace uso de las características del proyecto Maven de Apache http://maven.apache.org/ por ello y previo al manejo de las fuentes, es interesante tener instalado Maven en nuestra máquina y así poder aprovechar las facilidades que nos aporta. Obviamente las fuentes siguen estando disponibles sin uso de Maven. Más detalles sobre la instalación de Maven en la pagina de maven

Instalado Maven seguimos con los pasos siguientes.

Descarga #

Las fuentes del proyecto Sinadura se encuentran disponibles en Sourceforge en la siguiente dirección: https://sinadura.svn.sourceforge.net/svnroot/sinadura/

Por lo que no tenemos más que crearnos una carpeta y realizar los checkouts correspondientes de la siguiente forma:

mkdir sinadura
svn co https://sinadura.svn.sourceforge.net/svnroot/sinadura/trunk/

O descargarnos directamente el tarball desde el cliente web del subversion de sourceforge

En cualquier caso acabamos teniendo dos carpetas descargadas sinaduraCore y sinaduraDesktop.

El core #

Lo primero que necesitamos es disponer de la librería core que va a ser utilizada por el desktop. Para la generación del core ejecutamos los siguientes comandos:

cd sinadura/trunk/sinaduraCore
mvn clean install

Esto instalará el jar de sinaduraCore en nuestro repositorio Maven local, típicamente en la ruta /home/usuario/.m2

Puede que salga un error de dependencias como el siguiente


Missing:

1) bouncycastle:bctsp:jar:jdk15-135

  Try downloading the file manually from the project website.

  Then, install it using the command:
      mvn install:install-file -DgroupId=bouncycastle -DartifactId=bctsp -Dversion=jdk15-135 
                        -Dpacka ging=jar -Dfile=/path/to/file

  Alternatively, if you host your own repository you can deploy the file there:
      mvn deploy:deploy-file -DgroupId=bouncycastle -DartifactId=bctsp 
                         -Dversion=jdk15-135 -Dpackaging=jar 
                         -Dfile=/path/to/file -Durl=[url] -DrepositoryId=[id]

  Path to dependency:
        1) sinadura:sinaduraCore:jar:1.3
        2) bouncycastle:bctsp:jar:jdk15-135

1 required artifact is missing.

for artifact:
  sinadura:sinaduraCore:jar:1.3

Esto se debe a que la librería bctsp_xxxx.jar no se encuentra en los repositorios por defecto de Maven. Para solucionarlo nos los instalamos a mano como nos sugiere el mensaje de error. Para ello:

mvn install:install-file -DgroupId=bouncycastle -DartifactId=bctsp -Dversion=jdk15-141 
          -Dpackaging=jar -Dfile=/home/usuario/bctsp-jdk15-141.jar

Con la librería instalada volvemos a ejecutar

mvn clean install

El desktop #

Una vez que tenemos disponible la librería core pasamos a generar la librería desktop y los correspondientes ficheros de distribución tar.gz instalador java e instalador windows.

Antes de ejecutar el comando de Maven vamos a tener que realizar una instalación, como la realizada en la parte core. Se trata de otra dependencia no resuelta por el plugin de izpack que es el que se utiliza para la generación del instalador java. En versiones futuras si se corrigen las dependencias de terceros no será necesario realizar esta instalación.

Para la instalación:

mvn install:install-file -DgroupId=org.bluestemsoftware.open.maven.tparty \
-DartifactId=xerces-impl -Dversion=2.9.0 -Dpackaging=jar \
-Dfile=/home/usuario/xercesImpl-2.9.0.jar

Instalada la librería podemos generar los paquetes de distribución. Disponemos de diferentes opciones según las necesidades:

mvn clean package -P Unix32
mvn clean package -P Unix64
mvn clean package -P Mac
mvn clean package -P Win32

Cualquiera de ellas compila los fuentes y deja en la carpeta target un fichero tar.gz y un fichero de instalador java.

A partir de aquí el uso descrito en el manual de instalación /wiki/sinadura/InstallManual

Notas adicionales #

  • En el caso de la plataforma Windows disponemos de una opción más
mvn clean pre-integration-test -P Win32

Esta opción, además de lo anterior nos genera un fichero de instalación .exe, pero para ello es necesario tener instalado Python en nuestra máquina, ya que lo que se ejecuta es un script py de transformación.

  • En las plataformas Unix una vez hecha la instalación nos puede salir el mensaje de "Permiso Denegado" por lo que hay que dar permisos de ejecución al script
cd /home/usuario/sinadura/bin
chmod +x sinadura
1 Adjunto
14818 Accesos
Promedio (0 Votos)
Comentarios