Aplicación gvSIG con fines educativos » Interfaz de usuario

#!/bin/bash

function usage() {

   echo "Generate bundle"

   echo ""

   echo "Usage:"

   echo "    $0"

}

SCRIPT_FILE=`readlink -f $0`

SCRIPT_PATH=`dirname $0`

WORK_FOLDER="$SCRIPT_PATH/target"

ACTIVITY_FOLDER_NAME="Batovi.activity"

ACTIVITY_FOLDER="$WORK_FOLDER/$ACTIVITY_FOLDER_NAME"

TARGET_FILE_NAME="org.gvsig.educa.batovi.xo"

TARGET_FILE="$WORK_FOLDER/$TARGET_FILE_NAME"

if [ ! -d "$ACTIVITY_FOLDER" ] ; then

  usage

  echo ""

  echo "Work folder does not exist. Missing 'prepare-bundle.sh' execution?"

  exit 1;

fi

if [ -f "$TARGET_FILE" ] ; then

  echo "Cleaning previso bundle..."

  rm "$TARGET_FILE"

fi

# Generate MANIFEST file

echo "Creating MANIFEST..."

cd "$ACTIVITY_FOLDER"

find ./ | sed "s,^./,$ACTIVITY_FOLDER_NAME/,g" > MANIFEST

echo "Adjusting scripts permission..."

# Adjust shell script permission

find . -name '*.sh' -exec chmod a+x {} ';'

# Adjust python script permission

find . -name '*.py' -exec chmod a+x {} ';'

# Generate .xo file

echo "Generating bundle file..."

cd ..

zip -r $TARGET_FILE_NAME $ACTIVITY_FOLDER_NAME

echo "Generated bundle file $TARGET_FILE"

echo "Done."

<?xml version="1.0" encoding="UTF-8"?>

<xml-tag xmlns="http://www.gvsig.gva.es">

	<xml-tag>

		<property key="Skin-Selected" value="org.gvsig.educa.batovi.app.skin.BatoviSkin" />

		<property key="DefaultBrowser" value="Firefox" />

		<property key="com.iver.andami.pluginName" value="org.gvsig.coreplugin" />

	</xml-tag>

	<xml-tag>

		<property key="MDIFrameSize" value="1200 ,900" />

		<property key="MDIFramePos" value="0 ,0" />

		<property key="MDIFrameState" value="6" />

		<property key="com.iver.andami.pluginName" value="Andami.Launcher" />

	</xml-tag>

</xml-tag>

#!/bin/sh

# Fixes symbolic link of GDAL library (if any)

OUT_FILE="$0.sh_out"

touch "$OUT_FILE"

echo "Check for $GVSIG_HOME/native/libgdal.so" >> "$OUT_FILE"

if [ -f "$GVSIG_HOME/native/libgdal.so"] ; then

  rm "Delete $GVSIG_HOME/native/libgdal.so" &>> "$OUT_FILE"

  rm "$GVSIG_HOME/native/libgdal.so" &>> "$OUT_FILE"

fi;

echo "Check for $GVSIG_HOME/native/libgdal.so.1" >> "$OUT_FILE"

if [ -f "$GVSIG_HOME/libgdal.so.1"] ; then

  rm "Delete $GVSIG_HOME/native/libgdal.so.1" &>> "$OUT_FILE"

  rm "$GVSIG_HOME/native/libgdal.so.1" &>> "$OUT_FILE"

fi;

echo "Check for $GVSIG_HOME/native/libgdal.so.1.*" >> "$OUT_FILE"

GDAL_LIB=`ls $GVSIG_HOME/native/libgdal.so.1.*`

echo "Found: $GDAL_LIB" >> "$OUT_FILE"

if [ -f "$GDAL_LIB" ] ; then

  echo "ln -s $GDAL_LIB $GVSIG_HOME/native/libgdal.so" >> "$OUT_FILE"

  ln -s "$GDAL_LIB" "$GVSIG_HOME/native/libgdal.so" &>> "$OUT_FILE"

  echo "ln -s $GDAL_LIB $GVSIG_HOME/native/libgdal.so.1" >> "$OUT_FILE"

  ln -s "$GDAL_LIB" "$GVSIG_HOME/native/libgdal.so.1" &>> "$OUT_FILE"

fi

#!/bin/bash

function usage() {

   echo "Customize gvSIG installation"

   echo ""

   echo "Usage:"

   echo ""

   echo "    $0 -g {path-to-gvsig-tocustomize} -r {path-to-resources-folder} -w {path-to-work-folder} -a {path-to-activity-folder}"

   echo ""

   echo "Options:"

   echo ""

   echo "-g {path-to-gvsig-tocustomize}: path where gvSIG v2.0 is to customize"

   echo "-r {path-to-resources-folder}: path to resources folder"

   echo "-w {path-to-work-folder}: path to work folder"

   echo "-a {path-to-activity-folder}: path to work activity folder"

}

## Replace a regular expression in a file by a string

#

# Params:

# * File

# * Regular expression

# * Final string

#

function replaceInFile(){

  FILE_TO_REPLACE="$1"

  BACKUP_FILE="$FILE_TO_REPLACE.back"

  RE_FOR_SED="$2"

  FINAL_STRING="$3"

  cp "$FILE_TO_REPLACE" "$BACKUP_FILE"

  sed "s/$RE_FOR_SED/$FINAL_STRING/" "$BACKUP_FILE" > "$FILE_TO_REPLACE"

  rm "$BACKUP_FILE"

}

#set -x

while getopts "g:r:w:a:" OPT 

do	case "$OPT" in

	g)	export TARGET_GVSIG_FOLDER="$OPTARG";;

	r)	export RESOURCE_FOLDER="$OPTARG";;

	w)	export WORK_FOLDER="$OPTARG";;

	a)	export ACTIVITY_FOLDER="$OPTARG";;

	[?])	usage;	

		exit 1;;

	esac

done

set +e

