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 20384 mijail
DISTRIBUIBLE COMPLETO:
2 10691 mija
Para generar el bundle (.app) para Mac, se debe lanzar el script de Ant "build.xml".
3 9148 mija
Supone definida la variable build.number .
4 10691 mija
Dentro define FULLVERSION (habr? que cambiarlo para cada versi?n mayor, claro)
5 20384 mijail
build.xml llama a build-bundle.xml para crear el bundle de gvSIG.
6 10691 mija
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 9148 mija
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 10691 mija
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 12516 mija
EXPLICACION DETALLADA:
14 10691 mija
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 12516 mija
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 12917 mija
<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 10691 mija
En el caso de aplicaciones java, tambi?n incluye el classpath, par?metros para la aplicaci?n y la JVM, etc.
19 12917 mija
Para el caso de gvSIG, en <miBundle.app>/Contents/Resources/Java/ ir? una copia del directorio gvsig/bin/ de un build normal.
20 10691 mija
De todo esto se encarga build-bundle.xml.
21
22 20384 mijail
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 10691 mija
24 12516 mija
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.