Manual Codeblocks FR PDF

Code::Blocks
Manuel Utilisateur
Version 1.1
Merci a lequipe CodeBlocks:
Anders F. Bjorklund (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)
Il est permis de copier, distribuer et/ou modifier ce document dans le respect de la licence
GNU Free Documentation, Version 1.2 ou tout autre version posterieure publiee par la
Free Software Foundation.
Traduction de la version originale anglaise par Gerard Durand (gd on).
1 Gestion de Projet CodeBlocks
Les instructions du chapitre 3 a la page 58 et du chapitre 4 a la page 68 sont les documen-
tations officielles du site Wiki de CodeBlocks ou elles ne sont disponibles quen anglais.
Note:
Remarque du traducteur : Les references aux menus sont traduites
en francais. Cela suppose donc que vous avez installe la francisation
de linterface de CodeBlocks que vous pouvez obtenir, notamment via
le forum, dans la rubrique CodeBlocks Translation. Ne plus utiliser
celle du site LaunchPad bien trop ancienne et largement depassee. Les
images ci-dessous sont celles de la documentation originale, en anglais
Lillustration ci-dessous montre lapparence de la fenetre de linterface utilisateur de Code-

Blocks.
Figure 1.1: Environnement de developpement Integre (IDE) de CodeBlocks
Gestion Cette fenetre contient linterface Projets qui dans le texte suivant sera referencee
comme vue du projet. Cette vue affiche tous les projets ouverts dans CodeBlocks a
Code::Blocks V1.1
un instant donne. Longlet Symboles de la fenetre Gestion affiche les symboles, les
variables etc.
Editeur Dans lillustration ci-dessus, un fichier source nomme hello.c est ouvert avec
colorisation de syntaxe dans lediteur.
Liste des fichiers ouverts affiche une liste de tous les fichiers ouverts dans lediteur, dans
cet exemple : hello.c.
CodeSnippets peut etre affiche via le menu Vue CodeSnippets . Ici vous pouvez
gerer des modules de texte, des liens vers des fichiers et des liens vers des urls.
Journaux & autres . Cette fenetre est utilisee pour sortir des resultats de recherche, des
messages envoyes par un compilateur etc..
La barre detat donne un apercu des parametrages suivants :
Chemin absolu dun fichier ouvert dans lediteur.
Lediteur utilise lencodage par defaut de votre systeme dexploitation. Cette con-
figuration sera affichee par default.
Numeros de ligne et de colonne de la position actuelle du curseur dans lediteur.
Le mode de configuration du clavier pour inserer du texte (Insertion ou Remplace-
ment).
Etat actuel du fichier. Un fichier modifie sera marque comme Modifie sinon cette
case reste vide.
Autorisation dun fichier. Un fichier qui est en lecture seule sera affiche Lecture seule
dans la barre detat. Dans la fenetre Ouvrir la liste de fichiers ces fichiers seront
identifies par une icone de verrouillage superposee.
Note:
Dans lediteur courant, lutilisateur peut choisir les proprietes du
menu de contexte. Dans le dialogue apparaissant dans longlet
General , loption Le fichier est en lecture seule peut etre
selectionnee. Cette option marquera le fichier correspondant comme
etant en lecture seule pour CodeBlocks, mais les attributs en lecture
et ecriture du fichier original ne seront pas modifies dans le systeme
de fichiers.
Si vous demarrez CodeBlocks en ligne de commande avec --personality=<profile>
la barre detat affichera le profil utilisateur courant, sinon default sera affiche. Les
parametres de CodeBlocks sont enregistres dans le fichier de configuration corre-
spondant <personality>.conf.
CodeBlocks offre une gestion des projets tres flexible et tres comprehensible. Le texte
suivant ne montre que quelques aspects de la gestion de projets.
Codeblocks 2
Code::Blocks V1.1 1.1 Vue du projet
1.1 Vue du projet

Dans CodeBlocks, les sources et les parametres dun processus de generation sont stockes
dans un fichier projet <name>.cbp. Les sources en C/C++ et les fichiers dentetes corre-
spondants (ou headers) sont les composants typiques dun projet. La facon la plus simple
de creer un projet est de passer par la commande Fichier Projet et de choisir un
assistant. Vous pouvez alors ajouter des fichiers au projet via le menu de contexte Ajouter
des fichiers de la fenetre de gestion.
CodeBlocks gere les fichiers de projets en categories qui dependent de lextension des
fichiers. Les categories suivantes sont predefinies :
Sources contient les fichiers sources dont lextension est *.c;*.cpp;.
ASM Sources contient les fichiers sources dont lextension est *.s;*.S;*.ss;*.asm.
Headers contient, entre autres, les fichiers dont lextension est *.h;.
Ressources contient les fichiers pour parametrer laspect des fenetres des wxWidgets
avec les extensions *.res;*.xrc;. Ces types de fichiers sont affiches dans longlet
Ressources de la fenetre de Gestion.
Les parametres des types et categories de fichiers peuvent etre ajustes via le menu de con-
texte Arbre des projets Editer les types et categories de fichiers . Ici, vous pouvez
definir aussi des categories personnalisees pour les extensions de votre choix. Par exem-
ple, si vous souhaitez lister des scripts dedition de liens avec lextension *.ld dans une
categorie nommee Linkerscript, vous navez qua creer une nouvelle categorie.
Note:
Si vous desactivez Arbre des projets Categoriser par type de
fichiers dans le menu de contexte, laffichage par categories sera
masque, et les fichiers seront listes comme ils sont stockes dans le
systeme de fichiers.
1.2 Notes pour les Projets

Dans CodeBlocks, ce quon appelle des notes peuvent etre stockees dans un projet. Ces
notes peuvent contenir de breves descriptions ou des points particuliers pour le projet cor-
respondant. En affichant ces informations a louverture dun projet, les autres utilisateurs
peuvent avoir un rapide apercu de lavancement du projet. Laffichage des notes peut etre
valide ou invalide via longlet Notes des Proprietes dun projet.
1.3 Modele de Projet

CodeBlocks est fourni avec tout un ensemble de modeles de projets qui sont affiches quand
on cree un nouveau projet. Cependant, vous pouvez aussi enregistrer des modeles person-
nalises pour y sauvegarder vos propres specifications doptions de compilation, les optimi-
sations a utiliser, les options specifiques aux machines etc. Ces modeles seront enregistres
Codeblocks 3
Code::Blocks V1.1 1.4 Creer des Projets a partir de Cibles de Generation
dans le repertoire Documents and Settings\<user>\Application Data\codeblocks\UserTemplate

Si les modeles doivent pouvoir etre ouverts par tous les utilisateurs, ils devront etre copies
dans un repertoire correspondant de linstallation de CodeBlocks. Ces modeles seront
alors affiches lors du demarrage suivant de CodeBlocks dans Nouveau Projet
Modeles utilisateur .
Note:
Les modeles disponibles dans lassistant Projet peuvent etre edites en
les selectionnant via un clic droit.
1.4 Creer des Projets a partir de Cibles de Generation

Dans les projets, il est necessaire davoir a disposition differentes variantes de projets. On
appelle ces variantes Cibles de Generation. Elles different par leurs options de compilation,
les informations de debogage et/ou le choix des fichiers. Une cible de generation peut aussi
etre externalisee dans un projet separe. Pour ce faire, cliquer sur Projet Proprietes
puis selectionner la variante dans longlet Generer les cibles et cliquer sur le bouton
Creer un projet a partir dune cible (voir Figure 1.2 a la page 4).
Figure 1.2: Cibles de Generation
1.5 Cibles Virtuelles

Les projets peuvent etre egalement structures dans CodeBlocks en ce quon appelle des
cibles virtuelles. Une structure frequemment utilisee de projet consiste en deux cibles de
generation, la premiere cible Debug qui contient des informations pour le debogage et la
Codeblocks 4
Code::Blocks V1.1 1.6 Etapes Pre- et Post Generation
seconde cible Release sans ces informations. En ajoutant Cibles Virtuelles via Projet
Proprietes Cibles de generation on peut combiner des cibles de generation indi-
viduelles. Par exemple, une Cible Virtuelle All peut creer les cibles Debug et Release
simultanement. Les cibles virtuelles sont affichees dans la barre de symboles du compila-
teur dans Generer les cibles.
1.6 Etapes Pre- et Post Generation

Dans CodeBlocks on peut effectuer des operations complementaires avant et apres la
compilation dun projet. Ces operations sont appelees etapes de Pre generation ou Post
generation. Des Post generations typiques sont :
Creation dun format Intel Hexformat a partir un objet termine
Manipulation dobjets par objcopy
Generer des fichiers de dump par objdump
Exemple
Creer le desassemblage dun objet sous Windows. Le transfert vers un fichier necessite
lappel a cmd avec loption /c.
cmd /c objdump -D name.elf > name.dis
Un autre exemple de Post generation peut etre larchivage dun projet. Pour cela, creez
une cible de generation Archive et incluez les instructions suivantes dans letape de post
generation :
zip -j9 $(PROJECT_NAME)_$(TODAY).zip src h obj $(PROJECT_NAME).cbp
Avec cette commande, le projet actif et ses sources, entetes et objets seront compresses
en tant que fichier zip. En faisant ainsi, les variables integrees $(PROJECT_NAME) et
$(TODAY), le nom du projet et la date courante seront extraites (voir section 3.2 a la
page 59). Apres lexecution de la cible Archive, le fichier compresse sera stocke dans le
repertoire du projet.
Dans le repertoire share/codeblocks/scripts vous trouverez quelques exemples de
scripts. Vous pouvez ajouter un script via le menu Parametres Edition de scripts
et lenregistrer dans un menu. Si vous executez par exemple le script make dist depuis le
menu, alors tous les fichiers appartenant a un projet seront compresses dans une archive
<project>.tar.gz.
1.7 Ajouter des Scripts a des Cibles de Generation

CodeBlocks offre la possibilite dutiliser des actions de menus dans les scripts. Le script
represente un autre degre de liberte pour controler la generation de votre projet.
Note:
Un script peut egalement etre inclus dans une Cible de Generation.
Codeblocks 5
Code::Blocks V1.1 1.8 Espace de travail et Dependances de Projet
1.8 Espace de travail et Dependances de Projet

Des projets multiples peuvent etre ouverts dans CodeBlocks. En enregistrant les projets
ouverts via Fichier Enregistrer lespace de travail vous pouvez les rassembler dans
un seul espace de travail sous <name>.workspace. Si vous ouvrez <name>.workspace
au demarrage suivant de CodeBlocks, tous les projets seront de nouveau affiches.
Les logiciels complexes sont un assemblage de composants qui sont geres dans differents
projets CodeBlocks. De plus, lors de la generation de tels logiciels, il y a souvent des
dependances entre ces projets.
Exemple
Un projet A contient des fonctions de base qui sont rendues disponibles aux autres projets
sous forme dune librairie. Maintenant, si les sources de ce projet sont modifiees, alors la
librairie doit etre re-generee. Afin de maintenir la consistance entre un projet B qui utilise
ces fonctions et le projet A qui les implemente, le projet B doit dependre du projet A.
Les informations necessaires aux dependances des projets sont enregistrees dans lespace
de travail adequat, ainsi chaque projet peut etre genere separement. Lutilisation des
dependances rend egalement possible le controle de lordre dans lequel sont generes les
projets. Les dependances de projets peuvent etre configurees en selectionnant le menu
Projet Proprietes puis en cliquant sur le bouton Dependances du projet.
1.9 Inclure des Fichiers en Assembleur

Dans la fenetre Gestion dune vue de projet, les fichiers en Assembleur sont affiches dans la
categorie ASM Sources. Lutilisateur peut changer la liste des fichiers dans les categories
(voir section 1.1 a la page 3). Un clic droit sur un des fichiers assembleur listes ouvrira un
menu de contexte. Selectionner Proprietes pour ouvrir une nouvelle fenetre. Selectionnez
maintenant longlet Generer et activez les deux champs Compiler le fichier and Edition
de liens du fichier. Selectionnez ensuite longlet Avance et executez les etapes suivantes
:
1. Configurer Variable de compilation a CC
2. Selectionner le compilateur dans Pour ce compilateur
3. Selectionner Utiliser des commandes personnalisees pour generer ce fichier
4. Dans la fenetre, entrez :
$compiler $options $includes <asopts> -c $file -o $object
Les variables de CodeBlocks sont identifiees par un $ (voir section 3.4 a la page 63).
Elles sont automatiquement configurees, ainsi vous navez a remplacer que loption de
lassembleur <asopt> par vos propres configurations.
Codeblocks 6
Code::Blocks V1.1 1.10 Editeur et Outils
1.10 Editeur et Outils

1.10.1 Code par Defaut
Les regles de codage dans une compagnie imposent davoir un modele standard. Avec
CodeBlocks, il est possible dinclure un contenu predefini automatiquement en debut de
fichier lors de la creations dune nouvelle source C/C++ ou dentetes (headers). Le con-
tenu predefini est denomme code par defaut. Cette configuration peut etre selectionnee
dans Parametres Editeur Code par Defaut. Si vous creez un nouveau fichier alors
une expansion des variables macro, notamment celles de Parametres Variables Glob-
ales , est effectuee. Un nouveau fichier peut etre cree via le menu Fichier Nouveau
Fichier .
Exemple
/*************************************************************************
* Project: $(project)
* Function:
*************************************************************************
* $Author: mario $
* $Name: $
*************************************************************************
*
* Copyright 2007 by company name
*
************************************************************************/
1.10.2 Abreviations
Pas mal de frappes au clavier peuvent etre economisees dans CodeBlocks en definissant
des abreviations. Ceci peut sobtenir en selectionnant Parametres Editeur et en
definissant les abreviations par un nom <name>, qui peut alors etre appele par un rac-
courci clavier Ctrl-J (voir Figure 1.3 a la page 8).
On peut egalement les parametrer en incluant des variables $(NAME) dans les abreviations.
#ifndef $(Guard token)
#define $(Guard token)
#endif // $(Guard token)
Quand on utilise labreviation <name> dans un texte source et quon utilise Ctrl-J, le
contenu de la variable est recupere puis inclus.
1.10.3 Personnalites
Les configurations de CodeBlocks sont enregistrees en tant que donnees dapplication dans
un fichier denomme <user>.conf dans le repertoire de codeblocks. Ce fichier de con-
figuration contient des informations telles que les derniers projets ouverts, le parametrage
de lediteur, laffichage des barres de symboles etc. Par defaut, la personnalite default est
utilisee et sa configuration sauvegardee dans un fichier default.conf. Si CodeBlocks est
lance en ligne de commande avec le parametre --personality=myuser, le parametrage
Codeblocks 7
Figure 1.3: Definition des abreviations
sera enregistre dans un fichier myuser.conf. Si le profil nexiste pas deja, il sera au-
tomatiquement cree. Cette procedure rend possible la creation de differents profils pour
differentes etapes de travail. Si vous lancez CodeBlocks en ligne de commande avec le
parametre additionnel --personality=ask, une bote de selection sera affichee avec tous
les profils disponibles.
Note:
Le nom du profil/personnalite courant est affiche dans le coin a droite
de la barre detat.
1.10.4 Fichiers de Configuration

Les parametres de CodeBlocks sont enregistres dans le fichier de profil default.conf
dans le repertoire codeblocks de votre Application Data. Quand vous utilisez des per-
sonnalites (ou profils) (voir sous-section 1.10.3 a la page 7), les details de configuration
sont enregistres dans un fichier <personality>.conf.
Loutil cb share conf, quon trouve dans le repertoire dinstallation de CodeBlocks, est
utilise pour gerer et enregistrer ces parametrages.
Si vous souhaitez definir des parametres standard pour plusieurs utilisateurs de lordinateur,
le fichier de configuration default.conf doit etre enregistre dans le repertoire \Documents
and Settings\Default User\Application Data\codeblocks. Lors du premier demarrage,
Codeblocks 8
CodeBlocks copiera les valeurs par defaut depuis Default User vers le repertoire Appli-
cation data de lutilisateur courant.
Pour creer une version portable de CodeBlocks sur cle USB, procedez comme suit. Copiez
le repertoire dinstallation de CodeBlocks vers la cle USB et stockez le fichier de configura-
tion default.conf dans ce repertoire. Cette configuration servira de parametrage global.
Faites attention au fait que ce fichier soit accessible en ecriture, sinon les changements de
configuration ne pourront y etre enregistres.
1.10.5 Navigation et Recherche

Dans CodeBlocks il y a plusieurs facons de naviguer rapidement entre les fichiers et les
fonctions. Une procedure typique est la configuration de marques de recherche. Via le
raccourci clavier Ctrl-B une marque est posee ou supprimee dans un fichier source. Via
Alt-PgUp vous pouvez aller a la marque precedente, et via Alt-PgDn vous pouvez aller a
la marque suivante.
Si vous selectionnez lespace de travail ou un projet particulier de lespace de travail
dans la vue du projet vous pouvez rechercher un fichier dans le projet. Selectionnez tout
simplement Rechercher le fichier depuis le menu de contexte, puis tapez le nom du fichier
et le fichier sera selectionne. Si vous tapez sur la touche Entree, ce fichier sera ouvert dans
lediteur (voir Figure 1.4 a la page 9).
Figure 1.4: Recherche de fichiers
Dans CodeBlocks vous pouvez facilement naviguer entre les Entetes/Sources en :

