Document Actions
Batoví activity
Descripción de Batoví activity
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
