Bernd
Pol

# Primeros pasos — el &appwizard;

En &kdevelop; el trabajo de desarrollo de software se organiza en proyectos. Estos proyectos guardan junto todo lo que pertenece a una completa tarea de programación: archivos de código fuente, archivos de datos adicionales, cualquier utilidad de gestión realmente necesaria (como el sistema de construcción), así como el acceso a todos los componentes y cualquier herramienta adicional necesaria para generar la aplicación y para ejecutarla.

La organización de todas las tareas de desarrollo en proyectos le permite cambiar fácilmente entre diferentes tareas globales. Esto es bastante útil si, &eg;, trabaja en varias aplicaciones al mismo tiempo, como suele suceder a menudo. Dígale a &kdevelop; que abra el proyecto en el que quiere trabajar y podrá continuar en su entorno tal y como lo había dejado la última vez.

## Nuevos proyectos

Cada vez que desee iniciar un nuevo proyecto de programación necesitará realizar bastantes procesos de configuración. Deberá establecer una estructura de carpetas inicial, proporcionar archivos de cabecera y de código fuente iniciales, inicializar el sistema de construcción, &etc;

&kdevelop; le proporciona un modo fácil de iniciar un nuevo proyecto de programación: el &appwizard;. Encontrará el &appwizard; en la opción del menú Proyecto Nuevo proyecto.

Si usa el &appwizard;, solo necesitará realizar una corta serie de pasos para comenzar un nuevo proyecto de programación:

1. Seleccionar el lenguaje de programación que desea usar y el tipo de aplicación que desea generar a partir de un juego de plantillas predefinidas.

2. Proporcionar alguna información general como el nombre de la aplicación, la carpeta donde deberá ser generada, &etc;

3. Decidir si desea utilizar un sistema de control de versiones, como &eg; CVS, y proporcionar los datos que fueran necesarios.

4. Configurar algunas plantillas para los archivos iniciales de cabecera y de código fuente (si es necesario).

5. Finalmente, dígale al &appwizard; que genere todo lo necesario, la estructura de carpetas, las plantillas iniciales para archivos de cabecera y código fuente, los archivos de las herramientas de gestión (como, &eg;, un esqueleto make inicial), &etc;

¡Y ya está! Eso es todo. &appwizard; le proporcionará un juego de archivos de programación con funcionalidades primarias con los que podrá comenzar a trabajar inmediatamente.

Veamos ahora todo esto más detalladamente...

### Pasos iniciales

Para crear un nuevo proyecto en &kdevelop;, seleccione Nuevo proyecto en el menú Proyecto. El diálogo Crear nuevo proyecto se mostrará con una página General inicial:

Diálogo inicial para configurar un nuevo proyecto

Como puede ver, este diálogo está dividido en dos partes: en la superior puede decidir el lenguaje de programación y el tipo de aplicación; la parte inferior guarda alguna información general.

#### Selección del lenguaje de programación y tipo de aplicación

En el lado izquierdo de la parte superior de este diálogo podrá realizar la selección de su trabajo. En él encontrará una lista de carpetas, cada una etiquetada con el nombre de un lenguaje de programación, como estos:

- Ada

- C

- C++

- Base de datos (proyectos SQL)

- Fortran

- Haskell

- Java

- PHP

- Pascal

- Perl

- Python

- Ruby

- Shell (guiones para el intérprete Bash)

Para ser precisos, estas carpetas no contienen realmente herramientas de programación, sino que conducen a plantillas predefinidas que puede utilizar como punto de partida para desarrollos en dichos lenguajes. Para hacerse una idea de lo que se le proporciona, abra las diferentes carpetas. Encontrará varias subcarpetas en algunas de ellas, mientras que en otras solo habrá una o más entradas simples. Estas subcarpetas sirven para organizar las plantillas disponibles según algunas tareas; las entradas simples se refieren a las plantillas que puede seleccionar.