1. Positionnant le curseur a lendroit ou le fichier dentete (header) est inclus puis
ouvrir ce fichier via le menu de contexte Ouvrir le fichier inclus (voir Figure 1.5 a
la page 10)
2. Basculer du fichier dentete au fichier source via le menu de contexte Basculer en-
tete/source
3. Selectionner par exemple un define dans lediteur et choisir Trouver la declaration
depuis le menu de contexte pour ouvrir le fichier contenant cette declaration.
Codeblocks 9
Figure 1.5: Ouverture dun fichier den-tetes
CodeBlocks offre plusieurs possibilites de recherches dans un fichier ou un repertoire.

La bote de dialogue de recherche souvre par Chercher Rechercher (Ctrl-F) ou
Rechercher dans les fichiers (Ctrl-Shift-F).
Alt-G et Ctrl-Alt-G sont dautres fonctions utiles. Le dialogue qui souvrira en utilisant
ces raccourcis vous permet de choisir des fichiers/fonctions et aller vous positionner a
limplementation de la fonction selectionnee (voir Figure 1.6 a la page 10) ou bien ouvrir
le fichier selectionne dans lediteur. Vous pouvez utiliser dans le dialogue des jokers comme
ou ? etc. pour y obtenir une recherche incrementale.
Figure 1.6: Recherche de fonctions
Note:
Avec le raccourci Ctrl-PgUp vous pouvez aller a la fonction
precedente, et via Ctrl-PgDn vous pouvez aller a la fonction suivante.
Dans lediteur, vous pouvez ouvrir un nouveau dialogue Ouvrir des fichiers Ctrl-Tab et
vous pouvez passer de lun a lautre via la liste affichee. Si vous appuyez sur la touche
Ctrl, alors un fichier peut etre selectionne de differentes facons :
Codeblocks 10
1. Si vous selectionnez une entree avec le bouton gauche de la souris, le fichier selectionne
sera ouvert.
2. Si vous appuyez sur la touche Tab vous passez de lune a lautre des entrees listees.
En relachant la touche Ctrl le fichier selectionne sera ouvert.
3. Si vous deplacez la souris au-dessus des entrees listees, alors la selection courante
sera surlignee. En relachant la touche Ctrl le fichier selectionne sera ouvert..
4. Si le pointeur de souris est en dehors de la selection surlignee, vous pouvez utiliser
la molette de la souris pour basculer entre les entrees. En relachant la touche Ctrl
le fichier selectionne sera ouvert.
Une facon commune de developper du logiciel est de jongler avec un ensemble de fonctions
implementees dans differents fichiers. Lextension Browse Tracker vous aidera a resoudre
cette tache en vous montrant dans quel ordre ont ete selectionnes les fichiers. Vous pouvez
alors naviguer aisement entre les appels de fonctions (voir section 2.8 a la page 42).
Laffichage des numeros de lignes dans CodeBlocks peut sactiver via Parametres Editeur
Parametres generaux a laide du champ Afficher les numeros de ligne. Le raccourci
Ctrl-G ou la commande de menu Rechercher Aller a la ligne vous aidera a atteindre
la ligne desiree.
Note:
Si vous maintenez la touche Ctrl enfoncee en selectionnant du texte
dans lediteur de CodeBlocks vous pouvez lancer une recherche Inter-
net, notamment avec Google, via le menu de contexte.
1.10.6 Vue des Symboles

La fenetre Gestion de CodeBlocks offre une vue arborescente des symboles des sources
en C/C++ pour naviguer dans les fonctions et les variables. Dans ce type de vue, vous
pouvez travailler sur le fichier courant, le projet courant ou tout lespace de travail.
Note:
Entrer un terme a chercher ou des noms de symboles dans le masque
dentree Rechercher du navigateur de Symboles permet dobtenir
une vue filtree des symboles si concordance il y a.
Les categories suivantes existent pour les symboles :

Fonctions Globales Liste limplementation des fonctions globales.
typedefs globales Liste lutilisation des definitions typedef.
Variables globales Affiche les symboles de variables globales.
Symboles du pre-processeur Liste les directives du pre-processeur creees par #define.
Macros globales Liste les macros des directives du pre-processeur
Codeblocks 11
Figure 1.7: Vue des symboles
Les structures et classes sont affichees par le menu arbre du bas et lordre de tri peut etre
modifie via le menu de contexte. Si une categorie est selectionnee a la souris, les symboles
trouves seront affiches dans la partie basse de la fenetre (voir Figure 1.7 a la page 12).
Double-cliquer sur un symbole ouvrira le fichier ou il est defini ou bien la fonction ou elle
est implementee, puis on se positionnera sur la ligne correspondante. Un rafrachissement
automatique du navigateur de symboles, sans avoir a sauvegarder de fichier, peut etre
active par le menu Parametres Editeur Code Completion (voir Figure 1.8 a la
page 13). Les performances de CodeBlocks seront affectees dans les projets comportant
de nombreux symboles.
Note:
Dans lediteur, une liste de classes peut etre affichee via les menus de
contexte Inserer methode de classe ou Toutes methodes de classes
sans implementation .
Codeblocks 12
Figure 1.8: Activation de lanalyse en temps reel
1.10.7 Inclure des fichiers daide externes

Lenvironnement de developpement CodeBlocks supporte linclusion de fichiers daide
externes via le menu Parametres Environnement . Inserez le manuel au format chm
de votre choix dans la selection Fichiers daide , selectionnez Ceci est le fichier dAide
par defaut (voir Figure 1.9 a la page 13). Lentree $(keyword) est un substituant pour une
selection particuliere dans votre editeur. Vous pouvez alors selectionner une fonction dans
un fichier ouvert de CodeBlocks par un simple clic, et la documentation correspondante
saffichera lorsque vous appuierez sur F1.
Si vous avez inclus plusieurs fichiers daide, vous pouvez choisir un terme particulier dans
lediteur, puis choisir le fichier daide dans le menu de contexte Chercher dans pour que
CodeBlocks ly recherche.
Figure 1.9: Configuration des fichiers daide
Dans CodeBlocks vous pouvez egalement ajouter un support de pages man. Ajouter seule-
ment une entree man et specifiez les chemins comme suit (NdT ici pour Linux!).
man:/usr/share/man
CodeBlocks fourni un Visualiseur HTML integre, qui peut etre utilise pour afficher un
simple fichier html et y rechercher des mots cles. Configurez simplement le chemin du
Codeblocks 13
Code::Blocks V1.1 1.11 Astuces pour travailler avec CodeBlocks
fichier html qui doit etre analyse et cochez la case Ouvrir ce fichier avec le visualiseur
daide integre via le menu Parametres Environnement Fichiers daide .
Figure 1.10: Visualiseur HTML integre
Note:
Si vous selectionnez un fichier html par double clic dans lexplorateur
(voir section 2.7 a la page 38) alors le visualiseur html integre sera
demarre, du moins si aucune association vers les fichiers html nest
faite par le gestionnaire dextensions de fichiers.
1.10.8 Inclure des outils externes

Linclusion doutils externes dans CodeBlocks est faisable via Outils Configurer les
outils Ajouter . Les variables internes (voir section 3.2 a la page 59) peuvent aussi
etre utilisees comme parametres des outils. Dautre part, il y a plusieurs sortes doptions
de lancement pour demarrer des applications externes. En fonction des options, les appli-
cations externes peuvent sarreter quand on quitte CodeBlocks. Si les applications doivent
rester ouvertes apres quon ait quitte CodeBlocks, loption Lancer loutil visible en mode
detache doit etre cochee.
1.11 Astuces pour travailler avec CodeBlocks

Dans ce chapitre nous presenterons quelques parametrages utiles dans CodeBlocks.
1.11.1 Recherche de Modifications

CodeBlocks fourni une fonctionnalite pour pister les modifications effectuees dans un
fichier source et affiche une barre dans la marge la ou ont eut lieu les changements. Les
Codeblocks 14
modifications sont marquees par une barre de changements jaune alors que celles qui ont
deja ete enregistrees sont marquees par une barre de changements verte (voir Figure 1.11
a la page 15). Vous pouvez naviguer dans vos changements a laide du menu Rechercher
Aller a la ligne changee suivante ou encore Rechercher Aller a la ligne changee
precedente . La meme fonctionnalite est accessible via les raccourcis clavier Ctrl-F3 et
Ctrl-Shift-F3.
Figure 1.11: Recherche de modifications
Cette fonctionnalite peut etre activee ou desactivee via la case a cocher Utiliser la barre
de changements dans le menu Parametres Editeur Marges et tirets .
Note:
Si un fichier modifie est ferme, alors lhistorique des changements tels
que defaire/refaire ainsi que la barre de changements sont perdus. A
laide du menu Edition Effacer lhistorique des changements ou
le menu de contexte correspondant vous pouvez effacer cet historique
meme si le fichier reste ouvert.
1.11.2 Echange de donnees avec dautres applications

Les echanges de donnees entre CodeBlocks et dautres applications sont possibles. Pour
cela on utilise, avec Windows, le processus de communication inter processus DDE (Dy-
namic Data Exchange) et, avec les autres systemes dexploitation, une communication
basee sur le protocole TCP.
Avec cette interface, differentes commandes peuvent etre envoyees vers une instance de
CodeBlocks en suivant la syntaxe suivante.
[<command>("<parameter>")]
Les commandes suivantes sont actuellement disponibles :

Open La commande
[Open("d:\temp\test.txt")]
utilise un parametre, dans notre cas cest le nom dun fichier avec
son chemin en absolu, et il souvre dans une instance existante de
CodeBlocks ou bien, si necessaire, une premiere instance demarre.
Codeblocks 15
OpenLine Cette commande ouvre un fichier dans une instance de CodeBlocks et

se positionne sur la ligne dont le numero est entre. Le numero de ligne
est specifie par : ligne .
[OpenLine("d:\temp\test.txt:10")]
Raise Donne le focus a linstance de CodeBlocks. Aucun parametre ne doit

etre entre.
1.11.3 Configurer les variables denvironnement

La configuration dun systeme dexploitation se fait par ce quon appelle les variables
denvironnement. Par exemple, la variable denvironnement PATH contient le chemin
dun compilateur installe. Le systeme dexploitation analysera cette variable dans lordre
decriture, cest a dire que les entrees de la fin seront utilisees en dernier dans les recherches.
Si plusieurs versions de compilateur ou dautres applications sont installees, les situations
suivantes peuvent se produire :
On appelle une version incorrecte dun logiciel
Les logiciels installes sappellent entre eux
Ainsi, on peut tomber sur le cas ou differentes versions dun compilateur ou dun autre
outil sont obligatoires pour differents projets. Lorsque cela arrive, une premiere solution
est de changer les variables denvironnement dans le systeme dexploitation pour chaque
projet. Toutefois cette procedure est sujette a erreur et manque de flexibilite. Pour ce faire,
CodeBlocks offre une solution elegante. Differentes configurations de variables peuvent
etre creees pour un usage uniquement en interne a CodeBlocks. De plus, vous pouvez
passer de lune a lautre de ces configurations. La Figure 1.12 a la page 17 montre la
bote de dialogue que vous obtenez via Variables dEnvironnement dans Parametres
Environnement . On cree une configuration a laide du bouton Creer.
Lacces et letendue des variables denvironnement ainsi creees sont limites a CodeBlocks.
Vous pouvez etendre ces variables denvironnement comme toutes les autres variables dans
CodeBlocks a laide de $(NAME).
Note:
La configuration dune variable denvironnement pour chaque pro-
jet peut etre selectionnee dans le menu de contexte Proprietes de
longlet Options EnvVars.
Exemple
Vous pouvez ecrire dans un fichier <project>.env lenvironnement utilise dans une etape
de post generation (voir section 1.6 a la page 5) puis larchiver dans votre projet.
cmd /c echo \%PATH\% > project.env
ou sous Linux
echo \$PATH > project.env
Codeblocks 16
Figure 1.12: Variables denvironnement
1.11.4 Basculer entre diverses dispositions

En fonction des taches a effectuer, il peut etre utile davoir plusieurs configurations ou dis-
positions (ou presentations) differentes de CodeBlocks et de les sauvegarder. Par defaut, le
parametrage (notamment afficher/masquer les barres doutils, aspect, etc.) est enregistre
dans le fichier de configuration default.conf. En utilisant loption en ligne de commande
--personality=ask au demarrage de CodeBlocks, on peut choisir parmi plusieurs pos-
sibilites de parametrages. En dehors de ces parametrages globaux, il peut se produire
une situation ou vous souhaitez basculer entre differentes vues de fenetres ou de bar-
res de symboles pendant une session. Ledition de fichier et le debogage de projets sont
deux exemples typiques de telles situations. CodeBlocks offre un mecanisme pour enreg-
istrer et selectionner differentes dispositions afin deviter a lutilisateur davoir a fermer et
ouvrir manuellement et frequemment des fenetres et des barres de symboles. Pour enreg-
istrer une disposition, selectionnez le menu Vue Disposition Enregistrer la dispo-
sition actuelle et entrez un nom dans <nom>. La commande Parametres Editeur
Raccourcis clavier Vue Dispositions <name> permet de definir un rac-
courci clavier pour ce processus. Il est ainsi possible de basculer entre les diverses dispo-
sitions simplement en utilisant ces raccourcis clavier.
Note:
Autre exemple : editer un fichier en mode plein ecran sans barre de
symboles. Vous pouvez creer une disposition comme Plein Ecran et
lui assigner un raccourci specifique.
1.11.5 Basculer entre projets

Si plusieurs projets ou fichiers sont ouverts en meme temps, lutilisateur a besoin dun
moyen pour passer rapidement de lun a lautre. CodeBlocks possede plusieurs raccourcis
Codeblocks 17
pour ce faire.
Alt-F5 Active le projet precedent de la vue des projets.
Alt-F6 Active le projet suivant de la vue des projets.
F11 Dans lediteur, bascule entre un fichier source <name>.cpp et le fichier den-tete
(header) correspondant <name>.h
1.11.6 Configurations etendue des compilateurs

Lors de la generation dun projet, les messages du compilateur sont affiches dans longlet
Messages de generation. Si vous souhaitez recevoir des informations detaillees, laffichage
peut etre etendu. Pour cela, cliquez sur Parametres Compilateur et debogueur puis
selectionnez longlet Autres options dans le menu deroulant.
Figure 1.13: Configurer des informations detaillees
Assurez vous que le compilateur soit correctement selectionne. Loption Ligne de com-
mande complete des Avertissements du compilateur permet de sortir des informations
detaillees. De plus, ces sorties peuvent etre redirigees vers un fichier HTML. Pour cela,
selectionnez Enregistrer le journal de generation dans un fichier HTML en fin de generation.
Dautre part, CodeBlocks peut afficher une barre davancement du processus de generation
dans la fenetre de generation qui peut etre activee en cochant Afficher la barre de pro-
gression de generation.
Codeblocks 18
1.11.7 Zoomer dans lediteur

CodeBlocks possede un editeur tres puissant. Cet editeur vous permet de changer la
taille des caracteres du texte affiche des fichiers ouverts. Si vous avez une souris avec une
molette, vous navez qua appuyer sur la touche Ctrl tout en tournant la molette dans un
sens ou lautre pour agrandir ou reduire la taille du texte.
Note:
Avec le raccourci Ctrl-Numepad-/ ou a laide du menu Edition
Commandes speciales Zoom Remise a 0 vous restaurez
la taille originale du texte courant.
1.11.8 Mode de Repliement

Quand on edite des fichiers de texte, notamment des *.txt, dans CodeBlocks, il peut
etre utile davoir le texte replie, ce qui signifie que les lignes longues seront affichees
sur plusieurs lignes a lecran afin quelles puissent etre correctement editees. La fonc-
tion Repliement peut etre activee dans Parametres Editeur Autres Options
ou en cochant la case Activer le repliement . Les touches Home et Fin position-
nent respectivement le curseur en debut et en fin de ligne repliee. Quand on choisi
Parametres Editeur Autres Options et La touche Home deplace toujours le
curseur en premiere colonne , le curseur sera positionne respectivement en debut ou en
fin de ligne si on appuie sur la touche Home ou Fin. Si on desire placer le curseur au
debut de la premiere ligne du paragraphe en cours, il vous faut utiliser la combinaison de
touches Alt-Home . La meme chose de facon analogue pour Alt-Fin pour positionner
le curseur en fin de la derniere ligne du paragraphe courant.
1.11.9 Selection de modes dans lediteur

CodeBlocks supporte differents modes de selection pour le couper-coller des chanes de
caracteres.
1. Un texte de lediteur actif peut etre selectionne avec le bouton gauche de la souris,
puis on relache ce bouton. Lutilisateur peut se deplacer de haut en bas avec la
molette de la souris. Si on appuie sur le bouton du milieu, le texte precedemment
selectionne sera insere. Cet effet est disponible au niveau dun fichier et peut etre
vu comme un presse papier de fichier.
2. Appuyer sur la touche ALT active ce quon appelle la selection en mode bloc et
un rectangle de selection saffiche a laide du bouton gauche de la souris. Lorsquon
relache la touche Alt cette selection peut etre copiee ou collee. Cette option est
utile si vous voulez selectionner des colonnes, notamment dans un tableau et en
copier-coller le contenu.
3. Dans le menu Parametres Editeur Marges et tirets on peut activer ce
quon appelle des Espaces Virtuels . Ceci active la possibilite davoir une selection
en mode bloc qui peut commencer ou se terminer par une ligne vide.
Codeblocks 19
4. Dans le menu Parametres Editeur Marges et tirets on peut activer les