if [ "x$TARGET_GVSIG_FOLDER" == "x" ] ; then

  usage

  echo ""

  echo "ERROR: Missing -g option"

  exit 1;

fi;

if [ ! -d "$TARGET_GVSIG_FOLDER" ] ; then

  usage

  echo ""

  echo "ERROR: $TARGET_GVSIG_FOLDER is not a gvSIG installation folder"

  exit 1;

fi;

if [ ! -d "$TARGET_GVSIG_FOLDER/gvSIG" ] ; then

  usage

  echo ""

  echo "ERROR: $TARGET_GVSIG_FOLDER is not a gvSIG installation folder"

  exit 1;

fi;

if [ ! -f "$TARGET_GVSIG_FOLDER/gvSIG.sh" ] ; then

  usage

  echo ""

  echo "ERROR: $TARGET_GVSIG_FOLDER is not a gvSIG installation folder"

  exit 1;

fi;

if [ ! -d "$TARGET_GVSIG_FOLDER/gvSIG/extensiones" ] ; then

  usage

  echo ""

  echo "ERROR: $TARGET_GVSIG_FOLDER is not a gvSIG installation folder"

  exit 1;

fi;

if [ "x$RESOURCE_FOLDER" == "x" ] ; then

  usage

  echo ""

  echo "ERROR: Missing -r option"

  exit 1;

fi;

if [ ! -d "$RESOURCE_FOLDER" ] ; then

  usage

  echo ""

  echo "ERROR: $RESOURCE_FOLDER is not a folder"

  exit 1;

fi;

if [ "x$WORK_FOLDER" == "x" ] ; then

  usage

  echo ""

  echo "ERROR: Missing -w option"

  exit 1;

fi;

if [ ! -d "$WORK_FOLDER" ] ; then

  usage

  echo ""

  echo "ERROR: $WORK_FOLDER is not a folder"

  exit 1;

fi;

if [ "x$ACTIVITY_FOLDER" == "x" ] ; then

  usage

  echo ""

  echo "ERROR: Missing -a option"

  exit 1;

fi;

if [ ! -d "$ACTIVITY_FOLDER" ] ; then

  usage

  echo ""

  echo "ERROR: $ACTIVITY_FOLDER is not a folder"

  exit 1;

fi;

echo "Removing unused files..."

rm "$TARGET_GVSIG_FOLDER/uninstall"

rm "$TARGET_GVSIG_FOLDER/README.txt"

rm "$TARGET_GVSIG_FOLDER/LEEME.txt"

