Manual de instalación de eclipse

ÍNDICE

Índice……………………………………………………………………………………………………………………………………………………………………….1

1 Introducción ................................................................................................................................................... 1

2 Requisitos para instalar Eclipse ....................................................................................................................... 1

3 Descarga e Instalación de Eclipse .................................................................................................................... 1

3.1 Descarga de Eclipse .................................................................................................................................. 1

3.2 Instalación de Eclipse ................................................................................................................................ 2

4 Uso de Eclipse ................................................................................................................................................. 2

4.1 Detalles de estilo ...................................................................................................................................... 3

Apéndice A: Descarga e Instalación de JME ............................................................................................................. 6

Introducción ....................................................................................................................................................... 6

Instalación de SVN .............................................................................................................................................. 6

Instalación de Subversive ................................................................................................................................ 7

Descarga de JME2 ........................................................................................................................................... 9

Añadiendo las rutas de las clases................................................................................................................... 10

1

MANUAL DE INSTALACIÓN DE ECLIPSE EN WINDOWS

1 INTRODUCCIÓN

Este manual es complementario a los tutoriales para la creación de módulos (cells) en Wonderland. Eclipse es un poderoso IDE – Integrated Development Enviroment – (Entorno de Desarrollo Integrado) que nos será de mucha utilidad para codificar cada uno de los archivos fuente que necesitemos para crear los módulos para Wonderland.

Eclipse es un software de código abierto (open source), por lo que no es necesario pagar alguna licencia para su uso, en sí, solo es necesario descargarlo y descomprimirlo, pues no necesita de ninguna instalación (en Windows).

Eclipse es multiplataforma, si usted desea instalar el IDE en un sistema operativo diferente, visite la página http://www.eclipse.org/ .

2 REQUISITOS PARA INSTALAR ECLIPSE

El único requisito necesario para usar Eclipse, es tener instalado el paquete JRE (Java Runtime Enviroment). Sin embargo, como Eclipse es una herramienta para desarrolladores, se recomienda descargar el paquete JDK (Java Develpment Kit), que también incluye JRE. Si usted desea saber como descargar e instalar JDK, vea el “Manual de Instalación de Wonderland”

3 DESCARGA E INSTALACIÓN DE ECLIPSE

3.1 DESCARGA DE ECLIPSE

En su navegador Web preferido, ingrese a la página http://www.eclipse.org/downloads/, dentro de ella, busque el link que diga Eclipse IDE for Java Developers (92 MB) . La versión actual de Eclipse se llama Eclipse Galileo.

Después de hacer clic en el link anterior, le llevará a otra página, ahí estará un link de un “sitio espejo” para descargar el IDE. Más abajo aparece una imagen que le indica donde estará el link.

El enlace que usted vea en la página no tiene por que ser exactamente igual al que aparece en la imagen, esta es solamente para ilustrar en donde estará el link para descargar la aplicación

Descargue Eclipse en el lugar que usted desee.

2

3.2 INSTALACIÓN DE ECLIPSE

Ahora que ha descargado Eclipse, solo es necesario descomprimir el archivo .zip en el lugar que usted desee. Como ya se había comentado anteriormente, solo es necesario descomprimirlo para instalarlo. Por no contar con ningún instalador, Eclipse se podría considerar como una aplicación “portable”. Ya sea comprimido o descomprimido, se puede llevar a cualquier computadora con sistema operativo Windows y funcionará sin ningún problema (siempre y cuando tenga el JRE).

4 USO DE ECLIPSE

Al abrir por primera vez Eclipse, aparecerá un recuadro que le preguntará donde se encuentra su “workspace”. El workspace (o espacio de trabajo) será una carpeta en almacenamiento secundario (ya sea disco duro o memoria flash) donde estarán organizados sus proyectos. Usted puede tener múltiples “workspaces”, pero solo puede trabajar en uno a la vez.

Un lugar muy recomendable para poner el workspace es dentro de la misma carpeta donde esté Eclipse, esto suele ser muy bueno puesto que si necesita moverse de computadora, solo

Aquí está el enlace para descargar Eclipse.

3

copia toda la carpeta de Eclipse a la nueva computadora y no necesita volver a referenciar todos los proyectos, pues guardaran una relación relativa con respecto a Eclipse.

Otra ubicación recomendable en caso de que trabaje en muchas computadoras y quiera mover su workspace sin ningún problema, es una memoria flash. En una memoria flash, puede iniciar su workspace desde cualquier computadora con Eclipse y siempre tendrá sus archivos actualizados y organizados, sin necesidad de estarlos copiando a la computadora en la que esté trabajando, ni tampoco de hacer algún movimiento de referencias.

Una vez elegido el lugar de su workspace, verá esta pantalla:

