# Primeros pasos con &tdevelop; — Un paseo guiado

Ahora que ha instalado su entorno de desarrollo integrado &tdevelop;, ¿cómo va a utilizarlo de forma correcta? Como se trata de una aplicación compleja, la curva de aprendizaje puede ser un poco larga, especialmente si no está acostumbrado a este tipo de entorno de desarrollo integrado.

Trataremos de suavizar un poco esta curva de aprendizaje mediante la creación de una sencilla aplicación en C++ para KDE. De este modo, veremos (de forma superficial):

- Cómo es la apariencia exterior del IDE &tdevelop;.
- Cómo crear un nuevo proyecto.

## El primer encuentro con &tdevelop;

### Apariencia exterior

Cuando inicie &tdevelop; por primera vez verá una ventana similar a esta:

Disposición inicial de &tdevelop;

### Área de trabajo y pestañas de vistas de herramientas

En esta disposición inicial, &tdevelop; utiliza lo que se denomina modo de interfaz de usuario IDEAl, un área de trabajo del máximo tamaño posible rodeada por la izquierda, por la derecha y por la parte inferior de una serie de botones que funcionan de un modo similar a las pestañas de una ventana con separadores de pestaña. Si pulsa sobre una de estas pestañas se mostrará lo que se denomina ventana de vista de herramientas, que le permitirá trabajar sobre una tarea específica.

### El menú y las barras de herramientas

En la parte superior está la típica barra de menú, seguida por varias filas de barras de herramientas, alguna de las cuales puede estar inicialmente vacía. Tendrán contenido una vez que exista un proyecto abierto sobre el que trabajar.

### La barra de estado

Finalmente, existe una barra de estado en la parte inferior de la ventana, donde se muestran cortas informaciones sobre varias tareas.

### Cómo obtener ayuda

Además del menú Ayuda, que le ofrece respuestas a cuestiones específicas, la barra de estado y dos clases de ayudas emergentes le proporcionarán una rápida información.

### ¿Qué hace esta entrada del menú?

Normalmente, cuando sitúa el cursor del ratón sobre una entrada del menú, se mostrará algún tipo de información corta en la barra de estado. Mientras que en la mayor parte de los casos solo se repite el nombre de la selección, algunas veces proporcionará información adicional sobre el propósito del comando del menú.

### ¿Cuál es el nombre de este elemento?

Si sitúa el cursor durante algunos segundos sobre la mayoría de los elementos, se mostrará una ayuda emergente con el nombre corto de su función. Esto es útil para orientarse rápidamente en las barras de herramientas o en las pestañas de vistas de herramientas del modo IDEAl, cuando el IDE ha sido configurado para que solo muestre iconos en estos botones..

### ¿Qué hace este elemento?

Dispone de más información mediante las ayudas emergentes expandidas que existen en muchos elementos del IDE. Seleccione Ayuda ¿Qué es esto? o pulse &Shift;F1, con lo que el cursor cambiará a un signo de interrogación con el que puede seleccionar el elemento sobre el que desea saber más. También puede abrir cualquier menú de este modo y pulsar sobre cualquiera de sus entradas (tanto activas como desactivadas) para ver si se dispone de más información sobre ella.

### ¿Qué hay en los menús?

Existen diez menús seleccionables en la barra de menú. Muchos de ellos solo dispondrán de todas sus opciones una vez que haya abierto un proyecto sobre el que trabajar, mientras que otros necesitan al menos un documento abierto. Brevemente, le permitirán los siguientes tipos de acciones.

Tenga en cuenta que esto es solo una primera aproximación. Para un listado detallado de los menús y de sus elementos, vea la referencia de comandos.

Archivo

- ### Acciones comunes

  Es bastante estándar. Le permite crear, abrir, guardar, imprimir y cerrar archivos de documentos, así como salir de la forma usual de la aplicación &tdevelop;.

  ### Revertir cambios

  Adicionalmente, le permite deshacer todas las modificaciones volviendo a cargar el contenido del archivo previamente guardado.

