1  Gestion de Projet Code::Blocks

Les textes de plusieurs paragraphes (par exemple 2 ou 3) sont les documentations officielles du site Wiki de Code::Blocks (éventuellement revues et complétées) où elles ne sont disponibles qu’en anglais. Cette documentation est une extension de la version originale 1.1, assemblée et/ou écrite par Mario Cupelli.

L’illustration ci-dessous montre l’apparence de la fenêtre de l’interface utilisateur de Code::Blocks.

Gestion

Cette fenêtre contient l’interface ’Projets’ qui dans le texte suivant sera référencée comme vue du projet. Cette vue affiche tous les projets ouverts dans Code::Blocks à un instant donné. L’onglet ’Symboles’ de la fenêtre Gestion affiche les symboles, les variables etc.

Éditeur

Dans l’illustration ci-dessus, un fichier source nommé hello.c est ouvert avec colorisation de syntaxe dans l’éditeur.

Liste des fichiers ouverts

affiche une liste de tous les fichiers ouverts dans l’éditeur, dans cet exemple : hello.c.

CodeSnippets

peut être affiché via le menu ’Affichage’ →’ CodeSnippets’ . Ici vous pouvez gérer des modules de texte, des liens vers des fichiers et des liens vers des urls.

Journaux & autres

Cette fenêtre est utilisée pour sortir des résultats de recherche, des messages envoyés par un compilateur etc...

La barre d’état donne un aperçu des paramétrages suivants :

• Chemin absolu d’un fichier ouvert dans l’éditeur.

• L’éditeur utilise l’encodage par défaut de votre système d’exploitation. Cette configuration sera affichée par défaut.

• Numéros de ligne et de colonne de la position actuelle du curseur dans l’éditeur.

• Le mode de configuration du clavier pour insérer du texte (Insertion ou Remplacement).

• État actuel du fichier. Un fichier modifié sera marqué comme Modifie sinon cette case reste vide.

• Autorisation d’un fichier. Un fichier qui est en lecture seule sera affiché Lecture seule dans la barre d’état. Dans la fenêtre ’Ouvrir la liste de fichiers’ ces fichiers seront identifiés par une icône de verrouillage superposée.

  Note :
  Dans l’éditeur courant, l’utilisateur peut choisir les propriétés du menu de contexte. Dans le dialogue apparaissant dans l’onglet ’Général’ , l’option ’Le fichier est en lecture seule’ peut être sélectionnée. Cette option marquera le fichier correspondant comme étant en lecture seule pour Code::Blocks, mais les attributs en lecture et écriture du fichier original ne seront pas modifiés dans le système de fichiers.

• Si vous démarrez Code::Blocks en ligne de commande avec --personality=<profile> la barre d’état affichera le profil utilisateur courant, sinon default sera affiché. Les paramètres de Code::Blocks sont enregistrés dans le fichier de configuration correspondant <personality>.conf.

Code::Blocks offre une gestion des projets très flexible et très compréhensible. Le texte suivant ne montre que quelques aspects de la gestion de projets.

1.1  Vue du projet

Dans Code::Blocks, les sources et les paramètres d’un processus de génération sont stockés dans un fichier projet <name>.cbp. Les sources en C/C++ et les fichiers d’en-têtes correspondants (ou headers) sont les composants typiques d’un projet. La façon la plus simple de créer 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 fenêtre de gestion.

Code::Blocks gère les fichiers de projets en catégories qui dépendent de l’extension des fichiers. Les catégories suivantes sont prédéfinies :

Sources

contient les fichiers sources dont l’extension est *.c;*.cpp;.

ASM Sources

contient les fichiers sources dont l’extension est *.s;*.S;*.ss;*.asm.

Headers

contient, entre autres, les fichiers dont l’extension est *.h;.

Ressources

contient les fichiers pour paramétrer l’aspect des fenêtres des wxWidgets avec les extensions *.res;*.xrc;. Ces types de fichiers sont affichés dans l’onglet ’Ressources’ de la fenêtre de Gestion.

Les paramètres des types et catégories de fichiers peuvent être ajustés via le menu de contexte ’Arbre des projets’ →’Éditer les types et catégories de fichiers’ . Ici, vous pouvez définir aussi des catégories personnalisées pour les extensions de votre choix. Par exemple, si vous souhaitez lister des scripts d’édition de liens avec l’extension *.ld dans une catégorie nommée Linkerscript, vous n’avez qu’à créer une nouvelle catégorie.

1.2  Notes pour les Projets

Dans Code::Blocks, des notes spécifiques peuvent être stockées dans un projet. Ces notes peuvent contenir de brèves descriptions ou des points particuliers pour le projet correspondant. En affichant ces informations à l’ouverture d’un projet, les autres utilisateurs peuvent avoir un rapide aperçu de l’avancement du projet. L’affichage des notes peut être validé ou invalidé via l’onglet Notes des Propriétés d’un projet.

1.3  Modèles de Projet

Code::Blocks est fourni avec tout un ensemble de modèles de projets qui sont affichés quand on crée un nouveau projet. Cependant, vous pouvez aussi enregistrer des modèles personnalisés pour y sauvegarder vos propres spécifications d’options de compilation, les optimisations à utiliser, les options spécifiques aux machines etc. Ces modèles seront enregistrés dans Documents and Settings∖<user>∖Application Data∖codeblocks∖UserTemplates sous Windows 7, ∖Utilisateurs∖<user>∖AppData∖Roaming∖CodeBlocks∖UserTemplates sous Windows 10 ou 11 (ou un chemin équivalent du profil de l’utilisateur, adapté à chaque OS) : <user> est votre nom d’utilisateur. Si les modèles doivent pouvoir être ouverts par tous les utilisateurs, ils devront être copiés dans un répertoire correspondant de l’installation de Code::Blocks. Ces modèles seront alors affichés lors du démarrage suivant de Code::Blocks dans ’Nouveau’ →’Projet’ →’Modèles utilisateur’ .

1.4  Créer des Projets à partir de Cibles de Génération

Dans les projets, il est nécessaire d’avoir à disposition différentes variantes de projets. On appelle ces variantes Cibles de Génération. Elles diffèrent par leurs options de compilation, les informations de débogage et/ou le choix des fichiers. Une cible de génération peut aussi être externalisée dans un projet séparé. Pour ce faire, cliquer sur ’Projet’ →’Propriétés’ puis sélectionner la variante dans l’onglet ’Générer les cibles’ et cliquer sur le bouton ’Créer un projet à partir d’une cible’ (voir figure 1.2).

1.5  Cibles Virtuelles

Les projets peuvent être également structurés dans Code::Blocks en ce qu’on appelle des cibles virtuelles. Une structure fréquemment utilisée de projet consiste en deux cibles de génération, la première cible ’Debug’ qui contient des informations pour le débogage et la seconde cible ’Release’ sans ces informations. En ajoutant Cibles Virtuelles via ’Projet’ →’Propriétés’ →’Cibles de génération’ on peut combiner des cibles de génération individuelles. Par exemple, une Cible Virtuelle ’All’ peut créer les cibles Debug et Release simultanément. Les cibles virtuelles sont affichées dans la barre de symboles du compilateur dans Générer les cibles.

1.6  Étapes Pré- et Post Génération

Dans Code::Blocks on peut effectuer des opérations complémentaires avant et après la compilation d’un projet. Ces opérations sont appelées étapes de Pré génération ou Post génération. Des Post générations typiques sont :

• Création d’un format Intel Hexformat à partir un objet terminé

• Manipulation d’objets par objcopy

• Générer des fichiers de dump par objdump

Exemple

Créer le désassemblage d’un objet sous Windows. Le transfert vers un fichier nécessite l’appel à cmd avec l’option /c.

cmd /c objdump -D name.elf > name.dis

Un autre exemple de Post génération peut être l’archivage d’un projet. Pour cela, créez une cible de génération ’Archive’ et incluez les instructions suivantes dans l’étape de post génération :

zip -j9 $(PROJECT_NAME)_$(TODAY).zip src h obj $(PROJECT_NAME).cbp

Avec cette commande, le projet actif et ses sources, en-têtes et objets seront compressés en tant que fichier zip. En faisant ainsi, les variables intégrées $(PROJECT_NAME) et $(TODAY), le nom du projet et la date courante seront extraites (voir section 3.2). Après l’exécution de la cible ’Archive’, le fichier compressé sera stocké dans le répertoire du projet.

Dans le répertoire share/codeblocks/scripts vous trouverez quelques exemples de scripts. Vous pouvez ajouter un script via le menu ’Paramètres’ →’Édition de scripts’ et l’enregistrer dans un menu. Si vous exécutez par exemple le script make_dist depuis le menu, alors tous les fichiers appartenant à un projet seront compressés dans une archive <project>.tar.gz.

1.7  Ajouter des Scripts à des Cibles de Génération

Code::Blocks offre la possibilité d’utiliser des actions de menus dans les scripts. Le script représente un autre degré de liberté pour contrôler la génération de votre projet.

1.8  Espace de travail et Dépendances de Projet

Des projets multiples peuvent être ouverts dans Code::Blocks. En enregistrant les projets ouverts via ’Fichier’ →’Enregistrer l’espace de travail’ vous pouvez les rassembler dans un seul espace de travail sous <name>.workspace. Si vous ouvrez <name>.workspace au démarrage suivant de Code::Blocks, tous les projets seront de nouveau affichés.

Les logiciels complexes sont un assemblage de composants qui sont gérés dans différents projets Code::Blocks. De plus, lors de la génération de tels logiciels, il y a souvent des dépendances entre ces projets.

Exemple

Un projet A contient des fonctions de base qui sont rendues disponibles aux autres projets sous forme d’une librairie. Maintenant, si les sources de ce projet sont modifiées, alors la librairie doit être re-générée. Afin de maintenir la consistance entre un projet B qui utilise ces fonctions et le projet A qui les implémente, le projet B doit dépendre du projet A. Les informations nécessaires aux dépendances des projets sont enregistrées dans l’espace de travail adéquat, ainsi chaque projet peut être généré séparément. L’utilisation des dépendances rend également possible le contrôle de l’ordre dans lequel sont générés les projets. Les dépendances de projets peuvent être configurées en sélectionnant le menu ’Projet’ →’Propriétés’ puis en cliquant sur le bouton ’Dépendances du projet’.

1.9  Inclure des Fichiers en Assembleur

Dans la fenêtre Gestion d’une vue de projet, les fichiers en Assembleur sont affichés dans la catégorie ASM Sources. L’utilisateur peut changer la liste des fichiers dans les catégories (voir section 1.1). Un clic droit sur un des fichiers assembleur listés ouvrira un menu de contexte. Sélectionner ’Propriétés’ pour ouvrir une nouvelle fenêtre. Sélectionnez maintenant l’onglet ’Générer’ et activez les deux champs ’Compiler le fichier’ et ’Édition de liens du fichier’. Sélectionnez ensuite l’onglet ’Avancé’ et exécutez les étapes suivantes :

1.

Configurer ’Variable de compilation’ à CC

2.

Sélectionner le compilateur dans ’Pour ce compilateur’

3.

Sélectionner ’Utiliser des commandes personnalisées pour générer ce fichier’

4.

Dans la fenêtre, entrez :

$compiler $options $includes <asopts> -c $file -o $object

Les variables de Code::Blocks sont identifiées par un $ (voir section 3.4). Elles sont automatiquement configurées, ainsi vous n’avez à remplacer que l’option de l’assembleur <asopt> par vos propres configurations.

1.10  Éditeur et Outils

Cette section regroupe des fonctions internes à l’éditeur

1.10.1  Code par Défaut

Les règles de codage dans une compagnie imposent d’avoir un modèle standard. Avec Code::Blocks, il est possible d’inclure un contenu prédéfini automatiquement en début de fichier lors de la création d’une nouvelle source C/C++ ou d’en-têtes (headers). Le contenu prédéfini est dénommé code par défaut. Cette configuration peut être sélectionnée dans ’Paramètres’ →’Éditeur’ Code par Défaut. Si vous créez un nouveau fichier alors une expansion des variables macro, notamment celles de ’Paramètres’ →’Variables Globales’ , est effectuée. Un nouveau fichier peut être créé via le menu ’Fichier’ →’Nouveau’ →’Fichier’ .

Exemple

/*************************************************************** 
 *  Project: $(project) 
 *  Function: 
 *************************************************************** 
 *  $Author: mario $ 
 *  $Name:  $ 
 *************************************************************** 
 * 
 *  Copyright 2007 by company name 
 * 
 ***************************************************************/

1.10.2  Abréviations

Pas mal de frappes au clavier peuvent être économisées dans Code::Blocks en définissant des abréviations. Ceci peut s’obtenir en sélectionnant ’Paramètres’ →’Éditeur’ et en définissant les abréviations par un nom <name>, qui peut alors être appelé par un raccourci clavier Ctrl-J (voir figure 1.3).

On peut également les paramétrer en incluant des variables $(NAME) dans les abréviations.

#ifndef $(Guard token) 
#define $(Guard token) 
#endif // $(Guard token)

Quand on utilise l’abréviation <name> dans un texte source et qu’on utilise Ctrl-J, le contenu de la variable est récupéré puis inclus.

1.10.3  Personnalités

Les configurations de Code::Blocks sont enregistrées en tant que données d’application dans un fichier dénommé <user>.conf dans le répertoire de codeblocks. Ce fichier de configuration contient des informations telles que les derniers projets ouverts, le paramétrage de l’éditeur, l’affichage des barres de symboles etc. Par défaut, la personnalité ’default’ est utilisée et sa configuration sauvegardée dans un fichier default.conf. Si Code::Blocks est lancé en ligne de commande avec le paramètre --personality=myuser, le paramétrage sera enregistré dans un fichier myuser.conf. Si le profil n’existe pas déjà, il sera automatiquement créé. Cette procédure rend possible la création de différents profils pour différentes étapes de travail. Si vous lancez Code::Blocks en ligne de commande avec le paramètre additionnel --personality=ask, une boîte de sélection sera affichée avec tous les profils disponibles.

1.10.4  Fichiers de Configuration

Les paramètres de Code::Blocks sont enregistrés dans le fichier de profil default.conf dans le répertoire codeblocks de votre Application Data. Quand vous utilisez des personnalités (ou profils) (voir section 1.10.3), les détails de configuration sont enregistrés dans un fichier <personality>.conf.

L’outil cb_share_conf, qu’on trouve dans le répertoire d’installation de Code::Blocks, est utilisé pour gérer et enregistrer ces paramétrages.

Si vous souhaitez définir des paramètres standard pour plusieurs utilisateurs de l’ordinateur, le fichier de configuration default.conf doit être enregistré dans le répertoire ∖Documents and Settings∖Default User∖Application Data∖codeblocks dans Windows 7, ou dans Windows 10 ou 11 ∖Utilisateurs∖Default∖AppData∖Roaming∖CodeBlocks, ou encore un chemin équivalent de votre profil pour d’autres OS. Lors du premier démarrage, Code::Blocks copiera les valeurs par défaut depuis ’Default User’ vers le répertoire ”Application data” de l’utilisateur courant.

Pour créer une version portable de Code::Blocks sur clé USB, procédez comme suit. Copiez le répertoire d’installation de Code::Blocks vers la clé USB et stockez le fichier de configuration default.conf dans ce répertoire. Cette configuration servira de paramétrage global. Faites attention au fait que ce fichier soit accessible en écriture, sinon les changements de configuration ne pourront y être enregistrés.

1.10.5  Navigation et Recherche

Dans Code::Blocks il y a plusieurs façons de naviguer rapidement entre les fichiers et les fonctions. Une procédure typique est la configuration de marques de recherche. Via le raccourci clavier Ctrl-B une marque est posée ou supprimée dans un fichier source. Via Alt-PgUp vous pouvez aller à la marque précédente, et via Alt-PgDn vous pouvez aller à la marque suivante.

Si vous sélectionnez l’espace de travail ou un projet particulier de l’espace de travail dans la vue du projet vous pouvez rechercher un fichier dans le projet. Sélectionnez tout simplement ’Rechercher le fichier’ depuis le menu de contexte, puis tapez le nom du fichier et le fichier sera sélectionné. Si vous tapez sur la touche Entrée, ce fichier sera ouvert dans l’éditeur (voir figure 1.4).

Dans Code::Blocks vous pouvez facilement naviguer entre les En-têtes/Sources en :

1.

Positionnant le curseur à l’endroit où le fichier d’en-tête (header) est inclus puis ouvrir ce fichier via le menu de contexte ’Ouvrir le fichier inclus’ (voir figure 1.5)

2.

Basculer du fichier d’en-tête au fichier source via le menu de contexte ’Basculer en-tête/source’

3.

Sélectionner par exemple un define dans l’éditeur et choisir ’Trouver la déclaration’ depuis le menu de contexte pour ouvrir le fichier contenant cette déclaration.

Code::Blocks offre plusieurs possibilités de recherches dans un fichier ou un répertoire. La boîte de dialogue de recherche s’ouvre par ’Chercher’ →’Rechercher’ (Ctrl-F) ou ’Rechercher dans les fichiers’ (Ctrl-Shift-F).

Alt-G et Ctrl-Alt-G sont d’autres fonctions utiles. Le dialogue qui s’ouvrira en utilisant ces raccourcis vous permet de choisir des fichiers/fonctions et aller vous positionner à l’implémentation de la fonction sélectionnée (voir figure 1.6) ou bien ouvrir le fichier sélectionné dans l’éditeur. Vous pouvez utiliser dans le dialogue des jokers comme * ou ? etc. pour y obtenir une recherche incrémentale.

Dans l’éditeur, vous pouvez ouvrir un nouveau dialogue Ouvrir des fichiers Ctrl-Tab et vous pouvez passer de l’un à l’autre via la liste affichée. Si vous appuyez sur la touche Ctrl, alors un fichier peut être sélectionné de différentes façons :

1.

Si vous sélectionnez une entrée avec le bouton gauche de la souris, le fichier sélectionné sera ouvert.

2.

Si vous appuyez sur la touche Tab vous passez de l’une à l’autre des entrées listées. En relâchant la touche Ctrl le fichier sélectionné sera ouvert.

3.

Si vous déplacez la souris au-dessus des entrées listées, alors la sélection courante sera surlignée. En relâchant la touche Ctrl le fichier sélectionné sera ouvert..

4.

Si le pointeur de souris est en dehors de la sélection surlignée, vous pouvez utiliser la molette de la souris pour basculer entre les entrées. En relâchant la touche Ctrl le fichier sélectionné sera ouvert.

Une façon commune de développer du logiciel est de jongler avec un ensemble de fonctions implémentées dans différents fichiers. L’extension ”Browse Tracker” vous aidera à résoudre cette tâche en vous montrant dans quel ordre ont été sélectionnés les fichiers. Vous pouvez alors naviguer aisément entre les appels de fonctions (voir section 2.4).

L’affichage des numéros de lignes dans Code::Blocks peut s’activer via ’Paramètres’ →’Éditeur’ →’Paramètres généraux’ à l’aide du champ ’Afficher les numéros de ligne’. Le raccourci Ctrl-G ou la commande de menu ’Rechercher’ →’Aller à la ligne’ vous aidera à atteindre la ligne désirée.

1.10.6  Vue des Symboles

La fenêtre Gestion de Code::Blocks 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 l’espace de travail.

Les catégories suivantes existent pour les symboles :

Fonctions Globales

Liste l’implémentation des fonctions globales.

typedefs globales

Liste l’utilisation des définitions typedef.

Variables globales

Affiche les symboles de variables globales.

Symboles du pré-processeur

Liste les directives du pré-processeur créées par #define.

Macros globales

Liste les macros des directives du pré-processeur

Les structures et classes sont affichées par le menu ’arbre du bas’ et l’ordre de tri peut être modifié via le menu de contexte. Si une catégorie est sélectionnée à la souris, les symboles trouvés seront affichés dans la partie basse de la fenêtre (voir figure 1.7). Double-cliquer sur un symbole ouvrira le fichier où il est défini ou bien la fonction où elle est implémentée, puis on se positionnera sur la ligne correspondante. Un rafraîchissement automatique du navigateur de symboles, sans avoir à sauvegarder de fichier, peut être activé par le menu ’Paramètres’ →’Éditeur’ →’Code Complétion’ (voir figure 1.8). Les performances de Code::Blocks seront affectées dans les projets comportant de nombreux symboles.

1.10.7  Inclure des Fichiers d’Aide Externes

Code::Blocks est seulement fourni avec son propre fichier d’aide : normalement, les développeurs ont besoin de bien plus d’aides et de références pour les langages, les librairies, les protocoles, les formats de fichiers et ainsi de suite. Le plugin help rend accessible toute la documentation nécessaire depuis Code::Blocks lui-même. Virtuellement, tout document peut être interprété par le système d’aide de Code::Blocks, depuis que le ”plugin help” a la possibilité, si besoin, de lancer des programmes externes pour visualiser les documents ajoutés.

Une fois qu’a été ajouté un nouveau fichier ou document d’aide, une nouvelle entrée dans le menu ”Aide” est disponible afin de pouvoir l’ouvrir.

