Como ya se está haciendo costumbre, nos basaremos en el tutorial de Adobe Apollo y Cómo compilar desde el SDK de Flex 2 de Zguillez, para poder explicar la forma de usar el SDK de Apollo para generar aplicaciones desde HTML.

Muchas personas me comentaron que no saben Flex y que para ellos sería imposible entrar a Apollo, pues no es así, la ventaja de usar Apollo es que podemos desarrollar desde HTML, Flash, Flex, Dreamweaver, bloc de notas, etc, debido a que podremos generar nuestra aplicacion con el SDK de Apollo y por línea de comando (también se puede desde Flex y Flash CS3).

Para poder realizar estos ejemplos podemos usar dos formas:

• Descargar sólo el SDK de Apollo
• Usar el SDK instalado por la extensión de Apollo para Flex

Lo explicaré de las dos formas, ya que el proceso de sólo trabajar con el SDK toma un paso adicional.

Si descargaste el SDK y por ejemplo lo descomprimiste en D:\ tendrás tus archivos así:

Todo bien, lo que ahora debemos modificar es el CLASSPATH para poder ejecutar lo necesario para empezar a trabajar con Apollo.

Para eso hacemos click derecho a miPC -> Propiedades, en la pestaña de Opciones Avanzadas hacer click a Variables de entorno. Buscamos en Variables de sistema a CLASSPATH y le damos a Modificar, escribimos la ruta de nuestro SDK:

Aceptamos y estamos listos para empezar a trabajar.

Por otro lado, si usaste la Extensión de Flex pues no hay muchos cambios. Ya que tu CLASSPATH estará ya configurado, sin embargo si tu deseas adicional a esto tener tu SDK pues podrás agregarlo sin problemas con un punto y coma ( ; ) así:

De esta manera podremos trabajar con el SDK de Apollo con flex o desde nuestra ruta en este caso D:\.

Ahora si manos al código, para empezar, haremos un ejemplo sencillo de como Depurar y Empaquetar nuestra aplicación Apollo. Es ahí donde nos encontramos con ADL y ADT a lo cual daremos una breve explicación.

ADL (Apollo Debug Launcher), nos permite revisar nuestra aplicación para ver posibles errores o simplemente probar nuestro trabajo.

ADT (Apollo Developer Tool), nos genera el archivo AIR que permitirá la instalación de la aplicación. Con ello, logramos empaquetar todos los elementos que usaremos para su ejecución.

Para empezar, haremos un ejemplo básico de HTML desde nuestro muy querido notepad:

Para tener orden, creamos la carpeta llamada ejemplos dentro de la carpeta bin, a su vez, creamos una carpeta llamada prueba1 y guardamos nuestro HTML como prueba1.html.

Ahora abrimos un nuevo documento del notepad y escribimos:

lo guardamos junto a prueba1.html con el nombre aplicacion.xml, que nos permitirá definir propiedades y declarar características de nuestra aplicación.

La explicación de este archivo:

appId: El id que identificará la aplicación.
name: Define el nombre de la aplicación.
publisher: Nombre de la publicación y carpeta donde estará nuestra aplicación, así como la ubicación en inicio/programas/eldervaz
rootContent: Es lo más importante de todo, aquí definimos la forma que tendrá nuestra aplicación, por decir el borde de la ventana con la barra de título, además si queremos que se ejecute y se visualize. Asimismo, ponemos con que archivo se iniciará nuestra aplicación.

Al final debemos ver nuestros archivos así:

Ahora probaremos si funciona nuestro ejemplo con el SDK, para eso abrimos nuestro cmd y escribimos:

Obviamente debe ser corrido desde la carpeta Bin, en este caso desde D, osea así:

y como resultado veremos esto:

Simple y sencillo, ahora ya vimos que no tenemos ningun error, porque de ser así saldría en la ventana de comandos.

Para empezar a empaquetar, necesitamos hacer un pequeño cambio a nuestro aplicacion.xml corrigiendo la dirección de nuestro archivo prueba1.html:

Eso es todo, lo guardamos y ejecutamos en nuestra línea de comandos:

Empiezo a explicar lo que hacemos:

adt nos hará la empaquetación de los archivos.

-package ejemplos/prueba1/miPrueba.air Indica la ruta donde guardaremos nuestro .air

ejemplos/prueba1/aplicacion.xml El archivo xml que define nuestra aplicación.

ejemplos/prueba1/prueba.html Archivos que contendrá nuestro paquete.

Al ejecutar nuestro resultado:

Ahora sólo ejecutamos nuestro instalador y listo.

Si por algun motivo necesitamos agregar algun elemento a nuestra aplicación, por ejemplo miEstilo.css la línea de comando sería así:

listo, con esto ya podemos empezar a hacer un ejercicio simple con ajax que viene en la documentación de Apollo. Para eso tenemos nuestro archivo HolaApollo.html dentro de nuestra nueva carpeta prueba2 con el siguiente código:

Además tenemos un archivo txt llamado request.txt:

nuestro archivo aplicacion.xml:

Aquí podremos ver el trace que hace javascript con la siguiente línea de comando:

Y si queremos empaquetar modificamos aplicacion.xml en:

y escribimos la siguiente línea de comandos:

Como han apreciado, es muy simple trabajar con el SDK sin necesidad de tener conocimientos de Flex o Flash, eso habre puertas a desarrolladores o diseñadores que quieran hacer una aplicación de escritorio con los conocimientos que tienen.

Archivos del tutorial