Bernd
Pol

# Premiers pas — l'&appwizard;

Dans &kdevelop;, les travaux de développement logiciel sont organisés en projets. Un tel projet conserve ensemble tout ce qui appartient à une tâche de programmation complète : fichiers source, fichiers de données additionnels, toute fonction de gestion réellement nécessaire comme le système « make », ainsi que l'accès à tous les composants et tout outil supplémentaire requis pour mettre en service et pour exécuter l'application.

L'organisation de tous les travaux de développement en projets vous permet de passer facilement d'une tâche globale à l'autre à la main. Ceci est très pratique si &pex; vous travaillez sur plusieurs applications en même temps comme c'est souvent le cas. Donnez l'ordre à &kdevelop; d'ouvrir le projet sur lequel vous souhaitez travailler et vous pouvez continuer dans l'environnement à l'endroit précis où vous l'aviez laissé.

## Nouveaux projets

Chaque fois que vous voulez lancer un nouveau projet de programmation, un nombre non négligeable de procédures formelles de configuration doit être effectué. Une structure initiale de dossiers doit être mise en place, les en-têtes initiaux et les fichiers sources fournis, le système « make » initialisé, &etc;

&kdevelop; offre un moyen aisé de lancer un nouveau projet de programmation — l'&appwizard;. Vous trouverez l'&appwizard; dans l'élément de menu Projet Nouveau projet.

Une seule et courte série d'étapes suffit pour démarrer un nouveau projet de programmation à l'aide de l'&appwizard; :

1. Choisissez le langage de programmation que vous souhaitez utiliser et le type de l'application que vous voulez construire à partir d'un ensemble de modèles prédéfinis.

2. Indiquez des informations générales comme le nom de l'application, le dossier dans lequel l'application devra être construite, &etc;

3. Décidez si vous souhaitez utiliser un système de contrôle de versions, comme &pex; CVS, et fournissez les données nécessaires si besoin est.

4. Configurez quelques modèles pour les en-têtes initiaux et les fichiers sources (si applicable).

5. Pour finir, donnez l'ordre à l'&appwizard; de configurer des éléments initiaux, une structure de dossiers, des modèles d'en-têtes de démarrage et de fichiers source, ainsi que des outils de gestion comme &pex; un squelette « make » initial, &etc;

Voilà — c'est tout. L'&appwizard; a mis à votre disposition un premier ensemble fonctionnel de fichiers de programmation qui vous permet de commencer à travailler dans de bonnes conditions.

Examinons tout ceci en détail à présent ...

### Étapes initiales

Pour créer un nouveau projet dans &kdevelop;, sélectionnez Nouveau projet dans le menu Projet. La boîte de dialogue Créer un nouveau projet apparaît, affichant une page initiale Géneral :

Boîte de dialogue initiale pour configurer un nouveau projet

Comme vous le voyez, cette boîte de dialogue est divisée en une partie supérieure et une partie inférieure. Dans la partie supérieure, vous pouvez décider du langage de programmation et du type de l'application, alors que la partie inférieure contient des informations d'ordre général.

#### Choisissez le langage de programmation et le type de l'application

Le côté gauche de la partie supérieure de cette boîte de dialogue est l'endroit où vous effectuez le travail de sélection. Lorsqu'elle s'affiche, vous y trouvez une liste de dossiers dont chacun porte le nom d'un langage de programmation comme :

- Ada

- C

- C++

- Base de données (projets SQL)

- Fortran

- Haskell

- Java

- PHP

- Pascal

- Perl

- Python

- Ruby

- Shell (scripts pour le shell Bash)

Pour être précis, ces dossiers ne contiennent pas d'outils de programmation réels à proprement parler. En revanche, ils donnent accès à des modèles prédéfinis que vous pouvez employer comme point de départ pour développer dans ce langage. Pour avoir une idée de ce qui est prévu, il suffit d'ouvrir les dossiers l'un après l'autre. Ils contiennent une série de sous-dossiers sur certains, un ou plusieurs éléments simples seulement sur d'autres. Les sous-dossiers que vous voyez organisent les modèles disponibles en fonction de certaines tâches, les éléments simples nomment les modèles que vous pouvez sélectionner.