No podemos entrar aquí en detalles sobre qué tarea proporciona cada plantilla, pero es fácil hacerse una idea. Cada vez que seleccione una entrada de plantilla se mostrará distinta información en los campos de la derecha. En el campo inferior encontrará una corta descripción de lo que se supone que hace la plantilla. En el campo inmediatamente superior se mostrará una imagen (si está disponible) sobre el aspecto de la aplicación que producirá dicha plantilla si la compila y ejecuta sin modificaciones. Normalmente se trata de una captura de pantalla de la ventana principal que muestra la aplicación.

Para empezar, seleccione la plantilla que se adapte mejor a los objetivos de su aplicación. Luego, introduzca la información de las propiedades generales en los campos inferiores tal y como se muestra en el siguiente capítulo.

##### Selección de un sistema de gestión del proyecto

Cada plantilla está ligada a un sistema degestión de proyecto específico. Actualmente no existe un medio directo para seleccionar libremente este sistema de gestión del proyecto. Deberá encontrar una plantilla que se adapte a sus necesidades o alterar su proyecto apropiadamente tras su creación.

#### Proporcionar información general

La parte inferior del diálogo Crear nuevo proyecto, en la página General, consiste en un cuadro con la etiqueta Propiedades. Aquí debe proporcionar alguna información general sobre su proyecto para que el &appwizard; sepa cómo generar la estructura inicial.

##### Nombre de la aplicación

Por supuesto, su aplicación necesita un nombre. Introdúzcalo en el campo superior de las Propiedades, llamado Nombre de la aplicación. Usaremos MiAplicacion como ejemplo.

Es posible que cuando lo haga note que el &appwizard; se niega a aceptar algunos caracteres especiales. Los únicos caracteres aceptados son:

- caracteres en mayúsculas y minúsculas (sin acentos)

- números

- el carácter de subrayado

La principal causa de esta restricción es que el &appwizard; usará el nombre de la aplicación como base para algunos nombres de clases que generará al crear un proyecto inicial. De este modo, el nombre de la aplicación debe ajustarse a las reglas del lenguaje de programación que va a utilizar.

##### La carpeta del proyecto

La otra causa importante para esta restricción puede verla en la línea inferior del área Propiedades, etiquetada Ubicación final, y que muestra la carpeta donde el &appwizard; generará su aplicación.

Mientras escribe el nombre de la aplicación notará que &appwizard; repite los caracteres introducidos al final de la línea etiquetada Ubicación final, utilizando únicamente caracteres en minúsculas.

Por lo tanto, debe seleccionar el nombre de su aplicación con cuidado. Si ha escrito el nombre de una carpeta existente, el &appwizard; no le permitirá continuar con el siguiente paso, manteniendo desactivado el botón Adelante >. Además, le avisará en este caso añadiendo (carpeta/archivo existente) en la línea Ubicación final.

##### La ruta inicial

Existen dos modos de seleccionar otra ruta para su nueva aplicación. Una consiste en seleccionar otro nombre. Aún así, esto no es siempre factible (&eg;, puede estar preparando otra versión de una aplicación ya existente). Como alternativa, puede seleccionar otra ruta para la carpeta de la aplicación.

Puede hacer esto en la segunda línea de Propiedades, etiquetada Ubicación. Lo que debe introducir aquí es la ruta inicial de la carpeta de desarrollo de la nueva aplicación. El &appwizard; añade el nombre de la aplicación a esta ruta cuando inicializa el nuevo proyecto. El resultado se muestra en la línea Ubicación final para proporcionarle un mejor control sobre lo que está ocurriendo.

El &appwizard; copiará un valor inicial en el campo Ubicación al comienzo, que se toma de lo que ha introducido en el campo Carpeta predeterminada para los proyectos durante los pasos de configuración general. En nuestro caso, hemos indicado a &kdevelop; que utilice `/home/devel/projects/` como ruta inicial para nuestros proyectos.

Modifique el contenido del campo Ubicación de modo que la carpeta de desarrollo para su aplicación mostrada en la línea Ubicación final sea única.