4.1 DETALLES DE ESTILO

Al iniciar por primera aparecerá una pantalla de bienvenida, ciérrela para empezar a trabajar.

Uno de los detalles de estilo importantes al empezar por primera vez Eclipse, es hacer visibles los números de línea en el editor. Para hacer esto vaya al menú Window -> preferences. Después de esto aparecerá la siguiente ventana:

4

En la lista que se encuentra a la izquierda, diríjase al menú General -> Editors -> Text Editors y en el lado derecho de la ventana aparecerán las siguientes opciones, seleccione la opción de “Show line numbers”, tal y como se ve en la ventana que está mas abajo.

5

Otra detalle muy útil al momento de trabajar es poder pasar de una pestaña de Eclipse a la última seleccionada la combinación de teclas Ctrl+Tab (al igual que con Windows se pasa de una de una ventana a la última seleccionada con alt+Tab). Este comportamiento está puesto por defecto con la combinación de teclas Ctrl+F6, pero suele ser más cómodo manejarlo con Ctrl+Tab. Para hacer este cambio, vaya a la ventana de Preferences (donde hicimos el cambio anterior) y en la lista de la izquierda vaya al menú General -> Keys. En la parte derecha aparecerá la ventana que se muestra más abajo. En esa ventana, en el cuadro de texto que tiene la leyenda de “type filter text” en color gris claro (sería el segundo cuadro de texto de arriba hacia abajo), teclee: next editor.

Seleccione la opcion que aparezca en la lista inferior al cuadro de texto y, mas abajo, en la misma ventana, en el cuadro de texto que tiene la etiqueta de Binding: teclee primero Ctrl y sin soltar esa tecla, teclee Tabulador. Ahora de clic en el botón de “Apply” y luego en el botón de ”OK”.

Esta es la opción para que aparezcan los números de línea

6

APÉNDICE A: DESCARGA E INSTALACIÓN DE JME

INTRODUCCIÓN

