| gvSIG desktop 1

TENGO QUE GENERAR UN INSTALADOR DE UNA EXTENSI?N PARA GVSIG-MAC. COMO LO HAGO?

No hay un build.xml para ello, ya que no tendria sentido (el proceso es corto y habria que hacer cosas a mano de todas formas).

1.- Preparar los ficheros en su arbol de directorios, siendo el directorio de andami.jar el "raiz". 

Por ejemplo, supongamos una extensi?n que vaya a proveer estos ficheros a un gvSIG ya instalado:

gvSIGbin/andami.jar

gvSIGbin/gvSIG/extensiones/nuevoFichero1

gvSIGbin/NuevoDirectorio1/nuevoFichero2

NativeLibs/nuevalib

2.- Hacer una copia de actualizador.app con un nuevo nombre (p. ej., "instalador de extension piloto de redes.app")

3.- Asegurarse de que tras la copia, los ficheros en <nuevo nombre>.app/Contents/MacOS/ tienen permisos de ejecuci?n. Una copia normal hecha con Ant suele perderlos!

4.- Copiar el arbol de directorios del paso 1 a <nuevo nombre>.app/Contents/Resources/updates/<gvSIGbin|NativeLibs>. Solo funcionar?n esos 2 directorios.

5.- Revisar <nuevo nombre>.app/Contents/Resources/configfile para asegurarse de que las opciones configurables 

son correctas. Contiene ejemplos.

6.- Opcional: se puede a?adir un fichero Info.plist en <nuevo nombre>.app/Contents/Resources/updates/ si se quiere 

substituir el original del gvSIG instalado (para cambiar paths, par?ms de arranque de la JVM, etc)

7.- Comprimir <nuevo nombre>.app en un ZIP y distribuir.

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

EXPLICACIONES: 

ACTUALIZACIONES, INSTALACIONES PARCIALES:

(y en general, para meter ficheros en un gvSIG ya instalado)

Para eso est? "actualizador.app". Es un bundle-aplicacion creado con AppleScript. Su prop?sito es copiar el contenido de uno de sus directorios internos al lugar adecuado de un bundle gvSIG.

Hay que poner en actualizador.app/Contents/Resources/updates/gvSIGbin/ el ?rbol de directorios de la actualizaci?n a instalar. Esos ficheros y directorios substituir?n a los que se encuentren en el gvSIG instalado, bas?ndose en la correspondencia entre el directorio mencionado y el directorio base del gvSIG ya existente en el mac del usuario (es decir, el directorio que contiene andami.jar; concretamente ser?a gvSIG.app/Contents/Resources/Java/).

Por ejemplo: si ponemos en actualizador.app/Contents/Resources/updates/ los siguientes ficheros:

gvSIGbin/andami.jar

gvSIGbin/gvSIG/extensiones/nuevoFichero1

gvSIGbin/NuevoDirectorio1/nuevoFichero2

NativeLibs/nuevalib

Al usar ese actualizador, el gvSIG actualizado habr? recibido el andami.jar nuevo, habr? a?adido nuevoFichero1 a gvSIG/extensiones/, habr? creado en el nivel de andami.jar el directorio NuevoDirectorio1 con nuevoFichero2 dentro, y habr? a?adido en el directorio de NativeLibs la nueva librer?a.

Ojo: s?lo se usar?n esos dos directorios: ..../updates/gvSIGbin y .../updates/NativeLibs

El fichero actualizador.app/Contents/Resources/configfile permite configurar algunas cosas del actualizador:

--nombre que se pondr? a los bundles actualizados (opcional; se aplica al bundle autoinstalador y/o bundle sencillo de gvSIG);

--numero de version del bundle que se pide al usuario (opcional; solo se usa como cadena que se mostrar? junto a un mensaje localizado del estilo de "Por favor, seleccione gvSIG versi?n...");

--MD5 de andami.jar de el/los gvSIG actualizables (opcional; permite limitar la instalaci?n a una versi?n definida de gvSIG)

--sufijo a agregar al nombre de los bundles actualizados (opcional; util para que un "gvSIG" pase a llamarse "gvSIG SEXTANTE", p. ej.)

--lista de ficheros a borrar

Hay ejemplos y comentarios dentro del propio fichero configfile.

Si el actualizador encuentra un fichero actualizador.app/Contents/Resources/updates/Info.plist, lo pondr? en el lugar adecuado del bundle del gvSIG actualizado. Ser? ?til por ejemplo para cambiar el classpath de un nuevo gvSIG, su nombre tal como lo usa OS X, la versi?n de Java requerida, etc.

El actualizador copia los ficheros a su destino sobreescribiendo lo que encuentre. Los directorios son creados si no existen en destino; si existen, los ficheros que contiene son a?adidos. Es decir, un directorio existente con 10 ficheros no ser? machacado por un directorio con un s?lo fichero, sino que ser? a?adido. (este es el comportamiento intuitivamente esperable de un actualizador)

La opci?n de borrar acepta rutas relativas (que son relativas al directorio Resources del bundle interior). Es decir, las siguientes rutas son correctas: "Java/andami.jar" y "NativeLibs/libjgdal.jnilib".

Tambi?n acepta rutas absolutas, pero no deber?an usarse generalmente (ya que ni sabemos en qu? parte del filesystem puede estar el bundle de gvSIG).