Tenga cuidado de que la ruta que introduzca en el campo Ubicación ya exista. En caso contrario, no podrá continuar con el siguiente paso. El &appwizard; le avisará si no existe la ruta añadiendo (no válida) a la línea Ubicación final.

Preparar el nuevo proyecto para CVS

##### Información personal

Los siguientes campos no son tan críticos. Solo tiene que proporcionar su nombre (&ie;, el nombre de la persona que es responsable de la aplicación) en el campo Autor, y una dirección de correo electrónico válida en el campo Correo electrónico. De este modo, los usuarios de su aplicación podrán ponerse en contacto con el autor.

1. El &appwizard; rellena estos campos con algunos valores por omisión, tomados de los datos establecidos en el &kcontrolcenter;. Si los valores por omisión que ve en los campos Autor y Correo electrónico del diálogo Crear nuevo proyecto no son correctos, debería revisar su configuración de correo electrónico en el &kcontrolcenter;.

2. El &appwizard; integrará esta información en las plantillas de comienzo del programa, si es necesario. En los programas en C++ de &kde;, por ejemplo, encontrará estos datos cerca del comienzo del archivo de código fuente `main.cpp`.

3. De todos estos campos, el Correo electrónico es opcional, teniendo en cuenta que no todos los programadores pueden tener acceso a Internet. Puede dejar este campo en blanco si así lo desea y continuar sin problemas.

##### Información sobre la versión y la licencia

Finalmente, introduzca un número inicial de versión para su nueva aplicación en el campo Versión, y seleccione la licencia bajo la que desea que esté su aplicación en la pestaña Licencia.

Si ha seleccionado un tipo de aplicación para el que el &appwizard; proporciona textos de plantilla de código fuente comunes (&eg;, C/C++), verá el texto de notificación de la licencia en la tercera página de este diálogo Crear nuevo proyecto (vea más adelante el capítulo Proporcionar plantillas para las cabeceras y el código fuente).

Si selecciona Personalizada en la pestaña Licencia, deberá proporcionar un texto propio para la licencia.

Tanto la versión como la información sobre la licencia serán también integradas en las plantillas de comienzo de un modo adecuado que proporciona el tipo de aplicación que ha seleccionado.

Una vez que haya introducido correctamente toda esta información, pulse el botón Adelante > para proceder como se muestra en los siguientes capítulos.

### Proporcionar información sobre el sistema de versiones

En un segundo paso, el &appwizard; le llevará a la página del Sistema de control de versiones, donde puede decidir qué sistema de control de versiones desea utilizar.

Esta discusión se concentra solo en las necesidades de la creación del proyecto. Para más información sobre &CVS;, vea más adelante el capítulo Uso de &CVS;.

#### No se desea usar un sistema de control de versiones

Inicialmente estará seleccionado Ninguno en la pestaña Sistema de control de versiones, y el resto de la página estará en blanco. Si no desea utilizar un sistema de control de versiones, pulse el botón Adelante > para continuar.

#### Uso de &CVS;

En cualquier otro caso, deberá seleccionar el sistema de control de versiones que desea utilizar en la pestaña Sistema de control de versiones. Usaremos &cvs; en nuestro ejemplo. Si lo selecciona, el &appwizard; volverá a visualizar la página, mostrándole una serie de campos que debe rellenar.

Preparar el nuevo proyecto para CVS

Un sistema de control de versiones como &CVS; (que significa Sistema de versiones concurrentes) almacena copias de los archivos seleccionados del proyecto en algún tipo de base de datos. Si utiliza &CVS;, podrá, entre otras cosas, subir (commit) estos archivos o descargarlos en la carpeta de su proyecto (checkout, o update). Lo que este sistema tiene de especial es que los archivos existentes en la base de datos de versiones se almacenan de un modo estructurado que le permite recuperar en cualquier momento un estado de desarrollo anterior, si lo necesita. Y &CVS; permite que varios programadores colaboren de un modo bastante fácil en un gran proyecto (como &kdevelop;) sin interferir en el trabajo de los demás.

#### Raíz &CVS;

