Manual Codeblocks FR
Manual Codeblocks FR
Manual Codeblocks FR
Manuel Utilisateur
Anders F. Björklund (afb), Biplab Kumar Modak (biplab), Bartomiej wiecki (byo), Paul
A. Jimenez (ceniza), Koa Chong Gee (cyberkoa), Daniel Orb (daniel2000), Lieven de Cock
(killerbot), Yiannis Mandravellos (mandrav), Mispunt (mispunt), Martin Halle (morten-
macfly), Jens Lody (jens), Jerome Antoine (dje), Damien Moore (dmoore), Pecan Heber
(pecan), Ricardo Garcia (rickg22), Thomas Denk (thomasdenk), tiwag (tiwag), stahta01
(stahta01), oBFusCATed (oBFusCATed), BlueHazzard (BlueHazzard)
Et bien d’autres contributeurs...
Manuel original en Anglais et en Allemand (V1.x) par Mario Cupelli (mariocup)
Traduction de la version originale anglaise et corrections/ajouts dans la version 2 par
Gérard Durand (gd on).
Il est permis de copier, distribuer et/ou modifier ce document dans le respect de la licence
”GNU Free Documentation”, Version 1.2 ou toute autre version postérieure publiée par
la ”Free Software Foundation”.
mis à jour en octobre 2020
Table des Matières
1 Gestion de Projet Code::Blocks 5
1.1 Vue du projet . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7
1.2 Notes pour les Projets . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7
1.3 Modèles de Projet . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7
1.4 Créer des Projets à partir de Cibles de Génération . . . . . . . . . . . . . . 8
1.5 Cibles Virtuelles . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8
1.6 Étapes Pré- et Post Génération . . . . . . . . . . . . . . . . . . . . . . . . 9
1.7 Ajouter des Scripts à des Cibles de Génération . . . . . . . . . . . . . . . . 9
1.8 Espace de travail et Dépendances de Projet . . . . . . . . . . . . . . . . . 10
1.9 Inclure des Fichiers en Assembleur . . . . . . . . . . . . . . . . . . . . . . 10
1.10 Éditeur et Outils . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11
1.10.1 Code par Défaut . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11
1.10.2 Abréviations . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11
1.10.3 Personnalités . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11
1.10.4 Fichiers de Configuration . . . . . . . . . . . . . . . . . . . . . . . . 12
1.10.5 Navigation et Recherche . . . . . . . . . . . . . . . . . . . . . . . . 13
1.10.6 Vue des Symboles . . . . . . . . . . . . . . . . . . . . . . . . . . . . 15
1.10.7 Inclure des Fichiers d’Aide Externes . . . . . . . . . . . . . . . . . . 17
1.10.8 Inclure des outils externes . . . . . . . . . . . . . . . . . . . . . . . 19
1.11 Astuces pour travailler avec Code::Blocks . . . . . . . . . . . . . . . . . . . 20
1.11.1 Recherche de Modifications . . . . . . . . . . . . . . . . . . . . . . 20
1.11.2 Échange de données avec d’autres applications . . . . . . . . . . . . 20
1.11.3 Configurer les variables d’environnement . . . . . . . . . . . . . . . 21
1.11.4 Basculer entre diverses dispositions . . . . . . . . . . . . . . . . . . 22
1.11.5 Basculer entre projets . . . . . . . . . . . . . . . . . . . . . . . . . 23
1.11.6 Configurations étendue des compilateurs . . . . . . . . . . . . . . . 23
1.11.7 Zoomer dans l’éditeur . . . . . . . . . . . . . . . . . . . . . . . . . 24
1.11.8 Mode de Repliement . . . . . . . . . . . . . . . . . . . . . . . . . . 24
1.11.9 Sélection de modes dans l’éditeur . . . . . . . . . . . . . . . . . . . 24
1.11.10 Repliement de code . . . . . . . . . . . . . . . . . . . . . . . . . . . 25
1.11.11 Auto complétion . . . . . . . . . . . . . . . . . . . . . . . . . . . . 26
1.11.12 Recherche de fichiers cassés . . . . . . . . . . . . . . . . . . . . . . 26
1.11.13 Inclure des librairies . . . . . . . . . . . . . . . . . . . . . . . . . . 26
1.11.14 Ordre d’édition de liens des fichiers objets . . . . . . . . . . . . . . 26
1.11.15 Sauvegarde automatique . . . . . . . . . . . . . . . . . . . . . . . . 27
1.11.16 Configuration des extensions de fichiers . . . . . . . . . . . . . . . . 27
1.12 Code::Blocks en ligne de commande . . . . . . . . . . . . . . . . . . . . . . 27
1.13 Raccourcis Clavier . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 28
1.13.1 Introduction . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 28
1.13.2 Fonctionnalités . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 29
1.13.3 Utilisation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 29
1.13.4 Éditeur . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 30
1.13.5 Fichiers . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 32
1.13.6 Vue . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 32
Code::Blocks V2.0.1 beta Table des Matières
1.13.7 Recherche . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 32
1.13.8 Générer . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 33
1.13.9 Debug . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 33
2 Extensions 34
2.1 Généralités . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 34
2.2 Astyle . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 35
2.3 AutoVersioning . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 36
2.3.1 Introduction . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 36
2.3.2 Fonctionnalités . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 36
2.3.3 Utilisation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 37
2.3.4 Onglets de la boı̂te de dialogue . . . . . . . . . . . . . . . . . . . . 37
2.3.5 Inclusion dans votre code . . . . . . . . . . . . . . . . . . . . . . . . 41
2.3.6 Générateur de journal des changements . . . . . . . . . . . . . . . . 42
2.4 Browse Tracker . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 44
2.5 CodeSnippets . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 45
2.6 Doxyblocks . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 48
2.7 Extension Editor Tweaks . . . . . . . . . . . . . . . . . . . . . . . . . . . . 50
2.8 Extensions FileManager et PowerShell . . . . . . . . . . . . . . . . . . . . 50
2.9 Éditeur Hexadécimal . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 54
2.10 Recherche Incrémentale . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 55
2.11 Extension NassiShneiderman . . . . . . . . . . . . . . . . . . . . . . . . . . 57
2.11.1 Création d’un diagramme . . . . . . . . . . . . . . . . . . . . . . . 57
2.11.2 Édition de structogrammes . . . . . . . . . . . . . . . . . . . . . . . 59
2.12 LibFinder . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 59
2.12.1 Recherche de librairies . . . . . . . . . . . . . . . . . . . . . . . . . 60
2.12.2 Inclure des librairies dans les projets . . . . . . . . . . . . . . . . . 62
2.12.3 Utilisation de LibFinder dans des projets générés par des assistants 63
2.13 Extension SpellChecker . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 63
2.13.1 Introduction . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 63
2.13.2 Configuration . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 63
2.13.3 Dictionnaires . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 64
2.13.4 Fichiers Thésaurus . . . . . . . . . . . . . . . . . . . . . . . . . . . 65
2.13.5 Bitmaps (Drapeaux) . . . . . . . . . . . . . . . . . . . . . . . . . . 65
2.13.6 Styles à vérifier . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 65
2.14 Exporter du code Source . . . . . . . . . . . . . . . . . . . . . . . . . . . . 66
2.15 Support de SVN . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 66
2.16 Liste des ”à faire” . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 67
2.17 Tools+ . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 68
2.17.1 Exemple d’Outils Tools+ . . . . . . . . . . . . . . . . . . . . . . . . 72
2.18 Thread Search . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 75
2.18.1 Fonctionnalités . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 75
2.18.2 Utilisation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 76
2.18.3 Configuration . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 76
2.18.4 Options . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 77
2.18.5 Options de Thread search (ou Tâche de Recherche) . . . . . . . . . 78
2.18.6 Mise en page . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 78
Code::Blocks 2
Code::Blocks V2.0.1 beta Table des Matières
3 Expansion de Variables 82
3.1 Syntaxe . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 82
3.2 Liste des variables internes . . . . . . . . . . . . . . . . . . . . . . . . . . . 83
3.2.1 Espace de travail Code::Blocks . . . . . . . . . . . . . . . . . . . . . 83
3.2.2 Fichiers et répertoires . . . . . . . . . . . . . . . . . . . . . . . . . . 83
3.2.3 Cibles de génération . . . . . . . . . . . . . . . . . . . . . . . . . . 84
3.2.4 Langue et encodage . . . . . . . . . . . . . . . . . . . . . . . . . . . 85
3.2.5 Heure et date . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 85
3.2.6 Dépendant de la Plateforme . . . . . . . . . . . . . . . . . . . . . . 85
3.2.7 Commandes du Système d’exploitation . . . . . . . . . . . . . . . . 85
3.2.8 Valeurs aléatoires . . . . . . . . . . . . . . . . . . . . . . . . . . . . 86
3.2.9 Chemins Standard . . . . . . . . . . . . . . . . . . . . . . . . . . . 86
3.2.10 Fonctions internes pour la conversion de chemins . . . . . . . . . . 86
3.2.11 Évaluation Conditionnelle . . . . . . . . . . . . . . . . . . . . . . . 87
3.3 Expansion de script . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 87
3.4 Macros Commandes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 88
3.5 Compilation d’un fichier unique . . . . . . . . . . . . . . . . . . . . . . . . 89
3.6 Édition de liens de fichiers objets en exécutable . . . . . . . . . . . . . . . 89
3.7 Variables globales du compilateur . . . . . . . . . . . . . . . . . . . . . . . 89
3.7.1 Synopsis . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 89
3.7.2 Noms et Membres . . . . . . . . . . . . . . . . . . . . . . . . . . . . 89
3.7.3 Contraintes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 90
3.7.4 Utilisation des Variables Globales du Compilateur . . . . . . . . . . 91
3.7.5 Ensembles de Variables . . . . . . . . . . . . . . . . . . . . . . . . . 91
3.7.6 Mini-Tutoriel de membres utilisateur . . . . . . . . . . . . . . . . . 92
Code::Blocks 3
Code::Blocks V2.0.1 beta Table des Matières
Code::Blocks 4
1 Gestion de Projet Code::Blocks
Les textes de plusieurs paragraphes (par exemple chapitre 3 à la page 82 ou chapitre 2 à la
page 34) sont les documentations officielles du site Wiki de Code::Blocks (éventuellement
revues et complétées) où elles ne sont disponibles qu’en anglais. Cette documentation est
une extension de la version originale 1.1, assemblée et/ou écrite par Mario Cupelli.
Note :
Remarque du traducteur : Les références aux menus sont traduites en
français. Cela suppose donc que vous avez installé la francisation de
l’interface de Code::Blocks que vous pouvez obtenir, notamment via le
forum, dans la rubrique CodeBlocks Translation. Ne plus utiliser celle
du site original LaunchPad bien trop ancienne et largement dépassée.
Utiliser plutôt une nouvelle version, aussi sur Launchpad, via https:
//launchpad.net/codeblocks-gd. Les images ci-dessous sont celles
de la documentation originale, en anglais
Gestion Cette fenêtre contient l’interface ’Projets’ qui dans le texte suivant sera référencée
comme vue du projet. Cette vue affiche tous les projets ouverts dans Code::Blocks
à un instant donné. L’onglet ’Symboles’ de la fenêtre Gestion affiche les symboles,
les variables etc.
Éditeur Dans l’illustration ci-dessus, un fichier source nommé hello.c est ouvert avec
colorisation de syntaxe dans l’éditeur.
Liste des fichiers ouverts affiche une liste de tous les fichiers ouverts dans l’éditeur, dans
cet exemple : hello.c.
CodeSnippets peut être affiché via le menu ’Vue’ →’ CodeSnippets’ . Ici vous pouvez
gérer des modules de texte, des liens vers des fichiers et des liens vers des urls.
Journaux & autres . Cette fenêtre est utilisée pour sortir des résultats de recherche, des
messages envoyés par un compilateur etc..
La barre d’état donne un aperçu des paramétrages suivants :
Chemin absolu d’un fichier ouvert dans l’éditeur.
L’éditeur utilise l’encodage par défaut de votre système d’exploitation. Cette con-
figuration sera affichée par défaut.
Numéros de ligne et de colonne de la position actuelle du curseur dans l’éditeur.
Le mode de configuration du clavier pour insérer du texte (Insertion ou Remplace-
ment).
État actuel du fichier. Un fichier modifié sera marqué comme Modie sinon cette
case reste vide.
Autorisation d’un fichier. Un fichier qui est en lecture seule sera affiché Lecture seule
dans la barre d’état. Dans la fenêtre ’Ouvrir la liste de fichiers’ ces fichiers seront
identifiés par une icône de verrouillage superposée.
Note :
Dans l’éditeur courant, l’utilisateur peut choisir les propriétés du
menu de contexte. Dans le dialogue apparaissant dans l’onglet
’Général’ , l’option ’Le fichier est en lecture seule’ peut être
sélectionnée. Cette option marquera le fichier correspondant comme
étant en lecture seule pour Code::Blocks, mais les attributs en lecture
et écriture du fichier original ne seront pas modifiés dans le système
de fichiers.
Si vous démarrez Code::Blocks en ligne de commande avec --personality=<profile>
la barre d’état affichera le profil utilisateur courant, sinon default sera affiché. Les
paramètres de Code::Blocks sont enregistrés dans le fichier de configuration corre-
spondant <personality>.conf.
Code::Blocks offre une gestion des projets très flexible et très compréhensible. Le texte
suivant ne montre que quelques aspects de la gestion de projets.
Code::Blocks 6
Code::Blocks V2.0.1 beta 1.1 Vue du projet
Note :
Si vous désactivez ’Arbre des projets’ →’Catégoriser par type de
fichiers’ dans le menu de contexte, l’affichage par catégories sera
masqué, et les fichiers seront listés comme ils sont stockés dans le
système de fichiers.
Code::Blocks 7
Code::Blocks V2.0.1 beta 1.4 Créer des Projets à partir de Cibles de Génération
sous Win 7 (ou un chemin équivalent du profil de l’utilisateur, adapté à chaque OS). Si les
modèles doivent pouvoir être ouverts par tous les utilisateurs, ils devront être copiés dans
un répertoire correspondant de l’installation de Code::Blocks. Ces modèles seront alors
affichés lors du démarrage suivant de Code::Blocks dans ’Nouveau’ →’Projet’ →’Modèles
utilisateur’ .
Note :
Les modèles disponibles dans l’assistant Projet peuvent être édités en
les sélectionnant via un clic droit.
Code::Blocks 8
Code::Blocks V2.0.1 beta 1.6 Étapes Pré- et Post Génération
seconde cible ’Release’ sans ces informations. En ajoutant Cibles Virtuelles via ’Projet’
→’Propriétés’ →’Cibles de génération’ on peut combiner des cibles de génération indi-
viduelles. Par exemple, une Cible Virtuelle ’All’ peut créer les cibles Debug et Release
simultanément. Les cibles virtuelles sont affichées dans la barre de symboles du compila-
teur dans Générer les cibles.
Un autre exemple de Post génération peut être l’archivage d’un projet. Pour cela, créez
une cible de génération ’Archive’ et incluez les instructions suivantes dans l’étape de post
génération :
z i p = j 9 $ (PROJECT NAME) $ (TODAY) . z i p s r c h o b j $ (PROJECT NAME) . cbp
Avec cette commande, le projet actif et ses sources, en-têtes et objets seront compressés
en tant que fichier zip. En faisant ainsi, les variables intégrées $(PROJECT_NAME) et
$(TODAY), le nom du projet et la date courante seront extraites (voir section 3.2 à la
page 83). Après l’exécution de la cible ’Archive’, le fichier compressé sera stocké dans le
répertoire du projet.
Dans le répertoire share/codeblocks/scripts vous trouverez quelques exemples de
scripts. Vous pouvez ajouter un script via le menu ’Paramètres’ →’Édition de scripts’
et l’enregistrer dans un menu. Si vous exécutez par exemple le script make dist depuis le
menu, alors tous les fichiers appartenant à un projet seront compressés dans une archive
<project>.tar.gz.
Note :
Un script peut également être inclus dans une Cible de Génération.
Code::Blocks 9
Code::Blocks V2.0.1 beta 1.8 Espace de travail et Dépendances de Projet
Les variables de Code::Blocks sont identifiées par un $ (voir section 3.4 à la page 88).
Elles sont automatiquement configurées, ainsi vous n’avez à remplacer que l’option de
l’assembleur <asopt> par vos propres configurations.
Code::Blocks 10
Code::Blocks V2.0.1 beta 1.10 Éditeur et Outils
1.10.2 Abréviations
Pas mal de frappes au clavier peuvent être économisées dans Code::Blocks en définissant
des abréviations. Ceci peut s’obtenir en sélectionnant ’Paramètres’ →’Éditeur’ et en
définissant les abréviations par un nom <name>, qui peut alors être appelé par un rac-
courci clavier Ctrl-J (voir Figure 1.3 à la page 12).
On peut également les paramétrer en incluant des variables $(NAME) dans les abréviations.
#i f n d e f $ ( Guard token )
#define $ ( Guard token )
#endif // $ ( Guard token )
Quand on utilise l’abréviation <name> dans un texte source et qu’on utilise Ctrl-J, le
contenu de la variable est récupéré puis inclus.
1.10.3 Personnalités
Les configurations de Code::Blocks sont enregistrées en tant que données d’application
dans un fichier dénommé <user>.conf dans le répertoire de codeblocks. Ce fichier de
configuration contient des informations telles que les derniers projets ouverts, le paramétrage
Code::Blocks 11
Code::Blocks V2.0.1 beta 1.10 Éditeur et Outils
de l’éditeur, l’affichage des barres de symboles etc. Par défaut, la personnalité ’default’ est
utilisée et sa configuration sauvegardée dans un fichier default.conf. Si Code::Blocks est
lancé en ligne de commande avec le paramètre --personality=myuser, le paramétrage
sera enregistré dans un fichier myuser.conf. Si le profil n’existe pas déjà, il sera au-
tomatiquement créé. Cette procédure rend possible la création de différents profils pour
différentes étapes de travail. Si vous lancez Code::Blocks en ligne de commande avec le
paramètre additionnel --personality=ask, une boı̂te de sélection sera affichée avec tous
les profils disponibles.
Note :
Le nom du profil/personnalité courant est affiché dans le coin à droite
de la barre d’état.
Code::Blocks 12
Code::Blocks V2.0.1 beta 1.10 Éditeur et Outils
Code::Blocks copiera les valeurs par défaut depuis ’Default User’ vers le répertoire ”Ap-
plication data” de l’utilisateur courant.
Pour créer une version portable de Code::Blocks sur clé USB, procédez comme suit. Copiez
le répertoire d’installation de Code::Blocks vers la clé USB et stockez le fichier de con-
figuration default.conf dans ce répertoire. Cette configuration servira de paramétrage
global. Faites attention au fait que ce fichier soit accessible en écriture, sinon les change-
ments de configuration ne pourront y être enregistrés.
Code::Blocks 13
Code::Blocks V2.0.1 beta 1.10 Éditeur et Outils
Alt-G et Ctrl-Alt-G sont d’autres fonctions utiles. Le dialogue qui s’ouvrira en utilisant
ces raccourcis vous permet de choisir des fichiers/fonctions et aller vous positionner à
l’implémentation de la fonction sélectionnée (voir Figure 1.6 à la page 14) ou bien ouvrir
le fichier sélectionné dans l’éditeur. Vous pouvez utiliser dans le dialogue des jokers comme
* ou ? etc. pour y obtenir une recherche incrémentale.
Note :
Avec le raccourci Ctrl-PgUp vous pouvez aller à la fonction
précédente, et via Ctrl-PgDn vous pouvez aller à la fonction suivante.
Dans l’éditeur, vous pouvez ouvrir un nouveau dialogue Ouvrir des fichiers Ctrl-Tab et
vous pouvez passer de l’un à l’autre via la liste affichée. Si vous appuyez sur la touche
Ctrl, alors un fichier peut être sélectionné de différentes façons :
1. Si vous sélectionnez une entrée avec le bouton gauche de la souris, le fichier sélectionné
sera ouvert.
2. Si vous appuyez sur la touche Tab vous passez de l’une à l’autre des entrées listées.
En relâchant la touche Ctrl le fichier sélectionné sera ouvert.
Code::Blocks 14
Code::Blocks V2.0.1 beta 1.10 Éditeur et Outils
3. Si vous déplacez la souris au-dessus des entrées listées, alors la sélection courante
sera surlignée. En relâchant la touche Ctrl le fichier sélectionné sera ouvert..
4. Si le pointeur de souris est en dehors de la sélection surlignée, vous pouvez utiliser
la molette de la souris pour basculer entre les entrées. En relâchant la touche Ctrl
le fichier sélectionné sera ouvert.
Une façon commune de développer du logiciel est de jongler avec un ensemble de fonctions
implémentées dans différents fichiers. L’extension ”Browse Tracker” vous aidera à résoudre
cette tâche en vous montrant dans quel ordre ont été sélectionnés les fichiers. Vous pouvez
alors naviguer aisément entre les appels de fonctions (voir section 2.4 à la page 44).
L’affichage des numéros de lignes dans Code::Blocks peut s’activer via ’Paramètres’ →’Éditeur’
→’Paramètres généraux’ à l’aide du champ ’Afficher les numéros de ligne’. Le raccourci
Ctrl-G ou la commande de menu ’Rechercher’ →’Aller à la ligne’ vous aidera à atteindre
la ligne désirée.
Note :
Si vous maintenez la touche Ctrl enfoncée en sélectionnant du texte
dans l’éditeur de Code::Blocks vous pouvez lancer une recherche In-
ternet, notamment avec Google, via le menu de contexte.
Note :
Entrer un terme à chercher ou des noms de symboles dans le masque
d’entrée ’Rechercher’ du navigateur de Symboles permet d’obtenir
une vue filtrée des symboles si concordance il y a.
Code::Blocks 15
Code::Blocks V2.0.1 beta 1.10 Éditeur et Outils
Les structures et classes sont affichées par le menu ’arbre du bas’ et l’ordre de tri peut être
modifié via le menu de contexte. Si une catégorie est sélectionnée à la souris, les symboles
trouvés seront affichés dans la partie basse de la fenêtre (voir Figure 1.7 à la page 16).
Double-cliquer sur un symbole ouvrira le fichier où il est défini ou bien la fonction où elle
est implémentée, puis on se positionnera sur la ligne correspondante. Un rafraı̂chissement
automatique du navigateur de symboles, sans avoir à sauvegarder de fichier, peut être
activé par le menu ’Paramètres’ →’Éditeur’ →’Code Complétion’ (voir Figure 1.8 à la
page 17). Les performances de Code::Blocks seront affectées dans les projets comportant
de nombreux symboles.
Code::Blocks 16
Code::Blocks V2.0.1 beta 1.10 Éditeur et Outils
Note :
Dans l’éditeur, une liste de classes peut être affichée via les menus de
contexte ’Insérer méthode de classe’ ou ’Toutes méthodes de classes
sans implémentation’ .
Code::Blocks 17
Code::Blocks V2.0.1 beta 1.10 Éditeur et Outils
man : / u s r / s h a r e /man
Sous Linux, les pages man sont habituellement installées de toute façon. Sous Windows
vous pourriez vouloir les télécharger, par ex. depuis ici : http://www.win.tue.nl/~aeb/
linux/man
Options d’Aide
Vous pouvez demander à Code::Blocks d’utiliser un fichier particulier comme fichier
d’aide par défaut, en cochant la case ”Ceci est le fichier d’aide par défaut”. Ainsi,
ce fichier sera affiché dès lors que vous appuierez sur la touche ’F1’. De plus, si
vous écrivez le mot $(keyword) en tant que mot clé par défaut (voir plus loin), on
cherchera ces mots clés dans ce fichier (le mot sélectionné ou le mot sous le curseur
du fichier source courant) et les correspondances seront affichées, si elles existent.
Vous pouvez demander à Code::Blocks d’ouvrir un fichier d’aide sur un sujet de
votre choix, en écrivant le mot clé correspondant dans la boı̂te de texte ”Valeur
du mot clé par défaut”. Si le fichier d’aide est celui par défaut et que vous utilisez
$(keyword) comme mot clé par défaut, l’éditeur utilisera le mot sous le curseur
(ou celui sélectionné) dans le fichier d’aide actuellement ouvert comme mot clé, en
ouvrant le fichier d’aide par défaut sur le sujet adéquat. Ceci ne sera toutefois vrai
que sur le fichier d’aide par défaut : on ne cherchera pas de cette façon dans les autres
fichiers d’aide. Par exemple, si vous avez une référence de langage comme fichier
d’aide par défaut et que vous ajoutez un fichier d’aide sur une librairie standard, vous
obtiendrez l’explication du mot clé du langage en appuyant sur la touche ’F1’, mais
vous n’aurez pas les fonctions de librairie expliquées de cette façon. Inversement, en
configurant le fichier de la librairie par défaut, via la touche F1 vous perdrez cette
fonctionnalité pour les mots clés de langage.
Si votre fichier d’aide est un fichier HTML, vous pouvez demander à Code::Blocks
Code::Blocks 18
Code::Blocks V2.0.1 beta 1.10 Éditeur et Outils
Note :
Si vous sélectionnez un fichier html par double-clic dans l’explorateur
(voir section 2.8 à la page 50) alors le visualiseur html intégré sera
démarré, du moins si aucune association vers les fichiers html n’est
faite par le gestionnaire d’extensions de fichiers.
Fichiers CHM
Vous pouvez trouver des fichiers d’aide c++ chm sur le web. Ajoutez-les tout simplement
dans la boı̂te de dialogue.
Sous Linux vous avez à installer un visualiseur de fichiers chm pour pouvoir afficher ces
fichiers chm. Il y en a plusieurs comme gnochm, kchmviewer, xchm et ainsi de suite.
Code::Blocks 19
Code::Blocks V2.0.1 beta 1.11 Astuces pour travailler avec Code::Blocks
doivent rester ouvertes après qu’on ait quitté Code::Blocks, l’option ’Lancer l’outil visible
en mode détaché’ doit être cochée.
Cette fonctionnalité peut être activée ou désactivée via la case à cocher ’Utiliser la barre
de changements’ dans le menu ’Paramètres’ →’Éditeur’ →’Marges et tirets’ .
Note :
Si un fichier modifié est fermé, alors l’historique des changements tels
que défaire/refaire ainsi que la barre de changements sont perdus. À
l’aide du menu ’Édition’ →’Effacer l’historique des changements’ ou
le menu de contexte correspondant vous pouvez effacer cet historique
même si le fichier reste ouvert.
Code::Blocks 20
Code::Blocks V2.0.1 beta 1.11 Astuces pour travailler avec Code::Blocks
[<command>(”<parameter>” ) ]
utilise un paramètre, dans notre cas c’est le nom d’un fichier avec
son chemin en absolu, et il s’ouvre dans une instance existante de
Code::Blocks ou bien, si nécessaire, une première instance démarre.
OpenLine Cette commande ouvre un fichier dans une instance de Code::Blocks
et se positionne sur la ligne dont le numéro est entré. Le numéro de
ligne est spécifié par : ligne .
[ OpenLine ( ”d : \ temp\ t e s t . t x t : 1 0 ” ) ]
Note :
La configuration d’une variable d’environnement pour chaque pro-
jet peut être sélectionnée dans le menu de contexte ’Propriétés’ de
l’onglet ’Options EnvVars’.
Code::Blocks 21
Code::Blocks V2.0.1 beta 1.11 Astuces pour travailler avec Code::Blocks
Exemple
Vous pouvez écrire dans un fichier <project>.env l’environnement utilisé dans une étape
de post génération (voir section 1.6 à la page 9) puis l’archiver dans votre projet.
cmd / c echo \%PATH\% > p r o j e c t . env
ou sous Linux
echo \$PATH > p r o j e c t . env
Code::Blocks 22
Code::Blocks V2.0.1 beta 1.11 Astuces pour travailler avec Code::Blocks
Note :
Autre exemple : éditer un fichier en mode plein écran sans barre de
symboles. Vous pouvez créer une disposition comme ’Plein Ecran’ et
lui assigner un raccourci spécifique.
Code::Blocks 23
Code::Blocks V2.0.1 beta 1.11 Astuces pour travailler avec Code::Blocks
Note :
Avec le raccourci Ctrl-Numepad-/ ou à l’aide du menu ’Édition’
→’Commandes spéciales’ →’Zoom’ →’Remise à 0’ vous restaurez
la taille originale du texte courant.
Code::Blocks 24
Code::Blocks V2.0.1 beta 1.11 Astuces pour travailler avec Code::Blocks
relâche la touche Alt cette sélection peut être copiée ou collée. Cette option est
utile si vous voulez sélectionner des colonnes, notamment dans un tableau et en
copier-coller le contenu.
3. Dans le menu ’Paramètres’ →’Éditeur’ →’Marges et tirets’ on peut activer ce
qu’on appelle des ’Espaces Virtuels’ . Ceci active la possibilité d’avoir une sélection
en mode bloc qui peut commencer ou se terminer par une ligne vide.
4. Dans le menu ’Paramètres’ →’Éditeur’ →’Marges et tirets’ on peut activer le
’Sélections Multiples’ . En maintenant enfoncée la touche Ctrl l’utilisateur peut
sélectionner diverses lignes dans l’éditeur actif avec le bouton gauche de la souris.
Les sélections sont ajoutées dans le presse-papier à l’aide des raccourcis Ctrl-C ou
Ctrl-X. Ctrl-V en insèrera le contenu à la position courante du curseur. Une option
complémentaire dénommée ’Active l’entrée clavier (et la suppression)’ peut être
activée pour les sélections multiples. Cette option est utile si vous voulez ajouter
des directives de pré-processeur comme #ifdef sur plusieurs lignes de code source
ou si vous voulez superposer ou remplacer du texte en plusieurs endroits.
Note :
La plupart des gestionnaires de fenêtres de Linux utilisent ALT-
ClicGauche-Déplacer pour déplacer une fenêtre, aussi vous devrez
désactiver cette fonctionnalité pour pouvoir sélectionner en mode
bloc.
Note :
Le style de repliement et la profondeur limite du repliement peuvent
se configurer dans le menu ’Paramètres’ →’Éditeur’ →’Repliement’ .
//{
code avec repliement défini par l’utilisateur
//}
Code::Blocks 25
Code::Blocks V2.0.1 beta 1.11 Astuces pour travailler avec Code::Blocks
Note :
Une autre façon d’inclure des librairies est documentée dans la sec-
tion 2.12 à la page 59.
Code::Blocks 26
Code::Blocks V2.0.1 beta 1.12 Code::Blocks en ligne de commande
de prédéfinir l’ordre dans lequel seront liés les fichiers objets. Vous pouvez obtenir cela
dans Code::Blocks en assignant des priorités. Dans le menu de contexte ’Propriétés’ , vous
pouvez définir les priorités d’un fichier dans l’onglet Générer. Une priorité faible fera que
le fichier sera lié plus tôt.
Note :
Si un programme utilisateur est associé à une certaine extension
de fichier, la configuration ’Désactiver Code::Blocks quand un pro-
gramme externe est lancé’ devrait être désactivée, sinon Code::Blocks
sera fermé dès qu’un fichier qui possède cette extension est ouvert.
Code::Blocks 27
Code::Blocks V2.0.1 beta 1.13 Raccourcis Clavier
/h, --help Affiche un message d’aide concernant les arguments en ligne de com-
mande.
/na, --no-check-associations
Ne faire aucun contrôle d’association de fichiers (Windows seulement).
/nd, --no-dde Ne pas lancer le serveur DDE (Windows seulement).
/ni, --no-ipc Ne pas lancer le serveur IPC (Linux et Mac seulement).
/ns, --no-splash-screen
Ne pas afficher l’écran de démarrage pendant le chargement de l’application.
/d, --debug-log
Afficher le journal de débogage de l’application.
--prefix=<str>
Configure le préfixe du répertoire de données partagées.
/p, --personality=<str>, --profile=<str>
Configure le profil (ou personnalité) à utiliser. Vous pouvez utiliser le
paramètre ask pour afficher la liste de tous les profils disponibles.
--rebuild Nettoie et génère le projet ou l’espace de travail.
--build Génère le projet ou l’espace de travail.
--target=<str>
Configure la cible de génération. Par exemple --target=’Release’.
--no-batch-window-close
Garde la fenêtre batch de journalisation visible après que la génération
par batch soit terminée.
--batch-build-notify
Affiche un message une fois que la génération batch est terminée.
--safe-mode Désactive toutes les extensions (plugins) au démarrage.
> <build log file>
Placé en toute dernière position d’une ligne de commande, ceci permet
à l’utilisateur de rediriger la sortie standard vers un fichier log. Ceci
n’est pas à proprement parler une option de codeblocks, mais seulement
une redirection standard des sorties des shells DOS/*nix.
1.13.1 Introduction
Ce plugin peut être utilisé pour ajouter un ou plusieurs raccourcis clavier aux menus.
Même si une IDE comme Code::Blocks est surtout pilotée à la souris, les raccourcis claviers
sont néanmoins un moyen très pratique pour accélérer et simplifier le travail. Les tableaux
ci-dessous regroupent quelques-uns des raccourcis claviers disponibles.
Code::Blocks 28
Code::Blocks V2.0.1 beta 1.13 Raccourcis Clavier
1.13.2 Fonctionnalités
Inclue un panneau de configuration et un système complet pour visualiser/supprimer/a-
jouter/éditer des commandes en raccourcis clavier.
Supporte plusieurs profils de raccourcis clavier et un système complet de chargement/en-
registrement est présent.
Permet à l’utilisateur de personnaliser toutes les commandes de menus désirées, et définir
des raccourcis clavier pour chacune des commandes.
1.13.3 Utilisation
La page de configuration du plugin est accessible via le menu ’Paramètres’ →’Éditeur’ ,
en sélectionnant la section Raccourcis Clavier.
Sélectionner une commande dans l’arborescence des Commandes, vous affiche le raccourci
actuel pour la commande sur la droite. Sur la figure c’est Open... qui est sélectionné et le
raccourci par défaut Ctrl-O est affiché.
Pour ajouter un nouveau raccourci à la commande sélectionnée, suivre les étapes suivantes
:
1. Placer le curseur dans la boı̂te de texte au-dessous du Nouveau raccourci et presser
sur les touches, par exemple F3 ou Ctrl-A.
2. Vérifier l’assignation courante, et si une autre commande a déjà ce raccourci affecté
vous verrez son nom ici. Si le texte dit Aucun c’est que c’est bon.
Code::Blocks 29
Code::Blocks V2.0.1 beta 1.13 Raccourcis Clavier
1.13.4 Éditeur
Fonction Raccourci clavier
Défaire la dernière action Ctrl+Z
Refaire la dernière action Ctrl+Shift+Z
Couper le texte sélectionné Ctrl+X
Copier le texte sélectionné Ctrl+C
Coller le texte Ctrl+V
Sélectionner tout le texte Ctrl+A
Permuter en-têtes / source F11
Commenter le code surligné Ctrl+Shift+C
Décommenter le code surligné Ctrl+Shift+X
Dupliquer la ligne où est le curseur Ctrl+D
Auto-complète / Abréviations Ctrl+Space/Ctrl+J
Afficher les astuces Ctrl+Shift+Space
Permuter la ligne où est le curseur avec celle au-dessus Ctrl+T
Bascule la marque Ctrl+B
Aller à la marque précédente Alt+PgUp
Aller à la marque suivante Alt+PgDown
Changer le repliement de bloc F12
Changer tous les repliements Shift+F12
Ceci est une liste des raccourcis fournis pas le composant éditeur de Code::Blocks. Ces
raccourcis ne peuvent pas être substitués.
Code::Blocks 30
Code::Blocks V2.0.1 beta 1.13 Raccourcis Clavier
Code::Blocks 31
Code::Blocks V2.0.1 beta 1.13 Raccourcis Clavier
1.13.5 Fichiers
Fonction Raccourci clavier
Nouveau fichier ou projet Ctrl+N
Ouvrir un fichier ou un projet existant Ctrl+O
Enregistrer le fichier courant Ctrl+S
Enregistrer tous les fichiers Ctrl+Shift+S
Fermer le fichier courant Ctrl+F4/Ctrl+W
Fermer tous les fichiers Ctrl+Shift+F4/Ctrl+Shift+W
Ceci est une liste des raccourcis fournis pas le composant éditeur de Code::Blocks. Ces
raccourcis ne peuvent pas être substitués.
Fonction Raccourci clavier
Activer le fichier ouvert suivant Ctrl+Tab
Activer le fichier ouvert précédent Ctrl+Shift+Tab
1.13.6 Vue
Fonction Raccourci clavier
Afficher / masquer le panneau de Messages F2
Afficher / masquer le panneau de Gestion Shift+F2
Déplacer le projet vers le haut (dans l’arborescence) Ctrl+Shift+Up
Déplacer le projet vers le bas (dans l’arborescence) Ctrl+Shift+Down
Activer le précédent (dans l’arbre des projets) Alt+F5
Activer le suivant (dans l’arbre des projets) Alt+F6
Zoomer / Dézoomer Ctrl+Roll Mouse Wheel
Focus editor CTRL+Alt+E
1.13.7 Recherche
Fonction Raccourci clavier
Rechercher Ctrl+F
Rechercher le suivant F3
Rechercher le précédent Shift+F3
Rechercher dans les fichiers Crtl+Shift+F
Remplacer Ctrl+R
Remplacer dans les fichiers Ctrl+Shift+R
Aller à la ligne Ctrl+G
Aller à la ligne changée suivante Ctrl+F3
Aller à la ligne changée précédente Ctrl+Shift+F3
Aller au fichier Alt+G
Aller à la fonction Ctrl+Alt+G
Aller à la fonction précédente Ctrl+PgUp
Aller à la fonction suivante Ctrl+PgDn
Aller à la déclaration Ctrl+Shift+.
Aller à l’implémentation Ctrl+.
Ouvrir le fichier inclus Ctrl+Alt+.
Code::Blocks 32
Code::Blocks V2.0.1 beta 1.13 Raccourcis Clavier
1.13.8 Générer
Fonction Raccourci clavier
Générer Ctrl+F9
Compiler le fichier courant Ctrl+Shift+F9
Exécuter Ctrl+F10
Générer et exécuter F9
Re-générer Ctrl+F11
1.13.9 Debug
Fonction Raccourci clavier
Débuguer F8
Continuer le débogage Ctrl+F7
Aller jusqu’au bloc de code suivant F7
Entrer dans le bloc de code Shift+F7
Aller jusqu’en sortie du bloc de code Ctrl+Shift+F7
Changer l’état du point d’arrêt F5
Exécuter jusqu’au curseur F4
Erreur précédente Alt+F1
Code::Blocks 33
2 Extensions
La plupart des extensions décrites dans ce chapitre le sont également dans le Wiki. Les
figures et les textes ont été copiés du Wiki mais adaptées pour être incluses dans des
documents Latex (Miktex 2.0).
2.1 Généralités
On peut étendre les fonctionnalités de Code::Blocks en utilisant des greffons (ou plugins,
terme que l’on gardera parfois par commodité ci-dessous). Il y a généralement trois types
de plugins :
Core plugins : extensions développées et maintenues par l’équipe de base de Code::Blocks.
Contrib plugins : extensions développées et maintenues par la communauté et recon-
nues comme étant appréciables. Elles sont donc intégrées dans le dépôt SVN de
Code::Blocks.
3rd party plugins : extensions développées et maintenues par la communauté mais pas
(encore?) dans le dépôt de Code::Blocks. Elles ont souvent leur propre dépôt ou ont
été postées (incluant le code source) dans les forums.
Si vous recherchez des plugins :
1. Regardez dans la distribution officielle. Notez que l’installateur / ”package manager”
peut vous demander d’activer spécifiquement certains des plugins. Donc LISEZ at-
tentivement.
2. Cherchez les annonces dans les forums, en particulier les forums de http://forums.
codeblocks.org/index.php/board,14.0.html.
3. Il peut y avoir des informations sur le Wiki concernant d’autres plugins dans ses
pages et ici : http://wiki.codeblocks.org/index.php/Announcement_for_plugins/
patches.
Pour les utilisateurs de Windows, le comportement par défaut de l’installateur est de
ne pas installer les ”contrib plugins”. Vous devez manuellement cocher la case ”contrib
plugin” quand on vous proposera une sélection des composants à installer. Il n’y a pas
franchement de moyen de les installer manuellement après coup.
Si vous développez des plugins : Bien sûr, vous pouvez travailler sur des plugins
comme bon vous semble, mais voici quelques suggestions:
Annoncez-les sur le ”plugin development board” dans les forums - en y incluant le code
source (initial).
OU
Créez votre propre page Web (ou utilisez une plate-forme de partage de fichiers) puis
postez le lien d’accès vers les sources/binaires/svn sur le ”plugin development board” dans
les forums.
Code::Blocks V2.0.1 beta 2.2 Astyle
OU
Créez un dépôt, par exemple sur BerliOS ou SourceForge, postez le lien d’accès vers
les sources/binaires/svn sur le ”plugin development board” dans les forums. Veuillez
noter : C’est la meilleure façon de faire car les fichiers attachés dans nos forums peuvent
être supprimés de temps en temps. Ce n’est donc pas très sûr de poster du code dans les
forums.
ENFIN
Entrez la description des plugins sur cette page.
Annoncez le plugin en utilisant le formulaire sur http://wiki.codeblocks.org/index.
php/Template_for_plugin_announcement
2.2 Astyle
Artistic Style est un indenteur de code source, un formateur de code source et un em-
bellisseur de code source pour les langages de programmation C, C++, C#. Il peut être
utilisé pour sélectionner différents styles de règles de codage dans les Code::Blocks.
Quand on indente un code source, nous en tant que programmeurs avons tendance à
utiliser à la fois des espaces et des caractères de tabulations pour créer l’indentation
souhaitée. De plus, certains éditeurs insèrent par défaut des espaces à la place des tab-
ulations quand on appuie sur la touche Tab, alors que d’autres éditeurs ont la faculté
de rendre d’embellir les lignes en ajoutant automatiquement des espaces en début de
lignes, éventuellement en remplaçant dans ce code les tabulations utilisées jusqu’alors
pour l’indentation par des espaces.
Code::Blocks 35
Code::Blocks V2.0.1 beta 2.3 AutoVersioning
Comme le nombre de caractères affichés sur l’écran pour chaque caractère de tabulation
change d’un éditeur à l’autre, un des problèmes courants auquel est confronté un pro-
grammeur qui passe d’un éditeur à un autre est qu’un code qui contient à la fois des
espaces et des tabulations et qui était jusqu’à présent bien indenté, devient soudain dif-
ficile à regarder après le changement d’éditeur. Même si en tant que programmeur vous
faites attention à n’utiliser QUE des espaces ou QUE des tabulations, récupérer un code
de quelqu’un d’autre peut malgré tout être problématique.
C’est pour résoudre ce problème qu’Artistic Style a été créé - un filtre écrit en C++ qui
ré-indente et reformate automatiquement les fichiers sources en C / C++ / C#.
Note :
Quand vous copiez du code, par exemple depuis Internet ou d’un
manuel, ce code sera automatiquement adapté aux règles de codage
dans Code::Blocks.
2.3 AutoVersioning
Une application de suivi de versions qui incrémente les numéros de version et de génération
de votre application à chaque fois qu’un changement est effectué et l’enregistre dans un
fichier version.h avec des déclarations de variables faciles à utiliser. Possède également
une option pour proposer des changements dans un style à la SVN, un éditeur de schémas
de versions, un générateur de journal des changements, et bien d’autres choses encore . . .
2.3.1 Introduction
L’idée de développer l’extension AutoVersioning est venue lors du développement d’un
logiciel en version pre-alpha qui exigeait des informations de version et d’état. Trop oc-
cupé par le codage, sans temps disponible pour maintenir la numérotation des versions,
l’auteur a décidé de développer une extension qui puisse faire le travail avec aussi peu
d’interventions que possible.
2.3.2 Fonctionnalités
Voici résumée la liste des fonctions couvertes par l’extension :
Supporte C et C++.
Génère et incrémente automatiquement des variables de versions.
Éditeur de l’état du logiciel.
Éditeur de schéma intégré pour changer le comportement de l’auto incrémentation
des valeurs de versions.
Déclaration des dates en mois, jour et année.
Style de version Ubuntu.
Contrôle des révisions Svn.
Code::Blocks 36
Code::Blocks V2.0.1 beta 2.3 AutoVersioning
2.3.3 Utilisation
Aller simplement dans le menu ’Projet’ →’Autoversioning’ . Une fenêtre popup comme
celle-ci apparaı̂tra :
Code::Blocks 37
Code::Blocks V2.0.1 beta 2.3 AutoVersioning
Code::Blocks 38
Code::Blocks V2.0.1 beta 2.3 AutoVersioning
Schéma
Vous permet d’éditer comment l’extension incrémentera les valeurs de version (voir Fig-
ure 2.5 à la page 39).
Valeur max pour numéro mineur Valeur maximale que peut atteindre la valeur mineure.
Une fois cette valeur atteinte, le numéro Majeur est incrémenté de 1 et à la compi-
lation suivante le numéro mineur sera remis à 0.
Nombre max de générations Quand cette valeur est atteinte, le compteur sera remis à
0 à la génération suivante. Mettre à 0 pour ne pas limiter.
Révision maximale Comme Nombre max de générations. Mettre à 0 pour ne pas limiter.
Révision aléatoire maximale Les révisions s’incrémentent par un nombre aléatoire que
vous décidez. Si vous mettez 1, les révisions s’incrémenteront évidemment par 1.
Nombre de générations avant d’incrémenter Mineur Après des changements de code
et des compilations avec succès, l’historique des générations s’incrémente, et quand
cette valeur est atteinte alors la valeur Mineure s’incrémente.
Paramètres
Ici vous pouvez entrer certains paramètres du comportement d’Autoversioning (voir Fig-
ure 2.6 à la page 40).
Auto-incrémente Majeur et Mineur Laisse l’extension incrémenter ces valeurs en util-
isant le schéma. Si non coché, seuls les numéros de génération et de Révision
s’incrémenteront.
Code::Blocks 39
Code::Blocks V2.0.1 beta 2.3 AutoVersioning
Créer des déclarations de dates Crée des entrées dans le fichier version.h avec des
dates et un style de version à la façon d’Ubuntu.
Incrémentation automatique Indique à l’extension d’incrémenter automatiquement dès
qu’une modification est faite. Cette incrémentation interviendra avant la compila-
tion.
Langage de l’en-tête Sélectionne le langage de sortie du fichier version.h
Interroger pour incrémenter Si Incrémentation automatique est coché, on vous inter-
roge alors avant la compilation (si des changements ont été effectués) pour incrémenter
les valeurs de version.
Svn activé Recherche dans le répertoire courant la révision Svn et la date puis génère les
entrées correspondantes dans version.h
Journal des changements
Ceci vous permet d’entrer chaque changement effectué au projet afin de générer un fichier
ChangesLog.txt (voir Figure 2.7 à la page 41).
Afficher les changements quand la version s’incrémente Affichera une fenêtre popup
d’édition de journal quand la version est incrémentée.
Format du Titre Un titre formaté avec une liste de valeurs prédéfinies.
Code::Blocks 40
Code::Blocks V2.0.1 beta 2.3 AutoVersioning
void main ( ) {
s t d : : cout<<AutoVersion : : Major<<e n d l ;
}
Sortie de version.h
Le fichier d’en-tête généré. Voici un exemple sur un fichier en mode c++ :
#i f n d e f VERSION H
#define VERSION H
namespace AutoVersion {
// Date V e r s i o n Types
static const char DATE [ ] = ” 15 ” ;
static const char MONTH[ ] = ” 09 ” ;
static const char YEAR [ ] = ” 2007 ” ;
static const double UBUNTU VERSION STYLE = 7 . 0 9 ;
// S o f t w a r e S t a t u s
s t a t i c const char STATUS [ ] = ” Pre=a l p h a ” ;
Code::Blocks 41
Code::Blocks V2.0.1 beta 2.3 AutoVersioning
// Standard V e r s i o n Type
s t a t i c const long MAJOR = 0 ;
s t a t i c const long MINOR = 1 0 ;
s t a t i c const long BUILD = 1 0 8 6 ;
s t a t i c const long REVISION = 6 3 4 9 ;
// M i s c e l l a n e o u s V e r s i o n Types
s t a t i c const long BUILDS COUNT = 1 9 8 4 ;
#d e f i n e RC FILEVERSION 0 , 1 0 , 1 0 8 6 , 6 3 4 9
#d e f i n e RC FILEVERSION STRING ” 0 , 1 0 , 1 0 8 6 , 6349\0 ”
s t a t i c const char FULLVERSION STRING [ ] = ” 0 . 1 0 . 1 0 8 6 . 6 3 4 9 ” ;
}
#endif //VERSION h
// Date V e r s i o n Types
static const char DATE [ ] = ” 15 ” ;
static const char MONTH[ ] = ” 09 ” ;
static const char YEAR [ ] = ” 2007 ” ;
static const double UBUNTU VERSION STYLE = 7 . 0 9 ;
// S o f t w a r e S t a t u s
s t a t i c const char STATUS [ ] = ” Pre=a l p h a ” ;
s t a t i c const char STATUS SHORT [ ] = ”pa” ;
// Standard V e r s i o n Type
s t a t i c const long MAJOR = 0 ;
s t a t i c const long MINOR = 1 0 ;
s t a t i c const long BUILD = 1 0 8 6 ;
s t a t i c const long REVISION = 6 3 4 9 ;
// M i s c e l l a n e o u s V e r s i o n Types
s t a t i c const long BUILDS COUNT = 1 9 8 4 ;
#d e f i n e RC FILEVERSION 0 , 1 0 , 1 0 8 6 , 6 3 4 9
#d e f i n e RC FILEVERSION STRING ” 0 , 1 0 , 1 0 8 6 , 6349\0 ”
s t a t i c const char FULLVERSION STRING [ ] = ” 0 . 1 0 . 1 0 8 6 . 6 3 4 9 ” ;
#endif //VERSION h
Code::Blocks 42
Code::Blocks V2.0.1 beta 2.3 AutoVersioning
est cochée, une fenêtre s’ouvrira pour vous permettre d’entrer la liste des changements
après une modification des sources du projet ou un évènement d’incrémentation (voir
Figure 2.8 à la page 43).
Change l o g :
= Fixed : p o i n t e r d e c l a r a t i o n
=Bug : b l a h b l a h
02 September 2007
r e l e a s e d v e r s i o n 0 . 7 . 3 2 o f AutoVersioning =Linux
Change l o g :
=Documented some a r e a s o f t h e code
Code::Blocks 43
Code::Blocks V2.0.1 beta 2.4 Browse Tracker
= R e o r g a n i z e d t h e code f o r r e a d a b i l i t y
01 September 2007
r e l e a s e d v e r s i o n 0 . 7 . 3 0 o f AutoVersioning =Linux
Change l o g :
= E di te d t h e change l o g window
= I f t h e change l o g windows i s l e a v e blank no c h a n g e s . t x t i s m o d i f i e d
Note :
NdT : certains menus ou affichages ne sont pas traduits car l’auteur de
l’extension n’a pas marqué certaines chaı̂nes comme étant traduisibles
Code::Blocks 44
Code::Blocks V2.0.1 beta 2.5 CodeSnippets
Mark Style (Styles des marques) Les marques de navigation sont affichées par défaut
comme des . . . dans la marge. Avec le choix ’Book Marks’ elles seront affichées
en tant que marque par une flèche bleue dans la marge. L’option ”hide” supprime
l’affichage des marques.
Toggle Browse Mark key Les marques peuvent être activées ou supprimées soit par un
simple clic avec le bouton gauche de la souris soit avec un clic-gauche tout en
maintenant la touche Ctrl enfoncée.
Toggle Delay Durée pendant laquelle le bouton gauche de la souris est enfoncé pour
entrer dans le mode de marquage de navigation.
Clear All BrowseMarks (Effacer toutes les marques) tout en maintenant enfoncée la
touche Ctrl soit par simple clic soit par double-clic sur le bouton gauche de la
souris.
La configuration de l’extension est enregistrée dans votre répertoire application data dans
le fichier default.conf. Si vous utilisez la fonctionnalité des profils (ou personnalité) de
Code::Blocks la configuration est alors lue dans votre fichier <personality>.conf.
2.5 CodeSnippets
L’extension CodeSnippets permet de structurer des modules de texte et des liens vers des
fichiers en fonction de catégories dans une vue arborescente. Les modules sont utilisés
pour stocker des fichiers fréquemment utilisés, des constructions de modules de texte, le
tout géré depuis un endroit centralisé. Imaginez la situation suivante : Un certain nombre
de fichiers source fréquemment utilisés sont stockés dans divers répertoires du système de
fichiers. La fenêtre de CodeSnippets vous donne l’opportunité de créer des catégories et,
à l’intérieur de ces catégories, des liens vers les fichiers requis. Avec cette fonctionnalité,
vous pouvez contrôler l’accès aux fichiers indépendamment de l’endroit où ils sont stockés
dans le système de fichiers, et vous pouvez rapidement naviguer entre ces fichiers sans
avoir besoin de les chercher un peu partout dans le système.
Note :
Vous pouvez utiliser les variables Code::Blocks ou les vari-
ables d’environnement dans les liens vers les fichiers comme
$(VARNAME)/name.pdf pour paramétrer un lien dans le navigateur
de CodeSnippets.
La liste des modules de texte et des liens peut être enregistrée dans la fenêtre des
CodeSnippets en cliquant sur le bouton droit de la souris et en sélectionnant ’Enregistrer
l’index’ depuis le menu de contexte. Le fichier codesnippets.xml qui est alors créé par
cette procédure, se trouve dans le sous-répertoire codeblocks du répertoire Documents
and Settings\Application data. Sous Linux, cette information est enregistrée dans le
sous-répertoire .codeblocks de votre répertoire HOME. Les fichiers de configuration de
Code::Blocks seront chargés au démarrage suivant. Si vous souhaitez enregistrer le con-
tenu des CodeSnippets à un autre endroit, sélectionnez l’entrée ’Enregistrer l’index sous’.
Code::Blocks 45
Code::Blocks V2.0.1 beta 2.5 CodeSnippets
Pour charger ce fichier, sélectionnez ’Charger le fichier d’index’ lors du démarrage suivant
de Code::Blocks ou incluez le répertoire dans les ’Paramètres’ du menu de contexte de
’Répertoire des Snippets’. Les paramétrages sont enregistrés dans le fichier correspondant
codesnippets.ini dans votre application data.
Pour inclure une catégorie, utilisez le menu ’Ajouter une sous-catégorie’. Une catégorie
peut contenir des Snippets (modules de texte) ou des Liens vers un fichier. Un module
de texte est créé via la commande ’Ajouter un Snippet’ depuis le menu de contexte. Le
contenu est intégré dans le module de texte comme un ’Nouveau snippet’ en sélectionnant
un passage de texte dans l’éditeur de Code::Blocks et en le glissant-déposant sur le module
dont les propriétés s’affichent. En double-cliquant sur la nouvelle entrée ou en sélectionnant
’Éditer le Texte’ on en éditera le contenu.
La sortie d’un module de texte est gérée dans Code::Blocks via la commande ’Appliquer’
du menu de contexte ou en faisant un glisser-déposer dans l’éditeur. Sous Windows, le
contenu d’un Snippet peut également être glissé-déposé dans d’autres applications. Dans
le navigateur de CodeSnippets vous pouvez copier une sélection par glisser-déposer vers
une catégorie différente.
De plus, les modules de texte peuvent être paramétrés par des variables <name> qui
peuvent être accédées via $(name) (voir Figure 2.9 à la page 46). Les valeurs des variables
peuvent être récupérées dans un champ d’entrée si le module de texte est appelé via la
commande du menu de contexte ’Appliquer’.
À côté des modules de texte, des liens vers des fichiers peuvent aussi être créés. Si, après
avoir créé un module de texte, vous cliquez sur la commande ’Propriétés’ du menu de
contexte, vous pouvez alors sélectionner une cible de type lien en cliquant sur le bouton
’Lien cible’. Cette procédure convertira automatiquement le module de texte en un lien
vers un fichier. Dans CodeSnippets, tous les modules de texte sont marqués par un symbole
T, les liens vers un fichier par un symbole F et les urls par un symbole U. Si vous
voulez ouvrir un fichier sélectionné (lien) dans la vue des codesnippets, sélectionnez tout
simplement le menu de contexte ’Ouvrir le fichier’ ou tout en maintenant enfoncée la
touche ’Alt’ effectuez un double-clic sur le fichier.
Note :
Vous pouvez même ajouter une url (comme
http://www.codeblocks.org) dans les modules de texte. L’url
peut être ouverte en utilisant le menu de contexte ’Ouvrir l’Url’ ou
en utilisant un glisser-déposer vers votre navigateur favori.
Code::Blocks 46
Code::Blocks V2.0.1 beta 2.5 CodeSnippets
Avec un tel paramétrage, si vous ouvrez un lien vers un fichier pdf depuis la vue des
codesnippets, un visualiseur de fichiers pdf sera automatiquement démarré. Cette méthode
rend possible à l’utilisateur l’accès à des fichiers répartis un peu partout sur le réseau,
comme des données, mises en forme, documentations etc., à l’aide des applications com-
munes, simplement par le biais d’un lien. Le contenu des codesnippets est enregistré dans le
fichier codesnippets.xml, la configuration est enregistrée dans le fichier codesnippets.ini
de votre répertoire application data. Ce fichier ini contiendra, par exemple, le chemin
du fichier codesnippets.xml.
Code::Blocks supporte l’utilisation de différents profils. Ces profils sont aussi nommés
personnalités. En démarrant, avec l’option --personality=<profile>, Code::Blocks en
ligne de commande vous créez ou utilisez un profil existant. Dans ce cas, le paramétrage ne
sera pas enregistré dans le fichier default.conf, mais plutôt dans un <personality>.conf
de votre répertoire application data. L’extension Codesnippets enregistrera alors ses
paramètres dans un fichier <personality>.codesnippets.ini. Maintenant, si vous
chargez un nouveau contenu <name.xml> dans les paramètres de codesnippets via ’Charger
un fichier d’index’, ce contenu sera enregistré dans le fichier ini correspondant. L’avantage
de cette méthode tient dans le fait que dans le cas où il y a différents profils, on peut
gérer plusieurs configurations de modules de textes et de liens.
L’extension offre une fonction de recherche complémentaire pour naviguer dans les catégories
et les Snippets. La façon de rechercher dans les Snippets, catégories ou Snippets et
catégories peut s’ajuster. En entrant l’expression de recherche requise, l’entrée correspon-
dante est automatiquement sélectionnée dans la vue. La Figure 2.10 à la page 47 affiche
Code::Blocks 47
Code::Blocks V2.0.1 beta 2.6 Doxyblocks
Note :
Quand on utilise des modules de texte volumineux, le contenu de ces
modules devrait être enregistré sous forme de fichiers via ’Convertir en
lien vers fichier’ de façon à réduire l’utilisation mémoire du système. Si
vous supprimez un codesnippet ou un lien vers un fichier, il est en fait
déplacé vers la corbeille (ou un répertoire .trash); si vous maintenez
la touche Maj enfoncée, cet élément sera réellement détruit.
2.6 Doxyblocks
DoxyBlocks est une extension pour Code::Blocks qui intègre doxygen dans l’IDE. Il vous
permet de créer de la documentation, insérer des blocs de commentaires et de lancer des
documents HTML ou CHM. Il fournit également la configuration de quelques-uns des
paramètres les plus communément utilisés at un accès à doxywizard pour obtenir une
configuration plus détaillée.
Les paramètres de la barre d’outils de DoxyBlocks ont la signification suivante :
Code::Blocks 48
Code::Blocks V2.0.1 beta 2.6 Doxyblocks
Code::Blocks 49
Code::Blocks V2.0.1 beta 2.7 Extension Editor Tweaks
se traduira par :
int var = 1;
int longVarName = 2 ;
int f o o b a r = 3;
Code::Blocks 50
Code::Blocks V2.0.1 beta 2.8 Extensions FileManager et PowerShell
Code::Blocks 51
Code::Blocks V2.0.1 beta 2.8 Extensions FileManager et PowerShell
Note :
Les fichiers/répertoires sélectionnés dans l’explorateur de fichiers peu-
vent être accédés dans l’extension PowerShell à l’aide de la variable
mpaths.
Celle-ci et toutes les commandes suivantes créeront un sous-menu, dans ce cas ’Extensions’
→’SVN’ →’Ajouter’ . Le menu de contexte est étendu de même. Cliquez sur la commande
du menu de contexte pour faire exécuter la commande SVN add sur les fichiers/répertoires
sélectionnés.
TortoiseSVN est un programme SVN très répandu qui s’intègre dans l’explorateur. Le
programme TortoiseProc.exe de TortoiseSVN peut être démarré en ligne de commande
et affiche une boı̂te de dialogue pour y entrer les données de l’utilisateur. Ainsi vous pouvez
lancer des commandes, disponibles en tant que menus de contexte dans l’explorateur,
également en ligne de commande. Vous pouvez donc l’intégrer en tant qu’extension du
Shell dans Code::Blocks. Par exemple, la commande
Code::Blocks 52
Code::Blocks V2.0.1 beta 2.8 Extensions FileManager et PowerShell
Note :
Pour les fichiers qui sont sous le contrôle de SVN l’explorateur de
fichier affiche des icônes superposées qui s’activent via le menu ’Vue’
→’SVN Decorators’ .
Exemple
Vous pouvez utiliser l’explorateur de fichiers pour afficher les différences sur des fichiers
ou des répertoires. Suivez les étapes suivantes :
1. Ajoutez le nom via le menu ’Paramètres’ →’Environnement’ →’PowerShell’ . C’est
affiché comme une entrée par l’interpréteur de menu et le menu de contexte.
2. Sélectionnez le chemin absolu de l’exécutable Diff (notamment kdiff3). Le pro-
gramme est accédé avec la variable $interpreter .
3. Ajoutez les paramètres de l’interpréteur
D i f f ; $ i n t e r p r e t e r $ mpaths ; ; ;
Cette commande sera exécutée en utilisant les fichiers ou répertoires sélectionnés en tant
que paramètres. La sélection peut être accédée via la variable $mpaths. Ceci est une façon
commode de différentier des fichiers ou des répertoires.
Code::Blocks 53
Code::Blocks V2.0.1 beta 2.9 Éditeur Hexadécimal
Note :
L’extension supporte l’utilisation des variables de Code::Blocks dans
l’extension du Shell.
$interpreter Appelle cet exécutable.
$fname Nom du fichier sans son extension.
$fext Extension du fichier sélectionné.
$file Nom du fichier.
$relfile Nom du fichier sans l’information de chemin.
$dir Nom du répertoire sélectionné.
$reldir Nom du répertoire sans l’information de chemin.
$path Chemin absolu.
$relpath Chemin relatif du fichier ou du répertoire
$mpaths Liste des fichiers et répertoires sélectionnés actuellement
$inputstr{<msg>} Chaı̂ne de caractères qui est entrée dans une fenêtre de message.
$parentdir Répertoire Parent (../).
Note :
Les entrées de l’extension Shell sont également disponibles en tant
que menus de contexte dans l’éditeur de Code::Blocks.
Code::Blocks 54
Code::Blocks V2.0.1 beta 2.10 Recherche Incrémentale
Bouton Aller à : Sauter à une position absolue. Format décimal ou hexadécimal. Saut
relatif vers l’avant ou vers l’arrière en spécifiant le signe.
Chercher: Recherchez des motifs hexadécimaux dans la vue HexEditor ou des chaı̂nes de
caractères dans la vue d’aperçu de fichier.
Configuration du nombre de colonnes : Exactement, Multiple de, Puissance de
Mode d’affichage : Hexa, Binaire
Octets : Sélectionnez le nombre d’octets à afficher par colonne.
Choix d’Endianess : BE: Big Endian LE: Little Endian
Valeur Prévisualisée : Ajoute une vue supplémentaire dans HexEditor. Pour une valeur
sélectionnée dans HexEditor, la valeur est également affichée sous forme de Word, Dword,
Float, Double.
Entrée d’expression : Permet d’effectuer une opération arithmétique sur une valeur dans
HexEditor. Le résultat de l’opération est affiché dans la marge de droite.
Calc: Testeur d’Expression
Édition d’un fichier dans HexEditor :
Commandes d’historique Annuler (Undo) et Refaire (Redo).
Autre exemple, Déplacer le curseur dans la vue des chaı̂nes de caractères : Insérer des
espaces avec la touche Insérer. Supprimer des caractères en appuyant sur la touche Suppr.
En saisissant un texte, le contenu existant est écrasé sous la forme d’une chaı̂ne de car-
actères.
En saisissant des chiffres dans la vue d’HexEditor, les valeurs sont écrasées et l’aperçu est
mis à jour.
Code::Blocks 55
Code::Blocks V2.0.1 beta 2.10 Recherche Incrémentale
Si la chaı̂ne de caractère recherchée ne peut pas être trouvée dans le fichier courant, afin
d’indiquer que c’est ce qui se passe, le fond du masque de recherche est affiché en rouge.
Code::Blocks 56
Code::Blocks V2.0.1 beta 2.11 Extension NassiShneiderman
En cliquant sur ce bouton ce sont toutes les occurrences de la chaı̂ne recherchée qui
sont surlignées en couleur, pas seulement la première.
Activer cette option réduit le champ de recherche au passage de texte marqué dans
l’éditeur.
Cette option signifie que la recherche sera sensible à la casse (respect des majuscules
et minuscules).
Note :
Le paramétrage standard de cette barre d’outil peut être configuré
dans ’Paramètres’ →’Éditeur’ →’Recherche Incrémentale’ .
Code::Blocks 57
Code::Blocks V2.0.1 beta 2.11 Extension NassiShneiderman
Code::Blocks 58
Code::Blocks V2.0.1 beta 2.12 LibFinder
2.11.2.2 Extensions
2.12 LibFinder
Si vous voulez utilisez des librairies dans votre application, vous devez configurer votre
projet pour cela. Un tel processus de configuration peut être difficile et ennuyeux car
chaque librairie peut utiliser un schéma d’options particulier. Un autre problème est que
cette configuration diffère entre les plates-formes ce qui résulte en des incompatibilités
entre des projets Unix et Windows.
LibFinder propose deux fonctionnalités majeures :
Recherche des librairies installées sur votre système
Code::Blocks 59
Code::Blocks V2.0.1 beta 2.12 LibFinder
Inclure les librairies dans votre projet en seulement quelques clics en rendant le
projet indépendant de la plate-forme
Quand LibFinder est à la recherche de librairies, il utilise des règles spéciales pour détecter
leur présence. Chaque ensemble de règle est situé dans un fichier xml. Actuellement
LibFinder peut rechercher wxWidgets 2.6/2.8, Code::Blocks SDK et GLFW – la liste
sera étendue dans le futur.
Note :
Pour obtenir davantage de détails sur comment ajouter un support
de librairie dans LibFinder, lisez dans les sources de Code::Blocks
src/plugins/contrib/lib finder/lib finder/readme.txt.
Après avoir terminé l’analyse, LibFinder affiche les résultats (voir Figure 2.17 à la page 61).
Dans la liste, vous cochez les librairies qui doivent être enregistrées dans la base de données
de LibFinder. Notez que chaque librairie peut avoir plus d’une configuration valide et les
Code::Blocks 60
Code::Blocks V2.0.1 beta 2.12 LibFinder
paramétrages ajoutés en premier sont plutôt destinés à être utilisés lors de la génération
de projets.
Au-dessous de la liste, vous pouvez sélectionner ce qu’il faut faire avec les résultats des
analyses précédentes :
Ne pas effacer les résultats précédents Cette option travaille comme une mise à jour
des résultats existants – Cela ajoute les nouveaux et met à jour ceux qui existent
déjà. Cette option n’est pas recommandée.
Seconde option (Effacer les résultats précédents des librairies sélectionnées) effacera
tous les résultats des recherches précédentes des librairies sélectionnées avant d’ajouter
les nouveaux résultats. C’est l’option recommandée.
Effacer toutes les configurations précédentes des librairies quand vous sélectionnez cette
option, la base de données de LibFinder sera effacée avant d’y ajouter les nouveaux
résultats. C’est utile quand vous voulez nettoyer une base de données LibFinder
contenant des résultats invalides.
Une autre option de ce dialogue est ’Configurer les Variables Globales’ . Quand vous
cochez cette option, LibFinder essaiera de configurer des Variables Globales qui sont
Code::Blocks 61
Code::Blocks V2.0.1 beta 2.12 LibFinder
Vous pouvez filtrer les librairies connues de LibFinder en fournissant un filtre de recherche.
La case à cocher ’Afficher comme un arbre’ permet de basculer antre des vues sans
catégories et des vues avec catégories.
Si vous voulez ajouter une librairie qui n’est pas disponible dans la base de données de
LibFinder, vous pouvez utiliser le champ ’Librairie inconnue’ . Notez que vous devriez
entrer le ”library’s shortcode” (nom court, qui habituellement correspond au nom de
variable globale) ou le nom de librairie dans pkg-config. Vous trouverez une liste de noms
courts suggérés dans le Wiki de Code::Blocks dans Global Variables. L’usage de cette
option n’est recommandé que lorsqu’on prépare un projet qui doit être généré sur d’autres
machines où ce type de librairie existe et y est correctement détectée par LibFinder. Vous
pouvez accéder à une variable globale dans Code::Blocks comme :
Code::Blocks 62
Code::Blocks V2.0.1 beta 2.13 Extension SpellChecker
2.13.1 Introduction
Une extension pour vérifier l’orthographe de chaı̂nes de caractères et de commentaires.
L’orthographe est vérifiée au cours de la frappe. De plus un thésaurus est fourni. Les deux
peuvent être accédés sur demande en sélectionnant le mot en question, puis choisir entre
le correcteur... ou le Thesaurus... depuis le menu d’Édition (l’opération peut être affectée
à une touche d’accès rapide via le plugin Raccourcis Clavier). Le menu de contexte (clic
droit sur le mot) permet d’accéder aux suggestions d’orthographe.
2.13.2 Configuration
La configuration est dans le menu ’Paramêtres’ →’Éditeur’ . L’option ”spell check” est à
peu près à mi-chemin vers le bas de la liste de gauche.
La signification des différents contrôles est la suivante :
Activer spell checker en-ligne Active ou désactive spell checker.
Langue La langue utilisée pour la vérification orthographique et le thésaurus est sélectionnée
en choisissant un dictionnaire. On peut aussi le changer dans la barre d’état.
Configuration des chemins, Dictionnaires Le plugin cherche les fichiers dictionnaires
via ce chemin.
Code::Blocks 63
Code::Blocks V2.0.1 beta 2.13 Extension SpellChecker
Configuration des chemins, Thésaurus Le plugin cherche les fichiers thésaurus via ce
chemin.
Configuration des chemins, Bitmaps (Optionnel) Le plugin cherche, via ce chemin, les
drapeaux à afficher dans la barre d’état.
Note :
Vous pouvez utiliser des Macros dans les trois con-
figurations de chemins, comme par ex. $(CODE-
BLOCKS)/share/codeblocks/SpellChecker. Voir Expansion de
Variables pour plus de détails. Ceci est pratique si vous utilisez une
version portable de Code::Blocks.
2.13.3 Dictionnaires
SpellChecker utilise une librairie nommée hunspell. Hunspell est le correcteur orthographique
de OpenOffice.org, Mozilla Firefox et d’autres projets. Les dictionnaires disponibles pour
ces applications sont compatibles avec ce plugin.
Open Office fourni toute une collection de dictionnaires pour plusieurs langues et dialectes
à télécharger. Les extensions de OOo 3.x (*.oxt) sont des archives compressés qui peuvent
être ouvertes avec votre logiciel d’archives préféré (par exemple 7-Zip ou File Roller).
Copiez le fichier .aff et le fichier .dic dans le répertoire configuré dans ’Configuration des
chemins, Dictionnaires’ (voir ci-dessus).
Si vous êtes sous Linux vous avez sans doute déjà des dictionnaires compatibles d’installés.
Code::Blocks 64
Code::Blocks V2.0.1 beta 2.13 Extension SpellChecker
Code::Blocks 65
Code::Blocks V2.0.1 beta 2.14 Exporter du code Source
Pour ajouter des styles, regardez le nom du langage de programmation et les indices
dans le fichier correspondant lexer *.xml puis ajoutez cette information au fichier Online-
SpellChecking.xml.
Par exemple, pour vérifier l’orthographe dans des scripts de commande bash (fichiers
*.sh), ajoutez la ligne :
<Language name="Bash"index="2,5,6"/>
Le support du système de contrôle de version SVN est inclus dans l’extension Code::Blocks
TortoiseSVN. Via le menu ’TortoiseSVN’ →’Plugin settings’ vous pouvez configurer les
commandes svn accessibles dans l’onglet ’Integration’ .
Menu intégration Ajoute une entrée TortoiseSVN dans la barre de menu avec différents
paramétrages.
Project manager Active les commandes TortoiseSVN du menu de contexte de la gestion
de projet.
Code::Blocks 66
Code::Blocks V2.0.1 beta 2.16 Liste des ”à faire”
Note :
L’Explorateur de fichiers dans Code::Blocks utilise différentes icônes
superposées afin d’indiquer l’état de svn. Les commandes de Tortois-
eSVN sont incluses dans le menu de contexte.
Note :
La liste des ”à faire” peut être ajoutée à la console de messages.
Sélectionnez l’option ’Inclure la liste des ”A faire” dans le panneau
de messages’ à l’aide du menu ’Paramètres’ →’Environnement’ .
Si les fichiers sources sont ouverts dans Code::Blocks, un ”à faire” peut être ajouté à la liste
via la commande ’Ajouter un élément ”à faire”’ du menu de contexte. Un commentaire
est ajouté dans le code sur la ligne sélectionnée.
// TODO ( u s e r #1#): a j o u t e r un nouveau d i a l o g u e pour l a p r o c h a i n e r e l e a s e
Quand on ajoute un ”à faire”, une boı̂te de dialogue apparaı̂t où les paramétrages suivants
peuvent être faits (voir Figure 2.21 à la page 68).
Code::Blocks 67
Code::Blocks V2.0.1 beta 2.17 Tools+
Utilisateur Nom de l’utilisateur <user> pour le système d’exploitation. Les tâches pour
d’autres utilisateurs peuvent également être créées ici. Pour cela, le nom de l’utilisateur
correspondant doit être créé par Ajouter un nouvel utilisateur. L’assignation d’un
”à faire” est alors faite via une sélection d’entrées pour cet utilisateur.
Note :
Notez que les Utilisateurs ici n’ont rien à voir avec les profils (ou
personnalités) utilisés dans Code::Blocks.
2.17 Tools+
Créer un nouvel outil est assez facile, et cela peut s’effectuer en quelques étapes simples.
D’abord ouvrir ’Tools(+)’ →’Configurer les outils...’ pour accéder au dialogue des Outils
définis par l’utilisateur.
Code::Blocks 68
Code::Blocks V2.0.1 beta 2.17 Tools+
Nom de l’outil
C’est le nom qui sera affiché dans le menu déroulant de Tools(+). Il sera aussi affiché
comme nom d’onglet pour les Tools+ redirigés vers la fenêtre Outils.
Ligne de Commande
Toute ligne de commande valide, fonction et paramètres, peut être entrée ici. La substi-
tution de variable est également acceptée. La liste suivante contient les variables les plus
utiles (voir section 3.2 à la page 83 pour la liste complète).
$relfile, $file Respectivement, le nom relatif et absolu d’un fichier sélectionné.
$reldir, $dir Respectivement, le nom relatif et absolu d’un répertoire sélectionné.
$relpath, $path Le nom relatif et absolu d’un fichier ou répertoire sélectionné.
$mpaths Une liste de fichiers ou de répertoires sélectionnés (seulement des chemins
en absolu).
$fname, $fext Le nom sans extension et l’extension sans le nom d’un fichier sélectionné.
$inputstr{prompt}
Demande à l’utilisateur d’entrer une chaı̂ne de texte qui sera substituée
dans la ligne de commande.
$if(condition){true clause}{false clause}
Résolution en false clause si la condition est vide, 0, ou fausse; sinon
true clause .
Types de fichiers
Les expressions avec un caractère joker (*) séparées par des points virgules vont restrein-
dre le choix par le sous-menu clic droit sur un fichier, répertoire, chemin multiple dans
l’arborescence des projets, de l’explorateur de fichiers, ou du panneau d’éditeur à un/des
Code::Blocks 69
Code::Blocks V2.0.1 beta 2.17 Tools+
type/s spécifiés. Laisser vide pour traiter tous les types de fichiers/répertoires.
Répertoire de Travail
Le répertoire sur lequel exécuter la commande. Les variables de Code::Blocks, les variables
de projet, et les variables globales sont disponibles. De même,
1. Si $dir est entré dans la ligne de commande, alors $dir peut aussi être utilisé ici.
2. $parentdir est disponible pour $relle , $le , $reldir , $dir , $relpath, $path, $fname,
$fext , pour l’évaluation du chemin absolu d’un répertoire contenant cet élément.
Chemin du Menu Outils
Contrôle l’emplacement de la commande dans le menu de Tools(+), donnant la possibilité
d’ajouter des sous-menus (les niveaux multiples sont autorisés).
Submenu/Tool1
Submenu/Tool2
Tool3
Va créer cette structure.
Le nom de la commande sera utilisé si cette entrée est vide. Si le premier caractère est un
point, la commande sera cachée.
Chemin du Menu de Contexte
Ceci contrôle l’emplacement de la commande dans le menu clic-droit des Projets et des
onglets de fichiers du panneau de Gestion. Les mêmes règles que pour la structure des
menu de Tools+ s’appliquent ici.
Code::Blocks 70
Code::Blocks V2.0.1 beta 2.17 Tools+
Notez SVP que la commande n’apparaı̂tra dans les menus de contexte que si la ligne de
commande contient un ou plusieurs des éléments suivants : $relle , $le , $reldir , $dir ,
$relpath, $path, $fname, et $fext .
Sortie vers
Ceci détermine vers où la sortie de la commande sera redirigée. Le but et la fonction de
la commande détermineront ce qui est le mieux à faire. Tools Output Window
Les outils qui ne requièrent que des résultats de sortie en ligne de commande (et ne
demandent pas d’entrées) utilisent généralement cette façon de faire. Le programme sera
lancé en mode invisible et toutes les sorties seront redirigées vers l’onglet approprié de
la fenêtre de sortie des Outils Tools+. Le texte [DONE/TERMINÉ] sera ajouté en fin
d’exécution de l’Outil.
Code::Blocks 71
Code::Blocks V2.0.1 beta 2.17 Tools+
Note :
Si la fenêtre de sortie des Outils Tools+ est ouverte à la clôture de
Code::Blocks, il se peut que Code::Blocks plante.
Console de Code::Blocks
Ceci va permettre de lancer le programme via l’exécutable cb console runner (ce même
programme qui est lancé après Générer et exécuter). Généralement, c’est utilisé par les
outils en ligne de commande pour obtenir des interactions utilisateur avancées, bien que
des programmes graphiques puissent aussi être utilisés (notamment si le programme n’est
pas stable ou s’il affiche des messages dans la sortie standard). Le ”Console runner” mettra
la fenêtre en pause (l’empêchant de se fermer), affichera le temps d’exécution, ainsi que
le code de sortie quand le programme s’arrêtera.
Shell Standard
C’est la même chose que de placer cette commande dans un script batch ou un script
Shell puis de l’exécuter. Le programme s’exécutera quelle que soit la méthode par défaut,
et lorsqu’il aura terminé, sa fenêtre se fermera.. Ce paramètre est utile pour exécuter un
programme (par exemple un fichier ou un navigateur Web) qui doit rester ouvert après la
fermeture de Code::Blocks.
Note :
Comme le plugin Tools+ plugin est en cours de développement,
quelques fonctionnalités - par exemple Priorité de Menu et Variables
d’environnement - peuvent ne pas être disponibles.
Code::Blocks 72
Code::Blocks V2.0.1 beta 2.17 Tools+
– Menu de Contexte
explorer /select,"$path"
Dolphin
– Menu Outils Tools+
dolphin --select "$(PROJECTFILE)"
– Menu de Contexte
dolphin --select "$path"
Note :
Les trois commandes suivantes du menu contextuel ne prennent en
charge que les dossiers (mais pas les fichiers).
Nautilus
– Menu Outils Tools+
nautilus --no-desktop --browser "$(PROJECTDIR)"
– Menu de Contexte
nautilus --no-desktop --browser "$dir"
Thunar
– Menu Outils Tools+
thunar "$(PROJECTDIR)"
– Menu de Contexte
thunar "$dir"
PCMan File Manager
– Menu Outils Tools+
pcmanfm "$(PROJECTDIR)"
– Menu de Contexte
pcmanfm "$dir"
Mise à jour d’un répertoire Subversion
Windows
– Menus Outils Tools+
"path_to_svn\bin\svn" update "$inputstr{Directory}"
– Menu de Contexte
Code::Blocks 73
Code::Blocks V2.0.1 beta 2.17 Tools+
Windows
– Menus Outil Tools+
"path_to_cbp2make\cbp2make" -in "$(PROJECTFILE)"
Linux
– Menus Outil Tools+
"path_to_cbp2make/cbp2make" -in "$(PROJECTFILE)"
Compresser le projet actif dans une archive
Windows
– 7z ou zip - Menus Outil Tools+ (sur 1 seule ligne)
"path_to_7z\7z" a -t$if(zip == $inputstr{7z or zip?}){zip -mm=Deflate
-mmt=on -mx9 -mfb=128 -mpass=10}{7z -m0=LZMA -mx9
-md=64m -mfb=64 -ms=on} -sccUTF-8 "-w$(PROJECTDIR).."
"$(PROJECTDIR)..\$(PROJECT_NAME)" "$(PROJECTDIR)*"
– tar.gz ou tar.bz2 - Menus Outil Tools+ (sur 1 seule ligne)
cmd /c ""path_to_7z\7z" a -ttar -mx0 -sccUTF-8 "-w$(PROJECTDIR).."
"$(PROJECTDIR)..\$(PROJECT_NAME)" "$(PROJECTDIR)*" &&
"path_to_7z\7z" a -t$if(gz == $inputstr{gz or bz2?}){gzip -mx9
-mfb=128 -mpass=10 -sccUTF-8 "-w$(PROJECTDIR).."
"$(PROJECTDIR)..\$(PROJECT_NAME).tar.gz}{bzip2 -mmt=on -mx9
-md=900k -mpass=7 -sccUTF-8 "-w$(PROJECTDIR).."
"$(PROJECTDIR)..\$(PROJECT_NAME).tar.bz2}"
"$(PROJECTDIR)..\$(PROJECT_NAME).tar" &&
cmd /c del "$(PROJECTDIR)..\$(PROJECT_NAME).tar""
Code::Blocks 74
Code::Blocks V2.0.1 beta 2.18 Thread Search
Note :
L’interpréteur en ligne de commande de Windows a été invoqué di-
rectement ici (cmd /c), ce qui permet à des commandes multiples de
s’enchaı̂ner en une seule ligne. Cependant, cela peut provoquer un
échec de l’exécution de la commande dans la console Code::Blocks.
Linux
– 7z ou zip - Menu Outils Tools+ (sur 1 seule ligne)
7z a -t$if(zip == $inputstr{7z or zip?}){zip -mm=Deflate -mmt=on -mx9
-mfb=128 -mpass=10}{7z -m0=LZMA -mx9 -md=64m -mfb=64 -ms=on}
-sccUTF-8 "-w$(PROJECTDIR).." "$(PROJECTDIR)../$(PROJECT_NAME)"
"$(PROJECTDIR)*"
– tar.gz ou tar.bz2 - Menu Outils Tools+ (sur 1 seule ligne)
tar -cf "$(PROJECTDIR)../$(PROJECT_NAME).tar.$if(gz == $inputstr{gz
ou bz2?}){gz" -I ’gzip}{bz2" -I ’bzip2} -9’ "$(PROJECTDIR)*"
Note :
L’étendue des extensions de fichiers à inclure dans la recherche est
préconfiguré et peut avoir besoin d’être ajusté.
2.18.1 Fonctionnalités
L’extension ThreadSearch offre les fonctionnalités suivantes :
’Recherche dans les fichiers’ multi tâches (Multi-threaded).
Éditeur interne en lecture seule pour voir les résultats
Fichier ouvert dans l’éditeur de type notebook
Menu contextuel ’Rechercher les occurrences’ pour commencer une recherche dans
les fichiers à partir du mot situé sous le curseur
Code::Blocks 75
Code::Blocks V2.0.1 beta 2.18 Thread Search
2.18.2 Utilisation
1. Configurez vos préférences de recherche (voir Figure 2.27 à la page 77)
Une fois l’extension installée, il y a 4 façons de conduire une recherche :
a) Tapez/Sélectionnez un mot dans la boı̂te de recherche combinée et appuyez
sur Entrée ou cliquez sur Rechercher dans le panneau de Thread search de la
console de messages.
b) Tapez/Sélectionnez un mot dans la boı̂te de recherche combinée de la barre
d’outil et appuyez sur Entrée ou cliquez sur le bouton Rechercher.
c) Clic droit sur n’importe quel ’mot’ dans l’éditeur actif puis cliquez sur ’Rechercher
les occurrences’.
d) Cliquez sur Rechercher/Thread search pour trouver le mot courant dans l’éditeur
actif.
Note :
Les points 1, 2 et 3 peuvent ne pas être disponibles en fonction de la
configuration courante.
2. Cliquez de nouveau sur le bouton de recherche pour arrêter la recherche en cours.
3. Un clic simple sur un élément résultat l’affiche dans la prévisualisation sur la droite.
4. Un double-clic sur un élément résultat ouvre ou configure un éditeur sur la droite.
2.18.3 Configuration
Pour accéder au panneau de configuration de l’extension ThreadSearch cliquez sur (voir
Figure 2.27 à la page 77) :
1. Bouton des Options du panneau de Thread search dans la console des messages.
2. Bouton des Options dans la barre d’outils de Thread search.
3. Menu Paramètres/Environnement puis choisir l’élément Thread search dans la colonne
de gauche.
Code::Blocks 76
Code::Blocks V2.0.1 beta 2.18 Thread Search
Note :
Les points 1, 2 et 3 peuvent ne pas être disponibles en fonction de la
configuration courante.
2.18.4 Options
Mot entier si coché, lignes contenant l’expression recherchée si l’expression recherchée
est trouvée sans caractères alphanumériques +'_' avant et après.
Début de mot si coché, lignes contenant l’expression recherchée si l’expression recherchée
est trouvée au début d’un mot sans caractères alphanumériques +'_' avant et après.
Respecter la casse si coché, la recherche est sensible à la casse (majuscules-minuscules).
Expression régulière l’expression recherchée est une expression régulière.
Code::Blocks 77
Code::Blocks V2.0.1 beta 2.18 Thread Search
Note :
Si vous voulez chercher des expressions régulières comme \n vous
devrez choisir l’option ’Utiliser des recherches RegEx avancées’ via
le menu ’Paramètres’ →’Éditeur’ →’Paramètres généraux’ .
Code::Blocks 78
Code::Blocks V2.0.1 beta 2.19 Code statistics
Basée sur les caractéristiques d’un masque de configuration, cette simple extension détecte
les pourcentages de codes, commentaires et lignes blanches d’un projet. L’évaluation se
lance via la commande de menu ’Extensions’ →’Code statistics’ .
Code::Blocks 79
Code::Blocks V2.0.1 beta 2.21 Importation de Projets
Note :
Koders et son successeur BlackDuck semblent avoir disparu ou changé
de site Web ! Aussi ce plugin ne fonctionne plus. En attente de mise
à jour ...
Cette recherche dans la base vous aidera à trouver du code source originaire du monde
entier en provenance d’autres projets universitaires, consortiums et d’organisations comme
Apache, Mozilla, Novell Forge, SourceForge et bien d’autres, qui peuvent être réutilisés
sans avoir à réinventer la roue à chaque fois. SVP, regardez bien la licence du code source
dans chaque cas particulier.
Code::Blocks 80
Code::Blocks V2.0.1 beta 2.23 Extension Symbol Table
Code::Blocks 81
3 Expansion de Variables
Code::Blocks fait la différence entre plusieurs types de variables. Ces types peuvent servir à
configurer l’environnement de création d’un programme, mais aussi à accroı̂tre la mainten-
abilité et la portabilité. L’accès aux variables de Code::Blocks s’obtient grâce à $<name>.
Variables d’Environnement sont configurées au démarrage de Code::Blocks. Elles peu-
vent modifier les variables d’environnement du système telles que PATH. Cela peut
être utile dans les cas où une variable d’environnement spécifique est nécessaire à la
création de projets. La configuration des variables d’environnement dans Code::Blocks
se fait à l’aide de ’Paramètres’ →’Environnement’ →’Variables d’environnement’ .
Variables internes sont prédéfinies dans Code::Blocks, et peuvent être accédées via leurs
noms (voir les détails dans section 3.2 à la page 83).
Macros Commandes Ce type de variables est utilisé pour contrôler le processus de
génération. Pour de plus amples informations se référer à section 3.4 à la page 88.
Variables Utilisateur sont des variables définies par l’utilisateur qui peuvent être spécifiées
dans les options de génération d’un projet. Ici vous pouvez, par exemple définir votre
type de processeur comme une variable MCU et lui assigner une valeur correspon-
dante. Puis entrer dans les options de compilation -mcpu=$(MCU), et Code::Blocks
le remplacera automatiquement par le contenu. Par cette méthode, la configuration
d’un projet peut être largement paramétrée.
Variables Globales sont surtout utilisées pour créer Code::Blocks à partir des sources ou
pour le développement d’applications wxWidgets. Ces variables ont une significa-
tion bien particulière. Par rapport à toutes les autres, si vous configurez de telles
variables et partagez votre fichier projet avec d’autres qui eux n’ont *pas* con-
figuré ces variables globales (ou GV), Code::Blocks demandera à l’utilisateur de
les configurer. C’est un moyen pratique de d’assurer qu’un ’autre développeur’ sait
facilement ce qu’il doit configurer. Code::Blocks posera la question pour tous les
chemins usuellement nécessaires.
3.1 Syntaxe
Code::Blocks traite de façon équivalente, en tant que variables, les séquences de caractères
suivantes dans les étapes de pré-génération, post-génération ou génération :
$VARIABLE
$(VARIABLE)
${VARIABLE}
%VARIABLE%
Les noms de variables doivent être composés de caractères alphanumériques et sont in-
sensibles à la casse (minuscules-majuscules). Les variables commençant par un seul signe
dièse (#) sont interprétées comme des variables utilisateur globales (voir les détails dans
Code::Blocks V2.0.1 beta 3.2 Liste des variables internes
la section 3.7 à la page 89). Les noms listés ci-dessous sont interprétés comme des types
de variables internes.
Les variables qui ne sont ni de type utilisateur globales ni de type interne, seront rem-
placées par une valeur fournie dans le fichier projet, ou par une variable d’environnement
si ce dernier échoue.
L’utilisation de ces variables peut être effectuée comme dans l’exemple suivant :
#include "include/manager.h"
wxString strdate = Manager::Get()=>GetMacrosManager()=>ReplaceMacros(_T("$TODAY"));
Note :
Les définitions ”par cible” sont prioritaires par rapport aux définitions
par-projet.
Code::Blocks 83
Code::Blocks V2.0.1 beta 3.2 Liste des variables internes
$(ACTIVE_EDITOR_DIRNAME)
le répertoire contenant le fichier actif courant (relatif au chemin de
plus haut niveau).
$(ACTIVE_EDITOR_STEM)
Le nom de base (sans extension) du fichier actif courant.
$(ACTIVE_EDITOR_EXT)
L’extension du fichier actif courant.
$(ALL_PROJECT_FILES)
Une chaı̂ne contenant les noms de tous les fichiers du projet courant.
$(MAKEFILE) Le nom de fichier du makefile.
$(CODEBLOCKS), $(APP_PATH), $(APPPATH), $(APP-PATH)
Le chemin de l’instance courante de Code::Blocks en cours d’exécution.
$(DATAPATH), $(DATA_PATH), $(DATA-PATH)
Le répertoire ’partagé’ de l’instance courante de Code::Blocks en cours
d’exécution.
$(PLUGINS) Le répertoire des plugins (ou extensions) de l’instance courante de
Code::Blocks en cours d’exécution.
$(TARGET_COMPILER_DIR)
Le répertoire d’installation du compilateur appelé aussi chemin maı̂tre.
Code::Blocks 84
Code::Blocks V2.0.1 beta 3.2 Liste des variables internes
Code::Blocks 85
Code::Blocks V2.0.1 beta 3.2 Liste des variables internes
Code::Blocks 86
Code::Blocks V2.0.1 beta 3.3 Expansion de script
L’évaluation Conditionnelle sera considérée comme vraie dans les cas suivants
la condition est un caractère non vide autre que 0 ou false
la condition est une variable non vide qui ne se résout pas en 0 ou false
la condition est une variable qui est évaluée à true (implicite par une condition
précédente)
L’évaluation Conditionnelle sera considérée comme fausse dans les cas suivants
la condition est vide
la condition est 0 ou false
la condition est une variable qui est vide ou évaluée à 0 ou false
Note :
Notez SVP que les variantes de syntaxe de variable %if (...) ou
$( if )(...) ne sont pas supportées dans ce type de construction.
Exemple
Par exemple : vous utilisez plusieurs plateformes et vous voulez configurer différents
paramètres en fonction du système d’exploitation. Dans le code suivant, la commande
de script [[ ]] est évaluée et la <commande> sera exécutée. Ce peut être utile dans une
étape de post-génération.
[ [ i f (PLATFORM == PLATFORM MSW) { p r i n t ( T ( ”cmd / c ” ) ) ; } e l s e
{ p r i n t ( T ( ” sh ” ) ) ; } ] ] <commande>
Note :
La manipulation d’états de Code::Blocks devrait être implémentée
dans des étapes de pré-générations plutôt que dans un script.
Code::Blocks 87
Code::Blocks V2.0.1 beta 3.4 Macros Commandes
L’expression entre ”backticks” (ou apostrophes inversées) retourne une liste de tous les
exécutables *.elf des sous-répertoires. Le résultat de cette expression peut être utilisé
directement par objdump. Au final, la sortie est redirigée vers un fichier nommé name.dis.
Ainsi, des processus peuvent être automatisés simplement sans avoir recours à aucune
boucle.
Exemple utilisant un Script
Le texte du script est remplacé par toute sortie générée par votre script, ou ignoré en cas
d’erreur de syntaxe.
Comme l’évaluation conditionnelle est exécutée avant l’expansion de scripts, l’évaluation
conditionnelle peut être utilisée pour les fonctionnalités de type pré-processeur. Les vari-
ables internes (et les variables utilisateur) sont étendues en sortie de scripts, aussi on peut
référencer des variables dans les sorties d’un script.
[ [ p r i n t ( GetProjectManager ( ) . G e t A c t i v e P r o j e c t ( ) . G e t T i t l e ( ) ) ; ]]
Code::Blocks 88
Code::Blocks V2.0.1 beta 3.5 Compilation d’un fichier unique
3.7.1 Synopsis
Travailler en tant que développeur sur un projet reposant sur des librairies tierces im-
pose un certain nombre de tâches répétitives inutiles, comme configurer des variables de
génération dépendantes du système de fichier local. Dans le cas de fichiers projets, une
attention toute particulière doit être apportée afin d’éviter de diffuser une copie modifiée
localement. Si on n’y prend pas garde, cela peut se produire facilement après avoir changé
par exemple un flag de génération pour obtenir une version de type release.
Le concept de variable globale du compilateur est une nouvelle solution unique à Code::Blocks
qui adresse ce problème. Les variables globales du compilateur vous permettent de con-
figurer un projet une seule fois, avec n’importe quel nombre de développeurs utilisant
n’importe quel système de fichiers pour compiler et développer ce projet. Aucune infor-
mation locale ne nécessite d’être changée plus d’une fois.
Code::Blocks 89
Code::Blocks V2.0.1 beta 3.7 Variables globales du compilateur
Les membres include et lib sont par défaut des aliases pour base/include et base/lib , re-
spectivement. Cependant, l’utilisateur peut les redéfinir si une autre configuration est
souhaitée.
Il est généralement recommandé d’utiliser la syntaxe $(#variable.include) plutôt que son
équivalent $(#variable)/include, car elle fournit une flexibilité accrue tout en étant fonc-
tionnellement identique (voir sous-section 3.7.6 à la page 92 et Figure 3.1 à la page 90
pour plus de détails).
Les membres cags et lags sont vides par défaut et peuvent être utilisés pour fournir la
possibilité de remplir un ensemble consistant unique de flags compilateur/éditeur de liens
pour toutes les générations sur une machine donnée. Code::Blocks vous permet de définir
des membres de variables utilisateur en complément de ceux prédéfinis.
3.7.3 Contraintes
Les noms de variables de configuration ou de compilateur ne peuvent pas être vides,
ne peuvent pas contenir de caractères blancs (ou espaces), doivent commencer par
une lettre et ne contenir que des caractères alphanumériques. Les lettres Cyrilliques
ou Chinoises ne sont pas des caractères alphanumériques. Si Code::Blocks rencontre
une séquence de caractères non valides dans un nom, il peut la remplacer sans le
demander.
Toutes les variables nécessitent que leur base soit définie. Tout le reste est optionnel,
mais la base est absolument obligatoire. Si vous ne définissez pas la base d’une
variable, elle ne sera pas sauvegardée (et ce même si les autres champs ont été
définis).
Vous ne pouvez pas définir un nom de membre utilisateur qui a le même nom qu’un
membre prédéfini. Actuellement, le membre utilisateur écrasera le membre prédéfini,
mais en général, le comportement est indéfini dans ce cas.
Les valeurs des variables et des membres peuvent contenir un nombre arbitraire de
séquences de caractères, mais doivent respecter les contraintes suivantes :
Code::Blocks 90
Code::Blocks V2.0.1 beta 3.7 Variables globales du compilateur
– Vous ne pouvez pas définir une variable par une valeur qui se référence à la
même variable ou à n’importe lequel de ses membres
– Vous ne pouvez pas définir un membre par une valeur qui se référence à ce
même membre
– Vous ne pouvez pas définir un membre ou une variable par une valeur qui se
référence à la même variable ou membre par une dépendance cyclique.
Code::Blocks détectera les cas de définitions récursives les plus évidentes (ce qui peut
arriver par accident), mais il ne fera pas d’analyse en profondeur de tous les cas possibles
abusifs. Si vous entrez n’importe quoi, alors vous obtiendrez n’importe quoi; vous êtes
avertis maintenant.
Exemples
Définir wx.include comme $(#wx)/include est redondant, mais parfaitement légal. Définir
wx.include comme $(#wx.include) est illégal et sera détecté par Code::Blocks. Définir
wx.include comme $(#cb.lib) qui est lui-même défini comme $(#wx.include) créera une
boucle infinie.
Code::Blocks 91
Code::Blocks V2.0.1 beta 3.7 Variables globales du compilateur
Un autre point positif à propos des ensembles est que si vous avez une douzaine de variables
et que vous voulez obtenir un nouvel ensemble avec une de ces variables pointant vers
un endroit différent, vous n’êtes pas obligés de ré-entrer toutes les données à nouveau.
Vous pouvez simplement créer un clone de l’ensemble courant, ce qui dupliquera toutes
vos variables.
Supprimer un ensemble supprimera également toutes les variables de cet ensemble (mais
pas celles d’une autre ensemble). L’ensemble default est toujours présent et ne peut pas
être supprimé.
Code::Blocks 92
Code::Blocks V2.0.1 beta 3.7 Variables globales du compilateur
C’est là que la véritable puissance des variables globales utilisateur se révèle. Quand vous
définissez la valeur de la variable #boost, vous allez juste un cran plus loin que d’habitude.
Vous définissez le membre include comme C:\Boost\include\boost-1 33 1\boost et le
membre lib comme C:\Boost\lib, respectivement. Votre projet utilisant $(#boost.include)
et $(#boost.lib) travaillera comme par magie correctement sur tout PC sans aucune mod-
ifications. Vous n’avez pas besoin de savoir pourquoi, vous ne voulez pas savoir pourquoi.
Code::Blocks 93
4 Travailler avec Code::Blocks
Ce chapitre traite de quelques connaissances de base pour pouvoir travailler avec Code::Blocks.
Quelques paragraphes, ici directement repris du Wiki font double emploi mais avec une
présentation un peu différente de ce qu’il y a dans le premier chapitre.
4.1.3 Projets
C’est ici que les choses deviennent intéressantes :).
Code::Blocks V2.0.1 beta 4.1 Le processus de génération de Code::Blocks
L’ordre de génération des projets est différent suivant que l’utilisateur a indiqué s’il y a
des dépendances ou pas entre les projets. Alors, allons-y...
Sans dépendances inter-projets
Dans ce cas, les projets sont générés dans l’ordre d’apparition, du haut vers le bas. Dans
la plupart des projets cependant (sauf ceux du genre ”hello world”), vous allez vouloir
créer des dépendances entre projets.
Utilisation de dépendances entre projets
Les dépendances de projets sont une façon simple d’indiquer à Code::Blocks qu’un projet
donné ”dépend” d’un autre (toujours dans le même espace de travail).
Alors imaginons que, dans votre espace de travail, vous avez un projet de librairie et
un projet d’exécutable qui dépend de cette librairie. Vous pouvez alors (et devez) in-
former Code::Blocks de cette dépendance. Pour faire cela, vous sélectionnez ’Projet’
→’Propriétés’ et cliquez sur le bouton des ”Dépendances de Projet...”.
Veuillez noter que les informations de dépendances sont enregistrées dans le fichier de
l’espace de travail, et non dans un fichier projet car les dépendances se font entre deux
projets à l’intérieur d’un même espace de travail.
C’est très facile d’utiliser ce dialogue. Sélectionnez le projet sur lequel vous voulez ajouter
une dépendance et cochez la case sur tous les projets dont ce projet de base dépend. Cela
aura pour conséquence que tous les projets que vous avez coché seront générés avant le
projet qui en dépend, assurant ainsi une génération synchronisée.
Code::Blocks 95
Code::Blocks V2.0.1 beta 4.1 Le processus de génération de Code::Blocks
Astuce : Vous n’avez pas à fermer ce dialogue et lancer d’autres propriétés de pro-
jets de nouveau pour configurer leurs dépendances. Vous pouvez configurer toutes les
dépendances de projets depuis cette même boı̂te de dialogue. Sélectionnez simplement un
autre projet dans le menu déroulant :).
Quelques choses à noter :
Les dépendances sont configurées directement ou indirectement. Si le projet A
dépend directement du projet B et que le projet B dépend du projet C, alors le
projet A dépend également du projet C, mais indirectement.
Code::Blocks est suffisamment intelligent pour vérifier s’il y a des dépendances cir-
culaires et donc les interdire. Une dépendance circulaire est obtenue quand un projet
A dépend directement ou indirectement d’un projet B et que le projet B dépend
directement ou indirectement du projet A.
Les dépendances prennent effet soit lors de la génération d’un espace de travail entier
soit sur un projet seul. Dans ce cas, seules les dépendances nécessaires au projet que
vous êtes en train de générer seront aussi générées.
Code::Blocks 96
Code::Blocks V2.0.1 beta 4.1 Le processus de génération de Code::Blocks
Note :
Les étapes de Pré-génération sont toujours exécutées. Les étapes de
Post-génération ne seront exécutées que si le projet/cible auxquelles
elles sont rattachées n’est pas à jour (c.à.d. en train d’être généré).
Vous pouvez changer cela en sélectionnant ”Toujours exécuter, même
si la cible est à jour” dans les options de génération.
Exemples de Script
Script de Post-génération qui copie le fichier de sortie dans un répertoire C:\Program\bin
sous Windows :
Code::Blocks 97
Code::Blocks V2.0.1 beta 4.2 Création d’un Nouveau Projet
Note :
Un texte en rouge au lieu d’un texte en noir sous n’importe quelle
icône signifie que l’on utilise un script assistant personnalisé.
Code::Blocks 98
Code::Blocks V2.0.1 beta 4.2 Création d’un Nouveau Projet
L’assistant Application console apparaitra ensuite. Continuez dans les menus, en sélectionnant
C++ quand on vous demandera le langage. Sur l’écran suivant, donnez un nom au
projet et tapez ou sélectionnez un répertoire de destination. Comme on voit ci-dessous,
Code::Blocks génèrera les entrées restantes à partir de ces deux là.
Finalement, l’assistant vous demandera si ce projet doit utiliser le compilateur par défaut
(normalement GCC) et les deux générations par défaut : Debug et Release. Toutes
ces configurations sont correctes. Appuyez sur Terminer et le projet va se générer. La
fenêtre principale va se griser, mais ce n’est pas un problème, le fichier source doit encore
être ouvert. Dans l’onglet Projets du panneau de Gestion sur la gauche, dépliez les
répertoires et double-cliquez sur le fichier source main.cpp afin de l’ouvrir dans l’éditeur.
Code::Blocks 99
Code::Blocks V2.0.1 beta 4.2 Création d’un Nouveau Projet
Note :
Généralement, c’est un mauvais style de programmation que de créer
une fonction dans un aussi petit fichier ; ici, ce n’est fait qu’à titre
d’exemple.
Pour ajouter un nouveau fichier au projet, appelez l’assistant de modèle de fichier soit
par le ’Fichier’ →’Nouveau’ →’Fichier...’ soit par ’Barre d’outils principale’ →’Nouveau
fichier (bouton)’ →’Fichier...’ Utilisez le menu ’Générer’ →’Générer l’espace de travail’
pour générer un espace de travail (c.a.d tous les projets qui y sont contenus).
Sélectionnez la source en C/C++ et cliquez sur Aller (ou Go). Continuez dans les
dialogues suivants tout comme lors de la création du projet original, en sélectionnant
Code::Blocks 100
Code::Blocks V2.0.1 beta 4.2 Création d’un Nouveau Projet
C++ quand on vous demandera le langage. La page finale vous présentera plusieurs
options. La première boı̂te détermine le nouveau nom du fichier et l’emplacement (comme
noté, le chemin complet est requis). Vous pouvez utiliser en option le bouton ... pour
afficher une fenêtre de navigateur de fichiers pour enregistrer l’emplacement du fichier.
En cochant Ajouter le fichier au projet actif vous enregistrerez le nom du fichier
dans le répertoire Sources de l’onglet Projets du panneau de Gestion. En cochant
une ou plusieurs cibles de génération vous informerez Code::Blocks que le fichier devra
être compilé puis de faire l’édition de liens pour la(les) cible(s) sélectionnée(s). Ce peut
être utile si, par exemple, le fichier contient du code spécifique de débogage, car cela
permettra l’inclusion dans (ou l’exclusion de) la (les) cible(s) de génération appropriée(s).
Dans cet exemple, toutefois, la fonction hello est indispensable, et donc requise dans toutes
les sources. Par conséquent, sélectionnez toutes les cases et cliquez sur Terminer pour
générer le fichier.
void h e l l o ( )
{
c o u t << ” H e l l o world ! ” << e n d l ;
}
Code::Blocks 101
Code::Blocks V2.0.1 beta 4.2 Création d’un Nouveau Projet
void h e l l o ( ) ;
Enregistrez ce fichier en tant que fichier d’en-tête (hello.h) dans le même répertoire
que les autres fichiers source de ce projet. Revenez dans Code::Blocks, cliquez sur ’Pro-
jet’ →’Ajouter des fichiers...’ pour ouvrir un navigateur de fichiers. Là, vous pouvez
sélectionner un ou plusieurs fichiers (en utilisant les combinations de Ctrl et Maj ). (L’option
’Projet’ →’Ajouter des fichiers récursivement...’ va chercher dans tous les sous-répertoires
d’un répertoire donné, en sélectionnant les fichiers adéquats à inclure.) Sélectionnez hello.h,
et cliquez sur Open pour obtenir le dialoque vous demandant dans quelles cibles le(les)
fichiers doivent appartenir. Dans cet exemple, sélectionnez les deux cibles.
Note :
Si le projet en cours n’a qu’une seule cible, on ne passera pas par ce
dialogue.
Code::Blocks 102
Code::Blocks V2.0.1 beta 4.2 Création d’un Nouveau Projet
#include ” h e l l o . h”
int main ( )
{
hello ();
return 0 ;
}
L’exécutable peut maintenant être lancé soit en cliquant sur le bouton Run soit en tapant
sur Ctrl-F10.
Note :
L’option F9 (pour Générer et exécuter) combine ces commandes, et
peut être encore plus utile dans certaines situations.
Code::Blocks 103
Code::Blocks V2.0.1 beta 4.2 Création d’un Nouveau Projet
Note :
Enlever un fichier d’un projet ne le supprime pas physiquement ;
Code::Blocks l’enlève seulement de la gestion du projet.
Code::Blocks 104
Code::Blocks V2.0.1 beta 4.2 Création d’un Nouveau Projet
Code::Blocks 105
Code::Blocks V2.0.1 beta 4.2 Création d’un Nouveau Projet
L’étape suivante est de changer les paramètres de cible. Cliquez sur Options de génération...
pour accéder aux paramètres. Le premier onglet qui s’affiche possède toute une série de
commutateurs de compilation (flags) accessibles via des cases à cocher. Sélectionnez ”Re-
tirez tous les symboles du binaire” et ”Optimiser le code généré pour la taille”. Les flags
ici contiennent bien d’autres options communément utilisées, cependant, on peut passer
outre. Basculez vers le sous-onglet Autres options et ajoutez-y les commutateurs suiv-
ants :
= fno = r t t i
= fno = e x c e p t i o n s
=f f u n c t i o n =s e c t i o n s
=f d a t a = s e c t i o n s
=f l t o
dans l’onglet Autre options de l’éditeur de liens :. (Pour plus de détails sur ce que font
ces commutateurs, se référer à la documentation de GCC sur les options d’optimisation
et les options de l’éditeur de liens.)
Cibles Virtuelles
Cliquez sur OK pour accepter ces changements et retournez au dialogue précédent. Main-
tenant, vous avez deux cibles de génération ”Release”, qui auront deux compilations
séparées pour lancer Générer ou Générer et exécuter. Heureusement, Code::Blocks
possède une option pour enchaı̂ner plusieurs générations ensemble. Cliquez sur Cibles
Virtuelles..., puis Ajouter. Nommez la cible virtuelle Releases puis cliquez sur OK.
Dans la boı̂te de droite Générer les cibles contenues, sélectionnez les deux Release
et Release small. Fermez cette boı̂te et cliquez sur OK dans la fenètre principale.
Code::Blocks 106
Code::Blocks V2.0.1 beta 4.3 Débogage avec Code::Blocks
La cible virtuelle ”Releases” est maintenant disponible dans la barre d’outils du Compi-
lateur ; la générer produira les sorties suivantes :
============== B u i l d : R e l e a s e i n HelloWorld ===============
Code::Blocks 107
Code::Blocks V2.0.1 beta 4.3 Débogage avec Code::Blocks
que dans les compilateurs autres que GCC, -g et/ou -s peuvent être des commutateurs
différents (-s peut ne pas être du tout disponible).
’Menu’ →’Projet’ →’Options de génération’
Code::Blocks 108
Code::Blocks V2.0.1 beta 4.3 Débogage avec Code::Blocks
La liste des témoins peut être enregistrée dans un fichier et rechargée plus tard. Pour ce
faire, clic droit dans la liste des témoins et sélectionnez ”enregistrer dans un fichier de
témoins” (puis ”charger un fichier de témoins” pour les recharger).
Code::Blocks 109
Code::Blocks V2.0.1 beta 4.3 Débogage avec Code::Blocks
2. Quand le débugueur est arrêté sur un point d’arrêt, sélectionnez un nom de vari-
able ou une expression complète, clic droit pour ouvrir un menu de contexte puis
sélectionnez ”Ajouter un témoin ’expression’”.
3. Sélectionnez une expression dans l’éditeur puis glissez-déposez là dans la fenêtre des
témoins.
L’inclusion automatique des variables locales et des arguments de fonction ont été ré-
implémentés en version 13.12.
Vous devez effectuer un clic droit dans la frame de la fenêtre de débogage de la ”pile
d’appel” et sélectionner ”Basculer vers cette frame”.
Code::Blocks 110
Code::Blocks V2.0.1 beta 4.3 Débogage avec Code::Blocks
Lancez le débugueur jusqu’à ce qu’il atteigne le point d’arrêt. Clic droit sur la variable
pour configurer un témoin dans la fenêtre des témoins.
Les points d’arrêts peuvent aussi être obtenus ou inversés par un clic gauche dans la marge
gauche de l’éditeur.
4.3.5 Notes
Support de Scripts
Code::Blocks utilise en natif le langage de scripts squirrel pour travailler avec gdb, voir:
Scripts du Débugueur (section 4.4 à la page 113). Depuis la version 7.X, gdb supporte les
”pretty printer” de python, et donc, il peut aussi utiliser gdb (avec le support python)
pour afficher des valeurs complexes de variables. Voir dans les forum le fil ”unofficial
MinGW GDB gdb with python released” et ”Use GDB python under Codeblocks” pour
Code::Blocks 111
Code::Blocks V2.0.1 beta 4.3 Débogage avec Code::Blocks
plus de détails.
Débogage d’un fichier seul
Pour débuguer votre programme vous devez absolument configurer un projet. Les pro-
grammes ne consistant qu’en un seul fichier, sans projet associé, ne sont pas supportés.
Chemin avec espaces
Les points d’arrêts ne peuvent pas fonctionner si le chemin et/ou le nom du répertoire où
vous avez placé votre projet contient des espaces ou d’autres caractères spéciaux. Pour
être sûr du coup, n’utilisez que des lettres anglaises, des chiffres et le caractère ’ ’.
”Forking”
Si votre application utilise le système d’appel ’fork’ vous aurez des problèmes pour arrêter
le programme en cours de débogage ou pour configurer des points d’arrêts à la volée.
Voici un lien expliquant les modes forking de GDB : http://sourceware.org/gdb/
onlinedocs/gdb/Forks.html
Mise à jour vers une version plus récente de MinGW
Depuis la version 6.8 de gdb d’Avril 2008, il supporte de nombreuses fonctionnalités qui
n’existaient pas dans les versions antérieures. Vous pouvez obtenir une mise à jour en
installant les binaires depuis les packages MinGW64 sur SourceForge.
Note :
Le package TDM-Mingw était un bon choix jusqu’à la version 5.1,
mais le développement est aujourd’hui abandonné.
Utilisation de CDB 32bit pour des programmes 32bit et CDB 64bit pour des
programmes 64bit
Il semble que le débogage d’un programme 32bit avec CDB 64bit ne fonctionne pas sous
Windows 7 (et plus ?), mais CDB 32bit fonctionne parfaitement.
Note :
Ceci ne devrait plus être le cas depuis Code::Blocks rev>=10920. Pour
plus de détails voir le ticket : #429
Code::Blocks 112
Code::Blocks V2.0.1 beta 4.4 Scripts du Débugueur
...et placer un point d’arrêt dans ”DebugCtorDtor” sur la ligne "int i = 0;". Le débugueur
s’arrêtera sur cette ligne. Si vous avancez alors pas à pas dans le débogage (’Menu
Débugueur’ →’Ligne suivante’ ; ou de façon alternative F7) vous atteindrez le code dans
le constructeur/destructeur (”is initialized = true/false;”).
Code::Blocks 113
Code::Blocks V2.0.1 beta 4.4 Scripts du Débugueur
Regardez l’image ci-dessus. Cela vous donnera un bref aperçu de comment les scripts du
débugueur fonctionnent. Par exemple, vous voulez observer la variable ”msg”. Il y a deux
échanges entre l’extension du débugueur et gdb.
Premièrement, l’extension du débugueur envoie une commande à gdb pour l’interroger
sur le type de msg
w h a t i s msg
Deuxièmement, le débugger vérifie que wxString est déjà enregistré, puis envoie la com-
mande
output / c msg . m pchData [ 0 ]@( ( wxStringData * ) msg . m pchData =1)=>nDataLength
Code::Blocks 114
Code::Blocks V2.0.1 beta 4.4 Scripts du Débugueur
// STL S t r i n g
d r i v e r . RegisterType (
T ( ”STL S t r i n g ” ) ,
T ( ” [ ˆ [ : alnum : ] ]+ s t r i n g [ ˆ [ : alnum : ] ] * ” ) ,
T(” Evaluate StlString ” ) ,
T(” Parse StlString ”)
);
}
Le paramètre ”driver” est le driver du débugueur mais vous n’avez pas besoin de vous en
soucier :) (actuellement, ça ne marche que dans GDB). Cette classe contient une seule
méthode : RegisterType. Voici sa déclaration en C++ :
void GDB driver : : R e g i s t e r T y p e ( const wxString& name , const wxString& regex ,
const wxString& e v a l f u n c , const wxString& p a r s e f u n c )
Donc, dans le code du script ci-dessus, le type ”STL String” (seulement un nom - qu’importe
ce que c’est) est enregistré, fournissant une expression régulière de contrôle sous forme de
Code::Blocks 115
Code::Blocks V2.0.1 beta 4.4 Scripts du Débugueur
chaı̂ne de caractères pour l’extension débugueur et, au final, il fournit les noms de deux
fonctions indispensables, nécessaires pour chaque type enregistré :
1. fonction d’évaluation : doit retourner la commande comprise par le débugueur
courant (GDB en l’occurrence). Pour ”STL string”, la fonction d’évaluation retourne
une commande de ”sortie” de GDB qui sera exécutée par de débugueur GDB.
2. fonction d’analyse : une fois que le débugueur a lancé la commande retournée par
la fonction d’évaluation, il passe ses résultats à cette fonction pour des traite-
ments complémentaires. Ce que cette fonction retourne, c’est ce qui est affiché
par Code::Blocks (habituellement dans la fenêtre des témoins ou dans une fenêtre
d’astuces (tooltip)).
Regardons la fonction d’évaluation pour std :: string :
f u n c t i o n E v a l u a t e S t l S t r i n g ( type , a s t r , s t a r t , count )
{
l o c a l oper = T ( ” . ” ) ;
l o c a l r e s u l t = T ( ” output ” ) + a s t r + o p e r + T ( ” c s t r ( ) [ ” )
+ s t a r t + T ( ” ]@” ) ;
i f ( count != 0 )
r e s u l t = r e s u l t + count ;
else
r e s u l t = r e s u l t + a s t r + oper + T ( ” s i z e ( ) ” ) ;
return r e s u l t ;
}
Je ne vais pas expliquer ce que cette fonction retourne. Je vais juste vous dire qu’elle re-
tourne une commande GDB qui fera que GDB imprimera le contenu réel de la std :: string .
Oui, vous devrez connaitre votre débugueur et ses commandes avant d’essayer d’étendre
ses fonctions.
Ce que je vais vous dire toutefois, c’est ce que sont les arguments de ces fonctions.
type: le type de données, par ex. ”char*”, ”const string”, etc.
a_str: le nom de la variable que GDB est en train d’évaluer.
start: l’offset de départ (utilisé pour les tableaux (ou arrays)).
count: le compteur démarrant depuis l’offset de départ (utilisé pour les tableaux).
Voyons maintenant la fonction d’analyse utile :
function Parse StlString ( a str , start )
{
// n o t h i n g n e e d s t o be done
return a s t r ;
}
Code::Blocks 116
Code::Blocks V2.0.1 beta 4.5 Code::Blocks et les Makefiles
a_str: la chaı̂ne retournée quand GDB a été exécuté et retournée par la fonction
d’évaluation. Dans le cas de std :: string , c’est le contenu de la chaı̂ne.
start: l’offset de départ (utilisé pour les tableaux).
Bon, dans cet exemple, il n’y a rien besoin de faire. ”a_str” contient déjà le contenu de
std: string et donc il suffit de retourner la chaı̂ne:)
Je vous suggère d’étudier comment wxString est enregistré dans ce même fichier, en tant
qu’exemple plus complexe.
Code::Blocks 117
Code::Blocks V2.0.1 beta 4.5 Code::Blocks et les Makefiles
.mak dans votre projet et il apparaitra dans le panneau de Gestion de projets, sur la
gauche.
En supposant que vous voulez éditer le makefile depuis CB, vous devez vous assurer
que l’éditeur utilise bien des tabulations (plutôt que des espaces). C’est un problème
générique de l’utilitaire make car il a besoin de commencer des lignes de commandes
par un caractère tab alors que de nombreux éditeurs remplacent les tabulations par des
espaces. Pour obtenir cela dans CB, ouvrez la fenêtre ’Paramètres’ →’Éditeur’ et cocher
la case pour utiliser le caractère de tabulation (tab).
Les problèmes réels commencent toutefois maintenant. La génération automatique de CB
ajoute toutes les en-têtes des wxWidgets, mais si vous utilisez un makefile, tout cela n’est
pas fait et vous aurez à le faire vous-même.
Heureusement CB possède une autre fonctionnalité qui peut venir à votre secours. Si
vous allez dans le menu ’Paramètres’ →’Compilateur et Débugueur’ , déplacez les onglets
horizontalement vers la droite, vous trouverez l’onglet ‘autres paramètres’. Là, cliquez sur
la case à cocher ’Enregistrer la génération en HTML ...’. Ceci permettra à CB de créer,
au moment de la génération, un fichier HTML qui enregistrera toutes les commandes de
génération.
Note :
Cette façon de créer un fichier html de génération n’existe plus dans
les versions récentes de CB, mais il y a d’autres solutions
Si vous compilez (sans utiliser un makefile - donc si vous avez déjà tout remis à plat
- désolé) le programme minimal par défaut utilisant wxWidgets, vous pouvez voir les
commandes de compilation et d’édition de liens qui produisent ce fichier.
En supposant que vous allez prendre cela comme base pour votre projet, vous pouvez
utiliser le contenu du fichier HTML produit comme base de votre makefile.
Vous ne pouvez pas simplement le copier depuis le visualiseur HTML de CB (il n’y
a pas cette fonction dans CB) mais vous pouvez charger le fichier dans un navigateur
ou un éditeur, et le copier depuis là. Vous le trouverez dans votre répertoire de pro-
jet avec <le_meme_nom_que_votre_projet>_build_log.HTML. Malheureusement, cela re-
quiert encore quelques ajustements comme montrés ci-dessous.
Voici une copie d’un fichier de génération pour un programme wxWidgets de base tel que
décrit ci-dessus.
Note :
Pour une meilleure lisibilité, les lignes trop longues ont été découpées.
Le signe ^ est le séparateur de ligne en mode DOS, le signe \ est le
séparateur dans le makefile. Mais vous pouvez avoir les commandes
sur une seule ligne à condition d’enlever les séparateurs
Code::Blocks 118
Code::Blocks V2.0.1 beta 4.5 Code::Blocks et les Makefiles
Le code ci-dessus peut être converti en un makefile ci-dessous. Il est resté délibérément
assez proche de la sortie du fichier HTML.
Incpath1 = C:\PF\wxWidgets2.8\include
Incpath2 = C:\PF\wxWidgets2.8\contrib\include
Incpath3 = C:\PF\wxWidgets2.8\lib\gcc_dll\mswud
Libpath = C:\PF\wxWidgets2.8\lib\gcc_dll
CXX = mingw32-g++.exe
obj\Debug\testMain.o : C:\Development\test\testMain.cpp
$(CXX) $(flags) -I$(Incpath1) -I$(Incpath2) -I$(Incpath3) \
-c C:\Development\test\testMain.cpp -o obj\Debug\testMain.o
Code::Blocks 119
Code::Blocks V2.0.1 beta 4.5 Code::Blocks et les Makefiles
obj\Debug\testApp.o : C:\Development\test\testApp.cpp
$(CXX) $(flags) -I$(Incpath1) -I$(Incpath2) -I$(Incpath3) \
-c C:\Development\test\testApp.cpp -o obj\Debug\testApp.o
obj\Debug\resource.coff : C:\Development\test\resource.rc
windres -I$(Incpath1) -I$(Incpath2) -I$(Incpath3) \
-iC:\Development\test\resource.rc -oobj\Debug\resource.coff
J’ai écrit un makefile générique que je n’ai testé que sous Windows Vista mais qui devrait
fonctionner sur tout projet commencé comme décrit ci-dessus. Vous devrez changer le
nom du projet et ajuster les chemins appropriés (vous n’aurez probablement qu’à changer
Ppath et WXpath).
#paths for Project (Ppath) Object files (Opath) and binary path (Bpath)
Ppath := C:\Development\$(Proj)
Opath := obj\$(Version)
Bpath := bin\$(Version)
Code::Blocks 120
Code::Blocks V2.0.1 beta 4.5 Code::Blocks et les Makefiles
CXX = mingw32-g++.exe
$(Proj).exe : $(Obj)
$(CXX) -L$(Libpath) -o $(Bpath)\$(Proj).exe $(Obj) -lwxmsw28ud -mwindows
$(Opath)\$(Proj)Main.o : $(Ppath)\$(Proj)Main.cpp
$(CXX) $(flags) -I$(IncWX) -I$(IncCON) -I$(IncMSW) -c $^ -o $@
$(Opath)\$(Proj)App.o : C:\Development\$(Proj)\$(Proj)App.cpp
$(CXX) $(flags) -I$(IncWX) -I$(IncCON) -I$(IncMSW) -c $^ -o $@
$(Opath)\resource.coff : C:\Development\$(Proj)\resource.rc
windres -I$(IncWX) -I$(IncCON) -I$(IncMSW) -i$^ -o $@
.PHONEY : clean
clean:
del $(Bpath)\$(Proj).exe $(Obj) $(Opath)\resource.coff
Note :
Exporter un makefile depuis un projet Code::Blocks est possible in-
directement. Vous pouvez l’obtenir à partir de l’utilitaire cbp2make
(voir sa description dans section 4.6 à la page 122 et/ou un exemple
d’utilisation via Tool+ sous-section 2.17.1 à la page 74.
Une dernière remarque. Une fois que vous avez utilisé un makefile, toute tentative de
compiler sans un makefile vous produira de nombreux warnings. La seule façon que j’ai
trouvée pour résoudre cela est de réinstaller CB. Si vous avez besoin des deux façons de
compiler il est possible d’installer 2 versions de CB.
Note :
C’est une remarque du texte original dans le Wiki. Mais, en tant
qu’utilisateur gd on, je n’ai jamais observé ce comportement
Code::Blocks 121
Code::Blocks V2.0.1 beta 4.6 Utilitaire Cbp2make
En général, il n’est pas recommandé d’utiliser un makefile, mais s’il y a de bonnes raisons
de le faire, alors vous avez ici ce qu’il faut.
4.5.2 Compléments
Par défaut, Code::Blocks génère une cible ”Release” et une cible ”Debug”. Dans votre
Makefile, ces cibles peuvent ne pas être présentes. Mais vous avez peut-être une cible
”All” (ou ”all”). Vous pouvez renommer la cible dans Code::Blocks (ou en ajouter une)
par ce nom qui a été donné dans le Makefile.
De plus, votre Makefile génère un exécutable avec un nom spécifique et dans un répertoire
spécifique. Dans Code::Blocks vous devriez ajuster le chemin et le nom de l’exécutable.
Ainsi, Code::Blocks, comme il ne connait ni n’analyse le Makefile, trouvera l’exécutable,
et la flèche verte d’exécution dans le menu fonctionnera (ou Ctrl-F10).
Note :
Cbp2make n’est pas une extension de Code::Blocks, mais une ap-
plication console autonome, placée dans le répertoire principal de
Code::Blocks, et qui génère un (ou des) makefile(s) à partir du système
de génération interne de Code::Blocks
4.6.1 À propos
”cbp2make” est un outil autonome qui vous permet de générer un (ou des) makefile(s)
pour les utiliser via le Make de GNU et en externe aux projets ou aux espaces de travail
de l’IDE Code::Blocks. (Voir aussi http://forums.codeblocks.org/index.php/topic,
13675.0.html])
4.6.2 Utilisation
Création d’un makefile pour un projet unique ou un espace de travail
Supposons que vous ayez un projet ”mon projet.cbp” et que vous ayez besoin d’un makefile
pour ce projet. Dans le cas le plus simple, tout ce que vous avez à faire c’est :
cbp2make = i n m o n p r o j e t . cbp
Code::Blocks 122
Code::Blocks V2.0.1 beta 4.6 Utilitaire Cbp2make
4.6.3 Configuration
Quelques options spécifiques d’installation ou spécifiques de projet, essentiellement des
configurations d’outils, peuvent être enregistrées dans un fichier de configuration. Par
défaut (depuis la rev.110 ), cbp2make n’enregistre aucun paramètre dans un fichier de
configuration sauf si l’utilisateur spécifie explicitement l’option "==cong". Un fichier de
configuration peut être soit global (enregistré dans le profil utilisateur / répertoire home)
soit local (enregistré dans le répertoire courant).
SVP, gardez à l’esprit que comme cbp2make est encore à un stade de développement
précoce, un ancien fichier de configuration peut devenir incompatible avec la nouvelle
version de l’outil et il pourrait être nécessaire de le mettre à jour à la main ou d’en
initialiser un nouveau.
Initialisation
cbp2make == c o n f i g o p t i o n s == g l o b a l
cbp2make == c o n f i g o p t i o n s == l o c a l
Utilisation suivante
Lorsqu’on invoque cbp2make, il commence par essayer de charger un fichier de configura-
tion local. S’il n’y a pas de fichier de configuration local, il tentera d’en charger un global.
Code::Blocks 123
Code::Blocks V2.0.1 beta 4.6 Utilitaire Cbp2make
Si ces tentatives échouent, la configuration construite en interne est alors utilisée. L’ordre
de consultation des configurations peut se changer par les options en ligne de commande
"==local" ou "==global". Si une des options est fournie à cbp2make, la configuration
non-spécifiée ne sera pas tentée même si celle spécifiée est absente et que la non-spécifiée
existe.
Ordre de consultation par défaut
cbp2make = i n p r o j e c t . cbp = out M a k e f i l e }
Types d’outils :
Code::Blocks 124
Code::Blocks V2.0.1 beta 4.6 Utilitaire Cbp2make
Options de gestion :
Options communes :
Code::Blocks 125
Code::Blocks V2.0.1 beta 4.6 Utilitaire Cbp2make
Options
"Génération de Makefile"
--flat-objects // force les noms "flat" pour les fichiers objets avec un
"character set" limité;
--flat-objpath // force les noms de chemins "flat" pour les fichiers objets
sans sous-répertoires;
Code::Blocks 126
Code::Blocks V2.0.1 beta 4.7 Internationalisation de l’interface de Code::Blocks
Code::Blocks 127
Code::Blocks V2.0.1 beta 4.7 Internationalisation de l’interface de Code::Blocks
Code::Blocks 128
Code::Blocks V2.0.1 beta 4.7 Internationalisation de l’interface de Code::Blocks
Code::Blocks 129
5 Installation et Configuration de CodeBlocks
avec MinGW
Ce chapitre décrit comment installer et configurer Code::Blocks. Le processus d’installation
est ici décrit pour Windows, mais peut être adapté aux autres OS.
Une bonne solution, est d’installer une distribution officielle comportant MinGW
puis d’installer par-dessus cette version officielle une ”nightly”. Il vous faudra suivre
la procédure avec attention car car il pourrait y avoir des incompatibilités. Le
mélange de versions apporte des problèmes.
La version complète de Code::Blocks est distribuée avec une version de MinGW en
64 bits incluse dans un sous-répertoire. Parfois, cela peut amener des soucis car le
nom de chemin complet contient un espace (dans Program Files). Une bonne so-
lution consiste à déplacer le répertoire MinGW à la racine de votre disque. Vous
pouvez aussi le renommer en C:\MinGW64. La détection automatique du compila-
teur devrait l’y trouver.
5.2.1 Généralités
Une chaı̂ne d’outils de compilation est ce que Code::Blocks utilise pour transformer le
code que vous avez tapé en nombres que l’ordinateur peut comprendre. Comme une
chaı̂ne d’outils de compilation est une chose plutôt complexe ce n’est pas une par-
tie intégrante de Code::Blocks mais plutôt un projet séparé que Code::Blocks utilise
alors. Le type d’outils de chaı̂ne de compilation dont il est question dans ces pages est
la chaı̂ne d’outils ”MinGW”. Cela veut dire ”Minimalist GNU for Windows.” Et ”GNU”
peut s’interpréter par ”GNU’s Not Unix.” Davantage d’informations sur le projet GNU
peuvent être trouvées via la page d’accueil de GNU.
Pour la plupart des chaı̂nes d’outils de compilation basées sur MinGW, il est important
d’avoir le chemin de cette chaı̂ne dans votre variable d’environnement PATH car cela
signifie que pendant le développement les librairies seront accessibles par défaut à vos
programmes pendant que vous les développez mais cela rend aussi plus facile l’utilisation
d’utilitaires comme CMake car ils seront capables de trouver votre chaı̂ne d’outils de
compilation. Quand vous distribuez vraiment vos programmes vers d’autres ordinateurs
vous aurez besoin de copier les fichiers .dll nécessaires depuis votre répertoire de chaı̂ne
de compilation et de les intégrer en tant que partie intégrante dans votre installateur. Sur
votre machine elles sont dans votre PATH et donc vous les avez toujours à portée, mais
sur les ordinateurs des autres utilisateurs, ils n’auront peut-être pas cette chaı̂ne d’outils
de compilation, c’est pourquoi vous devrez fournir vos fichier dll avec votre programme.
Code::Blocks 131
Code::Blocks V2.0.1 beta 5.2 Configurer MinGW
Code::Blocks 132
Code::Blocks V2.0.1 beta 5.2 Configurer MinGW
Puis dans l’onglet ”Programmes” (ou ”Toolchain executables”) (flèche en rouge), cliquez
sur ”...”, (flèche en bleu) et choisissez le répertoire de base où vous avez installé MinGW
(64-bits ici). Une fois que vous avez choisi ce répertoire, dans la sous rubrique ”Fichiers
de Programmes” (flèche en vert) des champs à rempli sont affichés. Si vous n’utilisez
pas une chaı̂ne d’outils MinGW 64-bits, il se peut que des variations mineures soient à
apporter aux noms des exécutables. Si vous avez choisi d’abord le bouton indiqué par la
flèche en bleu, alors pour chacun des boutons suivants vous serez déjà positionnés dans le
sous-répertoire bin de votre MinGW 64-bits où sont placés les programmes.
Code::Blocks 133
Code::Blocks V2.0.1 beta 5.2 Configurer MinGW
Note :
Pour configurer un nouveau compilateur, gfortran par exemple, entrez
gfortran.exe dans les 3 premiers champs de texte de l’ongle ”Fichiers
Programmes”, ou le nom exact qui est dans votre distribution
Choisissez votre débugueur par défaut (flèche en rouge), puis remplissez dans le champ
de l’exécutable comme indiqué pour MinGW 64-bits (flèche en bleu).
Code::Blocks 134
Code::Blocks V2.0.1 beta 5.3 Version Nightly de Code::Blocks sous Windows
Résumé
Vous avez maintenant un environnement de Code::Blocks qui est configuré pour utiliser
correctement MinGW 64-bits. Utilisez ce guide comme un modèle pour configurer d’autres
chaı̂nes d’outils de compilation qu’elle qu’en soit la source - suivez simplement cette
procédure de base.
Outils de Développement
Normalement vous ne devriez pas avoir besoin de ces outils. ZIP est pratique, notamment
pour générer Code::Blocks lui-même, est souvent déjà présent dans MinGW, mais les
autres outils servent seulement dans des cas particuliers.
UnxUtils : différents outils Unix-Like sur https://sourceforge.net/projects/
unxutils/
GnuWin32 : d’autres outils Gnu sur https://sourceforge.net/projects/gnuwin32/
ZIP : 32-bits ou 64-bits sur ftp://ftp.info-zip.org/pub/infozip/win32/ : choi-
sissez plutôt une version zip300xn.
Code::Blocks 135
Code::Blocks V2.0.1 beta 5.3 Version Nightly de Code::Blocks sous Windows
de l’art des sources de Code::Blocks. En principe, elles sont relativement stables, cepen-
dant elles peuvent aussi introduire de nouveaux bugs, des régressions, mais d’un autre
côté elles peuvent apporter de nouvelles fonctionnalités, des corrections de bugs, ...
Avant de décrire ce que ces générations contiennent, il est important de commencer par
revoir ce que NE SONT PAS les générations ”nightly”. Pour débuter demandez-vous :
qu’est-ce que Code::Blocks?
Bon, c’est un IDE (Integrated Development Environment) soit en français un Environ-
nement de Développement Intégré : cela signifie qu’il intègre différents outils et les fait
travailler ensemble. Donc Code::Blocks n’est PAS un compilateur (ni même MS, ni
Borland), ce n’est pas un débugueur, ce n’est pas non plus un système de génération de
makefile ! Donc, ces composants ne font PAS partie de Code::Blocks, et par conséquent
ne font pas partie de la distribution ”nightly”. Toutefois, plusieurs des composants de
développement mentionnés peuvent être combinés pour travailler harmonieusement en-
semble dans Code::Blocks. Par exemple, vous pouvez y intégrer le compilateur GCC et le
débugueur GDB et ainsi compiler et débuguer vos propres applications.
Code::Blocks est lui-même compilé avec GCC. Sous Windows c’est fait en utilisant le
portage MinGW. Comme Code::Blocks est une application ”multi-threaded” cela nécessite
le support de routines fournissant ces fonctionnalités de ”multi-threading”. C’est ce que
fourni le portage MinGW, et plus particulièrement la librairie ”mingwm10.dll” Dans cha-
cune des annonces d’une nouvelle génération de ”nightly” vous trouverez un lien vers cette
dll. Code::Blocks possède un GUI (Graphical User Interface) ou Interface Graphique Util-
isateur en français. Il existe de nombreuses façons de créer un GUI : vous pouvez le coder
en utilisant le coeur de l’API Windows (ne fonctionne que sous Windows) ou vous pouvez
utiliser MS-MFC (ne fonctionne que sous Windows) ou vous pouvez utiliser une librairie
de GUI tierce, comme QT, wxWidgets, Tk, ...
Code::Blocks utilise wxWidgets. En plus de l’apport GUI, wxWidgets amène bien d’autres
fonctions supplémentaires (manipulation de chaı̂nes, fichiers, flux, sockets, ...) et le meilleur
dans tout ça : wxWidgets apporte ces fonctions pour différentes plateformes (Windows,
Linux, Apple, ...). Cela veut dire qu’il faut que Code::Blocks intègre les fonctionnalités de
wxWidgets (à savoir le code binaire qui effectue le réel travail). C’est ce qui est obtenu
via une dll : ”wxmsw31u gcc cb.dll” (17.12 était basé sur ”wxmsw28u gcc cb.dll”). Une
fois de plus, sur chaque annonce de génération ”nightly” vous trouverez un lien vers cette
dll ainsi que d’autres prérequis.
Quand, sous Windows, vous installez une version officielle incluant MinGW (la version
recommandée), vous trouverez un répertoire MinGW dans C:\Program Files\codeblocks.
Si cela marche bien ici dans la plupart des cas, ce n’est pas le meilleur endroit pour le
mettre, entre autre parce qu’il y a un espace à l’intérieur du nom du chemin d’accès et
que cet espace peut troubler certains des composants de MinGW. Alors, sous Windows,
déplacez de répertoire MinGW vers C:, par exemple. Vous pouvez même le renommer
MinGW32 pour une chaı̂ne d’outils de compilation en 32 bits, ou MinGW64 pour une
chaı̂ne en 64 bits.
Comme dit précédemment, une bonne solution pour installer une version ”nightly” est
de commencer par installer une version officielle, puis de la configurer et l’essayer.
Ainsi, vos fichiers de configuration, associations, raccourcis clavier, seront correctement
paramétrés et ils seront conservés lors de l’installation de la ”nightly”. Le lien pour trouver
Code::Blocks 136
Code::Blocks V2.0.1 beta 5.3 Version Nightly de Code::Blocks sous Windows
Code::Blocks 137
6 Générer CodeBlocks à partir des Sources
Ce chapitre décrit comment générer Code::Blocks lui-même.
Note :
Ce chapitre existait dans les fichiers originaux .tex de la version 1
mais n’a pas été publié dans toutes les langues. Il est nécessaire de le
revoir et de le compléter, au moins pour les utilisateurs Linux.
6.1 Introduction
Cette section décrit le processus de création des nightly builds (générations nocturnes !),
et peut être utilisé comme un guide si vous voulez générer Code::Blocks vous-même. La
description suivante est une séquence d’actions.
Afin de procéder à notre tâche de génération, nous aurons besoin de plusieurs outils.
Créons d’abord une liste d’ingrédients pour notre recette de cuisine.
un compilateur
un système de génération initial (une version précédente déjà fonctionnelle)
les sources de Code::Blocks
un programme zip
svn (système de contrôle de versions)
wxWidgets
Note :
La version MinGW 64 bits peut générer du code 64 bits et du code
32 bits. Ajoutez simplement l’option -m64 ou -m32 à vos options de
compilation ET d’édition de liens. En principe, la version 32 bits ne
génère que du code 32 bits. Faites juste attention si vous utilisez des
librairies, statiques ou dynamiques, à ce qu’elles aient été générées
avec le même nombre de bits
set path=%PATH%;C:\MinGW32\bin;C:\MinGW32\i686-w64-mingw32\bin;
Code::Blocks 139
Code::Blocks V2.0.1 beta 6.2 Windows ou Linux
set path=%PATH%;C:\MinGW64\bin;C:\MinGW64\x86_64-w64-mingw32\bin;
C’est nécessaire pour lancer votre exécutable en dehors du contexte de l’IDE Code::Blocks.
Vous pouvez aussi modifier la variable d’environnement PATH (globale ou utilisateur).
Code::Blocks 140
Code::Blocks V2.0.1 beta 6.2 Windows ou Linux
6.2.3 wxWidgets
[,→Wxwidgets] est une librairie disponible sur plusieurs plateformes et qui fournit une
API supportant de nombreuses choses comme une Interface Graphique Utilisateur (GUI),
des sockets, fichiers, fonctionnalités de registres. En utilisant cette API, vous pouvez créer
des programmes indépendants des plateformes.
Code::Blocks est une application wxWidgets (aussi dénommées ci-dessous : wx), ce qui
signifie que pour exécuter Code::Blocks vous avez besoin des fonctionnalités wx. Cela peut
se faire de deux façons. Soit par une .dll soit par une librairie statique. Code::Blocks
utilise wx en tant que dll et cette dll peut aussi se télécharger depuis la section nightly
builds du forum.
Néanmoins, si nous voulons générer une application wx, nous devons inclure les headers
(ou en-têtes) des sources wx. Elles donnent au compilateur les informations sur les fonc-
tionnalités de wx. En plus de ces fichiers de headers, notre application a besoin d’être liée
aux librairies d’importation wx. Bien, voyons cela pas à pas.
Wx est fourni sous forme de fichiers sources dans un fichier zip, aussi, nous devons le
générer par nous-mêmes. Nous avons déjà le compilateur MinGW, donc nous avons tous
les outils nécessaires sous la main.
Dézippez maintenant les sources wx dans C:\Projets et ainsi nous aurons au final un
répertoire wx de base comme celui-ci : C:\Projets\wxWidgets-3.1.3. Ensuite, dézippez
les patchs (s’il y en a !) dans le même sous répertoire afin de remplacer les fichiers modifiés.
Notez que nous allons référencer le répertoire wx de base à partir de maintenant comme
<wxDir>
Maintenant, nous allons générer les wxWidgets. Voici comment faire :
Premièrement, assurez-vous que C:\MingGW\bin est dans votre variable path, car durant
la génération quelques programmes résidant dans le répertoire MinGW\bin seront appelés.
De plus, Make doit être en version 3.80 ou supérieure.
Code::Blocks 141
Code::Blocks V2.0.1 beta 6.2 Windows ou Linux
Il est temps maintenant de compiler les wxWidgets. Ouvrir une fenêtre de commande
DOS et se placer dans le répertoire des wxWidgets :
cd <wxDir>\build\msw
Nous sommes maintenant au bon endroit. Nous allons d’abord nettoyer les sources :
Maintenant que tout est propre, nous pouvons compiler les wxWidgets :
Si vous utilisez le compilateur TDM-gcc 5.1.0, ou gcc 8.1.0, vous aurez à ajouter sur la
même ligne de commande :
USE_XRC=1
CXXFLAGS+="-fpermissive -fno-keep-inline-dllexport -std=gnu++11
-Wno-deprecated-declarations"
LDFLAGS="-Wl,--allow-multiple-definition"
Depuis la révision SVN 11701, Code::Blocks sous Windows est généré en activant/forçant
le support de DIRECT2D (pour une plus rapide et meilleure qualité graphique). La
génération de wxWidgets nécessite quelques ajustments à effectuer directement dans le(s)
fichier(s) setup.h. Normalement le seul fichier à modifier est dans le sous-répertoire lib,
celui créé lors de la première génération de wxWidgets, et utilisé par la suite. Pour une
génération par gcc, dll, c’est quelque chose comme : C:\wxWidgets-3.1.3\lib\gcc dll\mswu\wx.
Vous pouvez simplement modifier la ligne contenant (ligne 1593 dans wxWidgets 3.1.3):
#define wxUSE_GRAPHICS_DIRECT2D 0
par
#define wxUSE_GRAPHICS_DIRECT2D 1
Les autres setup.h peuvent être modifiés, mais ce n’est normalement pas requis.
en option :
USE_OPENGL=1
DEBUG_LEVEL=0
Note :
USE OPENGL=1 crée une dll supplémentaire, utilisée si votre pro-
gramme wxWidgets requiert une fenêtre OpenGL, notamment lorsque
vous utilisez wxGLCanvas
Code::Blocks 142
Code::Blocks V2.0.1 beta 6.2 Windows ou Linux
VENDOR=cb
VENDOR=cb_64
Note :
Si VENDOR n’est pas spécifié, cela revient à VENDOR=custom.
VENDOR=cb est utilisé par l’équipe de Code::Blocks. Aussi, pour
éviter toute confusion, il peut être prudent d’utiliser un autre identi-
fiant de ”vendor”.
strip ..\..\lib\gcc_dll\wxmsw313u_gcc_cb_64.dll
strip ..\..\lib\gcc_dll\wxmsw313u_gl_gcc_cb_64.dll
6.2.4 Zip
Durant la génération de Code::Blocks, plusieurs ressources seront compressées dans des
fichiers zip. Aussi, le processus de génération doit pouvoir accéder à un zip.exe. Nous
Code::Blocks 143
Code::Blocks V2.0.1 beta 6.2 Windows ou Linux
devons télécharger ce zip.exe (s’il n’est pas déjà dans votre distribution MinGW) et le
mettre quelque part dans notre path. MingW\bin est un bon endroit pour cela.
Vous pouvez depuis ce site (http://www.info-zip.org/pub/infozip/Zip.html) télécharger
zip.exe gratuitement, ou depuis là (ftp://ftp.info-zip.org/pub/infozip/win32/) qui
est un lien direct vers un répertoire contenant les plus récentes versions.
Une fois téléchargé, extraire simplement zip.exe vers l’endroit approprié.
Code::Blocks 144
Code::Blocks V2.0.1 beta 6.2 Windows ou Linux
Note :
Il existe plusieurs variantes de ce fichier, dépendant de l’OS, de la
version wxWidgets, d’une génération en 32 ou 64 bits.
Code::Blocks 145
Code::Blocks V2.0.1 beta 6.2 Windows ou Linux
6.2.6.1 Windows
Nous sommes maintenant arrivés à l’étape finale ; notre but ultime. Lancez l’exécutable
Code::Blocks depuis votre téléchargement de ”nightly”. Ouvrir le menu Fichier, dans le
navigateur cherchez l’espace de travail adéquat et lances-le. Soyez patients pendant que
Code::Blocks analyse l’ensemble, puis on vous demandera de renseigner 3 ou 4 variables
globales. Celles-ci indiqueront à Code::Blocks où il trouvera les wxWidgets (pour mémoire
: les fichiers d’en-têtes et les librairies d’importation) et où il peut trouver les sources de
... Code::Blocks. Ceci est nécessaire pour les plug-ins contributifs (ainsi que pour les
plug-ins de l’utilisateur), qui doivent savoir où trouver le sdk (Les fichiers d’en-têtes de
Code::Blocks). Dans notre cas, cela peut donner :
wx <wxDir> répertoire de base des wxWidgets: le nom de la variable peut être wx31,
wx31 64,...
cb <cbDir>/src répertoire contenant les sources de Code::Blocks.
cb release type : -O (Pour obtenir une version release, cas habituel. Les développeurs
peuvent entrer -g pour débuguer C::B)
boost : répertoire de base où boost est installé (par ex : C:\boost). · Utilisé par le plugin
NassiShneiderman Remplissez avec la même valeur les sous-sections include et lib.
Aller maintenant dans le Menu Projet et choisissez (re)générer l’espace de travail, et allez
faire un tour. Regardez comment Code::Blocks est en train de générer Code::Blocks.
Après la création de Code::Blocks, les fichiers générés avec les informations de débogage
se trouvent dans le sous-répertoire devel. En appelant, ou lançant depuis une con-
sole, le fichier batch update.bat depuis le répertoire source <cbDir>/src (ou plus
spécifiquement la version adaptée à votre génération spécifique, comme par exemple
update31 64.bat), les fichiers sont copiés dans le sous-répertoire output (ou la version
adaptée). De plus, toutes les informations de débogage sont retirées. Cette étape est très
importante - ne jamais l’oublier.
Vous pouvez maintenant copier la dll wx à la fois dans ce répertoire output et, en option,
dans devel.
Vous pouvez alors fermer Code::Blocks. Rappelez-vous, nous utilisions la version nightly
téléchargée ?
Il est temps de tester la nouvelle version. Dans le répertoire output, lancez CodeBlocks.exe.
Si tout s’est bien passé, vous avez généré votre propre version de Code::Blocks faite maison.
6.2.6.2 Linux
(Note : Cette section devrait être revue et complétée. Elle ne semble pas
complètement à jour)
linux Lancer update revision.sh
Code::Blocks 146
Code::Blocks V2.0.1 beta 6.2 Windows ou Linux
Avec cette fonction la révision SVN de la génération Nightly est mise à jour dans les
sources. On peut trouver ce fichier dans le répertoire principal des sources de Code::Blocks.
Quand on génère sous Linux, les étapes suivantes sont nécessaires. Dans cet exemple nous
supposons que vous êtes dans le répertoire source de Code::Blocks. Sous Linux, la variable
d’environnement PKG_CONFIG_PATH doit être configurée. Le répertoire <prefix> doit
contenir le fichier codeblocks.pc.
PKG_CONFIG_PATH=$PKG_CONFIG_PATH:<prefix>
sh update_revsion.sh
./bootstrap
./configure --with-contrib=[all | noms des plugins separes par des virgules]
--prefix=<install-dir>
make
make install (en tant que root)
Vous pouvez aussi générer sous Linux comme sous Windows, avec un fichier workspace.
Toutefois, pkg config et wx-config doivent être correctement configurés.
6.2.7.1 Windows
<cbDir>/codeblocks/src
Variable wx
Pour la variable wx, entrer dans base le répertoire source de wx : par ex.
C:\wxWidgets-2.8.12
ou pour générer avec une version plus récente, wx31 (ou wx31 64)
C:\wxWidgets-3.1.4
Code::Blocks 147
Code::Blocks V2.0.1 beta 6.2 Windows ou Linux
gcc_<VENDOR>.dll
6.2.7.2 Linux
Code::Blocks 148
URL catalog
[,→7Z] 7z zip homepage.
http://www.7-zip.org
[,→ZIP] Info-zip Ftp page.
ftp://ftp.info-zip.org/pub/infozip/win32/
[,→SourceForgeCB] Codeblocks at Sourceforge.
https://sourceforge.net/p/codeblocks/code/log/
[,→SourceForgeCBSrc] Trunk SVN C::B Source on Sourceforge.
https://sourceforge.net/p/codeblocks/code/HEAD/tree/trunk/
[,→FORUM] Codeblocks forum.
http://forums.codeblocks.org/
[,→WIKI] Codeblocks wiki.
http://wiki.codeblocks.org/index.php/Main_Page
[,→CODEBLOCKS] Codeblocks homepage.
http://www.codeblocks.org/
[,→GCC] GCC home page.
http://gcc.gnu.org/
[,→MinGW] MinGW original page.
http://www.mingw.org/
[,→MinGW64] MinGW64 files page.
https://sourceforge.net/projects/mingw-w64/files/
[,→MinGW64-Ray-Linn] MinGW64 Ray Linn Personal page.
https://sourceforge.net/projects/mingw-w64/files/Multilib%20Toolchains%
28Targetting%20Win32%20and%20Win64%29/ray_linn/gcc-9.x-with-ada/
[,→MinGW64-Equation] MinGW64 Equation files page.
http://www.equation.com/servlet/equation.cmd?fa=fortran
[,→MinGW64-LHMouse] MinGW64 LHMouse files page.
https://gcc-mcf.lhmouse.com/
[,→MinGW64-WinLibs] MinGW64 WinLibs page.
http://winlibs.com/
[,→MSys2] Msys2 home page.
http://www.msys2.org/
[,→MSys2-MinGW64-Toolchain] Msys2 Toolchain for MinGW64.
https://packages.msys2.org/group/mingw-w64-x86_64-toolchain
[,→UnxUtils] Unix Like Utilities files page.
https://sourceforge.net/projects/unxutils/
[,→GnuWin32] An other Unix Like Utilities files page.
https://sourceforge.net/projects/gnuwin32/
Code::Blocks V2.0.1 beta URL catalog
Code::Blocks 150