Editar

- Este menú solo es útil si tiene abierto algún documento.

  ### Acciones comunes

  Proporciona las típicas acciones deshacer/rehacer y cortar/copiar/pegar. Además, le permite seleccionar bloques de texto de varias maneras.

  ### Buscar y reemplazar

  Existe una función de búsqueda realmente potente en el menú Editar. Además de las típicas acciones de búsqueda y sustitución limitadas al documento actual, también puede realizar acciones de búsqueda y sustitución globales, que le permiten trabajar simultáneamente sobre todos los archivos del proyecto.

  ### Edición de texto avanzada

  Existen opciones para reformatear el documento actual y para completar de forma automática el texto parcialmente tecleado de varios modos.

Ver

- Del mismo modo que el menú Editar, este menú es útil solo si hay un proyecto abierto. En este caso, dispondrá de las siguientes acciones (entre otras):

  ### Historial de navegación

  Desplazarse atrás y adelante entre los documentos, &etc;, que haya visitado.

  ### Seguimiento de errores

  Navegar hasta las líneas de código que contienen los errores encontrados durante el último proceso de compilación o construcción.

  ### Administrar la vista de herramientas

  Mostrar y ocultar ventanas de vistas de herramientas o puntos de anclaje de vistas de herramientas.

  ### Acciones relacionadas con el editor

  Algunas entradas del menú Ver controlan el aspecto del editor que está usando. En caso de sea el componente de &kate; (Editor de texto avanzado empotrable), dispondrá de los siguientes controles:

  - Controlar el comportamiento del ajuste de línea en la ventana del documento.

  - Mostrar u ocultar algunas marcas en el borde de las ventanas de documento: números de línea, iconos y diversos tipos de marcadores.

  - Controlar cómo se muestran las secciones de código fuente plegado (temporalmente oculto).

Proyecto

- Todo el trabajo de &tdevelop; se basa en proyectos, que básicamente son una colección de archivos de código fuente, archivos de administración de la compilación y otro tipo de información residente en una carpeta de proyecto. En este menú puede controlar qué proyecto usar y qué propiedades tiene, además de otras acciones de administración. En particular:

  ### Abrir un proyecto

  Permite crear nuevos proyectos, abrir proyectos existentes e importar proyectos de otros entornos.

  ### Opciones del proyecto

  Permite definir una buena cantidad de propiedades de un proyecto.

  ### Administración de clases

  Añade nuevas clases a un proyecto y traza el árbol de herencia de una clase.

  ### Distribuir el proyecto

  Ayuda a construir paquetes para la distribución del proyecto.

Construir

- Este menú está destinado a compilar y documentar el proyecto, por lo que solo tiene utilidad cuando hay uno abierto. En este caso proporciona las siguientes acciones:

  ### Compilar, enlazar y ejecutar

  Permite compilar y enlazar todo el proyecto o partes del mismo, así como ejecutar la aplicación desde el IDE.

  ### Preparar operaciones de construcción

  Esto depende realmente del sistema «make» que esté utilizando en su proyecto. En el caso de proyectos «automake» permite ejecutar los archivos `Makefile.cvs` y `configure` por sí mismos. También existen acciones para eliminar archivos de traducción del proyecto en varios grados de intensidad.

  ### Instalar la aplicación

  Permite instalar la aplicación en carpetas locales o en las del sistema (solo accesibles al usuario «root»).

  ### Documentación de la API

  Construir o eliminar del proyecto la documentación de la API basada en «doxygen» definida en las opciones del proyecto.

Depurar