L’environnement de développement Code::Blocks supporte l’inclusion de fichiers d’aide externes via le menu ’Paramètres’ →’Environnement’ . Insérez le manuel de votre choix (au format chm par ex., voir ci-dessous) dans la sélection ’Fichiers d’aide’ , sélectionnez ’Ceci est le fichier d’Aide par défaut’ (voir figure 1.9). L’entrée $(keyword) est un paramètre de substitution pour une sélection particulière dans votre éditeur. Vous pouvez alors sélectionner une fonction dans un fichier ouvert de Code::Blocks par un simple clic, et la documentation correspondante s’affichera lorsque vous appuierez sur la touche F1.

Si vous avez inclus plusieurs fichiers d’aide, vous pouvez choisir un terme particulier dans l’éditeur, puis choisir le fichier d’aide adéquat dans le menu de contexte ’Chercher dans’ pour que Code::Blocks y fasse la recherche.

Dans Code::Blocks vous pouvez également ajouter un support de pages ”man”. Ajoutez seulement une entrée ’man’ et spécifiez les chemins comme suit (NdT ici pour Linux!).

man:/usr/share/man

Sous Linux, les pages man sont habituellement installées de toute façon. Sous Windows vous pourriez vouloir les télécharger, par ex. depuis ici : https://www.win.tue.nl/~aeb/linux/man

Options d’Aide

• Vous pouvez demander à Code::Blocks d’utiliser un fichier particulier comme fichier d’aide par défaut, en cochant la case ”Ceci est le fichier d’aide par défaut”. Ainsi, ce fichier sera affiché dès lors que vous appuierez sur la touche ’F1’. De plus, si vous écrivez le mot $(keyword) en tant que mot clé par défaut (voir plus loin), on cherchera ces mots clés dans ce fichier (le mot sélectionné ou le mot sous le curseur du fichier source courant) et les correspondances seront affichées, si elles existent.

• Vous pouvez demander à Code::Blocks d’ouvrir un fichier d’aide sur un sujet de votre choix, en écrivant le mot clé correspondant dans la boîte de texte ”Valeur du mot clé par défaut”. Si le fichier d’aide est celui par défaut et que vous utilisez $(keyword) comme mot clé par défaut, l’éditeur utilisera le mot sous le curseur (ou celui sélectionné) dans le fichier d’aide actuellement ouvert comme mot clé, en ouvrant le fichier d’aide par défaut sur le sujet adéquat. Ceci ne sera toutefois vrai que sur le fichier d’aide par défaut : on ne cherchera pas de cette façon dans les autres fichiers d’aide. Par exemple, si vous avez une référence de langage comme fichier d’aide par défaut et que vous ajoutez un fichier d’aide sur une librairie standard, vous obtiendrez l’explication du mot clé du langage en appuyant sur la touche ’F1’, mais vous n’aurez pas les fonctions de librairie expliquées de cette façon. Inversement, en configurant le fichier de la librairie par défaut, via la touche F1 vous perdrez cette fonctionnalité pour les mots clés de langage.

• Si votre fichier d’aide est un fichier HTML, vous pouvez demander à Code::Blocks de l’ouvrir avec le visualiseur de fichiers HTML intégré, en cochant l’option correspondante.

Code::Blocks fourni un ’Visualiseur HTML intégré’, qui peut être utilisé pour afficher un simple fichier html et y rechercher des mots clés. Configurez simplement le chemin du fichier html qui doit être analysé et cochez la case ’Ouvrir ce fichier avec le visualiseur d’aide intégré’ via le menu ’Paramètres’ →’Environnement’ →’Fichiers d’aide’ .

Fichiers CHM

Vous pouvez trouver des fichiers d’aide c++ chm sur le web. Ajoutez-les tout simplement dans la boîte de dialogue.

Sous Linux vous avez à installer un visualiseur de fichiers chm pour pouvoir afficher ces fichiers chm. Il y en a plusieurs comme gnochm, kchmviewer, xchm et ainsi de suite.

1.10.8  Inclure des outils externes

L’inclusion d’outils externes dans Code::Blocks est faisable via ’Outils’ →’Configurer les outils’ →’Ajouter’ . Les variables internes (voir section 3.2) peuvent aussi être utilisées comme paramètres des outils. D’autre part, il y a plusieurs sortes d’options de lancement pour démarrer des applications externes. En fonction des options, les applications externes peuvent s’arrêter quand on quitte Code::Blocks. Si les applications doivent rester ouvertes après qu’on ait quitté Code::Blocks, l’option ’Lancer l’outil visible en mode détaché’ doit être cochée.

1.11  Astuces pour travailler avec Code::Blocks

Dans ce chapitre nous présenterons quelques paramétrages utiles dans Code::Blocks.

1.11.1  Recherche de Modifications

Code::Blocks fourni une fonctionnalité pour pister les modifications effectuées dans un fichier source et affiche une barre dans la marge là où ont eût lieu les changements. Les modifications sont marquées par une barre de changements jaune alors que celles qui ont déjà été enregistrées sont marquées par une barre de changements verte (voir figure 1.11). Vous pouvez naviguer dans vos changements à l’aide du menu ’Rechercher’ →’Aller à la ligne changée suivante’ ou encore ’Rechercher’ →’Aller à la ligne changée précédente’ . La même fonctionnalité est accessible via les raccourcis clavier Ctrl-F3 et Ctrl-Shift-F3.

Cette fonctionnalité peut être activée ou désactivée via la case à cocher ’Utiliser la barre de changements’ dans le menu ’Paramètres’ →’Éditeur’ →’Marges et tirets’ .

1.11.2  Échange de données avec d’autres applications

Les échanges de données entre Code::Blocks et d’autres applications sont possibles. Pour cela on utilise, avec Windows, le processus de communication inter processus DDE (Dynamic Data Exchange) et, avec les autres systèmes d’exploitation, une communication basée sur le protocole TCP.

Avec cette interface, différentes commandes peuvent être envoyées vers une instance de Code::Blocks en suivant la syntaxe suivante.

[<command>("<parameter>")]

Les commandes suivantes sont actuellement disponibles :

Open

La commande

[Open("d:\temp\test.txt")]

utilise un paramètre, dans notre cas c’est le nom d’un fichier avec son chemin en absolu, et il s’ouvre dans une instance existante de Code::Blocks ou bien, si nécessaire, une première instance démarre.

OpenLine

Cette commande ouvre un fichier dans une instance de Code::Blocks et se positionne sur la ligne dont le numéro est entré. Le numéro de ligne est spécifié par :ligne.

[OpenLine("d:\temp\test.txt:10")]

Raise

Donne le ”focus” à l’instance de Code::Blocks. Aucun paramètre ne doit être entré.

1.11.3  Configurer les variables d’environnement

Voir aussi l’”Extension Variables d’Environnement” dans la section 2.10.

La configuration d’un système d’exploitation se fait par ce qu’on appelle les variables d’environnement. Par exemple, la variable d’environnement PATH contient le chemin d’un compilateur installé. Le système d’exploitation analysera cette variable dans l’ordre d’écriture, c’est à dire que les entrées de la fin seront utilisées en dernier dans les recherches. Si plusieurs versions de compilateur ou d’autres applications sont installées, les situations suivantes peuvent se produire :

• On appelle une version incorrecte d’un logiciel

• Les logiciels installés s’appellent entre eux

Ainsi, on peut tomber sur le cas où différentes versions d’un compilateur ou d’un autre outil sont obligatoires pour différents projets. Lorsque cela arrive, une première solution est de changer les variables d’environnement dans le système d’exploitation pour chaque projet. Toutefois cette procédure est sujette à erreur et manque de flexibilité. Pour ce faire, Code::Blocks offre une solution élégante. Différentes configurations de variables peuvent être créées pour un usage uniquement en interne à Code::Blocks. De plus, vous pouvez passer de l’une à l’autre de ces configurations. La figure 1.12 montre la boîte de dialogue que vous obtenez via ’Variables d’Environnement’ dans ’Paramètres’ →’Environnement’ . On crée une configuration à l’aide du bouton ’Créer’.

L’accès et l’étendue des variables d’environnement ainsi créées sont limités à Code::Blocks. Vous pouvez étendre ces variables d’environnement comme toutes les autres variables dans Code::Blocks à l’aide de $(NAME).

Exemple

Vous pouvez écrire dans un fichier <project>.env l’environnement utilisé dans une étape de post génération (voir section 1.6) puis l’archiver dans votre projet.

cmd /c echo \%PATH\%  > project.env

ou sous Linux

echo \$PATH > project.env

1.11.4  Basculer entre diverses dispositions

En fonction des tâches à effectuer, il peut être utile d’avoir plusieurs configurations ou dispositions (ou présentations) différentes de Code::Blocks et de les sauvegarder. Par défaut, le paramétrage (notamment afficher/masquer les barres d’outils, aspect, etc.) est enregistré dans le fichier de configuration default.conf. En utilisant l’option en ligne de commande --personality=ask au démarrage de Code::Blocks, on peut choisir parmi plusieurs possibilités de paramétrages. En dehors de ces paramétrages globaux, il peut se produire une situation où vous souhaitez basculer entre différentes vues de fenêtres ou de barres de symboles pendant une session. L’édition de fichier et le débogage de projets sont deux exemples typiques de telles situations. Code::Blocks offre un mécanisme pour enregistrer et sélectionner différentes dispositions afin d’éviter à l’utilisateur d’avoir à fermer et ouvrir manuellement et fréquemment des fenêtres et des barres de symboles. Pour enregistrer une disposition, sélectionnez le menu ’Affichage’ →’Disposition’ →’Enregistrer la disposition actuelle’ et entrez un nom dans <nom>. La commande ’Paramètres’ →’Éditeur’ →’Raccourcis clavier’ →’Affichage’ →’Dispositions’ →’<name>’ permet de définir un raccourci clavier pour ce processus. Il est ainsi possible de basculer entre les diverses dispositions simplement en utilisant ces raccourcis clavier.

1.11.5  Basculer entre projets

Si plusieurs projets ou fichiers sont ouverts en même temps, l’utilisateur a besoin d’un moyen pour passer rapidement de l’un à l’autre. Code::Blocks possède plusieurs raccourcis pour ce faire.

Alt-F5

Active le projet précédent de la vue des projets.

Alt-F6

Active le projet suivant de la vue des projets.

F11

Dans l’éditeur, bascule entre un fichier source <name>.cpp et le fichier d’en-tête (header) correspondant <name>.h

1.11.6  Configurations étendue des compilateurs

Lors de la génération d’un projet, les messages du compilateur sont affichés dans l’onglet Messages de génération. Si vous souhaitez recevoir des informations détaillées, l’affichage peut être étendu. Pour cela, cliquez sur ’Paramètres’ →’Compilateur et débogueur’ puis sélectionnez l’onglet ’Autres options’ dans le menu déroulant.

Assurez-vous que le compilateur soit correctement sélectionné. L’option ’Ligne de commande complète’ des Avertissements du compilateur permet de sortir des informations détaillées. De plus, ces sorties peuvent être redirigées vers un fichier HTML. Pour cela, sélectionnez ’Enregistrer le journal de génération dans un fichier HTML en fin de génération’. D’autre part, Code::Blocks peut afficher une barre d’avancement du processus de génération dans la fenêtre de génération qui peut être activée en cochant ’Afficher la barre de progression de génération’.

1.11.7  Zoomer dans l’éditeur

Code::Blocks possède un éditeur très puissant. Cet éditeur vous permet de changer la taille des caractères du texte affiché des fichiers ouverts. Si vous avez une souris avec une molette, vous n’avez qu’à appuyer sur la touche Ctrl tout en tournant la molette dans un sens ou l’autre pour agrandir ou réduire la taille du texte.

1.11.8  Mode de Repliement

Quand on édite des fichiers de texte, notamment des *.txt, dans Code::Blocks, il peut être utile d’avoir le texte replié, ce qui signifie que les lignes longues seront affichées sur plusieurs lignes à l’écran afin qu’elles puissent être correctement éditées. La fonction ’Repliement’ peut être activée dans ’Paramètres’ →’Éditeur’ →’Autres Options’ ou en cochant la case ’Activer le repliement’ . Les touches ”Home” et ”Fin” positionnent respectivement le curseur en début et en fin de ligne repliée. Quand on choisit ’Paramètres’ →’Éditeur’ →’Autres Options’ et ’La touche Home déplace toujours le curseur en première colonne’ , le curseur sera positionné respectivement en début ou en fin de ligne si on appuie sur la touche ”Home” ou ”Fin”. Si on désire placer le curseur au début de la première ligne du paragraphe en cours, il vous faut utiliser la combinaison de touches ’Alt-Home’ . La même chose de façon analogue pour ’Alt-Fin’ pour positionner le curseur en fin de la dernière ligne du paragraphe courant.

1.11.9  Sélection de modes dans l’éditeur

Code::Blocks supporte différents modes de sélection pour le couper-coller des chaînes de caractères.

1.

Un texte de l’éditeur actif peut être sélectionné avec le bouton gauche de la souris, puis on relâche ce bouton. L’utilisateur peut se déplacer de haut en bas avec la molette de la souris. Si on appuie sur le bouton du milieu, le texte précédemment sélectionné sera inséré. Cet effet est disponible au niveau d’un fichier et peut être vu comme un presse-papier de fichier.

2.

Appuyer sur la touche ’ALT’ active ce qu’on appelle la sélection en mode bloc et un rectangle de sélection s’affiche à l’aide du bouton gauche de la souris. Lorsqu’on relâche la touche Alt cette sélection peut être copiée ou collée. Cette option est utile si vous voulez sélectionner des colonnes, notamment dans un tableau et en copier-coller le contenu.

3.

Dans le menu ’Paramètres’ →’Éditeur’ →’Marges et tirets’ on peut activer ce qu’on appelle des ’Espaces Virtuels’ . Ceci active la possibilité d’avoir une sélection en mode bloc qui peut commencer ou se terminer par une ligne vide.

4.

Dans le menu ’Paramètres’ →’Éditeur’ →’Marges et tirets’ on peut activer le ’Sélections Multiples’ . En maintenant enfoncée la touche Ctrl l’utilisateur peut sélectionner diverses lignes dans l’éditeur actif avec le bouton gauche de la souris. Les sélections sont ajoutées dans le presse-papier à l’aide des raccourcis Ctrl-C ou Ctrl-X. Ctrl-V en insèrera le contenu à la position courante du curseur. Une option complémentaire dénommée ’Active l’entrée clavier (et la suppression)’ peut être activée pour les sélections multiples. Cette option est utile si vous voulez ajouter des directives de pré-processeur comme #ifdef sur plusieurs lignes de code source ou si vous voulez superposer ou remplacer du texte en plusieurs endroits.

1.11.10  Repliement de code

Code::Blocks supporte ce qu’on appelle le repliement de code. Avec cette fonctionnalité vous pouvez replier notamment les fonctions dans l’éditeur de Code::Blocks. Un point de repliement est marqué dans la marge gauche de l’éditeur par un signe moins. Dans la marge, le début et la fin d’un point de repliement sont visibles à l’aide d’une ligne verticale. Si vous cliquez sur le signe moins avec le bouton gauche de la souris, la portion de code sera repliée ou dépliée. Via le menu ’Édition’ →’Repliement’ vous pouvez sélectionner le repliement. Dans l’éditeur, un code replié est vu comme une ligne horizontale continue.

Code::Blocks fournit aussi la fonctionnalité de repliement pour les directives du pré-processeur. Pour l’activer, sélectionnez ’Replier les commandes du pré-processeur’ dans l’entrée Repliement de ’Paramètres’ →’Éditeur’ .

Une autre façon de faire est de définir des points de repliement utilisateurs. Le point de départ du repliement s’entre comme un commentaire suivi d’une parenthèse ouvrante et la fin comme un commentaire suivi d’une parenthèse fermante.

//{
code avec repliement défini par l’utilisateur
//}

1.11.11  Auto complétion

Lorsque vous ouvrez un projet dans Code::Blocks les ’Répertoires de recherche’ de votre compilateur et de votre projet, les fichiers sources et d’en-têtes de votre projet sont analysés. De plus les mots clés de l’analyseur syntaxique correspondant sont analysés également. Les informations issues de l’analyse sont alors utilisées pour la fonctionnalité d’auto complétion dans Code::Blocks. Vérifiez s’il vous plait que cette fonctionnalité est bien activée dans l’éditeur. L’auto complétion est accessible au travers du raccourci Ctrl-Espace. Via le menu ’Paramètres’ →’Éditeur’ →’Colorisation syntaxique’ vous pouvez ajouter des mots clés définis par l’utilisateur à votre analyseur syntaxique.

1.11.12  Recherche de fichiers cassés

Lorsqu’un fichier est supprimé du disque, mais est toujours inclus dans un fichier projet <project>.cbp, alors un ’fichier cassé’ sera affiché avec un symbole ”cassé” dans la vue du projet. Vous devriez utiliser ’Enlever ce fichier du projet’ plutôt que de supprimer le fichier.

Dans de gros projets, avec de nombreux sous-répertoires, la recherche de fichiers cassés peut être une grande consommatrice de temps. Avec l’extension ThreadSearch (voir section 2.21) Code::Blocks apporte une solution simple à ce problème. Si vous entrez une expression de recherche dans ThreadSearch et sélectionnez l’option ’Fichiers du projet’ ou ’Fichiers de l’espace de travail’ , alors ThreadSearch analysera tous les fichiers qui sont inclus dans le projet ou l’espace de travail. Si un fichier cassé est trouvé, ThreadSearch génèrera une erreur sur le fichier absent.

1.11.13  Inclure des librairies

Dans les options de génération d’un projet, vous pouvez ajouter les librairies utilisées via le bouton ’Ajouter’ dans l’entrée ’Librairies à lier’ des ’Options de l’éditeur de liens’. Ce faisant, vous pouvez soit utiliser le chemin absolu de la librairie ou seulement donner son nom sans le préfixe lib ni l’extension du fichier.

Exemple

Pour une librairie nommée <path>∖libs∖lib<name>.a, écrire seulement <name>. L’éditeur de liens avec les chemins de recherche correspondants inclura alors correctement les librairies.

1.11.14  Ordre d’édition de liens des fichiers objets

Lors de la compilation, les fichiers objets name.o sont créés à partir des sources name.c/cpp. L’éditeur de liens assemble les fichiers objets individuels pour en faire une application name.exe ou sur d’autre systèmes name.elf. Dans certains cas, il peut être préférable de prédéfinir l’ordre dans lequel seront liés les fichiers objets. Vous pouvez obtenir cela dans Code::Blocks en assignant des priorités. Dans le menu de contexte ’Propriétés’ , vous pouvez définir les priorités d’un fichier dans l’onglet Générer. Une priorité faible fera que le fichier sera lié plus tôt.

1.11.15  Sauvegarde automatique

Code::Blocks offre la possibilité d’enregistrer automatiquement les projets et les fichiers sources, ou encore de créer des copies de sauvegarde. Cette fonctionnalité peut être activée dans le menu ’Paramètres’ →’Environnement’ →’Sauvegarde-auto’ . Ce faisant, ’Enregistrer dans un fichier .save’ doit être spécifié comme méthode de création de copie de sauvegarde.

1.11.16  Configuration des extensions de fichiers

Dans Code::Blocks, vous pouvez choisir entre plusieurs méthodes de traitement des extensions de fichiers. La boîte de dialogue de configuration s’ouvre par ’Paramètres’ →’Gestion des extensions de fichiers’ . Vous pouvez alors soit utiliser les applications assignées par Windows pour chaque extension de fichier (l’ouvrir avec l’application associée), ou changer la configuration pour chaque extension de telle façon que ce soit un programme défini par l’utilisateur qui soit lancé (lancer un programme externe), ou que ce soit Code::Blocks qui ouvre le fichier dans son éditeur (l’ouvrir dans l’éditeur de Code::Blocks).

1.12  Code::Blocks en ligne de commande

L’Environnement de Développement Intégré (IDE) Code::Blocks peut être exécuté depuis une ligne de commande sans interface graphique. Dans ce cas, plusieurs options sont disponibles pour contrôler le processus de génération d’un projet. Comme Code::Blocks peut être piloté par des ”scripts”, la création d’exécutables peut être intégrée dans vos propres processus de travail.

1.12.1  Utilisation des arguments en ligne de commande

Si vous entrez en ligne de commande :
codeblocks /h
Vous verrez une nouvelle fenêtre contenant une liste d’arguments :

Usage: 
codeblocks [/h] [/?] [--safe-mode] [/na] [/nd] [/ni] [/ns] 
          [--multiple-instance] [/d] [/nc] [/v] [--prefix <str>] 
          [--user-data-dir <str>] [/p <str>] [--no-log] [--log-to-file] 
          [--debug-log-to-file] [--profile <str>] [/S] [/D] 
          [--rebuild] [--build] [--clean] [--target <str>] 
          [--no-batch-window-close] [--batch-build-notify] 
          [--script <str>] [--file <str>] 
          [--dbg-config <str>] [--dbg-attach <str>] 
          [filename(s)...]

Windows

1.

Rechercher le raccourci vers Code::Blocks sur le bureau ou via le menu Démarrer.

2.

Clic droit sur l’icône et sélectionner Propriétés.

3.

Sélectionner l’onglet Raccourci.

4.

Ajouter en fin de ligne de commande les arguments que vous voulez utiliser à la suite du texte de la cible (après les guillemets).

5.

Lancer Code::Blocks en utilisant le raccourci que vous avez édité.

