R1.01 – PROG#13 – Exercice 2 : Découpage modulaire et compilation stricte

Objectif

Dans un projet logiciel professionnel (et dans le cadre de la SAÉ 1.01), tout le code ne doit jamais résider dans un unique fichier main.cpp. L’objectif de cet exercice est de segmenter votre projet du TP 10 sous Qt Creator (QMake) tout en garantissant une compilation sans aucun avertissement (warning).

Travail à effectuer

1. Configuration stricte du compilateur

  1. Ouvrez votre projet du TP 10 dans Qt Creator (ou créez un nouveau projet Application console C++ avec qmake en y copiant votre code fonctionnel du TP 10).
  2. Ouvrez le fichier de projet .pro et ajoutez la ligne suivante afin d’activer les vérifications strictes du compilateur C++ :
QMAKE_CXXFLAGS += -Wall -Wextra -pedantic
  1. Compilez votre projet (Ctrl + B) et corrigez tous les warnings éventuels (variables non utilisées, comparaisons entre int et unsigned / size_t, ordre d’initialisation, etc.).

2. Segmentation en fichiers d’en-tête (.h) et sources (.cpp)

Découpez votre code existant en créant les fichiers suivants dans votre projet Qt Creator (Clic droit sur le projet -> Ajouter nouveau -> C++ -> Fichier d’en-tête C++ / Fichier source C++) :

Fichier(s) Contenu à déplacer / créer
constantes.h Toutes les constantes du programme : codes couleurs VT100 (KReset, KRouge, KVert, KBleu, KMagenta…), symboles de la grille (kSymboleJoueur1, kSymboleArrivee, kMur, kEmpty…), touches par défaut (kToucheHautDefaut, kToucheBasDefaut, kToucheGaucheDefaut, kToucheDroiteDefaut), ainsi que la map<string, char> constante kConfigDefaut associant les touches et symboles par défaut. Aucun caractère ou nombre « magique » ne doit subsister dans les .cpp.
type.h Les définitions de types et structures de données (ligne, matrice2D, position).
affichage.h / affichage.cpp Les fonctions liées au terminal VT100 et au rendu (clearScreen, couleur, showmatrice2D).
jeu.h / jeu.cpp Les règles et mécaniques du jeu (initmat, moveToken, getch).
labyrinthe.h / labyrinthe.cpp La fonction de génération aléatoire de labyrinthe fournie au TP 10 (genererLabyrinthe, estValide).
main.cpp Uniquement la fonction ppal() (ou le menu de lancement) et main().

Dans constantes.h, déclarez notamment la configuration par défaut sous la forme :

const map<string, char> kConfigDefaut = {
    {"toucheHaut",     kToucheHautDefaut},
    {"toucheBas",      kToucheBasDefaut},
    {"toucheGauche",   kToucheGaucheDefaut},
    {"toucheDroite",   kToucheDroiteDefaut},
    {"symboleJoueur",  kSymboleJoueur1},
    {"symboleDrapeau", kSymboleArrivee}
};

Points de vigilance obligatoires

  • Protection contre les inclusions multiples : Chaque fichier .h doit impérativement être encadré par des directives de préprocesseur :
#ifndef CONSTANTES_H
#define CONSTANTES_H

// Vos déclarations et constantes ici

#endif // CONSTANTES_H
  • Vérifiez que le projet compile sans aucun warning et que le jeu fonctionne exactement comme à la fin du TP 10.