Configurer son environnement de travail

Guide minimal pour la configuration de Git, GitHub et de votre IDE
Pourquoi ce guide ?
  • Ce petit guide vous aidera à configurer votre environnement de travail pour le projet associé au cours. Il est à réaliser avant votre première séance.
  • Assurez-vous de suivre toutes les étapes dans l’ordre jusqu’au bout.
Où taper les commandes ?

Sur certaines partie, vous allez devoir taper des commandes. Toutes les commandes indiquées dans ce guide doivent être tapées dans un terminal (sous macOS et Linux) ou dans Git Bash sous Windows).

1 Installation de Git

1.1 macOS

Option A : Xcode Command Line Tools (Recommandé)

xcode-select --install

Option B : Homebrew

brew install git

Vérification :

git --version
# Devrait afficher : git version 2.x.x

1.2 Linux (Ubuntu/Debian)

sudo apt update
sudo apt install git

Vérification :

git --version

1.3 Windows

  1. Télécharger : https://git-scm.com/download/win
  2. Installer avec les options par défaut
  3. Ouvrir Git Bash (installé avec Git)

Vérification : (dans Git Bash)

git --version

2 Configuration initiale de Git

Configurez votre identité (une seule fois) :

# Votre nom (sera visible sur GitHub)
git config --global user.name "Prénom Nom"

# Votre email (utilisez celui de votre compte GitHub)
git config --global user.email "votre.email@example.com"

Vérification :

git config --global user.name
git config --global user.email

3 Création d’un Compte GitHub (si vous n’en avez pas)

  1. Aller sur https://github.com/signup
  2. Entrer votre email (votre email étudiant est recommandé)
  3. Créer un mot de passe fort
  4. Choisir un nom d’utilisateur (ex: jean-dupont)
  5. Valider l’email

4 Configuration de l’Authentification (Token)

Pourquoi un token ?

Depuis 2021, GitHub n’accepte plus les mots de passe pour les opérations Git.

Un Personal Access Token (PAT) remplace le mot de passe.

  1. Se connecter sur GitHub : https://github.com

  2. Accéder aux paramètres :

    • Cliquer sur votre photo de profil (en haut à droite)
    • Settings
  3. Aller dans Developer settings :

    • Descendre tout en bas de la barre latérale
    • Cliquer sur Developer settings
  4. Créer un nouveau token :

    • Cliquer sur Personal access tokensTokens (classic)
    • Cliquer sur Generate new tokenGenerate new token (classic)
  5. Configurer le token :

    • Note : Nommez-le par exemple “git token”
    • Expiration : Choisissez “No expiration” (Ce n’est pas recommandé, mais cela va éviter les interruptions pour notre usage)
    • Select scopes :
      • Cocher repo (Full control of private repositories)
      • Cocher delete_repo (Delete repositories) – plus bas
    • Cliquer sur Generate token (en bas)
  6. IMPORTANT : Copier le token : GitHub va alors générer et afficher un token comme ceci ghp_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx. Sauvegardez-le immédiatement dans un fichier texte ! Vous ne pourrez jamais le revoir après avoir quitté la page.

Quand utiliser le Token ?

Ce token sera utilisé à la place de votre mot de passe GitHub, quand git vous demandera vos identifiants :


Username for 'https://github.com': votre-username
Password for 'https://votre-username@github.com': [COLLEZ VOTRE TOKEN ICI]

Le token sera sauvegardé automatiquement par Git. Vous n’aurez à le saisir qu’une seule fois !

5 Ajouter les excecutables gcc et cmake au PATH (sous Windows)

Afin de terminer la configuration de votre environnement de développement sous Windows, il est nécessaire d’ajouter les exécutables du compilateur C et de CMake au PATH système. Normalement, vous avez du les installer lors de l’installation de CLion.

5.1 Trouver les chemins d’installation

  1. Ouvrez CLion.
  2. Allez dans FileSettingsBuild, Execution, DeploymentToolchains.
  3. Notez les chemins des champs C Compiler et CMake.
Les chemins doivent ressembler à quelque chose comme :
  • C Compiler : C:\Program Files\JetBrains\CLion 20XX.X.X\bin\mingw\bin
  • CMake : C:\Program Files\JetBrains\CLion 20XX.X.X\bin\cmake\win\x64\bin

5.2 Ajouter au PATH

  1. Ouvrez le menu Démarrer et cherchez “Variables d’environnement”.
  2. Cliquez sur “Modifier les variables d’environnement système”.
  3. Dans la fenêtre “Propriétés système”, cliquez sur “Variables d’environnement…”.
  4. Dans la section “Variables système”, sélectionnez la variable Path et cliquez sur “Modifier…”.
  5. Cliquez sur “Nouveau” et ajoutez les chemins notés précédemment (un par un).
  6. Cliquez sur “OK” pour fermer toutes les fenêtres.

5.3 Vérification finale

  1. Redémarrez CLion puis sur la barre latérale, ouvrez le terminal intégré.
  2. Appuyez sur le petit bouton “v” à côté du “+” pour ouvrir un menu déroulant puis sélectionnez “Git Bash”.
  3. Tapez les commandes suivantes pour vérifier que gcc et cmake sont accessibles :
gcc --version
cmake --version