Compilación de Minimo

Transcripción

1 Capítulo 6 Compilación de Minimo En este capítulo se muestra al lector los pasos a seguir para, desde el código fuente disponible de Minimo, poder llegar a compilarlo obteniendo así un paquete instalable que podremos utilizar en cualquier dispositivo adecuado para ello. La idea de compilar un software es la primera que surge cuando se aborda la cuestión de cambiar algo perteneciente a él, es decir, si se quiere cambiar algo se tiene que hacer en su código fuente natural y luego volver a generarlo para que el software se vea afectado por los cambios. Aunque avanzado el proyecto surge la idea de XPCOM que habla de modificar algún software de Mozilla aisladamente y sin necesidad de compilar de nuevo todo el software, las características especiales de Minimo hacen imprescindible saber construirlo para poder modificar algo en él. Se realizará una descripción detallada de todo el proceso llevado a cabo comentando cualquier pequeño detalle. 37

2 Capítulo 6. Compilación de Minimo 6.1 Compilación detallada de Minimo [7] Paso 1: Requerimientos En primer lugar, debido a que Minimo es un proyecto de Mozilla, para empezar a trabajar se tiene que crear el entorno de desarrollo de Mozilla en Windows. Para ello hay que tener un determinado software instalado que a continuación se detalla. De acuerdo a las indicaciones que proporciona Mozilla en la parte de desarrollo y que podemos encontrar en la siguiente dirección se debe cumplir con las siguientes especificaciones: - Requerimientos hardware: El equipo debe contar al menos con un procesador Pentium III, 512MB de RAM, 1.5 NTFS o 3 FAT de espacio en el disco duro y Windows2000SP4. - Requerimientos software: Es necesario tener el siguiente software instalado: Microsoft Visual C++ (MSVC): Dependiendo del proyecto de Mozilla en el que se quiere desarrollar se tiene que instalar una u otra versión. Para el desarrollo llevado a cabo con Minimo, que tiene ya algún tiempo, se ha utilizado Microsoft Visual Studio Se ha de decir que la versión de Visual Studio gratuita es muy limitada y puede traer muchos problemas, por lo tanto se recomienda usar la versión profesional del producto que instalará correctamente los framework y SDK s necesarios. Microsoft Windows SDK: También dependiendo del proyecto y nuestra máquina se ha de elegir uno u otro. Aquí, para desarrollarlo en Windows XP, y debido a que está dirigido a un navegador para un dispositivo móvil, se tiene que escoger algún SDK de la familia para Windows Mobile, que en este caso será Windows Mobile 5.0 Developer Resource Kit. Dentro de esta SDK se instalaran las dos variantes Windows Mobile 5.0 SDK for Pocket PC y Windows Mobile 5.0 SDK for SmartPhone. 38

3 Proyecto Fin de Carrera MozillaBuild: Mozilla permite descargar de sus páginas un paquete que contiene todo el software añadido al anteriormente comentado propietario de otra empresa para desarrollar su código. Contiene mucho otro software útil y necesario como pueden ser el entorno de desarrollo MSYS, Mercurial, CVS, Python, xemacs, etc. Para este cometido se ha usado MozillaBuildSetup-1.1. Es muy importante recordar que en todas las instalaciones se siguen los pasos sin variar mucho los parámetros que el instalador ofrece como opción, es decir, para futuras referencias a directorios y demás se han conservado los que por defecto se ofrecen. Una vez que se haya instalado todo este software y se cumpla con los requisitos hardware se está en condiciones de comenzar el trabajo con Minimo, pero antes se va a crear una pila de comandos para empezar a trabajar en una ventana de comandos con las variables de entorno apropiadamente asignadas. Esta ventana de comandos es muy similar a la que nos proporciona Windows. El fichero que se creará será un fichero.bat de instrucciones (archivo por lotes de MS-DOS) y se puede consultar con detalle en el apéndice. Se le llamará start-msvc8-nuestro.bat por seguir con la nomenclatura existente en el paquete mozilla-build que se ha descargado. Para crear este fichero ha sido necesaria ayuda de los ya existentes que proporciona Mozilla, haciendo ligeros cambios adecuados para el entorno de trabajo de este proyecto. Se ha añadido set WINCE_TOOLS=c:\home\mozilla\build\wince\tools\vs8ppc2003arm y cambiado SET PATH=%PATH%;%MOZ_TOOLS%\bin por SET PATH=%PATH%;%MOZ_TOOLS%\bin;%WINCE_TOOLS% ya que como se comentó antes se va a trabajar con un dispositivo móvil y se quiere usar este directorio que es en el que residen todas las herramientas de la línea de comandos de Windows CE. 39