&CVS; necesita gestionar la base de datos de versiones que mantiene de sus archivos del proyecto. Para realizar esta tarea, mantiene cierta información especial de la base de datos en una carpeta propia, llamada raíz &CVS;. El primer paso para acomodar su nuevo proyecto a &CVS; consiste, pues, en indicarle a &kdevelop; dónde está ubicada esta raíz.

Raíz &CVS; local. Existen dos posibilidades básicas: usar una base de datos &CVS; local, o bien usar una base de datos situada en un servidor remoto. Si está desarrollando para usted mismo, tal vez prefiera usar la base de datos de &CVS; como si se tratara de un sistema de copias de seguridad en su propio sistema. Habitualmente establecerá esta raíz en su carpeta personal, dándole el nombre `cvsroot`, tal y como se muestra a continuación:

``/home/devel/cvsroot`` (donde `devel` se refiere al usuario programador, solo a título de ejemplo)

De hecho, esta es una forma abreviada. Exactamente, la raíz &CVS; local debe ser referida usando el prefijo `:local:`. La forma abreviada solo está permitida en los casos en que el nombre de archivo comience con una barra (`/`). El nombre completo para nuestro ejemplo de raíz &CVS; local sería: `:local:/home/devel/cvsroot`

Introduzca el nombre de la carpeta raíz de &CVS; que ha sido establecida en su sistema en el campo Raíz CVS. En principio, puede seleccionar cualquier nombre, e incluso usar múltiples bases de datos &CVS;, pero es recomendable que se atenga a la raíz &CVS; una vez establecida.

Inicializar una nueva raíz &CVS;. Si todavía no existe una raíz &CVS;, &kdevelop; puede ordenar al sistema &CVS; que cree una por usted en la carpeta indicada. Solo tiene que marcar la casilla Iniciar raíz que hay debajo del campo Raíz CVS.

Como se ha dicho, &kdevelop; solo ordena al sistema &CVS; que inicialice una nueva raíz &CVS;, pero no hace nada por sí mismo en esta carpeta. Por fortuna, &CVS; es lo suficientemente inteligente como para comprobar si ya existe la carpeta raíz &CVS;. De ahí que no sea peligroso que marque Iniciar raíz sin tener en cuenta que ya pueda existir una carpeta raíz &CVS;.

Raíz &CVS; remota. Existen ocasiones en las que la base de datos &CVS; se mantiene un un servidor remoto, especialmente cuando varios programadores trabajan en el mismo proyecto. En este caso, debe introducir el &URL; de la raíz &CVS; de este servidor en el campo Raíz CVS. Por ejemplo, si desea acceder al servidor &CVS; de &kde;:

``:pserver:mi_login@cvs.kde.org:/home/kde`` (donde mi_login se refiere al nombre de usuario establecido para su cuenta &CVS; de &kde;)

#### Tipos de servidores remotos de &CVS;

Básicamente existen dos tipos de servidores de &CVS; remotos ampliamente usados: el pserver, que utiliza un protocolo no cifrado asegurado por una contraseña, y el servidor ext, que utiliza transferencias de datos cifrados con rsh o ssh. Se distinguen por el prefijo de &URL; que utilizan:

`:pserver:`

para el tipo de servidor protegido por contraseña, y

`:ext:`

para el tipo de servidor que usa rsh o ssh. Por ejemplo

``:ext:mi_login@cvs.cervisia.sourceforge.net:/cvsroot/cervisia``

accede a la raíz &CVS; de la ampliamente usada herramienta de gestión Cervisia en el servidor de SourceForge.

Si desea utilizar un servidor de &CVS; que soporte acceso cifrado con rsh o ssh, debe indicarle a &kdevelop; el protocolo de cifrado que debe usar. Solo tiene que introducir `rsh` o `ssh` en el campo CVS_RSH de la página Sistema de control de versiones del diálogo Crear nuevo proyecto.

Debe tener en cuenta ciertos aspectos si usa un servidor cifrado para &CVS; con &kdevelop;. Vea el capítulo Uso de &CVS; para más detalles.

