{{tag>Bionic Xenial programmation launchpad}}

----
{{ :bazaar_explorer_lucid_00.png|Logo de Bazaar explorer}}
====== Bazaar Explorer ======
<note important>Les captures sont à actualiser.</note>

bzr-explorer est l'[[:bzr#utilisation_d_une_interface_graphique|interface graphique de Bazaar]] par défaut qui remplace l'interface précédente : bzr-gtk.

===== Pré-requis =====

  * Disposer des [[:sudo|droits d'administration]].
  * Disposer d'une connexion à Internet configurée et activée.

===== Installation =====
<note>bzr-explorer n'est plus disponible dans les dépôts depuis [[Focal]]((https://packages.ubuntu.com/search?suite=default&section=all&arch=any&searchon=names&keywords=bzr-explorer))</note>
Il suffit donc d'[[:tutoriel:comment_installer_un_paquet|installez le paquet]] **[[apt://bzr-explorer|bzr-explorer]]**.

===== Utilisation =====
Bazaar explorer se présente sous trois principales vues différentes.

  * Accueil
  * Dépôt
  * Status

Au premier démarrage, la vue accueil vous propose ces options:

{{  bazaar_explorer_lucid_01.png?600x452  }}

==== Configuration de l'utilisateur ====

{{  bazaar_explorer_lucid_02.png  }}

Les données //nom// et //adresse mail// sont importantes lors de l'usage d'un logiciel de suivi de version. Ces paramètres constituent votre identifiant sur Launchpad.

Ils sont l'équivalent de la commande:
<code>
bzr whoami "Your Name <email@example.com>"
</code>

==== Préférences: ====

{{  bazaar_explorer_lucid_03.png  }}

Ces paramètres n'impactent que sur l'interface seule et peuvent différer selon votre distribution, [[http://doc.bazaar.canonical.com/explorer/en/visual-tour-gnome.html|Gnome]] [en],
[[http://doc.bazaar.canonical.com/explorer/en/visual-tour-kde.html|KDE]] [en].

Dans l'onglet //Applications//, les options de style de dialogues Gtk ne sont disponibles que si le plug-in [[apt://bzr-gtk|bzr-gtk]] est [[:tutoriel:comment_installer_un_paquet|installé]].

==== Récupérer un projet: ====
{{  bazaar_explorer_lucid_04.png?600x452  }}

Vous pouvez récupérer un projet existant (checkout), les deux approches de travail possibles, en local ou miroir, sont expliquées dans la fenêtre principale.
    
==== Créer un nouveau projet: ====
{{  bazaar_explorer_lucid_05.png  }}

  * **Colocated branches** :\\ Crée un arbre de travail à l'emplacement pointant sur un tronc dans un répertoire partagé.

  * **Feature branches** :\\ Créer un répertoire partagé et crée une branche tronc dans ce répertoire.

  * **Plain branch** :\\ Crée une branche  à l'emplacement. Si créée dans un répertoire partagé,les révisions seront situées dans celui-ci. Sinon, les révisions seront placées dans la branche.

  * **Shared repository** :\\ Crée un répertoire à l'emplacement. Les branches créées sous ce répertoire l'utiliseront pour situer leurs révisions.

Pour les projets de petite ou moyenne taille, //Feature branches// est recommandé, les projets
de taille importante choisiront //Colocated branches//.

{{  bazaar_explorer_lucid_06.png}}

Notez que ces deux dernières actions, **<< Récupérer un projet >>** et **<< Créer un projet >>**, se retrouvent dans le menu **//Bazaar -> Démarrer >//**


==== Ouvrir un projet: ====

Nous partons du principe que votre projet est situé en local, donc sur votre disque dur.
C'est sur cet emplacement que vous effectuerez la totalité du travail de mise à jour, ajout, suppression, commit, etc, la mise à jour de la branche située sur Launchpad se résumera à "pousser" (push) votre travail terminé.

Cette façon de travailler dite "décentralisée", vous permet de disposer de votre projet à jour en permanence et de ne pas être tributaire d'une connexion internet capricieuse, entre autres avantages.

{{bazaar_explorer_lucid_07.png}}

Sélectionnez votre projet.

{{bazaar_explorer_lucid_08.png}}

Bazaar explorer vérifie si des changements sont intervenus dans le projet depuis la dernière révision et nous présente, comme sur cette capture, ces différences.

Dans le cas de nouveaux éléments ajoutés au projet, nous serons d'abord invité à versionnés ceux-ci, cliquez sur le signe plus dans le texte (Add)

Équivalent:
<code>
bzr add --no-recurse "projet ..."
</code>

Ensuite, il nous faudra soumettre ces changements comme nouvelle révision, ce que nous allons faire en cliquant sur la flèche située en fin  de texte.

{{bazaar_explorer_lucid_09.png}}

Saisissez le texte et cliquez OK.

Équivalent:
<code>
bzr commit -m "texte ..."
</code>

A ce stade, nous avons mis à jour notre projet, mais uniquement sur notre dépôt local. Il faut donc appliquer ces modifications au dépôt Launchpad.

{{bazaar_explorer_lucid_10.png}}

Cliquez sur ajouter.

{{bazaar_explorer_lucid_11.png}}

Cliquez OK.

Équivalent:
<code>
bzr push --no-strict 
</code>

Nous pouvons, maintenant, nous rendre sur la page du projet sur Lauchpad pour vérifier nos changements.

Bazaar Explorer dispose d'un grand nombre d'outils supplémentaires sous forme de plug-in, voir le lien ci-dessous.

===== Désinstallation =====

Pour supprimer cette application, il suffit de [[:tutoriel:comment_supprimer_un_paquet|supprimer son paquet]]. Selon la méthode choisie, le configuration globale de l'application est conservée ou supprimée. Les journaux du système, et les fichiers de préférence des utilisateurs dans leurs dossiers personnels sont toujours conservés.


===== Liens =====
  * **(en)** [[http://doc.bazaar.canonical.com/explorer/en/|Page d'accueil]]
  * **(en)** [[https://launchpad.net/bzr-explorer| Projet Bazaar explorer sur Launchpad]]
  * **(en)** [[http://doc.bazaar.canonical.com/explorer/en/tutorials/customization.html|Personnaliser explorer]]
  * **(en)**  [[http://www.proven-corporation.com/software/bzr-notification/|Obtenir notification des changements]]
  * **(fr)** [[http://bazaar-vcs.org/fr/IntroductionABzr|Introduction à Bazaar]]

----
//Contributeurs principaux : [[utilisateurs:VinsS]]

Mise en forme : [[:utilisateurs:draco31.fr]]