Utilisation de git avec Delphi

Utilisation de git
dans Delphi
Webinaire du 22 décembre 2020

PRÉSENTATEUR
MVP Embarcadero
Prestataire informatique freelance et formateur Delphi
CV et contacts :
https://www.linkedin.com/in/patrickpremartin/
Blog Delphi/Pascal :
https://developpeur-pascal.fr

Outils Embarcadero
Les meilleurs outils de développement multi-
plateformes. Créez une fois et déployez des
applications modernes sur chaque plateforme.
Support Technique
Nos techniciens sont à votre service à tout
moment pour répondre à vos questions et
vous fournir des informations sûres.
Distributeur Officiel
Partenaire exclusif de Embarcadero
Technologies, largement reconnu pour
ses produits de programmation primés.
B A R N S T E N
QUI
Site : https://www.barnsten.com – Contacts FR : equipe@barnsten.com

NOTRE
Société de prestations informatiques.
Edition de sites Internet, logiciels, vidéos et livres.
Centre de formation référencé sur Datadock.
Infos et contacts : https://olfsoftware.fr
Formations en entreprise : https://se-former-a-delphi.fr
Formations en ligne : https://apprendre-delphi.fr
O L F S O F T W A R E

AU
• Introduction
• Notions sur Git
• Installation et configuration de Git
• Travail sur un projet local
• Travail sur un projet distant
• Utilisation avec Github
• Participer à un projet open source
• Conclusion
© Patrick Prémartin / developpeur-pascal.fr

INTROD
Quand on développe seul, la gestion de sources
et de versions n’est pas toujours la priorité.
C’est surtout vrai chez « les anciens » qui
n’avaient pas d’outils dédiés lors de leur
apprentissage de l’informatique et n’en ont pas
ressenti le besoin depuis. Un ZIP ou la copie d’un
dossier suffisent pour les archivages.

INTROD
Elle le devient quand les choses se compliquent :
travail à plusieurs sur le même projet, travail
depuis plusieurs appareils à la fois.
La gestion des ZIP et des copies de fichiers
devient un trop gros casse tête pour éviter les
erreurs.

INTROD
Dans ce cas il est fortement recommandé de
passer par une solution centralisée pour gérer ses
fichiers.
On parle de VCS (version control system) ou de
SCM (source control management).

INTROD
Vous avez probablement déjà entendu parler de
l’un de ces trois là : Subversion (SVN), Mercurial
et Git.
Ils sont pris en charge nativement dans l’IDE de
Delphi et C++Builder.

INTROD
Dans cette session nous allons voir git, à quoi il
sert, comment s’en servir pour des projets
personnels, internes à une organisation mais
aussi tournés pour du partage avec la
communauté de développeurs.

GIT :
Git a été créé par Linus Torvalds en 2005 pour
gérer le noyau de Linux et ses dépendances.
En 10 ans il est devenu le système le plus
populaire dans le milieu open source et
maintenant professionnel.
Plus d’infos sur https://fr.wikipedia.org/wiki/Git

GIT :
Git est un gestionnaire de versions de codes
sources mais pas seulement.
De base il sert à archiver les sources de projets et
pouvoir évoluer dans le temps pour chaque
fichier qu’il prend en charge.

GIT :
Git permet également de gérer des séries de
modifications, les fusionner, les annuler sous la
forme de transactions et de branches.
Interfacé avec un système d’intégration continue
il permet d’automatiser la génération de plusieurs
versions de vos projets quasiment sans
intervention humaine.

GIT :
L’outil se présente sous la forme d’un programme
console classique. Tout se fait en ligne de
commande ou par l’intermédiaire d’une couche
graphique proposée par de nombreux éditeurs.
Pour utiliser git il faut en connaître la philosophie
et les commandes de base.

GIT :
Git travaille par projet.
Un projet correspond à un dossier, son
arborescence descendante et certains fichiers qui
s’y trouvent.
Les dépôts de code ou repository correspondent
à un stockage quelque part de « projets git ».

