Outils pour utilisateurs

Outils du site


docs:dev:recuperation_sources

Récupération du dépôt git de grisbi

Avant de commencer

Avertissement

En aucun cas il ne faut travailler sur votre fichier de compte original (celui que vous utilisez habituellement) avec les versions de développement qui peuvent le corrompre. Attention particulièrement à la fonction d'enregistrement automatique de Grisbi.

Le plus simple est de copier votre fichier de compte sous un nouveau nom et de le charger à la première utilisation de la version de développement de Grisbi. Si Grisbi a chargé automatiquement votre fichier, fermez le en utilisant me menu “Fichier → Fermer”

S'inscrire sur la liste de développement

Pour s'inscrire sur la liste de développement vous devez remplir le formulaire et cliquer sur le bouton Subscrire.

Signaler un bug

Vous devez ouvrir un compte sur le bugtracker afin d'être ajouté au groupe testing. Vous aurez ainsi la possibilité de déclarer les bugs que vous avez trouvé et faire des demandes d'évolution.

Tester grisbi

Dans une console, lancez Grisbi avec la commande suivante :

$ export DEBUG_GRISBI=5 && grisbi

Si vous avez plusieurs versions de grisbi installées vérifiez que vous testez la bonne version. Si ce n'est pas le cas remplacez grisbi dans la commande ci dessus avec la commande de lancement qui se trouve dans la partie compilation.

Exemple :

$ export DEBUG_GRISBI=5 && /usr/local/bin grisbi

En cas de plantage recopiez les 10 lignes qui se trouvent au dessus du message du crash et mettez les dans le le bugtracker en même temps que la description du bug.

Participer au développement

Pour pouvoir envoyer vos modifications, il est nécessaire d'ouvrir un compte sur sourceforge et que l'on vous ajoute dans l'équipe de grisbi. L'accès anonyme au dépôt git ne suffira pas.

Aide

Il existe un canal IRC pour Grisbi. Vous y trouverez sûrement de l'aide mais soyez patient si on ne vous répond pas tout de suite :-)

salon : #grisbi serveur : irc.freenode.net

Pour accéder à IRC avec pidgin mais c'est facilement transposable avec un autre client IRC :

Récupération du dépôt git

Il est conseillé de créer un répertoire spécifique dans son home pour y mettre les sources des programmes. Dans notre exemple il s'agit de : ~/Bureau/devel

Dans une console, tapez:

$ cd Bureau/devel

puis sur une seule ligne

$ git clone git://git.code.sf.net/p/grisbi/code grisbi

Connaître la branche de travail

Dans une console, tapez :

$ git branch

vous obtiendrez :

  • master

Changer pour la branche grisbi-1.0.x

Dans une console, tapez :

$ git checkout grisbi-1.0.x

Si c'est la première fois vous obtiendrez :

Branch grisbi-1.0.x set up to track remote branch grisbi-1.0.x from origin.
Switched to a new branch 'grisbi-1.0.x'

Sinon :

Switched to branch 'grisbi-1.0.x'

Pour revenir à la branche master :

git checkout master

Mise à jour du dépôt git

Pour avoir la dernière version de développement il faut mettre régulièrement à jour votre dépôt. Aller dans le répertoire des sources ici ~/Bureau/devel/grisbi.

Dans une console, tapez :

$ make clean && make distclean

ce qui va nettoyer les sources

puis faire un :

$ git pull --rebase

: il vous faudra bien évidement refaire les commandes suivantes avec vos options habituelles afin de compiler la nouvelle version !

$ ./autogen.sh
$ ./configure [vos_options]
$ make
$ make install

Avant de compiler

Un certain nombre de bibliothèques sont nécessaires pour compiler Grisbi avec toutes ses fonctionnalités.

: Les bibliothèques ci-dessous sont pour la branche grisbi1.0.x. La branche master nécessite gtk3 et les bibliothèques associées.

  • en base : glib2-devel, gtk2-devel, gettext, libtool, intltool
  • en option : libxml2-devel, openssl-devel, libofx-devel. Pour avoir les graphiques avec la version 0.9.5 : libgofficexx-devel

Le nom peut changer en fonction de votre distribution et on peut avoir “lib64…..” pour les versions 64 bits.

Pour Ubuntu et Debian :

  • en base : libglib2.0-dev, libgtk2.0-dev, gettext, libtool, intltool
  • en option : libxml2-dev, libssl-dev, libofx-dev ; libgoffice-xx-dev pour avoir les graphiques avec la version 0.9.5.

Pour Archlinux:

  • les bibliothèques de développement sont incluses dans les bibliothèques standard, donc il vous suffit d'avoir installé glib2, gtk2, openssl et libofx.

Compilation de Grisbi

Il faut d'abord choisir la branche que l'on veut compiler :

  • grisbi-1.0.x est la branche de la future version 1.0.0
  • master est la branche de développement

: Il est déconseillé de compiler et d'utiliser la branche master qui n'est pas stable. A réserver aux spécialistes

Voilà… il ne reste plus qu'à compiler en tapant les commandes suivantes :

: Nous partons du principe que l'utilisateur est ici gilles et que vous êtes dans ~/Bureau/devel

$ cd grisbi
$ ./autogen.sh

Une fois cela fait, nous allons indiquer un chemin pour installer tout le nécessaire et le mettre dans un répertoire dédié ici dans le répertoire utilisateur :

$ ./configure --prefix=/home/gilles/Bureau/devel/grisbi-compil/

Ensuite, il reste juste à terminer avec les commandes traditionnelles :

$ make
$ make install

Une fois la compilation terminée, il vous suffira de lancer la version compilée de Grisbi via le chemin suivant dans une console :

$ ~/Bureau/devel/grisbi-compil/bin/grisbi

Installation standard de Grisbi

Si vous souhaitez installer une version de Grisbi utilisable par plusieurs utilisateurs vous devez saisir les commandes suivantes dans une console :

Saisir dans le terminal :

$ cd grisbi
$ ./autogen.sh
$ ./configure
$ make

et suivant votre distribution :

Mandriva, fedora ….

$ su
[mot de passe administrateur]
# make install

Ubuntu

sudo make install
[mot de passe utilisateur]

L'installation se fera par défaut dans /usr/local/ et le binaire de Grisbi sera :

/usr/local/bin/grisbi

Normalement vous devriez trouver un menu pour accéder directement à Grisbi dans un des sous-menus du menu Applications

docs/dev/recuperation_sources.txt · Dernière modification: 2013/04/08 19:38 par pbiava