El manual de usuario de KDevelop: Instalación
Description: Manual de usuario de KDevelop

Página siguiente Página anterior Índice general

### 2. Instalación

### 2.1 Cómo obtener el KDevelop

KDevelop puede ser encontrado en la página de aplicaciones del KDE en http://www.kde.org/current.html o en la página web del KDevelop en http://www.kdevelop.org. El programa también se incluye con algunas distribuciones, tales como la SuSE 6.1.

También puede obtener copias del repositorio CVS del programa desde su página web, para aquellos que quieran tener la última versión disponible del KDevelop. Normalmente, estas copias no están hechas para su uso habitual, sino para probar nuevas características y para mostrar los avances en el desarrollo del programa. Si desea obtener los programas ajenos que KDevelop necesita para funcionar, tales como KDoc y KDbg, también los puede obtener desde la web del programa.

Si encuentra problemas al compilar o utilizar KDevelop, por favor, lea la sección Preguntas y respuestas de este manual, o el fichero FAQ incluido con el paquete del programa. Si su problema no aparece mencionado, por favor suscríbase en la lista de correo de KDevelop en kdevelop@fara3.cs.uni-potsdam.de enviando un correo electrónico con la cabecera vacía, que contenga "subscribe" como único contenido. Sólo se aceptan preguntas y notificaciones de error que tengan que ver con el EID, y no relacionadas con problemas de implementación que puedan surgirle mientras programa su aplicación. Recuerde que todos los mensajes enviados a la lista deben estar escritos en inglés, para que todos los que participan en ella puedan tomar parte de su problema y ayudarle mejor. La lista de correo también está creada para aquellos usuarios que quieran ayudar y que hayan encontrado soluciones para algún problema que les surgió, de forma que podamos solucionar errores y utilizar su conocimiento para dar a los novatos ayuda de primera mano. Una buena forma de notificar errores es enviar la salida que obtenga al ejecutar KDevelop desde la consola, o copiando y pegando el contenido de la ventana de mensajes interna de KDevelop.

### 2.2 Requerimientos

Para poder compilar y utilizar KDevelop necesita los siguientes programas y bibliotecas, que están disponibles para la mayoría de plataformas como paquetes de distribución, y que por tanto pueden ser instalados fácilmente.

Requerido:

- g++ 2.7.2/g++ 2.8.1/egcs 1.1 (o compatible), disponible en http://www.gnu.org
- GNU make (o compatible), disponible en http://www.gnu.org
- perl 5.004, disponible en http://www.perl.com
- autoconf 2.12, disponible en http://www.gnu.org
- automake 1.2, disponible en http://www.gnu.org
- flex 2.5.4,
- GNU gettext, disponible en http://www.gnu.org
- Qt 1.42, disponible en http://www.troll.no
- KDE 1.1.x, disponible en http://www.kde.org

Opcional:

