Installation

Installation sous Windows

1. Téléchargez et installez: CMake https://cmake.org/
- - Download \(->\) Windows x64 Installer (cmake-x.x.x-windows-x86_64.msi)
- - Activez l'option "Add CMake to the system PATH" in the setup lors de l'installation.

- CMake est un outil de génération de projet qui permettra de configurer vos code C++ de manière portable.
- Patientez jusqu'à la fin de l'installation avant de passer à la suite.

Téléchargez et installez également Visual Studio Code/VSCode si vous ne l'avez pas déjà.

- VSCode est un outil d'étition de texte et code.

2. Installez Visual Studio Community Edition
- Lors de l'installation, sélectionnez le module "Desktop development with C++".

- Le logiciel est propriétaire à Microsoft et peut nécessiter la création d'un compte sur leur site, mais est gratuit.
- Ne confondez pas Visual Studio Code/VSCode (IDE multiplateforme sans compilateur), et Microsoft Visual Studio Community Edition (IDE dédié pour Windows avec compilateur C++).
- Notez que le téléchargement et l'installation peuvent être long. Vous devrez redémarrer votre ordinateur après l'installation.

3. Dans le répertoire où vous avez placé les codes des séances, lancez le script situé dans 00_test_installation/scripts/visual-studio-generate.bat.
- - A l'issue de l'execution, un fichier 00_test_installation/00_test_installation.sln devrait être créé. Ouvrez celui-ci avec Visual Studio afin d'accéder au code compilable.
- - Vous pouvez accéder au code depuis la fenêtre "Solution Explorer". La compilation et l'exécution se réalisent via le bouton "Local Windows Debugger" (icône "Play" en haut).

- - Le script de génération utilise CMake pour créer un projet Visual Studio (fichier .sln) adapté au code.
- - Si vous ajoutez de nouveaux fichiers C++ au code, il sera nécessaire de relancer ce script afin que Visual Studio prenne en compte les nouveaux fichiers.
- - Si vous rencontrez des erreurs lors de l'execution du script de compilation, vérifiez que votre code est bien positionné dans un répertoire sans accents ni espaces.

Installation sous Mac

1. Installez, si vous ne les avez pas déjà, les outils suivants:
- VS Code https://code.visualstudio.com/

- VSCode est un outil d'étition de code.

- - HomeBrew https://brew.sh/

- brew est un gestionnaire de paquets pour MacOS.

2. Dans un terminal, tappez les commandes suivantes

# CMake tool to compile
brew install cmake

# Install pkg-config - tool helping to find library for compilation
brew install pkg-config

# Install ninja - a compilation chain tool
brew install ninja

# Install glfw - the window handler used as external library
brew install glfw

Rem. En cas de besoin: Aide pour l'utilisation d'un terminal sous Mac/Linux

3. Ouvrez un terminal et placez-vous dans le répertoire où vous avez placé les codes des séances csc43043ep-lab-code/. Vous pouvez tester la compilation en tapant les commandes suivantes:

cd 00_test_installation
mkdir build
cd build
cmake ..
make

Si la compilation s'est bien déroulée, un exécutable project devrait être créé dans le répertoire build/. Vous pouvez lancer celui-ci en tapant:

./project

4. L'édition du code peut se réaliser en ouvrant le fichier vscode.code-workspace avec VS Code situé dans le répertoire racine des codes des séances. Choisissez la configuration "RelWithDebInfo" pour compiler avec les options de debug.

Debug

Si GLFW n'est pas trouvé, il est possible d'utiliser la version précompilée fournie avec le code.

- Ouvrez le 'CMakeLists.txt' et modifiez la ligne suivante:

option(MACOS_GLFW_PRECOMPILED "Use precompiled library for GLFW on MacOS" OFF)

option(MACOS_GLFW_PRECOMPILED "Use precompiled library for GLFW on MacOS" ON)

- Ouvez Finder dans le répertoire suivant: 00_test_installation/cgp/third_party/glfw/macos/lib/
- Ouvrez le fichier libglfw.3.dylib (click droit, ou CTRL+Click), choisissez Open
- Réalisez une nouvelle compilation du code.

Installation sous Linux/Ubuntu

1. Installez, si vous ne les avez pas déjà:
- VS Code https://code.visualstudio.com/

- VSCode est un outil d'étition de code.

2. Installez les outils nécessaires en tapant la commande suivante dans un terminal:

# Make sure that your apt deposit is updated [optional]
sudo apt-get update

# Basic development tools (g++, make, etc)
sudo apt-get install build-essential pkg-config

# Install CMake tool
sudo apt-get install cmake 

# Install GLFW library
sudo apt-get install libglfw3-dev

Rem. En cas de besoin: Aide pour l'utilisation d'un terminal sous Mac/Linux

3. Ouvrez un terminal et placez-vous dans le répertoire où vous avez placé les codes des séances csc43043ep-lab-code/. Vous pouvez tester la compilation en tapant les commandes suivantes:

cd 00_test_installation
mkdir build
cd build
cmake ..
make

4. L'édition du code peut se réaliser en ouvrant le fichier vscode.code-workspace avec VS Code situé dans le répertoire racine des codes des séances. Choisissez la configuration "RelWithDebInfo" pour compiler avec les options de debug.

Aide aditionnelle détaillée

En cas de problème, une version détaillée des installations possibles est disponible ici https://imagecomputing.net/cgp/compilation (certains chemins du code peuvent différer).