Statistics
| Revision:

svn-gvsig-desktop / tags / v1_1_2_1_Build_1046 / install / instalador-gvSIG-mac / HOWTO-BUILD.txt @ 20384

History | View | Annotate | Download (2.29 KB)

1
DISTRIBUIBLE COMPLETO:
2
Para generar el bundle (.app) para Mac, se debe lanzar el script de Ant "build.xml".
3
Supone definida la variable build.number .
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. 
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
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

    
9
El classpath que usar? gvSIG est? hardcoded en linea "extraclasspath" de task jarbundler de build-bundle.xml. Ese classpath debe ser el mismo que se define en el gvSIG.sh de Linux, por ejemplo.
10

    
11

    
12

    
13
EXPLICACION DETALLADA:
14
OS X puede ejecutar un fichero.jar con un doble click, pero eso es equivalente a "java fichero.jar", sin m?s par?metros.
15
Para que se ejecute con unos par?metros y un classpath, un icono propio y la metainformaci?n necesaria para parecer una aplicaci?n normal de mac, lo convertimos en un bundle.
16
Un bundle es un directorio con nombre *.app y una cierta estructura de directorios.
17
<miBundle.app>/Contents/Info.plist es un fichero XML con la metainfo necesaria para que OS X sepa ciertas cosas sobre la aplicaci?n: ficheros que puede abrir (extensiones, mimetypes, visor o editor, etc), icono, nombre/s que presentar al usuario, numeros de versi?n...
18
En el caso de aplicaciones java, tambi?n incluye el classpath, par?metros para la aplicaci?n y la JVM, etc.
19
Para el caso de gvSIG, en <miBundle.app>/Contents/Resources/Java/ ir? una copia del directorio gvsig/bin/ de un build normal.
20
De todo esto se encarga build-bundle.xml.
21

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

    
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.