GIT :
Git n’a pas de distinction entre serveur ou client.
C’est le même programme qui permet de
synchroniser des données dans un dossier local
comme avec un dépôt de code en cloud.
Voici quelques hébergeurs de dépôts de code
connus : GitHub, GitLab, BitBucket, CodeCommit,
Assembla, SourceForge…

GIT :
On peut aussi créer notre propre dépôt de code,
soit avec juste git (un peu de ssh sur une
distribution Linux peut aider), soit en utilisant
l’une des interfaces graphiques proposées par
exemple par GitLab, Gogs, Gitea…

GIT :
Un projet git est composé de branches. Par
défaut on est généralement sur la branche
« master ».
On peut en créer d’autres à partir de n’importe
quelle modification puis les manipuler pour les
fusionner et créer une multitude de versions du
même projet.

GIT :
Le système de branches permet par exemple de
gérer les versions de production, test et
développement d’un logiciel.
On peut ajouter une branche par développeur sur
chacune d’entre elles ou une branche de
correctifs.

GIT :
Les branches peuvent ensuite être regroupées
lors d’une opération de fusion qui permet de
gérer les éventuels conflits (fichiers modifiées au
même endroit et ne contenant pas les mêmes
modifications).

GIT :
Illustration provenant du tutoriel de Atlassian sur
https://www.atlassian.com/fr/git/tutorials/using-
branches

GIT :
Le commit est la base de Git. Comme pour les
bases de données gérant des transactions, c’est
un regroupement de modifications de fichiers
validées et enregistrées « à vie » dans le projet.
Chaque commit a une référence unique et un
commentaire.

GIT :
Les branches sont composées de commit dans
leur ordre de validation.
Les commit sont inaltérables.
Toute opération sur un projet git fait l’objet d’un
commit.

GIT :
Dans un projet git (hors fichiers de git) il existe
trois types de fichiers : ignoré, pas encore pris en
compte, pris en compte.
Les fichiers pris en compte sont soit modifiés
(créé/supprimé/modifié), en attente de validation
ou validés dans la branche en cours.

GIT :
En pratique on a les fichiers sur lesquels on
travaille, dans la branche en cours du projet, et
les fichiers qu’on a regroupés pour le prochain
commit.
Ceux-ci se trouvent dans un groupe appelé
staging area. Le commit suivant validera la staging
area.

GIT :
En plus du commit il existe aussi une zone
tampon dans laquelle on peut faire un équivalent
du commit mais elle est réversible puisque
validée uniquement localement.

GIT :
Git est fiable mais comme pour tout logiciel avec
une base de données on n’est pas à l’abri d’une
anomalie.
Il est fortement recommandé de faire des
sauvegardes de vos dépôts de code / projets dans
les différentes versions qui vous intéressent (par
exemple chaque version publiée de vos logiciels).

GIT :
Tout ce qui se trouve dans un dépôt git est visible
par toutes les personnes ayant un accès à ce
projet.
Il n’y a pas de suppression possible de données !

GIT :
Ne créez jamais de dépôt public en cloud pour
vos projets internes. Créez les en mode privé.
NE STOCKEZ JAMAIS de mots de passes dans vos
sources ou de clés (signature/chiffrement) avec
vos projets : ils seraient visibles sur les dépôts
pour n’importe qui ayant accès un jour dessus.

GIT :
D’une manière générale restez méfiants envers
les plateformes d’hébergement de dépôts de
codes en ligne. Du jour au lendemain elles
peuvent fermer, couper les accès, tomber en
panne, se faire pirater, boguer et publier en
public des projets privés…

GIT :
Soyez conscients des avantages mais aussi des
risques.
Limitez les dépendances autant que possible.
Faites des backups chez vous (et en dehors bien
entendu) !