Ahora que tenemos instalado Eclipse, ya podemos descargar jME. jME (cuyas siglas significan jMonkey Engine http://www.jmonkeyengine.com) es una librería de gráficos de alto rendimiento desarrollada en Java bajo la filosofía del código abierto con una licencia BSD. Las características de jME la convierten en la librería perfecta y la base gráfica de Wonderland. Será necesario saber un poco de esta librería y tenerla instalada para, por ejemplo, poder convertir los modelos 3D desarrollados desde ciertos formatos a un formato manipulable por jME, y por tanto, también por Wonderland. El formato que maneja jME es precisamente .jme . Este tutorial cubre solamente la descarga e instalación de jME con Eclipse. Para saber como convertir modelos 3D a jme, vea el manual “Creación de un módulo a partir de una figura predeterminada”.

INSTALACIÓN DE SVN

Para poder descargar la última versión de jME (2.0) junto con eclipse, antes es necesario hacer algunas cosas. JME se encuentra en un repositorio en GoogleCode (vea su página en

7

http://code.google.com/p/jmonkeyengine/) por lo tanto, será necesario usar SVN. En este tutorial, usaremos SVN a través del Subversive en Eclipse.

INSTALACIÓN DE SUBVERSIVE

Después de iniciar eclipse en el workspace de su gusto, haga los siguientes pasos:

1. Vaya al menú Help -> Install New Software….

2. En el combo box con la etiqueta de “Work with:” seleccione: Galileo - http://download.eclipse.org/releases/galileo

3. En la lista que aparecerá mas abajo, expanda el menú de Collaboration (Cada expansión de los menús puede llevar algunos minutos, sea paciente)

4. Ahora seleccione e instale “Subversive SVN Team Provider (Incubation)” (Si no encuentra Subversive SVN Team Provider en el menú que expandió, de clic en el botón de “Add…” que se encuentra junto al combo del paso 2 y en “Name:” ponga SVN Team Provider y en “Location:” ponga el link que aparezca en la siguiente página: http://www.eclipse.org/subversive/downloads.php, debajo del titulo de Galileo Release, debajo del subtítulo Archived update site:)

8

5. De clic en el botón Next >, y luego otra vez clic en Next >, acepte la licencia y finalmente clic en Finish. Ahora se le pedirá que reinicie Eclipse.

6. Una vez reiniciado, sigue instalar los conectores. Para instalarlos, vaya otra vez a Help -> Install New Software… y de clic al botón de Add… junto al combo de Work with:

7. En la ventana que aparecerá, en el campo Name escriba: Subversive SVN Connectors, y en el campo Location ponga la siguiente página: http://community.polarion.com/projects/subversive/download/eclipse/2.0/galileo-site/

8. De clic en OK y aparecerán 2 sitios en la lista, expanda el menú de Subversive SVN Connectors (Nota: solo hasta Connectors, no el que tiene Source al final).

9. Dentro del menú expandido, busque SVNKit 1.3.0 Implementation (Optional) , selecciónelo y de clic en el botón Next > y después clic en Finish. Ahora reinicie.

9

10. Una vez reiniciado, ya debe de poder usar SVN. Vaya a Window -> Show View… -> Other… y en la ventana que aparezca expanda el menú de SVN y del menú expandido elija SVN Repositories, de clic en OK y podrá ver la pestaña de SVN Repositories en el área inferior del Editor.

DESCARGA DE JME2

Ahora que ha instalado SVN en Eclipse, ya podemos realizar descargas desde repositorios. Una vez que se realicen estos pasos, podemos actualizar JME2 con el clic derecho del Mouse sobre el proyecto y seleccionando Team -> Update.

Ahora sigamos los pasos para descargar JME2

1. Para empezar, de un clic derecho del Mouse en el área en blanco de la pestaña de SVN Repositories, (si no la puede ver, entonces repita el paso 10 del capítulo anterior) después elija el menú New -> Repository Location. En el área de URL escriba http://jmonkeyengine.googlecode.com/svn/ y de clic en Finish.

10

2. En caso de obtener algún error que haga fallar el “checkout” revise el error que arroja, si el mensaje dice algo como ‘Selected SVN connector library is not available or cannot be loaded.’ Entonces regrese al menú de Install new software, agregue el sitio http://www.polarion.org/projects/subversive/download/eclipse/2.0/update-site/ y desde ahí descargue los Subversive SVN Connectors (después de desinstalar los que tenga, si los tiene) y el SVNKit (la versión mas nueva).

3. Expanda el repositorio que acaba de agregar. Debe de ver lo siguiente:

trunk

branches

tags

Wiki

ROOT

REVISIONS

4. Ahora de clic derecho sobre trunk y elija Find/Check Out As…

5. Seleccione Check out as a project with the name specified: ,escriba JME 2 en el cuadro de texto que se habilite y luego haga clic en Finish.

AÑADIENDO LAS RUTAS DE LAS CLASES

Después de descargar JME2 usted se podrá dar cuenta de que todavía no está compilado. Esto es por que todavía no le hemos indicado a Eclipse donde encontrar las clases necesarias en los archivos jar. Para arreglar este problema, haga lo siguiente:

1. Haga clic derecho sobre el proyecto JME 2 que se acaba de crear y elija Build Path -> Configure Build Path….

2. En la ventana que aparezca, vaya a la pestaña de Libraries, de clic sobre el botón de Add Library, elija User Library y haga clic sobre el botón Next >. En siguiente ventana de clic sobre el botón User Library, en la ventana que aparezca, de clic sobre el botón de New…. y en el cuadro de texto escriba “JME 2 Required” o algo que haga referencia a las librerías necesarias para JME2.

3. De clic en el botón de Add JARs… y agregue los siguientes JARS’s, que se encontrarán en el directorio de workspace/JME 2/:

lib/jogl/gluegen-rt.jar lib/jogl/jogl.jar

11

lib/jorbis/jorbis-0.0.17.jar ib/junit/junit-4.1.jar lib/lwjgl/jinput.jar lib/lwjgl/lwjgl.jar lib/lwjgl/lwjgl_util.jar lib/lwjgl/lwjgl_util_applet.jar lib/swt/<os>/swt.jar (para este caso, sustituya <os> por su sistema operativo)

4. Finalmente, debemos de indicarle a LWJGL donde encontrar sus implementaciones Nativas. En la ventana de Preferences (Filtered) (en la que estamos trabajando ahorita) expanda el nodo “lwjgl.jar”. Seleccione “native library location” y de clic en Edit. En la nueva ventana, haga clic en Workspace, y en la ventana que aparezca seleccione JME 2/lib/lwjgl/native/<os>, reemplazando <os> por su sistema operativo.

5. Ahora de clic en OK o Finish en las ventanas que abrimos, y el proyecto se reconstruirá automáticamente sin errores.

Para usar JME en algún proyecto nuestro, solamente debemos de crear un nuevo proyecto de Java (o importar alguno), hacemos clic derecho en el proyecto, elegimos Build Path -> Configure Build Path…, elegimos la pestaña de Projects, hacemos clic en el botón Add, seleccionamos JME 2 y hacemos clic en OK. Después de esto, podremos hacer uso de JME en el proyecto de nuestra elección.

Nota aclaratoria: La parte de descarga e Instalación de JME está basada en el tutorial que se encuentra en la página http://www.jmonkeyengine.com/wiki/doku.php?id=setting_up_eclipse_to_build_jme_2