Tutorial: Compiler un programme en C++

Transcription

1 Tutorial: Compiler un programme en C++ Ce tutorial propose de reprendre dans deux cas de figures (un unique fichier source, et plusieurs fichiers sources en c++11 différentes approches permettant de compiler des fichiers en C++. Contents 1 Compilation d un fichier unique En ligne de commande À l aide d un Makefile À l aide de QMake À l aide de CMake Compilation de plusieurs fichiers En ligne de commande À l aide d un Makefile À l aide de QMake À l aide de CMake

2 1 Compilation d un fichier unique Soit un programme d exemple contenant un unique fichier (main.cpp par exemple. #include <iostream> #include <string> int main( { std::string variable="mon premier"; variable += " programme."; std::cout<<variable<<std::endl; } return 0; Il est possible de compiler ce fichier suivant différentes approches. 1.1 En ligne de commande Cette solution est possible lorsque vous avez un seul fichier source, elle est à déconseiller si votre programme contient plusieurs fichiers car trop répétitive. Ouvrez une ligne de commande dans le même répertoire que le fichiermain.cpp. Tapez g++ main.cpp -g -Wall -Wextra -o main Cette commande viens générer le fichiermain executable qui se lance dans le même terminal (observez le à l aide de la commandels à l aide de la commande 1.2 À l aide d un Makefile Solution généralement conseillée: précision et compréhension de la démarche. Dans le même répertoire que le fichiermain.cpp, créer un fichier du nom demakefile, et remplissez le de la manière suivante à l aide d un éditeur de texte. CXXFLAGS = -g -Wall -Wextra all: main main : main.cpp clean: rm -f * main Notez qu il y a une tabulation avant la commanderm, et non une suite d espaces. Pour compiler le programme, tapez ensuite dans la ligne de commande./ Cette commande viens générer l executablemain que vous pouvez ensuite lancer. Notez qu il est possible de nettoyer le répertoire des fichiers temporaires et de l executable par l appel à la commande./ clean Il est par contre inutile d appeler clean entre deux compilations. 2/7 CPE Lyon

3 1.3 À l aide de QMake Solution envisageable pour un projet utilisant Qt. Il n est pas conseillé d utiliser QMake sur un autre type de projet: peu de controles et ajout de bibliothèques et dépendances inutiles. QMake est un outil associé à la bibliothèque de développement Qt permettant de générer sans efforts des Makefile à partir d un ensemble de fichiers sources. Dans un répertoire en amont de celui contenant le fichier main.cpp 1, tapez en ligne de commande q -project Observez la création d un fichier du type [nom_repertoire].pro. Ce fichier est un fichier de configuration pour l outil QMake. Cette première étape permet de parcourir les répertoires du projet pour générer ce fichier de configuration. Il est cependant également possible d écrire ce fichier entièrement à la main pour d autres projets. Dans le cas présent, les Warnings ne sont pas activés. Pour activez ceux-ci, il est possible d éditer le fichier [nom_repertoire].pro à l aide d un éditeur de texte, et d y ajouter la ligne suivante: QMAKE_CXXFLAGS += -g -Wall -Wextra Tapez ensuite en ligne de commande q. Cette commande permet de générer un Makefile à partir du fichier de configuration.pro. De manière traditionnelle, la compilation puis l execution se réalise à l aide des commandes suivantes:./[nom_repertoire] 1.4 À l aide de CMake Solution envisageable pour un projet quelconque utilisant Qt ou d autres bibliothèques. Il est recommandé de connaitre l utilisation et la configuration d un projet CMake. CMake génère cependant un Makefile peu lisible, moins générique et inclus de nombreuses dépendences parfois inutiles. Il reste ainsi conseillé de pouvoir également être capable de générer un Makefile plus simple équivalent. CMake est un outil permettant de simplifier la création d un Makefile pour un projet existant. CMake est développé par Kitware 2 qui l utilise classiquement pour compiler leurs projets (VTK, ITK, etc. Dans un répertoire en amont de celui contenant le fichier main.cpp 3, créez un fichier CMakeLists.txt qui contient les informations suivantes c_minimum_required(version 2.6 project(main 1 Il est possible de faire cette démarche dans le même répertoire, mais il est conseillé d éviter cette pratique pour éviter de polluer votre répertoire source et d écraser un Makefile existant 2 société de développement de logiciels en imagerie médicale et informatique scientifique 3 Idem que pour QMake 3/7 CPE Lyon

4 set(cmake_build_type debug set(cmake_cxx_flags "-Wall -Wextra" file( GLOB_RECURSE source_files src/*.cpp add_executable( main ${source_files} Ce fichier est un fichier de configuration que l on écrit à la main. L avantage de ce fichier concerne la description récursive et générique des noms de fichiers. CMake possède également l avantage de pouvoir trouver certaines librairies de manière automatique sur différents PC. Tapez en ligne de commande c. Cette commande a pour effet de lancer l outilcmake sur le fichier de configuration CMakeLists.txt et génère un fichiermakefile. Note: Il est également possible d avoir un éditeur configurable en mode graphique en tapantc-gui.. Une fois le Makefile généré, celui-ci permet de compiler puis d exécuter le projet de manière traditionnelle: Note: L utilisation de CMake génère plusieurs fichiers temporaires: CMakeCache.txt, c_install.c, et un répertoire temporaire CMakeFiles. Ces fichiers et répertoires peuvent être supprimés en toutes sécurités, le seul fichier à garder est le fichier de configuration CMakeLists.txt. En particulier, il est recommandé de supprimer tous les fichiers temporaires lorsque vous déplacer votre projet, ou bien changez de machine. Il suffit alors de relancer l outilcmake sur votre fichier de configuration pour créer un nouveaumakefile. 4/7 CPE Lyon

5 2 Compilation de plusieurs fichiers Supposons désormais les fichiers suivants dans le même répertoire: //FICHIER main.cpp #include "lib1.hpp" #include <iostream> #include <string> int main( { std::cout<<"j appelle ma fonction:"<<std::endl; ma_fonction(; } return 0; //FICHIER lib1.hpp #pragma once #ifndef LIB1_HPP #define LIB1_HPP void ma_fonction(; #endif //FICHIER lib1.cpp #include "lib1.hpp" #include <iostream> using std::cout; using std::endl; void ma_fonction( { auto T={7,8,9,-12}; for(auto value : T cout<<value<<endl; } Nous pouvons également détailler les différentes approches de compilation. 2.1 En ligne de commande Ouvrez une ligne de commande dans le même répertoire que le fichiermain.cpp. Tapez dans un ordre quelconque la demande de compilation des deux fichiers g++ -c lib1.cpp -g -Wall -Wextra -std=c++11 g++ -c main.cpp -g -Wall -Wextra -std=c++11 5/7 CPE Lyon

6 Note: Cette fois nous ajoutons l option std=c++11 car le code contient du c++ moderne. Réalisez ensuite l édition de lien pour créer l exécutable g++ lib1.o main.o -o main L executable généré peut alors être lancé par la commande 2.2 À l aide d un Makefile Dans le même répertoire que vos fichiers sources, écrivez cette fois le Makefile suivant: CXXFLAGS = -g -Wall -Wextra -std=c++11 CXX=g++ #executable name project=main all: ${project} #linking ${project} : main.o lib1.o ${CXX} $ˆ -o ${project} #compile object files main.o: main.cpp lib1.hpp lib1.o: lib1.cpp lib1.hpp clean: rm -f * *.o main Puis demandez la compilation et enfin l exécution du projet par les deux lignes suivantes: 2.3 À l aide de QMake Créez tout d abord le fichier de configuration.pro dans un répertoire en amont de vos sources. q -project Éditez ensuite le fichier de configuration.pro afin d y ajouter les paramètres suivants QMAKE_CXXFLAGS += -g -Wall -Wextra -std=c++11 Puis créez le Makefile, compilez et exécutez le projet à l aide des commandes suivante q../[nom_repertoire] 6/7 CPE Lyon

7 2.4 À l aide de CMake Dans un répertoire en amont de vos fichiers sources, créez cette fois un fichier CMakeLists.txt avec les instructions suivantes. c_minimum_required(version 2.6 project(main set(cmake_build_type debug set(cmake_cxx_flags "-Wall -Wextra -std=c++11" file( GLOB_RECURSE source_files src/*.[ch]pp add_executable( main ${source_files} Remarque: ce fichier est très générique et peux être récopié tel pour compiler de nombreux projets. Faites ensuite appel à CMake pour générer le Makefile, compilez le projet, puis exécuter celui-ci à l aide des 3 commandes suivantes. c. 7/7 CPE Lyon