Exemple:
codeblocks /na /nd --no-splash-screen --build <name>.cbp --target=’Release’

*nix

1.

Lancer un client de terminal comme XTerm, Gnome Terminal ou Konsole.

2.

Y entrer ”codeblocks” puis ajouter les arguments en ligne de commande que vous voulez utiliser.

Note : Code::Blocks ne peut pas s’exécuter dans une console réelle, X11 doit être en cours d’exécution et vous devez utiliser un émulateur graphique de terminal.

Exemple:
codeblocks --no-splash-screen --debug-log

1.12.2  Arguments en ligne de commande

1.13  Raccourcis Clavier

Cette section décrit les raccourcis clavier qui sont ou peuvent être utilisés dans Code::Blocks.

1.13.1  Introduction

Ce plugin peut être utilisé pour ajouter un ou plusieurs raccourcis clavier aux menus.

Même si une IDE comme Code::Blocks est surtout pilotée à la souris, les raccourcis claviers sont néanmoins un moyen très pratique pour accélérer et simplifier le travail. Les tableaux ci-dessous regroupent quelques-uns des raccourcis claviers disponibles.

1.13.2  Fonctionnalités

Inclue un panneau de configuration et un système complet pour visualiser/supprimer/ajouter/éditer des commandes en raccourcis clavier.

Supporte plusieurs profils de raccourcis clavier et un système complet de chargement/enregistrement est présent.

Permet à l’utilisateur de personnaliser toutes les commandes de menus désirées, et définir des raccourcis clavier pour chacune des commandes.

1.13.3  Utilisation

La page de configuration du plugin est accessible via le menu ’Paramètres’ →’Éditeur’ , en sélectionnant la section Raccourcis Clavier.

Sélectionner une commande dans l’arborescence des Commandes, vous affiche le raccourci actuel pour la commande sur la droite. Sur la figure c’est Open... qui est sélectionné et le raccourci par défaut Ctrl-O est affiché.

Pour ajouter un nouveau raccourci à la commande sélectionnée, suivre les étapes suivantes :

1.

Placer le curseur dans la boîte de texte au-dessous du Nouveau raccourci et presser sur les touches, par exemple F3 ou Ctrl-A.

2.

Vérifier l’assignation courante, et si une autre commande a déjà ce raccourci affecté vous verrez son nom ici. Si le texte dit Aucun c’est que c’est bon.

3.

Presser sur Ajouter pour ajouter le raccourci à la liste.

4.

Presser sur OK dans le dialogue pour enregistrer des changements et retourner dans l’éditeur.

1.13.4  Éditeur

Ceci est une liste des raccourcis fournis par le composant éditeur de Code::Blocks. Ces raccourcis ne peuvent pas être substitués.

1.13.5  Fichiers

Ceci est une liste des raccourcis fournis par le composant éditeur de Code::Blocks. Ces raccourcis ne peuvent pas être substitués.

1.13.6  Vue

1.13.7  Recherche

1.13.8  Générer

1.13.9  Debug

1.14  Chemins sources automatiques

Une interface utilisateur pour les ”globs” de projet, c’est-à-dire une intégration automatique de répertoires sources. Le but est d’imiter la fonction ”glob” de cmake.
Ce paragraphe est recopié (et traduit) du wiki de C::B : https://wiki.codeblocks.org/index.php/Automatic_source_paths. Vous pouvez aussi jeter un oeil à la discussion sur le forum: https://forums.codeblocks.org/index.php/topic,25276.0.html.

1.14.1  Introduction

Les chemins sources automatiques sont une fonctionnalité de Code::Blocks pour mettre à jour automatiquement dans un fichier projet de Code::Blocks des dossiers modifiés dans des répertoires source. Un cas typique d’utilisation est, par exemple, lorsqu’un programme externe crée des fichiers sources qui sont utilisés dans Code::Blocks. Avec les chemins sources automatiques, Code::Blocks détecte automatiquement les changements (ajout et suppression de fichiers source) dans un répertoire donné et les reflète dans le fichier projet.

1.14.2  Interface Utilisateur

La fonctionnalité est accessible via l’entrée de menu ’Projet’ →’Chemins sources automatiques...’ :

Cela ouvre le dialogue de synthèse

Chemin

: Le chemin de base dans lequel les fichiers sont recherchés pour l’importation automatique

Récursif

: Recherche aussi dans les sous-répertoires

Joker

: Filtrer les fichiers en fonction de ce caractère générique (par exemple : *.cpp : importe uniquement les fichiers se terminant par .cpp

Ajouter

: Ajouter un nouveau chemin

Supprimer

: Supprimer de la liste le chemin actuellement sélectionné

Édition

: Éditer le chemin actuellement sélectionné de la liste

L’ajout ou l’édition d’un chemin ouvre la boîte de dialogue Éditer le chemin

1.

Le chemin vers la surveillance automatique

2.

Ouvre la boîte de dialogue du chemin sur le système pour sélectionner le chemin à surveiller automatiquement

3.

Ouvre le dialogue des variables globales pour sélectionner une variable globale qui est remplacée et surveillée par Code::Blocks

4.

Si cette case est cochée, tous les sous-répertoires de ce chemin sont également surveillés

5.

Une liste de caractères de remplacement séparés par des ’;’ pour les extensions de fichiers qui sont importées pour ce ”glob” (ex. : *.h pour n’importer que les fichiers d’en-tête, *.cpp;*.h pour importer les fichiers cpp et h)

6.

Sélection des cibles où les fichiers trouvés dans le chemin sont ajoutés

7.

Case à cocher pour sélectionner les cibles toutes/aucunes

8.

Si cette case est cochée les fichiers seront ajoutés au fichier projet. Le fichier projet sera modifié chaque fois qu’un fichier sera trouvé. Ceci permet de modifier les propriétés d’un fichier (comme une cible ou les flags de l’éditeur de liens). Les propriétés sont enregistrées dans le fichier projet et rechargées lorsque le projet est rechargé. Si cette case n’est pas cochée, les fichiers sont bien chargés lors de l’exécution de Code::Blocks, mais ne sont pas enregistrés dans le fichier projet, et donc les propriétés du fichier ne peuvent pas être sauvegardées et seront perdues.

1.14.3  Exemple

Dans cet exemple nous utilisons la stucture de répertoire suivante :

Supposons que les fichiers dans src sont ajoutés/supprimés automatiquement par un logiciel tiers. En ajoutant maintenant un dossier source automatique dans Code::Blocks, les fichiers seront automatiquement ajoutés/supprimés s’ils sont modifiés dans le système de fichiers.

2  Extensions

La plupart des extensions décrites dans ce chapitre le sont également dans le Wiki. Les figures et les textes ont été copiés du Wiki mais adaptées pour être incluses dans des documents Latex (Miktex 2.9).

2.1  Généralités

On peut étendre les fonctionnalités de Code::Blocks en utilisant des extensions (ou plugins ou greffons, termes que l’on gardera parfois par commodité ci-dessous). Il y a généralement trois types de plugins :

Core plugins :

extensions développées et maintenues par l’équipe de base de Code::Blocks.

Contrib plugins :

extensions développées et maintenues par la communauté et reconnues comme étant appréciables. Elles sont donc intégrées dans le dépôt SVN de Code::Blocks.

3rd party plugins :

extensions développées et maintenues par la communauté mais pas (encore?) dans le dépôt de Code::Blocks. Elles ont souvent leur propre dépôt ou ont été postées (incluant le code source) dans les forums.

Si vous recherchez des plugins :

1.

Regardez dans la distribution officielle. Notez que l’installateur / ”package manager” peut vous demander d’activer spécifiquement certains des plugins. Donc LISEZ attentivement.

2.

Cherchez les annonces dans les forums, en particulier les forums de https://forums.codeblocks.org/index.php/board,14.0.html.

3.

Il peut y avoir des informations sur le Wiki concernant d’autres plugins dans ses pages et ici : https://wiki.codeblocks.org/index.php/Announcement_for_plugins/patches.

Pour les utilisateurs de Windows, le comportement par défaut de l’installateur est de ne pas installer les ”contrib plugins”. Vous devez manuellement cocher la case ”contrib plugin” quand on vous proposera une sélection des composants à installer. Il n’y a pas franchement de moyen de les installer manuellement après coup.

Si vous développez des plugins (ou extensions) : Bien sûr, vous pouvez travailler sur des plugins/extensions comme bon vous semble, mais voici quelques suggestions:

  Annoncez-les sur le ”plugin development board” dans les forums - en y incluant le code source (initial).

OU

  Créez votre propre page Web (ou utilisez une plate-forme de partage de fichiers) puis postez le lien d’accès vers les sources/binaires/svn sur le ”plugin development board” dans les forums.

OU

  Créez un dépôt, par exemple sur BerliOS ou SourceForge, postez le lien d’accès vers les sources/binaires/svn sur le ”plugin development board” dans les forums. Veuillez noter : C’est la meilleure façon de faire car les fichiers attachés dans nos forums peuvent être supprimés de temps en temps. Ce n’est donc pas très sûr de poster du code dans les forums.

ENFIN

  Entrez la description des plugins/extensions sur cette page.

  Annoncez le plugin en utilisant le formulaire sur https://wiki.codeblocks.org/index.php/Template_for_plugin_announcement

2.2  Astyle

Artistic Style est un indenteur de code source, un formateur de code source et un embellisseur de code source pour les langages de programmation C, C++, C#. Il peut être utilisé pour sélectionner différents styles de règles de codage dans les Code::Blocks.

Quand on indente un code source, nous en tant que programmeurs avons tendance à utiliser à la fois des espaces et des caractères de tabulations pour créer l’indentation souhaitée. De plus, certains éditeurs insèrent par défaut des espaces à la place des tabulations quand on appuie sur la touche Tab, alors que d’autres éditeurs ont la faculté de rendre d’embellir les lignes en ajoutant automatiquement des espaces en début de lignes, éventuellement en remplaçant dans ce code les tabulations utilisées jusqu’alors pour l’indentation par des espaces.

Comme le nombre de caractères affichés sur l’écran pour chaque caractère de tabulation change d’un éditeur à l’autre, un des problèmes courants auquel est confronté un programmeur qui passe d’un éditeur à un autre est qu’un code qui contient à la fois des espaces et des tabulations et qui était jusqu’à présent bien indenté, devient soudain difficile à regarder après le changement d’éditeur. Même si en tant que programmeur vous faites attention à n’utiliser QUE des espaces ou QUE des tabulations, récupérer un code de quelqu’un d’autre peut malgré tout être problématique.

C’est pour résoudre ce problème qu’Artistic Style a été créé - un filtre écrit en C++ qui ré-indente et reformate automatiquement les fichiers sources en C / C++ / C#.

2.3  AutoVersioning

Une application de suivi de versions qui incrémente les numéros de version et de génération de votre application à chaque fois qu’un changement est effectué et l’enregistre dans un fichier version.h avec des déclarations de variables faciles à utiliser. Possède également une option pour proposer des changements dans un style à la SVN, un éditeur de schémas de versions, un générateur de journal des changements, et bien d’autres choses encore …

2.3.1  Introduction

L’idée de développer l’extension AutoVersioning est venue lors du développement d’un logiciel en version pre-alpha qui exigeait des informations de version et d’état. Trop occupé par le codage, sans temps disponible pour maintenir la numérotation des versions, l’auteur a décidé de développer une extension qui puisse faire le travail avec aussi peu d’interventions que possible.

2.3.2  Fonctionnalités

Voici résumée la liste des fonctions couvertes par l’extension :

• Supporte C et C++.

• Génère et incrémente automatiquement des variables de versions.

• Éditeur de l’état du logiciel.

• Éditeur de schéma intégré pour changer le comportement de l’auto incrémentation des valeurs de versions.

• Déclaration des dates en mois, jour et année.

• Style de version Ubuntu.

• Contrôle des révisions Svn.

• Générateur de journal des changements.

• Fonctionne sous Windows et Linux.

2.3.3  Utilisation

Aller simplement dans le menu ’Projet’ →’Autoversioning’ . Une fenêtre popup comme celle-ci apparaîtra :

Quand on répond Oui au message de demande de configuration, la fenêtre principale de configuration d’AutoVersioning s’ouvre pour vous permettre de paramétrer les informations de version de votre projet.

Après avoir configuré votre projet pour la mise en version automatique, les paramètres entrés dans la boîte de dialogue de configuration sont enregistrées dans le fichier de projet et un fichier version.h est créé. Pour le moment, chaque fois que vous entrez dans le menu ’Projet’ →’Autoversioning’ , le dialogue de configuration qui apparaît vous permet d’éditer votre version de projet et les paramètres qui y sont liés, à moins que vous n’enregistriez pas les nouveaux changements effectués par l’extension dans le fichier de projet.

2.3.4  Onglets de la boîte de dialogue

Valeurs de Version

Ici vous entrez simplement les valeurs de version adéquates ou laissez l’extension Autoversioning le faire pour vous (voir figure 2.3).

Version Majeure

Incrémenté de 1 quand le numéro mineur atteint son maximum

Version mineure

Incrémenté de 1 quand le numéro de génération dépasse la barrière de nombre de générations, la valeur étant remise à 0 quand il atteint sa valeur maximale.

Numéro de génération

(également équivalent à numéro de Release) - Incrémenté de 1 chaque fois que le numéro de révision est incrémenté.

Révision

Incrémenté aléatoirement quand le projet a été modifié puis compilé.

État

Quelques champs pour garder une trace de l’état de votre logiciel avec une liste de valeurs prédéfinies usuelles (voir figure 2.4).

État du logiciel

Un exemple typique pourrait être v1.0 Alpha

Abréviation

Idem à l’état du logiciel mais comme ceci : v1.0a

Schéma

Vous permet d’éditer comment l’extension incrémentera les valeurs de version (voir figure 2.5).

Valeur max pour numéro mineur

Valeur maximale que peut atteindre la valeur mineure. Une fois cette valeur atteinte, le numéro Majeur est incrémenté de 1 et à la compilation suivante le numéro mineur sera remis à 0.

Nombre max de générations

Quand cette valeur est atteinte, le compteur sera remis à 0 à la génération suivante. Mettre à 0 pour ne pas limiter.

Révision maximale

Comme Nombre max de générations. Mettre à 0 pour ne pas limiter.

Révision aléatoire maximale

Les révisions s’incrémentent par un nombre aléatoire que vous décidez. Si vous mettez 1, les révisions s’incrémenteront évidemment par 1.

Nombre de générations avant d’incrémenter Mineur

Après des changements de code et des compilations avec succès, l’historique des générations s’incrémente, et quand cette valeur est atteinte alors la valeur Mineure s’incrémente.

Paramètres

Ici vous pouvez entrer certains paramètres du comportement d’Autoversioning (voir figure 2.6).

Auto-incrémente Majeur et Mineur

Laisse l’extension incrémenter ces valeurs en utilisant le schéma. Si non coché, seuls les numéros de génération et de Révision s’incrémenteront.

Créer des déclarations de dates

Crée des entrées dans le fichier version.h avec des dates et un style de version à la façon d’Ubuntu.

Incrémentation automatique

Indique à l’extension d’incrémenter automatiquement dès qu’une modification est faite. Cette incrémentation interviendra avant la compilation.

Langage de l’en-tête

Sélectionne le langage de sortie du fichier version.h

Interroger pour incrémenter

Si Incrémentation automatique est coché, on vous interroge alors avant la compilation (si des changements ont été effectués) pour incrémenter les valeurs de version.

Svn activé

Recherche dans le répertoire courant la révision Svn et la date puis génère les entrées correspondantes dans version.h

Journal des changements

Ceci vous permet d’entrer chaque changement effectué au projet afin de générer un fichier ChangesLog.txt (voir figure 2.7).

Afficher les changements quand la version s’incrémente

Affichera une fenêtre popup d’édition de journal quand la version est incrémentée.

Format du Titre

Un titre formaté avec une liste de valeurs prédéfinies.

2.3.5  Inclusion dans votre code

Pour utiliser les variables générées par l’extension faire simplement #include <version.h>. Le code suivant est un exemple de ce qu’on peut faire :

#include <iostream> 
#include "version.h" 
 
void main(){ 
   std::cout<<AutoVersion::Major<<endl; 
}

Sortie de version.h

Le fichier d’en-tête généré. 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 c’est la même chose qu’en 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"; 
   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.3.6  Générateur de journal des changements

Cette boîte de dialogue est accessible à partir du menu ’Projet’ →’ Journal des changements’ . Également si la case ”Afficher l’éditeur des changements quand la version s’incrémente” est cochée, une fenêtre s’ouvrira pour vous permettre d’entrer la liste des changements après une modification des sources du projet ou un évènement d’incrémentation (voir figure 2.8).

Résumé des Boutons

Ajouter

Ajoute une ligne à la grille de données

Éditer

Active les modifications de la cellule sélectionnée

Supprimer

Supprime la ligne courante de la grille de données

Enregistrer

Enregistre dans un fichier temporaire (changes.tmp) les données actuelles pour pouvoir effectuer plus tard les entrées dans le journal des changements

Écrire

Entre la grille de données dans le journal des changements

Annuler

Ferme simplement la boîte de dialogue sans rien faire d’autre

Voici un exemple de sortie générée par l’extension 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 
   released version 0.7.32 of AutoVersioning-Linux 
 
    Change log: 
       -Documented some areas of the code 
       -Reorganized the code for readability 
 
01 September 2007 
   released version 0.7.30 of AutoVersioning-Linux 
 
    Change log: 
       -Edited the change log window 
       -If the change log windows is leave blank no changes.txt is modified

2.4  Browse Tracker (Suivi de Navigation)

Browse Tracker est une extension qui aide à naviguer parmi les fichiers récemment ouverts dans Code::Blocks.

La liste des fichiers récents est sauvegardée dans un historique. Le menu ’Affichage’ →’Suivi de Navigation’ →’Tout Effacer’ permet d’effacer l’historique.

Dans les différents ’onglets’ vous pouvez naviguer entre les divers éléments des fichiers récemment ouverts en utilisant l’entrée de menu ’Affichage’ →’Suivi de Navigation’ →’Aller en arrière/Aller en avant’ ou en utilisant les raccourcis claviers Alt-Gauche/Alt-Droit. Le menu de suivi de navigation est également accessible dans les menus de contexte. Les marqueurs sont enregistrés dans un fichier de mise en page <projectName>.bmarks

Quand on développe du logiciel, on passe souvent d’une fonction à une autre implémentée dans différents fichiers. L’extension de suivi de navigation vous aidera dans cette tâche en vous montrant l’ordre dans lequel ont été sélectionnés les fichiers. Vous pouvez alors naviguer confortablement dans les différents appels de fonctions.

L’extension permet même de naviguer entre les marqueurs de chaque fichier de l’éditeur de Code::Blocks. La position du curseur est mémorisée pour chacun des fichiers. Vous pouvez poser ces marqueurs en utilisant le menu ’Affichage’ →’ Suivi de Navigation’ →’ Activer le marquage de navigation’ ou en sélectionnant une ligne avec le bouton gauche de la souris. Une marque … est alors posée dans la marge gauche. Avec les menus ’Vue’ →’Suivi de Navigation’ →’Marque précédente/Marque suivante’ ou les raccourcis Alt-up/Alt-down vous pouvez naviguer entre les différents marques posées dans un fichier. Si vous voulez naviguer dans un fichier avec des marques triées en fonction du numéro 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 sélectionnée est supprimé. Si un marqueur est posé sur une ligne, le fait d’appuyer 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 marquée, vous remettez à 0 tous les marqueurs d’un fichier.

Le paramétrage de l’extension peut être configuré via le menu ’Paramètres’ →’Éditeur’ →’Browse Tracker’ .

Styles des marques

Les marques de navigation sont affichées par défaut comme des … dans la marge. Avec le choix ’Book_Marks’ elles seront affichées en tant que marque par une flèche bleue dans la marge. L’option ”hide” supprime l’affichage des marques. Note : Ces options ont été supprimées récemment du greffon mais existent encore dans des versions de Code::Blocks plus anciennes. Seul l’affichage par flèche bleue est resté.

Touche de basculement du suivi de navigation

Les marques peuvent être activées ou supprimées soit par un simple clic avec le bouton gauche de la souris soit avec un clic-gauche tout en maintenant la touche Ctrl enfoncée.

Délai avant d’activer le basculement Souris_Gauche

Durée pendant laquelle le bouton gauche de la souris doit être est enfoncé avant d’entrer dans le mode de marquage de navigation.

Supprimer toutes les marques de navigation

tout en maintenant enfoncée la touche Ctrl soit par simple clic soit par double-clic sur le bouton gauche de la souris.

La configuration de l’extension est enregistrée dans votre répertoire application data dans le fichier default.conf. Si vous utilisez la fonctionnalité des profils (ou personnalité) de Code::Blocks, la configuration est alors lue dans votre fichier <personality>.conf.

2.5  CodeSnippets

L’extension CodeSnippets permet de structurer des modules de texte et des liens vers des fichiers en fonction de catégories dans une vue arborescente. Les modules sont utilisés pour stocker des fichiers fréquemment utilisés, des constructions de modules de texte, le tout géré depuis un endroit centralisé. Imaginez la situation suivante : Un certain nombre de fichiers source fréquemment utilisés sont stockés dans divers répertoires du système de fichiers. La fenêtre de CodeSnippets vous donne l’opportunité de créer des catégories et, à l’intérieur de ces catégories, des liens vers les fichiers requis. Avec cette fonctionnalité, vous pouvez contrôler l’accès aux fichiers indépendamment de l’endroit où ils sont stockés dans le système de fichiers, et vous pouvez rapidement naviguer entre ces fichiers sans avoir besoin de les chercher un peu partout dans le système.

La liste des modules de texte et des liens peut être enregistrée dans la fenêtre des CodeSnippets en cliquant sur le bouton droit de la souris et en sélectionnant ’Enregistrer l’index’ depuis le menu de contexte. Le fichier codesnippets.xml qui est alors créé par cette procédure, se trouve dans le sous-répertoire codeblocks du répertoire Documents and Settings∖Application data sous Win 7 (ou un chemin équivalent du profil de l’utilisateur, adapté à chaque OS). Sous Linux, cette information est enregistrée dans le sous-répertoire .codeblocks de votre répertoire HOME. Les fichiers de configuration de Code::Blocks seront chargés au démarrage suivant. Si vous souhaitez enregistrer le contenu des CodeSnippets à un autre endroit, sélectionnez l’entrée ’Enregistrer l’index sous’. Pour charger ce fichier, sélectionnez ’Charger le fichier d’index’ lors du démarrage suivant de Code::Blocks ou incluez le répertoire dans les ’Paramètres’ du menu de contexte de ’Répertoire des Snippets’. Les paramétrages sont enregistrés dans le fichier correspondant codesnippets.ini dans votre application data.

Pour inclure une catégorie, utilisez le menu ’Ajouter une sous-catégorie’. Une catégorie peut contenir des Snippets (modules de texte) ou des Liens vers un fichier. Un module de texte est créé via la commande ’Ajouter un Snippet’ depuis le menu de contexte. Le contenu est intégré dans le module de texte comme un ’Nouveau snippet’ en sélectionnant un passage de texte dans l’éditeur de Code::Blocks et en le glissant-déposant sur le module dont les propriétés s’affichent. En double-cliquant sur la nouvelle entrée ou en sélectionnant ’Éditer le Texte’ on en éditera le contenu.

La sortie d’un module de texte est gérée dans Code::Blocks via la commande ’Appliquer’ du menu de contexte ou en faisant un glisser-déposer dans l’éditeur. Sous Windows, le contenu d’un Snippet peut également être glissé-déposé dans d’autres applications. Dans le navigateur de CodeSnippets vous pouvez copier une sélection par glisser-déposer vers une catégorie différente.

De plus, les modules de texte peuvent être paramétrés par des variables <name> qui peuvent être accédées via $(name) (voir figure 2.9). Les valeurs des variables peuvent être récupérées dans un champ d’entrée si le module de texte est appelé via la commande du menu de contexte ’Appliquer’.

À côté des modules de texte, des liens vers des fichiers peuvent aussi être créés. Si, après avoir créé un module de texte, vous cliquez sur la commande ’Propriétés’ du menu de contexte, vous pouvez alors sélectionner une cible de type lien en cliquant sur le bouton ’Lien cible’. Cette procédure convertira automatiquement le module de texte en un lien vers un fichier. Dans CodeSnippets, tous les modules de texte sont marqués par un symbole T, les liens vers un fichier par un symbole F et les urls par un symbole U. Si vous voulez ouvrir un fichier sélectionné (lien) dans la vue des codesnippets, sélectionnez tout simplement le menu de contexte ’Ouvrir le fichier’ ou tout en maintenant enfoncée la touche ’Alt’ effectuez un double-clic sur le fichier.

Avec un tel paramétrage, si vous ouvrez un lien vers un fichier pdf depuis la vue des codesnippets, un visualiseur de fichiers pdf sera automatiquement démarré. Cette méthode rend possible à l’utilisateur l’accès à des fichiers répartis un peu partout sur le réseau, comme des données, mises en forme, documentations etc., à l’aide des applications communes, simplement par le biais d’un lien. Le contenu des codesnippets est enregistré dans le fichier codesnippets.xml, la configuration est enregistrée dans le fichier codesnippets.ini de votre répertoire application data. Ce fichier ini contiendra, par exemple, le chemin du fichier codesnippets.xml.

Code::Blocks supporte l’utilisation de différents profils. Ces profils sont aussi nommés personnalités. En démarrant, avec l’option --personality=<profile>, Code::Blocks en ligne de commande vous créez ou utilisez un profil existant. Dans ce cas, le paramétrage ne sera pas enregistré dans le fichier default.conf, mais plutôt dans un <personality>.conf de votre répertoire application data. L’extension Codesnippets enregistrera alors ses paramètres dans un fichier <personality>.codesnippets.ini. Maintenant, si vous chargez un nouveau contenu <name.xml> dans les paramètres de codesnippets via ’Charger un fichier d’index’, ce contenu sera enregistré dans le fichier ini correspondant. L’avantage de cette méthode tient dans le fait que dans le cas où il y a différents profils, on peut gérer plusieurs configurations de modules de textes et de liens.

L’extension offre une fonction de recherche complémentaire pour naviguer dans les catégories et les Snippets. La façon de rechercher dans les Snippets, catégories ou Snippets et catégories peut s’ajuster. En entrant l’expression de recherche requise, l’entrée correspondante est automatiquement sélectionnée dans la vue. La figure 2.10 affiche une fenêtre CodeSnippets typique.

2.6  Complétion de Code dans Code::Blocks

Deux extensions qui fournissent une fonctionnalité de complétion de code et navigation de classe. Ils ne sont pas compatibles entre-eux. Un seul des deux peut être activé.

2.6.1  Extension de Complétion de Code

CodeCompletion fourni un navigateur de symboles pour vos projets et une complétion de code interne à l’éditeur. Lors de la complétion de code, on utilise un ensemble de symboles pour identifier le type associé avec les éléments suggérés ; ces symboles sont définis dans la table ci-dessous.

Note : Ceci est un document utilisateur de l’extension Code Complétion. Seuls les langages C/C++ sont supportés par cette extension (en l’état actuel)...

2.6.2  Client Clangd pour CB

Ce greffon fournit une fonctionnalité de complétion de code et navigation de classe par Clangd via LSP (Language Server Protocol).

La page d’accueil de l’extension est : https://sourceforge.net/projects/cb-clangd-client/

Le développeur principal est Pecan.

Le forum de discussion correspondant est : Code completion using LSP and clangd
(https://forums.codeblocks.org/index.php/topic,24357.msg166136.html)

Cette documentation est extraite du wiki : https://wiki.codeblocks.org/index.php/CB_Clangd_Client

2.6.2.1 Qu’est-ce que Clangd

clangd comprend votre code en C++ et ajoute des fonctions évoluées à votre éditeur :

• complétion de code

• erreurs à la compilation

• aller à la définition

• aller à l’implémentation

• recherche de références

et bien plus.

clangd est un serveur de langage qui peut fonctionner avec votre éditeur via un greffon.
Code::Blocks vous apporte Clangd_client en tant que greffon utile.

Clangd_client améliore en outre le serveur clangd en fournissant :

• appel d’astuces

• définitions des fonctions

• définitions des paramètres

• fonction de positionnement sur précédent ou suivant

• navigateur de symboles

• aller au fichier

• aller à la fonction

• renommer des symboles

2.6.2.2 Configuration de clangd_client

Clangd_client a besoin d’un exécutable tiers : clangd.

Voir Windows : Compilateur Clangd/Installateur de Package LLVM ci-dessous (2.6.2.5) pour l’installer, ou Linux : Processus d’installation de l’exécutable Clangd (voir 2.6.2.6)

Après l’installation avec succès de l’exécutable clangd, il faut faire ce qui suit :

• Désactivez le greffon ”CodeCompletion”.

• Allez dans ’Extensions’ →’ Gestion des extensions’ et désactivez CodeCompletion.

• Allez dans ’Extensions’ →’ Gestion des extensions’ et activez Clangd_client.

Redémarrez Code::Blocks.

Configurez (ou vérifiez) dans Code::Blocks là où est déclaré l’exécutable clangd :

Allez dans ’Paramètres’ →’ Éditeur’ →’ Clangd_client’ →’ Parseur C/C++ (onglet)’ et vérifiez l’emplacement de l’exécutable de clangd dans la boîte labellée ”Spécifier l’exécutable clangd à utiliser”.

2.6.2.3 Installation de Clangd_client à partir des sources ou d’un binaire pré-généré

1.

Installez LLVM ou Clangd.exe comme documenté dans la section ci-dessous de titre :
Installation sous Windows de l’exécutable Clangd (voir section 2.6.2.5)

2.

Désactivez le greffon Code completion comme suit :

a)

Ouvrez la Gestion des Extensions via le menu de Code::Blocks
’Menu Principal’ →’ Extensions’ →’ Gestion des extensions...’

b)