Selections Multiples . En maintenant enfoncee la touche Ctrl lutilisateur peut
selectionner diverses lignes dans lediteur actif avec le bouton gauche de la souris.
Les selections sont ajoutees dans le presse papier a laide des raccourcis Ctrl-C ou
Ctrl-X. Ctrl-V en inserera le contenu a la position courante du curseur. Une option
complementaire denommee Active lentree clavier (et la suppression) peut etre
activee pour les selections multiples. Cette option est utile si vous voulez ajouter
des directives de pre-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 fenetres de Linux utilisent ALT-
ClicGaucheDeplacer pour deplacer une fenetre, aussi vous devrez
desactiver cette fonctionnalite pour pouvoir selectionner en mode
bloc.
1.11.10 Repliement de code

CodeBlocks supporte ce quon appelle le repliement de code. Avec cette fonctionnalite
vous pouvez replier notamment les fonctions dans lediteur de CodeBlocks. Un point
de repliement est marque dans la marge gauche de lediteur par un signe moins. Dans la
marge, le debut et la fin dun point de repliement sont visibles a laide dune ligne verticale.
Si vous cliquez sur le signe moins avec le bouton gauche de la souris, la portion de code
sera repliee ou depliee. Via le menu Edition Repliement vous pouvez selectionner le
repliement. Dans lediteur, un code replie est vu comme une ligne horizontale continue.
Note:
Le style de repliement et la profondeur limite du repliement peuvent
se configurer dans le menu Parametres Editeur Repliement .
CodeBlocks fournit aussi la fonctionnalite de repliement pour les directives du pre-processeur.

Pour lactiver, selectionnez Replier les commandes du pre-processeur dans lentree Repliement
de Parametres Editeur .
Une autre facon de faire est de definir des points de repliement utilisateurs. Le point de
depart du repliement sentre comme un commentaire suivi dune parenthese ouvrante et
la fin comme un commentaire suivi dune parenthese fermante.
//{
code avec repliement defini par lutilisateur
//}
1.11.11 Auto completion

Lorsque vous ouvrez un projet dans CodeBlocks les Repertoires de recherche de votre
compilateur et de votre projet, les fichiers sources et den-tetes de votre projet sont
analyses. De plus les mots cles de lanalyseur syntaxique correspondant sont analyses
Codeblocks 20
egalement. Les informations issues de lanalyse sont alors utilisees pour la fonctionnalite
dauto completion dans CodeBlocks. Verifiez sil vous plait que cette fonctionnalite est
bien activee dans lediteur. Lauto completion est accessible au travers du raccourci Ctrl-
Espace. Via le menu Parametres Editeur Colorisation syntaxique vous pouvez
ajouter des mots cles definis par lutilisateur a votre analyseur syntaxique.
1.11.12 Recherche de fichiers casses

Lorsquun fichier est supprime du disque, mais est toujours inclus dans un fichier projet
<project>.cbp, alors un fichier casse sera affiche avec un symbole casse dans la vue
du projet. Vous devriez utiliser Enlever ce fichier du projet plutot que de supprimer le
fichier.
Dans de gros projets, avec de nombreux sous-repertoires, la recherche de fichiers casses
peut etre une grande consommatrice de temps. Avec lextension ThreadSearch (voir sec-
tion 2.6 a la page 34) CodeBlocks apporte une solution simple a ce probleme. Si vous
entrez une expression de recherche dans ThreadSearch et selectionnez loption Fichiers
du projet ou Fichiers de lespace de travail , alors ThreadSearch analysera tous les
fichiers qui sont inclus dans le projet ou lespace de travail. Si un fichier casse est trouve,
ThreadSearch generera une erreur sur le fichier absent.
1.11.13 Inclure des librairies

Dans les options de generation dun projet, vous pouvez ajouter les librairies utilisees via
le bouton Ajouter dans lentree Librairies a lier des Options de lediteur de liens. Ce
faisant, vous pouvez soit utiliser le chemin absolu de la librairie ou seulement donner son
nom sans le prefixe lib ni lextension du fichier.
Exemple
Pour une librairie nommee <path>\libs\lib<name>.a, ecrire seulement <name>. Lediteur
de liens avec les chemins de recherche correspondants inclura alors correctement les li-
brairies.
Note:
Une autre facon dinclure des librairies est documentee dans la sec-
tion 2.10 a la page 43.
1.11.14 Ordre dedition de liens des fichiers objets

Lors de la compilation, les fichiers objets name.o sont crees a partir des sources name.c/cpp.
Lediteur de liens assemble les fichiers objets individuels pour en faire une application
name.exe ou sur dautre systemes name.elf. Dans certains cas, il peut etre preferable
de predefinir lordre dans lequel seront lies les fichiers objets. Vous pouvez obtenir cela
dans CodeBlocks en assignant des priorites. Dans le menu de contexte Proprietes , vous
pouvez definir les priorites dun fichier dans longlet Generer. Une priorite faible fera que
le fichier sera lie plus tot.
Codeblocks 21
Code::Blocks V1.1 1.12 CodeBlocks en ligne de commande
1.11.15 Sauvegarde automatique

CodeBlocks offre la possibilite denregistrer automatiquement les projets et les fichiers
sources, ou encore de creer des copies de sauvegarde. Cette fonctionnalite peut etre ac-
tivee dans le menu Parametres Environnement Sauvegarde-auto . Ce faisant,
Enregistrer dans un fichier .save doit etre specifie comme methode de creation de copie
de sauvegarde.
1.11.16 Configuration des extensions de fichiers

Dans CodeBlocks, vous pouvez choisir entre plusieurs methodes de traitement des exten-
sions de fichiers. La bote de dialogue de configuration souvre par Parametres Gestion
des extensions de fichiers . Vous pouvez alors soit utiliser les applications assignees par
Windows pour chaque extension de fichier (louvrir avec lapplication associee), ou changer
la configuration pour chaque extension de telle facon que ce soit un programme defini par
lutilisateur qui soit lance (lancer un programme externe), ou que ce soit CodeBlocks qui
ouvre le fichier dans son editeur (louvrir dans lediteur de Code::Blocks).
Note:
Si un programme utilisateur est associe a une certaine extension
de fichier, la configuration Desactiver Code::Blocks quand un pro-
gramme externe est lance devrait etre desactivee, sinon CodeBlocks
sera ferme des quun fichier qui possede cette extension est ouvert.
1.12 CodeBlocks en ligne de commande

LEnvironnement de Developpement Integre (IDE) CodeBlocks peut etre execute depuis
une ligne de commande sans interface graphique. Dans ce cas, plusieurs options sont
disponibles pour controler le processus de generation dun projet. Comme CodeBlocks
peut etre pilote par des scripts, la creation dexecutables peut etre integree dans vos
propres processus de travail.
codeblocks.exe /na /nd --no-splash-screen --built <name>.cbp --target=Release
<filename> Specifie le nom du fichier de projet *.cbp ou le nom de lespace de tra-

vail *.workspace. Par exemple, <filename> peut etre project.cbp.
Placez cet argument en fin de ligne de commande, juste avant la redi-
rection de la sortie, sil y en a une.
--file=<filename>[:ligne]
Ouvrir un fichier dans Code::Blocks et, en option, se positionner sur
une ligne particuliere.
/h, --help Affiche un message daide concernant les arguments en ligne de com-
mande.
/na, --no-check-associations
Ne faire aucun controle dassociation de fichiers (Windows seulement).
/nd, --no-dde Ne pas lancer le serveur DDE (Windows seulement).
Codeblocks 22
Code::Blocks V1.1 1.13 Raccourcis
/ni, --no-ipc Ne pas lancer le serveur IPC (Linux et Mac seulement).

