Différences
Ci-dessous, les différences entre deux révisions de la page.
| Les deux révisions précédentes Révision précédente Prochaine révision | Révision précédente | ||
|
gtkmm [Le 11/06/2012, 23:00] 88.120.181.98 [Avec l'IDE codeblocks] |
gtkmm [Le 11/09/2022, 12:09] (Version actuelle) moths-art Suppression des espaces en fin de ligne (détecté et corrigé via le bot wiki-corrector (https://forum.ubuntu-fr.org/viewtopic.php?id=2067892) |
||
|---|---|---|---|
| Ligne 4: | Ligne 4: | ||
| =====Installation===== | =====Installation===== | ||
| - | Pour installer les librairies de développement de gtkmm, il faut installer le paquet [[apt://libgtkmm-2.4-dev |libgtkmm-2.4-dev ]]. | + | Pour installer les librairies de développement de gtkmm, il faut installer le paquet [[apt>libgtkmm-3.0-dev]] (ou 2.4). |
| - | Si vous le désirez vous pouvez installer la documentation (en anglais) en installant [[apt://libgtkmm-2.4-doc |libgtkmm-2.4-doc]]. Pour la lire, vous pouvez utiliser le programme [[apt://devhelp |devhelp]], ou simplement votre navigateur web préféré en vous rendant à l'adresse [[file:///usr/share/doc/libgtkmm-2.4-doc/docs/index.html]] | + | Si vous le désirez vous pouvez installer la documentation (en anglais) en installant [[apt>libgtkmm-3.0-doc]]. Pour la lire, vous pouvez utiliser le programme [[apt>devhelp]], ou simplement votre navigateur web préféré en vous rendant à l'adresse [[file:///usr/share/doc/libgtkmm-3.0-doc/docs/index.html]] |
| =====Compilation===== | =====Compilation===== | ||
| ==== Avec g++ ==== | ==== Avec g++ ==== | ||
| Pour compiler, vous devrez linker le projet en utilisant l'utilitaire pkg-config comme ci-dessous: | Pour compiler, vous devrez linker le projet en utilisant l'utilitaire pkg-config comme ci-dessous: | ||
| - | <code>g++ fichier.cpp -o executable `pkg-config gtkmm-2.4 --cflags --libs` </code> | + | <code>g++ fichier.cpp -o executable `pkg-config gtkmm-3.0 --cflags --libs` </code> |
| ==== Avec l'IDE codeblocks ==== | ==== Avec l'IDE codeblocks ==== | ||
| Ligne 17: | Ligne 17: | ||
| * Créez un projet de type « console application » en C++ dans codeblocks. | * Créez un projet de type « console application » en C++ dans codeblocks. | ||
| * Allez dans Project → Build options → Compiler settings → Other options, et collez-y ceci : | * Allez dans Project → Build options → Compiler settings → Other options, et collez-y ceci : | ||
| - | <code>`pkg-config --cflags gtkmm-2.4`</code> | + | <code>`pkg-config --cflags gtkmm-3.0`</code> |
| + | N.B. ; l'option pkg-config est entre "guillemets-accent-grave" ( = Alt-Gr + 7 ) | ||
| * Allez dans Project → Build options → Linker settings → Other linker options, et collez-y ceci : | * Allez dans Project → Build options → Linker settings → Other linker options, et collez-y ceci : | ||
| - | <code>`pkg-config --libs gtkmm-2.4`</code> | + | <code>`pkg-config --libs gtkmm-3.0`</code> |
| * Entrez un code de base pour gtkmm : | * Entrez un code de base pour gtkmm : | ||
| <code> | <code> | ||
| #include <iostream> | #include <iostream> | ||
| - | #include <gtkmm-2.4/gtkmm.h> | + | #include <gtkmm-3.0/gtkmm.h> |
| int main(int argc, char *argv[]) | int main(int argc, char *argv[]) | ||
| Ligne 36: | Ligne 37: | ||
| * Vous pouvez maintenant écrire et compiler votre projet. Vous pouvez également l'enregistrer comme template : File → save project as user template. Vous pourrez ainsi créer directement dans codeblocks un nouveau projet utilisant gtkmm : File → New → Project → User templates. | * Vous pouvez maintenant écrire et compiler votre projet. Vous pouvez également l'enregistrer comme template : File → save project as user template. Vous pourrez ainsi créer directement dans codeblocks un nouveau projet utilisant gtkmm : File → New → Project → User templates. | ||
| - | Bien sûr, cette démarche doit être adaptée à la version de gtkmm que vous utilisez. Les lignes ci-dessus ont été écrite pour le paquet **gtkmm-2.4**. Mais si vous avez installé le paquet **gtkmm-3.0**, elles doivent être naturellement adaptées de la façon suivante : | + | Bien sûr, cette démarche doit être adaptée à la version de gtkmm que vous utilisez. Les lignes ci-dessus ont été écrite pour le paquet **gtkmm-3.0**. Mais si vous avez installé le paquet **gtkmm-2.4**, elles doivent être naturellement adaptées de la façon suivante : |
| * Créez un projet de type « console application » en C++ dans codeblocks. | * Créez un projet de type « console application » en C++ dans codeblocks. | ||
| Ligne 58: | Ligne 59: | ||
| </code> | </code> | ||
| - | Il peut être intéressant, surtout si l'on débute en C++, de compléter l'installation de **Codeblocks** en installant des **exemples de programmes**. On peut trouver de nombreux exemples sur le site [[http://git.gnome.org/browse/gtkmm-documentation/tree/examples/book]] ou encore dans les tutoriels proposés sur le site : [[http://developer.gnome.org/gtkmm-tutorial]]. Comme on peut le voir sur les forums, ils ont l'inconvénient de présenter des erreurs à la compilation ! Ceci est sans doute du fait que la version de gtkmm utilisée pour les mettre au point n'est pas bien précisée (elle ne correspond pas toujours au numéro de version des paquets ! ) et est sans doute différente de la vôtre. | + | Il peut être intéressant, surtout si l'on débute en C++, de compléter l'installation de **Codeblocks** en installant des **exemples de programmes**. On peut trouver de nombreux exemples sur le site [[http://git.gnome.org/browse/gtkmm-documentation/tree/examples/book]] ou encore dans les tutoriels proposés sur le site : [[http://developer.gnome.org/gtkmm-tutorial]]. |
| + | Comme on peut le voir sur les forums, il arrive souvent que ds tentatives d'utilisation de ces exemples se soldent par des erreurs à la compilation ! Ceci est du fait que la version de gtkmm utilisée pour les mettre au point est différente de celle que vous venez d'installer sur votre ordinateur. Deux raisons peuvent induire en erreur : | ||
| - | Voici quelques conseils pour vous aider à en faire tourner quelques uns avec **gtkmm-3.0** : | + | - la première est que le numéro de version gtkmm n'est pas forcément le même que le numéro de version des paquets(cf. [[http://developer.gnome.org/gtkmm-tutorial/unstable/sec-install-unix-and-linux.html.fr#sec-linux-install-from-packages]] ). Si l'on constate des erreurs à la compilation, il peut être intéressant de tester la compilation pour des versions de numéro voisins. |
| - | * La première étape consiste à récupérer les codes sources des programmes donnés en exemple sur le site [[http://git.gnome.org/browse/gtkmm-documentation/tree/examples/book]] et à les placer dans un répertoire local. | + | - la deuxième raison est que le numéro de la version de gtkmm qui correspond à ces programmes n'est pas inscrite dans les commentaires du code de ces programmes. Une fois ces programmes récupérés, si vous n'avez pas fait attention au numéro de version au moment où vous les avez récupérés, vous n'avez plus de moyens pour le retrouver. |
| - | * Ensuite, on ouvre un nouveau projet en utilisant le nouveau type de projet que vous avez créé en suivant les indications ci-dessus. C'est-à-dire : File → New → Project → From templates... et vous choisissez le modèles que vous venez de créer pour **gtkmm-3.0**. | + | |
| - | * Une fenêtre de dialogue vous demande alors de choisir le répertoire de travail. Et vous choisissez le répertoire dans lequel se trouve les sources du programme qui vous intéresse. Vous confirmez que vous n'avez pas peur d'écraser les fichiers. En fait, il n'y aura pas d'écrasement de fichier puisque vous n'écrivez alors qu'un fichier un fichier projet **Codeblock** (*.cbp), un fichier XML (*.layout) et un seul fichier source "main.cpp" qui contient tout simplement le code base entré pour créer votre "User Template". Ce fichier ne va pas écraser le fichier initial de programme exemple car celui-ci est dans le fichier "main.cc". | + | |
| - | * Ensuite on peut ajouter à notre projet **Codeblock** les fichier source du programme exemple (*.h et *.cc). Pour ce faire, allez dans Project → Add files recursively... et sélectionnez tous les fichiers sources du programme exemple qui vous sont proposés. | + | |
| - | * Maintenant nous avons deux "main" ! Nous allons garder celui fourni par l'exemple "main.cc" et nous allons supprimer le main par défaut "main.cpp" en allant dans Project → Remove file... | + | |
| - | * Maintenant on peut compiler et c'est là qu'apparaissent les erreurs. Dans tous les fichiers où elle se trouve, il faut remplacer la ligne <code>#include <gtkmm/application.h></code> par <code>#include <gtkmm.h></code> Ensuite, il faut souvent retravailler le fichier "main.cc" en s'inspirant du code du fichier "main.cpp". C'est parfois suffisant pour arriver à faire tourner l'exemple ... | + | |
| + | Voici quelques conseils pour vous aider à récupérer la bonne version du code de ces programmes exemples. Nous supposons que vous avez installé **gtkmm 3.0** à partir du paquet synaptic d'Ubuntu. Notre objectif est donc d'obtenir la version 3.0 des programmes exemples. Ces programmes sont stockés sur le site [[http://git.gnome.org/browse/gtkmm-documentation/tree/examples/book]]. Ce site est un repository git. Il nous faut donc installer git pour y avoir facilement accès. | ||
| + | |||
| + | Il existe de nombreux tutoriels d'introduction à git. En fait ils sont écrit pour des développeurs et sont trop compliqués pour l'utilisation que nous voulons en faire. | ||
| + | Pour l'installation : | ||
| + | <code>$ sudo apt-get install git</code> | ||
| + | devrait être suffisant. | ||
| + | Ensuite il faut se placer dans le répertoire où l'on veut stocker les exemples et cloner le repository git : | ||
| + | <code>~/MonRepertoirePourLesExemples$ git clone http://git.gnome.org/browse/gtkmm-documentation</code> | ||
| + | Par défaut cela nous donne la version de développement ( puisque c'est un outils pour les développeurs ). On peut se renseigner sur les versions disponibles avec la commande : | ||
| + | <code>~/MonRepertoirePourLesExemples$ cd gtkmm-documentation/ | ||
| + | ~/MonRepertoirePourLesExemples/gtkmm-documentation$ git tag</code> | ||
| + | Parmi les lignes de résultat on repère le numéro de version disponible qui nous intéresse, dans notre exemple **3.0.0**. On obtient la version correspondante avec la commande : | ||
| + | <code>~/MonRepertoirePourLesExemples/gtkmm-documentation$ git checkout 3.0.0</code> | ||
| + | Ceci devrait être suffisant pour installer en local la version voulue des programmes exemples. | ||
| + | |||
| + | Une fois les source des programmes exemples récupérés : | ||
| + | * On ouvre un nouveau projet en utilisant le nouveau type de projet que vous avez créé en suivant les indications ci-dessus. C'est-à-dire : File → New → Project → From templates... et vous choisissez le modèle que vous venez de créer pour **gtkmm-3.0**. | ||
| + | * Une fenêtre de dialogue vous demande alors de choisir le répertoire de travail. Et vous choisissez le répertoire dans lequel se trouve les sources du programme qui vous intéresse. Vous confirmez que vous n'avez pas peur d'écraser les fichiers. En fait, il n'y aura pas d'écrasement de fichier puisque vous n'écrivez alors qu'un fichier un fichier projet **Codeblock** (*.cbp), un fichier XML (*.layout) et un seul fichier source "main.cpp" qui contient tout simplement le code base entré pour créer votre "User Template". Ce fichier ne va pas écraser le fichier initial du programme exemple car celui-ci s'intitule "main.cc". | ||
| + | * Ensuite on peut ajouter à notre projet **Codeblock** les fichiers sources du programme exemple (*.h et *.cc). Pour ce faire, allez dans Project → Add files recursively... et sélectionnez tous les fichiers sources du programme exemple qui vous sont proposés. | ||
| + | * Maintenant nous avons deux "main" ! Nous allons garder celui fourni par l'exemple "main.cc" et nous allons supprimer le main par défaut "main.cpp" en allant dans Project → Remove file... | ||
| + | * Maintenant on peut compiler et on espère qu'il n'y a plus d'erreurs ... | ||
| Ligne 75: | Ligne 93: | ||
| ==== Avec CMake ==== | ==== Avec CMake ==== | ||
| [[http://www.cmake.org|Cmake]] est un programme permettant de simplifier la compilation en générant des makefiles. | [[http://www.cmake.org|Cmake]] est un programme permettant de simplifier la compilation en générant des makefiles. | ||
| - | Pour utiliser gtkmm avec cmake, il faut procéder ainsi : | + | Pour utiliser gtkmm avec cmake, il faut procéder ainsi : |
| <code>project(nom_du_projet) | <code>project(nom_du_projet) | ||
| cmake_minimum_required(VERSION 2.6) | cmake_minimum_required(VERSION 2.6) | ||
| find_package(PkgConfig) | find_package(PkgConfig) | ||
| - | pkg_check_modules(GTKMM gtkmm-2.4 ) | + | pkg_check_modules(GTKMM gtkmm-3.0 ) |
| link_directories( | link_directories( | ||
| Ligne 103: | Ligne 121: | ||
| [[http://www.gtkmm.org/documentation.shtml|La documentation officielle (en anglais)]] | [[http://www.gtkmm.org/documentation.shtml|La documentation officielle (en anglais)]] | ||
| - | [[http://www.gtkmm.org/docs/gtkmm-2.4/docs/tutorial/pdf/programming-with-gtkmm.pdf|Le livre en ligne "Programming with gtkmm"]] ([[http://www.gtkmm.org/docs/gtkmm-2.4/docs/tutorial/html/index.html|aussi disponible en html]]) | + | [[http://www.gtkmm.org/docs/gtkmm-3.0/docs/tutorial/pdf/programming-with-gtkmm.pdf|Le livre en ligne "Programming with gtkmm"]] ([[http://www.gtkmm.org/docs/gtkmm-3.0/docs/tutorial/html/index.html|aussi disponible en html]]) |
| [[http://www.siteduzero.com/tutoriel-3-277422-creer-des-interfaces-graphiques-en-c-avec-gtkmm.html#part_277420|Tutoriel en français sur "Le Site du Zéro"]] | [[http://www.siteduzero.com/tutoriel-3-277422-creer-des-interfaces-graphiques-en-c-avec-gtkmm.html#part_277420|Tutoriel en français sur "Le Site du Zéro"]] | ||
| ---- | ---- | ||
| //Contributeurs : [[utilisateurs:geenux|Geenux]], [[utilisateurs:bsaleil|bsaleil]]// | //Contributeurs : [[utilisateurs:geenux|Geenux]], [[utilisateurs:bsaleil|bsaleil]]// | ||