Dans le dialogue de Gestion des extensions faire ce qui suit :

i.

Recherchez et sélectionnez le greffon ”Code completion” à l’aide de son nom

ii.

Pressez sur le bouton ”Désactiver” sur la droite proche du haut

iii.

Si vous obtenez des erreurs ré-essayez.

3.

Installez le greffon Clangd-Client en utilisant une des options suivantes, qui sont documentées ci-dessous :

a)

Installer via la Gestion des extensions

b)

Installer à la main les fichiers du greffon

4.

Configurez le greffon Clangd-Client en vue de son utilisation comme suit :

a)

Sélectionnez l’élément de menu de Code::Blocks ’Paramètres’ →’ Éditeur...’

b)

Dans la liste sur la gauche cliquez/sélectionnez l’option ”clangd_client”.

c)

Dans l’onglet ”Parseur C/C++” modifiez ”Spécifier l’exécutable clangd à utiliser” pour référencer le clangd.exe que vous avez installé via l’étape 1) ci-dessus.
Quelques exemples de ce que cela pourrait être :

               C:\msys64\clang64\bin\clangd.exe
               C:\msys64\clang32\bin\clangd.exe
               C:\LLVM\bin\clangd.exe
               C:\compilers\clang\clangd.exe
               

2.6.2.4 Suppression Manuelle du greffon Clangd-Client

1.

Quittez Code::Blocks !

2.

Si vous avez installé les fichiers à la main ou utilisé la Gestion des extensions, alors vous pouvez faire ce qui suit :

a)

Dans le répertoire Code::Blocks ...∖share∖CodeBlocks, supprimez le fichier clangd_client.zip

b)

Dans le répertoire Code::Blocks ...∖share∖CodeBlocks∖plugins, supprimez le fichier clangd_client.dll

3.

Si vous avez installé via la Gestion des extensions, alors vous pouvez supprimer les fichiers avec les commandes suivantes :

a)

del %APPDATA%∖CodeBlocks∖share∖codeblocks∖plugins∖clangd_client.dll

b)

del %APPDATA%∖CodeBlocks∖share∖codeblocks∖clangd_client.zip

4.

Si vous voulez ré-utiliser l’ancien ”code completion”, pensez à réactiver le greffon

2.6.2.5 Windows : Installation sous Windows de l’exécutable Clangd

Il y a 3 options principales pour installer clangd.exe:

1.

Installer un compilateur LLVM.

2.

Extraire à la main les fichiers nécessaires du compilateur LLVM.

3.

Installer un package Clangd pour le compilateur Windows que vous utilisez, s’il est disponible.

Les étapes pour effectuer ces trois options sont détaillées ci-dessous.

Windows : Installer le compilateur LLVM

1.

Téléchargez le dernier (non RC/Beta) exécutable LLVM Windows pour votre OS (Win32 ou Win64) depuis la page de téléchargement Github de LLVM :
https://github.com/llvm/llvm-project/releases

Depuis Janvier 2022 les noms des fichiers Windows sont :

           LLVM-<version>-win64.exe
           LLVM-<version>-win32.exe
        

où <version> est la version de LLVM, comme 13.0.0 ou 13.0.1.

2.

Lancez LLVM-<version>-win<xx>.exe que vous avez téléchargé pour installer le compilateur LLVM.

Windows : Extraction Manuelle des fichiers du compilateur LLVM

1.

Téléchargez le dernier (non RC/Beta) exécutable LLVM Windows pour votre OS (Win32 ou Win64) depuis la page de téléchargement Github de LLVM :
https://github.com/llvm/llvm-project/releases

Depuis Janvier 2022 les noms des fichiers Windows sont :

           LLVM-<version>-win64.exe
           LLVM-<version>-win32.exe
        

où <version> est la version de LLVM, comme 13.0.0 ou 13.0.1.

2.

Dézippez le fichier LLVM-<version>-win<xx>.exe que vous avez téléchargé avec 7ZIP ou votre programme ZIP préféré dans un sous-répertoire

3.

Créez un nouveau répertoire pour y placer clangd.exe et ses dll’s

4.

Copiez les fichiers suivants dans ce nouveau répertoire à partir du répertoire où a été dézippé LLVM :

          bin\clangd.exe
          bin\msvcp140.dll
          bin\vcruntime140.dll
          bin\vcruntime140\_1.dll
          

Windows : Compilateur Clangd/Installateur de Package LLVM
En raison du nombre de compilateurs différents disponibles pour Windows, tous ces compilateurs n’auront pas forcément à la fois les fichiers requis pour Clang ou LLVM. Si vous voulez installer un (ou des) package(s) spécifique(s) pour votre compilateur Windows, celui que vous avez, afin d’y utiliser le fichier clangd.exe, veuillez suivre les instructions ci-dessous pour le compilateur spécifique que vous avez installé :

MSYS2 Compiler - MinGW64
Il y a 2 options principales pour installer clangd.exe :

1.

La première option afin de minimiser l’espace disque est d’installer les ”Clang extra tools” en utilisant l’un des packages suivants :

Pour intaller le package faire ce qui suit :

a)

Ouvrir un shell bash via msys2.exe

b)

Y lancer la commande suivante :
pacman -S <Package name in the table above>

”OU”

2.

La seconde option est d’installer la version complète des ”Clang tool chain” comme suit :

a)

Ouvrir un shell bash via msys2.exe

b)

Y lancer la commande suivante :
pacman -S mingw-w64-clang-x86_64-toolchain

MSYS2 Compiler - MinGW32
Il y a 2 options principales pour installer clangd.exe :

1.

La première option afin de minimiser l’espace disque est d’installer les ”Clang extra tools” en utilisant l’un des packages suivants :

Pour installer le package faire ce qui suit :

a)

Ouvrir un shell bash via msys2.exe

b)

Y lancer la commande suivante :
pacman -S <Package name in the table above>

”OU”

2.

La seconde option est d’installer la version complète des ”Clang tool chain” comme suit :

a)

Ouvrir un shell bash via msys2.exe

b)

Y lancer la commande suivante :
pacman -S mingw-w64-clang-i686-toolchain

_______________________________________________________________________________________
Notes vues sur le forum Code::Blocks afin d’éviter un mélange d’exécutables gcc/clangd incompatibles.
_______________________________________________________________________________________
https://forums.codeblocks.org/index.php/topic,24357.msg169412.html#msg169412

Ne mélangez surtout pas mingw64 avec clang64.

Si vous utilisez la version gcc de msys2, (compilateurs dans le répertoire ”msys64∖mingw64∖bin”), vous devriez utiliser ”mingw-w64-x86_64-clang-tools-extra”, (le fichier clangd.exe est dans le répertoire ”msys64∖mingw64∖bin”) soit le même répertoire que votre gcc.exe.

Si vous utilisez la version complète de ”clang tool chain”, (le répertoire ”msys64∖clang64∖bin”), vous devriez utiliser ”mingw-w64-clang-x86_64-clang-tools-extra”.

J’ai trouvé que j’avais fait une grosse erreur : c’est que j’utilisais la chaine d’outils gcc de ”msys64∖mingw64∖bin”, mais que j’utilisais le clangd.exe de ”msys64∖clang64∖bin”. Le résultat, c’est que j’obtenais un grand nombre de messages de diagnostiques et d’erreurs de LSP.
Par chance, j’en ai trouvé la raison, et corrigé ce problème. En espérant que cela serve à d’autres.

2.6.2.6 Linux : Processus d’installation de l’exécutable Clangd

NOTE : Le greffon Clangd_client a besoin d’un exécutable clangd en version 13 ou supérieure.

Vérifiez votre version actuelle de clangd en exécutant clangd --version.
Si le numéro de version est inférieur à 13 vous devrez installer une version plus récente.

Voir https://clangd.llvm.org/installation.html

L’installation d’un package clangd vous donnera couramment une version légèrement plus ancienne.
Testez cela en exécutant apt-get install --dry-run clangd

Depuis le 16/11/2022, c’est la version 10 de clangd qui sera installée.
Si le numéro de version de clangd affiché est inférieur à 13, vous devrez installer une version spécifique comme suit :

Installez un package ”release” (doit être en version 13 ou supérieure):

sudo apt-get install clangd-13 (Doit être en version 13 ou supérieure).

Cela installera clangd dans /usr/bin/clangd-13.