GIT :
Ne faites pas de commit de fonctionnalités que
vous n’avez pas testées.
Quand vous travaillez à plusieurs ne synchronisez
pas de projet avec des commit non testés pour
éviter que toute l’équipe se trouve avec un
logiciel inutilisable !

GIT :
Pour nous l’installation sous Windows est
suffisante. Il suffit de télécharger et installer
https://gitforwindows.org

GIT :
Une fois installé il faut s’identifier auprès de git
pour « signer » chaque modification. Ces données
sont accessibles à vie pour les personnes ayant
accès au projet.

GIT :
• Enregistrez votre nom et l’adresse email à
laquelle vous contacter. Si vous participez à un
projet public, mettez une adresse avec un bon
antispams et antivirus…
• Enregistrez une clé SSH si vous voulez utiliser
ce protocole pour travailler. Pas pris en charge
par RAD Studio pour le moment mais pratique
pour les saisies en ligne de commande.

GIT :
Installez une surcouche graphique pour vous
simplifier la vie : TortoiseGit, SourceTree,
GitExtensions, …
Si vous travaillez avec Github, il est recommandé
de passer par Github desktop pour simplifier vos
opérations sur les projets associés à votre
compte.

GIT :
Du côté de RAD Studio il suffit de remplir les
informations disponibles dans « Outils / Options /
Contrôle de version / Git »

TRAVAILLER
Pas besoin d’avoir un serveur pour travailler avec
git. Il suffit d’un dossier dans lequel on l’active
pour travailler.
Git n’est pas un logiciel client / serveur.
Il fonctionne de façon autonome, sans réseau,
tant qu’on n’a pas besoin de se synchroniser avec
des projets gérés sur un hébergement ailleurs.

TRAVAILLER
• Créer un dossier ou ouvrir un dossier existant
• Activer git dedans
• Travailler sur les fichiers du dossier
La gestion de versions et de branches est
pleinement fonctionnelle.

TRAVAILLER
Si on travaille à plusieurs ou avec plusieurs
ordinateurs sur les mêmes projets il est
préférable d’avoir un dépôt de code sur un
serveur (sur Internet, un NAS ou un ordinateur du
réseau local).

TRAVAILLER
De base il suffit que git soit installé et accessible
de l’extérieur, par exemple avec ssh.
De nombreux tutoriels existent sur Internet. Pour
la démo j’ai suivi celui-ci sur un serveur VPS chez
OVH équipé d’Ubuntu :
https://linuxize.com/post/how-to-setup-a-git-
server/

TRAVAILLER
Une fois la partie serveur configurée, il suffit d’y
créer un projet sous forme de dépôt de code
distant. Ca génère un fichier d’extension git qui
sert pour les synchronisations.

TRAVAILLER
Le dépôt distant (appelé REMOTE) est la base de
stockage. Tout le travail se fait en local, y compris
la gestion du dépôt distant.

TRAVAILLER
Les commandes à connaître sont :
• CLONE pour créer le projet localement à partir
d’un projet distant (et de son fichier .git)
• PULL (FETCH + MERGE) pour mettre à jour la
branche activée du projet local à partir du
dépôt distant.
• PUSH pour envoyer nos COMMIT (et autres
modifs) sur le dépôt distant.

TRAVAILLER
Notez que les fichiers et modifications non
validées restent en local.
Globalement seules les modifications ayant fait
l’objet d’un COMMIT sont synchronisées.

GITHUB :
GitHub est l’un des nombreux services
d’hébergement de projets. Plutôt orienté open
source GitHub permet aussi de stocker des
projets privés.
En plus de la partie sources, GitHub propose aussi
la gestion de tickets d’incidents, de versions, un
wiki par projet et l’hébergement de sites web.

GITHUB :
GitHub et les autres plateformes équivalentes ont
l’avantage de proposer un peu plus qu’un simple
archivage de projets git en ligne et accessible
partout.
Outre l’utilisation pour nos propres projets on
peut collaborer sur d’autres et avec une
multitude de développeurs.

