Ottenere il codice sorgente di MariaDB

Le istruzioni presenti in questa pagina illustrano come scaricare un branch locale del repository del codice sorgente di MariaDB, con la cronologia delle revisioni completa. Se si desidera ottenere un tarball dei sorgenti senza la cronologia delle revisioni, si veda la pagina dei download di MariaDB.

Se si desidera semplicemente vedere il codice sorgente, si può farlo su https://code.launchpad.net/maria.

Fare il checkout dei sorgenti con Bazaar

Prerequisiti

Occorre Bazaar per il controllo di versione.

Istruzioni

1. Si prepari una directory che conterrà il codice di MariaDB in:

   mkdir $repo # dove $repo è una directory (es: ~/repos)
   cd $repo
   bzr init-repo maria # crea ~/repos/maria
   

2. Ottenere una copia locale del repo Maria:

   cd $repo/maria # (es: ~/repos/maria)
   bzr branch lp:maria trunk
   

   Il comando sopra serve a ottenere una copia locale dell'ultima versione stabile di MariaDB. Se si vuole ottenere un'altra release si usi lp:maria/5.2, lp:maria/5.3... Per un elenco completo, si veda Launchpad e si scelga 'Code' dal menu che si trova in alto nella pagina.
   • Nota: L'operazione di branch iniziale potrebbe durare molto, questo dipende dalla velocità della connessione a internet e dal carico di lavoro su Launchpad. In questo primo branch si scaricano più di 600 MB di dati.
3. Se si riscontra un errore come:

   bzr: ERROR: Unknown repository format: 'Bazaar RepositoryFormatKnitPack6 (bzr 1.9)'
   

   significa che la versione di bzr che si sta usando è troppo vecchia. Si usi la versione 1.12 o superiore per evitare questo errore.
4. Se si ha aggiornato bzr e non si riesce a eseguire il branch da Launchpad, si provi a usare il tarball dei sorgenti.
5. La cronologia aggiornata si trova in:

   cd $maria-repo/trunk
   bzr log | less
   

6. Se si ha intenzione di modificare i sorgenti di MariaDB, si veda la pagina Contributing Code.
7. Se si desidera soltanto compilare MariaDB, si veda la pagina Compiling MariaDB.

Il tarball dei sorgenti

Per coloro che non riescono a creare un branch di MariaDB da Launchpad è stato creato un tarball di un repository completo.

Prerequisiti

Occorre Bazaar per lavorare sul repository.

Using the Source Tree Tarball

1. Si scarichi il file mariadb-shared-repo.tgz da uno dei mirrori di MariaDB.
   • Il file è di 292MB, perciò il download potrebbe durare a lungo, questo dipende dalla velocità della connessione.
2. Il file .tgz contiene una directory .bzr. La directory superiore di .bzr è (o diventa) un repository condiviso che contiene i sorgenti di MariaDB. Si raccomanda di creare una nuova directory per questo repository; ecco come fare. Si assegni a questa directory un nome a piacere ("maria", "mariadb", "my", "src", etc...).Una volta creata, ci si porti in essa (cd) e si esegua un untar del file. Ecco un esempio in cui la nuova directory si chiama "mariadb" e si trova in una directory "src" nella home directory dell'utente corrente, mentre il file mariadb-shared-repo.tgz di trova in una directory Downloads (anch'essa nella home directory):

   mariadbdir="mariadb"
   downloadsdir="${HOME}/Downloads"
   sourcecodedir="${HOME}/src"
   cd ${sourcecodedir}
   mkdir ${mariadbdir}
   cd ${mariadbdir}
   tar -zxvf ${downloadsdir}/mariadb-shared-repo.tgz
   

3. Dopo aver eseguito l'untar si ha un repository condiviso bzr, ma non un albero funzionante. Nella directory del repository, si usi il comando bzr branch per ottenere un branch degli alberi di MariaDB ai quali si è interessati. Per esempio:
   • bzr branch lp:maria/5.2
   • bzr branch lp:maria
4. Grazie al repository, entrambi i comandi si eseguiranno molto velocemente.
5. Prima di lavorare con il codice, ci si assicuri di avere l'ultima versione del codice sorgente:

   cd mariadb-5.2 # o come si chiama la directory
   bzr pull
   

6. A questo punto si può utilizzare l'albero dei sorgenti come se si avesse creato un branch direttamente da launchpad.