Vous pouvez maintenant configurer le greffon clangd_client en suivant les instructions précédentes dans Configuration de clangd_client (voir section 2.6.2.2

Si vous préférez installer entièrement le package LLVM/Clang, parce que c’est ce que vous voulez, il existe un script automatique d’installation disponible pour vous installer LLVM.

Pour installer la dernière version stable : voir https://apt.llvm.org/, ”Automatic installation script”. Notez que dans ce script, vous devrez spécifier le numéro de version voulu.

2.7  CScope

Ce paragraphe est une extraction traduite du contenu de ”cscope plugin” dans le wiki.

2.7.1  Généralités

Ce greffon intègre les fonctionnalités de recherche dans un code de Cscope dans Code::Blocks (une version pour Windows est disponible dans Cscope-win32). Cscope est particulièrement utile sur de gros projets, et peut rechercher :

• toutes les références à un symbole

• les définitions globales

• les fonctions appelées par une fonction

• les fonctions appelant une autre fonction

• des chaînes de texte

• un modèle d’expression régulière

• un fichier

• des fichiers incluant un autre fichier

Bien que l’analyseur syntaxique de Cscope soit ciblé sur du C, il conserve suffisamment de flexibilité pour fournir ses fonctionnalités sur du code en C++ (et Java).

2.7.2  Installation de CScope

Ces instructions sont pour Code::Blocks, Version de SVN >11828.

2.7.2.1 Linux

Sous Linux, installer cscope devrait être aussi simple que d’appeler votre gestionnaire de ”packages” préféré pour installer cscope. Code::Blocks devrait trouver l’exécutable par défaut. S’il ne peut pas trouver l’exécutable de cscope, veuillez le configurer dans ’Paramètres’ →’Environnement’ →’CScope’ . Vous pouvez trouver le chemin vers l’exécutable cscope en tapant locate cscope dans votre terminal préféré.

2.7.2.2 Windows

Il est assez difficile de trouver un binaire précompilé de cscope sous Windows. La solution la plus simple est d’installer msys2. Suivez les instructions sur le site web [ MSys2] pour installer msys2. Après avoir installé et mis à jour comme décrit, ouvrez le terminal de msys et tapez pacman -S cscope. Ceci installera cscope depuis le dépôt global de ”packages”.

Maintenant vous devez configurer Code::Blocks:

• Ouvrir Code::Blocks

• ’Paramètres’ →’Environnement’ →’CScope’

• Cliquer sur le bouton ... avec 3 points

• Rechercher l’exécutable cscope.exe. Il est probablement situé dans
  REPERTOIRE_INSTALLATION_DE_MSYS2∖usr∖bin∖cscope.exe

• Fermer le dialogue via OK

• Maintenant vous devriez pouvoir utiliser les fonctions de cscope dans Code::Blocks (par ex. ”Rechercher les fonctions appelant XXXX”).

2.8  Doxyblocks

DoxyBlocks est une extension pour Code::Blocks qui intègre doxygen dans l’IDE. Il vous permet de créer de la documentation, insérer des blocs de commentaires et de lancer des documents HTML ou CHM. Il fournit également la configuration de quelques-uns des paramètres les plus communément utilisés pour un accès à doxywizard afin d’obtenir une configuration plus détaillée.

Les paramètres de la barre d’outils de DoxyBlocks ont la signification suivante :

class="description">

Lancer doxywizard. Ctrl-Alt-D

class="description">

Extraire la documentation du projet courant. Ctrl-Alt-E

class="description">

Insère un bloc de commentaires sur la ligne courante. De plus, DoxyBlocks essaiera de façon intelligente de lire si une méthode existe dans la ligne où le commentaire est en train d’être ajouté. Ctrl-Alt-B

/** \brief 
 * 
 * \param bar bool 
 * \return void 
 * 
 */ 
void MyClass::Foo(bool bar) 
{ 
   fooBar(bar); 
}

class="description">

Insère une ligne de commentaire à la position actuelle du curseur. Ctrl-Alt-L

void MyClass::Foo(bool bar) 
{ 
   fooBar(bar); /**<  */ 
}

class="description">

Affiche la documentation HTML générée. Ctrl-Alt-H

class="description">

Affiche la documentation CHM (Help) générée. Ctrl-Alt-C

class="description">

Ouvre les préférences de DoxyBlocks. Ctrl-Alt-P

Doxyblocks ne peut travailler que si doxygen est installé sur votre système. Vous avez besoin au moins des exécutables de doxygen et de doxywizard (disponibles dans la distribution officielle de doxygen sur https://www.doxygen.nl/). En option, vous pouvez avoir l’exécutable ”dot” du package graphviz (voir https://graphviz.gitlab.io/. Sous Windows, le compilateur d’aide (hhc) peut également être utilisé les fichiers de type chm.

Notes

Dans les préférences, vous avez une case à cocher qui autorise ou pas DoxyBlocks à écraser le fichier doxyfile. Par défaut, si un doxyfile existe déjà il ne sera pas écrasé pour protéger de divers changements qui auraient pu être faits en dehors de DoxyBlocks. Néanmoins ce comportement empèche aux changements faits par DoxyBlocks lui-même d’être écrits dans le doxyfile existant.

Si un champ de texte des ”Préférences” est vide, DoxyBlocks assumera que l’exécutable correspondant est disponible quelquepart via votre variable d’environnement path. Vous pouvez utiliser des macros telles que $(CODEBLOCKS) dans votre path et elles seront automatiquement étendues.

OUTPUT_DIRECTORY

Utilisé pour spécifier le chemin de base (relatif ou absolu) ou sera enregistrée la documentation générée. Si un chemin relatif est entré, il sera en relatif par rapport à l’emplacement d’où doxygen a été lancé. Si laissé en blanc, c’est le répertoire courant qui sera utilisé. Doxyblocks utilisera le nom de chemin entré ici pour créer un répertoire relatif au <rep. projet>. Ceci vout permet de créer des répertoire doxygen différents pour des projets inclus dans un même répertoire, ou simplement utiliser un nom de répertoire différent. Si le champ est laissé en blanc, les documents seront créés dans ”<rep. projet>/doxygen”. Entrer les noms de répertoires sans points, ni séparateurs de tête, ni nom de volume, etc. DoxyBlocks effectue la validation sur le nom de chemin et supprime les caractères en trop.

      Exemples:
      [blanc]           -> <répertoire projet>/doxygen.
      "docs"            -> <répertoire projet>/docs.
      "docs/sub1/sub2"  -> <répertoire projet>/docs/sub1/sub2.
      "doxygen/docs"    -> <répertoire projet>/doxygen/docs.

OUTPUT_LANGUAGE

Utilisé pour spécifier dans quelle langue sera générée la documentation par doxygen. Doxygen utilisera cette information pour générer toutes les sorties constantes dans la langue adéquate. La langue par défaut est l’anglais. D’autres langues sont supportées.

D’autres informations dans les fichiers d’aide de doxygen

2.9  Extension Editor Tweaks

Le plugin EditorTweaks (modifications d’édition) apporte plusieurs fonctionnalités différentes. Sur une base de travail fichier à fichier, il contrôle :

• le repliement de mots ;

• la numérotation des lignes ;

• l’interprétation de la touche tab (caractère de tabulation ou espaces) ;

• le nombre de caractères espace remplaçant la touche tab ;

• les caractères de fin de ligne (carriage-return + linefeed; carriage-return; linefeed) ;

• la visualisation des caractères de fin de ligne ;

• sur demande, la suppression des espaces blancs en fin de ligne ;

• sur demande, la synchronisation des caractères de fin de ligne ;

• la suppression de la touche d’insertion.

Depuis la fusion avec le plugin ”Aligner”, il peut rendre des sections de code plus lisibles en les alignant sur un caractère spécifique.
Par exemple, aligner sur le caractère ”=” dans :

int var = 1; 
int longVarName = 2; 
int foobar = 3;

se traduira par :

int var        = 1; 
int longVarName = 2; 
int foobar     = 3;

2.10  Extension Variables d’Environnement

D’après le wiki de Code::Blocks. Voir aussi la section 1.11.3.

L’extension Éditeur de variables d’environnement permet de définir des variables d’environnement du système dans le cadre de Code::Blocks.
L’utilisateur peut avoir plusieurs ensembles qui contiennent 1..n variables d’environnement.
L’utilisateur peut passer d’un ensemble à l’autre via la boîte de dialogue de configuration des variables d’environnement.
En outre, l’extension EnvVars apporte une option aux projets (dans la configuration du projet) pour appliquer un ensemble EnvVar particulier à activer (et à utiliser pendant la compilation).

La boîte de dialogue permettant de modifier les ensembles se trouve dans ’Paramètres’ →’Environnement’ →’Variables d’environnement’ .
La boîte de dialogue permettant de choisir l’ensemble actif pour le projet en cours se trouve dans ’Projet’ →’Propriétés’ →’Options EnvVar’ .

Script binding

Cette extension apporte sa fonctionnalité via un ”squirrel binding” :

NOTE : Les arguments ”value” sont automatiquement générés à partir des macros. Vous n’avez pas besoin d’appeler ReplaceMacros() sur ceux-ci.

Beaucoup d’autres fonctions de script sont disponibles. Regardez dans https://wiki.codeblocks.org/index.php/Scripting_commands

Exemple

Dans les fenêtres des étapes de post ou pré-génération :

[[EnvvarApply(_("test"),_("testValue"));]] 
echo %test%

2.11  Extensions FileManager et PowerShell

L’explorateur de fichiers figure 2.13 est inclus dans l’extension FileManager, et se trouve dans l’onglet ’Fichiers’. L’aspect de File Explorer est montré à la figure 2.13.

En haut vous trouverez le champ d’entrée du chemin. En cliquant sur le bouton à l’extrémité de ce champ, la flèche vers le bas listera un historique des entrées précédentes dans lesquelles on peut naviguer à l’aide d’une barre de défilement. La flèche vers le haut à droite du champ déplace d’un cran vers le haut dans la structure des répertoires.

Dans le champ ’Joker’ vous pouvez entrer un filtre de visualisation pour l’affichage des fichiers. En laissant vide ce champ ou en y entrant * vous afficherez tous les fichiers. En y entrant *.c;*.h par exemple, vous n’afficherez que les fichiers sources en C et les fichiers d’en-têtes (headers). Ouvrir la flèche du bas, affiche de nouveau la liste des dernières entrées.

Appuyer sur la touche Maj tout en cliquant, sélectionne un groupe de fichiers ou de répertoires, alors qu’appuyer sur la touche Ctrl tout en cliquant sélectionne des fichiers multiples ou des répertoires séparés.

Les opérations suivantes peuvent être obtenues via le menu de contexte si un ou plusieurs répertoires ont été sélectionnés dans l’Explorateur de Fichiers :

Make Root

défini le répertoire courant comme répertoire de base.

Ajouter aux favoris

configure un marqueur pour ce répertoire et l’enregistre dans les favoris. Cette fonction permet de naviguer rapidement entre des répertoires fréquemment utilisés ou encore sur des disques réseau.

Nouveau Fichier

crée un nouveau fichier dans le répertoire sélectionné.

Nouveau Répertoire

crée un nouveau sous répertoire dans le répertoire sélectionné.

Les opérations suivantes peuvent être obtenues via le menu de contexte si un ou plusieurs fichiers ou même un ou plusieurs répertoires ont été sélectionnés dans l’Explorateur de Fichiers :

Dupliquer

copie un fichier/répertoire et le renomme.

Copier vers

ouvre une boîte de dialogue pour entrer un répertoire cible dans lequel on copiera les fichiers/répertoires.

Déplacer vers

déplace la sélection vers un autre endroit.

Supprimer

supprime les fichiers/répertoires sélectionnés.

Afficher les fichiers masqués

active/désactive l’affichage des fichiers systèmes masqués. Si activé, le menu est coché par un marqueur.

Actualiser

actualise l’affichage de l’arborescence des répertoires.

Les opérations suivantes peuvent être obtenues via le menu de contexte si un ou plusieurs fichiers ont été sélectionnés dans l’Explorateur de Fichiers :

Ouvrir dans l’éditeur CB

ouvre le fichier sélectionné dans l’éditeur de Code::Blocks.

Renommer

renomme le fichier sélectionné.

Ajouter au projet actif

ajoute le(s) fichier(s) au projet actif.

On peut spécifier via la commande de menu ’Paramètres’ →’Environnement’ →’PowerShell’ des fonctions utilisateur. Dans le masque de PowerShell, une nouvelle fonction qui peut être nommée aléatoirement, est créée via le bouton ’Nouveau’. Dans le champ ’ShellCommand Executable’, le programme exécutable est spécifié, et dans le champ en bas de la fenêtre, des paramètres additionnels peuvent être passés au programme. En cliquant sur la fonction dans le menu de contexte ou dans le menu de PowerShell, la fonction s’exécute et traite les fichiers/répertoires sélectionnés. La sortie est redirigée vers une fenêtre de Shell séparée.

Par exemple une entrée de menu a été créée dans ’PowerShell’ →’SVN’ et dans le menu de contexte en tant que ’SVN’. Dans ce contexte $file signifie le fichier sélectionné dans l’explorateur de fichiers, $mpath les fichiers ou répertoires sélectionnés (voir section 3.2).

 Add;$interpreter add $mpaths;;;

Celle-ci et toutes les commandes suivantes créeront un sous-menu, dans ce cas ’Extensions’ →’SVN’ →’Ajouter’ . Le menu de contexte est étendu de même. Cliquez sur la commande du menu de contexte pour faire exécuter la commande SVN add sur les fichiers/répertoires sélectionnés.

TortoiseSVN est un programme SVN très répandu qui s’intègre dans l’explorateur. Le programme TortoiseProc.exe de TortoiseSVN peut être démarré en ligne de commande et affiche une boîte de dialogue pour y entrer les données de l’utilisateur. Ainsi vous pouvez lancer des commandes, disponibles en tant que menus de contexte dans l’explorateur, également en ligne de commande. Vous pouvez donc l’intégrer en tant qu’extension du Shell dans Code::Blocks. Par exemple, la commande

TortoiseProc.exe /command:diff /path:$file

affichera les différences entre un fichier sélectionné dans l’explorateur de Code::Blocks et celui de la base de SVN. Voir figure 2.14 comment intégrer cette commande.

Exemple

Vous pouvez utiliser l’explorateur de fichiers pour afficher les différences sur des fichiers ou des répertoires. Suivez les étapes suivantes :

1.

Ajoutez le nom via le menu ’Paramètres’ →’Environnement’ →’PowerShell’ . C’est affiché comme une entrée par l’interpréteur de menu et le menu de contexte.

2.

Sélectionnez le chemin absolu de l’exécutable Diff (notamment kdiff3). Le programme est accédé avec la variable $interpreter.

3.

Ajoutez les paramètres de l’interpréteur

Diff;$interpreter $mpaths;;;

Cette commande sera exécutée en utilisant les fichiers ou répertoires sélectionnés en tant que paramètres. La sélection peut être accédée via la variable $mpaths. Ceci est une façon commode de différentier des fichiers ou des répertoires.

$interpreter

Appelle cet exécutable.

$fname

Nom du fichier sans son extension.

$fext

Extension du fichier sélectionné.

$file

Nom du fichier.

$relfile

Nom du fichier sans l’information de chemin.

$dir

Nom du répertoire sélectionné.

$reldir

Nom du répertoire sans l’information de chemin.

$path

Chemin absolu.

$relpath

Chemin relatif du fichier ou du répertoire

$mpaths

Liste des fichiers et répertoires sélectionnés actuellement

$inputstr{ msg }

Chaîne de caractères qui est entrée dans une fenêtre de message.

$parentdir

Répertoire Parent (../).

2.12  Éditeur Hexadécimal

Comment ouvrir un fichier via HexEditor dans Code::Blocks.

1.

’Fichier’ →’ Ouvrir avec HexEditor’

2.

Menu contextuel du navigateur de projet (’Ouvrir avec’ →’Hex editor’

3.

Sélectionnez l’onglet Fichier dans le panneau de gestion. En sélectionnant un fichier dans le Gestionnaire de fichiers et en exécutant le menu contextuel ’Ouvrir avec Hex Editor’ , le fichier s’ouvre dans HexEditor.

Répartition des fenêtres :

À gauche la Vue de HexEditor et à droite l’affichage sous forme de chaînes de caractères

Ligne du haut : Position actuelle (valeur en décimal/hex) et pourcentage (rapport entre la position actuelle du curseur et le fichier complet).

Boutons :

Fonctions de recherche

Bouton Aller à : Sauter à une position absolue. Format décimal ou hexadécimal. Saut relatif vers l’avant ou vers l’arrière en spécifiant le signe.

Chercher : Recherchez des motifs hexadécimaux dans la vue HexEditor ou des chaînes de caractères dans la vue d’aperçu de fichier.

Configuration du nombre de colonnes : Exactement, Multiple de, Puissance de

Mode d’affichage : Hexa, Binaire

Octets : Sélectionnez le nombre d’octets à afficher par colonne.

Choix d’Endianess : BE: Big Endian LE: Little Endian

Valeur Prévisualisée : Ajoute une vue supplémentaire dans HexEditor. Pour une valeur sélectionnée dans HexEditor, la valeur est également affichée sous forme de Word, Dword, Float, Double.

Entrée d’expression : Permet d’effectuer une opération arithmétique sur une valeur dans HexEditor. Le résultat de l’opération est affiché dans la marge de droite.

Calc : Testeur d’Expression

Édition d’un fichier dans HexEditor :

Commandes d’historique Annuler (Undo) et Refaire (Redo).

Autre exemple, Déplacer le curseur dans la vue des chaînes de caractères : Insérer des espaces avec la touche Insérer. Supprimer des caractères en appuyant sur la touche Suppr.

En saisissant un texte, le contenu existant est écrasé sous la forme d’une chaîne de caractères.

En saisissant des chiffres dans la vue d’HexEditor, les valeurs sont écrasées et l’aperçu est mis à jour.

2.13  Recherche Incrémentale

Pour obtenir une recherche efficace dans des fichiers ouverts, Code::Blocks fourni ce qu’on nomme une recherche incrémentale. Cette méthode de recherche s’initialise, pour un fichier ouvert, via le menu ’Rechercher’ →’Recherche Incrémentale’ ou par le raccourci clavier Ctrl-I. L’entrée active passe alors automatiquement à la configuration du masque de recherche dans la barre d’outils correspondante. Dès que vous commencez à entrer des termes de recherche, le fond du masque de recherche s’ajuste en fonction des occurrences des termes. Si un accord est trouvé dans l’éditeur actif, la position respective est marquée en couleur. Par défaut l’accord courant est surligné en vert. Cette configuration peut être changée dans ’Paramètres’ →’ Éditeur’ →’ Recherche Incrémentale’ (voir figure 2.15). En appuyant sur la touche Entrée la recherche saute à l’occurrence suivante de la chaîne de texte recherchée à l’intérieur du fichier. Avec Maj-Entrée, c’est l’occurrence précédente qui est sélectionnée. Cette fonctionnalité n’est pas supportée par Scintilla si la recherche incrémentale utilise des expressions régulières.

Si la chaîne de caractère recherchée ne peut pas être trouvée dans le fichier courant, afin d’indiquer que c’est ce qui se passe, le fond du masque de recherche est affiché en rouge.

ESC

Quitte le module de Recherche Incrémentale.

ALT-Suppr

Efface l’entrée du champ de recherche incrémentale.

Les icônes de la barre d’outils de Recherche Incrémentale ont les significations suivantes :

class="description">

Suppression du texte dans le masque de recherche de la barre d’outils de Recherche Incrémentale.

class="cmssbx-10x-x-120">, class="description">

Navigation dans les occurrences de chaîne recherchée.

class="description">

En cliquant sur ce bouton ce sont toutes les occurrences de la chaîne recherchée qui sont surlignées en couleur, pas seulement la première.

class="description">

Activer cette option réduit le champ de recherche au passage de texte marqué dans l’éditeur.

class="description">

Cette option signifie que la recherche sera sensible à la casse (respect des majuscules et minuscules).

class="description">

Valider les expressions régulières dans le champ d’entrée de la recherche incrémentale.

2.14  Extension NassiShneiderman

L’extension NassiShneiderman permet de créer des diagrammes de Nassi Shneiderman depuis Code::Blocks ([ NassiShneiderman]).

2.14.1  Création d’un diagramme

Vous avez deux possibilités pour créer un diagramme.

1.

Pour créer un diagramme vide, sélectionnez les options de menu ’Fichier’ →’Nouveau’ →’Diagramme de Nassi Shneiderman’ .

2.

La deuxième option consiste à créer un diagramme depuis le code source C/C++.

Dans une fenêtre de l’éditeur, sélectionnez une partie de code pour en créer un diagramme. Par exemple le corps d’une fonction/méthode depuis l’accolade ouvrante jusqu’à l’accolade fermante. Puis, via un clic droit sur la sélection, choisissez ’Nassi Shneiderman’ →’Créer un diagramme’ (voir figure 2.16).

Vous devriez obtenir un nouveau diagramme (voir figure 2.17).

L’analyseur a quelques limitations:

• Des commentaires ne peuvent pas être placés en fin de branche.

• Depuis la définition d’une fonction, on ne peut analyser que le corps de la fonction, pas la déclaration.

• Bien sûr, vous en trouverez bien d’autres...

2.14.2  Édition de structogrammes

2.14.2.1 Que faire avec un diagramme ?

Vous pouvez faire plein de choses avec un structogramme :

1.

L’enregistrer pour l’utiliser plus tard. On peut l’enregistrer via ’Fichier’ →’Enregistrer le fichier’ ou ’Fichier’ →’Enregistrer le fichier sous...’ .

2.

On peut l’exporter dans différents formats ’Fichier’ →’Exporter’

• ”Exporter la source...” pour l’enregistrer comme fichier source en C.

• ”StrukTeX” pour l’utiliser dans une documentation sous LaTeX.

• ”PNG” ou ”PS” et éventuellement ”SVG” pour obtenir le diagramme dans un format image connu de nombreux autres outils.

3.

Insérer directement le code dans l’éditeur : Ouvrir ou créer un diagramme. De retour dans la fenêtre d’édition, faites un clic droit et choisissez ’Nassi Shneiderman’ →’insérer en xy’ (Vous obtenez ici une liste de tous les diagrammes ouverts).

4.

Glisser/Déposer le diagramme (ou une partie) dans d’autres outils. Par exemple vers OpenOffice Writer afin d’y insérer une image dans votre documentation.

Si le diagramme choisi comporte une sélection, l’exportation ou la génération de code ne portera que sur cette partie de diagramme.

2.14.2.2 Extensions

L’extension NassiShneiderman supporte quelques extensions des diagrammes de Nassi-Shneiderman :

• séparation d’une brique spécifique avec la ”flèche droite”

• continuer sur une brique spécifique avec la ”flèche gauche”

• Pour être en mesure de créer des diagrammes avec des instructions c/c++ ”switch”, la sélection ne doit pas être implicitement interrompue avant un ”case”. Les différents ”cases” sont alignés verticalement. Support de C et C++.

2.15  LibFinder

Si vous voulez utilisez des librairies dans votre application, vous devez configurer votre projet pour cela. Un tel processus de configuration peut être difficile et ennuyeux car chaque librairie peut utiliser un schéma d’options particulier. Un autre problème est que cette configuration diffère entre les plates-formes ce qui résulte en des incompatibilités entre des projets Unix et Windows.

LibFinder propose deux fonctionnalités majeures :

• Recherche des librairies installées sur votre système

• Inclure les librairies dans votre projet en seulement quelques clics en rendant le projet indépendant de la plate-forme

2.15.1  Recherche de librairies

La recherche des librairies est disponible via le menu ’Extensions’ →’Library finder’ . Son but est de détecter les librairies installées sur votre système et d’enregistrer les résultats dans la base de données de LibFinder (notez que ces résultats ne sont pas écrits dans les fichiers projets de Code::Blocks). La recherche commence par un dialogue où vous pouvez fournir un ensemble de répertoires où sont installées les librairies. LibFinder les analysera de façon récursive aussi, si vous ne savez pas trop où elles sont, vous pouvez sélectionner des répertoires génériques. Vous pouvez même entrer le disque complet – dans ce cas-là, le processus de recherche prendra plus de temps mais il détectera davantage de librairies (voir figure 2.18).

Quand LibFinder est à la recherche de librairies, il utilise des règles spéciales pour détecter leur présence. Chaque ensemble de règle est situé dans un fichier xml. Actuellement LibFinder peut rechercher wxWidgets 2.6/2.8, Code::Blocks SDK et GLFW – la liste sera étendue dans le futur.

Après avoir terminé l’analyse, LibFinder affiche les résultats (voir figure 2.19).

Dans la liste, vous cochez les librairies qui doivent être enregistrées dans la base de données de LibFinder. Notez que chaque librairie peut avoir plus d’une configuration valide et les paramétrages ajoutés en premier sont plutôt destinés à être utilisés lors de la génération de projets.

Au-dessous de la liste, vous pouvez sélectionner ce qu’il faut faire avec les résultats des analyses précédentes :

Ne pas effacer les résultats précédents

Cette option travaille comme une mise à jour des résultats existants – Cela ajoute les nouveaux et met à jour ceux qui existent déjà. Cette option n’est pas recommandée.

Seconde option (Effacer les résultats précédents des librairies sélectionnées)

effacera tous les résultats des recherches précédentes des librairies sélectionnées avant d’ajouter les nouveaux résultats. C’est l’option recommandée.

Effacer toutes les configurations précédentes des librairies

quand vous sélectionnez cette option, la base de données de LibFinder sera effacée avant d’y ajouter les nouveaux résultats. C’est utile quand vous voulez nettoyer une base de données LibFinder contenant des résultats invalides.

Une autre option de ce dialogue est ’Configurer les Variables Globales’ . Quand vous cochez cette option, LibFinder essaiera de configurer des Variables Globales qui sont aussi utilisées pour aider à traiter les librairies.

Si vous avez pkg-config d’installé sur votre système (C’est installé automatiquement sur la plupart des versions de systèmes linux) LibFinder proposera des librairies venant de cet outil. Il n’est pas nécessaire de faire une analyse spécifique pour celles-ci – elles seront automatiquement chargées au démarrage de Code::Blocks.

2.15.2  Inclure des librairies dans les projets

LibFinder ajoute un onglet supplémentaire dans les propriétés d’un projet ’Librairies’ – Cet onglet montre les librairies utilisées dans le projet ainsi que celles connues de LibFinder. Pour ajouter une librairie dans votre projet, sélectionnez là dans le panneau de droite et cliquez sur le bouton <. Pour enlever une librairie d’un projet, sélectionnez la dans le panneau de gauche et cliquez sur le bouton > (voir figure 2.20).

Vous pouvez filtrer les librairies connues de LibFinder en fournissant un filtre de recherche. La case à cocher ’Afficher comme un arbre’ permet de basculer antre des vues sans catégories et des vues avec catégories.

Si vous voulez ajouter une librairie qui n’est pas disponible dans la base de données de LibFinder, vous pouvez utiliser le champ ’Librairie inconnue’ . Notez que vous devriez entrer le ”library’s shortcode” (nom court, qui habituellement correspond au nom de variable globale) ou le nom de librairie dans pkg-config. Vous trouverez une liste de noms courts suggérés dans le Wiki de Code::Blocks dans Global Variables. L’usage de cette option n’est recommandé que lorsqu’on prépare un projet qui doit être généré sur d’autres machines où ce type de librairie existe et y est correctement détectée par LibFinder. Vous pouvez accéder à une variable globale dans Code::Blocks comme :

$(#GLOBAL_VAR_NAME.include)

Cocher l’option ’Ne pas configurer automatiquement’ indiquera à LibFinder qu’il ne devrait pas ajouter automatiquement les librairies lors de la compilation. Dans ce cas, LibFinder peut s’invoquer depuis un script de génération. Un exemple d’un tel script est généré et ajouté au projet en appuyant sur ’Ajouter un script de génération manuel’ .

2.15.3  Utilisation de LibFinder dans des projets générés par des assistants

Les assistants vont créer des projets qui n’utilisent pas LibFinder. Pour les intégrer avec cette extension, vous devrez mettre à jour manuellement les options de génération du projet. Ceci est facilement obtenu en enlevant tous les paramétrages spécifiques aux librairies et en ajoutant les librairies au travers de l’onglet ’Librairies’ dans les propriétés du projet.

De tels projets deviennent indépendants des plates-formes. Tant que les librairies utilisées sont dans la base de données de LibFinder, les options de génération du projet seront automatiquement mises à jour pour coïncider avec les paramétrages de librairie propres aux plates-formes.

2.16  Extension SpellChecker

Une extension pour vérifier l’orthographe de chaînes de caractères et de commentaires.

2.16.1  Introduction

Une extension pour vérifier l’orthographe de chaînes de caractères et de commentaires. L’orthographe est vérifiée au cours de la frappe. De plus un thésaurus est fourni. Les deux peuvent être accédés sur demande en sélectionnant le mot en question, puis choisir entre le correcteur... ou le Thesaurus... depuis le menu d’Édition (l’opération peut être affectée à une touche d’accès rapide via le plugin Raccourcis Clavier). Le menu de contexte (clic droit sur le mot) permet d’accéder aux suggestions d’orthographe.

2.16.2  Configuration

La configuration est dans le menu ’Paramêtres’ →’Éditeur’ . L’option ”spell check” est à peu près à mi-chemin vers le bas de la liste de gauche.

La signification des différents contrôles est la suivante :

Activer spell checker en-ligne

Active ou désactive spell checker.

Langue

La langue utilisée pour la vérification orthographique et le thésaurus est sélectionnée en choisissant un dictionnaire. On peut aussi le changer dans la barre d’état.

Configuration des chemins, Dictionnaires

Le plugin cherche les fichiers dictionnaires via ce chemin.

Configuration des chemins, Thésaurus

Le plugin cherche les fichiers thésaurus via ce chemin.

Configuration des chemins, Bitmaps

(Optionnel) Le plugin cherche, via ce chemin, les drapeaux à afficher dans la barre d’état.

2.16.3  Dictionnaires

SpellChecker utilise une librairie nommée hunspell. Hunspell est le correcteur orthographique de OpenOffice.org, Mozilla Firefox et d’autres projets. Les dictionnaires disponibles pour ces applications sont compatibles avec ce plugin.

Open Office fourni toute une collection de dictionnaires pour plusieurs langues et dialectes à télécharger. Les extensions de OOo 3.x (*.oxt) sont des archives compressés qui peuvent être ouvertes avec votre logiciel d’archives préféré (par exemple 7-Zip ou File Roller). Copiez le fichier .aff et le fichier .dic dans le répertoire configuré dans ’Configuration des chemins, Dictionnaires’ (voir ci-dessus).

Si vous êtes sous Linux vous avez sans doute déjà des dictionnaires compatibles d’installés. Regardez dans /usr/share/hunspell ou plutôt mon choix dans /usr/share/myspell/dicts. La raison pour laquelle j’aime les fichiers myspell est qu’ils incluent d’office les fichiers thésaurus qui sont correctement nommés pour travailler avec l’extension, et tout est placé au même endroit. Ne copiez pas ces fichiers. Pointez seulement spell checker vers l’endroit où ils se trouvent déjà.

Je sais que sous Windows, Firefox et Thunderbird installent aussi des fichiers dictionnaires compatibles. On peut les trouver dans... C:∖Program Files∖Mozilla Firefox∖dictionaries ou C:∖Program Files∖Mozilla Thunderbird∖dictionaries. De plus, OpenOffice.org et LibreOffice installent aussi des fichiers dictionnaires dans
C:∖Program Files∖(Open/Libre)Office∖share∖extensions∖dict-*.

Le navigateur Google Chrome installe aussi des dictionnaires, mais ils sont au format .bdic et le plugin de correction orthographique de Code::Blocks ne peut pas travailler avec ces fichiers.

2.16.4  Fichiers Thésaurus

Les fichiers de thésaurus sont aussi disponibles sur OOo, comme les dictionnaires. Copiez les fichiers de thésaurus (th_*.dat and th_*.idx) dans le répertoire configuré dans ’Configuration des chemins, Thésaurus’ (voir ci-dessus) puis renommez les pour que leur nom concorde avec celui des dictionnaires mais les faire précéder de ”th_” tout en gardant l’extension telle qu’elle est.

Exemple: Si les fichiers dictionnaires (pour moi, une seule langue) sont ”en_GB.aff” et ”en_GB.dic” les fichiers utilisés pour le thésaurus sont ”th_en_GB.idx” et ”th_en_GB.dat”.

Sur mon système Linux je trouve les fichiers thésaurus déjà installés dans /usr/share/myspell/dicts et /usr/share/mythes. De même, ne déplacez pas les fichiers. Configurez spell checker pour utiliser directement ces fichiers là où ils sont.

Sous Windows, si soit OpenOffice.org soit LibreOffice est installé, ils incluent souvent les fichiers thésaurus dans C:∖Program Files∖(Open/Libre)Office∖share∖extensions∖dict-*.

2.16.5  Bitmaps (Drapeaux)

L’image bitmap de la langue sélectionnée est affichée dans la barre d’état. S’il n’y a pas d’image bitmap, c’est le nom de la langue qui s’affiche. L’image bitmap doit être au format PNG Choisissez un drapeau dans famfamfam_flag_icons, copiez le dans le répertoire configuré dans ’Configuration des chemins, Bitmaps’ (voir ci-dessus) et renommez-le pour que le nom soit conforme à celui du dictionnaire mais gardez l’extension png.

2.16.6  Styles à vérifier

Seul du texte possédant un style spécifique peut être vérifié (par exemple seulement des commentaires et des chaînes de caractères). Les styles sont configurés automatiquement par Scintilla (le composant d’édition de Code::Blocks).

Le fichier OnlineSpellChecking.xml contient une liste avec des indices sur les styles à vérifier. Les indices ne sont pas les mêmes en fonction des langages de programmation, et donc, le fichier contient une liste pour chacun des langages de programmation. Pour ajouter des styles, regardez le nom du langage de programmation et les indices dans le fichier correspondant lexer_*.xml puis ajoutez cette information au fichier OnlineSpellChecking.xml.

Par exemple, pour vérifier l’orthographe dans des scripts de commande bash (fichiers *.sh), ajoutez la ligne :

<Language name="Bash"index="2,5,6"/>

2.17  Exporter du code Source

Il est souvent nécessaire de transférer du code source vers d’autres applications ou vers des e-mails. Si le texte est simplement copié, le formatage est perdu, ce qui rend le texte peu clair. La fonction exporter de Code::Blocks est une des solutions dans ce type de situations. Le format requis pour le fichier exporté peut être sélectionné via ’Fichier’ →’Exporter’ . Le programme adoptera alors le nom de fichier et le répertoire cible en fonction du fichier source ouvert et les proposera pour enregistrer le fichier à exporter. L’extension de fichier appropriée à chaque cas de figure sera déterminée par le type de l’exportation. Les formats suivants sont disponibles :

html

Un format de type texte qui peut être affiché dans un navigateur web ou dans un traitement de texte.

rtf

Le format Rich Text qui est un format basé sur du texte et qui peut être ouvert dans un traitement de texte comme Word ou OpenOffice.

odt

Le format Open Document Text qui est un format standardisé spécifié par Sun et O’Reilly. Ce format peut être traité par Word, OpenOffice et d’autres traitements de texte.

pdf

Le format Portable Document qui peut être ouvert par des applications comme Acrobat Reader.

2.18  Support de SVN

Le support du système de contrôle de version SVN est inclus dans l’extension Code::Blocks TortoiseSVN. Via le menu ’TortoiseSVN’ →’Plugin settings’ vous pouvez configurer les commandes svn accessibles dans l’onglet ’Integration’ .

Menu intégration

Ajoute une entrée TortoiseSVN dans la barre de menu avec différents paramétrages.

Project manager

Active les commandes TortoiseSVN du menu de contexte de la gestion de projet.

Editor

Active les commandes TortoiseSVN du menu de contexte de l’éditeur.

Dans la configuration de l’extension vous pouvez choisir quelles sont les commandes svn qui sont accessibles dans le menu principal ou le menu de contexte. L’onglet intégration fournit une entrée ’Edit main menu’ et ’Edit popup menu’ pour paramétrer ces commandes.

2.19  Liste des ”à faire”

Dans des projets logiciels complexes, où différents développeurs sont impliqués, il est souvent nécessaire que différentes tâches soient effectuées par plusieurs utilisateurs. Pour cela, Code::Blocks possède une Liste des ”à faire”. Cette liste s’ouvre via ’Affichage’ →’Liste des ”A faire”’ , et contient les tâches à effectuer ensemble, avec leurs priorités, le type et le responsable de la tâche. On peut filtrer la liste par tâches, utilisateurs et/ou fichiers sources. Un tri par colonnes peut être effectué en cliquant sur le titre de la colonne correspondante.

Si les fichiers sources sont ouverts dans Code::Blocks, un ”à faire” peut être ajouté à la liste via la commande ’Ajouter un élément ”à faire”’ du menu de contexte. Un commentaire est ajouté dans le code sur la ligne sélectionnée.

// TODO (user#1#): ajouter un nouveau dialogue pour la prochaine release

Quand on ajoute un ”à faire”, une boîte de dialogue apparaît où les paramétrages suivants peuvent être faits (voir figure 2.23).

Utilisateur

Nom de l’utilisateur <user> pour le système d’exploitation. Les tâches pour d’autres utilisateurs peuvent également être créées ici. Pour cela, le nom de l’utilisateur correspondant doit être créé par Ajouter un nouvel utilisateur. L’assignation d’un ”à faire” est alors faite via une sélection d’entrées pour cet utilisateur.

Note :
Notez que les Utilisateurs ici n’ont rien à voir avec les profils (ou personnalités) utilisés dans Code::Blocks.

Type

Par défaut, le type est TODO (à faire”).

Priorité

Dans Code::Blocks, l’importance de la tâche peut être exprimée par des priorités (1 - 9).

Position

Ce paramètre spécifie si le commentaire doit être inclus avant, après ou bien à la position exacte du curseur.

Style de commentaire

Une sélection de formats de commentaires (notamment doxygen).

2.20  Tools+

Créer un nouvel outil est assez facile, et cela peut s’effectuer en quelques étapes simples. D’abord ouvrir ’Tools(+)’ →’Configurer les outils...’ pour accéder au dialogue des Outils définis par l’utilisateur.

Nom de l’outil

C’est le nom qui sera affiché dans le menu déroulant de Tools(+). Il sera aussi affiché comme nom d’onglet pour les Tools+ redirigés vers la fenêtre Outils.

Ligne de Commande

Toute ligne de commande valide, fonction et paramètres, peut être entrée ici. La substitution de variable est également acceptée. La liste suivante contient les variables les plus utiles (voir section 3.2 pour la liste complète).

$relfile, $file

Respectivement, le nom relatif et absolu d’un fichier sélectionné.

$reldir, $dir

Respectivement, le nom relatif et absolu d’un répertoire sélectionné.

$relpath, $path

Le nom relatif et absolu d’un fichier ou répertoire sélectionné.

$mpaths

Une liste de fichiers ou de répertoires sélectionnés (seulement des chemins en absolu).

$fname, $fext

Le nom sans extension et l’extension sans le nom d’un fichier sélectionné.

$inputstr{prompt}

Demande à l’utilisateur d’entrer une chaîne de texte qui sera substituée dans la ligne de commande.

$if(condition){true clause}{false clause}

Résolution en false clause si la condition est vide, 0, ou fausse; sinon true clause.

Types de fichiers

Les expressions avec un caractère joker (*) séparées par des points virgules vont restreindre le choix par le sous-menu clic droit sur un fichier, répertoire, chemin multiple dans l’arborescence des projets, de l’explorateur de fichiers, ou du panneau d’éditeur à un/des type/s spécifiés. Laisser vide pour traiter tous les types de fichiers/répertoires.

Répertoire de Travail

Le répertoire sur lequel exécuter la commande. Les variables de Code::Blocks, les variables de projet, et les variables globales sont disponibles. De même,

1.

Si $dir est entré dans la ligne de commande, alors $dir peut aussi être utilisé ici.

2.

$parentdir est disponible pour $relfile, $file, $reldir, $dir, $relpath, $path, $fname, $fext, pour l’évaluation du chemin absolu d’un répertoire contenant cet élément.

Chemin du Menu Outils

Contrôle l’emplacement de la commande dans le menu de Tools(+), donnant la possibilité d’ajouter des sous-menus (les niveaux multiples sont autorisés).

• Submenu/Tool1

• Submenu/Tool2

• Tool3

Va créer cette structure.

Le nom de la commande sera utilisé si cette entrée est vide. Si le premier caractère est un point, la commande sera cachée.

Chemin du Menu de Contexte

Ceci contrôle l’emplacement de la commande dans le menu clic-droit des Projets et des onglets de fichiers du panneau de Gestion. Les mêmes règles que pour la structure des menu de Tools+ s’appliquent ici.

Notez SVP que la commande n’apparaîtra dans les menus de contexte que si la ligne de commande contient un ou plusieurs des éléments suivants : $relfile, $file, $reldir, $dir, $relpath, $path, $fname, et $fext.

Sortie vers

Ceci détermine vers où la sortie de la commande sera redirigée. Le but et la fonction de la commande détermineront ce qui est le mieux à faire. Tools Output Window

Les outils qui ne requièrent que des résultats de sortie en ligne de commande (et ne demandent pas d’entrées) utilisent généralement cette façon de faire. Le programme sera lancé en mode invisible et toutes les sorties seront redirigées vers l’onglet approprié de la fenêtre de sortie des Outils Tools+. Le texte [DONE/TERMINÉ] sera ajouté en fin d’exécution de l’Outil.

Console de Code::Blocks

Ceci va permettre de lancer le programme via l’exécutable cb_console_runner (ce même programme qui est lancé après Générer et exécuter). Généralement, c’est utilisé par les outils en ligne de commande pour obtenir des interactions utilisateur avancées, bien que des programmes graphiques puissent aussi être utilisés (notamment si le programme n’est pas stable ou s’il affiche des messages dans la sortie standard). Le ”Console runner” mettra la fenêtre en pause (l’empêchant de se fermer), affichera le temps d’exécution, ainsi que le code de sortie quand le programme s’arrêtera.

Shell Standard

C’est la même chose que de placer cette commande dans un script batch ou un script Shell puis de l’exécuter. Le programme s’exécutera quelle que soit la méthode par défaut, et lorsqu’il aura terminé, sa fenêtre se fermera.. Ce paramètre est utile pour exécuter un programme (par exemple un fichier ou un navigateur Web) qui doit rester ouvert après la fermeture de Code::Blocks.

2.20.1  Exemple d’Outils Tools+

Ouvrir l’explorateur sur un fichier sélectionné

• Windows Explorer

  • Menu Outils Tools+

               explorer /select,"$(PROJECTFILE)"

  • Menu de Contexte

               explorer /select,"$path"

• Dolphin

  • Menu Outils Tools+

               dolphin --select "$(PROJECTFILE)"

  • Menu de Contexte

               dolphin --select "$path"

  Note :
  Les trois commandes suivantes du menu contextuel ne prennent en charge que les dossiers (mais pas les fichiers).

• Nautilus

  • Menu Outils Tools+

               nautilus --no-desktop --browser "$(PROJECTDIR)"

  • Menu de Contexte

               nautilus --no-desktop --browser "$dir"

• Thunar

  • Menu Outils Tools+

               thunar "$(PROJECTDIR)"

  • Menu de Contexte

               thunar "$dir"

• PCMan File Manager

  • Menu Outils Tools+

               pcmanfm "$(PROJECTDIR)"

  • Menu de Contexte

               pcmanfm "$dir"

Mise à jour d’un répertoire Subversion

• Windows

  • Menus Outils Tools+

               "path_to_svn\bin\svn" update "$inputstr{Directory}"

  • Menu de Contexte

               "path_to_svn\bin\svn" update "$dir"

• Linux

  • Menus Outil Tools+

               svn update "$inputstr{Directory}"

  • Menu de Contexte

               svn update "$dir"

Exporter un makefile

• Windows

  • Menus Outil Tools+

               "path_to_cbp2make\cbp2make" -in "$(PROJECTFILE)"

• Linux

  • Menus Outil Tools+

               "path_to_cbp2make/cbp2make" -in "$(PROJECTFILE)"

Compresser le projet actif dans une archive

• Windows

  • 7z ou zip - Menus Outil Tools+ (sur 1 seule ligne)

               "path_to_7z\7z" a -t$if(zip == $inputstr{7z or zip?}){zip -mm=Deflate
                    -mmt=on -mx9 -mfb=128 -mpass=10}{7z -m0=LZMA -mx9
                    -md=64m -mfb=64 -ms=on} -sccUTF-8 "-w$(PROJECTDIR).."
                    "$(PROJECTDIR)..\$(PROJECT_NAME)" "$(PROJECTDIR)*"

  • tar.gz ou tar.bz2 - Menus Outil Tools+ (sur 1 seule ligne)

               cmd /c ""path_to_7z\7z" a -ttar -mx0 -sccUTF-8 "-w$(PROJECTDIR).."
                     "$(PROJECTDIR)..\$(PROJECT_NAME)" "$(PROJECTDIR)*" &&
                     "path_to_7z\7z" a -t$if(gz == $inputstr{gz or bz2?}){gzip -mx9
                     -mfb=128 -mpass=10 -sccUTF-8 "-w$(PROJECTDIR).."
                     "$(PROJECTDIR)..\$(PROJECT_NAME).tar.gz}{bzip2 -mmt=on -mx9
                     -md=900k -mpass=7 -sccUTF-8 "-w$(PROJECTDIR).."
                     "$(PROJECTDIR)..\$(PROJECT_NAME).tar.bz2}"
                     "$(PROJECTDIR)..\$(PROJECT_NAME).tar" &&
                      cmd /c del "$(PROJECTDIR)..\$(PROJECT_NAME).tar""

    Note :
    L’interpréteur en ligne de commande de Windows a été invoqué directement ici (cmd /c), ce qui permet à des commandes multiples de s’enchaîner en une seule ligne. Cependant, cela peut provoquer un échec de l’exécution de la commande dans la console Code::Blocks.

• Linux

  • 7z ou zip - Menu Outils Tools+ (sur 1 seule ligne)

               7z a -t$if(zip == $inputstr{7z or zip?}){zip -mm=Deflate -mmt=on -mx9
                   -mfb=128 -mpass=10}{7z -m0=LZMA -mx9 -md=64m -mfb=64 -ms=on}
                   -sccUTF-8 "-w$(PROJECTDIR).." "$(PROJECTDIR)../$(PROJECT_NAME)"
                   "$(PROJECTDIR)*"

  • tar.gz ou tar.bz2 - Menu Outils Tools+ (sur 1 seule ligne)

               tar -cf "$(PROJECTDIR)../$(PROJECT_NAME).tar.$if(gz == $inputstr{gz
                    or bz2?}){gz" -I ’gzip}{bz2" -I ’bzip2} -9’ "$(PROJECTDIR)*"

2.21  Thread Search

Via le menu ’Rechercher’ →’Thread Search’ , cette extension peut être affichée ou masquée en tant qu’onglet dans la console de messages. Dans Code::Blocks, une prévisualisation de l’occurrence de la chaîne de caractères peut être affichée pour un fichier, un espace de travail ou un répertoire. Ce faisant, la liste des résultats de la recherche sera affichée sur la partie droite de la console ThreadSearch. En cliquant sur une entrée de la liste, une prévisualisation s’affiche sur la partie gauche. En double-cliquant dans la liste, le fichier sélectionné est ouvert dans l’éditeur de Code::Blocks.

2.21.1  Fonctionnalités

L’extension ThreadSearch offre les fonctionnalités suivantes :

• ’Recherche dans les fichiers’ multi tâches (Multi-threaded).

• Éditeur interne en lecture seule pour voir les résultats

• Fichier ouvert dans l’éditeur de type notebook

• Menu contextuel ’Rechercher les occurrences’ pour commencer une recherche dans les fichiers à partir du mot situé sous le curseur

2.21.2  Utilisation

1.

Configurez vos préférences de recherche (voir figure 2.29)

Une fois l’extension installée, il y a 4 façons de conduire une recherche :

a)

Tapez/Sélectionnez un mot dans la boîte de recherche combinée et appuyez sur Entrée ou cliquez sur Rechercher dans le panneau de Thread search de la console de messages.

b)

Tapez/Sélectionnez un mot dans la boîte de recherche combinée de la barre d’outil et appuyez sur Entrée ou cliquez sur le bouton Rechercher.

c)

