Documentazione di Gambas

Attenzione! Questa pagina non è aggiornata. Vedi versione in inglese

LEGGIMI

Benvenuti in Gambas!

Gambas è una implementazione libera di un ambiente grafico di sviluppo basato su un interprete BASIC. È molto ispirato a Visual Basic e Java.

Più informazioni su http://gambas.sourceforge.net

Note importanti

Prima di scaricare Gambas, compilarlo e poi lamentarsi, per favore leggi ATTENTAMENTE le seguenti note!

Per compilare Gambas, hai bisogno delle seguenti librerie sul tuo sistema:

Gambas 1.0.x (versione stabile)

Componenti	Librerie
`gb.compress.bzlib2`	`libbz2.so`
`gb.compress.zlib`	`libz.so`
`gb.db.mysql`	`libmysqlclient.so` `libz.so`
`gb.db.postgresql`	`libpq.so`
`gb.db.sqlite`	`libsqlite.so`
`gb.net.curl`	`libcurl.so`
`gb.qt`	`libqt-mt.so.3`
`gb.qt.kde`	All KDE libraries
`gb.sdl`	`libSDL.so` `libSDL_mixer.so`
`gb.xml.libxml`	`libxml-2.0`
`gb.xml.libxml.xslt`	`libxslt`

Gambas 1.9.x (versione in sviluppo)

Componenti	Librerie
`gb.compress.bzlib2`	`libbz2.so`
`gb.compress.zlib`	`libz.so`
`gb.corba`	`libACE.so` `libomniORB4.so` `libomniDynamic4.so`
`gb.crypt`	`libcrypt.so`
`gb.db.firebird`	`libibpp.so` `libfbclient.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.gtk`	All GTK+ libraries
`gb.ldap`	`libldap.so`
`gb.net.curl`	`libcurl.so`
`gb.opengl`	`libGL.so` `libGLU.so`
`gb.pcre`	`libpcre.so`
`gb.pdf`	`libpoppler.so`
`gb.qt`	`libqt-mt.so.3`
`gb.qt.kde`	All KDE libraries
`gb.sdl`	`libSDL.so` `libSDL_image.so` `libSDL_gfx.so` `libSDL_ttf.so` `libGL.so` `libGLU.so`
`gb.sdl.sound`	`libSDL.so` `libSDL_mixer.so`
`gb.v4l`	`libjpeg.so` `libpng.so` Video4Linux >= 2.0
`gb.xml`	`libxml-2.0`
`gb.xml.xslt`	`libxslt`

E non dimenticare di installare tutto i relativi pacchetti di sviluppo!

Cerca sempre ad usare una versione recente di queste librerie.

Devi compilare i componenti gb.qt e gb.qt.ext per avere un ambiente di sviluppo funzionante.

Qt 3.2 è richiesto a causa di una funzione Qt che era assente in versioni precedenti di Qt. Gambas compilerà ugualmente con Qt 3.1, ma la funzione Picture.Copy() potrà non funzionare in alcuni casi. Gambas non compila correttamente con versioni precedenti di Qt.

Devi inoltre avere i permessi di scrittura su /tmp, altrimenti Gambas non funzionerà.

Questo pacchetto è stato creato con le seguenti versioni dei tools GNU:

automake 1.9.4
autoconf 2.59
libtool 1.5.12 (questo tool non è richiesto, in quanto è incluso nel pacchetto)

Ogni sottodirectory di questo pacchetto sorgente è indipendente. Puoi configurare, compilare ed installare ognuna di esse indipendentemente.

Come compilare ed installare Gambas?

Controlla l'installazione

Prima di tutto, controlla di avere tutte le librerie necessarie, in particolare tutti i pacchetti di sviluppo.

Configurazione sorgenti

Quando sei sicuro che tutto sia installato, scrivi le seguenti righe magiche in una shell.

'#' rappresenta il prompt della shell, e '...' sono i messaggi stampati durante la configurazione e la compilazione.

Questo comando analizza il sistema e configura il pacchetto:

# ./configure -C
...

Se una libreria o un pacchetto di sviluppo risulta mancante, allora sarai avvisato che alcuni componenti sono disabilitati. Devi leggere tutto l'output di ./configure per trovare le linee che cominciano con "warning" per capire cosa manca.

Esistono spiegazioni più specifiche di 'configure' nel file INSTALL. Vi invito a leggerle.

Compilazione

Se tutto viene configurato senza errori, il prossimo passo sarà la compilazione del programma con questo comando:

# make
...

Installazione

Se tutto viene compilato senza errori, si può procedere con l'installazione utilizzando questo comando:

Devi essere root per installare Gambas sul tuo sistema.

# su -c "make install"
Password: 
...

Risoluzione dei problemi

Se hai provato diverse compilazioni in successione, e qualcosa fallisce durante questo processo, puoi provare ad eseguire questo comando prima di eseguire nuovamente ./configure:

# ./reconf

Se non funziona, ho bisogno di sapere cosa è successo esattamente. Per fare ciò, digita il seguente comando:

# ( ./configure; make; make install ) > output.txt 2>&1

E mandami il file "output.txt" via email, con ogni possibile altro dettaglio riguardo il tuo computer e la tua distribuzione, se reputi che possa essere utile.

Eseguire Gambas

Se tutto è andato bene, digita "gambas2" per eseguire l'ambiente di sviluppo.

Buon divertimento!