Nous ne pouvons pas préciser davantage ici quelles tâches chaque modèle prévoit, mais il est facile de le découvrir. Quand vous choisissez un élément de modèle, des informations s'affichent dans les champs de droite. Le champ inférieur contient une courte description de ce que le modèle est supposé faire. Dans le champ supérieur, une image illustre, si disponible, le résultat de l'application que ce modèle produit si vous le compilez et l'exécutez sans le modifier. Habituellement, c'est une capture d'écran de la fenêtre principale que l'application affiche.

Choisissez le modèle qui correspond le mieux aux objectifs de votre application comme point de départ. Saisissez ensuite les informations générales sur les propriétés dans le champ inférieur, comme expliqué dans le prochain chapitre.

##### Sélectionner un système de gestion de projet

Chaque modèle est lié à un système de gestion de projet spécifique. Il n'y a actuellement aucun moyen direct de choisir librement un tel système de gestion de projet. Il vous faut trouver un modèle qui convienne à vos besoins ou modifier votre projet en conséquence après création.

#### Fournir des informations générales

La partie inférieure de la boîte de dialogue Créer un nouveau projet de la page Général est un champ encadré intitulé Propriétés. Indiquez ici quelques informations d'ordre général sur votre projet de façon à ce que l'&appwizard; sache comment construire la structure initiale.

##### Nom de l'application

Votre application a bien entendu besoin d'un nom. Saisissez ce dernier dans le champ Propriétés supérieur, appelé Nom de l'application. Nous utiliserons MyApp à titre d'exemple.

Ce faisant, vous remarquez que l'&appwizard; refuse d'admettre des caractères spéciaux, quels qu'ils soient. Les seuls caractères admis sont :

- les caractères en majuscules et en minuscules

- les nombres

- le caractère de soulignement

Une cause notable de cette restriction est que l'&appwizard; utilise ce nom d'application comme base de certains noms de classes qu'il construit lors de la configuration d'un projet initial. Par conséquent, le nom de l'application doit coller aux règles du langage de programmation que vous employez.

##### Le dossier du projet

Vous pouvez voir l'autre cause notable de cette restriction sur la ligne inférieure de la zone Propriétés. Elle est intitulée Emplacement cible et affiche le dossier dans lequel l'&appwizard; crée l'application.

Lorsque vous saisissez le nom de l'application, vous remarquez que l'&appwizard; répète votre saisie à la fin de la ligne Emplacement cible, en utilisant uniquement des caractères en minuscules.

Par conséquent, vous devez choisir le nom de votre nouvelle application avec soin. Si vous vous retrouvez avec un dossier déjà utilisé, l'&appwizard; ne vous autorisera pas à passer à l'étape suivante et laissera le bouton Suivant > désactivé (grisé). De plus, il vous avertira dans ce cas en ajoutant ( le o«ssier / fichier existe déjà) » à la fin de la ligne Emplacement cible.

##### Le chemin de démarrage

