Compilation et installation
Ce document explique la manière de construire et d'installer Gambas à partir du code source.
Bien que ce ne soit pas la manière la plus facile pour installer Gambas sur votre système (étant donné que la plupart des distributions fournissent des paquetages Gambas), C'est nécessaire si vous voulez la toute dernière version de Gambas, ou si vous voulez travailler avec la version de développement.
Prérequis
Paquetages de développement
Pour compiler Gambas, vous devez installer les dépendances suivantes et leurs équivalents de "développement".
Le nom réel des paquetages contenant ces dépendances dépend de votre distribution, aussi veuillez vous référer aux pages spécifiques de votre distribution ci-dessous pour plus détails.
|
Composant
|
Prérequis (bibliothèques ou module pkg-config)
|
|---|
|
Compilation
|
gcc g++ automake autoconf libtool >= 2.0
|
|
Interpreter
|
libffi
|
gb.compress.bzlib2
|
libbz2.so
|
gb.compress.zlib
|
libz.so
|
gb.cairo
|
cairo >= 1.6.0 cairo-ft >= 1.6.0
|
gb.crypt
|
libcrypt.so
|
gb.db.mysql
|
libmysqlclient.so, libz.so
|
gb.db.odbc
|
libodbc.so
|
gb.db.postgresql
|
libpq.so
|
gb.db.sqlite2
|
libsqlite.so
|
gb.db.sqlite3
|
libsqlite3.so
|
gb.dbus
|
dbus-1
|
gb.desktop
|
libXtst.so
|
gb.desktop.gnome
|
gnome-keyring-1
|
gb.gmp
|
libgmp.so
|
gb.gsl
|
libgsl.so libgslcblas.so
|
gb.gtk
|
gtk+-2.0 >= 2.16 cairo >= 1.6.0 cairo-ft >= 1.6.0
gtk+-unix-print-2.0 >= 2.10
librsvg-2.0 >= 2.14.3
|
gb.gtk.opengl
|
gtkglext-1.0
|
gb.image.io
|
gdk-pixbuf
|
gb.image.imlib
|
imlib
|
gb.libxml
|
libxml-2.0
|
gb.media
|
gstreamer-0.10 >= 0.10.31 gstreamer-interfaces-0.10 >= 0.10.31 for Gambas <= 3.4
gstreamer-1.0 gstreamer-video-1.0 for Gambas >= 3.5
|
gb.mime
|
gmime-2.4 or gmime-2.6
|
gb.ncurses
|
ncurses.so panel.so
|
gb.net.curl
|
libcurl >= 7.13
|
gb.opengl gb.opengl.glsl
|
libGL.so libGLEW.so
|
gb.opengl.glu
|
libGLU.so
|
gb.openssl
|
openssl
|
gb.pcre
|
libpcre.so
|
gb.pdf
|
poppler >= 0.5
|
gb.qt4 gb.qt4.ext gb.qt4.opengl gb.qt4.webkit
|
All Qt4 libraries >= Qt 4.5
|
gb.qt5
|
Qt5Core >= 5.3.0 Qt5Gui Qt5Widgets Qt5Svg Qt5PrintSupport Qt5X11Extras
|
gb.qt5.opengl
|
Qt5Core >= 5.3.0 Qt5Gui Qt5Widgets Qt5OpenGL
Note: Qt5OpenGL is not needed if your Qt version is >= 5.4.0
|
gb.qt5.webkit
|
Qt5Core >= 5.3.0 Qt5Gui Qt5Widgets Qt5Network Qt5Xml Qt5WebKit
Qt5WebKitWidgets Qt5PrintSupport
|
gb.sdl
|
libSDL.so libSDL_ttf.so libGL.so libGLEW.so
|
gb.sdl2
|
libSDL2-2.0.so libSDL2_ttf-2.0 libGL.so libGLEW.so
|
gb.sdl.sound
|
libSDL.so libSDL_mixer.so
|
gb.sdl2.sound
|
libSDL2-2.0.so libSDL2_mixer-2.0.so
|
gb.v4l
|
libjpeg.so libpng.so Video4Linux >= 2.0
|
gb.xml.xslt
|
libxml-2.0 libxslt
|
Autres prérequis
Vous devez avoir le droit d'écrire dans le répertoire
/tmp, sinon Gambas ne fonctionnera pas.
Les versions suivantes de GNU tools sont nécessaires :
-
automake 1.11.1
-
autoconf 2.68
-
libtool 2.4
Compiler avec des versions plus anciennes peut ne pas fonctionner !
Téléchargement des sources
Il y a deux manières d'obtenir les sources de Gambas : télécharger l'archive tar de la version, ou la récupérer du répertoire
git.
Téléchargement de l'archive tar de la version
L'archive tar pour la toute dernière version peut être téléchargée directement depuis
le site web,
dans la section
Download.
Téléchargement depuis git
Le téléchargement des sources depuis git est nécessaire si vous voulez utiliser la version de développement. Vous aurez aussi besoin d'installer
git pour lancer les commandes suivantes. Pour plus d'informations sur l'utilisation du dépôt Gambas de Gitlab, consultez le
guide de développement de git pour Gambas
Lancez la commande suivante pour récupérer la dernière révision de la version de développement dans un nouveau répertoire
gambas :
git clone --depth=1 https://gitlab.com/gambas/gambas.git
L'argument
--depth=1 fait que
git ne télécharge que la dernière version. Si vous l'oubliez, il va télécharger tout l'historique
des changements faits au code source, ce qui est inutile si vous ne prévoyez pas de contribuer à Gambas.
Par conséquent, c'est mieux pour la plupart des utilisateurs de laisser cette option activée, et elle réduira la taille la taille du téléchargement, ainsi que
l'usage du disque.
Une fois terminé, un répertoire
gambas sera créé, contenant le code source.
Pour rechercher et télécharger les mises à jour, entrez dans le répertoire
gambas, et lancez la commande suivante :
Les sources seront alors mises à jour, et vous devrez redémarrer la procédure de compilation et d'installation pour
appliquer les changements à votre système.
Comment compiler et installer Gambas 3
Configuration du paquetage Source
Quand vous serez certain que tout est téléchargé, entrez les phrases magiques suivantes dans une console.
'$' représente votre invite de console, et '...' sont les messages affichés pendant la configuration et la compilation.
Entrez d’abord le dossier supérieur du code source :
$ cd <chemin/du/répertoire/source/ >
Puis, tapez ceci pour créer les scripts de configuration :
Puis ceci pour analyser le système en cours et configurer le paquetage :
S’il manque une bibliothèque ou un paquet de développement, vous serez averti que certains composants sont désactivés.
Il y a des explications complémentaires spécifiques à 'configure' dans le fichier INSTALL situé au sommet de l’arborescence du code source.
Je vous invite à les lire.
Compilation
Si tout est configuré sans erreur, lancez alors cette commande pour compiler le programme :
Installation
Si tout se compile sans erreur, lancez enfin cette commande pour tout installer :
Vous devez être root (administrateur) pour installer Gambas sur votre système.
$ su -c "make install"
Password: <Entrez ici le mot de passe root>
...
ou
$ sudo make install
Password: <Entrez ici votre mot de passe>
...
Dépannage
Si vous faites plusieurs compilations successives, après avoir mis à jour les sources à partir du dépôt par exemple, et si quelque chose échoue pendant tout ce processus, vous pouvez tenter de "reconfigurer" les scripts de configuration en entrant la commande suivante :
Puis vous pouvez exécuter à nouveau
./configure -C
Si cela ne fonctionne pas, il me faut savoir exactement ce qui est arrivé.
Pour cela, tapez la commande suivante :
$ ( ./configure -C; make; make install ) > output.txt 2>&1
Et transmettez-moi le fichier "output.txt" par mail, ainsi que tout autre détail qui vous paraît utile concernant votre machine et votre distribution.
Instructions pour des distributions spécifiques
L'environnement de développement
L'interface graphique de Gambas est écrit en Gambas. Pour le compiler et l'utiliser, vous avez besoin de compiler les composants suivants :