BerndPol Anne-MarieMahfouf instalación En este capítulo se discutirán los pasos necesarios para compilar e instalar el IDE &tdevelop;: Cómo obtener &tdevelop; se concentra principalmente en la descarga del código fuente más reciente de &tdevelop; desde su repositorio svn. Requisitos de &tdevelop; lista los programas y bibliotecas que necesitará tener instalados para compilar el IDE con éxito. Compilación e instalación de &tdevelop; le guía a través del proceso de compilación e instalación de la aplicación. Cómo obtener la documentación de la API de &tdevelop; le enseña qué es una API y cómo obtener esta útil herramienta para navegar a través del código fuente de &tdevelop;. obtener &tdevelop; &tdevelop; obtener El binario de &tdevelop; está disponible en muchas distribuciones de &Linux;, como SuSE, RedHat y otras. Estos binarios están empaquetados en algún formato adecuado (principalmente RPM) para que su instalación sea fácil. Para instalarlo, siga las instrucciones genéricas que le proporcione su distribución. Tabién puede obtener el código fuente de &tdevelop;, compilarlo e instalarlo usted mismo. Este código fuente se puede encontrar en la página del proyecto, http://www.tdevelop.org, o en el servidor ftp de &kde;. svn Si desea estar al día del desarrollo actual, dispone de versiones descargadas anónimamente del repositorio svn. El nombre del módulo es tdevelop en svn co svn://anonsvn.kde.org/home/kde/branches/KDE/3.5/tdevelop. checkout &tdevelop; svn checkout Para obtener una versión inicial de &tdevelop;, debe descargarla de un svn anónimo. Para realizar esta operación (llamadacheckout) siga los siguientes pasos. Asumiremos que quiere tener su copia de &tdevelop; en la subcarpeta kde3src de su carpeta personal (~). # Crear la carpeta de destino, si es necesario: ~> mkdir kde3src ~> cd kde3src ~/kde3src> svn co svn://anonsvn.kde.org/home/kde/branches/KDE/3.5/tdevelop ~/kde3src> cd tdevelop Tras descargar con éxito su copia de &tdevelop; puede mantenerla al día de los cambios realizados en ella usando el procedimiento de actualización que se muestra en la siguiente sección. No sobrecargue el servidor. Por favor, no haga un «checkout» cada vez que quiera actualizar su &tdevelop;. Use el comando «svn update» para este propósito. Ahora debe compilar su versión de &tdevelop; como se muestra en la sección Compilación e instalación de &tdevelop;. actualizar &tdevelop; svn actualizar Tras descargar por primera vez (y compilar con éxito) &tdevelop; del repositorio tal y como se ha mostrado, tal vez quiera mantener su copia al día para obtener todos los parches que vayan siendo añadidos. Para ello siga los pasos siguientes (de nuevo asumiremos que tiene su copia de &tdevelop; en la carpeta kde3src). Note el uso del comando up (o update) en lugar de co (que significa checkout). ~> cd kde3src ~/kde3src> cd tdevelop ~/kde3src> svn up Eche un vistazo a los mensajes que genera svn durante el proceso de actualización. Los pasos exactos durante la secuencia de compilación dependerán de ello. Ahora puede compilar una nueva versión de &tdevelop; como se muestra en el capítulo Consideraciones sobre la compilación especial de svn. requisitos &tdevelop; requisitos GNU requisitos Para poder compilar y usar con éxito &tdevelop; necesita los siguientes programas y bibliotecas. Están disponibles como paquetes de su distribución en la mayoría de las plataformas, por lo que se pueden instalar fácilmente. gcc/g++ ≥ 2.95.3 (o compatible) gcc requisitos g++ requisitos Disponible en gcc.gnu.org &GNU; make (o compatible) make requisitos Disponible en www.gnu.org/software/make &perl; 5.004 (o superior) Perl requisitos Disponible en www.perl.com autoconf ≥ 2.52 (o superior) autoconf requisitos Disponible en www.gnu.org/software/autoconf automake ≥ 1.6 (o superior) automake requisitos Disponible en www.gnu.org/software/automake flex 2.5.4 (o superior) flex requisitos Disponible en www.gnu.org/software/flex &Qt; ≥ 3.3.0 (o superior) Qt requisitos Disponible en www.trolltech.com/products/qt KDE ≥ 3.4.0 (o superior) KDE requisitos Disponible en www.kde.org La herramienta de navegación a través del código fuente ctags, disponible en http://ctags.sourceforge.net, que le permite acceder de forma rápida a las declaraciones y definiciones mediante varios clics de ratón sobre sus nombres en la ventana del editor. ctags dot, un compilador de lenguaje de gráficos, disponible en http:/www.graphviz.org. Necesita esta herramienta junto a &doxygen; si quiere mostrar gráficamente la relación existente entre sus clases (lo que es muy recomendable). dot La herramienta de documentación &doxygen;, disponible en http://www.doxygen.org, si quiere generar documentación consisa y potente del API de su proyecto. doxygen valgrind disponible en http://developer.kde.org/~sewardj/ le ayuda a encontrar problemas de gestión de memoria en sus aplicaciones. valgrind svn, disponible en http://subversion.tigris.org, si quiere usar el sistema de versiones svn. svn requisitos Cualquier otro compilador o herramienta necesaria para programar en otro lenguaje o plataforma distinto de C++ y &kde;, o para algún fin especial. Hasta cierto punto, puede eludir la necesidad de tener &autoconf; ≥ 2.52 y &automake; ≥ 1.6. Para ello, elimine la carpeta admin en la carpeta de instalación de &tdevelop; y escriba autoconf circumvent version need automake circumvent version need version need circumvent for autoconf/automake (su carpeta de tdevelop)> ln -s $TDEDIR/share/apps/tdelibs/admin admin en la consola. Esto hace que &tdevelop; use las preferencias generales de la carpeta admin de &kde;. Tenga cuidado de no mezclar distintas versiones de &Qt;. Enlace siempre &tdevelop; con la misma versión de &Qt; con que haya sido compilada su biblioteca &kde;. En caso contrario es muy probable que experimente comportamientos muy extraños. &tdevelop; compilación &tdevelop; instalación Una vez que haya complido todos los requisitos, estará listo para compilar e instalar &tdevelop;. Este apéndice trata de los pasos necesarios para conseguirlo. Pasos preliminares le enseña a configurar un entorno correcto. Compilación de &tdevelop; trata sobre cómo obtener el código fuente de &tdevelop; del svn, cómo prepararlo para el proceso de instalación, y finalmente muestra los pasos necesarios para compilar e instalar &tdevelop;. Algunas notas sobre las opciones deconfigure le enseña a ejecutar &tdevelop; si ha sido instalado en una carpeta distinta a la de &kde;. preliminares Instalación de &tdevelop; TDEDIR QTDIR LD_LIBRARY_PATH LIBRARY_PATH PATH Antes de iniciar la secuencia de compilación debe asegurarse de que el sistema «make» puede acceder a todas las bibliotecas y herramientas necesarias. Para ello debe ajustar correctamente algunas variables de entorno. Los pasos reales a realizar dependerán del intérprete de comandos que esté usando. Para evitar el tener que teclear cada vez todas las sentencias que hacen falta para ajustar las variables de entorno necesarias cuando quiera compilar, debería colocarlas en su archivo .bashrc o .cshrc. De este modo, las variables de entorno se ajustarán correctamente cada vez que inicie el intérprete de comandos. Si usa el intérprete bash, añada las siguientes líneas: export TDEDIR=(ruta a su instalación de KDE) export QTDIR=(ruta a su biblioteca Qt) export LD_LIBRARY_PATH=$QTDIR/lib:$TDEDIR/lib:$LD_LIBRARY_PATH export LIBRARY_PATH=$QTDIR/lib:$TDEDIR/lib:$LIBRARY_PATH export PATH=$QTDIR/bin:$TDEDIR/bin:$PATH Si está usando el intérprete tcsh, añada las siguientes líneas: setenv TDEDIR (ruta a su instalación de KDE) setenv QTDIR (ruta a su biblioteca Qt) setenv LD_LIBRARY_PATH=$QTDIR/lib:$TDEDIR/lib:$LD_LIBRARY_PATH setenv LIBRARY_PATH $QTDIR/lib:$TDEDIR/lib:$LIBRARY_PATH setenv PATH $QTDIR/bin:$TDEDIR/bin:$PATH make Instalación de &tdevelop; compilación &tdevelop; En la siguiente sección supondremos que ha colocado el código fuente de &tdevelop; en la carpeta ~/kde3src/tdevelop. En el caso de que utilice una versión de &tdevelop; descargada directamente del repositorio svn, los pasos iniciales para su compilación dependen de si realizó un «checkout» completo y de si solo actualizó el código fuente. Tras hacer un «checkout» del svn Debe inicializar el sistema «make» tras realizar un «checkout». Esto también será de aplicación cada vez que necesite empezar desde cero. Escriba: ~/kde3src/tdevelop> make -f admin/Makefile.common svn-clean y luego siga el resto de pasos siguientes. Necesita tener acceso al repositorio svn para la limpieza si hace falta reconstruir algunos archivos dañados o que no existan en su copia local. El comando svn-clean eliminará cada archivo de la carpeta que no esté en el svn. Asegúrese de hacer una copia de seguridad de cualquier información valiosa antes de ejecutar este comando de limpieza. Tras una actualización svn El siguiente paso depende de la salida de la secuencia de actualización svn. Si ha obtenido como resultado (puede existir una «U» o una «P» como marca en la columna de la izquierda, ambas indicando que el archivo ha sido modificado) algo como esto: U /ruta_a_alguna_carpeta/Makefile.am o si realizó un «checkout» completo, debe introducir: ~/kde3src/tdevelop> make -f Makefile.svn antes de proceder con todos los pasos siguientes. Una vez que el sistema «make» básico haya sido ajustado, debe decidir qué tipo de sistema &tdevelop; quiere usar. Esto se hace en el siguiente paso de configuración, que construye los Makefiles reales que usará el comando make. Puede omitir la opción --prefix en las siguientes líneas de comando para configure si quiere que &tdevelop; se instale en la carpeta predeterminada de &kde;. Consulte el capítulo Algunas notas sobre las opciones de «configure». Una versión compilada para ser depurada Si quiere seguir el rastro de lo que hace su aplicación &tdevelop; cuando esté en ejecución, debe construir una versión compilada para ser depurada. Ejecute el siguiente comando configure para ello: ~/kde3src/tdevelop> ./configure --enable-debug=full --prefix=(donde está su kde3) Una versión compilada para ser liberada Si solo quiere usar &tdevelop; por sí mismo, bastará con una versión compilada para ser liberada (que es más pequeña y se ejecuta más rápidamente). El comando configure hace esto de forma predeterminada. ~/kde3src/tdevelop> ./configure --prefix=(donde está su kde3) Si quiere construir su propia documentación del API de &tdevelop;, debería incluir una opción adicional en el comando configure: ~/kde3src/tdevelop> ./configure --(opciones como las anteriores) \ --with-tdelibsdoxy-dir=$TDEDIR/share/doc/HTML/en/tdelibs-apidocs Make e instalación de &tdevelop; configure comprobará el sistema y creará algunos archivos Makefile según lo que encuentre. El comando make usará el Makefile principal de forma predeterminada. De este modo ~/kde3src/tdevelop> make es suficiente. Si es necesario, obtenga ahora privilegios de usuario root con el comando ~/kde3src/tdevelop> su e introduzca la contraseña del usuario root. Luego, instale la aplicación: ~/kde3src/tdevelop> make install Eso es todo. Si ha instalado &tdevelop; en la carpeta predeterminada de &kde; podrá ejecutar ahora el IDE. En caso contrario, necesitará algunos pasos adicionales como se muestra más adelante en la sección Carpeta de instalación no predeterminada. De hecho, normalmente habrá tres aplicaciones instaladas basadas en &tdevelop;: El IDE de &tdevelop; — el lugar donde normalmente trabajará. El navegador de documentación independiente del Asistente de &tdevelop; — aisla todas las potentes utilidades de documentación del IDE &tdevelop; en una herramienta separada. Esto resulta útil cuando necesita buscar determinada documentación sobre programación pero no quiere iniciar todo el IDE. El Diseñador de &tdevelop; — Amplía el «Diseñador de interfaces de usuario de &Qt;» con elementos específicos de &kde; y se integra perfectamente en el IDE de &tdevelop;. &tdevelop; instalación carpeta no predeterminada carpeta no predeterminada TDEDIRS kbuildsycoca Por defecto, configure prepara el IDE para que se instale en la carpeta predeterminada de &kde;. Esto es necesario porque &tdevelop; asume que puede acceder directamente a ciertas herramientas y partes que residen ahí. Si quiere usar su propia carpeta de instalación, debe indicárselo a configure con la opción --prefix. ~/kde3src/tdevelop> ./configure --prefix=(donde está su kde3) Existe un inconveniente si hace esto: debe proporcionar a &tdevelop; un medio para acceder a las herramientas y partes necesarias existentes en la carpeta de &kde; cuando esté funcionando (puede usar el IDE sin hacer esto, pero no dispondrá de todas sus capacidades). Inicie un intérprete de comandos y ejecute lo siguiente antes de iniciar &tdevelop; en la línea de introducción de comandos: Tenga cuidado en usar la forma plural: es TDEDIRS, no TDEDIR) ~> export TDEDIRS=/usr/local/kde:/opt/kde3 ~> kbuildsycoca (Ahora puede iniciar &tdevelop;) ~> tdevelop La variable de entorno TDEDIRS debe estar asignada a la lista de carpetas del &kde; activo de su sistema. Usamos /usr/local/kde:/opt/kde3 solo como ejemplo. La carpeta /usr/local/kde puede contener, por ejemplo, una versión incompleta de &kde; que haya compilado para propósitos de depuración, y la carpeta /opt/kde3 puede contener, adicionalmente, la versión estándar de&kde; que proporciona su distribución y que usa en el trabajo diario. En un intérprete tcsh debe establecer las variables de entorno usando: ~> setenv TDEDIRS /usr/local/kde:/opt/kde3 El comando kbuildsycoca (construir la caché de control del sistema) busca bibliotecas y cachés, sus ubicaciones y versiones, de modo que &tdevelop; pueda encontrarlas. El inconveniente es que tarda cierto tiempo en ejecutarse (y que necesita ejecutarse cada vez que llama al intérprete de comandos para iniciar &tdevelop; desde una carpeta no predeterminada). Es posible que quiera añadir los comandos anteriores a un guión del intérprete de comandos para eliminar la necesidad de tener que escribirlos una y otra vez. También puede poner esas líneas en su archivo .bashrc o .cshrc, pero esto no es recomendable, ya que kbuildsycoca se ejecutará cada vez que inicie el intérprete de comandos. El comando kbuildsycoca no se ejecuta como usuario «root». Debe llamarlo como usuario normal (pero tampoco es una idea muy buena realizar el desarrollo de software como «root»). API &tdevelop; &tdevelop; API compilación &tdevelop; API configurar API de &tdevelop; API significa interfaz del programa de aplicación. Relmente el API contiene una serie de descripciones (como convenciones de llamada) mediante las que un programa de aplicación puede acceder al sistema operativo y a otros servicios. En nuestro contexto se ha adoptado una definición más amplia: el API de una aplicación &Qt; o de &kde; es un extracto de las interfaces de las clases y de los métodos, una sinopsis para usar como un diccionario para navegar a través del código fuente. Existe una versión del API más reciente disponible en la web de KDevelop. Se actualiza automáticamente cada 24 horas, de modo que siempre esté al día. Esta versión se usa mejor en modo de solo lectura a través de Internet. Si no dispone de acceso permanente a Internet también puede construir su propia documentación del API a partir del código fuente de &tdevelop;. Para ello debe de indicar al sistema «automake» dónde encontrar el API de KDELIBS en su sistema. Esto se consigue con la opción especial --with-tdelibsdoxy-dir en el comando configure cuando prepare la compilación del código fuente de &tdevelop;: ~/kde3src/tdevelop> ./configure --(opciones usuales) \ --with-tdelibsdoxy-dir=$TDEDIR/share/doc/HTML/en/tdelibs-apidocs (make sustituirá la variable global $TDEDIR por la dirección de la carpeta real de &kde; guardada en ella). Ejecute luego el comando make como siempre. Una vez construido el IDE &tdevelop; también tendrá la oportunidad de construir su API. Para ello debe ejecutar ~/kde3src/tdevelop> make apidocs Esto creará un archivo Doxyfile en la carpeta principal de &tdevelop; que luego será procesado por la aplicación Doxygen para generar un buen número de archivos .html con la documentación del API. Cuando este a menudo largo proceso (puede durar más de una hora en un sistema lento) llegue a su fin, tendrá que instalar la documentación del API del mismo modo que tiene que instalar el IDE &tdevelop;. Si es necesario, obtenga permisos de superusuario con ~/kde3src/tdevelop> su e introduzca la contraseña del usuario root. Luego, instale los archivos del API: ~/kde3src/tdevelop> make install-apidox Cuando haya terminado make le informará de la carpeta donde encontrará el contenido de la documentación del API. Apunte esa dirección, ya que podrá usarla desde &konqueror; al igual que desde &tdevelop;, en el caso de que haya configurado el código fuente de &tdevelop; como un proyecto sobre el que trabajar. Es muy probable que vea un buen número de mensajes de aviso y/o de error mientras Doxygen genera la documentación del API. Puede ignorarlos, ya que solo tienen interés para los desarrolladores de &tdevelop;. Si la generación de la documentación del API termina con éxito, podrá utilizar los archivos .html que la contienen.