#### El repositorio &CVS;

Hasta ahora solo le ha indicado a &kdevelop; dónde reside la raíz de &CVS; para manejar la base de datos de versiones y cómo acceder a ella. Ahora necesita indicarle a &kdevelop; con qué nombre desea que el &CVS; guarde los archivos de su proyecto en dicha base de datos. Este lugar que contendrá los archivos de su proyecto en el &CVS; se denomina repositorio.

En principio, puede usar cualquier nombre para el repositorio &CVS; de los archivos de su proyecto, siempre que siga la especificación para nombrar archivos. Aún más, la mayor parte de los programadores usan simplemente el nombre de la misma aplicación. &CVS; creará una carpeta con este nombre en la raíz del &CVS;, de aquí que sea más fácil encontrarlo si mantiene el nombre de la aplicación para este propósito.

Solo debe introducir el nombre del repositorio que desea usar en el campo Repositorio CVS de la página Sistema de control de versiones del diálogo Crear nuevo proyecto. En nuestro ejemplo es: `MiAplicacion`

Tenga cuidado de no utilizar un repositorio existente. El sistema &CVS; no avisa sobre archivos duplicados, sino que aceptará cualquier cosa que no genere un conflicto formal. Si no tiene cuidado, acabará mezclándolo todo.

#### Los campos restantes

No queda demasiado trabajo por hacer. El &appwizard; ya habrá rellenado el resto de campos por usted. Con más detalle:

El campo Proveedor se usa solo por razones de compatibilidad. Puede aceptar el proveedor predeterminado que el &appwizard; ha colocado en él.

El campo Mensaje le permite comentar el contenido inicial del &CVS;. Puede usar el texto que desee o dejar el texto nuevo proyecto que el &appwizard; ha colocado en él de forma predeterminada.

La Etiqueta de publicación contiene el nombre que va a etiquetar el estado inicial de su proyecto. Esta etiqueta denomina un cierto punto dentro del repositorio &CVS; por el que puede acceder más tarde a este estado de su desarrollo. Vea más detalles en el capítulo Uso de &CVS;.

El &appwizard; ha colocado una etiqueta inicio por omisión en este campo, lo que constituye una buena propuesta. Puede aceptarla sin más.

Cuando cualquier información contenida en estos campos sea incorrecta, &kdevelop; no se dará cuenta normalmente hasta el momento en que construya su proyecto. Es el sistema &CVS; el que informará de estos errores cuando trate de construir el repositorio. Por ello, debería revisar la ventana de Mensajes de &kdevelop; cuando sea creado el proyecto durante el último paso. Si existe algún error relacionado con el &CVS;, en la mayoría de los casos observará un mensaje de error como este:

    * cd '/home/devel/test' && cvs -d '/home/devel/cvsroot' \
      import -m 'nuevo proyecto' '' 'proveedor' 'inicio' &&\
      sh /opt/kde3/share/apps/kdevcvs/buildcvs.sh . '' \
      '/home/devel/cvsroot'
    * cvs [importación abortada]: /home/devel/cvsroot/CVSROOT: No existe el
     archivo o el directorio
    * *** Terminado con estado: 1 ***

Si ocurre esto, deberá configurar el &CVS; manualmente (&kdevelop; habrá inicializado correctamente los archivos de su proyecto en este momento), o bien eliminar la carpeta del proyecto y comenzar de nuevo con la opción Nuevo proyecto del menú Proyecto.

Una vez que haya introducido toda la información relacionada con &CVS;, pulse el botón Adelante > para continuar.

Si desea corregir algún error de la página anterior del diálogo Crear nuevo proyecto, pulse el botón < Atrás. El &appwizard; recordará sus preferencias de la página actual, de modo que pueda continuar cuando vuelva a ella.

### Proporcionar plantillas para cabeceras y código fuente

El siguiente paso le muestra una serie de páginas donde puede indicar cierta información que desee incluir en sus archivos de código fuente y de cabecera, si la tarea que seleccionada lo permite.