GITHUB :
Pour nos projets le fonctionnement est le même
que sur un serveur à nous.
Pour collaborer sur d’autres projets il y a
quelques subtilités.

CONTRIBUER
Les projets open sources sont attachés à un
compte unique.
Certains autorisent un accès direct, d’autres
préfèrent par mesure de précaution ne pas laisser
libre accès et fonctionnent par soumission de
groupes de modifications.

CONTRIBUER
Pour les premiers, lorsqu’on fait partie des
développeurs ayant un accès complet, pas de
différence avec le travail habituel. On clone le
projet, on crée une branche de travail et quand
on a fini on intègre nos modifications au projet
global.

CONTRIBUER
Pour les seconds il n’est pas possible de
soumettre directement nos modifications sur le
projet de base. On a deux étapes
supplémentaires.

CONTRIBUER
Comme pour le reste il existe de nombreux
tutoriels en ligne sur le sujet, notamment sur
GitHub et ses pairs.
Vous pouvez vous inspirer de celui-ci :
https://akrabat.com/the-beginners-guide-to-
contributing-to-a-github-project/

GITHUB :
Première étape pour participer à un projet public
: faire un fork.
Ca consiste en une copie du projet d’origine sur
notre compte.
On travaille ensuite sur ce projet comme
n’importe lequel des nôtres.

GITHUB :
Dernière étape de la participation à un projet
open source : la soumission de nos modifications.
Cette opération s’appelle un PULL REQUEST.

GITHUB :
Le PULL REQUEST se fait au niveau de notre
repository, à partir de notre branche de travail
que l’on va pouvoir soumettre pour approbation
à une branche du projet d’origine.
Charge au gestionnaire de ce projet d’accepter ou
refuser notre lot de modifications.

CONCL
Je suis loin d’avoir tout dit sur git et son utilisation
en général.
Vous avez les manipulations de base et pouvez
vous documenter avec les très nombreuses
ressources disponibles en ligne.

CONCL
Même si vous travaillez seul, en local, sur vos
projets, habituez-vous à travailler avec un VCS…
et pensez à faire quand même une sauvegarde de
vos fichiers à chaque fois que vous sortez une
version de vos logiciels, c’est toujours plus sûr
d’avoir une version figée quelque part au cas où.

CONCL
S’il y avait un dernier conseil à vous donner suite
à cette session de présentation ce serait de vous
familiariser avec git ou d’autres outils de gestion
de version.
Tôt ou tard vous en aurez besoin.

PLUS
Pour des ressources complémentaires,
télécharger cette présentation et accéder aux
exemples, rendez-vous sur :
https://developpeur-pascal.fr/p/_400a-
webinaire-du-22-decembre-2020-utilisation-de-
git-dans-delphi.html

(RE)VOIR
La rediffusion de ce webinaire devrait être
disponible sur la chaîne YouTube de Barnsten :
https://www.youtube.com/c/BarnstenFrance/vid
eos
Vous y trouverez également d’autres vidéos dont
une formation complète aux bases de la
programmation avec Delphi en VCL et FMX.

PROCHAINS
La liste des sujets et des dates pour 2021 sera
communiquée courant janvier.
Surveillez vos emails.
Les rediffusions, détails et inscriptions sont aussi
disponibles depuis https://developpeur-
pascal.fr/p/_6007-webinaires.html

LIVRES
Des livres sur le développement avec Delphi
sortent régulièrement. Voici les 3 derniers :
• Delphi GUI programming with FireMonkey
• Delphi Event-based and Asynchronous
Programming
• Object Pascal Handbook (Delphi 10.4 Sydney
Edition)
Liste complète sur https://delphi-books.com/

QUESTIONS

Utilisation de git avec Delphi

Contenu connexe

Tendances (20)

Similaire à Utilisation de git avec Delphi (20)

Plus de pprem (20)

Utilisation de git avec Delphi