Clic droit sur n’importe quel ’mot’ dans l’éditeur actif puis cliquez sur ’Rechercher les occurrences’.

d)

Cliquez sur Rechercher/Thread search pour trouver le mot courant dans l’éditeur actif.

Note :
Les points 1, 2 et 3 peuvent ne pas être disponibles en fonction de la configuration courante.

2.

Cliquez de nouveau sur le bouton de recherche pour arrêter la recherche en cours.

3.

Un clic simple sur un élément résultat l’affiche dans la prévisualisation sur la droite.

4.

Un double-clic sur un élément résultat ouvre ou configure un éditeur sur la droite.

2.21.3  Configuration

Pour accéder au panneau de configuration de l’extension ThreadSearch cliquez sur (voir figure 2.29) :

1.

Bouton des Options du panneau de Thread search dans la console des messages.

2.

Bouton des Options dans la barre d’outils de Thread search.

3.

Menu Paramètres/Environnement puis choisir l’élément Thread search dans la colonne de gauche.

La recherche partielle défini l’ensemble de fichiers qui seront analysés.

• Les cases à cocher Projet et Espace de travail sont mutuellement exclusives.

• Le chemin du répertoire peut être édité ou configuré via le bouton Sélection.

• Masque est l’ensemble des spécifications de fichiers séparées par des ’;’. Par exemple: *.cpp;*.c;*.h.

