Compilación e instalación

Este documento explica como compilar e instalar Gambas desde el código fuente.

Si bien esta no es la forma más fácil de instalar Gambas en su sistema (ya que la mayoría de las distribuciones proporcionan paquetes de Gambas), es necesaria si desea instalar la última versión de Gambas, si desea trabajar con la versión de desarrollo o si necesita hacer algo de depuración.

Requerimientos

Paquetes de desarrollo

Para compilar Gambas debe instalar los siguientes paquetes de desarrollo.

El nombre actual de estos paquetes depende de su distribución, diríjase a las páginas especificas de cada una para mas detalles.

Componentes Requerimientos (librerías o módulos pkg-config)
Compilation gcc g++ automake autoconf libtool >= 2.0
Interpreter libffi
gb.compress.bzlib2 libbz2.so
gb.compress.zlib libz.so
gb.compress.zstd libzstd.so >= 1.3.3
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.x11 libXtst.so x11
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.gtk3 gtk+-3.0 >= 3.4 cairo >= 1.6.0 cairo-ft >= 1.6.0 gtk+-unix-print-2.0 >= 3.4 librsvg-2.0 >= 2.14.3
gb.gtk3.wayland gtk+-3.0 >= 3.4 gdk-wayland-3.0
gb.gtk3.webview gtk+-3.0 >= 3.4 webkit2gtk-4.0 >= 2.20
gb.gtk3.x11 gtk+-3.0 >= 3.4 gdk-x11-3.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 para Gambas <= 3.4

gstreamer-1.0 gstreamer-video-1.0 para Gambas >= 3.5
gb.mime gmime-2.6 or gmime-3.0
gb.ncurses ncurses.so panel.so
gb.net.curl libcurl >= 7.13
gb.openal openal >= 1.13 alure
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.poppler poppler >= 0.20 poppler-cpp poppler-glib
gb.qt4 QtCore >= 4.5.0 QtGui QtSvg x11
gb.qt4.ext QtCore >= 4.5.0 QtGui Qt3Support x11
gb.qt4.opengl QtCore >= 4.5.0 QtGui QtOpenGL x11 gl
gb.qt4.webkit QtCore >= 4.5.0 QtGui QtNetwork QtDBus QtXml QtWebKit >= 4.5.0
gb.qt4.webview QtCore >= 4.5.0 QtGui QtNetwork QtDBus QtXml QtWebKit >= 4.5.0
gb.qt5 Qt5Core >= 5.3.0 Qt5Gui Qt5Widgets Qt5Svg Qt5PrintSupport
gb.qt5.ext Qt5Core >= 5.3.0 Qt5Gui Qt5Widgets x11
gb.qt5.opengl Qt5Core >= 5.3.0 Qt5Gui Qt5Widgets Qt5OpenGL gl x11

Nota: Qt5OpenGL no es necesario si tu versión de QT es >= 5.4.0
gb.qt5.wayland Qt5Core >= 5.3.0 Qt5Gui Qt5Widgets
gb.qt5.webkit Qt5Core >= 5.3.0 Qt5Gui Qt5Widgets Qt5Network Qt5Xml Qt5WebKit Qt5WebKitWidgets Qt5PrintSupport
gb.qt5.webview Qt5Core >= 5.5.0 Qt5WebEngineWidgets
gb.qt5.x11 Qt5Core >= 5.3.0 Qt5Gui Qt5Widgets Qt5X11Extras x11-xcb
gb.sdl libSDL.so libSDL_ttf.so libGL.so libGLEW.so
gb.sdl.sound libSDL.so libSDL_mixer.so
gb.sdl2 libSDL2-2.0.so libSDL2_image-2.0 libSDL2_ttf-2.0 libGL.so libGLEW.so
gb.sdl2.audio 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

Otros requerimientos

Debe tener acceso de escritura a /tmp, de otra forma Gambas no funcionará.

Se necesitan las siguientes herramientas de GNU:
  • automake 1.11.1

  • autoconf 2.68

  • libtool 2.4

Compilar con versiones anteriores puede no funcionar.

Descargar el código fuente

Hay dos formas de obtener el código fuente de Gambas: descargando el archivo tar, o desde el repositorio git

Descargar el archivo tar

El archivo tar de la última versión se puede descargar directamente desde el sitio web, en la sección Descargar.

Descargar desde git

