Revision 20384 tags/v1_1_2_1_Build_1046/install/instalador-gvSIG-mac/HOWTO-BUILD.txt

View differences:

HOWTO-BUILD.txt
1 
INSTALACIONES COMPLETAS:
1 
DISTRIBUIBLE COMPLETO:
2 2 
Para generar el bundle (.app) para Mac, se debe lanzar el script de Ant "build.xml".
3 3 
Supone definida la variable build.number .
4 4 
Dentro define FULLVERSION (habr? que cambiarlo para cada versi?n mayor, claro)
5 
build.xml llama a build-bundle.xml para crear el bundle de gvSIG; luego lo mover? dentro del bundle "autoinstalador".
5 
build.xml llama a build-bundle.xml para crear el bundle de gvSIG.
6 6 
build-bundle.xml usa un Ant Task llamado Jarbundler, que se puede obtener en http://jarbundler.sourceforge.net/. Hay que instalarlo en la librer?a del Ant que se use.
7 7 
Si se desea usar con el Ant incluido en Eclipse, adem?s se debe a?adir xercesImpl.jar, que va incluido en los Ant "normales" pero no en el de Eclipse. (Tambi?n se puede redefinir el ANTHOME en las preferencias de Eclipse para apuntar a un Ant instalado aparte, en el se haya instalador el jarbundler).
8 8 

  		




  ......




  19
  19
  
    
Para el caso de gvSIG, en <miBundle.app>/Contents/Resources/Java/ ir? una copia del directorio gvsig/bin/ de un build normal.


  		




  20
  20
  
    
De todo esto se encarga build-bundle.xml.


  		




  21
  21
  
    

  		




  22
  
  
    
Luego, como en mac no es normal usar instaladores (sino que las aplicaciones son autocontenidas: se instalan copiando el bundle al disco duro, se desinstalan tirando el bundle a la papelera), usamos una peque?a aplicaci?n auxiliar: autoinstalador.app.


  		




  23
  
  
    
Autoinstalador.app est? pensado para contener el bundle de gvSIG creado en el paso anterior. De forma que el usuario ejecuta el autoinstalador con un doble click, y ?ste se encarga de comprobar que JAI y JAI I/O est?n correctamente instalados. Si no es as? los instala. Y acto seguido ejecuta el bundle de gvSIG que lleva dentro, de forma que para el usuario la instalaci?n es transparente (pero se le avisa de lo que est? pasando).


  		




  24
  
  
    
La estructura que nos interesa del autoinstalador es:


  		




  25
  
  
    
autoinstalador.app/


  		




  26
  
  
    
	Contents/


  		




  27
  
  
    
		Resources/


  		




  28
  
  
    
			instalacion/


  		




  29
  
  
    
				(JAI para OS X 10.3, JAI I/O, programa java para chequear instalacion)


  		




  30
  
  
    
			gvSIG/


  		




  31
  
  
    
				bundle gvSIG.app


  		




  32
  
  
    
			(...directorios de localizaci?n...)


  		




  
  22
  
    
Hasta gvSIG 1.1.x inclusive se usaba adem?s un bundle auxiliar "autoinstalador" que se encargaba de instalar JAI-ImageIO (si no lo estaba ya). Dado que causaba problemas, hemos abandonado eso y ahora se usa JAI-ImageIO en el Classpath de gvSIG.


  		




  33
  23
  
    

  		




  34
  
  
    

  		




  35
  
  
    
build.xml se encarga de:


  		




  36
  
  
    
-- llamar a build-bundle.xml, que crea el bundle "gvSIG.app" con sus librerias nativas; 


  		




  37
  
  
    
-- y luego, de meter el bundle "gvSIG.app" en el bundle autoinstalador. 


  		




  38
  
  
    
El resultado final es un autoinstalador completo.


  		




  39
  
  
    

  		




  40
  24
  
    
Nota: un usuario "normal" (no-desarrollador) de mac posiblemente no sepa qu? es un bundle. La forma normal de llamarlos es "aplicaci?n", y se suele considerar un item indivisible.


  		












Also available in:  Unified diff