2.21.4  Options

Mot entier

si coché, lignes contenant l’expression recherchée si l’expression recherchée est trouvée sans caractères alphanumériques +’_’ avant et après.

Début de mot

si coché, lignes contenant l’expression recherchée si l’expression recherchée est trouvée au début d’un mot sans caractères alphanumériques +’_’ avant et après.

Respecter la casse

si coché, la recherche est sensible à la casse (majuscules-minuscules).

Expression régulière

l’expression recherchée est une expression régulière.

2.21.5  Options de Thread search (ou Tâche de Recherche)

Activer les éléments du menu contextuel ’Trouver les occurrences’

Si coché, l’entrée Trouver les occurrences est ajoutée au menu contextuel de l’éditeur.

Utiliser les options par défaut du menu ’Trouver les occurrences’

Si coché, un ensemble d’options par défaut est appliqué aux recherches lancées par ’Trouver les occurrences’ du menu de contexte correspondant. Par défaut l’option ’Mot entier’ et ’Respecter la casse’ est activé.

Effacer les résultats précédents en début de recherche

Si l’extension ThreadSearch est configurée en ’Vue arborescente’ alors les résultats de la recherche sont listés dans l’ordre hiérarchique suivant,

• le premier noeud contient le terme cherché

• ensuite les fichiers qui contiennent ce terme sont listés

• dans cette liste les numéros des lignes et le contenu correspondant sont affichés

Si vous recherchez plusieurs termes, la liste deviendra confuse, aussi les résultats des recherches précédents peuvent être supprimés en utilisant cette option en début de recherche.

Note :
Dans la liste des occurrences les termes seuls ou tous les termes peuvent être supprimés via le menu de contexte ’Supprimer l’élément’ ou ’Supprimer tous les éléments’ .

2.21.6  Mise en page

Afficher l’en-tête dans la fenêtre de logs

si coché, l’en-tête est affiché dans la liste des résultats de contrôle.

Note :
Si non coché, les colonnes ne sont plus redimensionnables mais on économise de la place.

Dessiner des lignes entre les colonnes

Dessine des lignes entre les colonnes en mode Liste.

Afficher la barre d’outils de ThreadSearch

Afficher la barre d’outils de l’extension ThreadSearch.

Afficher les widgets de recherche dans le panneau de messages de ThreadSearch

Si coché, seuls les résultats de la liste de contrôle et l’éditeur de prévisualisation sont affichés. Les autres widgets de recherches sont masqués (économise de la place).

Afficher l’éditeur de prévisualisation de code

La prévisualisation du code peut être masquée soit par cette case à cocher soit par un double-clic sur la bordure du séparateur en milieu de fenêtre. C’est ici qu’on peut le faire de nouveau s’afficher.

2.21.7  Panneau de Gestion

Vous pouvez choisir différents modes de gestion de la fenêtre de ThreadSearch. Avec le choix ’Panneau de Messages’ la fenêtre ThreadSearch sera intégrée à la console de messages dans un des onglets. Si vous choisissez ’Mise en page’ vous pourrez le détacher de la console et obtenir une fenêtre flottante que vous pourrez placer ailleurs.

2.21.8  Type de journal

La vue des résultats de recherche peut s’afficher de plusieurs façons. Le choix ’Liste’ affiche toutes les occurrences sous forme d’une liste. L’autre mode ’Arborescence’ assemble toutes les occurrences internes d’un fichier dans un noeud.

2.21.9  Mode de partage de fenêtre

L’utilisateur peut configurer la séparation de fenêtre de prévisualisation et de sortie des résultats de recherche horizontalement ou verticalement.

2.21.10  Tri des résultats de recherche

Les résultats de recherche peuvent être triés par le nom de chemin ou le nom de fichier.

2.22  Code statistics

Basée sur les caractéristiques d’un masque de configuration, cette simple extension détecte les pourcentages de codes, commentaires et lignes blanches d’un projet. L’évaluation se lance via la commande de menu ’Extensions’ →’Code statistics’ .

2.23  Profilage de Code

Une interface graphique simple au Profileur GNU GProf.

2.24  Importation de Projets

Le plugin ProjectsImporter importe des projets et des espaces de travail d’autres IDE, notamment Dev-C++, MSVC6, MSVC7, et MSVC8 pour les utiliser comme projets Code::Blocks.

2.25  Recherche de Code Source Disponible

Cette extension permet de sélectionner un terme dans l’éditeur et de rechercher ce terme à l’aide du menu de contexte ’Rechercher dans Koders’ dans la base de données du site [?]. La boîte de dialogue permet d’ajouter la possibilité de filtrer les langages de programmation ou le type de licence.

Cette recherche dans la base vous aidera à trouver du code source originaire du monde entier en provenance d’autres projets universitaires, consortiums et d’organisations comme Apache, Mozilla, Novell Forge, SourceForge et bien d’autres, qui peuvent être réutilisés sans avoir à réinventer la roue à chaque fois. SVP, regardez bien la licence du code source dans chaque cas particulier.

2.26  Extension Symbol Table

Cette extension permet de rechercher des symboles dans des fichiers objets et dans des librairies. Les options et le chemin d’accès au programme nm en ligne de commande sont définis dans l’onglet des Options.

Cliquer sur ’Rechercher’ démarre la recherche. Les résultats du programme NM sont alors affichés dans une fenêtre séparée nommée ’SymTabs Result’. Les noms des fichiers objets et des librairies contenant les symboles sont listés avec comme titre ’Sortie de NM’.

3  Expansion de Variables

Code::Blocks fait la différence entre plusieurs types de variables. Ces types peuvent servir à configurer l’environnement de création d’un programme, mais aussi à accroître la maintenabilité et la portabilité. L’accès aux variables de Code::Blocks s’obtient grâce à $<name>.

Variables d’Environnement

sont configurées au démarrage de Code::Blocks. Elles peuvent modifier les variables d’environnement du système telles que PATH. Cela peut être utile dans les cas où une variable d’environnement spécifique est nécessaire à la création de projets. La configuration des variables d’environnement dans Code::Blocks se fait à l’aide de ’Paramètres’ →’Environnement’ →’Variables d’environnement’ .

Variables internes

sont prédéfinies dans Code::Blocks, et peuvent être accédées via leurs noms (voir les détails dans section 3.2).

Macros Commandes

Ce type de variables est utilisé pour contrôler le processus de génération. Pour de plus amples informations se référer à section 3.4.

Variables Utilisateur

sont des variables définies par l’utilisateur qui peuvent être spécifiées dans les options de génération d’un projet. Ici vous pouvez, par exemple définir votre type de processeur comme une variable MCU et lui assigner une valeur correspondante. Puis entrer dans les options de compilation -mcpu=$(MCU), et Code::Blocks le remplacera automatiquement par le contenu. Par cette méthode, la configuration d’un projet peut être largement paramétrée.

Variables Globales

sont surtout utilisées pour créer Code::Blocks à partir des sources ou pour le développement d’applications wxWidgets. Ces variables ont une signification bien particulière. Par rapport à toutes les autres, si vous configurez de telles variables et partagez votre fichier projet avec d’autres qui eux n’ont *pas* configuré ces variables globales (ou GV), Code::Blocks demandera à l’utilisateur de les configurer. C’est un moyen pratique de d’assurer qu’un ’autre développeur’ sait facilement ce qu’il doit configurer. Code::Blocks posera la question pour tous les chemins usuellement nécessaires.

3.1  Syntaxe

Code::Blocks traite de façon équivalente, en tant que variables, les séquences de caractères suivantes dans les étapes de pré-génération, post-génération ou génération :

• $VARIABLE

• $(VARIABLE)

• ${VARIABLE}

• %VARIABLE%

