TechManual
Guía de instalación #
- Instalar la máquina virtual de java versión 6 correspondiente al Sistema Operativo
- Variable de entorno JAVA_HOME configurada apuntando a la ruta de instalación de Java.
- Descarga:
- Descargar el aplicativo (sinaduraDesktop_vXXX.zip)
- Descomprimir el aplicativo en una carpeta de nuestra elección
- Arrancar la aplicación Ver http://www.zylk.net/group/sinadura/wik/wiki/sinadura/UserManual.
Configuración de smartcards en Linux #
Configurar las smartcards en linux
Añadir idiomas #
Documento Funcional #
Documento de Diseño #
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:
- Descargar la librería de http://www.bouncycastle.org/download/bctsp-jdk15-141.jar en nuestro directorio raíz (por ejemplo)
- Ejecutar el comando
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:
- Descargar el jar necesario de http://repo1.maven.org/maven2/xerces/xercesImpl/2.9.0/xercesImpl-2.9.0.jar
- Ejecutar el comando
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