Manual de instalacin de eclipse NDICE

ndice.1 1 2 3 Introduccin ................................................................................................................................................... 1 Requisitos para instalar Eclipse ....................................................................................................................... 1 Descarga e Instalacin de Eclipse .................................................................................................................... 1 3.1 3.2 4 Descarga de Eclipse .................................................................................................................................. 1 Instalacin de Eclipse ................................................................................................................................ 2

Uso de Eclipse................................................................................................................................................. 2 4.1 Detalles de estilo ...................................................................................................................................... 3

Apndice A: Descarga e Instalacin de JME ............................................................................................................. 6 Introduccin ....................................................................................................................................................... 6 Instalacin de SVN .............................................................................................................................................. 6 Instalacin de Subversive ................................................................................................................................ 7 Descarga de JME2 ........................................................................................................................................... 9 Aadiendo las rutas de las clases................................................................................................................... 10

MANUAL DE INSTALACIN DE ECLIPSE EN WINDOWS

1 INTRODUCCIN

Este manual es complementario a los tutoriales para la creacin de mdulos (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 mdulos para Wonderland. Eclipse es un software de cdigo 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 instalacin (en Windows). Eclipse es multiplataforma, si usted desea instalar el IDE en un sistema operativo diferente, visite la pgina 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 tambin incluye JRE. Si usted desea saber como descargar e instalar JDK, vea el Manual de Instalacin de Wonderland
3 3.1 DESCARGA E INSTALACIN DE ECLIPSE DESCARGA DE ECLIPSE

En su navegador Web preferido, ingrese a la pgina http://www.eclipse.org/downloads/, dentro de ella, busque el link que diga Eclipse IDE for Java Developers (92 MB) . La versin actual de Eclipse se llama Eclipse Galileo. Despus de hacer clic en el link anterior, le llevar a otra pgina, ah estar un link de un sitio espejo para descargar el IDE. Ms abajo aparece una imagen que le indica donde estar el link. El enlace que usted vea en la pgina 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 aplicacin Descargue Eclipse en el lugar que usted desee.

Aqu est el enlace para descargar Eclipse.

3.2

INSTALACIN DE ECLIPSE

Ahora que ha descargado Eclipse, solo es necesario descomprimir el archivo .zip en el lugar que usted desee. Como ya se haba comentado anteriormente, solo es necesario descomprimirlo para instalarlo. Por no contar con ningn instalador, Eclipse se podra considerar como una aplicacin portable. Ya sea comprimido o descomprimido, se puede llevar a cualquier computadora con sistema operativo Windows y funcionar sin ningn 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 estarn organizados sus proyectos. Usted puede tener mltiples 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
2

copia toda la carpeta de Eclipse a la nueva computadora y no necesita volver a referenciar todos los proyectos, pues guardaran una relacin relativa con respecto a Eclipse. Otra ubicacin recomendable en caso de que trabaje en muchas computadoras y quiera mover su workspace sin ningn 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 algn 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, cirrela para empezar a trabajar. Uno de los detalles de estilo importantes al empezar por primera vez Eclipse, es hacer visibles los nmeros de lnea en el editor. Para hacer esto vaya al men Window -> preferences. Despus de esto aparecer la siguiente ventana:

En la lista que se encuentra a la izquierda, dirjase al men General -> Editors -> Text Editors y en el lado derecho de la ventana aparecern las siguientes opciones, seleccione la opcin de Show line numbers, tal y como se ve en la ventana que est mas abajo.

Esta es la opcin para que aparezcan los nmeros de lnea

Otra detalle muy til al momento de trabajar es poder pasar de una pestaa de Eclipse a la ltima seleccionada la combinacin 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 combinacin de teclas Ctrl+F6, pero suele ser ms cmodo 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 ms abajo. En esa ventana, en el cuadro de texto que tiene la leyenda de type filter text en color gris claro (sera 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 botn de Apply y luego en el botn de OK.

APNDICE A: DESCARGA E INSTALACIN DE JME INTRODUCCIN

Ahora que tenemos instalado Eclipse, ya podemos descargar jME. jME (cuyas siglas significan jMonkey Engine http://www.jmonkeyengine.com) es una librera de grficos de alto rendimiento desarrollada en Java bajo la filosofa del cdigo abierto con una licencia BSD. Las caractersticas de jME la convierten en la librera perfecta y la base grfica de Wonderland. Ser necesario saber un poco de esta librera y tenerla instalada para, por ejemplo, poder convertir los modelos 3D desarrollados desde ciertos formatos a un formato manipulable por jME, y por tanto, tambin por Wonderland. El formato que maneja jME es precisamente .jme . Este tutorial cubre solamente la descarga e instalacin de jME con Eclipse. Para saber como convertir modelos 3D a jme, vea el manual Creacin de un mdulo a partir de una figura predeterminada.
INSTALACIN DE SVN

Para poder descargar la ltima versin de jME (2.0) junto con eclipse, antes es necesario hacer algunas cosas. JME se encuentra en un repositorio en GoogleCode (vea su pgina en
6

http://code.google.com/p/jmonkeyengine/) por lo tanto, ser necesario usar SVN. En este tutorial, usaremos SVN a travs del Subversive en Eclipse.
INSTALACIN DE SUBVERSIVE

Despus 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 expansin de los mens 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 botn 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 pgina: http://www.eclipse.org/subversive/downloads.php, debajo del titulo de Galileo Release, debajo del subttulo Archived update site:)

5. De clic en el botn 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 botn 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 pgina: http://community.polarion.com/projects/subversive/download/eclipse/2.0/galileo-site/

8. De clic en OK y aparecern 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) , seleccinelo y de clic en el botn Next > y despus clic en Finish. Ahora reinicie.

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 pestaa 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 pestaa de SVN Repositories, (si no la puede ver, entonces repita el paso 10 del captulo anterior) despus elija el men New -> Repository Location. En el rea de URL escriba http://jmonkeyengine.googlecode.com/svn/ y de clic en Finish.

2. En caso de obtener algn 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 (despus de desinstalar los que tenga, si los tiene) y el SVNKit (la versin 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.
AADIENDO LAS RUTAS DE LAS CLASES

Despus de descargar JME2 usted se podr dar cuenta de que todava no est compilado. Esto es por que todava 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 pestaa de Libraries, de clic sobre el botn de Add Library, elija User Library y haga clic sobre el botn Next >. En siguiente ventana de clic sobre el botn User Library, en la ventana que aparezca, de clic sobre el botn de New. y en el cuadro de texto escriba JME 2 Required o algo que haga referencia a las libreras necesarias para JME2. 3. De clic en el botn de Add JARs y agregue los siguientes JARSs, que se encontrarn en el directorio de workspace/JME 2/: lib/jogl/gluegen-rt.jar lib/jogl/jogl.jar
10

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 automticamente sin errores. Para usar JME en algn 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 pestaa de Projects, hacemos clic en el botn Add, seleccionamos JME 2 y hacemos clic en OK. Despus de esto, podremos hacer uso de JME en el proyecto de nuestra eleccin. Nota aclaratoria: La parte de descarga e Instalacin de JME est basada en el tutorial que se encuentra en la pgina http://www.jmonkeyengine.com/wiki/doku.php?id=setting_up_eclipse _to_build_jme_2

11