On vous a peut-être demandé de « cloner le dépôt et de le compiler », mais vous ne savez pas par où commencer ? Cet article vous guidera pas à pas pour faire fonctionner un programme GitHub sous Linux, même si vous n’avez aucune expérience préalable.
Les instructions qui constituent un programme informatique sont rédigées, modifiées et sauvegardées dans des fichiers texte. Un programme spécifique, appelé compilateur, analyse ensuite ces fichiers pour générer la version exécutable du programme. Ces fichiers texte contenant les instructions sont désignés sous le nom de code source. La version du programme qui peut être exécutée sur un ordinateur est appelée binaire ou exécutable.
Il s’agit d’une simplification, mais elle donne une idée générale du processus. Dans la pratique, vous rencontrerez des variations. Parfois, d’autres programmes créent les fichiers texte. Dans d’autres cas, le code source s’exécute directement dans un interpréteur et n’a pas besoin d’être compilé. etc.
Néanmoins, un principe universel s’applique à tous les projets logiciels : les fichiers de code source sont d’une importance capitale et nécessitent une protection particulière.
Outils de gestion des versions
L’ensemble des fichiers de code source d’un projet est appelé la base de code. Les projets de grande envergure impliquent souvent plusieurs développeurs travaillant sur la même base de code. Chaque modification du code doit être suivie, identifiable et réversible si nécessaire. Si différents développeurs modifient simultanément un même fichier source, leurs modifications doivent être fusionnées.
Il est donc naturel que des logiciels appelés systèmes de gestion de versions existent pour faciliter la gestion des modifications de la base de code. Ces systèmes conservent toutes les versions antérieures de chaque fichier, en enregistrant chaque changement, avec un commentaire et un suivi.
Git, un outil indispensable
Linus Torvalds, le créateur du noyau Linux, a conçu un outil de gestion de versions appelé Git afin de gérer le code source du noyau Linux. Cet outil est aujourd’hui le plus utilisé au monde pour le contrôle de version. Des millions de personnes l’utilisent quotidiennement.
Avec Git, la base de code d’un projet est stockée dans des dépôts (ou référentiels). En plus des dépôts locaux, situés sur les ordinateurs des développeurs, et potentiellement sur un serveur central, il est fortement recommandé de disposer d’un dépôt distant.
C’est là que GitHub entre en jeu.
GitHub, la plateforme de référence
GitHub a vu le jour suite au succès de Git. Ses fondateurs ont compris le besoin d’héberger des dépôts Git distants de manière sécurisée. Ils ont ainsi créé une entreprise offrant une plateforme cloud aux équipes de développement. En avril 2019, GitHub hébergeait plus de 100 millions de dépôts.
Si une application est un projet open-source, il y a de fortes chances qu’elle soit hébergée sur GitHub. Bien qu’il existe d’autres plateformes comme BitBucket et GitLab, GitHub domine le marché des dépôts open source.
Anatomie d’un dépôt
Un dépôt GitHub est un ensemble de dossiers contenant des fichiers, notamment les fichiers de code source les plus importants. En général, on y trouve d’autres types de fichiers : documentation, pages de manuel, licences logicielles, instructions de compilation et scripts shell. Il n’y a pas de règle stricte concernant le contenu d’un dépôt, mais des conventions sont généralement respectées.
De la même façon que vous pouvez vous orienter dans n’importe quelle cuisine si vous en connaissez le principe, il en va de même avec les dépôts. Une fois les conventions comprises, vous savez où chercher ce dont vous avez besoin.
Voyons comment obtenir une copie d’un dépôt sur votre ordinateur et comment compiler un programme en exécutable binaire.
Le fichier README
Il est courant d’inclure un fichier README dans un dépôt. Son nom peut être README, readme ou Readme, avec ou sans l’extension « .md ».
Prenons l’exemple du dépôt GitHub de l’éditeur Atom. Vous verrez une longue liste de dossiers et de fichiers. En descendant, vous trouverez le contenu du fichier README.md.
GitHub affiche automatiquement le contenu du fichier README sur la page d’accueil du dépôt. Si ce fichier a l’extension « .md », il sera écrit en langage Markdown, ce qui permet d’utiliser des éléments de mise en forme, comme les polices, les listes à puces et les images.
En règle générale, un fichier README comporte des sections expliquant le projet, le type de licence, les personnes en charge du projet, comment y participer, et comment compiler et exécuter l’application.
S’il ne contient pas les instructions de compilation détaillées, il vous indiquera où les trouver. Vous y trouverez aussi des informations utiles pour la compilation, comme les outils nécessaires et les dépendances, soit directement, soit via un lien.
Le dépôt des boîtes
Notre objectif est de cloner le dépôt des boîtes, puis de compiler l’application « boîtes ».
Ce dépôt suit la même structure que celui d’Atom : une liste de dossiers et de fichiers, suivie du contenu du fichier README. Il suit la mise en page standard, mais étant un projet plus petit, il comporte moins de dossiers et de fichiers.
Le fichier README est aussi plus concis. Il comprend une section « Développement » contenant un lien « Construire à partir de la source ». En suivant ce lien, nous devrions trouver les informations nécessaires.
Il faut souvent explorer un peu le dépôt pour trouver les informations utiles, mais ce n’est pas insurmontable. Lisez attentivement tout ce qui est affiché sur la page du dépôt. Parfois, les informations sont présentes, mais pas immédiatement visibles.
Les dépendances
La page « Construire à partir des sources » contient une section « Construire sous Linux », ce qui correspond à notre besoin. Elle indique que nous devons avoir installé un compilateur C, Bison, et Flex.
Les instructions de compilation mentionnent également la commande « make », nous aurons donc besoin de cet outil aussi.
En résumé, les outils nécessaires à la compilation de cette application sont un compilateur C, Bison, Flex, make et Git (pour cloner le dépôt sur votre machine).
Cet article a été testé sur des ordinateurs utilisant les distributions Linux Ubuntu, Fedora et Manjaro. Aucune de ces distributions n’avait tous les outils nécessaires installés par défaut ; il a donc fallu installer certains outils sur chaque distribution.
Installation des outils nécessaires
Sur Ubuntu, il a fallu installer Git, Flex, Bison et make. Voici les commandes à utiliser:
sudo apt-get install git
sudo apt-get install flex
sudo apt-get install bison
sudo apt-get install make
Sur Fedora, il a fallu installer Flex, Bison et make. Voici les commandes à utiliser:
sudo dnf install flex
sudo dnf install bison
sudo dnf install make
Sur Manjaro, il a fallu installer le compilateur GCC, Flex et Bison. Voici les commandes:
sudo pacman -Syu gcc
sudo pacman -Syu flex
sudo pacman -Syu bison
Cloner le dépôt
Chaque dépôt GitHub a une adresse Web spécifique, utilisée avec Git pour cloner le dépôt sur votre ordinateur. Sur la page principale du dépôt « boîtes », vous verrez un bouton vert intitulé « Cloner ou télécharger ».
Cliquez sur ce bouton pour voir l’adresse Web. C’est cette adresse que nous devons utiliser avec la commande git pour cloner le dépôt.
Rendez-vous dans le répertoire où vous voulez cloner le dépôt, puis tapez cette commande. Si votre terminal le permet, vous pouvez copier-coller l’adresse Web dans la commande. Pour coller dans un terminal GNOME, utilisez Ctrl + Maj + V.
<img decoding="async" loading="lazy" class="alignnone wp-image-429129 size-full" src="https://toptips.fr/wp-content/uploads/2020/12/1609456841_776_Comment-installer-des-logiciels-a-laide-de-Git-sous-Linux.png" alt="" git="" clone="" https:="" in="" a="" terminal="" window.="" width="646" height="