4 Capítulo 6. Compilación de Minimo Pues bien, hecho todo esto ahora sí que se está ya en condiciones de empezar a trabajar con Minimo y para ello lo que se va a intentar en primer lugar es compilarlo teniendo su código fuente Paso 2: Compilar Minimo Pasaremos a compilar a través de su código fuente el navegador de Mozilla para términales móviles llamado Minimo. Asumimos que se ha instalado en el directorio c:\mozilla-build (el de por defecto) el paquete que proporciona Mozilla. Se copia en este directorio el fichero que se ha creado anteriormente para tener correctamente asignadas todas las variables de entorno (start-msvc8-nuestro.bat). A continuación, se ejecuta el fichero y se nos abrirá la ventana de comandos mencionada anteriormente. En primer lugar debemos obtener el código fuente de Minimo, y lo haremos a través de cvs con los siguientes comandos ejecutados desde c: en la máquina local: cvs -d :pserver:anonymous@cvs-mirror.mozilla.org:/cvsroot co mozilla/client.mk cvs -d :pserver:anonymous@cvs-mirror.mozilla.org:/cvsroot co mozilla/minimo Con el primer comando se consigue descargar el archivo client.mk en la carpeta mozilla que ayudará posteriormente a compilar y con el segundo comando se baja todo el código fuente. Obtener el código se puede hacer de distintas formas. Incluso se puede navegar por los servidores de Mozilla en busca del código. El resultado final es que se tiene que tener un directorio llamado mozilla y dentro de él otro directorio llamado minimo. Con esto ya se tiene el código fuente descargado en la máquina local para ser posteriormente compilado. A continuación, y siguiendo las instrucciones que proporciona Mozilla, se crea un archivo en el directorio mozilla que se llame mozconfig y en el que se incluye esta línea. $topsrcdir/minimo/config/mozconfig/wince_mozconfig Una vez hecho todo esto es hora de empezar a compilar. Para ello previamente se ejecuta el siguiente comando: 40

5 Proyecto Fin de Carrera make -f client.mk pull_all Con esto se empezará a crear toda una estructura de directorios dentro de nuestro directorio raíz mozilla con multitud de archivos que servirán luego para construir Minimo. Transcurrido un tiempo, se habrán creado todos los directorios y ficheros necesarios. Ahora será el momento de compilar con el comando make -f client.mk build_all pero en la máquina local utilizada esto no se realiza correctamente, por lo que se inicia ahora un trabajo de observación de los fallos que ocurren y se cambian algunas opciones. Hay que decir que los cambios que ahora se comentan son de un significado local y puede que en otra máquina fueran otros y es ya un arduo trabajo el de saber qué ocurre. Este tipo de cambios no se comenta en Mozilla y hacen de la compilación de Minimo una tarea muy difícil y que trae multitud de complicaciones para todos los usuarios. Sólo hace falta darse una vuelta por los foros que hablan de ello para comprender todo esto. Estos son los cambios que se llevan a cabo en la máquina local de desarrollo. Se edita mozilla/build/wince/tools/makefile y se sustituye /D_CRT_SECURE_NO_DEPRECATE por -D_CRT_SECURE_NO_DEPRECATE también se sustituye /rebuild por -rebuild y /clean por -clean Se edita mozilla/build/wince/tools/vs8ppc2003arm/toolpaths.h y se sustituye #ifndef TOPSRCDIR 41

6 Capítulo 6. Compilación de Minimo #include "../topsrcdir.h" #endif por //#ifndef TOPSRCDIR //#include "../topsrcdir.h" //#endif #define TOPSRCDIR "/home/mozilla" es decir, se fuerza ese #define. Por último en este archivo cambiamos todos los Program Files por Archivos de programa debido a que en la máquina local de pruebas este nombre de directorio está en castellano. Todos estos cambios pueden parecer nimiedades pero llevan un gran trabajo detrás de observación. Es sin duda una tarea complicada llegar a compilar Minimo, también debido a que no es del todo un software muy testeado ni desarrollado concienzudamente. También se edita mozilla/configure y se añade la siguiente línea en la número 5563 ac_cv_static_assertion_macros_work="yes" Con todos estos cambios realizados, tras ejecutar en la línea de comandos make -f client.mk build_all y haber esperado mucho tiempo (la primera vez que se compila tarda mucho más que las siguientes) tendremos un directorio creado llamado obj-dirminimo-8-opt dentro de mozilla que será donde se han ido creando los resultados de la compilación. Se está ya a punto de tener una versión de Minimo, pero antes hay que empaquetarlo y hacer el instalador. Desde el directorio mozilla/obj-dir-minimo- 8-opt/minimo/base se ejecutan los siguientes comandos: make package make installer Si todo ha salido correctamente, por fin se tiene ya en el directorio mozilla/objdir-minimo-8-opt/dist el instalador para cualquier tipo de dispositivo móvil con el nombre minimo_wince_setup. 42

