Si vous connaissez l'exercice :

Dépaqueter les archives du code source avec

en remplaçant 2.26 par le numéro de version actuel. Cette commande créera le dossier gwyddion-2.26 (là encore avec le numéro de version actuel en lieu et place de 2.26), cd vers ce dossier. Toutes les autres étapes de la compilation se dérouleront à cet endroit.

Si votre système d'exploitation ne possède pas bzip2 vous pouvez télécharger gwyddion-2.26.tar.gz (compressé avec gzip) à la place et dépaqueter avec

Cependant, les systèmes Unix ou basés sur Unix récents possèdent à la fois bzip2 et gzip, étant donnée sa taille plus petite, gwyddion-2.26.tar.xz devrait être logiquement préféré.

Lancez

pour configurer Gwyddion.

Le script configure tente de déterminer les valeurs correctes de diverses variables du système utilisées lors de la compilation. Il utilise ces valeurs pour créer un Makefile dans chaque répertoire du paquet, quelques fichiers d'en-tête .h contenant des définition propres au système ainsi que quelques fichiers auxiliaires. Il crée finalement un script config.status que vous pourrez lancer pour recréer la configuration actuelle, et un fichier config.log. Ce fichier contient les détails du processus de détection, qu'il est utile d'include dans les rapports de bug liés à la compilation. configure affiche finalement un résumé des fonctionnalités optionnelles activées ou désactivées, en précisant les raisons pour lesquelles certaines fonctionnalités ont été désactivées.

Si configure annonce que certains paquets nécessaires manquent, installez les et re-lancer le. Cela s'applique aussi dans le cas où configure termine correctement mais vous vous rendez compte qu'il manque un paquet optionnel avec lequel vous souhaitez compiler Gwyddion. Il est possible qu'un paquet ne soit mal ou pas détecté du tout bien que vous l'ayez installé, typiquement si celui est installé dans un répertoire non standard. Il est nécessaire dans ce cas de modifier certaines variables d'environnement afin que configure soit capable de trouver ces paquets :

L'option --prefix de configure règle le répertoire de base de l'installation. Les composants du logiciels seront installés dans les sous-répertoires bin, lib, share, etc. (ils seront créés s'ils n'existent pas). Un contrôle plus fin est possible en utilisant des options spécifiant des sous-répertoires particuliers tels que --bindir, --libdir. Le préfixe par défaut est /usr/local/bin, pour installer Gwyddion dans votre répertoire home vous pouvez par exemple utiliser

Si vous installez Gwyddion pour une utilisation personnelle, nous vous recommandons d'utiliser un répertoire d'installation similaire, car dans ce cas aucune étape ne nécessitera des droits root.

Des fonctionnalités optionnelles peuvent être activées/désactivées avec des options telles que --with-foo/--without-foo ou --enable-foo/--disable-foo. La compilation avec FFTW3 peut par exemple être désactivée avec :

Toutes les fonctionnalitées optionnelles sont activées par défaut si les pre-requis sont présents. Un résumé des fonctionnalités activées et désactivées sont affichées vers la fin de la sortie de configure.

La liste complète des options de configure et des variables importantes peut être obtenues avec :

Certaines actions auxiliaires de l'installation peuvent être désactivées dans configure : la mise à jour des fichiers Freedesktop peut être désactivée avec --disable-desktop-file-update. L'installation des schémas GConf2 peut être désactivée avec --disable-schemas-install. Cependant, la raison habituelle pour désactiver ces actions est l'installation de Gwyddion dans un répertoire temporaire au lieu du répertoire final (c'est souvent le cas lors de la compilation de paquets Linux). Dans ce cas ces actions auxiliaires sont automatiquement déastivées par un DESTDIR non vide (voir installation) et n'ont donc pas à être désactivées dans configure.

Si vous souhaiter créer un patch ou modifier d'une manière ou d'une autre le code source de Gwyddion, passez l'option --enable-maintainer-mode à configure pour activer diverses mises à jour et recompiler les règles non utilisées dans la compilation de base. En fonction de la nature des modifications, certains des outils supplémentaires décrits dans la section Subversion, Développement peuvent être nécessaires.

Lancez

et attendez jusqu'à ce que Gwyddion soit compilé. Si configure s'est terminé sans erreur alors la compilation devrait se dérouler sans problème.

S'il vous faut faire des choses inhabituelles pour compiler le paquet, essayez de déterminer comment configure permettrait de régler le problème, et envoyer par e-mail des correctifs ou des instructions à l'adresse de rapport de bug, de manière à ce qu'ils soient pris en compte pour la version suivante.

Gwyddion doit être installé pour pouvoir être lancé, il est impossible de le faire tourner s'il n'est pas installé.

Lancez

pour installer Gwyddion dans le dossier ciblé. Si vous installez Gwyddion dans un dossier système, vous devez avoir les privilèges root pour lancer cette commande, en utilisant par exemple sudo :

Pour installer Gwyddion dans un répertoire temporaire, pour créer un paquet par exemple, modifiez la variable make DESTDIR avec un préfixe qui sera utilisé pour tous les répertoires cibles :

Ne modifiez pas les variables des dossiers individuels telles que bindir, libdir.

Si vous n'installez pas dans un dossier système, par exemple avec l'installation dans un sous-dossier ou votre dossier home, il vous faudra peut être ajuster les variables suivantes durant l'installation :

Il se peut que la variable XDG_DATA_DIRS doive être modifiée après l'installation pour obtenir une intégration complète dans le bureau.

Si vous installez Gwyddion dans /usr/local et obtenez le message comme quoi libgwyapp.so.0 ne peut être trouvé, il y a de fortes chances que votre système ne possède pas certains répertoires de librairies standards dans la configuration de l'éditeur de liens dynamiques. Cela arrive par exmple sous Ubuntu. Editez le fichier /etc/ld.so.conf et ajoutez-y la ligne suivante :

/usr/local/lib

.

Le lancement de Gwyddion ne nécessite normalement pas de réglage supplémentaire.

Toutefois, les fonctionnalités de certains environnements de bureau peuvent rendre inutilisable Gwyddion et celles-ci doivent être désactivées. Le détournement du menu principal des programmes dans Unity rend inaccessible la plupart des menus de Gwyddion. Cela peut être désactivé en modifiant UBUNTU_MENUPROXY pour le lancement de Gwyddion :

Lancez

dans le dossier où Gwyddion a été compilé afin de le supprimer. Dans le cas où vous auriez perdu le répertoire original, vous pouvez essayer d'extraire les fichiers de compilation, configurer et compiler de la même manière que lors de l'installation puis lancer make uninstall, mais le succès de cette opération dépend de votre capacité à reproduire le processus de compilation.

Il est possible de compiler des paquets RPM sur les distributions GNU/Linux basées sur RPM directement à partir des archives du code source grâce à la commande

, où 2.26 doit être remplacé par le numéro de version actuel. Cette méthode a été testée sur Fedora, openSuSE et Mandriva, et le fichier de spécifications RPM contient certaines informations pour ces systèmes. Un support spécifique à d'autres systèmes basés sur RPM peut être ajouté sur demande.