if [ ! -n `ls "$TARGET_GVSIG_FOLDER/install/"` ] ; then

  rm $TARGET_GVSIG_FOLDER/install/*

fi

echo "Adding andami-config.xml..."

cp "$RESOURCE_FOLDER/andami-config.xml" "$ACTIVITY_FOLDER/post-install/user-gvsig-home"

echo "Fixing gvSIG theme files..."

cp "$RESOURCE_FOLDER/one_pixel.png" "$TARGET_GVSIG_FOLDER/gvSIG/extensiones/org.gvsig.app/theme/gvsig-proj-black-wallpaper.png" 

echo "Adjusting removing JAVA_HOME from gvSIG.sh (will be initialized at activity startup)..."

replaceInFile "$TARGET_GVSIG_FOLDER/gvSIG.sh" "export[ ]JAVA_HOME=.*$" "#export JAVA_HOME=INITIALIZED BY ACTIVITY"

echo "Adjusting JVM memory settings..."

if [ -n "$GVSIG_INITIAL_MEM" ] ; then

  echo "    GVSIG_INITIAL_MEM=$GVSIG_INITIAL_MEM"

  replaceInFile "$TARGET_GVSIG_FOLDER/gvSIG.sh" "GVSIG_INITIAL_MEM=[0-9]*[MG]" "GVSIG_INITIAL_MEM=$GVSIG_INITIAL_MEM"

fi

if [ -n "$GVSIG_MAX_MEM" ] ; then

  echo "    GVSIG_MAX_MEM=$GVSIG_MAX_MEM"

  replaceInFile "$TARGET_GVSIG_FOLDER/gvSIG.sh" "GVSIG_MAX_MEM=[0-9]*[MG]" "GVSIG_MAX_MEM=$GVSIG_MAX_MEM"

fi

if [ -n "$GVSIG_MAX_PERM_SIZE" ] ; then

  echo "    GVSIG_MAX_PERM_SIZE=$GVSIG_MAX_PERM_SIZE"

  replaceInFile "$TARGET_GVSIG_FOLDER/gvSIG.sh" "GVSIG_MAX_PERM_SIZE=[0-9]*[MG]" "GVSIG_MAX_PERM_SIZE=$GVSIG_MAX_PERM_SIZE"

fi

if [ -d "$TARGET_GVSIG_FOLDER/gvSIG/extensiones/org.gvsig.educa.batovi.app.skin" ] ; then

  echo "Adding plugin-persistence to set Skin to Batovi.app.skin..."

  cp "$RESOURCE_FOLDER/plugins-persistence-2_0.xml" "$ACTIVITY_FOLDER/post-install/user-gvsig-home"

fi

GDAL_FILES=`ls $TARGET_GVSIG_FOLDER/native/libgdal.so* 2> /dev/null`

if [ -n "$GDAL_FILES" ] ; then 

  echo "Removing gdal symbolic links"

  rm $TARGET_GVSIG_FOLDER/native/libgdal.so $TARGET_GVSIG_FOLDER/native/libgdal.so.1

  echo "Copying post-install script to fix gdal symbolic links"

  cp "$RESOURCE_FOLDER/fix_gdal_links.sh" "$ACTIVITY_FOLDER/post-install/scripts/"

fi

#echo "Resizing png images (x2)"

#find "$TARGET_GVSIG_FOLDER/gvSIG/extensiones" -name '*.png' -print -exec mogrify -resize 200% {} ';'

echo "Resizing png images..."

images=`find "$TARGET_GVSIG_FOLDER/gvSIG/extensiones" -name '*.png'`

for image in $images

do

  img_size=`file $image | grep " [0-9]* x [0-9]*" -o | grep -o "[0-9]*"`

  ratio=""

  for aSize in $img_size

  do

    if [ $aSize -le 32 ] ; then

      ratio="200%"

      break

    fi

    if [ $aSize -le 64 ] ; then

      ratio="150%"

      break

    fi

    if [ $aSize -le 128 ] ; then

      ratio="125%"

      break

    fi

  done

  if [ -n "$ratio" ] ; then

    image_caption=`echo "$image" | sed "s/.*[/]gvSIG[/]extensiones[/]//"`

    echo "$image_caption [ $ratio ]"

    mogrify -resize "$ratio" "$image"

  fi

done

<?xml version="1.0" encoding="UTF-8"?>

<andami-config locale-language="es" locale-country="" locale-variant="" lookAndFeel="com.sun.java.swing.plaf.gtk.GTKLookAndFeel" pluginsDirectory="gvSIG/extensiones">

  <andami update="true"/>

  <plugin name="org.gvsig.app" update="false"/>

</andami-config>

#!/bin/bash

SCRIPT_FILE=`readlink -f $0`

SCRIPT_PATH=`dirname $0`

WORK_FOLDER="$SCRIPT_PATH/target"

# clean work folder (if any)

if [ -e "$WORK_FOLDER" ] ; then

  echo "Cleaning work folder..."

  rm -r "$WORK_FOLDER"

fi

===============

gvSIG Educa

===============

------------------------------------------------------------------------

Adaptación de gvSIG con fines educativos: Sugerencias de configuración

------------------------------------------------------------------------

Preparar una actividad para el OLPC

====================================

Para preparar una actividad (un fichero ``.xo``) hay que seguir los pasos del fichero *LEEME.rst*. En uno hya que prepara una instalación de gvSIG v2.0.

Pero, ¿Cómo debe de estar la instalación?. En este documento sugerimos los paquetes a incluir y los pasos adicionales necesarios.

Los pasos son:

# `Descargar el instalador`_ de gvSIG

# `Instalar los add-ons`_ a incluir

# `Otras configuraciones`_

Descargar el instalador

========================

Descargar de la página de descargas oficial la última versión de gvSIG v2.0 para linux que esté disponible, dar permisos de ejecución al fichero y arrancar la instalación.

Instalar los add-ons

=====================

Seguir las acciones del asistente hasta alcanzar el instalador de complementos.

En esta sección haremos sugerencias de paquetes dependiendo de:

* `Configuración Básica`_ Para equipos escasos de recurso, solo visionado de cartografía.

* `Configuración Estándar`_ Configuración estándar para visionado de cartografía.

* `Configuración con edición`_ Configuración que permita el visionado y creación de cartografía y mapas temáticos.

Configuración Básica

----------------------

Una configuración mínima que permita visualizar cartografía y mapas temáticos con capas vectoriales sería:

* Add-on manager

* Application gvSIG

* Default icon set

* Formats: GML/KML

* Formats: WFS

* Internationalization support

* Online basic help

* Skin management framework

* Thematic Maps viewer document

* Tools: Center view to point

* Tools: Hyperlink

* Tools: Locator by attribute

Esta configuración, junto al uso del *profile* ``minimum``, podría servir para equipos de unos 512Mb de RAM. Requerirá en disco sobre 40Mb (más los mapas temáticos que se incluyan).

Configuración Estándar

-----------------------

Una configuración estándar que permita visualizar cartografía y mapas temáticos con capas vectoriales y raster, además de algunas utilidades (como generar mapas) sería:

* Add-on manager

* Application gvSIG

* Default icon set

* Document: Layout

* Document: Table

* Formats: Gdal

* Formats: GML/KML

* Formats: WFS

* Internationalization support

* Online basic help

* Skin management framework

* Thematic Maps viewer document

* Tools: Center view to point

* Tools: Hyperlink

* Tools: Locator by attribute

* Transformation: Event theme

* Transformation: Join

* Transforms framework

* Web Catalog Service support

* Web Gazetteer Service client

* y el *Soporte Raster* (ver `Instalar soporte Raster`_ )

Esta instalación ocupará en disco unos 120Mb (más los mapas temáticos que se incluyan).

.. admonition:: Recordar

    Despues de instalar cualquier paquete es necesario reiniciar gvSIG (cerrar **y volver a arrancar**)

Configuración con edición

----------------------------------

Una configuración estándar que permita visualizar y preparar cartografía y mapas temáticos con capas vectoriales y raster, además de algunas utilidades (como generar mapas) sería:

* Add-on manager

* Application gvSIG

* Database conectors

* Default icon set

* Document: Layout

* Document: Table

* Export framework

* Formats: Gdal

* Formats: GML/KML

* Formats: WFS

* Internationalization support

* Online basic help

* Skin management framework

* Thematic Maps generator

* Thematic Maps viewer document

* Tools: Center view to point

* Tools: Export to annotation

* Tools: Field calculator

* Tools: Geometry editing

* Tools: Geometry measurement

* Tools: Hyperlink

* Tools: Import marker symbols tool

* Tools: Install marker symbols tool

* Tools: Locator by attribute

* Tools: New layer

* Tools: Selection tools

* Transformation: Event theme

* Transformation: Join

* Transforms framework

* Web Catalog Service support

* Web Gazetteer Service client

* y el *Soporte Raster* (ver `Instalar soporte Raster`_ )

Esta instalación ocupará en disco unos 140Mb (más los mapas temáticos que se incluyan).

.. admonition:: Recordar

    Despues de instalar cualquier paquete es necesario reiniciar gvSIG (cerrar **y volver a arrancar**)

Instalar soporte Raster

--------------------------

Ya que el linux en el que está basado el S.O. de los OLPC es un *Fedora 11*, es necesario instalar el soporte básico preparado para esta plataforma.

Sin en la distribución estándar no está disponible (no aparece el paquete *Raster base support* con el logo en forma de *f* de fedora), puede descargarse el fichero del componente de https://devel.gvsig.org/download/projects/gvsig-educa/pool/org.gvsig.raster.tilecache.app/ en instalarlo usando la opción de *Fichero* en el instalador.

Despues de instalar el soporte básico de raster instalaremos los siguientes paquetes de la instalación estándar:

* Formats: WCS

* Formats: WMS

* Tools: Raster tools

.. admonition:: Recordar

    Despues de instalar cualquier paquete es necesario reiniciar gvSIG (cerrar **y volver a arrancar**)

Otras configuraciones

========================

En esta sección describimos otros pasos a realizar para afinar la instalación de gvSIG 2.0.

Skin Batovi

-------------

En el directorio *org.gvsig.batovi.app* (hermano del actual) está el plugin de gvSIG que contiene un Skin personalizado.

Para instalar, tener generado el paquete del add-on (fichero ``.gvspkg``), arrancar el gvSIG que estamos preparando e installar usando el *Administrador de Add-on*.

Deshabilitar extensiones

-------------------------

Es recomendable desactivar algunas extensiones que vienen activas por defecto. 

Para ello, una vez instalada la aplicación acceder al panel de configuración del menú ``Ver/Preferencias`` y, dentro de la rama ``General/extensiones`` buscar las siguientes y _desmarcar_ la opción ``Extensión activa``.

* org.gvsig.app.extension.ShowDevelInfoExtension

* org.gvsig.installer.app.extension.creation.MakePluginPackageExtension

* org.gvsig.app.extension.dispose.DisposableManagementExtension

===============

gvSIG Educa

===============

-------------------------------------------------

Adaptación de gvSIG con fines educativos

-------------------------------------------------

Descripción

==============

Este fichero contiene información para generar un paquete de instalación de gvSIG personalizado que puede instalarse en el sistema operativo *Sugar* de los OLPC.

Contenido del directorio

===========================

* *profiles* : Directorio con configuraciones de entorno de ejecución para usar en la creación de la actividad

* *resource*: Recursos que son utilizados en la generación de la activida

* *skeleton*: Esqueleto de la activida, incluye los fichero de información, estructura de directorio y scrits de ejecución de la actividad.

* *README.rst* *LEEME.rst*: Este fichero

* *Sugerencias_de_configuracion.rst*: Documento con sugerencias para preparar gvSIG 2.0 para empaquetar

Requisitos

==============

* *Sistema operativo Linux*: Por ser *Sugar* un sistema operativo basado en Linux-base (*Fedora 9*)

Generar el paquete de instalación

=====================================

Esta sección explica como generar un paquete de *activida* (fichero ``.xo``).

Instalar gvSIG 2.0

---------------------

Es necesario instalar gvSIG v2.0 en el sistema para poder usarla como base de plugins y configuraciones que deseamos tener en la distribución para el OLPC.

Para más información sobre que paquetes/complementos instalar en gvSIG ver el fichero *Sugerencias_de_configuracion.rst*.

Limpiar compilación previa

----------------------------

Para limpiar una ejecución previa solo es necesario borrar el directorio de trabajo *target* o ejecutar el script *clean.sh* ::

   bash$ ./clean.sh

Preparar el paquete

---------------------

En este paso prepararemos el directorio temporal para general el paquete. Para ello ejecutar el script *prepare-bundle.sh*. Este script soporta los siguiente parámetros:

* ``-g {path}``:  *[obligatorio]* Directorio donde está la instalación de gvSIG 2.0 a usar como base.

* ``-p {profile}``:  *[opcional, standard por defecto]* Profile a usar para configura el entorno de ejecucion de gvSIG en el OLPC.

* ``-v {pkgVersion}``: *[obligatorio][entero]* Versión para el paquete generado.

* ``-t``: *[optional]* Incluir los mapas temáticos instalados en el directorio del usuario.

Un ejemplo de ejecución::

   bash$ ./prepare-bundle.sh -g "/tmp/gvSIG-2.0" -v 3

Este script, dentro de su proceso, ejecuta el script *resources/customize-gvSIG.sh* que ajusta gvSIG para el funcionamiento en el OLPC.

El script genera un directorio *target* que contiene el contenido que se usará para generar el *bundle*. Puede realizar, después de la ejecución del script, cualquier modificación que necesite hacer a mano.

El parámetro ``-t`` incluye todos los *mapas temáticos* que estén instalados en el directorio local de gvSIG (localizados en el directorio *~/gvSIG/plugins/org.gvsig.educa.thematicmap.app.viewer*).

Generar el paquete

--------------------

En este paso se genera el fichero ``.xo``` de la actividad. Únicamente es necesario ejecutar el script *generate-bundle.sh* ::

   bash$ ./generate-bundle.sh

#!/bin/bash

function usage() {

   echo "Prepare work folder to generate bundle"

   echo ""

   echo "Usage:"

   echo ""

   echo "    $0 -g {path-to-gvsig-installation} -v {bundle-version} [-p {profile}] [-t]"

   echo ""

   echo "Options:"

   echo ""

   echo "-g {path-to-gvsig-installation}: path where gvSIG v2.0 is installed"

   echo "-v {bundle-version}: path where gvSIG v2.0 is installed"

   echo "-p {profile}: profile to use (default 'standard')"

   echo "-t Include Thematic Maps from ~/gvSIG/plugins/org.gvsig.educa.thematicmap.app.viewer"

   echo ""

   echo "Availables profiles:"

   echo ""

   curpath=$PWD

   cd "$SCRIPT_PATH/profiles"

   for profile in *.profile

   do

      profile_name=`echo "$profile" | sed "s/[.]profile//"`

      profile_desc=`cat $profile_name.description`

      echo "  $profile_name :  $profile_desc"

   done

   cd "$curpath"

}

#set -x

SCRIPT_FILE=`readlink -f $0`

SCRIPT_PATH=`dirname $0`

PROFILE_TO_USE=standard

while getopts "g:v:p:t" OPT 

do	case "$OPT" in

	g)	SOURCE_GVSIG_FOLDER="$OPTARG";;

	v)	XO_PKG_VERSION="$OPTARG";;

	p)	PROFILE_TO_USE="$OPTARG";;

	t)	INCLUDE_THEMATIC_MAPS="true";;

	[?])	usage;	

		exit 1;;

	esac

done

set +e

if [ "x$SOURCE_GVSIG_FOLDER" == "x" ] ; then

  usage

  echo ""

  echo "ERROR: Missing -g option"

  exit 1;

fi;

if [ "x$SOURCE_GVSIG_FOLDER" == "x" ] ; then

  usage

  echo ""

  echo "ERROR: Missing -g option"

  exit 1;

fi;

if [ ! -d "$SOURCE_GVSIG_FOLDER" ] ; then

  usage

  echo ""

  echo "ERROR: $SOURCE_GVSIG_FOLDER is not a gvSIG installation folder"

  exit 1;

fi;

if [ ! -d "$SOURCE_GVSIG_FOLDER/gvSIG" ] ; then

  usage

  echo ""

  echo "ERROR: $SOURCE_GVSIG_FOLDER is not a gvSIG installation folder"

  exit 1;

fi;

if [ ! -f "$SOURCE_GVSIG_FOLDER/gvSIG.sh" ] ; then

  usage

  echo ""

  echo "ERROR: $SOURCE_GVSIG_FOLDER is not a gvSIG installation folder"

  exit 1;

fi;

if [ ! -d "$SOURCE_GVSIG_FOLDER/gvSIG/extensiones" ] ; then

  usage

  echo ""

  echo "ERROR: $SOURCE_GVSIG_FOLDER is not a gvSIG installation folder"

  exit 1;

fi;

if [ "x$XO_PKG_VERSION" == "x" ] ; then

  usage

  echo ""

  echo "ERROR: Missing -v option"

  exit 1;

fi;

expr "$XO_PKG_VERSION" + 1 2> /dev/null > /dev/null

if [ ! $? = 0 ] ; then

  usage

  echo ""

  echo "ERROR: Invalid value for -v"

  exit 1;

fi

if [ "$XO_PKG_VERSION" -le 0 ] ; then

  usage

  echo ""

  echo "ERROR: Invalid value for -v"

  exit 1;

fi;

if [ ! -f "$SCRIPT_PATH/profiles/$PROFILE_TO_USE.profile" ] ; then

  usage

  echo ""

  echo "ERROR: Ivalid profile $PROFILE_TO_USE"

  exit 1;

fi;

echo "Playing profile ($PROFILE_TO_USE)..."

set -e

source "$SCRIPT_PATH/profiles/$PROFILE_TO_USE.profile"

set -e

WORK_FOLDER="$SCRIPT_PATH/target"

# clean work folder (if any)

if [ -e "$WORK_FOLDER" ] ; then

  echo "Cleaning work folder..."

  rm -r "$WORK_FOLDER"

fi

# create work folder

echo "Creating work folder..."

mkdir "$WORK_FOLDER"

# copy base activity files

ACTIVITY_FOLDER="$WORK_FOLDER/Batovi.activity"

echo "Copying base activity files..."

tar c --exclude-vcs --exclude-backups skeleton  | tar x -C "$WORK_FOLDER"

mv "$WORK_FOLDER/skeleton" "$ACTIVITY_FOLDER"

# set bundle version

echo "Updating bundle version ($XO_PKG_VERSION)...."

cp "$ACTIVITY_FOLDER/activity/activity.info" "$WORK_FOLDER/tmp.info"

sed "s/[$][{]version[}]/$XO_PKG_VERSION/" "$WORK_FOLDER"/tmp.info > "$ACTIVITY_FOLDER/activity/activity.info"

rm "$WORK_FOLDER"/tmp.info

info=`cat "$ACTIVITY_FOLDER/activity/activity.info"`

if [ -e "$info" ] ; then

   echo "ERROR: in info file: Empty"

fi

# copy gvSIG files

echo "Copying gvSIG app files (from $SOURCE_GVSIG_FOLDER)..."

TARGET_GVSIG_FOLDER="$ACTIVITY_FOLDER/gvSIG"

GVSIG_FILES=`ls $SOURCE_GVSIG_FOLDER`

tar c --exclude-vcs --exclude-backups -C $SOURCE_GVSIG_FOLDER  $GVSIG_FILES | tar x -C $TARGET_GVSIG_FOLDER

# clean install folder

echo "Clean gvSIG install folder..."

rm -rf $TARGET_GVSIG_FOLDER/install/*

# clean install folder

echo "Clean gvSIG plugins install folder..."

to_remove=`find $TARGET_GVSIG_FOLDER/gvSIG/extensiones -name "install" -type d`

for file_to_remove in $to_remove

  do

    echo "    $file_to_remove"

    rm -r "$file_to_remove"

  done

# Call customizer script

echo "Calling customized gvSIG Installation script ($SCRIPT_PATH/resources/customize-gvSIG.sh)..."

echo ""

set -e

"$SCRIPT_PATH/resources/customize-gvSIG.sh" -g "$TARGET_GVSIG_FOLDER" -r "$SCRIPT_PATH/resources" -w "$WORK_FOLDER" -a "$ACTIVITY_FOLDER"

echo ""

set +e

echo "customized script Done. Resuming..."

# include thematic maps

if [ "$INCLUDE_THEMATIC_MAPS" == "true" ] ; then {

  echo "Check for installed Thematic Maps..."

  # Check if there is any thematic map

  GVSIG_PLUGINS_FOLDER="$HOME/gvSIG/plugins"

  THEMATIC_MAPS_PLUGIN_FOLDER="$GVSIG_PLUGINS_FOLDER/org.gvsig.educa.thematicmap.app.viewer"

  THEMATIC_MAPS_INSTALL_FOLDER="$THEMATIC_MAPS_PLUGIN_FOLDER/thematicMaps"

  if [ -d "$THEMATIC_MAPS_INSTALL_FOLDER" ] ; then {

    THEMATIC_MAP_LIST=`ls $THEMATIC_MAPS_INSTALL_FOLDER`

    if [ ! -e "$THEMATIC_MAP_LIST" ] ; then {

      TARGET_THEMATICMAP_FOLDER="$ACTIVITY_FOLDER/post-install/user-gvsig-home/plugins/org.gvsig.educa.thematicmap.app.viewer"

      # create folder for plugins in post-install folder

      mkdir -p "$TARGET_THEMATICMAP_FOLDER"

      echo "Copying Thematic Maps..."

      # copy thematic maps

      tar c --exclude-vcs --exclude-backups -C "$THEMATIC_MAPS_PLUGIN_FOLDER" thematicMaps | tar x -C  "$TARGET_THEMATICMAP_FOLDER"

      echo "Thematic Maps included:"

      echo ""

      ls "$TARGET_THEMATICMAP_FOLDER/thematicMaps"

      echo ""

    }

    else {

      # No found Thematic Maps installed

      echo "No Thematic Maps installed (none installed)..."

    }

    fi

  } 

  else {

    # No found Thematic Maps install folder

    echo "No Thematic Maps installed (install folder $THEMATIC_MAPS_INSTALL_FOLDER not found)..."

  }

  fi

}

fi

echo "Done."

#!/bin/sh

export GVSIG_INITIAL_MEM="90M"

export GVSIG_MAX_MEM="280M"

export GVSIG_MAX_PERM_SIZE="80M"

Stardart configuration for a system with RAM >= 512Mb

#!/bin/sh

export GVSIG_INITIAL_MEM="30M"

export GVSIG_MAX_MEM="75M"

export GVSIG_MAX_PERM_SIZE="60M"

Configuration for a system with RAM < 512Mb

===============

gvSIG Educa

===============

-------------------------------------------------

Customization of gvSIG for education purpose

-------------------------------------------------

Description

==============

This file contensts information to generate a custom gvSIG instalation package for OLPC Operation Sistem *Sugar*

Requirements

==============

* *Linux S.O.*: As *Sugar* is a Linux-base Operation System.

Generate distribution package

==============================

This section explains how to generate the package (the ``.xo`` file).

Install gvSIG 2.0

-------------------

We need to install a gvSIG v2.0 in our system. On it, we install all plug-ins which we want to incluide in the OLPC distribution.

See *Sugerencias_de_configuracion.rst* for information about packages to install.

Clean previous compilations

----------------------------

Before start clean the work folder of previous generating process (if any). Just remove ``target`` folder or execute the ``clean.sh`` script::

   bash$ ./clean.sh

Prepare bundle

----------------

In this step we going to prepare a temporal folder where the package contents will be copied. To do it execute ``prepare-bundle.sh`` script which allows this parameters:

* ``-g {path}``:  *[mandatory]* Specifies where is the gvSIG 2.0 instalation to use as base

* ``-p {profile}``:  *[optiona default standard]* Specifies which profile must use to configure OLPC execution environ.

* ``-v {pkgVersion}``: *[mandatory][integer]* Version for the target *Activity* package.

* ``-t``: *[optional]* Include installed Thematic Maps

An example of this command could be::

   bash$ ./prepare-bundle.sh -g "/tmp/gvSIG-2.0" -v 3

This script also executes *resources/customize-gvSIG.sh* which adjust gvSIG configurations.

This command generates a ``target`` folder with contents of bundle. You can make any change on it at this point in order of include extra content.

The ``-t`` includes all Thematic Map installed in gvSIG user folder (located in *~/gvSIG/plugins/org.gvsig.educa.thematicmap.app.viewer* folder).

Generate bundle

-----------------

In this step the final ``.xo`` activity bundle is generate. Just execute the script ``generate-bundle.sh``::

   bash$ ./generate-bundle.sh

import os, shutil, stat

import gtk, gobject

import popen2

from os import path as Path

import logging

import sugar.activity.activity as activity

from sugar.activity.activity import Activity

from sugar.datastore import datastore

"""

Alternative paths to locate JRE

"""

JAVA_HOME_PATHS=(

#"/usr/lib/jvm/jre", # gcj path DOESN'T WORK!!!

str(Path.join(Path.expanduser("~"),"Activities/Java.activity/jre")), # Java activity path

    )

# LOG level config

logging.basicConfig(level=logging.DEBUG)

#logging.basicConfig(level=logging.INFO)

"""

gvSIG batovi activity

Requires:

* Sugar builds > 706

* A java installed or the Java activity installed

  For more information see: http://www.mediagala.com/rap/foro/viewtopic.php?f=8&t=166

On first _run_ executes son post-install actions.

"""

class GvSIGActivity(Activity):

    # gvSIG Home path (where is gvSIG activity)

    gvsig_activity=None

    # gvSIG Home path (where is gvSIG installation)

    gvsig_home=None

    #Java Home

    java_home=None

    def __init__(self, handle):

      logging.debug('Creating GvSIG handler.')

      Activity.__init__(self, handle)

      self.handle = handle

      # Register run() to run from gtk_main_loop

      # as soon as it gets idle.

      # Which is kludge to make it run after the loop has begun

      self.idleFunc = gobject.idle_add(self.run)

    def run(self):

      # Remove run() because we want it to run only once

      gobject.source_remove(self.idleFunc)

      # locate and check jre

      if not self.initializeJavaHome():

        # Exiting with a error  

        self.showMessageError("Can't found any JRE to run gvSIG:\nSee http://www.mediagala.com/rap/foro/viewtopic.php?f=8&t=166\nfor more information")

        logging.error("No JRE found!!!")

        logging.debug("Closing activity");

        self.close(True)

        return

      # setup environ properties

      self.gvsig_activity=activity.get_bundle_path()

      self.gvsig_home=Path.join(self.gvsig_activity, 'gvSIG')

      os.environ['GVSIG_HOME']=self.gvsig_home

      os.environ['GVSIG_ACTIVITY']=self.gvsig_activity

      os.environ['JAVA_HOME']=self.java_home

      # do post-install actions

      self.postInstall()

      # identify gvSIG launcher

      gvSIG_sh = Path.join(activity.get_bundle_path(), 'gvSIG', 'gvSIG.sh')

      if not Path.exists(gvSIG_sh):

        raise Exception("Missing gvSIG launcher: %s" % gvSIG_sh)

      # check execution permission

      self.fixExcecutionFilePermission(gvSIG_sh)

      try:

        logging.info("Executing '%s'" % gvSIG_sh);

        # execute gvSIG.sh

        gvSIG_process = popen2.Popen4('%s' % gvSIG_sh, 16)

        # writing stout in log file

        logging.info(gvSIG_process.fromchild.read())

        # wait until gvSIG exit

        rcode = gvSIG_process.wait()

        logging.info('gvSIG.sh returned with code=%d' % rcode)

      finally:

        logging.debug("Closing activity");

        self.close(True)

    def showMessageError(self, message):

        md = gtk.MessageDialog(self, 

              gtk.DIALOG_MODAL, gtk.MESSAGE_ERROR, 

              gtk.BUTTONS_CLOSE, message)

        md.run()

        md.destroy()

    """

    Initialize property ``java_home``

    Try to locate a valid java in ``JAVA_HOME_PATHS`` list

    Check that existe a *bin/java* executable file inside of it.

    If not JRE found returns False. Otherwise returns True

    """

    def initializeJavaHome(self):

      for jhome in JAVA_HOME_PATHS:

        logging.debug("check jre in %s" % jhome)

        if not Path.exists(jhome):

          logging.debug("%s not found" % jhome)

          continue

        if self.checkJavaExecutable(jhome):

          self.java_home=jhome

          logging.debug("ussing '%s' for JAVA_HOME" % jhome)

          return True

      else:

        logging.debug("No Java available in register paths: %s" % repr(JAVA_HOME_PATHS))

        return False

    """

    Check ``javaHome`` folder: check that exist a *bin/java* executable file

    Returns True/False

    """

    def checkJavaExecutable(self, javaHome):

      javaExe=Path.join(javaHome,"bin","java")

      if not Path.exists(javaExe):

        return False

      return os.access(javaExe, os.X_OK)

    """

    Run post install actions.

    This actions usually will be execute just once, in first activity run

    """

    def postInstall(self):

      self.installInGvSIGUserHome()

      self.installInUserHome()

      self.execScripts()

    """

    *Post Intall process:* Excecutes install scripts

    This actions usually will be execute just once, in first activity run.

    """

    def execScripts(self):

      # check if ther is any file to copy to 

      sourceFolder = Path.join(activity.get_bundle_path(), 'post-install', 'scripts')

      if not Path.exists(sourceFolder):

        # No files to execute

        return

      everyScriptOk = True

      # for all file/dir in souceFolder

      scriptFiles = os.listdir(sourceFolder)

      for aFile in scriptFiles:

        fext = Path.splitext(aFile)[1]

        aFilePath = Path.join(sourceFolder,aFile)

        if fext == ".py":

          # Exec python script

          execOk = self.execPython(aFilePath)

          if execOk:

            shutil.move(aFilePath,aFilePath+".done")

          else:

             everyScriptOk=False

        elif fext == ".sh":

          # Exec Shell script

          execOk = self.execShell(aFilePath)

          if execOk:

            shutil.move(aFilePath,aFilePath+".done")

          else:

             everyScriptOk=False

        elif fext == "done":

          # Nothing to do

          pass

        else:

          # Ignoring file

          logging.debug("Ignoring post-install script: " + aFilePath)

      if everyScriptOk:

        # rename folder to avoid execution on next application open

        shutil.move(sourceFolder, sourceFolder+".done")

    """

    Excecutes a python script file

    """

    def execPython(self,aFile):

      logging.debug("Executing python script '%s'" % aFile);

      try:

        # open file in read-only mode

        f = file(aFile,"r")

        # exec script

        try:

          exec f

        finally:

          f.close()

        return True

      except Exception, exc:

        logging.error("Excecuting file %s: %s" % (aFile,exc));

        return False

    """

    Fix (set) execution permission of a file

    """

    def fixExcecutionFilePermission(self, aFile):

      # check execution permission

      if not os.access(aFile, os.X_OK):

        # set excecution permission

        os.chmod(aFile,os.stat(aFile)+stat.S_IEXEC)

    """

    Excecutes a shell script file

    """

    def execShell(self,aFile):

      logging.debug("Executing '%s'" % aFile);

      try:

        mProcess = popen2.Popen4('%s' % aFile, 16)

        logging.debug(mProcess.fromchild.read())

        rcode = mProcess.wait()

        return rcode == 0

      except Exception, exc:

        logging.error("Excecuting file %s: %s" % (aFile,exc));

        return False

    """

    *Post Intall process:* Install files in user home

    Move files from ``{activity_folder}/post-install/user-home`` to ``$HOME``

    **NOTE**: if a file/dir already exist **will be ignored** (Keeping untouched original files)

    """

    def installInUserHome(self):

      # check if ther is any file to copy to 

      sourceFolder = Path.join(activity.get_bundle_path(), 'post-install', 'user-home')

      if not Path.exists(sourceFolder):

        # No files to copy

        return

      homeUserFolder = Path.expanduser("~")

      #merge folder

      self.mergeFolder(sourceFolder,homeUserFolder)

      #rename source folder to prevent rerun of this step

      os.rename(sourceFolder,sourceFolder+".done")

      #done

      return

    """

    *Post Intall process:* Install files in the gvSIG user home folder

    Move files from ``{activity_folder}/post-install/user-gvsig-home`` to ``$HOME/gvSIG``

    """

    def installInGvSIGUserHome(self):

      # check if ther is any file to copy to 

      sourceFolder = Path.join(activity.get_bundle_path(), 'post-install', 'user-gvsig-home')

      if not Path.exists(sourceFolder):

        # No files to copy

        return

      homeGvsigUserFolder = Path.expanduser("~/gvSIG")

      if not Path.exists(homeGvsigUserFolder):

        # Create gvSIG user home folder

        os.mkdir(homeGvsigUserFolder)

      #move files

      self.mergeFolder(sourceFolder,homeGvsigUserFolder)

      #rename source folder to prevent rerun of this step

      os.rename(sourceFolder,sourceFolder+".done")

      #done

      return

    """

    Move files from ``sourceFolder`` into ``targetFolder``

    ``sourceFolder`` must be a folder

    ``targetFolder`` must be a folder or not exists (so it will be created)

    ``overrideTarget`` if it's ``False`` raise an exception when target already contains the file/dir to move. if ``ignoreExisting``

    ``ignoreExisting`` modifies ``overrideTarget`` option (when it's ``False``) to don't raise an exception, just skip file/folder

    """

    def moveFiles(self,sourceFolder,targetFolder,overrideTarget=True,ignoreExisting=True):

      if not Path.exists(targetFolder):

        # Create target folder

        os.makedirs(targetFolder)

        # set overrideTarget to True because target is new

        overrideTarget=True

      elif not Path.isdir(targetFolder):

        raise Exception("%s must be a dir" % targetFolder)

      # for all file/dir in souceFolder

      toMoveList = os.listdir(sourceFolder)

      for toMove in toMoveList:

        target = Path.join(targetFolder,toMove)

        # check if exists target

        if Path.exists(target):

          if overrideTarget:

            if ignoreExisting:

              continue

          else:

            if ignoreExisting:

              continue

            else:

              raise Exception("%s alredy exists in target folder %s" % (toMove, targetFolder))

        # move file/dir

        shutil.move(Path.join(sourceFolder, toMove), targetFolder)

    """

    Merge folder content: Copy all missing folders and files from

    ``sourceFolder`` to ``targetFolder``.

    Process doesn't override existing files in ``targetFolder``

    """

    def mergeFolder(self,sourceFolder,targetFolder):

      # get folder contents

      names = os.listdir(sourceFolder)

      if not Path.exists(targetFolder):

        # Create target folder if not exists

        os.makedirs(targetFolder)

      for name in names:

        srcname = Path.join(sourceFolder, name)

        dstname = Path.join(targetFolder, name)

        if Path.isdir(srcname):

          # Recursive call to mergeFolder

          self.mergeFolder(srcname,dstname)

        else:

          if not Path.exists(dstname):

            # Copy new file

            shutil.copy(srcname,dstname)

          else:

            # skip existing file

            continue

===========================================

gvSIG batovi Activity Post-intall process

===========================================

This folder contains all supported *post-intall* actions implemented in gvSIG activity.

user-gvsig-home

================

Files of this folder will be **merged** (copy only files than no exists on target folder) with *~/gvSIG* folder of user intallation in first gvSIG activity execution.

After that this folder will be renamed to *user-gvsig-home.done*.

user-home

===========

Files of this folder will be **merged** (copy only files than no exists on target folder)  to *user home* folder.

After that this folder will be removed.

scripts

========

Excecutes contained scripts in first gvSIG activity execution. Only *Pyhon* (files ``.py``) and *Shell* (files ``.sh``) are allowed (other files will be ignored).

Before all execution this environ variables will be set:

* ``GVSIG_ACTIVITY``: root folder of gvSIG activity (usually ``~/Activities/org.gvsig.batovi.activity``)

* ``GVSIG_HOME``: root folder of gvSIG installation (usually ``$GVSIG_ACTIVITY/gvSIG``)

After the script excution will be renamed (adds ``.done``) to prevent future executions.

When all script were executed, this folder will be renamed (adds ``.done``).

See log file for problems in script executions.

[Activity]

name = gvSIG Batovi

bundle_id = Batovi.Activity

class = GvSIGActivity.GvSIGActivity

icon = activity-gvsig

activity_version = ${version}

host_version = 1

show_launcher = yes

<?xml version="1.0" encoding="UTF-8" standalone="no"?>

<!-- Created with Inkscape (http://www.inkscape.org/) -->

<svg

   xmlns:dc="http://purl.org/dc/elements/1.1/"

   xmlns:cc="http://creativecommons.org/ns#"

   xmlns:rdf="http://www.w3.org/1999/02/22-rdf-syntax-ns#"

   xmlns:svg="http://www.w3.org/2000/svg"

   xmlns="http://www.w3.org/2000/svg"

   xmlns:sodipodi="http://sodipodi.sourceforge.net/DTD/sodipodi-0.dtd"

   xmlns:inkscape="http://www.inkscape.org/namespaces/inkscape"

   width="55"

   height="55"

   id="svg4502"

   sodipodi:version="0.32"

   inkscape:version="0.48.2 r9819"

   version="1.0"

   sodipodi:docname="logo_gvsig.svg"

   inkscape:output_extension="org.inkscape.output.svg.inkscape">

  <defs

     id="defs4504" />

  <sodipodi:namedview

     id="base"

     pagecolor="#ffffff"

     bordercolor="#666666"

     borderopacity="1.0"

     gridtolerance="10000"

     guidetolerance="10"

     objecttolerance="10"

     inkscape:pageopacity="0.0"

     inkscape:pageshadow="2"

     inkscape:zoom="1"

     inkscape:cx="32.531924"

     inkscape:cy="23.680342"

     inkscape:document-units="px"

     inkscape:current-layer="layer3"

     width="55px"

     height="55px"

     inkscape:window-width="1440"

     inkscape:window-height="876"

     inkscape:window-x="0"

     inkscape:window-y="24"

     showgrid="false"

     inkscape:window-maximized="1">

    <inkscape:grid

       id="GridFromPre046Settings"

       type="xygrid"

       originx="0px"

       originy="0px"

       spacingx="15px"

       spacingy="15px"

       color="#0000ff"

       empcolor="#0000ff"

       opacity="0.2"

       empopacity="0.4"

       empspacing="5" />

  </sodipodi:namedview>

  <metadata