Preparación:
------------

#. Debes instalar la aplicación utilizada para crear instaladores de gvSIG en tu ordenador: `InstallJammer `_. La versión 1.2.15 (la más actual en este momento) tiene un bug por lo que deberás emplear un `snapshot de la 1.2 `_. Una vez instalada, asegúrate de que la aplicación installjammer está disponible en el PATH de ejecución (**el ejecutable, no un enlace**).

#. Para poder crear los ejecutables de Windows *gvsig-desktop.exe* y *gvsig-package-installer.exe*, se debe tener en el PATH de ejecución la aplicación `launch4j `_

#. Debes tener en tu workspace el projecto **install** que se encuentra en el SVN. Este proyecto no puede ser un enlace simbólico dentro del workspace.

#. En tu workspace deben estar todos los proyectos que compondran la versión básica de gvSIG, estos proyectos estarán reflejados en el fichero *install/gvsig_default_installation_projects.xml*. Si hay cambios en los proyectos que entrarán en la versión básica debe actualizarse este fichero

Nota. Los ejemplos se han puesto considerando que la versión de gvSIG cuyo instalador se va a generar es la 1.12.0. Si se va a generar un instalador de una versión posterior, sustitúyase donde aparezca 1.12.0 o 1_12_0 por la versión correspondiente.


Pasos a seguir:
---------------

#. Un par de días antes del que está previsto hacer el build se comunica a la lista de desarrollo el número de versión y se espera un poco para que se suban los cambios pendientes

   ejemplo::

     Hi devs,

     As you know gvSIG is working in the release of a new build (number 1411) of the 1.x branch.

     Our intention is to make the build on Thursday so if you have patches to send make it ASAP. If you have some code to send but you can not do it with this schedule write me to see what can be done.

    Please do not commit to the trunk after Thursday until a new notice to simplify the release process.

    Thanks

#. Quitar el build automatically.

#. Sincronización con el svn. Tanto de los proyectos en el repositorio principal como de los que están en otros repositorios (Navtable, Sextante, consecutive numbers, ...). Los proyectos en otros repos deberían tener un tag hecho por los mantenedores previo a la publicación del build, y el release manager debería trabajar sobre ese tag::

     svn update *

#. **Refresh** para todo el workspace.

#. Hacer *clean-all* y *build all* del **build.xml** de **appgvSIG** para el workspace (a través de external tools).

#. Comprobar que gvSIG arranca y carga lo que esperamos

#. Actualizamos el número de versión y el build number.

   El cambio del número de versión en gvSIG se realiza en el archivo *package.info* del proyecto **appgvSIG** en las propiedades *version* y *gvSIG-version* y *state* cuando sea necesario. El número de versión y la etiqueta de la distribución (alpha, beta, RC1, ...) también habrá que cambiarlo en *_fwAndami/theme/andami-theme.xml* (en dos sitios).

   El build number se refleja a través del fichero build.number del proyecto appgvSIG. Tenga en cuenta que si construye el instalador siguiendo esta guia el build.number se incrementará al final del proceso en 1 respecto al valor inicial. Este nuevo valor del build number será el empleado para nombrar a los instaladores, se introducirá automáticamente en las propiedades de los package.info, etc ...

   En el proyecto _fwAndami debe comprobarse que el fichero LEEME y el fichero README reflejan el número de versión correcta. 

#. Ahora ejecutamos la tarea de ant *createInstallersFromSource* del fichero install/deploy.xml.

   Este proceso llamará al target clean-alll y a continuación al target batch-build de todos los proyectos que estén en la lista  *install/gvsig_default_installation_projects.xml*. Incrementará el build number. Creará los enlaces simbólicos en linux y copiará a una posición apta para el instalador las librerías binarias de windows y linux. Empleará launch4j para crear los ejecutables para windows. Empleará installjammer para crear los ejecutables para Windows y Linux.

   Al final del proceso los instaladores estarán en el directorio */install/installjammer/output*.