Il y a deux manières de sélectionner un autre chemin pour votre nouvelle application. L'une consiste à choisir un autre nom. Néanmoins, ce n'est pas toujours faisable (vous pourriez &pex; installer une autre version d'une application déjà existante). À titre d'alternative, vous pouvez choisir un autre chemin vers le dossier de l'application.

Le champ de saisie de la deuxième ligne de Propriétés, dénommé Emplacement permet de le faire. Ce que vous saisissez correspond au chemin de démarrage du dossier de développement de la nouvelle application. L'&appwizard; ajoute lenom de l'application à ce chemin lorsqu'il initialise le nouveau projet. Le résultat est affiché sur la ligne Emplacement cible pour vous donner un meilleur contrôle sur ce qui se passe.

L'&appwizard; copie une valeur initiale dans le champ Emplacement au démarrage. Celle-ci provient de ce que vous avez choisi dans le champ Dossier des projets par défaut pendant les étapes générales de configuration. Dans notre cas, &kdevelop; est configuré pour utiliser `/home/devel/projets/` comme chemin initial pour les nouveaux projets.

Modifiez le contenu du champ Emplacement de façon à ce que le dossier de développement d'application affiché sur la ligne Emplacement cible soit unique.

Veillez à ce que le chemin que vous saisissez dans le champ Emplacement existe déjà. Sinon, vous ne serez pas en mesure de passer à l'étape suivante. L'&appwizard; vous avertira à propos des chemins non existants en ajoutant ( non va«lable) à la fin» de la ligne Emplacement cible.

Configurer un nouveau projet pour CVS

##### Informations personnelles

Les champs suivants ne sont pas aussi cruciaux. Saisissez simplement votre nom (&cad; le nom de la personne responsable de l'application) dans le champ Auteur ainsi qu'une adresse électronique valable dans le champ Adresse électronique de façon à ce que les utilisateurs puissent vous communiquer leurs réactions sur l'application.

1. L'&appwizard; remplit ces champs avec certaines valeurs par défaut, provenant des préréglages d'adresses électroniques du &centreConfiguration;. Si ces valeurs par défaut dans les champs Créer un nouveau projet, Auteur et Adresse électronique ne conviennent pas, jetez un coup d'œil à la configuration de votre courrier dans le &centreConfiguration;.

2. L'&appwizard; intégrera ces informations dans les modèles du programme de démarrage, si applicable. Dans les programmes C++ de &kde;, &pex;, vous les trouverez au début du fichier source `main.cpp`.

3. De tous les champs, Adresse électronique est optionnel, illustrant le fait que tous les développeurs ne peuvent pas avoir accès à l'internet. Vous pouvez laisser ce champ vide si vous le souhaitez et continuer néanmoins.

##### Infos de version et de licence

Saisissez pour finir un numéro de version de départ pour votre nouvelle application dans le champ Version, et choisissez la licence sous laquelle vous souhaitez que votre application soit placée dans l'onglet Licence.

Si vous sélectionnez un type d'application pour lequel l'&appwizard; fournit des modèles de textes sources courants (&pex;, C/C++), vous pouvez voir le texte de notification sur la troisième page de cette boîte de dialogue Créer un nouveau projet (reportez-vous au chapitre Fournir des modèles de sources et d'en-têtes).

Si vous avez sélectionné « Personnalisée » dans l'onglet Licence, prévoyez un texte de licence qui vous est propre.

Les informations de version et de licence seront également intégrées dans les modèles de départ dans un format approprié que fournit le type d'application que vous avez choisi.

Une fois que avez correctement saisi toutes ces informations, cliquez sur le bouton Suivant > pour continuer, comme décrit dans les chapitres suivants.

### Fournir des informations sur le système de versions

Dans une seconde étape, l'&appwizard; vous conduit à la page Système de contrôle des versions dans laquelle vous pouvez décider du système de contrôle de versions que vous souhaitez utiliser.

Cette description se concentre sur les besoins pour la seule création d'un projet. Pour plus d'informations sur &CVS;, reportez-vous au chapitre Utilisation de &CVS; ci-dessous.

#### Aucun système de contrôle de versions souhaité

Initialement, « Aucun » est sélectionné dans l'onglet Système de contrôle de versions : la page sera donc vide en principe. Si vous ne voulez pas utiliser de système de contrôle de versions, il suffit de cliquer sur le bouton Suivant > et de continuer.

#### Utilisation de &CVS;

Dans le cas contraire, sélectionnez à nouveau le système de contrôle de versions que vous souhaitez employer dans l'onglet Système de contrôle des versions. Pour notre exemple, il s'agit de « &CVS; ». Si vous choisissez ce dernier, l'&appwizard; réaffiche la page, montrant à présent une série de champs qu'il vous faut remplir.

Configurer un nouveau projet pour CVS

Un système de contrôle de versions tel que &CVS; (qui signifie C oncurr«ent Versions System », système de versions concurrentes) enregistre des copies des fichiers des projets sélectionnés dans une sorte de base de données. Si vous utilisez &CVS;, vous pouvez entre autres déposer sur le serveur (faire un « commit ») ces fichiers ou les importer dans le dossier de votre projet (faire un c heckou«t », ou les mettre à jour (faire un « update »). Notez en particulier que les fichiers contenus dans la base de données du système de versions sont enregistrés de manière structurée qui vous permet de toujours revenir à un état de développement antérieur si besoin est. En outre, &CVS; permet à un grand nombre de développeurs de collaborer assez facilement sur un gros projet (tel que &kdevelop;) sans perturber le travail de chacun d'eux.

#### Racine de &CVS;

&CVS; doit gérer la base de données du système de versions qu'il garde de vos fichiers de projets. Pour ce faire, il conserve certaines informations spéciales de la base de données dans un dossier propre, appelé &CVS; root. La première étape pour configurer &CVS; pour votre nouveau projet consiste donc à indiquer à &kdevelop; où se trouve cette racine.

Local &CVS; root. Il y a deux possibilités essentielles. Soit vous souhaitez utiliser une base de données &CVS; locale, soit une base de données hébergée sur un serveur distant. Si vous développez pour vous-même, vous pouvez être amené à employer la base de données &CVS; comme une sorte de système de sauvegarde sur votre propre ordinateur. Habituellement, celle-ci est installée à la racine de votre dossier personnel et porte le nom `cvsroot`. Voici à quoi elle ressemble :

``/home/devel/cvsroot`` (où `devel` désigne simplement l'utilisateur d évelop«pement , juste »à titre d'exemple)

En fait, il s'agit d'une forme abrégée. Pour être exact, la racine du &CVS; local devra être adressée à l'aide du préfixe `:local:`. La forme abrégée n'est autorisée que dans les cas où le nom de fichier commence par une barre oblique (`/`). Le nom complet dans notre exemple de racine du &CVS; local ressemblera exactement à : `:local:/home/devel/ cvsroot`

Saisissez le nom du dossier de la racine &CVS; pour lequel votre système a été configuré dans le champ Racine du référentiel CVS. En principe, vous pouvez choisir n'importe quel nom, voire utiliser de multiples bases de données &CVS;, mais il est préférable de coller à la racine du &CVS; dès lors qu'elle est configurée.

Initialiser une nouvelle racine &CVS;. S'il n'existe pas encore de racine &CVS;, &kdevelop; peut ordonner au système &CVS; d'en créer une à votre place dans le dossier donné. Cochez simplement la case Dossier racine pour l'initialisation sous le champ Racine du référentiel CVS.

Comme nous l'avons vu, &kdevelop; ne commande le système &CVS; que pour initialiser une nouvelle racine &CVS;. Il n'a aucune action par lui-même dans ce dossier. Heureusement, &CVS; est assez intelligent pour vérifier si le dossier racine du &CVS; existe déjà. Donc, il n'y a aucun risque si vous avez coché Dossier racine pour l'initialisation par inadvertance sur un dosser racine &CVS; déjà existant.

Racine du &CVS; distant. Parfois, il faut conserver la base de données du &CVS; sur un serveur distant, en particulier lorsque plusieurs développeurs travaillent sur le même projet. Saisissez alors l'URL racine du &CVS; de ce serveur dans le champ Racine du référentiel CVS. Par exemple, pour accéder au serveur &CVS; de &kde; :

``:pserver:monlogin@cvs.kde.org:/home/kde`` (où `monlogin` désigne le nom de connexion configuré dans votre compte &CVS; &kde;)

#### Types de serveurs &CVS; distants

Il y a essentiellement deux types de serveurs &CVS; distants largement répandus : le serveur pserver qui fonctionne selon un protocole non crypté avec mot de passe sécurisé, et le serveur ext qui fait intervenir un transfert de données cryptées rsh ou ssh. On les distingue par le préfixe d'&URL; qu'ils utilisent :

`:pserver:`

pour le s erveur« protégé par mot de passe », de type non crypté, et

`:ext:`

pour un type de serveur crypté rsh ou ssh. Par exemple

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

accède à la racine &CVS; de l'outil de gestion &CVS; Cervisia bien connu, sur le serveur de SourceForge.

Pour bénéficier d'un serveur crypté rsh ou ssh pour un accès &CVS;, indiquez à &kdevelop; le protocole de cryptage à utiliser. Il suffit de saisir `rsh` ou `ssh` dans le champ CVS_RSH de la page Système de contrôle des versions, Créer un nouveau projet.

Il y a une mise en garde si vous utilisez un serveur crypté pour &CVS; depuis &kdevelop;. Consultez le chapitre Utilisation de &CVS; pour les détails.

#### Le référentiel &CVS;

Jusqu'ici, vous avez indiqué à &kdevelop; où réside la racine &CVS; qui gère la base de données du sytème de versions et la manière d'y accéder. Indiquez-lui à présent sous quel nom vous souhaitez que &CVS; enregistre vos fichiers de projet dans cette base de données. L'endroit qui contiendra vos fichiers de projets dans &CVS; est appelé référentiel.

En principe, vous pouvez choisir n'importe quel nom pour le référentiel &CVS; de vos fichiers de projets, du moment qu'il adhère aux spécifications de nommage d'un fichier. Néanmoins, la plupart des développeurs utilisent simplement le nom de l'application elle-même. Comme &CVS; crée un dossier portant son nom dans la racine du &CVS;, vous le retrouverez plus facilement si vous lui laissez le nom de l'application.

Saisissez juste le nom du référentiel de votre choix dans le champ Référentiel CVS de la page Système de contrôle des versions, Créer un nouveau projet. Dans notre exemple, il s'agit de : `MonApp`

Veillez à ne pas employer un référentiel qui existe déjà ! Le système &CVS; ne signale rien à propos des fichiers en double, mais supprime en bloc tout ce qui ne produit pas un conflit formel. Vous bouleverserez tout !

#### Les champs restants

Il ne reste plus beaucoup de choses à faire. L'&appwizard; a déjà configuré les champs restants à votre place. Dans le détail :

Le champ Fournisseur n'est employé que pour des raisons de compatibilité. Vous pouvez coller au f ournis«seur par déf»aut que l'&appwizard; place ici.

Le champ Message vous permet de commenter le contenu initial de &CVS;. Placez-y le texte de votre choix ou contentez-vous de coller le n ouveau« projet » par défaut que l'&appwizard; a placé ici.

Le Marqueur pour la version de diffusion contient le nom qui marque l'état initial de votre projet. Ce type de marqueur désigne un certain stade au sein du référentiel &CVS;, grâce auquel vous pourrez accéder utérieurement à cet état de votre développement. (Vous trouverez d'autres détails dans le chapitre Utilisation de &CVS;.)

L'&appwizard; a placé un marqueur d émarre«r » par défaut ici, qui est une proposition intéressante. Contentez-vous d'y adhérer.

Si l'une quelconque de ces informations est erronée, &kdevelop; n'en saura d'ordinaire rien jusqu'au moment de la construction du projet. C'est le système &CVS; qui découvrira ces erreurs lorsqu'il essaiera de construire le référentiel. Vous devez donc garder un œil sur la fenêtre Messages de &kdevelop; quand le projet est créé, lors de l'étape finale de configuration. Si quoi que ce soit était erroné avec &CVS;, vous verriez, dans la plupart des cas, un message d'erreur comme celui-ci :

    * cd '/home/devel/test' && cvs -d '/home/devel/mycvsroot' \
      import -m 'new project' '' 'vendor' 'start' &&\
      sh /opt/kde3/share/apps/kdevcvs/buildcvs.sh . '' \
      '/home/devel/mycvsroot'
    * cvs [import aborted]: /home/devel/mycvsroot/CVSROOT: No such file or
      directory
    * *** Exited with status: 1 ***

Si ceci se produit, il faut soit configurer manuellement &CVS; (&kdevelop; devra avoir réussi à initialiser vos fichiers de projets à ce moment), soit supprimer le dossier du projet et redémarrer avec Nouveau projet dans le menu Projet.

Après avoir saisi toutes les informations relatives à &CVS;, cliquez sur le bouton Suivant > pour continuer.

Pour corriger une erreur sur la page Créer un nouveau projet précédente, il suffit de cliquer sur le bouton < Précédent. Comme l'&appwizard; mémorise vos réglages sur la page actuelle, vous pourrez aisément continuer lorsque vous reviendrez.

### Fournir des modèles d'en-têtes / de sources

La prochaine étape vous amène à une série de pages où vous pouvez configurer des informations courantes que vous souhaitez inclure dans vos fichiers sources et vos fichiers d'en-tête, si la tâche à la main le permet.

Les modèles d'en-têtes et de sources sont fournis pour les applications C et C++, chacun sur sa propre page. Pour d'autres langages, il ne peut y avoir que des modèles de sources. Et dans certains cas, vous trouverez même cette page de modèles vide.

Si la page est utilisée, l'&appwizard; remplit quelques commentaires d'en-têtes standard qui, pour une application basée sur du C++, pourrait ressembler à ceci :

    /***************************************************************************
     *   Copyright (C) 2003 by Votre Nom                                       *
     *   vous@vous.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.             *
     ***************************************************************************/

D'autres modèles fournissent des informations similaires dans un format approprié aux définitions du langage de programmation que vous souhaitez utiliser.

Comme vous l'avez sans doute remarqué, le gestionnaire d'applications a immédiatement saisi les informations que vous avez fournies sur la première page Général de la boîte de dialogue Créer un nouveau projet, notamment le contenu des champs Auteur et Adresse électronique. De plus, les informations de licence correctes ont été insérées en fonction de votre choix dans l'onglet Licence.

#### Comment modifier les modèles

Les modèles que vous avez configurés dans la boîte de dialogue Créer un nouveau projet seront traités ultérieurement chaque fois que vous ordonnez à &kdevelop; de configurer un nouveau source et/ou fichier d'en-tête. Les informations que vous avez fournies ici seront inclues au début sous la forme d'un en-tête de documentation, avant que les parties de code ne commencent.

Vous n'êtes pas limité au texte pur cependant. &kdevelop; connaît plusieurs variables qui vous permettent d'inclure des informations réelles dans le fichier. L'&appwizard; n'a en fait pas utilisé de telles variables pour insérer les informations d'Auteur, d'Adresse électronique et de Licence dans le texte du modèle initial.

Inclure des informations sur des fichiers &doxygen;

  Si, par exemple, vous souhaitez que la documentation de l'&API; construite par &doxygen; affiche des informations complémentaires sur le contenu du fichier dans sa liste de noms de fichiers, vous pouvez inclure les lignes suivantes dans le modèle de fichier source :

      /**
       * \file $MODULE$.cpp
       * \brief (placer une courte description ici).
       **/

  Chaque fois que vous créez un nouveau fichier source, &kdevelop; remplace la variable `$MODULE$` par le corps du nom du fichier récemment créé. Par exemple, si vous avez créé une nouvelle classe C++ nommée `UnSimpleTest`, vous verrez les lignes suivantes dans le fichier `unsimpletest.cpp` :

      /**
       * \file asimpletest.cpp
       * \brief (placer une courte description ici).
       **/

  Vous devrez encore ajouter la courte description après le mot-clé « \brief », mais une partie de ce travail est automatiquement effectuée à votre place.

Le fichier texte de la licence

  Comme autre exemple, vous pourriez inclure un conseil explicite au texte de la licence que vous souhaitez employer dans le modèle. Utilisez la variable `$LICENSEFILE$` pour ce faire et ajoutez par exemple cette ligne :

      //   Voir $LICENSEFILE$ pour le texte complet de la licence.

  L'&appwizard; remplace la variable `$LICENSEFILE$` par le nom du fichier dans lequel se trouve la licence complète, à savoir :

      //   Voir COPYING pour le texte complet de la licence.

  pour la licence GPL ou

      //   Voir LICENSE.BSD pour le texte complet de la licence.

  Si vous avez décidé de placer votre application sous l'égide de la licence BSD.

  &kdevelop; connaît bien sûr d'autres variables. Reportez-vous à la section Édition des modèles dans le chapitre Édition des outils pour savoir ce qui est possible.

Les modèles que vous définissez ici entreront en vigueur uniquement après que l'&appwizard; a créé le nouveau projet. Vous trouverez ces informations au début des fichiers que vous avez créés vous-même dans le processus de développement. Lors de la création des fichiers initiaux, l'&appwizard; utilise quelques modèles standard prédéfinis. Vous devrez adapter manuellement ces fichiers initiaux à vos besoins.

### Construire les fichiers initiaux du projet

Presque tout est fait à présent. Sur la dernière page des modèles, le bouton Suivant > aura changé pour désormais lire Terminer.

Réfléchissez bien avant de cliquer dessus ! Vous avez encore la possibilité de tout revoir en cliquant à plusieurs reprises sur le bouton < Précédent. Comme l'&appwizard; mémorise toutes les informations que vous avez saisies jusqu'ici, il est recommandé de prendre le temps de revenir en arrière encore une fois. Au cas où vous utilisez &CVS; en local, n'oubliez pas de cocher deux fois le nom du référentiel &CVS; (il ne devrait pas y avoir déjà de sous-dossier de ce nom dans le dossier racine de &CVS; — si tel est le cas, essayez un autre nom de référentiel).

Si jamais vous ne souhaitez pas que le nouveau projet soit construit, interrompez la boîte de dialogue Créer un nouveau projet par le bouton Annuler. Sinon, cliquez sur Terminer et surveillez dans la fenêtre Messages la manière dont l'&appwizard; lance le projet.

Pour utiliser un système de contrôle de versions (&CVS;), il y a deux exécutions en fait. L'&appwizard; construit d'abord les dossiers et les fichiers du projet, puis appelle le programme &CVS; qui redémarre la fenêtre Messages avec son propre contenu. Si une erreur quelconque se produit dans l'une de ces exécutions, le processus s'arrête, affichant un message d'erreur approprié dans la fenêtre.

Dans de nombreux cas, quand votre nouveau projet a été configuré de cette manière, &kdevelop; charge automatiquement le(s) fichier(s) source(s) d'un ou plusieurs modules importants de base, de façon à pouvoir commencer à travailler. (Les modules sources à afficher seront affichés —s'il y a lieu bien sûr — tout dépend du modèle initialement sélectionné dans l'&appwizard;.)

N'oubliez pas de vérifier d'abord ce que l'&appwizard; a fourni. Par exemple,vous pouvez être amené à changer les informations d'en-tête initiales en fonction de vos propres modèles. Vous les trouverez habituellement dans un sous-dossier `modèles`, dans votre dossier de projet. Quelques opérations de copies simples suffiront le plus souvent.

Il est ensuite conseillé de compiler le projet initial avant de tenter de changer du code. Dans la plupart des cas, cette compilation initiale devrait être possible. Par conséquent, vous pouvez rattraper si le projet a été réellement configuré en fonction de vos besoins. Dans le cas contraire, supprimez simplement le dossier du projet (dans votre racine &CVS; local également si vous en utilisez une) puis redémarrez.

Avant de compiler votre nouveau projet pour la première fois, jetez un coup d'œil à Projet Configuration de construction. S'il y a trois sélections affichées : par défaut, optimisée et débogage, avec débogage sélectionné, collez à celui-ci sans hésiter ou utilisez optimisée à la place.

En raison de certaines restrictions dans l'installation actuelle de autoconf/automake, vous ne devez en aucun cas compiler dans la configuration par défaut. Cette opération corromprait certains paramètres internes du dossier, amenant `configure` à réagir quand vous essaierez de l'utiliser dans la configuration de construction optimisée ou débogage par la suite.

(Ceci ne s'applique qu'à ces capacités de multisélection. Si le type d'application que vous avez choisi prévoit uniquement une configuration de construction par défaut, vous devrez bien sûr utiliser cette dernière.)

## Configurer des projets

(... à écrire ...)