- Aunque este menú solo está disponible cuando hay un proyecto activo, solo resulta útil si el proyecto actual ha sido compilado previamente con información de depuración (lo que se puede configurar básicamente en el menú Proyecto Opciones del proyecto). En tal caso dispondrá de las siguientes acciones:

  ### Acciones típicas de depuración

  La primera sección del menú Depurar proporciona una interfaz gráfica para el depurador simbólico GDB de &GNU;. Le permite iniciar y detener su aplicación en el depurador, y avanzar por ella de varios modos.

  ### Puntos de interrupción

  &tdevelop; proporciona algunos métodos para establecer puntos de interrupción en el código fuente de su aplicación. Uno de ellos consiste en usar la entrada del menú Cambiar punto de interrupción.

  ### Depuración avanzada

  Otras entradas del menú Depurar permiten un análisis más sofisticado del programa. Utilice &Shift;F1 paraobtener más información sobre su propósito.

Ventana

- Es un menú bastante estándar. Aquí puede seleccionar la ventana de cualquier documento abierto, así como cerrar una o más ventanas de documentos. También puede seleccionar un conjunto de ventanas de documentos para ser cerradas de una vez.

Herramientas

- &tdevelop; es altamente configurable. Puede seleccionar su editor favorito para sus documentos así como proporcionar herramientas externas para extender las capacidades básicas del IDE. El menú Herramientas refleja gran parte de esta configuración.

  ### Edición avanzada

  El conjunto superior de las entradas del menú Herramientas será proporcionado por la extensión del editor que esté usando. Puede seleccionar su editor favorito en Preferencias Configurar KDevelop... Editor. Tras seleccionar un archivo editable, la parte superior del menú Herramientas proporcionará comandos de edición avanzados específicos de su editor.

  ### Manejo de documentos web

  En caso de que la ventana del documento activo contenga una página HTML (⪚ mostrada a partir de una selección de Documentación), el menú Herramientas mostrará entradas adicionales que le proporcionarán varios métodos para manejar páginas web.

  ### Otras herramientas

  Normalmente existirá un buen número de otras entradas según las herramientas disponibles en cada momento. Utilice &Shift;F1 para obtener más información sobre su propósito.

Preferencias

- Este menú le permite mostrar y ocultar la barra del menú, las barras de herramientas y la barra de estado. Además, puede configurar los accesos rápidos de teclado, las barras de herramientas, las notificaciones, el editor y el comportamiento general de KDevelop.

Ayuda

- Aquí podrá abrir este manual de KDevelop, leer la documentación de Qt, abrir páginas «man» (el formato tradicional de manuales de UNIX) y páginas «info» (el formato de manual GNU), informar de fallos y obtener información sobre su versión de KDevelop y sus autores.

## Cómo comenzar un nuevo proyecto: el &appwizard;

Trata de mostrarle lo fácil que es hacer que KDevelop cree un programa funcional.

El &appwizard; puede crear rápidamente un proyecto a partir de una lista de plantillas de proyectos predefinidos. Todo lo que tiene que hacer es seleccionar el tipo de proyecto que desea, nombrarlo y decidir en qué lugar de su disco situarlo.

Seleccione Proyecto -> Nuevo proyecto. Aparecerá la ventana para crear un nuevo proyecto. Asumamos que desea crear un proyecto típico para KDE, de modo que deberá seleccionar: C++ - KDE - Aplicación de KDE sencilla. Introduzca el nombre, por ejemplo, «holamundo». La ubicación por omisión será /home/usuario/holamundo. Pulse «Adelante» cuando haya terminado con esta ventana. En la siguiente ventana puede establecer algunas opciones que han sido prefijadas a sus valores predeterminados. Pulse «Adelante». Se le mostrarán las plantillas para los archivos .h y .cpp. Puede dejarlas tal y como están y pulsar el botón «Finalizar». Verá el mensaje de que su programa ha sido creado.

Para ejecutar su programa, seleccione Construir -> Ejecutar programa. Se mostrará un mensaje informando de que «automake» y sus programas relacionados deben ejecutarse en primer lugar. Pulse «Aceptar». Su programa será construido y ejecutado, con lo que verá aparecer la ventana de su nuevo programa con un mensaje que dice «Hola mundo». Ahora puede editar su programa y añadirle alguna funcionalidad más útil.