- a2ps o enscript para poder imprimir
- ghostview o kghostview para poder previsualizar la impresión
- glimpse 4.0 para el índice de búsqueda, disponible en http://glimpse.cs.arizona.edu
- sgmltools 1.0, disponibles en http://www.sgmltools.org
- KDE-SDK (KDE Software Development Kit, Conjunto de herramientas de desarrolo para KDE), que incluye KDoc, KSgml2Html, KTranslator (disponible en http://developer.kde.org)
- KDbg, disponible en http://members.telecom.at/~johsixt/kdbg.html
- KIconEdit (disponible en http://www.kde.org)

KDevelop fue probado con SuSE Linux 5.2 y con FreeBSD 3.0 en un AMD K6 200 con 64MB RAM, además de con SuSE Linux 6.0 en un Intel 200 MMX con 128MB RAM.

Por lo que saben los autores, tanto SuSE Linux como FreeBSD contienen todos los paquetes necesarios, incluyendo a2ps y enscript, como paquetes o como ficheros rpm, por lo que no debería tener problemas instalando los programas externos necesarios.

Documentación:

Para crear la documentación de las bibliotecas de KDE, necesita que las fuentes del paquete kdelibs estén instaladas en su sistema. Además necesita el programa KDoc (incluido con KDE-SDK).

También se encuentra disponible en nuestra página una referencia de C/C++, que se integra en navegador de documentación tras su instalación. Descarga el paquete, cópialo como `superusuario` en el directorio del kde y descomprímelo de la siguiente forma: `tar zxvf c_c++_reference.tar.gz`. La guía de referencia estará disponible desde el árbol de documentación; si no es así, al seleccionar la guía de referencia en el navegador, se mostrará un mensaje de error, con la URL desde la que se puede descargar y las instrucciones de instalación.

### 2.3 Compilación e instalación

Para poder compilar e instalar KDevelop en su sistema, escriba lo siguiente en el directorio base de la distribución de KDevelop:

> `

>             % ./configure
>             % make

>             (como superusuario)

>             % make install

> `

Como KDevelop utiliza `autoconf`, no debería tener problemas compilándolo.

Para poder compilar una copia del CVS de KDevelop, escriba lo siguiente:

> `

>             % make -f <idx/Makefile.cvs/
>             % ./configure
>             % make

>             cambie a superusuario y escriba:

>             % make install

> `

Si el comando make de su sistema es `gmake`, escriba `gmake` en lugar de `make`.

### 2.4 Arrancando KDevelop

Si utiliza KDE como gestor de ventanas, KDevelop puede ser lanzado desde "K"->"Desarrollo"->"KDevelop 1.1". Como KDevelop soporta los tipos Mime de KDE, puede también lanzarlo seleccionando un fichero de proyecto KDevelop ("*.kdevprj", mostrado con el icono de proyecto KDevelop) en el gestor de ficheros de KDE. En este último caso, KDevelop se ejecutará y abrirá el proyecto seleccionado. Con otros gestores de ventana, abra la consola y escriba:

> `

>     % kdevelop

> `

Para lanzar KDevelop con un proyecto ya existente, entre en el directorio del proyecto y escriba:

> `

>     % kdevelop  <suProyecto>.kdevprj

> `

La primera vez que un usuario lance el KDevelop, se ejecutará el proceso de instalación automática, que le permitirá configurar las opciones más habituales. Si en algún momento se estropea su instalación, puede reconfigurar el KDevelop de dos formas. Puede escribir:

> `

>     % kdevelop  --setup

> `

o, utilizando el KDE, puede seleccionar "K"->"Desarrollo"->"KDevelop Setup".

### 2.5 El programa de instalación

KDevelop incluye un programa de instalación automática, que se ejecuta cada vez que se lanza KDevelop y no existe el fichero de configuración kdeveloprc. Le recomendamos que siga el proceso de instalación eligiendo "Proceder", para que el programa analice su sistema y para configurar el entorno KDevelop.

Los botones del diálogo de instalación ejecutan las siguientes acciones:

Ayuda: Mostrará este fichero de ayuda.

Proceder: Comienza el proceso de instalación y ejecuta las siguientes acciones

1. Búsqueda de los programas make/gmake, autoconf, autoheader, automake y perl, para la creación y compilación de las aplicaciones generadas por KDevelop. Si gmake está instalado, se usará como comando make. Posteriormente se puede elegir los parámetros que se le pasan al comando make, en el diálogo de configuración del menú Opciones. Si desea leer una introducción al desarrollo de programas en sistemas Unix, vaya a la sección Programas.
2. Búsqueda de los programas KDoc y glimpse. Éstos permiten crear una nueva documentación de la biblioteca KDE y un índice de búsqueda. Si se encuentran los dos programas, tanto el índice como la documentación se crearán en un paso posterior de la instalación.
3. Búsqueda de a2ps y enscript para permitir la impresión de documentos. Alguno de los dos programas ha de estar presente para permitir una correcta impresión. De todas formas, si nínguno de los dos está presente, al instalarse posteriormente alguno de ellos, se puede elegir imprimir con él sin pasar otra vez por la configuración del programa. Unicamente hay que elegir el programa en el diálogo de impresión.
4. Búsqueda de KDbg, KIconEdit y KTranslator. Le recomendamos que instale estos programas, ya que son buenos compañeros para la creación de aplicaciones KDE. KDbg se puede utilizar para depurar su proyecto; KIconEdit sirve para mostrar y editar las imágenes que usted seleccione en el árbol de ficheros. Los programas KDbg, KIconEdit y KTranslator aparecerán disponibles (si se encuentran) en el menú Herramientas de KDevelop. Posteriormente se pueden añadir más herramientas al menú, mediante la opción Herramientas... del menú Opciones.
5. Resumen de los programas encontrados: se muestra una lista que indica los programas que se encontraron, y los que no. Se muestra también una pequeña sugerencia, si la presencia de algún programa es recomendada.
6. Detección del camino hasta la documentación de la biblioteca Qt. Busca la misma en la mayoría de localizaciones estandar para la documentación y configura el camino automáticamente. Si la documentación no es encontrada, porque no está instalada, o porque está en un camino distinto a los habituales, aparecerá un diálogo, que le dará como opciones seleccionar manualmente su situación o continuar. Si elige seleccionar manualmente la situación de la documentación, se le mostrará un diálogo para elegir su localización. Normalmente estará en el directorio qt/html. Tras hacer esto, la instalación puede ser continuada pulsando en "Proceder" otra vez.
7. Si KDoc es encontrado, se le pregutará si desea crear/actualizar la documentación de las bibliotecas de KDE. Para hacer esto, necesita tener las fuentes de dichas bibliotecas. A los usuarios de Linux que hayan instalado KDE desde una distribución, les recomendamos que copien y descompriman las fuentes del paquete de bibliotecas de KDE a su sistema; los usuarios de Free BSD que instalaron las bibliotecas como paquete, deberían buscar el paquete distfile adecuado. Si ninguno de estos casos es aplicable a su situación, descargue los ficheros fuente desde http://www.kde.org y descomprímalos en su sistema. Si lo desea, puede utilizar una documentación ya creada, que se encuentra disponible en http://developer.kde.org; en ese caso, cancele este paso y continúe creando el índice de búsqueda. Cuando la instalación termine, configure el camino hasta la documentación en el diálogo Configuración de KDevelop y vuelva a crear el índice de búsqueda, mediante la opción presente en el mismo diálogo. El diálogo "Actualización de la documentación de la biblioteca KDE" está preparado para utilizar $HOME/.kde/share/apps/kdevelop/KDE-Documentation como el camino por defecto para la documentación. Lo único que debe de hacer es elegir el camino hasta los fuentes de la biblioteca, con el botón situado en la parte superior del diálogo, y pulsar Aceptar. Ejemplo: si obtuvo el el paquete kdelibs.tar.gz desde http://www.kde.org y lo descargo a su directorio $HOME, debe abrir una consola o terminal y ejecutar "tar zxvf kdelibs.tar.gz". Los fuentes se descomprimirán en el directorio /home/nombredeusuario/kdelibs, que contendrá los fuentes de cada biblioteca en un subdirectorio. La biblioteca kdecore estará en el directorio /home/nombredeusuario/kdelibs/kdecore, etc. En el diálogo de actualización deberá elegir el camino a todas las bibliotecas, en este caso /home/nombredeusuario/kdelibs/. Tras pulsar Aceptar, un mensaje en la ventana de instalación le informará de que se está generando la documentación y de que debe esperar al siguiente mensaje.

   NOTA: En un sistema multiusuario o en sistemas con cuotas de disco para las cuentas de usuario, la instalación de documentación HTML para todos los usuarios sería una perdida de espacio. Es este caso, pida al administrador del sistema que ejecute KDevelop como superusuario, para que pueda acceder al directorio raiz del sistema. Entonces instale la documentación dentro del directorio de KDE, en $KDEDIR/share/apps/kdevelop/KDE-Documentation. El camino hasta este punto se puede configurar más tarde en el diálogo Configuración de KDevelop, en el menú Opciones.

8. Si se encontró el programa glimpse en su sistema, se le ofrecerá la posibilidad de crear una base de datos de búsqueda. La base de datos de búsqueda puede incluir la documentación de KDE y la documentación de las Qt (opción por defecto). Además, la documentación del KDevelop será incluida e indexada. Si desea crear un índice de cualquier otra documentación, puede seleccionar su directorio y serán incluidas en el proceso.
9. Durante la creación del índice de búsqueda la ventana de instalación mostrará un mensaje, indicando el proceso que se está realizando.
10. Si todos los pasos de la instalación se realizaron correctamente, aparecerá un mensaje final anunciando que el programa KDevelop será ejecutado tras pulsar Aceptar. Recuerde que puede configurar otras opciones adicionales, tales como el guardado automático de ficheros, en el diálogo Configuración del KDevelop, que es accesible a través del menú Opciones.

Cancelar: Mostrará un mensaje advirtiendo de que el proceso de instalación va a ser cancelado. Desde este diálogo se puede volver a la instalación ("Retroceder") o arrancar KDevelop con los valores por defecto ("Continuar"). En este último caso, deberá configurar todas las opciones manualmente desde los diálogos de configuración del menú Opciones.

Página siguiente Página anterior Índice general