Este proyecto contiene los script y los recursos necesarios para genera un fichero *.xo*, que son los usados para empaquetar un *Activity* para el Sistema Operativo *Sugar*.

En el directorio podemos encontrar documentación sobre como realizar el proceso, así como recomendaciones sobre los paquetes a incluir en el gvSIG que se use como base del *Activity*.

El directorio base del proyecto se puede encontrar en *org.gvsig.educa.batovi/${version}/org.gvsig.educa.batovi/org.gvsig.educa.batovi.activity* del repositorio.

Los script de generación están desarrollados usando *bash* por lo que deben ser ejecutado en un sistema *Unix-like*.

Los principales scripts son:

* **prepare-bundle.sh**: crea un directorio *target* con lo necesario para generar un *Activity*
* **generate-bundle.sh**: crea el fichero *.xo* dentro de *target* a partir de lo generado por el script **prepare-bundle.sh**.

El proceso está divido en dos para facilitar la inclusión de otro elementos al paquete.

Para más información consultar el fichero *LEEME.txt* del directorio.

Acciones post-install
========================

La clase de *python* preparada para gestionar la *Activity* dispone de un mecanismo de *post-install* que se ejecuta únicamente antes del primer arranque de gvSIG dentro del dispositivo. Las funcionalidades que soporta son:

* `Copia de archivos al directorio de usuario de gvSIG`_.
* `Copia de archivos al directorio de usuario`_.
* `Ejecución de scripts`_.

Estas acciones se pueden preparar justo después de la ejecución del script **prepare-bundle.sh**, añadiendo elementos en los subdirectorios de *target/Batovi.activity/post-install*. Para más información consultar el archivo *README.rst* de dicho directorio o el fuente de la actividad *skeleton/GvSIGActivity.py*.

Copia de archivos al directorio de usuario de gvSIG
------------------------------------------------------

Copia, si no existiese previamente, archivos al directorio *$HOME/gvSIG* del equipo instalado.

Para usar esta característica sólo es necesario copiar los archivos, con la estructura que debe quedar dentro de directorio destino, dentro del directorio  *target/Batovi.activity/post-install/user-gvsig-home*.

Este mecanismo es el usado para instalar los *mapas temáticos* que se desean incluir en la instalación

Copia de archivos al directorio de usuario
-------------------------------------------

Copia, si no existiese previamente, archivos al directorio *$HOME* del equipo instalado.

Para usar esta característica sólo es necesario copiar los archivos, con la estructura que debe quedar dentro de directorio destino, dentro del directorio  *target/Batovi.activity/post-install/user-home*.


Ejecución de scripts
-----------------------

Ejecuta script, ya sean *.sh* o *.py* antes de la primera ejecución de la aplicación.

Para usar esta característica sólo es necesario copiar los scripts, dentro del directorio  *target/Batovi.activity/post-install/scripts*.

Antes de ejecutar los scripts serán establecidas las siguientes variables de entorno:

* ``GVSIG_HOME``: Ruta al directorio donde se encuentra el directorio base de gvSIG (donde se encuentra el `gvSIG.sh`)
* ``GVSIG_ACTIVITY``: Ruta al directorio raíz de la actividad
* ``JAVA_HOME``: Ruta el directorio donde se encuentra la máquina virtual