Tanto la plantilla de la cabecera como la del código fuente se proporcionan para las aplicaciones C y C++, cada una en su propia página. Para otros lenguajes es posible que solo exista la plantilla para el código fuente. Y en algunos casos incluso encontrará vacía esta página de plantilla.

Si se usa esta página, &appwizard; rellenará algunos comentarios comunes de cabeceras, que para una aplicación basada en C++ pueden aparecer como:

    /***************************************************************************
     *   Copyright (C) 2003 by Su nombre                                       *
     *   usted@usted.com                                                           *
     *                                                                         *
     *   This program is free software; you can redistribute it and/or modify  *
     *   it under the terms of the GNU General Public License as published by  *
     *   the Free Software Foundation; either version 2 of the License, or     *
     *   (at your option) any later version.                                   *
     *                                                                         *
     *   This program is distributed in the hope that it will be useful,       *
     *   but WITHOUT ANY WARRANTY; without even the implied warranty of        *
     *   MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the         *
     *   GNU General Public License for more details.                          *
     *                                                                         *
     *   You should have received a copy of the GNU General Public License     *
     *   along with this program; if not, write to the                         *
     *   Free Software Foundation, Inc.,                                       *
     *   59 Temple Place - Suite 330, Boston, MA  02111-1307, USA.             *
     ***************************************************************************/

Otras plantillas proporcionarán información similar en un formato acorde a las definiciones del lenguaje de programación que desee utilizar.

Como habrá observado, el gestor de aplicaciones ha rellenado rápidamente la información que usted ha introducido en la primera página General del diálogo Crear nuevo proyecto, como el contenido de los campos Autor y Correo electrónico. También se ha insertado información sobre la licencia correcta que haya seleccionado en la pestaña Licencia.

#### Cómo editar las plantillas

Las plantillas que ha preparado en el diálogo Crear nuevo proyecto serán procesadas posteriormente cada vez que le ordene a &kdevelop; que cree un nuevo archivo de código fuente o de cabecera. La información que ha proporcionado aquí será incluida al comienzo de cada archivo como una cabecera de documentación, antes del inicio de las partes que contienen el código.

No está obligado a usar texto plano en ningún caso. &kdevelop; conoce el contenido de algunas variables que le permiten incluir información real en el archivo. El &appwizard; usa de hecho algunas de estas variables para insertar información sobre el Autor, su Correo electrónico y la Licencia en el texto inicial de la plantilla.

Incluir información &doxygen; en los archivos

  Si, por ejemplo, desea que &doxygen; genere documentación de su &API; para mostrar más información sobre el contenido de los archivos en su lista de nombres de archivos, debe incluir las siguientes líneas en la plantilla del archivo de código fuente:

      /**
       * \file $MODULE$.cpp
       * \brief (ponga aquí una descripción corta).
       **/

  Cada vez que cree un nuevo archivo de código fuente, &kdevelop; sustituirá la variable `$MODULE$` por nombre del cuerpo del archivo recién creado. Por ejemplo, si ha creado una nueva clase de C++ llamada `UnaSencillaPrueba`, verá las siguientes líneas en el archivo `unasencillaprueba.cpp`:

      /**
       * \file unasencillaprueba.cpp
       * \brief (ponga aquí una descripción corta).
       **/

  Todavía tendrá que proporcionar la descripción corta tras la palabra clave \brief, pero parte del trabajo será relizado por usted de forma automática.

El archivo con el texto de licencia

  Como otro ejemplo, puede incluir una referencia explícita al texto de licencia que desea utilizar en la plantilla. Use la variable `$LICENSEFILE$` para este propósito e incluya, por ejemplo, esta línea:

      //   Vea $LICENSEFILE$ para el texto completo de la licencia.

  El &appwizard; reemplazará la variable `$LICENSEFILE$` con el nombre del archivo donde se puede encontrar el texto completo de la licencia, como por ejemplo:

      //   Vea COPYING para el texto completo de la licencia.

  para la licencia GPL, o

      //   Vea LICENSE.BSD para el texto completo de la licencia.

  si desea poner su aplicación bajo la licencia BSD.

  Existen, por supuesto, más variables que &kdevelop; conoce. Vea la sección Edición de plantillas en el capítulo Herramientas de edición para ver una lista de las posibles variables que puede usar.

