diff --git a/source/images/git/gl_diff_view.png b/source/images/git/gl_diff_view.png new file mode 100644 index 0000000000000000000000000000000000000000..846d5567b09b7b4e493b16555387e84c4c46ffb4 Binary files /dev/null and b/source/images/git/gl_diff_view.png differ diff --git a/source/images/git/gl_gk_usage.png b/source/images/git/gl_gk_usage.png new file mode 100644 index 0000000000000000000000000000000000000000..adc32a8069ff13a589d9bcd2a2824c4c2e7cb39f Binary files /dev/null and b/source/images/git/gl_gk_usage.png differ diff --git a/source/images/git/gl_preview.png b/source/images/git/gl_preview.png new file mode 100644 index 0000000000000000000000000000000000000000..3ff0be0b6e2ec6e6d15632c602efe4184ab915bf Binary files /dev/null and b/source/images/git/gl_preview.png differ diff --git a/source/images/git/gl_repo_manager.png b/source/images/git/gl_repo_manager.png new file mode 100644 index 0000000000000000000000000000000000000000..5d90da1d65403722f37105eb64a6a18b708eff45 Binary files /dev/null and b/source/images/git/gl_repo_manager.png differ diff --git a/source/images/git/gl_sc_use.jpg b/source/images/git/gl_sc_use.jpg new file mode 100644 index 0000000000000000000000000000000000000000..2d4ce114f63d3feef434a1f5f5517e7543fb5753 Binary files /dev/null and b/source/images/git/gl_sc_use.jpg differ diff --git a/source/tools/git/outils.md b/source/tools/git/outils.md index f9bdd1265b5f173748bc551c232ca28ff7fed9ce..0d72d07c3ed06530819a0a51c1355633e6c0629b 100644 --- a/source/tools/git/outils.md +++ b/source/tools/git/outils.md @@ -176,7 +176,7 @@ Gitlab permet de suivre et tracer les bugs/évolutions via un système d'issue, Gitlab intégre également une interface d'édition des fichiers directement sur l'interface Web, avec des fonctionnalités très basiques. -## GitKraken +## GitKraken (Déprécié) Veremes a choisi d'utiliser Gitkraken comme outil graphique pour gérer Git sur nos postes. GitKraken est un outil très puissant, qui s'adapte aux habitudes de chacun et aux pratiques de l'entreprise. @@ -268,6 +268,70 @@ Le workspace présente plusieurs avantages : Le fait d'avoir un workspace par application permet de basculer rapidement d'une application à une autre. Le seul manque à mon sens, est l'intégration avec Gitlab que l'on a avec des workspaces de type Cloud, ce serait vraiment top. +## VSCode et Gitlens + +Veremes a choisi d'utiliser Gitlens comme outil graphique pour gérer Git sur nos postes de développeur. +Gitlens est un outil très puissant, qui s'adapte aux habitudes de chacun et aux pratiques de l'entreprise. +Il est intégrable à VSCode en tant qu'extension et vient surcoucher les fonctionnalité native de l'IDE. + +La documentation de GitLens est disponible via [ce lien](https://marketplace.visualstudio.com/items?itemName=eamodio.gitlens) + +### Installation + +Il faut l'ajouter via le gestionnaire d'extension de VSCode + + + +### Organisation du workspace VSCode + +Ouvrir le dépot principal dans VSCode. + +Il faut ensuite aller dans `File > Add folder to workspace` et ajouter chacun des dépots présent dans le dossier `src`. + +Une fois les dépots ajoutés au workspace, ils sont alors disponibles dans la section `source control` de VSCode + + + + +```{Tip} + Si un fichier code-workspace est présent dans le dépot vous pouvez simplement cliquer dessus et tout ce travail de création du workspace sera fait pour vous. +``` + +### Interface de base de VSCode et Gitlens + +Imaginons que je réalise un développement sur vmap qui impact l'application et vitis, je crée mes branches, ... + +J'ouvre mon Workspace VSCode et je veux passer sur les branches de développement. Je vais sur la section `source control` et je vais pouvoir controler tous mes dépots en même temps. + + + + + +Une fois que j'ai réalisé mes modifications je peux voir l'état de chaque dépot + +Je peux cliquer sur un pour visualiser les différence entre mes modification et le HEAD de la branche en cours : + + + +Si je veux stage mes modification je peux soit stage bloc par bloc dans le composant de diff, soit directement cliquer sur le vouton `+` sur le fichier dans le gestionnaire de dépot pour stage tout mon fichier. + +Ensuite dans le gestionnaire de dépots je peux écrire un commentaire et créer mon commit puis le push. + +Avec GitLens on peut aussi ouvrir le dépot dans un composant tiers (équivalent à celui de GitKraken) qui donne beaucoup plus d'informations : + + + +sur cet interface il est possible de : +- Changer de dépot sélectionné +- Changer de branche +- fetch, pull, push, merge, cherry pick, rebase, ... +- Voir les modifications apportés par un commit en particulier +- Ouvrir directement le dépot sur Gitlab + +En comparaison avec GitKraken, je n'arrive plus à : +- Comparer deux commit spécifiques +- Faire un interactive rebase + ## Autres outils graphiques pour Git Je ne rentre pas dans le détail de ces outils car leurs utilisations actuellement sont très ponctuelles, mais ce sont des alternatives à GitKraken en cas de manques de licences ou si on a besoin d'un outil plus simple à utiliser. @@ -275,5 +339,4 @@ Je ne rentre pas dans le détail de ces outils car leurs utilisations actuelleme - [SourceTree](https://www.sourcetreeapp.com/) : Très similaire à GitKraken, il a moins d'intégration avec Gitlab car développé par Atlassian, le propriétaire de BitBucket - [Github Desktop](https://desktop.github.com/) : Beaucoup plus simpliste, ça fera largement l'affaire pour un utilisateur qui utilise Git rarement ou qui ne fait que des actions très simples (pull, push, commit), pour corriger/écrire de la documentation. -- [Tortoise Git](https://tortoisegit.org/) : Pour les anciens cramponnés à SVN ou pour avoir un gestionnaire ultra-léger. -- [Git Lens](https://www.gitkraken.com/gitlens) : également développer par Axosoft, c'ets un outil complémentaire à Gitkraken, qui peut le remplacer sur des usages très simplistes, directement dans Visual Studio Code. \ No newline at end of file +- [Tortoise Git](https://tortoisegit.org/) : Pour les anciens cramponnés à SVN ou pour avoir un gestionnaire ultra-léger. \ No newline at end of file