1. Publicado en el WMLClub en Julio de 2000NOKIA WAP TOOLKITPor Santiago Mrquez Sols NOKIA WAP TOOLKIT Hola a todos, con el presente artculo pretendo que todos aquellos de vosotros que estis empezando en el apasionante mundo del WAP tengis un punto de referencia donde dirigiros cuando empecis a programar en WML con el mejor, a mi juicio, de los entornos de desarrollo que existen actualmente, el Nokia Wap Toolkit. Por tanto lo que pretendo, es introduciros en el entorno en el cual vamos a trabajar, describiendo aquellas opciones ms interesantes y tiles, para que vosotros podis sacarle todo el partido que queris a este excelente programa. Empezaremos con como instalar el programa y como compilar y visualizar un pequeo programa en WML, el famoso Hola Mundo que siempre se aprende cuando uno empieza en cualquier lenguaje, sin olvidar hacer una descripcin detallada de nuestro entorno de trabajo y su configuracin. Comencemos pues sin ms tardar nuestro viaje por el Nokia Wap Toolkit. El Nokia Wap Toolkit ofrece a los desarrolladores un entorno para la creacin, prueba y ejecucin de las aplicaciones WAP, lo mejor que tiene este kit es la posibilidad de no tener que salir para nada de la aplicacin ya que disponemos de todas las herramientas necesarias para empezar a trabajar, esto como todos sabris es una gran ventaja, ya que permite al desarrollador el no tener que preocuparse por las herramientas, ya que todas las tiene a su alcance, y centrarse en el desarrollo que es al fin y al cabo lo ms importante, verdad? Entonces, qu herramientas son las que tenemos a nuestro alcance? Disponemos de las siguientes: o WML y WMLScript encoders o Un simulador para poder ver nuestras aplicaciones, es decir, la representacin de un telfono que nos permite ejecutar nuestros programas como si los estuvisemos viendo realmente en nuestro mvil, muy prctico para ver como quedaran nuestras paginas. o Un editor de WML, WMLScript y un editor de WBMP o Lleva todo un sistema de depuracin, visualizacin de variables, etc. Ademas el kit se complementa con una documentacin bastante completa, asi como toda la pila de protocolos WAP implementada que aadido al precio del programa lo hacen ideal para empezar a trabajar. Qu necesitamos para poder usar el Nokia Wap Toolkit? Dado que la plataforma ms extendida es la plataforma Windows vamos a centrarnos en la instalacin en sta, para instalar el programa necesitamos tener lo siguiente: o Windows NT como mnimo con el Services Pack 3 instalado, o bien Windows 95 o 98, esto en cuanto a sistema operativo o En cuanto a mquina los requisitos mnimos que Nokia recomienda son los siguientes: necesitamos un Pentium a 266 Mhz con 20 MB libres de disco duro y 64 Mb de RAM y una tarjeta grfica que soporte el uso de 65000 colores o ms. o Adems necesitamos el Java Runtime Environment versin 1.2.2 o superior, ya que el Nokia Wap Toolkit es una aplicacin basada en Java, de hecho cuando entris en el programa veris que la apariencia es similar pero no exactamente idntica a cualquier otro programa Windows. No olvidis que este programa debe ser previamente instalado a la instalacin del Nokia Wap Toolkit. Podemos descargar el runtime de java desde Sun Microsystems en la siguiente direccin: http://www.javasoft.com/products/jdk/1.2/jre/index.html 1