Las plantillas que ha definido aquí tendrán efecto únicamente después de que el &appwizard; haya creado el nuevo proyecto. Encontrará esta información al principio de los archivos que cree usted mismo durante el proceso de desarrollo. Al crear los archivos iniciales, el &appwizard; usará algunas plantillas estándar predefinidas. Deberá adaptar manualmente estos archivos iniciales según sus propias necesidades.

### Construir los archivos iniciales del proyecto

Casi todo está terminado en este momento. En la última página de plantillas, el botón Adelante > habrá cambiado ahora a Finalizar.

Piense dos veces antes de pulsarlo. Todavía tiene la oportunidad de revisar todo repetidamente usando el botón < Atrás. Como el &appwizard; recuerda toda la información que ha introducido, sería recomendable que se tomara algo de tiempo en revisar todo una vez más. En caso de que utilice un &CVS; local, no se olvide de comprobar el nombre del repositorio &CVS; (no debe de existir una subcarpeta con ese nombre en la carpeta raíz del &CVS;; y, si existe, pruebe con otro nombre de repositorio).

Si no desea generar el nuevo proyecto, cancele el diálogo Crear nuevo proyecto con el botón Cancelar. En caso contrario, pulse el botón Finalizar y observe en la ventana de Mensajes cómo inicia el proyecto el &appwizard;.

Si desea utilizar un sistema de versiones (&CVS;), se realizarán realmente dos procesos. Primero, el &appwizard; generará las carpetas del proyecto y sus archivos, y luego llamará al programa &CVS;, que reinicia la ventana Mensajes con su propia salida. Si ocurre un error en cualquiera de estos pasos, el proceso se detendrá mostrándole un mensaje de error adecuado en la ventana.

En muchos casos, cuando su nuevo proyecto haya sido generado de este modo, &kdevelop; cargará automáticamente uno o más archivos de código fuente de los módulos básicamente más importantes para que pueda comenzar a trabajar con ellos inmediatamente. No obstante, dependiendo de la plantilla inicialmente seleccionada en el &appwizard;, se mostrarán unos u otros módulos (o ninguno).

No olvide comprobar inicialmente todo lo que ha generado el &appwizard;. Por ejemplo, puede querer cambiar la información inicial de las cabeceras según sus propias plantillas. Normalmente las encontrará en una subcarpeta llamada `templates` dentro de la carpeta de su proyecto. Unas sencillas operaciones de copia de archivos bastarán para modificarlas.

Luego sería recomendable que compilara el proyecto inicial antes de comenzar a cambiar el código. En la mayor parte de los casos, será posible realizar esta compilación inicial. De este modo, podrá asegurarse de que el proyecto ha sido generado realmente de acuerdo con sus necesidades. Si no fue así, solo tiene que eliminar la carpeta del proyecto (también en la raíz de su &CVS; local, si está usando uno) y comenzar de nuevo.

Antes de compilar su nuevo proyecto por primera vez, eche un vistazo a Proyecto Configuración de construcción. Si existen tres secciones mostradas como: predeterminada, optimizada y depuración, estando seleccionada depuración, utilice esta opción, o use optimizada en su lugar.

Debido a algunas limitaciones en la configuración de autoconf y automake, no debería bajo ningún concepto construir su proyecto con la configuración predeterminada. Esto ocasionaría que se perdieran ciertas preferencias internas de carpetas, haciendo que el comando `configure` genere errores cuando intente usarlo más adelante con las configuraciones de construcción optimizada o depuración.

Esto se aplica solo a estas posibilidades de selección múltiple. Si el tipo de aplicación que ha seleccionado proporciona solo una configuración de construcción predeterminada, deberá, por supuesto, usar esta opción.

## Configuración de proyectos

(... pendiente de escribir ...)