/ns, --no-splash-screen
Ne pas afficher lecran de demarrage pendant le chargement de lapplication.
/d, --debug-log
Afficher le journal de debogage de lapplication.
--prefix=<str>
Configure le prefixe du repertoire de donnees partagees.
/p, --personality=<str>, --profile=<str>
Configure le profil (ou personnalite) a utiliser. Vous pouvez utiliser le
parametre ask pour afficher la liste de tous les profils disponibles.
--rebuild Nettoie et genere le projet ou lespace de travail.
--build Genere le projet ou lespace de travail.
--target=<str>
Configure la cible de generation. Par exemple --target=Release.
--no-batch-window-close
Garde la fenetre batch de journalisation visible apres que la generation
par batch soit terminee.
--batch-build-notify
Affiche un message une fois que la generation batch est terminee.
--safe-mode Desactive toutes les extensions (plugins) au demarrage.
> <build log file>
Place en toute derniere position dune ligne de commande, ceci permet
a lutilisateur de rediriger la sortie standard vers un fichier log. Ceci
nest pas a proprement parler une option de codeblocks, mais seulement
une redirection standard des sorties des shells DOS/*nix.
1.13 Raccourcis
Meme si une IDE comme CodeBlocks est surtout pilotee a la souris, les raccourcis claviers
sont neanmoins moyen tres pratique pour accelerer et simplifier le travail. Les tableaux
ci-dessous regroupent quelques-uns des raccourcis claviers disponibles.
Codeblocks 23
1.13.1 Editeur
Fonction Raccourci clavier
Defaire la derniere action Ctrl-Z
Refaire la derniere action Ctrl-Shift-Z
Permuter en-tetes / source F11
Commenter le code surligne Ctrl-Shift-C
Decommenter le code surligne Ctrl-Shift-X
Auto-complete / Abreviations Ctrl-Space/Ctrl-J
Bascule la marque Ctrl-B
Aller a la marque precedente Alt-PgUp
Aller a la marque suivante Alt-PgDown
Ceci est une liste des raccourcis fournis pas le composant editeur de CodeBlocks. Ces
raccourcis ne peuvent pas etre substitues.
Creer ou supprimer un signet Ctrl-F2
Aller au signet suivant F2
Selectionner jusquau signet suivant Alt-F2
Rechercher la selection. Ctrl-F3
Rechercher la selection en arriere. Ctrl-Shift-F3
Recherche des conditions concordantes du preprocesseur, passer les imbriquees Ctrl-K
1.13.2 Files
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
1.13.3 Vue
Afficher / masquer le panneau de Messages F2
Afficher / masquer le panneau de Gestion Shift-F2
Activer le precedent (dans larbre des projets) Alt-F5
Activer le suivant (dans larbre des projets) Alt-F6
Codeblocks 24
1.13.4 Recherche
Rechercher Ctrl-F
Rechercher le suivant F3
Rechercher le precedent Shift-F3
Rechercher dans les fichiers Crtl-Shift-F
Remplacer Ctrl-R
Remplacer dans les fichiers Ctrl-Shift-R
Aller a la ligne Ctrl-G
Aller a la ligne changee suivante Ctrl-F3
Aller a la ligne changee precedente Ctrl-Shift-F3
Aller au fichier Alt-G
Aller a la fonction Ctrl-Alt-G
Aller a la fonction precedente Ctrl-PgUp
Aller a la fonction suivante Ctrl-PgDn
Aller a la declaration Ctrl-Shift-.
Aller a limplementation Ctrl-.
Ouvrir le fichier inclus Ctrl-Alt-.
1.13.5 Generer
Generer Ctrl-F9
Compiler le fichier courant Ctrl-Shift-F9
Executer Ctrl-F10
Generer et executer F9
Re-generer Ctrl-F11
Codeblocks 25
2 Extensions
2.1 Astyle
Artistic Style est un indentateur de code source, un formateur de code source, et rend le
code source des langages de programmation C, C++, C# plus beau. On peut lutiliser
pour selectionner differents styles de regles de codage dans CodeBlocks.
Figure 2.1: Formater votre code source
Quand on indente un code source, nous en tant que programmeurs avons tendance a
utiliser a la fois des espaces et des caracteres de tabulations pour creer lindentation
souhaitee. De plus, certains editeurs inserent par defaut des espaces a la place des tab-
ulations quand on appuie sur la touche Tab, alors que dautres editeurs ont la faculte
de rendre les lignes plus belles en ajoutant automatiquement des espaces en debut de
lignes, eventuellement en remplacant dans ce code les tabulations utilisees jusqualors
pour lindentation par des espaces.
Comme le nombre de caracteres affiches sur lecran pour chaque caractere de tabulation
change dun editeur a lautre, un des problemes courants auquel est confronte un pro-
grammeur qui passe dun editeur a un autre est quun code qui contient a la fois des
espaces et des tabulations et qui etait jusqua present bien indente, devient soudain dif-
ficile a regarder apres le changement dediteur. Meme si en tant que programmeur vous
Code::Blocks V1.1 2.2 CodeSnippets
faites attention a nutiliser QUE des espaces ou QUE des tabulations, recuperer un code
de quelquun dautre peut malgre tout etre problematique.
Cest pour resoudre ce probleme quArtistic Style a ete cree - un filtre ecrit en C++ qui
re-indente et reformate automatiquement les fichiers sources en C / C++ / C#.
Note:
Quand vous copiez du code, par exemple depuis Internet ou dun
manuel, ce code sera automatiquement adapte aux regles de codage
dans CodeBlocks.
2.2 CodeSnippets
Lextension CodeSnippets permet de structurer des modules de texte et des liens vers des
fichiers en fonction de categories dans une vue arborescente. Les modules sont utilises
pour stocker des fichiers frequemment utilises, des constructions de modules de texte, le
tout gere depuis un endroit centralise. Imaginez la situation suivante : Un certain nombre
de fichiers source frequemment utilises sont stockes dans divers repertoires du systeme de
fichiers. La fenetre de CodeSnippets vous donne lopportunite de creer des categories et,
a linterieur de ces categories, des liens vers les fichiers requis. Avec cette fonctionnalite,
vous pouvez controler lacces aux fichiers independamment de lendroit ou ils sont stockes
dans le systeme de fichiers, et vous pouvez rapidement naviguer entre ces fichiers sans
avoir besoin de les chercher un peu partout dans le systeme.
Note:
Vous pouvez utiliser les variables CodeBlocks ou les vari-
ables denvironnement dans les liens vers les fichiers comme
$(VARNAME)/name.pdf pour parametrer un lien dans le navigateur de
CodeSnippets.
La liste des modules de texte et des liens peut etre enregistree dans la fenetre des
CodeSnippets en cliquant sur le bouton droit de la souris et en selectionnant Enregistrer
lindex depuis le menu de contexte. Le fichier codesnippets.xml qui est alors cree par
cette procedure, se trouve dans le sous-repertoire codeblocks du repertoire Documents
and Settings\Application data. Sous Linux, cette information est enregistree dans le
sous-repertoire .codeblocks de votre repertoire HOME. Les fichiers de configuration de
CodeBlocks seront charges au demarrage suivant. Si vous souhaitez enregistrer le con-
tenu des CodeSnippets a un autre endroit, selectionnez lentree Enregistrer lindex sous.
Pour charger ce fichier, selectionnez Charger le fichier dindex lors du demarrage suivant
de CodeBlocks ou incluez le repertoire dans les Parametres du menu de contexte de
Repertoire des Snippets. Les parametrages sont enregistres dans le fichier correspondant
codesnippets.ini dans votre application data.
Pour inclure une categorie, utilisez le menu Ajouter une sous-categorie. Une categorie
peut contenir des Snippets (modules de texte) ou des Liens vers un fichier. Un module
de texte est cree via la commande Ajouter un Snippet depuis le menu de contexte. Le
Codeblocks 27
contenu est integre dans le module de texte comme un Nouveau snippet en selectionnant
un passage de texte dans lediteur de CodeBlocks et en le glissant-deposant sur le module
dont les proprietes saffichent. En double cliquant sur la nouvelle entree ou en selectionnant
Editer le Texte on en editera le contenu.
Figure 2.2: Edition dun module de texte
La sortie dun module de texte est geree dans CodeBlocks via la commande Appliquer
du menu de contexte ou en faisant un glisser-deposer dans lediteur. Sous Windows, le
contenu dun Snippet peut egalement etre glisse-depose dans dautres applications. Dans
le navigateur de CodeSnippets vous pouvez copier une selection par glisser-deposer vers
une categorie differente.
De plus, les modules de texte peuvent etre parametres par des variables <name> qui
peuvent etre accedees via $(name) (voir Figure 2.2 a la page 28). Les valeurs des variables
peuvent etre recuperees dans un champ dentree si le module de texte est appele via la
commande du menu de contexte Appliquer.
A cote des modules de texte, des liens vers des fichiers peuvent aussi etre crees. Si, apres
avoir cree un module de texte, vous cliquez sur la commande Proprietes du menu de
contexte, vous pouvez alors selectionner une cible de type lien en cliquant sur le bouton
Lien cible. Cette procedure convertira automatiquement le module de texte en un lien
vers un fichier. Dans CodeSnippets, tous les modules de texte sont marques 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 selectionne (lien) dans la vue des codesnippets, selectionnez tout
simplement le menu de contexte Ouvrir le fichier ou tout en maintenant enfoncee la
touche Alt effectuez un double clic sur le fichier.
Note:
Vous pouvez meme ajouter une url (comme
http://www.codeblocks.org) dans les modules de texte. Lurl
peut etre ouverte en utilisant le menu de contexte Ouvrir lUrl ou
en utilisant un glisser-deposer vers votre navigateur favori.
Avec un tel parametrage, si vous ouvrez un lien vers un fichier pdf depuis la vue des
codesnippets, un visualiseur de fichiers pdf sera automatiquement demarre. Cette methode
rend possible a lutilisateur lacces a des fichiers repartis un peu partout sur le reseau,
comme des donnees, mises en forme, documentations etc., a laide des applications com-
munes, simplement par le biais dun lien. Le contenu des codesnippets est enregistre dans le
Codeblocks 28
fichier codesnippets.xml, la configuration est enregistree dans le fichier codesnippets.ini

de votre repertoire application data. Ce fichier ini contiendra, par exemple, le chemin
du fichier codesnippets.xml.
CodeBlocks supporte lutilisation de differents profils. Ces profils sont aussi nommes per-
sonnalites. En demarrant, avec loption --personality=<profile>, CodeBlocks en ligne
de commande vous creez ou utilisez un profil existant. Dans ce cas, le parametrage ne sera
pas enregistre dans le fichier default.conf, mais plutot dans un <personality>.conf
de votre repertoire application data. Lextension Codesnippets enregistrera alors ses
parametres dans un fichier <personality>.codesnippets.ini. Maintenant, si vous
chargez un nouveau contenu <name.xml> dans les parametres de codesnippets via Charger
un fichier dindex, ce contenu sera enregistre dans le fichier ini correspondant. Lavantage
de cette methode tient dans le fait que dans le cas ou il y a differents profils, on peut
gerer plusieurs configurations de modules de textes et de liens.
Lextension offre une fonction de recherche complementaire pour naviguer dans les categories
et les Snippets. La facon de rechercher dans les Snippets, categories ou Snippets et
categories peut sajuster. En entrant lexpression de recherche requise, lentree correspon-
dante est automatiquement selectionnee dans la vue. La Figure 2.3 a la page 29 affiche
une fenetre CodeSnippets typique.
Figure 2.3: Vue des CodeSnippets
Codeblocks 29
Code::Blocks V1.1 2.3 Recherche Incrementale
Note:
Quand on utilise de volumineux modules de texte, le contenu de ces
modules devrait etre enregistre sous forme de fichiers via Convertir en
lien vers fichier de facon a reduire lutilisation memoire du systeme.
Si vous supprimez un codesnippet ou un lien vers un fichier il est en
fait deplace vers une categorie .trash; si vous maintenez enfoncee la
touche Maj cet element sera reellement detruit.
2.3 Recherche Incrementale

Pour obtenir une recherche efficace dans des fichiers ouverts, CodeBlocks fourni ce quon
nomme une recherche incrementale. Cette methode de recherche sinitialise, pour un fichier
ouvert, via le menu Rechercher Recherche Incrementale ou par le raccourci clavier
Ctrl-I. Lentree active passe alors automatiquement a la configuration du masque de
recherche dans la barre doutil correspondante. Des que vous commencez a entrer des
termes de recherche, le fond du masque de recherche sajuste en fonction des occurrences
des termes. Si un accord est trouve dans lediteur actif, la position respective est marquee
en couleur. Par defaut laccord courant est surligne en vert. Cette configuration peut etre
changee dans Parametres Editeur Recherche Incrementale (voir Figure 2.4 a la
page 31). En appuyant sur la touche Entree la recherche saute a loccurrence suivante de
la chane de texte recherchee a linterieur du fichier. Avec Maj-Entree, cest loccurrence
precedente qui est selectionnee. Cette fonctionnalite nest pas supportee par Scintilla si
la recherche incrementale utilise des expressions regulieres.
Si la chane de caractere recherchee ne peut pas etre trouvee dans le fichier courant, afin
dindiquer que cest ce qui se passe, le fond du masque de recherche est affiche en rouge.
ESC Quitte le module de Recherche Incrementale.
ALT-Suppr Efface lentree du champ de recherche incrementale.
Les icones de la barre doutil de Recherche Incrementale ont les significations suivantes :
Codeblocks 30
Code::Blocks V1.1 2.3 Recherche Incrementale
Figure 2.4: Parametres pour la Recherche Incrementale
Suppression du texte dans le masque de recherche de la barre doutils de Recherche

Incrementale.
, Navigation dans les occurrences de chane recherchee.
En cliquant sur ce bouton ce sont toutes les occurrences de la chane recherchee qui
sont surlignees en couleur, pas seulement la premiere.
Activer cette option reduit le champ de recherche au passage de texte marque dans
lediteur.
Cette option signifie que la recherche sera sensible a la casse (respect des majuscules
et minuscules).
Valider les expressions regulieres dans le champ dentree de la recherche incrementale.
Note:
Le parametrage standard de cette barre doutil peut etre configure
dans Parametres Editeur Recherche Incrementale .
Codeblocks 31
Code::Blocks V1.1 2.4 Liste des a faire
2.4 Liste des a faire

Dans des projets logiciels complexes, ou differents developpeurs sont impliques, il est
souvent necessaire que differentes taches soient effectuees par plusieurs utilisateurs. Pour
cela, CodeBlocks possede une Liste des a faire. Cette liste souvre via Vue Liste
des A faire , et contient les taches a effectuer ensemble, avec leurs priorites, le type et
le responsable de la tache. On peut filtrer la liste par taches, utilisateurs et/ou fichiers
sources. Un tri par colonnes peut etre effectue en cliquant sur le titre de la colonne
correspondante.
Figure 2.5: Affichage de la Liste des A faire
Note:
La liste des a faire peut etre ajoutee a la console de messages.
Selectionnez loption Inclure la liste des A faire dans le panneau
de messages a laide du menu Parametres Environnement .
Si les fichiers sources sont ouverts dans CodeBlocks, un a faire peut etre ajoute a la liste
via la commande Ajouter un element a faire du menu de contexte. Un commentaire
est ajoute dans le code sur la ligne selectionnee.
// TODO (user#1#): ajouter un nouveau dialogue pour la prochaine release
Quand on ajoute un a faire, une bote de dialogue apparat ou les parametrages suivants
peuvent etre faits (voir Figure 2.6 a la page 33).
Utilisateur Nom de lutilisateur <user> pour le systeme dexploitation. Les taches pour
dautres utilisateurs peuvent egalement etre creees ici. Pour cela, le nom de lutilisateur
correspondant doit etre cree par Ajouter un nouvel utilisateur. Lassignation dun
a faire est alors faite via une selection dentrees pour cet utilisateur.
Note:
Notez que les Utilisateurs ici nont rien a voir avec les profils (ou
personnalites) utilises dans CodeBlocks.
Type Par default, le type est TODO (a faire).
Codeblocks 32
Code::Blocks V1.1 2.5 Exporter du code Source
Figure 2.6: Dialogue pour ajouter un a faire
Priorite Dans CodeBlocks, limportance de la tache peut etre exprimee par des priorites
(1 - 9).
Position Ce parametre specifie si le commentaire doit etre inclus avant, apres ou bien a
la position exacte du curseur.
Style de commentaire Une selection de formats de commentaires (notamment doxygen).
2.5 Exporter du code Source

Il est souvent necessaire de transferer du code source vers dautres applications ou vers des
e-mails. Si le texte est simplement copie, le formattage est perdu, ce qui rend le texte peu
clair. La fonction exporter de CodeBlocks est une des solutions dans ce type de situations.
Le format requis pour le fichier exporte peut etre selectionne via Fichier Exporter .
Le programme adoptera alors le nom de fichier et le repertoire cible en fonction du fichier
source ouvert et les proposera pour enregistrer le fichier a exporter. Lextension de fichier
appropriee a chaque cas de figure sera determine par le type de lexportation. Les formats
suivants sont disponibles :
html Un format de type texte qui peut etre affiche dans un navigateur web ou dans un
traitement de texte.
rtf Le format Rich Text qui est un format base sur du texte et qui peut etre ouvert dans
un traitement de texte comme Word ou OpenOffice.
odt Le format Open Document Text qui est un format standardise specifie par Sun et
OReilly. Ce format peut etre traite par Word, OpenOffice et dautres traitements
de texte.
Codeblocks 33
Code::Blocks V1.1 2.6 Thread Search
pdf Le format Portable Document qui peut etre ouvert par des applications comme Ac-
robat Reader.
2.6 Thread Search

Via le menu Rechercher Thread Search , cette extension peut etre affichee ou masquee
en tant quonglet dans la console de messages. Dans CodeBlocks, une previsualisation de
loccurrence de la chane de caracteres peut etre affichee pour un fichier, un espace de
travail ou un repertoire. Ce faisant, la liste des resultats de la recherche sera affichee sur
la partie droite de la console ThreadSearch. En cliquant sur une entree de la liste, une
previsualisation saffiche sur la partie gauche. En double cliquant dans la liste, le fichier
selectionne est ouvert dans lediteur de CodeBlocks.
Note:
Letendue des extensions de fichiers a inclure dans la recherche est
preconfigure et peut avoir besoin detre ajuste.
2.6.1 Fonctionnalites
Lextension ThreadSearch offre les fonctionnalites suivantes :
Recherche dans les fichiers multi taches (Multi-threaded).
Editeur interne en lecture seule pour voir les resultats
Fichier ouvert dans lediteur de type notebook
Menu contextuel Rechercher les occurrences pour commencer une recherche dans
les fichiers a partir du mot situe sous le curseur
Figure 2.7: Panneau de Thread Search
2.6.2 Utilisation
1. Configurez vos preferences de recherche (voir Figure 2.8 a la page 35)
Une fois lextension installee, il y a 4 facons de conduire une recherche :
a) Tapez/Selectionnez un mot dans la bote de recherche combinee et appuyez
sur Entree ou cliquez sur Rechercher dans le panneau de Thread search de la
console de messages.
Codeblocks 34
b) Tapez/Selectionnez un mot dans la bote de recherche combinee de la barre

doutil et appuyez sur Entree ou cliquez sur le bouton Rechercher.
c) Clic droit sur nimporte quel mot dans lediteur actif puis cliquez sur Rechercher
les occurrences.
d) Cliquez sur Rechercher/Thread search pour trouver le mot courant dans lediteur
actif.
Note:
Les points 1, 2 et 3 peuvent ne pas etre disponibles en fonction de la
configuration courante.
2. Cliquez de nouveau sur le bouton de recherche pour arreter la recherche en cours.
3. Un clic simple sur un element resultat laffiche dans la previsualisation sur la droite.
4. Un double clic sur un element resultat ouvre ou configure un editeur sur la droite.
2.6.3 Configuration
Pour acceder au panneau de configuration de lextension ThreadSearch cliquez sur (voir
Figure 2.8 a la page 35) :
Figure 2.8: Configuration de Thread Search
Codeblocks 35
1. Bouton des Options du panneau de Thread search dans la console des messages.
2. Bouton des Options dans la barre doutils de Thread search.
3. Menu Parametres/Environnement puis choisir lelement Thread search dans la colonne
de gauche.
Note:
Les points 1, 2 et 3 peuvent ne pas etre disponibles en fonction de la
configuration courante.
La recherche partielle defini lensemble de fichiers qui seront analyses.

Les cases a cocher Projet et Espace de travail sont mutuellement exclusives.
Le chemin du repertoire peut etre edite ou configure via le bouton Selection.
Masque est lensemble des specifications de fichiers separees par des ;. Par exemple:
*.cpp;*.c;*.h.
2.6.4 Options
Mot entier si coche, lignes contenant lexpression recherchee si lexpression recherchee
est trouvee sans caracteres alphanumeriques +_ avant et apres.
Debut de mot si coche, lignes contenant lexpression recherchee si lexpression recherchee
est trouvee au debut dun mot sans caracteres alphanumeriques +_ avant et apres.
Respecter la casse si coche, la recherche est sensible a la casse (majuscules-minuscules).
Expression reguliere lexpression recherchee est une expression reguliere.
Note:
Si vous voulez chercher des expressions regulieres comme \n vous
devrez choisir loption Utiliser des recherches RegEx avancees via
le menu Parametres Editeur Parametres generaux .
2.6.5 Options de Thread search (ou Tache de Recherche)

Activer les elements du menu contextuel Trouver les occurrences Si coche, lentree
Trouver les occurrences est ajoutee au menu contextuel de lediteur.
Utiliser les options par defaut du menu Trouver les occurrences Si coche, un ensem-
ble doptions par defaut est applique aux recherches lancees par Trouver les occur-
rences du menu de contexte correspondant. Par defaut loption Mot entier et
Respecter la casse est active.
Effacer les resultats precedents en debut de recherche Si lextension ThreadSearch est
configuree en Vue arborescente alors les resultats de la recherche sont listes dans
lordre hierarchique suivant,
Codeblocks 36
le premier noeud contient le terme cherche

ensuite les fichiers qui contiennent ce terme sont listes
dans cette liste les numeros des lignes et le contenu correspondant sont affiches
Si vous recherchez plusieurs termes, la liste deviendra confuse, aussi les resultats des
recherches precedents peuvent etre supprimes en utilisant cette option en debut de
recherche.
Note:
Dans la liste des occurrences les termes seuls ou tous les termes peu-
vent etre supprimes via le menu de contexte Supprimer lelement ou
Supprimer tous les elements .
2.6.6 Mise en page

Afficher lentete dans la fenetre de logs si coche, len-tete est affiche dans la liste des
resultats de controle.
Note:
Si non coche, les colonnes ne sont plus redimensionnables mais on
economise de la place.
Dessiner des lignes entre les colonnes Dessine des lignes entre les colonnes en mode
Liste.
Afficher la barre doutils de ThreadSearch Afficher la barre doutils de lextension Thread-
Search.
Afficher les widgets de recherche dans le panneau de messages de ThreadSearch Si
coche, seuls les resultats de la liste de controle et lediteur de previsualisation sont
affiches. Les autres widgets de recherches sont masques (economise de la place).
Afficher lediteur de previsualisation de code La previsualisation du code peut etre masquee
soit par cette case a cocher soit par un double clic sur la bordure du separateur en
milieu de fenetre. Cest ici quon peut le faire de nouveau safficher.
2.6.7 Panneau de Gestion

Vous pouvez choisir differents modes de gestion de la fenetre de ThreadSearch. Avec
le choix Panneau de Messages la fenetre ThreadSearch sera integree a la console de
messages dans un des onglets. Si vous choisissez Mise en page vous pourrez le detacher
de la console et obtenir une fenetre flottante que vous pourrez placer ailleurs.
2.6.8 Type de journal

La vue des resultats de recherche peut safficher de plusieurs facons. Le choix Liste affiche
toutes les occurrences sous forme dune liste. Lautre mode Arborescence assemble toutes
les occurrences internes dun fichier dans un noeud.
Codeblocks 37
Code::Blocks V1.1 2.7 Extensions FileManager et PowerShell
2.6.9 Mode de partage de fenetre

Lutilisateur peut configurer la separation de fenetre de previsualisation et de sortie des
resultats de recherche horizontalement ou verticalement.
2.6.10 Tri des resultats de recherche

Les resultats de recherche peuvent etre tries par le nom de chemin ou le nom de fichier.
2.7 Extensions FileManager et PowerShell

Lexplorateur de fichiers Figure 2.9 a la page 39 est inclus dans lextension FileManager,
et se trouve dans longlet Fichiers. Laspect de File Explorer est montre a la Figure 2.9
a la page 39.
En haut vous trouverez le champ dentree du chemin. En cliquant sur le bouton a
lextremite de ce champ, la fleche vers le bas listera un historique des entrees precedentes
dans lesquelles on peut naviguer a laide dune barre de defilement. La fleche vers le haut
a droite du champ deplace dun cran vers le haut dans la structure des repertoires.
Dans le champ Joker vous pouvez entrer un filtre de visualisation pour laffichage des
fichiers. En laissant vide ce champ ou en y entrant vous afficherez tous les fichiers. En y
entrant .c ;. h par exemple, vous nafficherez que les fichiers sources en C et les fichiers
den-tetes (headers). Ouvrir la fleche du bas, affiche de nouveau la liste des dernieres
entrees.
Appuyer sur la touche Maj tout en cliquant, selectionne un groupe de fichiers ou de
repertoires, alors quappuyer sur la touche Ctrl tout en cliquant selectionne des fichiers
multiples ou des repertoires separes.
Les operations suivantes peuvent etre obtenues via le menu de contexte si un ou plusieurs
repertoires ont ete selectionnes dans lExplorateur de Fichiers :
Make Root defini le repertoire courant comme repertoire de base.
Ajouter aux favoris configure un marqueur pour ce repertoire et lenregistre dans les fa-
voris. Cette fonction permet de naviguer rapidement entre des repertoires frequemment
utilises ou encore sur des disques reseau.
Nouveau Fichier cree un nouveau fichier dans le repertoire selectionne.
Nouveau Repertoire cree un nouveau sous repertoire dans le repertoire selectionne.
fichiers ou meme un ou plusieurs repertoires ont ete selectionnes dans lExplorateur de
Fichiers :
Dupliquer copie un fichier/repertoire et le renomme.
Copier vers ouvre une bote de dialogue pour entrer un repertoire cible dans lequel on
copiera les fichiers/repertoires.
Codeblocks 38
Figure 2.9: Le gestionnaire de fichiers
Deplacer vers deplace la selection vers un autre endroit.

Supprimer supprime les fichiers/repertoires selectionnes.
Afficher les fichiers masques active/desactive laffichage des fichiers systemes masques.
Si active, le menu est coche par un marqueur.
Actualiser actualise laffichage de larborescence des repertoires.
fichiers ont ete selectionnes dans lExplorateur de Fichiers :
Ouvrir dans lediteur CB ouvre le fichier selectionne dans lediteur de CodeBlocks.
Renommer renomme le fichier selectionne.
Ajouter au projet actif ajoute le(s) fichier(s) au projet actif.
Note:
Les fichiers/repertoires selectionnes dans lexplorateur de fichiers peu-
vent etre accedes dans lextension PowerShell a laide de la variable
mpaths.
Codeblocks 39
On peut specifier via la commande de menu Parametres Environnement PowerShell

des fonctions utilisateur. Dans le masque de PowerShell, une nouvelle fonction qui peut
etre nommee aleatoirement, est creee via le bouton Nouveau. Dans le champ ShellCom-
mand Executable, le programme executable est specifie, et dans le champ en bas de la
fenetre, des parametres additionnels peuvent etre passes au programme. En cliquant sur
la fonction dans le menu de contexte ou dans le menu de PowerShell, la fonction sexecute
et traite les fichiers/repertoires selectionnes. La sortie est redirigee vers une fenetre de
shell separee.
Par exemple une entree de menu a ete creee dans PowerShell SVN et dans le menu
de contexte en tant que SVN. Dans ce contexte $file signifie le fichier selectionne dans
lexplorateur de fichiers, $mpath les fichiers ou repertoires selectionnes (voir section 3.2 a
la page 59).
Ajouter;$interpreter add $mpaths;;;
Celle-ci et toutes les commandes suivantes creeront un sous-menu, dans ce cas Extensions
SVN Ajouter . Le menu de contexte est etendu de meme. Cliquez sur la commande
du menu de contexte pour faire executer la commande SVN add sur les fichiers/repertoires
selectionnes.
TortoiseSVN est un programme SVN tres repandu qui sintegre dans lexplorateur. Le
programme TortoiseProc.exe de TortoiseSVN peut etre demarre en ligne de commande
et affiche une bote de dialogue pour y entrer les donnees de lutilisateur. Ainsi vous pouvez
lancer des commandes, disponibles en tant que menus de contexte dans lexplorateur,
egalement en ligne de commande. Vous pouvez donc lintegrer en tant quextension du
Shell dans CodeBlocks. Par exemple, la commande
TortoiseProc.exe /command:diff /path:$file
affichera les differences entre un fichier selectionne dans lexplorateur de CodeBlocks et

celui de la base de SVN. Voir Figure 2.10 a la page 41 comment integrer cette commande.
Note:
Pour les fichiers qui sont sous le controle de SVN lexplorateur de
fichier affiche des icones superposees qui sactivent via le menu Vue
SVN Decorators .
Exemple
Vous pouvez utiliser lexplorateur de fichiers pour afficher les differences sur des fichiers
ou des repertoires. Suivez les etapes suivantes :
1. Ajoutez le nom via le menu Parametres Environnement PowerShell . Cest
affiche comme une entree par linterpreteur de menu et le menu de contexte.
2. Selectionnez le chemin absolu de lexecutable Diff (notamment kdiff3). Le pro-
gramme est accede avec la variable $interpreter .
3. Ajoutez les parametres de linterpreteur
Codeblocks 40
Figure 2.10: Ajout dune extension Shell au menu de contexte
Diff;$interpreter $mpaths;;;
Cette commande sera executee en utilisant les fichiers ou repertoires selectionnes en tant
que parametres. La selection peut etre accedee via la variable $mpaths. Ceci est une facon
commode de differentier des fichiers ou des repertoires.
Note:
Lextension supporte lutilisation des variables de CodeBlocks dans
lextension du Shell.
$interpreter Appelle cet executable.
$fname Nom du fichier sans son extension.
$fext Extension du fichier selectionne.
$file Nom du fichier.
$relfile Nom du fichier sans linformation de chemin.
$dir Nom du repertoire selectionne.
$reldir Nom du repertoire sans linformation de chemin.
$path Chemin absolu.
$relpath Chemin relatif du fichier ou du repertoire
$mpaths Liste des fichiers et repertoires selectionnes actuellement
$inputstr{<msg>} Chane de caracteres qui est entree dans une fenetre de message.
$parentdir Repertoire Parent (../).
Codeblocks 41
Code::Blocks V1.1 2.8 Browse Tracker
Note:
Les entrees de lextension Shell sont egalement disponibles en tant
que menus de contexte dans lediteur de CodeBlocks.
2.8 Browse Tracker

Browse Tracker est une extension qui aide a naviguer parmi les fichiers recemment ouverts
dans CodeBlocks. La liste des fichiers recents est sauvegardee dans un historique. Le menu
Vue Suivi de Navigation Tout Effacer permet deffacer lhistorique.
Dans les differents onglets vous pouvez naviguer entre les divers elements des fichiers
recemment ouverts en utilisant lentree de menu Vue Suivi de Navigation Aller
en arriere/Aller en avant ou en utilisant les raccourcis claviers Alt-Gauche/Alt-Droit.
Le menu de suivi de navigation est egalement accessible dans les menus de contexte. Les
marqueurs sont enregistres dans un fichier de mise en page <projectName>.bmarks
Quand on developpe du logiciel, on passe souvent dune fonction a une autre implementee
dans differents fichiers. Lextension de suivi de navigation vous aidera dans cette tache
en vous montrant lordre dans lequel ont ete selectionnes les fichiers. Vous pouvez alors
naviguer confortablement dans les differents appels de fonctions.
Lextension permet meme de naviguer entre les marqueurs de chaque fichier de lediteur de
CodeBlocks. La position du curseur est memorisee pour chacun des fichiers. Vous pouvez
poser ces marqueurs en utilisant le menu Vue Suivi de Navigation Activer le
marquage de navigation ou en selectionnant une ligne avec le bouton gauche de la souris.
Une marque . . . est alors posee dans la marge gauche. Avec les menus Vue Suivi de
Navigation Marque precedente/Marque suivante ou les raccourcis Alt-up/Alt-down
vous pouvez naviguer entre les differents marques posees dans un fichier. Si vous voulez
naviguer dans un fichier avec des marques triees en fonction du numero de lignes, choisissez
simplement le menu Vue Suivi de Navigation Trier les marques de navigation .
En choisissant Effacer la marque de navigation le marqueur de la ligne selectionnee
est supprime. Si un marqueur est pose sur une ligne, le fait dappuyer pendant 1/4 de
seconde sur le bouton gauche de la souris tout en appuyant sur la touche Ctrl effacera le
marqueur de cette ligne. Avec le menu Effacer toutes les marques de navigation ou avec
un Ctrl-clic gauche sur toute ligne non marquee, vous remettez a 0 tous les marqueurs
dun fichier.
Le parametrage de lextension peut etre configure via le menu Parametres Editeur
Browse Tracker .
Note:
NdT : certains menus ou affichages ne sont pas traduits car lauteur de
lextension na pas marque certaines chanes comme etant traduisibles
Mark Style (Styles des marques) Les marques de navigation sont affichees par defaut
comme des . . . dans la marge. Avec le choix Book Marks elles seront affichees
en tant que marque par une fleche bleue dans la marge. Loption hide supprime
laffichage des marques.
Codeblocks 42
Code::Blocks V1.1 2.9 Support de SVN
Toggle Browse Mark key Les marques peuvent etre activees ou supprimees soit par un
simple clic avec le bouton gauche de la souris soit avec un clic-gauche tout en
maintenant la touche Ctrl enfoncee.
Toggle Delay Duree pendant laquelle le bouton gauche de la souris est enfonce pour
entrer dans le mode de marquage de navigation.
Clear All BrowseMarks (Effacer toutes les marques) tout en maintenant enfoncee la
touche Ctrl soit par simple clic soit par double clic sur le bouton gauche de la
souris.
La configuration de lextension est enregistree dans votre repertoire application data dans
le fichier default.conf. Si vous utilisez la fonctionnalite des profils (ou personnalite) de
CodeBlocks la configuration est alors lue dans votre fichier <personality>.conf.
2.9 Support de SVN

Note:
NdT : Cette extension est traduite ici, mais est obsolete. Vous avez
donc de grandes chances de ne plus la trouver.
Le support du systeme de controle de version SVN est inclus dans lextension CodeBlocks
TortoiseSVN. Via le menu TortoiseSVN Plugin settings vous pouvez configurer les
commandes svn accessibles dans longlet Integration .
Menu integration Ajoute une entree TortoiseSVN dans la barre de menu avec differents
parametrages.
Project manager Active les commandes TortoiseSVN du menu de contexte de la gestion
de projet.
Editor Active les commandes TortoiseSVN du menu de contexte de lediteur.
Dans la configuration de lextension vous pouvez choisir quelles sont les commandes svn
qui sont accessibles dans le menu principal ou le menu de contexte. Longlet integration
fournit une entree Edit main menu et Edit popup menu pour parametrer ces com-
mandes.
Note:
LExplorateur de fichiers dans CodeBlocks utilise differentes icones
superposees afin dindiquer letat de svn. Les commandes de Tortois-
eSVN sont incluses dans le menu de contexte.
2.10 LibFinder
Si vous voulez utilisez des librairies dans votre application, vous devez configurer votre
projet pour cela. Un tel processus de configuration peut etre difficile et ennuyeux car
chaque librairie peut utiliser un schema doptions particulier. Un autre probleme est que
Codeblocks 43
Code::Blocks V1.1 2.10 LibFinder
cette configuration differe entre les plates-formes ce qui resulte en des incompatibilites
entre des projets Unix et Windows.
LibFinder propose deux fonctionnalites majeures :
Recherche des librairies installees sur votre systeme
Inclure les librairies dans votre projet en seulement quelques clics en rendant le
projet independant de la plate-forme
2.10.1 Recherche de librairies

La recherche des librairies est disponible via le menu Extensions Library finder . Son
but est de detecter les librairies installees sur votre systeme et denregistrer les resultats
dans la base de donnees de LibFinder (notez que ces resultats ne sont pas ecrits dans les
fichiers projets de CodeBlocks). La recherche commence par un dialogue ou vous pouvez
fournir un ensemble de repertoires ou sont installees les librairies. LibFinder les analysera
de facon recursive aussi, si vous ne savez pas trop ou elles sont, vous pouvez selectionner
des repertoires generiques. Vous pouvez meme entrer le disque complet dans ce cas la,
le processus de recherche prendra plus de temps mais il detectera davantage de librairies
(voir Figure 2.11 a la page 44).
Figure 2.11: Liste de repertoires
Quand LibFinder est a la recherche de librairies, il utilise des regles speciales pour detecter
leur presence. Chaque ensemble de regle est situe dans un fichier xml. Actuellement
LibFinder peut rechercher wxWidgets 2.6/2.8, CodeBlocks SDK et GLFW la liste sera
etendue dans le futur.
Codeblocks 44
Note:
Pour obtenir davantage de details sur comment ajouter un support
de librairie dans LibFinder, lisez dans les sources de CodeBlocks
src/plugins/contrib/lib finder/lib finder/readme.txt.
Apres avoir termine lanalyse, LibFinder affiche les resultats (voir Figure 2.12 a la page 45).
Figure 2.12: Resultats de recherche
Dans la liste, vous cochez les librairies qui doivent etre enregistrees dans la base de donnees
de LibFinder. Notez que chaque librairie peut avoir plus dune configuration valide et les
parametrages ajoutes en premier sont plutot destines a etre utilises lors de la generation
de projets.
Au-dessous de la liste, vous pouvez selectionner ce quil faut faire avec les resultats des
analyses precedentes :
Ne pas effacer les resultats precedents Cette option travaille comme une mise a jour
des resultats existants Cela ajoute les nouveaux et met a jour ceux qui existent
deja. Cette option nest pas recommandee.
Seconde option (Effacer les resultats precedents des librairies selectionnees) effacera
Codeblocks 45
tous les resultats des recherches precedentes des librairies selectionnees avant dajouter
les nouveaux resultats. Cest loption recommandee.
Effacer toutes les configurations precedentes des librairies quand vous selectionnez cette
option, la base de donnees de LibFinder sera effacee avant dy ajouter les nouveaux
resultats. Cest utile quand vous voulez nettoyer une base de donnees LibFinder
contenant des resultats 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
aussi utilisees pour aider a traiter les librairies.
Si vous avez pkg-config dinstalle sur votre systeme (Cest installe automatiquement sur
la plupart des versions de systemes linux) LibFinder proposera des librairies venant de
cet outil. Il nest pas necessaire de faire une analyse specifique pour celles-ci elles seront
automatiquement chargees au demarrage de CodeBlocks.
2.10.2 Inclure des librairies dans les projets

LibFinder ajoute un onglet supplementaire dans les proprietes dun projet Librairies
Cet onglet montre les librairies utilisees dans le projet ainsi que celles connues de
LibFinder. Pour ajouter une librairie dans votre projet, selectionnez la dans le panneau
de droite et cliquez sur le bouton <. Pour enlever une librairie dun projet, selectionnez
la dans le panneau de gauche et cliquez sur le bouton > (voir Figure 2.13 a la page 46).
Figure 2.13: Configuration de projet
Vous pouvez filtrer les librairies connues de LibFinder en fournissant un filtre de recherche.
La case a cocher Afficher comme un arbre permet de basculer antre des vues sans
categories et des vues avec categories.
Codeblocks 46
Code::Blocks V1.1 2.11 AutoVersioning
Si vous voulez ajouter une librairie qui nest pas disponible dans la base de donnees de
LibFinder, vous pouvez utiliser le champ Librairie inconnue . Notez que vous devriez
entrer le librarys 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 suggeres dans le Wiki de CodeBlocks dans Global Variables. Lusage de cette
option nest recommande que lorsquon prepare un projet qui doit etre genere sur dautres
machines ou ce type de librairie existe et y est correctement detectee par LibFinder. Vous
pouvez acceder a une variable globale dans CodeBlocks comme :
$(#GLOBAL_VAR_NAME.include)
Cocher loption Ne pas configurer automatiquement indiquera a LibFinder quil ne

devrait pas ajouter automatiquement les librairies lors de la compilation. Dans ce cas,
LibFinder peut sinvoquer depuis un script de generation. Un exemple dun tel script est
genere et ajoute au projet en appuyant sur Ajouter un script de generation manuel .
2.10.3 Utilisation de LibFinder dans des projets generes par des

assistants
Les assistants vont creer des projets qui nutilisent pas LibFinder. Pour les integrer avec
cette extension, vous devrez mettre a jour manuellement les options de generation du
projet. Ceci est facilement obtenu en enlevant tous les parametrages specifiques aux li-
brairies et en ajoutant les librairies au travers de longlet Librairies dans les proprietes
du projet.
De tels projets deviennent independants des plates-formes. Tant que les librairies utilisees
sont dans la base de donnees de LibFinder, les options de generation du projet seront
automatiquement mises a jour pour concider avec les parametrages de librairie propres
aux plates-formes.
2.11 AutoVersioning
Une application de suivi de versions qui incremente les numeros de version et de con-
struction de votre application a chaque fois quun changement est effectue et lenregistre
dans un fichier version.h avec des declarations de variables faciles a utiliser. Possede
egalement une option pour proposer des changements dans un style a la SVN, un editeur
de schemas de versions, un generateur de journal des changements, et bien dautres choses
encore . . .
2.11.1 Introduction
Lidee de developper lextension AutoVersioning est venue lors du developpement dun
logiciel en version pre-alpha qui exigeait des informations de version et detat. Trop oc-
cupe par le codage, sans temps disponible pour maintenir la numerotation des versions,
lauteur a decide de developper une extension qui puisse faire le travail avec aussi peu
dinterventions que possible.
Codeblocks 47
2.11.2 Fonctionnalites
Voici resumee la liste des fonctions couvertes par lextension :
Supporte C et C++.
Genere et incremente automatiquement des variables de versions.
Editeur de letat du logiciel.
Editeur de schema integre pour changer le comportement de lauto incrementation
des valeurs de versions.
Declaration des dates en mois, jour et annee.
Style de version Ubuntu.
Controle des revisions Svn.
Generateur de journal des changements.
Fonctionne sous Windows et Linux.
2.11.3 Utilisation
Aller simplement dans le menu Projet Autoversioning . Une fenetre popup comme
celle-ci apparatra :
Figure 2.14: Configuration dun projet pour Autoversioning
Quand on repond Oui au message de demande de configuration, la fenetre principale de

configuration dAutoVersioning souvre pour vous permettre de parametrer les informa-
tions de version de votre projet.
Apres avoir configure votre projet pour le versionnage automatique, les parametres entres
dans la bote de dialogue de configuration sont enregistrees dans le fichier de projet et
un fichier version.h est cree. Pour le moment, chaque fois que vous entrez dans le menu
Projet Autoversioning , le dialogue de configuration qui apparat vous permet dediter
votre version de projet et les parametres qui y sont lies, a moins que vous nenregistriez
pas les nouveaux changements effectues par lextension dans le fichier de projet.
Codeblocks 48
2.11.4 Onglets de la bote de dialogue

2.11.4.1 Valeurs de Version
Ici vous entrez simplement les valeurs de version adequates ou laissez lextension Autover-
sioning le faire pour vous (see Figure 2.15 a la page 49).
Version Majeure Incremente de 1 quand le numero mineur atteint son maximum
Version mineure Incremente de 1 quand le numero de generation depasse la barriere
de nombre de generations, la valeur etant remise a 0 quand il atteint sa valeur
maximale.
Numero de generation (egalement equivalent a numero de Release) - Incremente de 1
chaque fois que le numero de revision est incremente.
Revision Incremente aleatoirement quand le projet a ete modifie puis compile.
Figure 2.15: Configuration des Valeurs de Version
2.11.4.2 Etat
Quelques champs pour garder une trace de letat de votre logiciel avec une liste de valeurs
predefinies usuelles (voir Figure 2.16 a la page 50).
Etat du logiciel Un exemple typique pourrait etre v1.0 Alpha
Abreviation Idem a letat du logiciel mais comme ceci : v1.0a
Codeblocks 49
Figure 2.16: Configuration de lEtat dans Autoversioning
2.11.4.3 Schema
Vous permet dediter comment lextension incrementera les valeurs de version (voir Fig-
ure 2.17 a la page 51).
Valeur max pour numero mineur Valeur maximale que peut atteindre la valeur mineure.
Une fois cette valeur atteinte, le numero Majeur est incremente de 1 et a la compi-
lation suivante le numero mineur sera remis a 0.
Nombre max de generations Quand cette valeur est atteinte, le compteur sera remis a
0 a la generation suivante. Mettre a 0 pour ne pas limiter.
Revision maximale Comme Nombre max de generations. Mettre a 0 pour ne pas limiter.
Revision aleatoire maximale Les revisions sincrementent par un nombre aleatoire que
vous decidez. Si vous mettez 1, les revisions sincrementeront evidemment par 1.
Nombre de generations avant dincrementer Mineur Apres des changements de code
et des compilations avec succes, lhistorique des generations sincremente, et quand
cette valeur est atteinte alors la valeur Mineure sincremente.
2.11.4.4 Parametres
Ici vous pouvez entrer certains parametres du comportement dAutoversioning (voir Fig-
ure 2.18 a la page 51).
Codeblocks 50
Figure 2.17: Schema de fonctionnement dAutoversioning
Figure 2.18: Parametres dAutoversioning
Codeblocks 51
Auto-incremente Majeur et Mineur Laisse lextension incrementer ces valeurs en util-

isant le schema. Si non coche, seuls les numeros de generation et de Revision
sincrementeront.
Creer des declarations de dates Cree des entrees dans le fichier version.h avec des
dates et un style de version a la Ubuntu.
Incrementation automatique Indique a lextension dincrementer automatiquement des
quune modification est faite. Cette incrementation interviendra avant la compila-
tion.
Langage de len-tete Selectionne le langage de sortie du fichier version.h
Interroger pour incrementer Si Incrementation automatique est coche, on vous inter-
roge alors avant la compilation (si des changements ont ete effectues) pour incrementer
les valeurs de version.
Svn active Recherche dans le repertoire courant la revision Svn et la date puis genere les
entrees correspondantes dans version.h
2.11.4.5 Journal des changements
Ceci vous permet dentrer chaque changement effectue au projet afin de generer un fichier
ChangesLog.txt (voir Figure 2.19 a la page 52).
Figure 2.19: Journal des changements dAutoversioning
Afficher les changements quand la version sincremente Affichera une fenetre popup
dedition de journal quand la version est incrementee.
Codeblocks 52
Format du Titre Un titre formate avec une liste de valeurs predefinies.
2.11.5 Inclusion dans votre code

Pour utiliser les variables generees par lextension faire simplement #include <version.h>.
Le code suivant est un exemple de ce quon peut faire :
#include <iostream>
#include "version.h"
void main(){
std::cout<<AutoVersion::Major<<endl;
}
2.11.5.1 Sortie de version.h
Le fichier den-tete genere. Voici un exemple sur un fichier en mode c++ :

#ifndef VERSION_H
#define VERSION_H
namespace AutoVersion{
//Date Version Types

static const char DATE[] = "15";
static const char MONTH[] = "09";
static const char YEAR[] = "2007";
static const double UBUNTU_VERSION_STYLE = 7.09;
//Software Status
static const char STATUS[] = "Pre-alpha";
static const char STATUS_SHORT[] = "pa";
//Standard Version Type

static const long MAJOR = 0;
static const long MINOR = 10;
static const long BUILD = 1086;
static const long REVISION = 6349;
//Miscellaneous Version Types

static const long BUILDS_COUNT = 1984;
#define RC_FILEVERSION 0,10,1086,6349
#define RC_FILEVERSION_STRING "0, 10, 1086, 6349\0"
static const char FULLVERSION_STRING[] = "0.10.1086.6349";
}
#endif //VERSION_h
En mode C cest la meme chose quen C++ mais sans le namespace:

#ifndef VERSION_H
#define VERSION_H
//Date Version Types

static const char DATE[] = "15";
static const char MONTH[] = "09";
static const char YEAR[] = "2007";
Codeblocks 53
static const double UBUNTU_VERSION_STYLE = 7.09;
//Software Status
static const char STATUS[] = "Pre-alpha";
static const char STATUS_SHORT[] = "pa";
//Standard Version Type

static const long MAJOR = 0;
static const long MINOR = 10;
static const long BUILD = 1086;
static const long REVISION = 6349;
//Miscellaneous Version Types

static const long BUILDS_COUNT = 1984;
#define RC_FILEVERSION 0,10,1086,6349
#define RC_FILEVERSION_STRING "0, 10, 1086, 6349\0"
static const char FULLVERSION_STRING[] = "0.10.1086.6349";
#endif //VERSION_h
2.11.6 Generateur de journal des changements

Cette bote de dialogue est accessible a partir du menu Projet Journal des change-
ments . Egalement si la case Afficher lediteur des changements quand la version sincremente
est cochee, une fenetre souvrira pour vous permettre dentrer la liste des changements
apres une modification des sources du projet ou un evenement dincrementation (voir
Figure 2.20 a la page 55).
Codeblocks 54
Figure 2.20: Changements dans un projet
2.11.6.1 Resume des Boutons
Ajouter Ajoute une ligne a la grille de donnees

Editer Active les modifications de la cellule selectionnee
Supprimer Supprime la ligne courante de la grille de donnees
Enregistrer Enregistre dans un fichier temporaire (changes.tmp) les donnees actuelles
pour pouvoir effectuer plus tard les entrees dans le journal des changements
Ecrire Entre la grille de donnees dans le journal des changements
Annuler Ferme simplement la bote de dialogue sans rien faire dautre
Voici un exemple de sortie generee par lextension dans le fichier ChangesLog.txt :
03 September 2007
released version 0.7.34 of AutoVersioning-Linux
Change log:
-Fixed: pointer declaration
-Bug: blah blah
02 September 2007
Codeblocks 55
Code::Blocks V1.1 2.12 Code statistics
Change log:
-Documented some areas of the code
-Reorganized the code for readability
01 September 2007
Change log:
-Edited the change log window
-If the change log windows is leave blank no changes.txt is modified
2.12 Code statistics
Figure 2.21: Configuration de Code Statistics
Basee sur les caracteristiques dun masque de configuration, cette simple extension detecte
les pourcentages de codes, commentaires et lignes blanches dun projet. Levaluation se
lance via la commande de menu Extensions Code statistics .
2.13 Recherche de Code Source Disponible

Cette extension permet de selectionner un terme dans lediteur et de rechercher ce terme
a laide du menu de contexte Rechercher dans Koders dans la base de donnees du site
[,Koders]. La bote de dialogue permet dajouter la possibilite de filtrer le langage et le
type de licence.
Cette recherche en base de donnees vous aidera a trouver du code source originaire du
monde entier en provenance dautres projets universitaires, de consortiums et dorganisations
comme Apache, Mozilla, Novell Forge, SourceForge et bien dautres, qui peuvent etre
utilises sans avoir a reinventer la roue a chaque fois. SVP, bien observer la licence du code
source dans chaque cas individuel.
2.14 Profilage de Code

Une interface graphique simple au Profileur GNU GProf.
Codeblocks 56
Code::Blocks V1.1 2.15 Extension Symbol Table
2.15 Extension Symbol Table

Cette extension permet de rechercher des symboles dans des fichiers objets et dans des
librairies. Les options et le chemin dacces au programme nm en ligne de commande sont
definis dans longlet des Options.
Figure 2.22: Configuration de Symbol Table
Cliquer sur Rechercher demarre la recherche. Les resultats du programme NM sont alors
affiches dans une fenetre separee nommee SymTabs Result. Les noms des fichiers objets
et des librairies contenant les symboles sont listes avec comme titre Sortie de NM.
Codeblocks 57
3 Expansion de Variables
CodeBlocks fait la difference entre plusieurs types de variables. Ces types peuvent servir a
configurer lenvironnement de creation dun programme, mais aussi a accrotre la mainten-
abilite et la portabilite. Lacces aux variables de CodeBlocks sobtient grace a $<name>.
Variables dEnvironnement sont configurees au demarrage de CodeBlocks. Elles peuvent
modifier les variables denvironnement du systeme telles que PATH. Cela peut etre
utile dans les cas ou une variable denvironnement specifique est necessaire a la
creation de projets. La configuration des variables denvironnement dans CodeBlocks
se fait a laide de Parametres Environnement Variables denvironnement .
Variables internes sont predefinies dans CodeBlocks, et peuvent etre accedees via leurs
noms (voir les details dans section 3.2 a la page 59).
Macros Commandes Ce type de variables est utilise pour controler le processus de
generation. Pour de plus amples informations se referer a section 3.4 a la page 63.
Variables Utilisateur sont des variables definies par lutilisateur qui peuvent etre specifiees
dans les options de generation dun projet. Ici vous pouvez, par exemple definir 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 CodeBlocks
le remplacera automatiquement par le contenu. Par cette methode, la configuration
dun projet peut etre largement parametree.
Variables Globales sont surtout utilisees pour creer CodeBlocks a partir des sources ou
pour le developpement dapplications wxWidgets. Ces variables ont une signification
bien particuliere. Par rapport a toutes les autres, si vous configurez de telles vari-
ables et partagez votre fichier projet avec dautres qui eux nont *pas* configure ces
variables glogales (ou GV), CodeBlocks demandera a lutilisateur de les configurer.
Cest un moyen pratique de dassurer quun autre developpeur sait facilement ce
quil doit configurer. CodeBlocks posera la question pour tous les chemins usuelle-
ment necessaires.
3.1 Syntaxe
CodeBlocks traite de facon equivalente, en tant que variables, les sequences de caracteres
suivantes dans les etapes de pre-generation, post-generation ou generation :
$VARIABLE
$(VARIABLE)
${VARIABLE}
%VARIABLE%
Les noms de variables doivent etre composes de caracteres alphanumeriques et sont in-
sensibles a la casse (minuscules-majuscules). Les variables commencant par un seul signe
Code::Blocks V1.1 3.2 Liste des variables internes
diese (#) sont interpretees comme des variables utilisateur globales (voir les details dans
la section 3.7 a la page 64). Les noms listes ci-dessous sont interpretes comme des types
de variables internes.
Les variables qui ne sont ni de type utilisateur globales ni de type interne, seront rem-
placees par une valeur fournie dans le fichier projet, ou par une variable denvironnement
si ce dernier echoue.
Note:
Les definitions par-cible sont prioritaires par rapport aux definitions
par-projet.
3.2 Liste des variables internes

Les variables listees ci-dessous sont des variables internes a CodeBlocks. Elles ne peuvent
pas etre utilises dans des fichiers sources.
3.2.1 Espace de travail CodeBlocks

$(WORKSPACE_FILENAME), $(WORKSPACE_FILE_NAME), $(WORKSPACEFILE), $(WORKSPACEFILENAME)
Le nom de fichier de lespace de travail courant (.workspace).
$(WORKSPACENAME), $(WORKSPACE_NAME)
Le nom de lespace de travail qui est affiche dans longlet Projets du
panneau Gestion.
$(WORKSPACE_DIR), $(WORKSPACE_DIRECTORY), $(WORKSPACEDIR), $(WORKSPACEDIRECTORY)
Le repertoire ou se trouve lespace de travail.
3.2.2 Fichiers et repertoires

$(PROJECT_FILENAME), $(PROJECT_FILE_NAME), $(PROJECT_FILE), $(PROJECTFILE)
Le nom de fichier du projet en cours de compilation.
$(PROJECT_NAME)
Le nom du projet en cours de compilation.
$(PROJECT_DIR), $(PROJECTDIR), $(PROJECT_DIRECTORY)
Le repertoire commun de plus haut niveau du projet en cours de com-
pilation.
$(ACTIVE_EDITOR_FILENAME)
Le nom du fichier ouvert dans lediteur actif courant.
$(ACTIVE_EDITOR_LINE)
Retourne le numero de ligne courant dans lediteur actif.
$(ACTIVE_EDITOR_COLUMN
Retourne le numero de colonne courant dans lediteur actif.
$(ACTIVE_EDITOR_DIRNAME)
le repertoire contenant le fichier actif courant (relatif au chemin de
plus haut niveau).
Codeblocks 59
$(ACTIVE_EDITOR_STEM)
Le nom de base (sans extension) du fichier actif courant.
$(ACTIVE_EDITOR_EXT)
Lextension du fichier actif courant.
$(ALL_PROJECT_FILES)
Une chane 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 linstance courante de CodeBlocks en cours dexecution.
$(DATAPATH), $(DATA_PATH), $(DATA-PATH)
Le repertoire partage de linstance courante de CodeBlocks en cours
dexecution.
$(PLUGINS) Le repertoire des plugins (ou extensions) de linstance courante de
CodeBlocks en cours dexecution.
$(TARGET_COMPILER_DIR)
Le repertoire dinstallation du compilateur appele aussi chemin matre.
3.2.3 Cibles de generation

$(FOOBAR_OUTPUT_FILE)
Le fichier de sortie dune cible specifique.
$(FOOBAR_OUTPUT_DIR)
Le repertoire de sortie dune cible specifique.
$(FOOBAR_OUTPUT_BASENAME)
Le nom de base du fichier de sortie (sans chemin, sans extension) dune
cible specifique.
$(TARGET_OUTPUT_DIR)
Le repertoire de sortie de la cible courante.
$(TARGET_OBJECT_DIR)
Le repertoire objet de la cible courante.
$(TARGET_NAME)
Le nom de la cible courante.
$(TARGET_OUTPUT_FILE)
Le fichier de sortie de la cible courante.
$(TARGET_OUTPUT_BASENAME)
Le nom de base du fichier de sortie (sans chemin, sans extension) de
la cible courante.
$(TARGET_CC), $(TARGET_CPP), $(TARGET_LD), $(TARGET_LIB)
Loutil de generation (compilateur, editeur de liens, etc.) de la cible
courante.
3.2.4 Langue et encodage

$(LANGUAGE) La langue du systeme en clair.
Codeblocks 60
$(ENCODING) Lencodage du systeme en clair.
3.2.5 Heure et date

$(TDAY) Date courante sous la forme AAAAMMJJ (par exemple 20051228)
$(TODAY) Date courante sous la forme AAAA-MM-JJ (par exemple 2005-12-28)
$(NOW) Heure courante sous la forme AAAA-MM-JJ-hh.mm (par exemple
2005-12-28-07.15)
$(NOW_L) Heure courante sous la forme AAAA-MM-JJ-hh.mm.ss (par exemple
2005-12-28-07.15.45)
$(WEEKDAY) Nom du jour de la semaine en clair (par exemple Mercredi)
$(TDAY_UTC), $(TODAY_UTC), $(NOW_UTC), $(NOW_L_UTC), $(WEEKDAY_UTC)
Ces types sont identiques aux precedents mais exprimes en temps uni-
versel TU.
$(DAYCOUNT) Nombre de jours passes depuis une date arbitraire choisie comme orig-
ine (1er Janvier 2009). Utile comme dernier composant dun numero
de version/generation.
3.2.6 Valeurs aleatoires

$(COIN) Cette variable simule un pile ou face (a chaque invocation) et retourne
0 ou 1.
$(RANDOM) Un nombre positif aleatoire sur 16 bits (0-65535)
3.2.7 Commandes du Systeme dexploitation

La variable est remplacee par la commande effective du Systeme dexploitation.
$(CMD_CP) Commande de Copie de fichiers.
$(CMD_RM) Commande de Suppression de fichiers.
$(CMD_MV) Commande de Deplacement de fichiers.
$(CMD_MKDIR) Commande de Creation de repertoire.
$(CMD_RMDIR) Commande de Suppression de repertoire.
3.2.8 Evaluation Conditionnelle

$if(condition){clause si vraie}{clause si fausse}
Levaluation Conditionnelle sera consideree comme vraie dans les cas suivants
la condition est un caractere non vide autre que 0 ou false
la condition est une variable non vide qui ne se resout pas en 0 ou false
Codeblocks 61
Code::Blocks V1.1 3.3 Expansion de script
la condition est une variable qui est evaluee a true (implicite par une condition
precedente)
Levaluation Conditionnelle sera consideree 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 evaluee a 0 ou false
Note:
Notez SVP que les variantes de syntaxe de variable %if (...) ou
$( if )(...) ne sont pas supportees dans ce type de construction.
Exemple
Par exemple : vous utilisez plusieurs plateformes et vous voulez configurer differents
parametres en fonction du systeme dexploitation. Dans le code suivant, la commande
de script [[ ]] est evaluee et la <commande> sera executee. Ce peut etre utile dans une
etape de post-generation.
[[ if (PLATFORM == PLATFORM_MSW) { print (_T("cmd /c")); } else { print (_T("sh ")); }
3.3 Expansion de script

Pour une flexibilite maximale, vous pouvez imbriquer les scripts en utilisant loperateur
[[ ]] en tant que cas particulier dexpansion de variable. Les scripts imbriques ont acces
a toutes les fonctionnalites standard disponibles pour les scripts et se comportent comme
des backticks (ou apostrophes inversees) de bash (a lexception de lacces au namespace
de CodeBlocks). En tant que tels, les scripts ne sont pas limites a la production de sorties
de type texte, mais peuvent aussi manipuler des etats de CodeBlocks (projets, cibles,
etc.).
Note:
La manipulation detats de CodeBlocks devrait etre implementee dans
des etapes de pre-generations plutot que dans un script.
Exemple avec Backticks

objdump -D find . -name *.elf > name.dis
Lexpression entre backticks (ou apostrophes inversees) retourne une liste de tous les
executables *.elf des sous-repertoires. Le resultat de cette expression peut etre utilise
directement par objdump. Au final, la sortie est redirigee vers un fichier nomme name.dis.
Codeblocks 62
Code::Blocks V1.1 3.4 Macros Commandes
Ainsi, des processus peuvent etre automatises simplement sans avoir recours a aucune
boucle.
Exemple utilisant un Script
Le texte du script est remplace par toute sortie generee par votre script, ou ignore en cas
derreur de syntaxe.
Comme levaluation conditionnelle est executee avant lexpansion de scripts, levaluation
conditionnelle peut etre utilisee pour les fonctionnalites de type pre-processeur. Les vari-
ables internes (et les variables utilisateur) sont etendues en sortie de scripts, aussi on peut
referencer des variables dans les sorties dun script.
[[ print(GetProjectManager().GetActiveProject().GetTitle()); ]]
insere le titre du projet actif dans la ligne de commande.
3.4 Macros Commandes

$compiler Accede au nom de lexecutable du compilateur.
$linker Accede au nom de lexecutable de lediteur de liens.
$options Flags du Compilateur
$link_options Flags de lediteur de liens
$includes Chemins des include du compilateur
$c Chemins des include de lediteur de liens
$libs Librairies de lediteur de liens
$file Fichier source (nom complet)
$file_dir Repertoire du fichier source sans le nom de fichier ni son extension.
$file_name Nom du fichier source sans les informations de chemin ni lextension.
$exe_dir Repertoire du fichier executable sans le nom de fichier ni son extension.
$exe_name Nom du fichier executable sans les informations de chemin ni lextension.
$exe_ext Extension de lexecutable sans les informations de chemin ni le nom
du fichier.
$object Fichier objet
$exe_output Fichier executable de sortie
$objects_output_dir
Repertoire de sortie des fichiers objets
3.5 Compilation dun fichier unique

$compiler $options $includes -c $file -o $object
Codeblocks 63
Code::Blocks V1.1 3.6 Edition de fichiers objets en executable
3.6 Edition de fichiers objets en executable

$linker $libdirs -o $exe_output $link_objects $link_resobjects $link_options $libs
3.7 Variables globales du compilateur

3.8 Synopsis
Travailler en tant que developpeur sur un projet reposant sur des librairies tierces im-
pose un certain nombre de taches repetitives inutiles, comme configurer des variables de
generation dependantes du systeme de fichier local. Dans le cas de fichiers projets, une
attention toute particuliere doit etre apportee afin deviter de diffuser une copie modifiee
localement. Si on ny prend pas garde, cela peut se produire facilement apres avoir change
par exemple un flag de generation pour obtenir une version de type release.
Le concept de variable globale du compilateur est une nouvelle solution unique a Code-
Blocks qui adresse ce probleme. Les variables globales du compilateur vous permettent
de configurer un projet une seule fois, avec nimporte quel nombre de developpeurs util-
isant nimporte quel systeme de fichiers pour compiler et developper ce projet. Aucune
information locale ne necessite detre changee plus dune fois.
3.9 Noms et Membres

Les variables globales du compilateur dans CodeBlocks se distinguent des variables par-
projet par la presence dun signe diese en tete. Les variables globales du compilateur
sont structurees ; chaque variable consiste en un nom et un membre optionnel. Les noms
sont definissables librement, alors que les membres sont construits dans lEnvironnement
Integre de Developpement (IDE). Bien que vous puissiez choisir nimporte quoi comme
nom en principe, il est recommande de reproduire des identificateurs connus de packages
communement utilises. Ainsi, le nombre dinformations que lutilisateur doit fournir est
minimise. Lequipe de CodeBlocks fourni une liste de variables recommandees pour divers
packages connus.
Le membre base correspond a la meme valeur que celle de la variable utilisee sans membre
(alias).
Les membres include et lib sont par defaut des aliases pour base/include et base/ lib , re-
spectivement. Cependant, lutilisateur peut les redefinir si une autre configuration est
souhaitee.
Il est generalement recommande dutiliser la syntaxe $(#variable . include ) plutot que son
equivalent $(#variable)/ include , car elle fournit une flexibilite accrue tout en etant fonc-
tionnellement identique (voir sous-section 3.12.1 a la page 67 et Figure 3.1 a la page 65
pour plus de details).
Les membres cflags et lflags sont vides par defaut et peuvent etre utilises pour fournir
une possibilite de remplir un ensemble consistant unique de flags compilateur/editeur de
liens pour toutes les generations sur une machine donnee. CodeBlocks vous permet de
definir des membres de variables utilisateur en complement de ceux predefinis.
Codeblocks 64
Code::Blocks V1.1 3.10 Contraintes
Figure 3.1: Variables Globales dEnvironnement
3.10 Contraintes
Les noms de variables de configuration ou de compilateur ne peuvent pas etre vides,
ne peuvent pas contenir de caracteres blancs (ou espaces), doivent commencer par
une lettre et ne contenir que des caracteres alphanumeriques. Les lettres Cyrilliques
ou Chinoises ne sont pas des caracteres alphanumeriques. Si CodeBlocks rencontre
une sequence de caracteres non valides dans un nom, il peut la remplacer sans le
demander.
Toutes les variables necessitent que leur base soit definie. Tout le reste est optionnel,
mais la base est absolument obligatoire. Si vous ne definissez pas la base dune
variable, elle ne sera pas sauvegardee (et ce meme si les autres champs ont ete
definis).
Vous ne pouvez pas definir un nom de membre utilisateur qui a le meme nom quun
membre predefini. Actuellement, le membre utilisateur ecrasera le membre predefini,
mais en general, le comportement est indefini dans ce cas.
Les valeurs des variables et des membres peuvent contenir un nombre arbitraire de
sequences de caracteres, mais doivent respecter les contraintes suivantes :
Vous ne pouvez pas definir une variable par une valeur qui se reference a la
meme variable ou a nimporte lequel de ses membres
Vous ne pouvez pas definir un membre par une valeur qui se reference a ce
meme membre
Vous ne pouvez pas definir un membre ou une variable par une valeur qui se
reference a la meme variable ou membre par une dependance cyclique.
Codeblocks 65
Code::Blocks V1.1 3.11 Utilisation des Variables Globales du Compilateur
CodeBlocks detectera les cas de definitions recursives les plus evidentes (ce qui peut arriver
par accident), mais il ne fera pas danalyse en profondeur de tous les cas possibles abusifs.
Si vous entrez nimporte quoi, alors vous obtiendrez nimporte quoi; vous etes avertis
maintenant.
Exemples
Definir wx.include comme $(#wx)/include est redondant, mais parfaitement legal.
Definir wx.include comme $(#wx.include) est illegal et sera detecte par CodeBlocks.
Definir wx.include comme $(#cb.lib) qui est lui meme defini comme $(#wx.include) creera
une boucle infinie.
3.11 Utilisation des Variables Globales du Compilateur

Tout ce que vous avez a faire pour utiliser des variables globales de compilateur cest de
les mettre dans votre projet! Oui, cest aussi simple que cela.
Quand lEnvironnement Integre de Developpement (IDE) detecte la presence dune vari-
able globale inconnue, il vous demande dentrer sa valeur. La valeur sera sauvegardee dans
vos parametres, ainsi vous naurez jamais besoin dentrer deux fois linformation.
Si vous avez besoin de modifier ou de supprimer une variable plus tard, vous pourrez le
faire depuis le menu des parametres.
Exemple
Figure 3.2: Variables Globales
Limage ci-contre montre a la fois les variables par-projet et globales. WX_SUFFIX est
defini dans le projet, mais WX est une variable utilisateur globale.
Codeblocks 66
Code::Blocks V1.1 3.12 Ensembles de Variables
3.12 Ensembles de Variables

Parfois, vous voulez utiliser differentes versions dune meme librairie, ou vous developpez
deux branches dun meme programme. Bien quil soit possible de gerer cela avec une vari-
able globale de compilateur, cela peut devenir fastidieux. Dans ce cas, CodeBlocks sup-
porte des ensembles de variables. Un ensemble de variables est une collection independante
de variables, identifiee par un nom (les noms densemble ont les memes contraintes que
les noms de variables).
Si vous souhaitez basculer vers un autre ensemble de variables, vous selectionnez tout
simplement un ensemble different depuis le menu. Des ensembles differents nont pas
obligatoirement les memes variables, et des variables identiques dans differents ensembles
nont pas forcement les memes valeurs, ni meme des membres utilisateurs identiques.
Un autre point positif a 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 different, vous netes pas obliges de re-entrer toutes les donnees a nouveau.
Vous pouvez simplement creer un clone de lensemble courant, ce qui dupliquera toutes
vos variables.
Supprimer un ensemble supprimera egalement toutes les variables de cet ensemble (mais
pas celles dune autre ensemble). Lensemble default est toujours present et ne peut pas
etre supprime.
3.12.1 Mini-Tutoriel de membres utilisateur

Comme decrit auparavant, ecrire $(#var.include ) et $(#var)/include revient a la meme
chose par defaut. Aussi pourquoi donc ecrire quelque chose daussi non intuitif que
$(#var.include ) ?
Prenons lexemple dune installation standard de Boost sous Windows. Generalement,

vous vous attendriez a ce quun package fictif ACME ait ses fichiers include dans ACME/in-
clude et ses librairies dans ACME/lib. Optionnellement, il pourrait mettre ses entetes
(headers) dans un autre sous repertoire appele acme. Ainsi apres avoir ajoute les chemins
corrects dans les options du compilateur et de lediteur de liens, vous pouvez vous atten-
dre a #include <acme/acme.h> et editer les liens avec libacme.a (ou quelque chose de ce
genre).
Boost, cependant, installe les entetes dans C:\Boost\include\boost-1 33 1\boost et ses
librairies dans C:\Boost\lib par defaut. Il semble impossible dobtenir ceci simplement
sans devoir tout ajuster sur chaque nouveau PC, particulierement si vous devez travailler
sous Linux mais aussi avec un autre OS.
Cest la que la veritable puissance des variables globales utilisateur se revele. Quand vous
definissez la valeur de la variable #boost, vous allez juste un cran plus loin que dhabitude.
Vous definissez 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 navez pas besoin de savoir pourquoi, vous ne voulez pas savoir pourquoi.
Codeblocks 67
4 Generer CodeBlocks a partir des Sources
4.1 Introduction
Cet article decrit le processus de creation des nightly builds (generations nocturnes !),
et peut etre utilise comme un guide si vous voulez generer CodeBlocks vous-meme. La
description suivante est une sequence dactions.
Afin de proceder a notre tache de generation, nous aurons besoin de plusieurs outils.
Creons dabord une liste dingredients pour notre recette de cuisine.
un compilateur
un systeme de generation initial (une version precedente deja fonctionnelle)
les sources de CodeBlocks
un programme zip
svn (systeme de controle de versions)
wxWidgets
4.1.1 WIN32
Comme les developpeurs de CodeBlocks generent CodeBlocks en utilisant GCC, nous
ferons de meme sous Windows. Le portage le plus facile et le plus propre est MinGW.
Cest le compilateur distribue avec CodeBlocks quand vous telechargez le package officiel.
Ici, on sen tiendra a la version 3.4.5, qui fonctionne bien.
Dabord, une breve explication des composants de MinGW :
gcc-core le coeur de la suite GCC
gcc-g++ le compilateur c++
mingw Runtime limplementation des librairies run time
mingw utils plusieurs utilitaires (implementation de petits programmes que GCC utilise
lui-meme)
win32Api lAPI (Interface de Programmation dApplication) pour creer des programmes
Windows
binutils plusieurs utilitaires utilises dans lenvironnement de generation
make le programme make de Gnu, ainsi vous pouvez generer a partir de fichiers make
GDB le debogueur Gnu
Code::Blocks V1.1 4.1 Introduction
Je vous suggere dextraire (et dinstaller pour GDB) le tout dans un repertoire C:\MinGW.
Le reste de cet article supposera que cest la que vous lavez mis. Si vous avez deja une
installation de CodeBlocks qui a ete fournie avec MinGW, je vous recommande malgre tout
dinstaller MinGW comme decrit ici. Un compilateur na pas a etre dans larborescence
dun Environnement de Developpement Integre (IDE); ce sont deux choses bien distinctes.
CodeBlocks le fournit avec les versions officielles afin que lutilisateur standard nait pas
a se preoccuper de ce genre de choses.
Vous pouvez avoir besoin dajouter le repertoire bin de votre installation MinGW a votre
variable path. Un moyen simple de faire cela est dentrer la commande suivante dans une
fenetre DOS :
set path=%PATH%;C:\MinGW\bin;C:\MinGW\mingw32\bin;
4.1.2 Systeme de generation initial

Sur [,CODEBLOCKS] est disponible un fichier de description de projet CodeBlocks.cbp.
Si vous chargez ce fichier dans CodeBlocks alors vous etes en mesure de generer Code-
Blocks a partir des sources. Tout ce dont vous avez besoin cest dune version de Code-
Blocks deja pre-generee.
Premierement, telechargez une version nightly. Vous pouvez faire votre selection a partir de
la ([,FORUM] rubrique Nightly Builds). Les versions nightly sont des versions Unicode,
contenant le coeur et les plugins contributifs.
Ensuite, decompressez le fichier 7-zip dans nimporte quel repertoire de votre choix. Si
vous navez pas 7-zip, vous pouvez le telecharger gratuitement depuis [,7Z].
Maintenant, CodeBlocks necessite une dll supplementaire pour travailler correctement:
la dll wxWidgets. Vous pouvez aussi la telecharger depuis le forum des nightly builds.
Dezippez la simplement dans le meme repertoire que celui ou vous avez decompresse
la version nightly de CodeBlocks. Il vous faut aussi la dll mingwm10.dll. Elle est nor-
malement dans le repertoire bin de votre installation de MinGW. Cest pourquoi il est
important de sassurer que le sous repertoire bin de votre installation MinGW est bien
dans votre variable path.
Enfin, demarrer cette nouvelle generation dune nightly de CodeBlocks. Elle devrait trou-
ver le compilateur MinGW qui vient detre installe.
4.1.3 Systeme de Controle de Versions

Afin de pouvoir recuperer les dernieres sources de CodeBlocks sources, nous avons besoin
dinstaller un systeme de controle de versions.
Les developpeurs de CodeBlocks fournissent leurs sources par le biais du systeme de
controle de versions [,Subversion]. Aussi, nous avons besoin dun client pour acceder
a leur depot svn des sources. [,TortoiseSVN] est un bon client pour Windows, facile
dutilisation, et qui est disponible gratuitement. Telechargez le et installez le, en gardant
tous les parametres suggeres.
Codeblocks 69
Maintenant, creez un repertoire ou vous voulez, par exemple D:\projets\CodeBlocks.

Faire un clic droit dans ce repertoire et choisir dans le menu popup : svn-checkout (ou
SVN Extraire si vous avez installe la francisation de SVN). Dans la bote de dialogue qui
apparat, entrez linformation suivante dans Url of Repository (URL du referentiel) :
svn://svn.berlios.de/codeblocks/trunk
et laissez les autres parametres comme ils sont.
Maintenant, soyez patient pendant que TortoiseSVN recupere les sources les plus recentes
du depot de CodeBlocks dans votre repertoire local. Oui ; toutes ces sources de CodeBlocks
viennent chez vous !
Pour plus dinformations sur le parametrage de SVN, voir info dans SVN settings. Si vous
naimez pas lintegration dans lexplorateur ou cherchez une solution inter-plateforme vous
pouvez jeter un oeil sur RapidSVN..
4.1.4 wxWidgets
[,Wxwidgets] est une abstraction de plateforme qui fourni une API supportant de nom-
breuses choses comme une Interface Graphique Utilisateur (GUI), des sockets, fichiers,
fonctionnalites de registres. En utilisant cette API, vous pouvez creer des programmes
independants des plateformes.
CodeBlocks est une application wxWidgets (soit apres : wx), ce qui signifie que pour
executer CodeBlocks vous avez besoin des fonctionnalites wx. Cela peut se faire de deux
facons. Soit par une .dll soit par une librairie statique. CodeBlocks utilise wx en tant
que dll et cette dll peut aussi se telecharger depuis la section nightly builds du forum.
Neanmoins, si nous voulons generer une application wx, nous devons inclure les headers
(ou en-tetes) des sources wx. Elles donnent au compilateur les informations sur les fonc-
tionnalites de wx. En plus de ces fichiers de headers, notre application a besoin detre liee
aux librairies dimportation wx. Bien, voyons cela pas a pas.
Wx est fourni sous forme de fichiers sources dans un fichier zip, aussi, nous devons le
generer par nous-memes. Nous avons deja le compilateur MinGW, donc nous avons tous
les outils necessaires sous la main.
Dezippez maintenant les sources wx dans C:\Projets et ainsi nous aurons au final un
repertoire wx de base comme celui-ci : C:\Projets\wxWidgets-2.8.9. Ensuite, dezippez
les patchs (sil y en a !) dans le meme sous repertoire afin de remplacer les fichiers modifies.
Notez que nous allons referencer le repertoire wx de base a partir de maintenant comme
<wxDir>
Maintenant, nous allons generer les wxWidgets. Voici comment faire :
Premierement, assurez-vous que C:\MingGW\bin est dans votre variable path, car durant
la generation quelques programmes residant dans le repertoire MinGW\bin seront appeles.
De plus, Make doit etre en version 3.80 ou superieure.
Il est temps maintenant de compiler les wxWidgets. Ouvrir une fenetre de commande
DOS et se placer dans le repertoire des wxWidgets :
Codeblocks 70
cd <wxDir>\build\msw
Nous sommes maintenant au bon endroit. Nous allons dabord nettoyer les sources :
mingw32-make -f makefile.gcc SHARED=1 MONOLITHIC=1 BUILD=release UNICODE=1 clean
Maintenant que tout est propre, nous pouvons compiler les wxWidgets :
mingw32-make -f makefile.gcc SHARED=1 MONOLITHIC=1 BUILD=release UNICODE=1
Cela prend un certain temps.

Pour generer une version debug, suivez ces etapes :
Nettoyer les precedentes compilations par
mingw32-make -f makefile.gcc SHARED=1 MONOLITHIC=1 BUILD=debug UNICODE=1 clean
Compiler par
mingw32-make -f makefile.gcc SHARED=1 MONOLITHIC=1 BUILD=debug UNICODE=1
Bien, regardons maintenant dans le repertoire (<wxDir>\lib\gcc dll). Les librairies

dimportation et les dll y sont visibles et il doit aussi y avoir un sous repertoire mswu\wx
a cet endroit, contenant setup.h.
Bravo! Vous venez de generer les wxWidgets!
Faisons encore quelques taches preliminaires complementaires avant dattaquer la compi-
lation de CodeBlocks.
4.1.5 Zip
Durant la generation de CodeBlocks, plusieurs ressources seront compressees dans des
fichiers zip. Aussi, le processus de generation doit pouvoir acceder a un zip.exe. Nous
devons telecharger ce zip.exe 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) telecharger
zip.exe gratuitement et ceci (http://switch.dl.sourceforge.net/sourceforge/infozip/zip232.zip)
est un lien direct(32bit) vers la plus recente version au moment de la redaction de cet
article.
Une fois telecharge, extraire simplement zip.exe vers lendroit approprie.
4.1.6 Generer Codeblocks

win32 Lancer update revision.bat (NdT : nest plus dans les versions recentes !)
linux Lancer update revision.sh
Avec cette fonction la revision SVN de la generation Nightly est mise a jour dans les
sources. On peut trouver ce fichier dans le repertoire principal des sources de CodeBlocks.
Codeblocks 71
4.1.7 WIN32
Maintenant, ouvrez le projet CodeBlocks.cbp dans CodeBlocks. Generez CodeBlocks en
lancant le processus de generation. Apres la creation de CodeBlocks, les fichiers generes
avec les informations de debogage se trouvent dans le sous-repertoire devel. En appelant
le fichier batch update.bat depuis le repertoire source, les fichiers sont copies dans le
sous-repertoire output et les informations de debogage sont retirees.
4.1.8 LINUX
Quand on genere sous Linux, les etapes suivantes sont necessaires. Dans cet exemple nous
supposons que vous etes dans le repertoire source de CodeBlocks. Sous Linux, la variable
denvironnement PKG_CONFIG_PATH doit etre configuree. Le repertoire <prefix> doit
contenir le fichier codeblocks.pc. (NdT : Cette section ne semble pas a jour avec les
dernieres versions)
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 (root)
4.1.9 Generer des plugins

Ensuite, configurer les variables globales via Parametres Variables Globales .
Variable cb
Pour la variable cb, entrer dans base le repertoire source de CodeBlocks.
<prefix>/codeblocks/src
Variable wx
Pour la variable wx, entrer dans base le repertoire source de wx (par ex.
C:\Programme\wxWidgets-2.8.9
Dans le projet CodeBlocks, la variable projet WX_SUFFIX est configuree a u. Cela sig-
nifie que pendant la generation de CodeBlocks ledition de liens se fera avec la librairie
*u gcc custom.dll. Les generations officielles des nightly de CodeBlocks seront liees avec
gcc cb.dll. Pour ce faire, il faut faire comme suit.
gcc_<VENDOR>.dll
La variable <VENDOR> est donnee dans le fichier de configuration compiler.gcc. Pour

sassurer quune distinction soit possible entre une generation officielle de CodeBlocks et
celles effectuee par vous-memes, la configuration par defaut VENDOR=custom ne devrait
pas etre changee.
Apres, creez lespace de travail ContribPlugins.cbp via Projet Generer lespace de
travail . Puis executez une fois de plus update.bat.
Codeblocks 72
4.1.10 Linux
Configurez la variable wx a laide des variables globales.
base /usr
include /usr/include/wx-2.8
lib /usr/lib
deboguer CodeBlocks. Demarrez CodeBlocks dans le repertoire output et chargez CodeBlocks.cbp
en tant que projet. Entrer le point darret et demarrer par Debug and Run (f8).
4.1.11 Plugins Contributifs

Ceci nous amene a la derniere tache preliminaire. Le code de CodeBlocks peut se diviser
en 2 parties principales : le coeur avec les plugins internes et les plugins contributifs. Vous
devez toujours dabord generer la partie coeur/plugins internes avant de generer la partie
contributive.
Pour generer la partie interne, Vous pouvez utiliser le fichier de projet de CodeBlocks
que vous trouverez dans : <cbDir>\src\CodeBlocks.cbp. Notre repertoire matre de
CodeBlocks sera maintenant mentionne comme <cbDir>. Un espace de travail est quelque
chose qui regroupe plusieurs projets entre eux. La generation des plugins contributifs se
trouve dans
<cbDir>\src\ContribPlugins.workspace
Mais, creons un espace de travail contenant lensemble. Placons cet espace de travail dans
le repertoire matre <cbDir> (NdT : la ou il y a deja CodeBlocks.cbp et ContribPlug-
ins.workspace). Utiliser simplement un editeur de texte normal et creer un fichier dont le
nom est CbProjects.workspace puis le remplir avec le contenu suivant (NdT : le fichier
ci-dessous est different de la version originale anglaise, car mis a jour au moment de la
traduction. En fait, il sagit tout simplement du fichier ContribPlugins.workspace auquel
on a change le titre du Workspace (3eme ligne), ajoute une ligne, la 4eme, pour generer
en tout premier le projet CodeBlocks.cbp et deplace loption active=1) :
<?xml version="1.0" encoding="UTF-8" standalone="yes" ?>
<CodeBlocks_workspace_file>
<Workspace title="Workspace">
<Project filename="CodeBlocks.cbp" active="1" />
<Project filename="plugins\contrib\AutoVersioning\AutoVersioning.cbp" />
<Project filename="plugins\contrib\BrowseTracker\BrowseTracker.cbp" />
<Project filename="plugins\contrib\Cccc\Cccc.cbp" />
<Project filename="plugins\contrib\CppCheck\CppCheck.cbp" />
<Project filename="plugins\contrib\codesnippets\codesnippets.cbp" />
<Project filename="plugins\contrib\codestat\codestat.cbp" />
<Project filename="plugins\contrib\copystrings\copystrings.cbp" />
<Project filename="plugins\contrib\Cscope\Cscope.cbp" />
<Project filename="plugins\contrib\devpak_plugin\DevPakPlugin.cbp" />
<Project filename="plugins\contrib\DoxyBlocks\DoxyBlocks.cbp" />
<Project filename="plugins\contrib\dragscroll\dragscroll.cbp" />
<Project filename="plugins\contrib\EditorTweaks\EditorTweaks.cbp" />
<Project filename="plugins\contrib\envvars\envvars.cbp" />
Codeblocks 73
<Project filename="plugins\contrib\source_exporter\Exporter.cbp" />

<Project filename="plugins\contrib\byogames\byogames.cbp" />
<Project filename="plugins\contrib\headerfixup\headerfixup.cbp" />
<Project filename="plugins\contrib\help_plugin\help-plugin.cbp" />
<Project filename="plugins\contrib\HexEditor\HexEditor-win.cbp" />
<Project filename="plugins\contrib\IncrementalSearch\IncrementalSearch.cbp" />
<Project filename="plugins\contrib\keybinder\keybinder.cbp" />
<Project filename="plugins\contrib\cb_koders\cb_koders.cbp" />
<Project filename="plugins\contrib\lib_finder\lib_finder.cbp">
<Depends filename="plugins\contrib\wxSmithContribItems\wxSmithContribItems.cbp" />
</Project>
<Project filename="plugins\contrib\MouseSap\MouseSap.cbp" />
<Project filename="plugins\contrib\NassiShneiderman\NassiShneiderman.cbp" />
<Project filename="plugins\contrib\profiler\cbprofiler.cbp" />
<Project filename="plugins\contrib\regex_testbed\RegExTestbed.cbp" />
<Project filename="plugins\contrib\symtab\symtab.cbp" />
<Project filename="plugins\contrib\ThreadSearch\ThreadSearch.cbp">
<Depends filename="plugins\contrib\wxSmithContribItems\wxSmithContribItems.cbp" />
</Project>
<Project filename="plugins\contrib\wxSmithContribItems\wxSmithContribItems.cbp">
<Depends filename="plugins\contrib\wxSmith\wxSmith.cbp" />
</Project>
<Project filename="plugins\contrib\wxSmith\wxSmith.cbp" />
<Project filename="plugins\contrib\wxSmithAui\wxSmithAui.cbp">
<Depends filename="plugins\contrib\wxSmith\wxSmith.cbp" />
</Project>
<Project filename="tools\cb_share_config\cb_share_config.cbp" />
</Workspace>
</CodeBlocks_workspace_file>
Nous utiliserons cet espace de travail pour generer lensemble de CodeBlocks.
4.1.12 Generer lensemble de CodeBlocks

Nous sommes arrives a letape finale ; notre but ultime. Lancer lexecutable de CodeBlocks
depuis notre telechargement de generation nightly. Choisir Ouvrir dans le menu Fichier et
rechercher lespace de travail que nous venons de creer puis louvrir. Soyez un peu patient
pendant que CodeBlocks analyse le tout, puis CodeBlocks vous demandera dentrer 2
variables globales, ces variables globales indiqueront a la version nightly de CodeBlocks
ou trouver les wxWidgets (rappelez-vous : fichiers header et librairies) et ou trouver ....
CodeBlocks, ce qui est necessaire aux plugins contributifs qui ont besoin de savoir (ainsi
que pour tout plugin cree par un utilisateur) ou est le sdk (fichiers dentetes (headers) de
CodeBlocks) are. Dans notre cas, ces valeurs sont :
wx <wxDir> repertoire de base des wxWidgets.
cb <cbDir>/src repertoire contenant les sources de CodeBlocks.
Aller maintenant dans le Menu Projet et choisissez (re)generer lespace de travail, et allez
faire un tour. Regardez comment CodeBlocks est en train de generer CodeBlocks.
Une fois la generation terminee, ouvrez une fenetre console dans <cbDir>/src et lancez la
commande update.bat. Cela transferera tout ce qui est utile depuis <cbDir>/src/devel
Codeblocks 74
vers <cbDir>/src/output. En plus, cela supprimera tous les symboles de deboguage.

Cette etape est tres importante - ne loubliez jamais.
Vous pouvez maintenant copier la dll wx a la fois dans ce repertoire output et dans devel.
Vous pouvez alors fermer CodeBlocks. Rappelez-vous, nous etions avec la version nightly
telechargee ?
Il est temps de tester la nouvelle. Dans le repertoire output, lancez CodeBlocks.exe. Si
tout sest bien passe, vous avez genere votre propre nightly de CodeBlocks faite maison.
Codeblocks 75
URL catalog
[,7Z] 7z zip homepage.
http://www.7-zip.org
[,ARM] ARM homepage.

http://www.arm.com/
[,BERLIOS] Codeblocks at berlios.

http://developer.berlios.de/projects/codeblocks/
[,FORUM] Codeblocks forum.

http://forums.codeblocks.org/
[,WIKI] Codeblocks wiki.

http://wiki.codeblocks.org/index.php?title=Main_Page/
[,CODEBLOCKS] Codeblocks homepage.

http://www.codeblocks.org/
[,GCC] GCC home page.

http://gcc.gnu.org/
[,HIGHTEC] HighTec homepage.

http://www.hightec-rt.com/
[,Koders] Koders homepage.

http://www.koders.com/
[,MSP430] MSP430 homepage.

http://www.ti.com/sc/msp430
[,PowerPC] Motorola homepage.

http://e-www.motorola.com/
[,TriCore] TriCore homepage.

http://www.infineon.com/tricore/
[,TortoiseSVN] TriCore homepage.

http://tortoisesvn.net/
[,Subversion] TriCore homepage.

http://subversion.tigris.org/
[,Wxwidgets] WxWidgets homepage.

http://www.wxwidgets.org/
[,Wxcode] WxCode homepage.

http://wxcode.sourceforge.net/

Manual Codeblocks FR PDF

Transféré par

Droits d'auteur :

Formats disponibles

Manual Codeblocks FR PDF

Transféré par

Informations du document

Titre original

Copyright

Formats disponibles

Partager ce document

Partager ou intégrer le document

Options de partage

Avez-vous trouvé ce document utile ?

Ce contenu est-il inapproprié ?

Droits d'auteur :

Formats disponibles

Manual Codeblocks FR PDF

Transféré par

Droits d'auteur :

Formats disponibles

Code::Blocks

Merci a lequipe CodeBlocks:

Lillustration ci-dessous montre lapparence de la fenetre de linterface utilisateur de Code-

Figure 1.1: Environnement de developpement Integre (IDE) de CodeBlocks

1.1 Vue du projet

1.2 Notes pour les Projets

1.3 Modele de Projet

dans le repertoire Documents and Settings\<user>\Application Data\codeblocks\UserTemplate

1.4 Creer des Projets a partir de Cibles de Generation

Figure 1.2: Cibles de Generation

1.5 Cibles Virtuelles

1.6 Etapes Pre- et Post Generation

1.7 Ajouter des Scripts a des Cibles de Generation

1.8 Espace de travail et Dependances de Projet

1.9 Inclure des Fichiers en Assembleur

1.10 Editeur et Outils

Figure 1.3: Definition des abreviations

1.10.4 Fichiers de Configuration

1.10.5 Navigation et Recherche

Figure 1.4: Recherche de fichiers

Dans CodeBlocks vous pouvez facilement naviguer entre les Entetes/Sources en :

Figure 1.5: Ouverture dun fichier den-tetes

CodeBlocks offre plusieurs possibilites de recherches dans un fichier ou un repertoire.

Figure 1.6: Recherche de fonctions

1.10.6 Vue des Symboles

Les categories suivantes existent pour les symboles :

Figure 1.7: Vue des symboles

Figure 1.8: Activation de lanalyse en temps reel

1.10.7 Inclure des fichiers daide externes

Figure 1.9: Configuration des fichiers daide

Figure 1.10: Visualiseur HTML integre

1.10.8 Inclure des outils externes

1.11 Astuces pour travailler avec CodeBlocks

1.11.1 Recherche de Modifications

Figure 1.11: Recherche de modifications

1.11.2 Echange de donnees avec dautres applications

Les commandes suivantes sont actuellement disponibles :

OpenLine Cette commande ouvre un fichier dans une instance de CodeBlocks et

Raise Donne le focus a linstance de CodeBlocks. Aucun parametre ne doit

1.11.3 Configurer les variables denvironnement

Figure 1.12: Variables denvironnement

1.11.4 Basculer entre diverses dispositions

1.11.5 Basculer entre projets

1.11.6 Configurations etendue des compilateurs

Figure 1.13: Configurer des informations detaillees

1.11.7 Zoomer dans lediteur

1.11.8 Mode de Repliement

1.11.9 Selection de modes dans lediteur

4. Dans le menu Parametres Editeur Marges et tirets on peut activer les

1.11.10 Repliement de code

CodeBlocks fournit aussi la fonctionnalite de repliement pour les directives du pre-processeur.

1.11.11 Auto completion

1.11.12 Recherche de fichiers casses

1.11.13 Inclure des librairies

1.11.14 Ordre dedition de liens des fichiers objets

1.11.15 Sauvegarde automatique

1.11.16 Configuration des extensions de fichiers

1.12 CodeBlocks en ligne de commande

<filename> Specifie le nom du fichier de projet *.cbp ou le nom de lespace de tra-