2. oAdems necesitamos una conexin a Internet si queremos probar servicios que estn ya disponibles en la Red, pero no es obligatoriooFinalmente necesitamos el propio Nokia Wap Toolkit, el cual podemos obtener directamente desde Nokia en la siguiente direccin, el fichero que hay que descargar se llama setupex.exe: http://www.forum.nokia.comUna vez que tenemos todos estos elementos en nuestra mquina, la instalacin del programaes muy sencilla, en primer lugar tenemos que realizar la instalacin del Java RuntimeEnviroment, una vez que este programa est ya instalado correctamente en nuestro equipopodemos proceder a instalar el Nokia Wap Toolkit, para ello ejecutamos el programasetupex.exe que previamente hemos descargado desde Nokia y seguimos las instrucciones depantalla, que se pueden resumir en determinar la ruta donde instalar el software y la carpeta deinicio dentro de la barra de tareas del explorador de Windows.Como veis hasta aqu todo muy sencillo y fcil, no obstante hay una serie de ficheros que seinstalan con el programa y que puede resultaros de utilidad saber que existen. Suponiendo quese hace la instalacin estandar, el Nokia Wap Toolkit se instala en la siguiente ruta: C:ProgramFilesNokiaNokia Wap Toolkit, dentro de este directorio podemos encontrar los siguientesficheros:Nombre Descripcion fichero/DirectorioAcuerdo de licencia con Nokia, recomiendo que os lo License.txtleis Rel_Note.txt Informacin de ltima hora, tambin muy til Toolkit.exeEs el programa en si, desde aqu se inicia la aplicacin W3c-http.jar Libreras java con la especificacin HTTPFichero de configuracin del Nokia Wap Toolkit, estefichero se actualiza cuando hacemos modificaciones en Wapsdk.inilas preferencias dentro del programa, en el cuadro 1podis ver el contenido tpico de este ficheroEs un fichero que java que permite iniciar tambin elprograma usando el programa java desde el interprete Wapsdk.jarde comandos, la sintaxis seria la siguiente:Java -jar wapsdk.ja Waptools.jar Contiene las libreras del servidor Wmlencoder.jar Libreras para WML WmlScriptencoder.jar Libreras para WMLScriptsEste fichero contiene la definicin de tipos de XML que DTDwml_1.1.xmlutiliza WMLEn este directorio tenemos los ficheros con DocsdocumentacinAqu tenemos ejemplos en WMLWMLScriptWBMP que Samplespodemos ejecutarUna ltima cosa sobre la instalacin si en algn momento queris desinstalar el programapodis hacerlo desde el Control Panel seleccionando Add/Remove Programs y eligiendo NokiaWap Toolkit procedereis a su desinstalacin. #WAP SDK Configuration file #Mon Jul 03 11:15:43 CEST 2000 http.gatewayCoPort=9201 Bookmark.number=0 http.useGateway=false http.useHttpCache=false wml.useAccessElement=true wml.characterSet=UTF-8 app.device.location=737,0 2 3. app.main.bounds=0,-2,738,600 wml.validateWML=true browser.historySize=0 http.gatewayClPort=9200 http.useCoConnection=false http.useHttpAuthentication=true http.gatewayAddr=127.0.0.1 http.useHttpProxy=false http.useBytecodeCache=true phone.model=Nokia6150 http.useHttpCookies=true http.proxyUrl= wml.useLocalDtd=true http.useRmiInterfaces=false encoder.useNativeEncoder=trueCuadro 1. Contenido de un fichero WapSdk.ini tpicoAspectos del Nokia Wap ToolkitUna vez que entramos dentro del programa, ya sea desde la lnea de comandos ejecutando elprograma java o haciendo clic en nuestro programa, aparecer la siguiente pantalla (figura 1)Figura 1Como podeis ver en la figura, tenemos:o por un lado una barra de localizacin (Localization toolbar) que nos indica quedocumento WMLWMLScript es el que estamos visualizando.o Una serie de pestaas que nos permiten ver diferentes vistas de nuestro entorno, deeste modo podemos ver mensajes, variables, el historico, los bookmarks o favoritos, elWMLDeck y la Sesino En la parte de la derecha tenemos el simulador del cliente, en este simulador podemosver el resultado del cdigo que vayamos tecleando y probar que la secuencia lgica delprograma es la correcta. Posteriormente cuando tengamos el cdigo definitivopodemos pasarlo a nuestro servidor y colgarlo en la ruta adecuada para que todo elmundo pueda verla. Los simuladores de clientes que aparecen no son productos realesde Nokia, sino como su nombre indica es un simulador.La barra de herramientas de compone de las opciones tpicas de cualquier programa Windows,como son File, para abrir/cerrar ficheros, crear ficheros WML, WMLScript y WBMP nuevos y salirde la aplicacin. El menu Edit, con las opciones de Cortar, Pegar, Deshacer y Rehacer. El menuGo con todas las opciones de refresco de cartar (cards) y recargas de barajas (decks), ir a la3 4. home y abrir URL remotas como ficheros en disco. El menu de Toolkit con las opciones deconfiguracin, seleccin de vistas etc. A lo largo del artculo haremos alusin a las opcionesparticulares de cada menu.Personalizando el Nokia Wap ToolkitEl primer paso que tenemos que seguir cuando nos ponemos a trabajar con el Nokia WapToolkit es realizar la personalizacin del entorno de desarrollo. Para poder realizar esto tenemosuna opcin del men dentro de la pantalla principal que nos posibilita esto, esta opcin laencontramos dentro del menu ToolkitPreferences. Todas las modificaciones que efectuemosdesde esta opcin tiene su correspondiente reflejo en el fichero WapSDK.Ini que veamos antes.Bien que aspectos podemos modificar de nuestro entorno, pues tenemos tres pestaasdiferentes: Communication, Encodig y General, es decir, las caractersticas de la comunicacin,la codificacin del cdigo y otros aspectos generales respectivamente. Vemoslos uno por uno:Communication (Comunicacin): Desde aqu podemos especificar si la comunicacin va aefectuarse va HTTP o a travs de un Gateway WAP (Pasarela WAP). Cada tipo de comunicacintiene su propio conjunto de parmetros que debemos especificar. En el caso de la comunicacinHTTP podemos especificar la siguiente informacin adicional:oUse HTTP Cookies (uso de cookies http): Si activamos esta opcin cualquier cookie que recibamos ser almacenado en el disco, de manera que futuras conexiones al lugar desde donde la descargamos podr hacer uso de la cookie para determinar por ejemplo nuestro perfil de usuario. Para que este cambio tenga efecto hay que reiniciar el Nokia Wap ToolkitoUse HTTP Autentification (uso de autentificacion HTTP), si activamos esta opcion obligamos al programa a usar la autentificacion bsica de HTTP en la cual se nos pedir un usuario y una password cuando el protocolo reciba una respuesta de no autentificacion por parte del servidor (lo que se llama una unauthenticated error)oUse HTTP proxy (uso de proxy), activando esta opcin decimos al programa que vamos a usar un proxy para hacer nuestras conexiones, por lo que debemos de indicar la ruta en la cual se encuentra dicho proxy.En el caso de optar por la comunicacin basada en un WAP Gateway tenemos que configurar lassiguientes opciones:oGateway Address (direccin del gateway): se corresponde con la IP en la cual tenemos configurado nuestro gateway.oUse Connection Oriented Mode/Use Connectionless Mode: Son dos tipos de conexiones que podemos efectuar a traves del Gateway, para ello hay que indicar los puertos que queremos usar (por defecto 9200 para connectionless y 9201 para connection mode), el tipo de conexin Connection Mode es un tipo de conexin segura a travs de Gateway no asi el tipo Connectionless, no obstante la conexin Connection Mode genera ms trfico que la Connectionless ya que es un protocolo ms robusto.oEncoding: Indica el tipo de codificacin que queremos realizar, pudiendo realizar una codificacin rpida de nuestros ficheros WML (lo que en caso de error solo nos devuelve en la ventana de mensajes determinados errores y no todos) activando la casilla Use Fast Encoding. Podemos tambin especificar el juego de caracteres que queremos usar para HTTP entre UTF 8, Latin 1 y Unicode.oGeneral: Podemos indicar el tamao del historico (WML History Size, ms adelante en este artculo se cuenta que es eso del histrico) y el tipo de dispositivo WAP (WAP device) o simulador que queremos para probar nuestras pginas, podemos elegir entre el Nokia 6150 y el Nokia 6110 ambos son terminales que no estn disponibles comercialmente.Las VistasHemos dicho que las diferentes pestaas que aparecen en la parte inferior de la pantallaprincipal permiten ver distintos aspectos del Nokia Wap Toolkit, en este apartado veremoscuales son estos aspectos. En primer lugar para personalizar las vistas que queremos queaparezcan en pantalla podemos hacerlo desde la opcin ToolkitShow del menu principal (figura2) , desde alli podemos determinar que pestaas queremos que aparezcan en la pantallaprincipal. Las vistas que estn activas aparecen marcadas con un smbolo en la parte de laizquierda y para activarlas y desactivarlas basta con hacer click sobre la opcin en cuestin.4 5. Figura 2Las vistas que tenemos son las siguientes:o Mensajes (Messages): Contiene los errores que se producen al compilar nuestrosprogramas asi como cualquier otro tipo de informacin que el Nokia Wap Toolkit nosquiera devolver (figura 3), podemos definir qu nivel de informacin es el quequeremos ver, estos niveles van desde Detail (Detalle, el ms completo, en la figurapodeis ver una salida tipo que se produce cuando seleccionamos este tipo de opcin) aCritical (Crtico, que slo muestra aquellos mensajes que son crticos para la ejecucinde nuestro programa), existen no obstante otros niveles como son Debug (muestrainformacin de depuracin), Normal (es el nivel medio), Warning (nos muestraadvertencias que se produzcan, no son errores propiamente dichos sino situacionesque pueden llevar a un error en un determinado momento). Si queremos borrar todoslos mensajes que se hayan introducido hasta el momento podemos hacerlo haciendoclic en el botn Clear. Figura 3o Variables: Nos muestra todas las variables que estn activas dentro de un documentoWML o WMLScript. El contenido de las variables se puede editar, modificar, aadirnuevas variables, borrarlas, etc, para ello basta con aadir el nombre de la variable ysu valor en el campo Name y Value respectivamente y hacer clic en el botn Set. Siqueremos borrar todas las variables hacemos clic en el botn Clear All (Borrar Todo).5 6. Para que los nuevos valores de las variables tenga efecto en nuestro entorno tenemos que hacer un Refresh Card desde la opcin de menu Go. o Historico (History): El histrico (figura 4) nos muestra todos los cards (cartas) que hemos ido visitando con nuestro navegador cliente. Las cartas se muestran las ms recientes en primer lugar y las ms antiguas (las primeras visitadas) al final de la lista, se puede fijar un lmite de entradas en el histrico desde la opcin Preferences del men principal Toolkit.Figura 4 o WML Deck (Baraja WML): Desde aqu podemos ver el cdigo y el tamao del documento (figura 5) WML o WMLScript activo en este momento. Es importante sealar que desde aqu podemos acceder a otras diferentes presentaciones del documento, estas son: la posibilidad de ver el cdigo original y editarlo (Original Source), la baraja decodificada (decoded deck, que es la opcin por defecto) o bien ver la baraja codificada (undecoded bytecode, en la cual vemos nuestra baraja como una cadena de caracteres hexadecimales)6 7. Figura 5o Bookmarks (Favoritos): Contiene una lista con aquellas direcciones que puedenresultarnos de interes, estas direcciones pueden ser tambin ficheros en nuestro discoduro. Para aadir un nuevo bookmark basta con hacer clic en boton New que apareceen la pantalla e introducir la nueva direccin que queremos aadir, posteriormente siqueremos desplazarnos a dicho bookmark basta con seleccionarlo y hacer clic en elbotn de Go.o Sesin (Session) Esta vista contiene una tabla con tres columnas, la primera de estascolumnas URL determina la URL que ha sido cargada en el sistema, la segundacolumna MIME-TYPE indica que tipo de contenido habia en esa URL (en la siguientetabla os recuerdo los tipo MIME-TYPE posibles). Finalmente la tercera columna, Size,nos muestra la informacin sobre los bytes cargados.MIME-TYPETipo de Contenido MIME typeExtensinFichero WML text/vnd.wap.wml wmlBitmapimage/vnd.wap.wbmp wbmpWML Compilado application/vnd.wap.wmlc wmlcFichero WMLScript text/vnd.wap.wmlscript wmlsWMLScript compilado application/vnd.wap.wmlscriptc wmlscEl editor WBMPUna de las utilidades ms interesantes que tenemos dentro del Nokia Wap Toolkit es el editorde imgenes WBMP, recordar que el tipo WBMP es el tipo definido para las imgenes dentro delestndar WAP. El editor WBMP permite hacer lo siguiente:o Crear imgenes WBMP de cualquier tamao.o Abrir imagines WBMP ya existentes y modificarlas, el editor nos permite cortar, pegary todas las opciones de edicin tpica.7 8. o Importar GIF y JPEG para convertirlas en WBMPo Hacer zooms sobre imgenesSi queremos ver un ejemplo del uso de WBMP dentro del Nokia Wap Toolkit tenemos unprograma llamado weather.wml que nos puede ser de utilidad para familiarizarnos con el usodel editor. Para crear un nuevo WBMP podemos hacerlo desde el men File seleccionar New y acontinuacin seleccionar en WBMP Image, introduciremos el alto y ancho de nuestra imagen yaccederemos al editor propiamente dicho (figura 6), el WBMP es un programa de dibujo muysencillo pero a la vez lo suficientemente potente como para permitirnos hacer todo tipo degrficos que cualquier aplicacin WAP pudiese necesitar.Figura 6Creando un pequeo programa en WMLConociendo todo lo anterior estaremos ya en situacin de crear nuestro primer programa WAPcon el Nokia WAP Toolkit, el programa que vamos a crear es un programa muy sencillo, comodecamos al principio del artculo el tpico Hola Mundo pero en versin WAP. Para hacerloseguimos los siguientes pasos:o Hacemos clic en File/New WML Deck, y vaya! se genera un cuerpo de programaautomticamente que resulta ser casi el que nosotros queremos, salvo por la salvedadde que el mensaje nos aparece en ingles como Hello world. Fijaros en lo til queresulta este entorno de desarrollo ya que los distintos tags, comentarios, en definitivacualquier elemento que escribamos aparece marcado en colores distintos, tambin esinteresante ver que el cuerpo de programa que se nos crea automticamente nospermitir un comienzo rpido para hacer cualquier programa WAP.o Personalizamos nuestro mensaje cambiando Hello World por Hola Mundo.o Hacemos clic en el botn de Compile para ver si nuestro cdigo est escritocorrectamente, en este momento se nos pide que almacenemos el fichero en disco.o Hacemos clic en el botn Show para ver el resultado final de nuestra creacin (figura7).Como veis todo el proceso es muy sencillo, ahora os recomiendo que veais las distintaspestaas para observar que resultados hemos obtenido y asi seguir familiarizandonos con elprograma.8 9. Figura 7Conclusin:Espero que este artculo haya servido a todos aquellos que se inician en este mundo a dar susprimeros pasos con una herramienta muy completa y relativamente fcil de usar, tambinespero que a aquellos que lleven ms tiempo les haya aportado algo nuevo. Y nada ms por miparte, hasta la prxima.Santiago Mrquez Sols 9