#. Instalamos la aplicación para probarla y verificamos que la versión es la correcta (en el menú **help/about** tiene que figurar el nuevo build number).

#. Si todo va bien subimos los archivos al servidor webdav de gvsig, en la url

    https://downloads.gvsig.org/download/gvsig-desktop/dists//builds//

   Dar a los ficheros subidos permisos de lectura, escritura y ejecución para todos. Para subir los ficheros al webdav necesitamos tener los `permisos adecuados `_

   El enlace entre la página de descargas de las versiones en desarrollo y los ficheros subidos al webdav se establece automáticamente.

#. Crear de nuevo el índice de los paquetes. Ejemplo
  
   ssh [USER]@shell.forge.osor.eu "cd /home/groups/gvsig-desktop/www/gvSIG-desktop/dists/1.12.0; ../gvspkg mks -c -s"

#. Mover el fichero packages.gvspks a /home/groups/gvsig-desktop/www/downloads/pub/projects/gvSIG-desktop/devel/gvSIG-1_12/gvSIG-1_12_0/[BUILD_NUMBER]/ renombrandolo como gvSIG-desktop-[VERSION]-[BUILD_NUMBER]-[STATE]-all-all.gvspks y generar instaladores estándar:

   .. code-block:: sh

      BN=[BUILD_NUMBER]
     
      DISTS=/home/groups/gvsig-desktop/www/gvSIG-desktop/dists
      cd /home/groups/gvsig-desktop/www/downloads/pub/projects/gvSIG-desktop/devel/gvSIG-1_12/gvSIG-1_12_0/$BN
      # Obtener y renombrar el conjunto de paquetes:
      mv $DISTS/1.12.0/packages.gvspks gvSIG-desktop-1.12.0-$BN-devel-all-all.gvspks
      # Generar instaladores personalizados con jre y conjunto de paquetes:
      $DISTS/gvspkg mkinstall --addjrelin gvSIG-desktop-1.12.0-$BN-devel-lin-x86-online.bin gvSIG-desktop-1.12.0-$BN-devel-all-all.gvspks
      $DISTS/gvspkg mkinstall --addjrewin gvSIG-desktop-1.12.0-$BN-devel-win-x86-online.exe gvSIG-desktop-1.12.0-$BN-devel-all-all.gvspks
      # Renombrar instaladores personalizados a instaladores estándar ("standard"):
      Rename custom installers to "standard" installers
      mv gvSIG-desktop-1.12.0-$BN-devel-lin-x86-custom.bin gvSIG-desktop-1.12.0-$BN-devel-lin-x86-standard.bin
      mv gvSIG-desktop-1.12.0-$BN-devel-win-x86-custom.exe gvSIG-desktop-1.12.0-$BN-devel-win-x86-standard.exe
     
#. Instalar gvSIG y realizar una prueba rápida de los instaladores generados, descargando todos los add-ons y comprobando las funcionalidades básicas (linux, windows, ...).

#. Comitear al repositorio los cambios en los ficheros package.info y build.number con un mensaje tipo
    gvSIG 1.12 Build 1411
    
    Updated build.number and package.info

#. Crear un tag de los ficheros incluidos en el build de instalación, con el número de build y el nombre del tag. Se debe tener en cuenta que una parte del proyecto estará alojado en otros repositorios svn. Si no en los proyectos externo no se está ya operando sobre un tag debería crearse uno ahora

    svn copy -r  https://devel.gvsig.org/svn/gvsig-desktop/trunk https://devel.gvsig.org/svn/gvsig-desktop/tags/v1_12_0_Build_1411 -m "gvSIG 1.12.0 build 1411" 

#. Se debe actualizar la sección `notas de la versión del plone `_ (Formatos, Funcionalidades, Proyectos que componen esta versión).

#. Se deben duplicar las páginas del manual de usuario que hayan sufrido alguna modificación y modificarlas.

#. Pasar los test de persistencia, y también los de funcionalidad en el caso de tratarse de una RC

#. Preparar una pequeña nota de prensa y publicarla