Descarga, instalación y uso de herramientas:

Eclipse:

Instalación de Eclipse
(Más información en http://www.eclipse.org/)

1. Copiar, descomprimir e instalar si es necesario la última versión de Eclipse

disponible: 3.3.1.1. (En los laboratorios de prácticas está instalada la versión 3.1).
2. Ejecutar eclipse. La primera vez preguntará por la carpeta (workspace) donde
se quieren ubicar los proyectos, elegir por ejemplo la que se propone por defecto.
3. La primera vez que se ejecute aparecerá una pantalla de bienvenida que podrá ser
visitada en cualquier momento desde la ruta de opciones Help → Welcome. Después de
explorar las opciones de esta bienvenida ir al entorno a través del icono Workbench en la
esquina superior derecha.

Creación de un proyecto JAVA

1. Crear un proyecto JAVA (File →New→Project→Java Project). Elegir un

nombre de proyecto y una ubicación (si no se quiere guardar en la carpeta definida para el
workspace). En el Package Explorer aparecerá una carpeta dedicada al proyecto, sobre ella
y con el botón derecho del ratón se podrá acceder a las opciones más comunes de los
proyectos.
2. Se añaden clases al proyecto a través de File →New→Class.
3. Para especificar la manera en la que queremos ejecutar las clases que forman
parte de un proyecto necesitamos definir una configuración. Esto se hace mediante la ruta
de opciones Run → Run... →Java Application → New. En la ventana correspondiente se
podrán especificar la clase principal del proyecto (pestaña Main) y los argumentos de
entrada (pestaña Arguments).

Instalación del plugin de ANTLR a través del gestor de actualizaciones

remotas
(Más información en http://antlreclipse.sourceforge.net)

1. Seguir la ruta de opciones Help → Software Updates → Find and Install

2. Elegir la opción Search for new features to install
3. Introducir la dirección de donde descargar el plugin (New Remote Site)
http://antlreclipse.sourceforge.net/updates/
4. Una vez creado el enlace a este nuevo sitio marcarlo y proseguir con la
instalación con el botón Next.
 5. Elegir la última versión del plugin y proseguir con la instalación. Al cabo de unas
cuantas confirmaciones se recomendará el reinicio del entorno Eclipse para que las
actualizaciones tengan efecto.

Instalación del plugin de ANTLR a través de una copia local

(Más información en http://antlreclipse.sourceforge.net)

1. Descargar la copia del la última versión del plugin de la página:

http://antlreclipse.sourceforge.net/updates/
2. Seguir la ruta de opciones Help → Software Updates → Find and Install
3. Elegir la opción Search for new features to install
4. Elegir el plugin a través del botón New Archived Site, aparecerá en la pantalla de
actualizaciones disponibles.
5. Marcarlo y proseguir con la instalación mediante el botón Next.

Creación de un proyecto ANTLR

(Más información en http://antlreclipse.sourceforge.net)

1. Crear un proyecto JAVA.

2. Para convertirlo en proyecto ANTLR usar la opción Toggle ANTLR project nature
(botón derecho del ratón sobre nombre del proyecto).
3. Para verificar que efectivamente es un proyecto ANTLR, y que por tanto procesa
automáticamente los ficheros de gramática tras cualquier cambio, se puede comprobar en la
ruta Project → Properties → Builders que ANTLR Builder está activo.
4. A través de la ruta de opciones Project → Properties → Java Build Path → Libraries
se debe añadir la biblioteca de ANTLR (antlr.jar).

Características más interesantes del plugin para ANTLR

La característica más importante del plugin para ANTLR es el tratamiento especial que
hace de los ficheros de gramáticas (*.g). Estos ficheros son procesados por el compilador
de ANTLR (antlr.Tool) y cada vez que son modificados se recompilan
automáticamente. Otras facilidades añadidas del plugin son:
• Coloreado sintáctico.
• Marcadores de errores de la gramática en la pantalla de edición.
• Vista de esquema de la gramática con los símbolos definidos para cada analizador.
• Inclusión automática en el proyecto de las clases JAVA generadas por ANTLR.
• Búsqueda de reglas de la gramática Cajas de texto mostrando las definiciones de
los símbolos cuando el cursor pasa sobre ellos (máximo diez líneas).

Recomendaciones sobre ANTLR

1. El plugin ANTLR para Eclipse no le informa a Eclipse cuando el código Java
generado ha cambiado. Por lo tanto, si tienen archivos .java generados abiertos,
podrían ejecutarse versiones de dichos archivos distintas a las más recientes. Es
mejor cerrar todos los archivos .java generados antes de ejecutar el programa.

2. Durante la depuración de la gramática es útil activar las opciones de traza (trace) del
ANTLR, lo cual puede hacerse seleccionando el archivo de gramática con el botón
derecho del ratón, y seleccionando Properties:
JDK:
Si no lo ha hecho ya, instale algún compilador de JAVA (java.sun.com).
Configure la variable de entorno CLASSPATH. Incluya los siguientes ficheros JAR
y directorios (uso de export en Linux):
"."
“JDK_HOME/jre/lib/rt.jar"
“JDK_HOME/lib/dt.jar"
“JDK_HOME/lib/tools.jar"
“JDK_HOME/jre/lib/ext/dnsns.jar"
“JDK_HOME/jre/lib/ext/ldapsec.jar"
“JDK_HOME/jre/lib/ext/localedata.jar"
“JDK_HOME/jre/lib/ext/sunjce_provider.jar"

Descargar e instalar ANTLR de www.antlr.org. Añada antlr.jar del directorio de

ANTLR a la variable CLASSPATH (En las aulas de prácticas sería:
“/usr/local/eclipse/plugins/org.antlr_2.7.6/antlr.jar”).

Una vez hemos definido el fichero de los analizadores (.g), el siguiente paso será
“compilarlo”. Los ficheros de gramáticas se “compilan” cuando se traducen para generar el
código nativo (JAVA, C++ o C#) de los analizadores.
La compilación la realizaremos utilizando la línea de comandos.

La forma más común de compilar un fichero de gramáticas es mediante la siguiente

orden:
> java antlr.Tool path_del_fichero

Así, si deseamos compilar el fichero MicroCalc.g deberemos hacer algo así:

> java antlr.Tool MicroCalc.g

ANTLR se pondrá entonces en funcionamiento. Si todo ha ido bien, aparecerán

varios ficheros de extensión *.java en el directorio:
• MicroCalcLexer.java
• MicroCalcParser.java
• MicroCalcTreeParser.java
• MicroCalcLexerTokenTypes.java

Los tres primeros ficheros son los analizadores propiamente dichos. El último es un
interfaz JAVA que contiene todos los “tipos de tokens” del analizador léxico.
Queda un único paso para tener unos analizadores completamente funcionales:
compilar los ficheros *.java para obtener los ficheros *.class. Esto se realiza de la misma
manera que compilamos cualquier fichero *.java. Si vamos a compilar un paquete completo
(denominado por ejemplo microcalc), la manera más sencilla de hacerlo es:
> cd ..
> java microcalc/*.java
 Como hemos incluido todos los analizadores dentro del paquete microcalc, es
necesario que los ficheros estén en un directorio llamado microcalc para que puedan
compilarse. Para poder compilar el paquete microcalc, será necesario que ANTLR se
encuentre en el CLASSPATH. El CLASSPATH se puede indicar también en la línea de
comandos a través de la opción del compilador JAVA: -cp.

Una vez generados los analizadores: *.class todavía nos queda un paso muy
importante por dar: hacer que éstos “funcionen”. Hablando en la jerga de C y C++,
diríamos que nos hace falta la función main. En la jerga de JAVA, nos hace falta el método
main. Será en dicho método donde obtendremos datos de entrada y donde se los pasaremos
a los analizadores, que tendremos que haber creado.

Una vez guardado el fichero (p. ej. Calc.java) que contiene la clase (Calc) en la que
se ubica el método main en el directorio correspondiente al paquete, solamente hay que
recompilar:

> javac microcalc/*.java

Solamente nos quedará ejecutar el intérprete:

>java microcalc.Calc

Tendremos que añadir el directorio donde se ubica el paquete microcalc a

CLASSPATH o puede hacerse en la línea de comandos con la extensión –cp.