Application: gvSIG desktop

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:

<raiz>/andami.jar

<raiz>/gvSIG/extensiones/nuevoFichero1

<raiz>/NuevoDirectorio1/nuevoFichero2

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/

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/gvSIGbin/ los siguientes ficheros:

andami.jar

gvSIG/extensiones/nuevoFichero1

NuevoDirectorio1/nuevoFichero2

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

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 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.)

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)

No hay opci?n implementada para borrar ficheros del destino; no parece necesario, y nos ahorramos riesgos.

Actualmente solo esta contemplada la posibilidad de copiar ficheros en el ?rbol de directorios a partir de donde esta andami.jar.