En este artículo explico cómo instalar el entorno para programar en SuperWaba.
Pues aquí vamos con la segunda entrega de la serie de programación en SuperWaba,
donde explicaremos la instalación de las herramientas necesarias para programar
en SuperWaba. Para esto necesitamos:
- JDK (Obligatorio)
- Distribución del SuperWaba (Obligatorio)
- JavaDocs, MSDN, o libro de JAVA (Por si acaso)
- POSE emulador de PALM (No es obligatorio)
- Un IDE decente (no es obligatorio siempre nos queda el NOTEPAD rey
de los IDES)
En este tutorial se tratará sólo la configuración de herramientas gratuitas,
si tiene alguna de pago (MSDN, Visual Java u otra) pues es de suponer que
ya sabrá como instalarlas y si no siempre puedes mandarme un mail y con
gusto trataré de ayudarte, o podríamos tratarlo en otro tutorial.
Instalación del JDK
Primero debemos descargar JDK.
Los JDKs válidos para SuperWaba son JDK 1.1.x y 1.2.2.
La instalación del JDK es muy fácil, solo pulsando los botones de siguiente
se instala. Nuestro directorio de instalación del JDK será por ejemplo C:\JDK
de ahora en adelante se tratará el camino hacia el JDK en base a este directorio.
Instalación opcional de los JavaDocs
Los JavaDocs
son documentación del JDK y, al igual que el JDK, se instalan fácilmente
colocándose en el sitio donde su imaginación le dicte, normalmente dentro
del directorio del JDK en una carpeta llamada Docs, pero esto no es estrictamente
necesario. Los JavaDocs solo son puntos de ayuda y referencia sobre el lenguaje,
por lo que si ya está familiarizado con el JAVA no serán del todo necesarios.
Instalación del SuperWaba
El autor de SuperWaba recomienda que se tome una versión anterior (la 1.21)
a la versión
de SuperWaba que nosotros usaremos, porque ésta es una beta aunque a
mi no me da problemas y la he usado bastante.
Bien ahora que la tenemos descargada vamos a instalarla. Descomprima el
ZIP manteniendo la estructura de directorios y copie el contenido a la carpeta
que se usará para el desarrollo con SuperWaba, por ejemplo C:\SuperWaba
(a partir de ahora esta carpeta "C:\SuperWaba" será el directorio base del
SuperWaba).
Después nos creamos una carpeta para nuestros proyectos. Para tener las
cosas organizadas crearemos una carpeta dentro de C:\SuperWaba llamada proyectos
y ahí será donde trabajaremos. Al finalizar nos debe quedar la siguiente
estructura de directorios:
Ahora tenemos que actualizar el CLASSPATH del JDK para que utilice las clases
del SuperWaba. En WIN 9x/Me abrimos el AUTOEXEC.BAT y si tiene una línea
que dice:
set CLASSPATH=C:\xxx\;xxx
Le añadiremos la ruta a las clases SuperWaba al principio, y si esta línea
no existe la pondremos nosotros. Por ejemplo si nuestro AUTOEXEC.BAT tiene
la siguiente línea o parecida:
set CLASSPATH=C:\jdk\lib;C:\jdk;c:\jdk\include
Entonces nos quedará:
set CLASSPATH=C:\SuperWaba\org\superwaba\palm\classes;
(continúa sin espacios con la segunda línea)
C:\SuperWaba\org\superwaba\palm\bin;C:\jdk\lib;C:\jdk;c:\jdk\include;.;
NOTA: Al final del CLASSPATH si no está el directorio actual
;.;
lo agregamos, vea en el ejemplo el final de la línea, esto es muy importante.
Si la línea de CLASSPATH no existe la ponemos nosotros pero esta vez no
solo agregamos el camino de SuperWaba, también agregaremos el camino al
JDK. Por ejemplo si nuestro AUTOEXEC.BAT es este:
@echo off
set PATH=X:\xx\xx
echo este es mi autoexec, etc....
Nos quedaría:
@echo off
set PATH=X:\xx\xx
echo este es mi autoexec, etc....
set CLASSPATH=C:\SuperWaba\org\superwaba\palm\classes;
(continúa sin espacios con la segunda línea)
C:\SuperWaba\org\superwaba\palm\bin;C:\jdk\lib;C:\jdk;c:\jdk\include;.;
NOTA: fíjese que las clases SuperWaba siempre deben ir primero que las del
JDK esto es debido a queSuperWaba utiliza una clase java.lang propia y si
se pusiera después de las clases del JDK este usaría su clase java.lang.
Si no tiene WINDOWS NT/2K/XP puede saltar al siguiente paso.
En WINDOWS NT/2K/XP el CLASSPATH esta ubicado en la sección Variables de
Entorno del Panel de Control:
Panel de Control\Sistema\Avanzado\Variables
de Entorno
Veremos dos paneles, uno del usuario que esta logueado actualmente y otro
del Administrador. Si es Administrador del ordenador puede ponerlo en cualquiera
de los dos, pero para evitar confusiones lo pondremos siempre en el del
usuario que normalmente es el de arriba.
Aquí es el mismo procedimiento, si la variable ya existe le agregamos las
clases del SuperWaba al principio y si no está agregamos el CLASSPATH con
todas las clases.
Click
para aumentar
Instalación del emulador POSE
Bueno llegados a este punto ya hemos hecho la parte más dura de la instalación.
Nos queda instalar el emulador POSE de Palm OS. Podemos descargar el
emulador
y los
Skins
y si no funciona podemos buscar en la web de
http://www.palmos.com/dev/tech/tools/emulator/
Ahora que los tenemos en el disco duro primero descomprimimos el ZIP del
emulador y ponemos el contenido en un directorio, por ejemplo
C:\POSE,
luego descomprimimos el ZIP de las Skins, creamos un directorio llamado
skins dentro del directorio del emulador
C:\POSE\ y trasladamos
el contenido del zip a ese directorio.
Ya solo nos falta una ROM de palm. La podemos obtener de dos formas: una
rellenando un formulario en el sitio Resource Pavillion de Palm Inc. (esto
es un proceso bastante largo) y el otro método es descargándolo de nuestro
ODB.A continuación reproducimos este método.
- Lo primero es instalar en nuestro ODB el archivo ROM Transfer.prc
incluido en la instalación del emulador y ejecutarlo.
- Luego ejecutamos el emulador, presionamos el botón download y seguimos
las instrucciones que aparecen.
- Al finalizar ya tendremos nuestra ROM lista para utilizar.
Instalación del IDE
El último paso es instalarnos el IDE pero como hay muchos y variados (Visual
Java, JCreator, JBuilder, Forte) eso lo dejo al gusto de cada cual. Para
nuestro propósito utilizaremos el NOTEPAD o BLOC DE NOTAS que es el mejor
IDE que se ha creado y una vez que le coges el gustillo verás como no puedes
vivir sin él, además como ya viene instalado nos viene de perlas.