7 Proyecto Fin de Carrera Paso 3: Testeo Tras los muchos esfuerzos llevados a cabo para la tarea de construir un paquete instalable de Minimo a partir del código fuente que nos proporciona Mozilla, se va a probar que funciona el navegador compilado. Para ello se realizarán las pruebas sobre el emulador de dispositivos móviles que proporciona Microsoft Visual Studio. Ahora se trata de emular que se tiene el hardware de un dispositivo móvil en el ordenador mediante software. Para realizar pruebas no hay muchas diferencias con un dispositivo real y es muy útil debido a lo engorroso que es muchas veces tratar directamente con el dispositivo por no comentar el coste de dinero que puede tener si durante las pruebas cometemos algún fallo de vital importancia (algo muy común). Previamente se va a instalar Microsoft ActiveSync 4.5. Esta herramienta que proporciona Microsoft sirve para sincronizar nuestro dispositivo móvil con el ordenador. Se van a poder explorar los archivos y documentos de nuestro dispositivo mediante el ordenador y viceversa. Es una potente herramienta para llevar a cabo transferencias de archivos entre el dispositivo móvil y el ordenador y además va a ayudar siempre a instalar un determinado software desde cualquier ordenador. Es imprescindible para la tarea que se va a llevar a cabo ya que se puede decir que es a través este programa como se van a realizar las comunicaciones entre el dispositivo móvil, en este caso el emulador, y el ordenador. Figura 6.1: Ventana de Microsoft ActiveSync. En la anterior figura (Figura 6.1) se puede ver una ventana típica de Microsoft ActiveSync que muestra que no hay ningún dispositivo conectado. 43

8 Capítulo 6. Compilación de Minimo En esta figura vemos el icono que aparece en la barra de tareas de Windows que indica que ActiveSync está instalado y su color gris que no hay ningún dispositivo conectado. Si se encuentra en color verde nos estará indicando que ya hay algún dispositivo conectado. Figura 6.2: Iconos de Microsoft ActiveSync. Una vez instalado Microsoft ActiveSync se arranca la herramienta del emulador desde la pestaña correspondiente en Visual Studio. Aparecerá una ventana con los dispositivos que es capaz de emular dependiendo de los SDK s que se hayan instalado en la máquina de esta forma: Figura 6.3: Ventana del emulador de Microsoft Visual Studio. Escogeremos, por ejemplo (siempre sin salir de Windows Mobile 5.0 objetivo de nuestro proyecto) Windows Mobile 5.0 Pocket PC Emulator. Con el botón derecho del ratón se elegirá connect y aparecerá una ventana con correspondiente al emulador del dispositivo. Mientras tanto en la ventana del Device Emulator Manager se nos indicará con algún icono que nos hemos conectado a este dispositivo. Ahora es cuando debemos iniciar la comunicación entre nuestro ordenador y el dispositivo móvil emulado. Ésta se va controlar a través de ActiveSync. Para 44

9 Proyecto Fin de Carrera ello, de nuevo con el botón derecho del ratón sobre el Device Emulator Manager se elegirá cradle que sería algo parecido a posar el dispositivo móvil sobre una base para su comunicación con el ordenador. Al hacer esto el icono sobre la barra de tareas se coloreará de verde e iniciará un gestor que nos va a ayudar a llevar a cabo la comunicación. Éste preguntará qué tipo de archivos se quiere sincronizar y creará una carpeta en el ordenador correspondiente a los documentos del dispositivo móvil. Es ahora cuando ya podemos fácilmente transferir archivos de un lado a otro. Si se mira en nuestro icono de Mi PC de Windows se verá que aparece un dispositivo que corresponde al dispositivo móvil. Se puede explorar y ver cómo se organizan sus documentos. A continuación instalaremos Minimo con el ejecutable que se había creado como si fuera otro programa normal de Windows. El instalador llevará a cabo las operaciones en uno y otro lado y tras ello se tendrá en nuestro emulador de dispositivo móvil el navegador Minimo que tanto se ha buscado. Ahora ya únicamente queda moverse por el dispositivo móvil y buscar el icono de Minimo. En la siguiente figura (Figura 6.4) se puede ver cómo, dentro de los programas, ha sido instalado Minimo. Tiene un icono peculiar que recuerda un tanto a su hermano mayor Mozilla Firefox. Hay que decir que navegar por un sistema operativo para dispositivos móviles como es Windows Mobile, no es nada más complicado que hacerlo por el archiconocido Windows. Por lo tanto la tarea de encontrar Minimo no es muy complicada. 45

10 Capítulo 6. Compilación de Minimo Figura 6.4: Minimo instalado en Programs. Una vez encontrado ya sólo nos quedará ejecutarlo y navegar con él. Concluimos el capítulo con varias capturas de pantalla de nuestro emulador con Minimo funcionando en él. 46

11 Proyecto Fin de Carrera Figura 6.5: Pantalla de inicio de Minimo. 47

12 Capítulo 6. Compilación de Minimo Figura 6.6: Minimo con la página de Google cargada. 48