Es necesario descargar las fuentes de git si desea utilizar la versión de desarrollo. También necesitarás instalar git para utilizar los siguientes comandos.

Escriba el siguiente comando para recibir la última revisión de la versión de desarrollo en un nuevo directorio gambas: 

$ git clone --depth=1 https://gitlab.com/gambas/gambas.git

el argumento --depth=1 hace que git solo descargue la +ultima versión, si lo omites, se descargará el histórico completo de cambios hechos en el código fuente, lo que es innecesario si no tiene planeado contribuir con el desarrollo de Gambas.

Por lo tanto, es mejor para la mayoría de los usuarios dejar activada esta opción, ya que reducirá el tamaño de la descarga, así como el uso del disco.

Una vez completado, se creará un directorio gambas que contiene el código fuente.

Para buscar y descargar actualizaciones, ingrese al directorio gambas y use el siguiente comando: 

$ git pull

Se actualizará el código fuente y tendrá que reiniciciar el proceso de compilación e instalación para aplicar los últimos cambios.

Como compilar e instalar Gambas 3

Configuración del archivo de código fuente

Cuando este seguro de que todo ha sido descargado, ingrese las siguientes sentencias en una linea de comando.

'$' representa una linea de comando, y '...' son los mensajes impresos durante la configuración e instalación..

Primero, ingrese al directorio principal del archivo fuente. 

$ cd &lt;path/to/source/directory&gt;

Luego, ejecute el siguiente comando para crear los archivos de configuración: 

$ ./reconf-all

Luego, ejecute el siguiente comando para analizar el sistema y configurar la instalación de Gambas 

$ ./configure -C
...

Si una librería o un paquete de desarrollo están ausentes, sera advertido de los componentes que fueron deshabilitados.

There are more 'configure' specific explanations in the INSTALL file located in the top-level source directory. I invite you to read them.

Compilación

Si todo es configurado sin errores, ejecute el siguiente comando para iniciar la compilación: 

$ make
...

Instalación

Si todo es compilado sin errores, ejecute el siguiente comando para iniciar la instalación:

Debe ser root para instalar Gambas en su sistema. 

$ su -c "make install"
Contraseña: <Ingrese su contraseña root aquí>
...

or 

$ sudo make install
Contraseña: <Ingrese su contraseña root aquí>
...

Resolución de problemas

Si ha realizado varias compilaciones sucesivas, luego de actualizar el árbol de trabajo desde Subversion, por ejemplo, y ocurre algún error durante este proceso, puede intentar "reconfigurar" los archivos de configuración ejecutando el siguiente comando. 

$ ./reconf-all

Luego puede ejecutar ./configure -C nuevamente

Si esto no funciona, necesito saber exactamente que ocurrió. Para eso, ejecute el siguiente comando: 

$ ( ./configure -C; make; make install ) > output.txt 2>&1

Y envíeme el archivo "output.txt" por correo electrónico, junto con otros datos acerca de su computadora y distribución que puedan parecer útiles.

Instrucciones especificas para cada distribución

A
 Arch Linux
D
 Debian
M
 Mandriva 2007 / 2008 / 2009
U
 Ubuntu

El ambiente de desarrollo

La IDE de Gambas fue escrita en Gambas. Para poder compilarla y usarla, debe instalar los siguientes componentes:

Compilando desde las fuentes de desarrollo

A principios de agosto de 2017, el trabajo comenzó a trasladar el repositorio de fuentes Gambas de SourceForge a GitLab y después de rev 8175 el repositorio de Subversion se hizo de sólo lectura.

El repositorio git de fuentes Gambas está en https://gitlab.com/gambas/gambas

  • El primer gambas es el nombre del grupo de usuarios de GitLab.

  • El segundo gambas es el nombre del proyecto.

Compilando desde repositorio Gitlab

(Esta sección es de interés para los usuarios que desean pasar al repositorio de Git ahora!)

Para compilar las últimas versiones de desarrollo de Gambas del repositorio git, consulte la página Como manejar Git y Gitlab. (De hecho todas las versiones desde la 1.9.44 pueden ser "Obtenidas" del repositorio de GitLab.)

Compilando desde repositorio Subversion

(Esta sección es de interés para los usuarios que permanecen con SVN por el momento).

Para compilar versiones de Gambas desde el repositorio de subversión, es decir, las versiones <= rev 8175, incluido el release 3.10.0 Consulte la página Como usar Subversion.