Les noms de variables doivent être composés de caractères alphanumériques et sont insensibles à la casse (minuscules-majuscules). Les variables commençant par un seul signe dièse (#) sont interprétées comme des variables utilisateur globales (voir les détails dans la section 3.5). Les noms listés ci-dessous sont interprétés comme des types de variables internes.

Les variables qui ne sont ni de type utilisateur globales ni de type interne, seront remplacées par une valeur fournie dans le fichier projet, ou par une variable d’environnement si ce dernier échoue.

L’utilisation de ces variables peut être effectuée comme dans l’exemple suivant :

#include "include/manager.h"
wxString strdate = Manager::Get()->GetMacrosManager()->ReplaceMacros(_T("$TODAY"));

3.2  Liste des variables internes

Les variables listées ci-dessous sont des variables internes à Code::Blocks. Elles ne peuvent pas être utilisées dans des fichiers sources.

3.2.1  Espace de travail Code::Blocks

$(WORKSPACE_FILENAME), $(WORKSPACE_FILE_NAME), $(WORKSPACEFILE), $(WORKSPACEFILENAME)

Le nom de fichier de l’espace de travail courant (.workspace).

$(WORKSPACENAME), $(WORKSPACE_NAME)

Le nom de l’espace de travail qui est affiché dans l’onglet Projets du panneau Gestion.

$(WORKSPACE_DIR), $(WORKSPACE_DIRECTORY), $(WORKSPACEDIR), $(WORKSPACEDIRECTORY)

Le répertoire où se trouve l’espace de travail.

3.2.2  Fichiers et répertoires

$(PROJECT_FILENAME), $(PROJECT_FILE_NAME), $(PROJECT_FILE), $(PROJECTFILE)

Le nom de fichier du projet en cours de compilation.

$(PROJECT_NAME), $(PROJECTNAME)

Le nom du projet en cours de compilation.

$(PROJECT_DIR), $(PROJECTDIR), $(PROJECT_DIRECTORY)

Le répertoire commun de plus haut niveau du projet en cours de compilation.

$(ACTIVE_EDITOR_FILENAME)

Le nom du fichier ouvert dans l’éditeur actif courant.

$(ACTIVE_EDITOR_LINE)

Retourne le numéro de ligne courant dans l’éditeur actif.

$(ACTIVE_EDITOR_COLUMN

Retourne le numéro de colonne courant dans l’éditeur actif.

$(ACTIVE_EDITOR_DIRNAME)

le répertoire contenant le fichier actif courant (relatif au chemin de plus haut niveau).

$(ACTIVE_EDITOR_STEM)

Le nom de base (sans extension) du fichier actif courant.

$(ACTIVE_EDITOR_EXT)

L’extension du fichier actif courant.

$(ALL_PROJECT_FILES)

Une chaîne contenant les noms de tous les fichiers du projet courant.

$(MAKEFILE)

Le nom de fichier du makefile.

$(CODEBLOCKS), $(APP_PATH), $(APPPATH), $(APP-PATH)

Le chemin de l’instance courante de Code::Blocks en cours d’exécution.

$(DATAPATH), $(DATA_PATH), $(DATA-PATH)

Le répertoire ’partagé’ de l’instance courante de Code::Blocks en cours d’exécution.

$(PLUGINS)

Le répertoire des plugins (ou extensions) de l’instance courante de Code::Blocks en cours d’exécution.

$(TARGET_COMPILER_DIR)

Le répertoire d’installation du compilateur appelé aussi chemin maître.

3.2.3  Cibles de génération

Remplacer FOOBAR par le nom de la cible

$(FOOBAR_OUTPUT_FILE)

Le fichier de sortie d’une cible spécifique.

$(FOOBAR_OUTPUT_DIR)

Le répertoire de sortie d’une cible spécifique.

$(FOOBAR_OUTPUT_BASENAME)

Le nom de base du fichier de sortie (sans chemin, sans extension) d’une cible spécifique.

$(FOOBAR_PARAMETERS)

Les paramètres d’exécution d’un cible spécifique

$(TARGET_OUTPUT_DIR)

Le répertoire de sortie de la cible courante.

$(TARGET_OBJECT_DIR)

Le répertoire 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)

L’outil de génération (compilateur, éditeur de liens, etc.) de la cible courante.

$(TARGET_COMPILER_DIR)

Le répertoire courant des outils de génération (compilateur, éditeur de liens, etc.).

3.2.4  Langue et encodage

$(LANGUAGE)

La langue du système en clair.

$(ENCODING)

L’encodage du système 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 précédents mais exprimés en temps universel TU.

$(DAYCOUNT)

Nombre de jours passés depuis une date arbitraire choisie comme origine (1er Janvier 2009). Utile comme dernier composant d’un numéro de version/génération.

3.2.6  Dépendant de la Plateforme

$(PLATFORM)

remplacé par msw sous windows et unix sous linux et mac (Depuis la révision r11793)

3.2.7  Commandes du Système d’exploitation

La variable est remplacée par la commande effective du Système d’exploitation.

$(CMD_CP)

Commande de Copie de fichiers.

$(CMD_RM)

Commande de Suppression de fichiers.

$(CMD_MV)

Commande de Déplacement de fichiers.

$(CMD_NULL)

NULL device (pour rediriger un flux)

$(CMD_MKDIR)

Commande de Création de répertoire.

$(CMD_RMDIR)

Commande de Suppression de répertoire.

3.2.8  Valeurs aléatoires

$(COIN)

Cette variable simule un pile ou face (à chaque invocation) et retourne 0 ou 1.

$(RANDOM)

Un nombre positif aléatoire sur 16 bits (0-65535)

3.2.9  Chemins Standard

$(GET_DATA_DIR)

Unix: prefix/share/appname ; Windows: chemin EXE

$(GET_LOCAL_DATA_DIR)

Unix: /etc/appname ; Windows: chemin EXE

$(GET_CONFIG_DIR)

Unix: /etc ; Windows: C:∖Documents and Settings∖All Users∖Application Data

$(GET_USER_CONFIG_DIR)

Unix:   ; Windows: C:∖Documents and Settings∖username∖Application Data∖appname

$(GET_USER_DATA_DIR)

Unix:  /.appname ; Windows: C:∖Documents and Settings∖username∖Application Data

$(GET_USER_LOCAL_DATA_DIR)

Unix:  /.appname ; Windows: C:∖Documents and Settings∖username∖Local Settings∖Application Data∖appname

$(GET_TEMP_DIR)

TOUTES plateformes: Un répertoire temporaire accessible en écriture

Sous Windows 10 ou 11, les chemins sont plutôt de la forme C:∖Utilisateurs∖<user>...

3.2.10  Fonctions internes pour la conversion de chemins

Ce sont des fonctions macro pour simplifier la génération des chemins

$TO_UNIX_PATH{}

converti vers un chemin unix (utilise ’/’ comme séparateur)

$TO_WINDOWS_PATH{}

converti vers un chemin windows (utilise ’∖’ comme séparateur)

$TO_NATIVE_PATH{}

converti vers le chemin natif de la plate-forme où l’instance de Code::Blocks s’exécute

Utilisation

$TO_UNIX_PATH{$(TARGET_OUTPUT_FILE)}

retourne le fichier de sortie de la cible courante en tant que chemin unix

3.2.11  Évaluation Conditionnelle

$if(condition){clause si vraie}{clause si fausse}

L’évaluation Conditionnelle sera considérée comme vraie dans les cas suivants

• la condition est un caractère non vide autre que 0 ou false

• la condition est une variable non vide qui ne se résout pas en 0 ou false

• la condition est une variable qui est évaluée à true (implicite par une condition précédente)

L’évaluation Conditionnelle sera considérée comme fausse dans les cas suivants

• la condition est vide

• la condition est 0 ou false

• la condition est une variable qui est vide ou évaluée à 0 ou false

Exemple

Par exemple : vous utilisez plusieurs plateformes et vous voulez configurer différents paramètres en fonction du système d’exploitation. Dans le code suivant, la commande de script [[ ]] est évaluée et la <commande> sera exécutée. Ce peut être utile dans une étape de post-génération.

[[ if (PLATFORM ==  PLATFORM_MSW) { print (_T("cmd /c")); } else 
     { print (_T("sh ")); } ]] <commande>

3.3  Expansion de script

Pour une flexibilité maximale, vous pouvez imbriquer les scripts en utilisant l’opérateur [[ ]] en tant que cas particulier d’expansion de variable. Les scripts imbriqués ont accès à toutes les fonctionnalités standard disponibles pour les scripts et se comportent comme des ”backticks” (ou apostrophes inversées) de bash (à l’exception de l’accès au namespace de Code::Blocks). En tant que tels, les scripts ne sont pas limités à la production de sorties de type texte, mais peuvent aussi manipuler des états de Code::Blocks (projets, cibles, etc.).

Exemple avec Backticks

objdump -D ‘find . -name *.elf‘ > name.dis

L’expression entre ”backticks” (ou apostrophes inversées) retourne une liste de tous les exécutables *.elf des sous-répertoires. Le résultat de cette expression peut être utilisé directement par objdump. Au final, la sortie est redirigée vers un fichier nommé name.dis. Ainsi, des processus peuvent être automatisés simplement sans avoir recours à aucune boucle.

Exemple utilisant un Script

Le texte du script est remplacé par toute sortie générée par votre script, ou ignoré en cas d’erreur de syntaxe.

Comme l’évaluation conditionnelle est exécutée avant l’expansion de scripts, l’évaluation conditionnelle peut être utilisée pour les fonctionnalités de type pré-processeur. Les variables internes (et les variables utilisateur) sont étendues en sortie de scripts, aussi on peut référencer des variables dans les sorties d’un script.

[[ print(GetProjectManager().GetActiveProject().GetTitle()); ]]

insère le titre du projet actif dans la ligne de commande.

3.4  Macros Commandes

$compiler

Accède au nom de l’exécutable du compilateur.

$linker

Accède au nom de l’exécutable de l’éditeur de liens.

$options

Flags du Compilateur

$link_options

Flags de l’éditeur de liens

$includes

Chemins des include du compilateur

$c

Chemins des include de l’éditeur de liens

$libs

Librairies de l’éditeur de liens

$file

Fichier source (nom complet)

$file_dir

Répertoire du fichier source sans le nom de fichier ni son extension.

$file_name

Nom du fichier source sans les informations de chemin ni l’extension.

$exe_dir

Répertoire du fichier exécutable sans le nom de fichier ni son extension.

$exe_name

Nom du fichier exécutable sans les informations de chemin ni l’extension.

$exe_ext

Extension de l’exécutable sans les informations de chemin ni le nom du fichier.

$object

Fichier objet

$exe_output

Fichier exécutable de sortie

$objects_output_dir

Répertoire de sortie des fichiers objets

3.4.1  Exemple 1 : Compilation d’un fichier unique

$compiler $options $includes -c $file -o $object

3.4.2  Exemple 2 : Édition de liens de fichiers objets en exécutable

$linker $libdirs -o $exe_output $link_objects $link_resobjects 
$link_options $libs

3.5  Variables globales du compilateur

Cette section décrit comment travailler avec des variables globales.

3.5.1  Synopsis

Travailler en tant que développeur sur un projet reposant sur des librairies tierces impose un certain nombre de tâches répétitives inutiles, comme configurer des variables de génération dépendantes du système de fichier local. Dans le cas de fichiers projets, une attention toute particulière doit être apportée afin de ne pas diffuser une copie modifiée localement. Si on n’y prend pas garde, cela peut se produire facilement après avoir changé par exemple un flag de génération pour obtenir une version de type release.

Le concept de variable globale du compilateur est une nouvelle solution unique à Code::Blocks qui adresse ce problème. Les variables globales du compilateur vous permettent de configurer un projet une seule fois, et n’importe quel nombre de développeurs utilisant n’importe quel système de fichiers pour compiler et développer ce projet. Aucune information locale ne nécessite d’être changée plus d’une fois.

3.5.2  Noms et Membres

Les variables globales du compilateur dans Code::Blocks se distinguent des variables par-projet par la présence d’un signe dièse en tête. Les variables globales du compilateur sont structurées ; chaque variable consiste en un nom et un membre optionnel. Les noms sont définissables librement, alors que les membres sont construits dans l’Environnement Intégré de Développement (IDE). Bien que vous puissiez choisir n’importe quoi comme nom en principe, il est recommandé de reproduire des identificateurs connus de packages communément utilisés. Ainsi, le nombre d’informations que l’utilisateur doit fournir est minimisé. L’équipe de Code::Blocks fourni une liste de variables recommandées pour divers packages connus.

Le membre base correspond à la même valeur que celle de la variable utilisée sans membre (alias).

Les membres include et lib sont par défaut des aliases pour base/include et base/lib, respectivement. Cependant, l’utilisateur peut les redéfinir si une autre configuration est souhaitée.

Il est généralement recommandé d’utiliser la syntaxe $(#variable.include) plutôt que son équivalent $(#variable)/include, car elle fournit une flexibilité accrue tout en étant fonctionnellement identique (voir section 3.5.6 et figure 3.1 pour plus de détails).

Les membres cflags et lflags sont vides par défaut et peuvent être utilisés pour fournir la possibilité de remplir un ensemble consistant unique de flags compilateur/éditeur de liens pour toutes les générations sur une machine donnée. Code::Blocks vous permet de définir des membres de variables utilisateur en complément de ceux prédéfinis.

3.5.3  Contraintes

• Les noms de variables de configuration ou de compilateur ne peuvent pas être vides, ne peuvent pas contenir de caractères blancs (ou espaces), doivent commencer par une lettre et ne contenir que des caractères alphanumériques. Les lettres Cyrilliques ou Chinoises ne sont pas des caractères alphanumériques. Si Code::Blocks rencontre une séquence de caractères non valides dans un nom, il peut la remplacer sans le demander.

• Toutes les variables nécessitent que leur base soit définie. Tout le reste est optionnel, mais la base est absolument obligatoire. Si vous ne définissez pas la base d’une variable, elle ne sera pas sauvegardée (et ce même si les autres champs ont été définis).

• Vous ne pouvez pas définir un nom de membre défini par l’utilisateur qui a le même nom qu’un membre prédéfini. Actuellement, le membre utilisateur écrasera le membre prédéfini, mais en général, le comportement est indéfini dans ce cas. Si ’libext’ est un membre défini par l’utilisateur on peut seulement écrire $(#variable.libext) et pas $(#variable)/libext.

• Les valeurs des variables et des membres peuvent contenir un nombre arbitraire de séquences de caractères, mais doivent respecter les contraintes suivantes :

  • Vous ne pouvez pas définir une variable par une valeur qui se référence à la même variable ou à n’importe lequel de ses membres

  • Vous ne pouvez pas définir un membre par une valeur qui se référence à ce même membre

  • Vous ne pouvez pas définir un membre ou une variable par une valeur qui se référence à la même variable ou membre par une dépendance cyclique.

Code::Blocks détectera les cas de définitions récursives les plus évidentes (ce qui peut arriver par accident), mais il ne fera pas d’analyse en profondeur de tous les cas possibles abusifs. Si vous entrez n’importe quoi, alors vous obtiendrez n’importe quoi; vous êtes avertis maintenant.

Exemples

Définir wx.include comme $(#wx)/include est redondant, mais parfaitement légal. Définir wx.include comme $(#wx.include) est illégal et sera détecté par Code::Blocks. Définir wx.include comme $(#cb.lib) qui est lui-même défini comme $(#wx.include) créera une boucle infinie.

3.5.4  Utilisation des Variables Globales du Compilateur

Tout ce que vous avez à faire pour utiliser des variables globales de compilateur c’est de les mettre dans votre projet! Oui, c’est aussi simple que cela.

Quand l’Environnement Intégré de Développement (IDE) détecte la présence d’une variable globale inconnue, il vous demande d’entrer sa valeur. La valeur sera sauvegardée dans vos paramètres, ainsi vous n’aurez jamais besoin d’entrer deux fois l’information.

Si vous avez besoin de modifier ou de supprimer une variable plus tard, vous pourrez le faire depuis le menu des paramètres.

Exemple

L’image ci-contre montre à la fois les variables par-projet et globales. WX_SUFFIX est défini dans le projet, mais WX est une variable utilisateur globale.

3.5.5  Ensembles de Variables

Parfois, vous voulez utiliser différentes versions d’une même librairie, ou vous développez deux branches d’un même programme. Bien qu’il soit possible de gérer cela avec une variable globale de compilateur, cela peut devenir fastidieux. Dans ce cas, Code::Blocks supporte des ensembles de variables. Un ensemble de variables est une collection indépendante de variables, identifiée par un nom (les noms d’ensemble ont les mêmes contraintes que les noms de variables).

Si vous souhaitez basculer vers un autre ensemble de variables, vous sélectionnez tout simplement un ensemble différent depuis le menu. Des ensembles différents n’ont pas obligatoirement les mêmes variables, et des variables identiques dans différents ensembles n’ont pas forcément les mêmes valeurs, ni même des membres utilisateurs identiques.

Un autre point positif à propos des ensembles est que si vous avez une douzaine de variables et que vous voulez obtenir un nouvel ensemble avec une de ces variables pointant vers un endroit différent, vous n’êtes pas obligés de ré-entrer toutes les données à nouveau. Vous pouvez simplement créer un clone de l’ensemble courant, ce qui dupliquera toutes vos variables.

Supprimer un ensemble supprimera également toutes les variables de cet ensemble (mais pas celles d’une autre ensemble). L’ensemble default est toujours présent et ne peut pas être supprimé.

Vous pouvez aussi exporter ou importer des ensembles de variables (depuis la version SVN r13224) : les fichiers, avec l’extension .set, sont des fichiers de texte contenant un ensemble particulier de variables. Ces fichiers sont facilement transférables entres utilisateurs/ordinateurs.

Toutes ces options sont disponibles via les boutons ”Ajouter”, ”Supprimer”, ”Cloner”, ”Exporter” et ”Importer”, situés en haut de la fenêtre des Variables Globales d’Environnement (voir figure 3.1).

3.5.6  Mini-Tutoriel pour utilisateur curieux

Comme décrit auparavant, écrire $(#var.include) et $(#var)/include revient à la même chose par défaut. Aussi pourquoi donc écrire quelque chose d’aussi non intuitif que $(#var.include)?

Prenons l’exemple d’une installation standard de Boost sous Windows. Généralement, vous vous attendriez à ce qu’un package fictif ACME ait ses fichiers include dans ACME/include et ses librairies dans ACME/lib. Optionnellement, il pourrait mettre ses en-têtes (headers) dans un autre sous répertoire appelé acme. Ainsi après avoir ajouté les chemins corrects dans les options du compilateur et de l’éditeur de liens, vous pouvez vous attendre à #include <acme/acme.h> et éditer les liens avec libacme.a (ou quelque chose de ce genre).

Boost, cependant, installe les en-têtes dans C:∖Boost∖include∖boost-1_33_1∖boost et ses librairies dans C:∖Boost∖lib par défaut. Il semble impossible d’obtenir ceci simplement sans devoir tout ajuster sur chaque nouveau PC, particulièrement si vous devez travailler sous Linux mais aussi avec un autre OS.

C’est là que la véritable puissance des variables globales utilisateur se révèle. Quand vous définissez la valeur de la variable #boost, vous allez juste un cran plus loin que d’habitude. Vous définissez le membre include comme C:∖Boost∖include∖boost-1_33_1∖boost et le membre lib comme C:∖Boost∖lib, respectivement. Votre projet utilisant $(#boost.include) et $(#boost.lib) travaillera comme par magie correctement sur tout PC sans aucune modifications. Vous n’avez pas besoin de savoir pourquoi, vous ne voulez pas savoir pourquoi.

3.5.7  Arguments en Ligne de Commande

Depuis la révision [r13245] on peut utiliser les arguments en ligne de commande pour substituer et définir des variables globales et configurer l’ensemble courant actif.

• ’-S’ paramêtre pour configurer l’ensemble courant actif via la ligne de commande

• ’-D’ paramêtre pour définir/substituer une variable utilisateur de la forme :
  -D set.variable.membre=valeur ou -D variable.membre=valeur

4  Travailler avec Code::Blocks

Ce chapitre traite de quelques connaissances de base pour pouvoir travailler avec Code::Blocks. Quelques paragraphes, ici directement repris du Wiki font double emploi mais avec une présentation un peu différente de ce qu’il y a dans le premier chapitre.

4.1  Le processus de génération de Code::Blocks

Dans ces pages, le processus de génération est expliqué en détail. On y voit ce qui se passe en arrière-plan et ”quand”. Je vous souhaite une intéressante lecture :).

4.1.1  Étapes successives de la Génération

Comme vous l’avez peut-être déjà compris, Code::Blocks ne lance pas au hasard les commandes de génération, mais effectue plutôt une séquence d’étapes bien pensées et préparées. Mais avant tout, regardons les différents composants qui sont utilisés lors d’une génération:

Espace de Travail :

contient un ou plusieurs projets (dénommé aussi workspace, comme en anglais)

Projet :

contient une ou plusieurs cibles de génération. Il contient également les fichiers de projet.

Cible de génération :

ce sont les variantes de projet qui lui-sont assignés, et qui seront générées par groupes afin de produire une sortie binaire. Cette sortie peut être soit un exécutable, une librairie dynamique ou statique. Note : Il existe un type de cible de génération qui ne produit pas directement une sortie binaire mais se contente plutôt de seulement réaliser des étapes de pre/post génération (qui peuvent générer de façon externe une sortie binaire).

Décomposons ces sujets en sections et expliquons-les en détail.

4.1.2  Espace de Travail

Un espace de travail (ou Workspace) est un conteneur (celui de plus haut niveau) utilisé pour organiser vos projets. Comme il ne peut y avoir qu’un seul espace de travail ouvert à la fois, il n’y a pas d’ordre spécifique les concernant. Un seul espace, donc il suffit de le générer ;).

Utilisez le menu ’Générer’ →’Générer l’espace de travail’ pour générer l’espace de travail (c.à.d. tous les projets qui y sont contenus).

4.1.3  Projets

C’est ici que les choses deviennent intéressantes :).

L’ordre de génération des projets est différent suivant que l’utilisateur a indiqué s’il y a des dépendances ou pas entre les projets. Alors, allons-y...

Sans dépendances inter-projets

Dans ce cas, les projets sont générés dans l’ordre d’apparition, du haut vers le bas. Dans la plupart des projets cependant (sauf ceux du genre ”hello world”), vous allez vouloir créer des dépendances entre projets.

Utilisation de dépendances entre projets

Les dépendances de projets sont une façon simple d’indiquer à Code::Blocks qu’un projet donné ”dépend” d’un autre (toujours dans le même espace de travail).

Alors imaginons que, dans votre espace de travail, vous avez un projet de librairie et un projet d’exécutable qui dépend de cette librairie. Vous pouvez alors (et devez) informer Code::Blocks de cette dépendance. Pour faire cela, vous sélectionnez ’Projet’ →’Propriétés’ et cliquez sur le bouton des ”Dépendances de Projet...”.

Veuillez noter que les informations de dépendances sont enregistrées dans le fichier de l’espace de travail, et non dans un fichier projet car les dépendances se font entre deux projets à l’intérieur d’un même espace de travail.

C’est très facile d’utiliser ce dialogue. Sélectionnez le projet sur lequel vous voulez ajouter une dépendance et cochez la case sur tous les projets dont ce projet de base dépend. Cela aura pour conséquence que tous les projets que vous avez coché seront générés avant le projet qui en dépend, assurant ainsi une génération synchronisée.

Astuce : Vous n’avez pas à fermer ce dialogue et lancer d’autres propriétés de projets de nouveau pour configurer leurs dépendances. Vous pouvez configurer toutes les dépendances de projets depuis cette même boîte de dialogue. Sélectionnez simplement un autre projet dans le menu déroulant :).

Quelques choses à noter :

• Les dépendances sont configurées directement ou indirectement. Si le projet A dépend directement du projet B et que le projet B dépend du projet C, alors le projet A dépend également du projet C, mais indirectement.

• Code::Blocks est suffisamment intelligent pour vérifier s’il y a des dépendances circulaires et donc les interdire. Une dépendance circulaire est obtenue quand un projet A dépend directement ou indirectement d’un projet B et que le projet B dépend directement ou indirectement du projet A.

• Les dépendances prennent effet soit lors de la génération d’un espace de travail entier soit sur un projet seul. Dans ce cas, seules les dépendances nécessaires au projet que vous êtes en train de générer seront aussi générées.

4.1.4  Génération de Cibles

L’ordre de génération des cibles dépend de deux choses.

1.

Si l’utilisateur a sélectionné une cible particulière dans le menu déroulant de la barre de compilation, alors seule cette cible sera générée. Si des dépendances de projet ont été configurées pour le projet contenant cette cible, tous les projets dépendants génèreront aussi leur cible sous le même nom. Si une telle cible n’existe pas, on passe au projet suivant.

2.

Si la cible virtuelle ”All” est sélectionnée, alors toutes les cibles dans le projet (et tous les projets dépendants) sont générés dans l’ordre du haut vers le bas. Il y a deux exceptions à cela :

• Une cible n’est pas générée par ”All” si l’option de cible (dans la page des propriétés du projet ”Cibles de génération”) ”Générer cette cible par All” n’est pas sélectionnée.

• Si aucune cible du projet n’a de sélectionnées l’option ci-dessus, alors la cible ”All” n’apparait pas dans la liste.

4.1.5  Phase de Preprocessing

Avant que le processus de génération démarre (c.à.d. commence l’exécution des commandes de compilation/édition de liens), une étape de preprocessing est lancée pour générer toutes les lignes de commandes du processus complet de génération. Cette étape place dans un cache la plupart des informations qu’elle génère, ce qui a pour effet de rendre les générations suivantes plus rapides.

Cette étape lance aussi tout script de génération qui y est attaché.

4.1.6  Commandes réelles d’exécution

C’est l’étape, du point de vue de l’utilisateur, où le processus de génération commence réellement. Les fichiers commencent à être compilés et au final liés entre eux pour générer les diverses sorties binaires définies par les cibles de génération.

Dans cette étape sont aussi exécutées les cibles de pré-génération et de post-génération.

4.1.7  Étape de pré-génération et post-génération

Ce sont des commandes qui peuvent être configurées au niveau projet et/ou au niveau cible. Ce sont des commandes Shell qui par exemple copient des fichiers ou toute autre opération que vous pouvez réaliser par les commandes Shell habituelles de l’OS.

Les variables spécifiées dans le paragraphe Expansion de Variables (3) peuvent être utilisées dans les scripts afin de récupérer des informations comme le répertoire de sortie, le répertoire de projet, le type de cible ou autres.

Vous avez ci-dessous le déroulé dans l’ordre d’exécution des étapes de pré/post génération d’un projet imaginaire avec 2 cibles (Debug/Release) :

1.

Étapes de pré-génération du Projet

a)

Target ”Debug” étapes de pré-génération

b)

Target ”Debug” compilation des fichiers

c)

Target ”Debug” édition de liens des fichiers et génération de la sortie binaire

d)

Target ”Debug” étapes de post-génération (voir les notes ci-dessous)

e)

Target ”Release” étapes de pré-génération

f)

Target ”Release” compilation des fichiers

g)

Target ”Release” édition de liens des fichiers et génération de la sortie binaire

h)

Target ”Release” étapes de post-génération (voir les notes ci-dessous)

2.

Étapes de post-génération du Projet

J’espère que c’est suffisamment clair :)

Exemples de Script

Script de Post-génération qui copie le fichier de sortie dans un répertoire C:∖Program∖bin sous Windows :

cmd /c copy "$(PROJECT_DIR)$(TARGET_OUTPUT_FILE)" "C:\Program\bin"

Exécution du script bash ”copyresources.sh” sous Linux :

/bin/sh copyresources.sh

Création d’un nouveau répertoire dans le répertoire de sortie :

mkdir $(TARGET_OUTPUT_DIR)/data

4.2  Création d’un Nouveau Projet

Ces pages sont un guide sur les fonctionnalités de base (et quelques intermédiaires) pour la création et la modification d’un projet Code::Blocks. Si c’est votre première exéprience avec Code::Blocks, alors ceci est un bon point de départ.

4.2.1  L’assistant de Projet

Lancez l’assistant de Projet par ’Fichier’ →’Nouveau’ →’Projet...’ afin de démarrer un nouveau projet. Ici, il y a plusieurs modèles pré-configurés pour divers types de projets, incluant l’option de création de modèles personnalisés. Sélectionnez Console application, car c’est le plus commun pour un usage général, puis cliquez sur Aller ou Go.

L’assistant Application console apparaitra ensuite. Continuez dans les menus, en sélectionnant C++ quand on vous demandera le langage. Sur l’écran suivant, donnez un nom au projet et tapez ou sélectionnez un répertoire de destination. Comme on voit ci-dessous, Code::Blocks génèrera les entrées restantes à partir de ces deux là.

Finalement, l’assistant vous demandera si ce projet doit utiliser le compilateur par défaut (normalement GCC) et les deux générations par défaut : Debug et Release. Toutes ces configurations sont correctes. Appuyez sur Terminer et le projet va se générer. La fenêtre principale va se griser, mais ce n’est pas un problème, le fichier source doit encore être ouvert. Dans l’onglet Projets du panneau de Gestion sur la gauche, dépliez les répertoires et double-cliquez sur le fichier source main.cpp afin de l’ouvrir dans l’éditeur.

Ce fichier contient le code standard suivant.

main.cpp

#include <iostream> 
using namespace std; 
int main() 
{ 
   cout << "Hello world!" << endl; 
   return 0; 
}

4.2.2  Changer la composition du fichier

Un simple fichier source est d’un intérêt limité dans des programmes plus ou moins complexes. Pour traiter cela, Code::Blocks possède plusieurs méthodes très simples permettant d’ajouter des fichiers supplémentaires au projet.

Ajout d’un fichier vide

Dans cet exemple, nous allons isoler la fonction

main.cpp

   cout << "Hello world!" << endl;

dans un fichier séparé.

Pour ajouter un nouveau fichier au projet, appelez l’assistant de modèle de fichier soit par le ’Fichier’ →’Nouveau’ →’Fichier...’ soit par ’Barre d’outils principale’ →’Nouveau fichier (bouton)’ →’Fichier...’ Utilisez le menu ’Générer’ →’Générer l’espace de travail’ pour générer un espace de travail (c.a.d tous les projets qui y sont contenus).

Sélectionnez la source en C/C++ et cliquez sur Aller (ou Go). Continuez dans les dialogues suivants tout comme lors de la création du projet original, en sélectionnant C++ quand on vous demandera le langage. La page finale vous présentera plusieurs options. La première boîte détermine le nouveau nom du fichier et l’emplacement (comme noté, le chemin complet est requis). Vous pouvez utiliser en option le bouton ... pour afficher une fenêtre de navigateur de fichiers pour enregistrer l’emplacement du fichier. En cochant Ajouter le fichier au projet actif vous enregistrerez le nom du fichier dans le répertoire Sources de l’onglet Projets du panneau de Gestion. En cochant une ou plusieurs cibles de génération vous informerez Code::Blocks que le fichier devra être compilé puis de faire l’édition de liens pour la(les) cible(s) sélectionnée(s). Ce peut être utile si, par exemple, le fichier contient du code spécifique de débogage, car cela permettra l’inclusion dans (ou l’exclusion de) la (les) cible(s) de génération appropriée(s). Dans cet exemple, toutefois, la fonction hello est indispensable, et donc requise dans toutes les sources. Par conséquent, sélectionnez toutes les cases et cliquez sur Terminer pour générer le fichier.