Configuration d'un environnement de développement - vaul-ulaval/vaul-wiki GitHub Wiki
Objectif
Les outils utilisés sur les robots, notamment le Robot Operating System (ROS) et le simulateur F1TENTH, sont basés sur le système d'exploitation Linux. Afin de garantir le fonctionnement de ces outils sur votre machine, nous vous avons préparé un tutoriel vous permettant d'avoir un environnement de développement fonctionnel sans avoir à installer ROS ainsi que le simulateur sur votre machine.
Sur MacOS et Linux, passez directement à l'étape 2
1. Installation de WSL2 (Windows 10/11 seulement)
Cette étape va vous permettre d'utiliser Linux directement à partir de Windows. En effet, Windows Subsystem for Linux (WSL) est un environnement Linux intégré à Windows, ce qui permet aux deux systèmes d'exploitation de cohabiter et d'éviter de devoir constamment redémarrer pour changer entre les deux.
Voici les étapes à suivre:
- Faites toutes les mises à jour dans Windows Update.
- Activez la fonctionnalité WSL:
- Ouvrir
Panneau de configuration
>Programmes
>Activer ou désactiver des fonctionnalités Windows
- Cocher
Sous-système Windows pour Linux
etVirtual Machine Platform
- Redémarrer votre ordinateur
- Ouvrir
- Ouvrir le Microsoft Store
- Chercher
WSL
et installerWindows Subsystem for Linux
- Chercher
Ubuntu
et installerUbuntu 20.04
- Chercher
Terminal
et installerWindows Terminal
- Chercher
- Démarrer
Ubuntu 20.04
et choisir un nom d'utilisateur et un mot de passe
:spiral_notepad: Note
- En cas d'erreur suite à l'installation de WSL2, veuillez vous référer à la page suivante.
- Des ressources supplémentaires de configuration sont également disponibles ici.
2. Configuration de l'environnement de développement
Cette étape va vous permettre d'avoir un environnement de développement complet dans un conteneur Docker
à même vscode
.
2.1 Installation de Visual Studio Code (vscode)
La première étape consiste à installer vscode
sur votre machine.
Pour ce faire, suivez le lien suivant et installer la version qui correspond à votre système.
https://code.visualstudio.com/#alt-downloads
2.2 Installation de Docker
La deuxième étape consiste à installer Docker
sur votre machine.
Pour ce faire, utilisez le lien correspondant à votre système.
- Install Docker Engine on Ubuntu
- Suivi par Linux post-installation steps for Docker Engine (Faire seulement les deux premières sections)
- Install Docker Desktop on Mac
- Install Docker Desktop on Windows
:spiral_notepad: Note
- Assurez-vous d'avoir les exigences système avant l'installation.
vscode
2.3 Installation des extensions dans À partir de l'onglet Extensions
de vscode
, installez les extensions suivantes:
Docker
Dev Containers
2.4 Configuration d'une clé SSH Github
Pour contribuer sur des dépôts Github depuis votre ordinateur, vous devez maintenant avoir configuré une clé SSH. Suivez les sections suivantes :
Installation de Foxglove Studio
On utilise Foxglove Studio pour visualiser ce qui se passe sur le robot. Pour l'installer, suivez le lien suivant : https://foxglove.dev/download
Prochaines étapes
Voilà! Vous êtes maintenant prêt à la prochaine étape et installer le simulateur F1TENTH! :tada:
Par ici -> Installation du simulateur F1TENTH
Pour en savoir plus...
- https://dev.to/koheikawata/devcontainer-for-ros2-project-31ng
- https://docs.ros.org/en/foxy/How-To-Guides/Setup-ROS-2-with-VSCode-and-Docker-Container.html
- https://www.allisonthackston.com/articles/vscode-docker-ros2
- https://github.com/athackst/vscode_ros2_workspace
- https://github.com/athackst/dockerfiles
- https://code.visualstudio.com/docs/devcontainers/containers
- https://code.visualstudio.com/docs/devcontainers/tutorial
- https://code.visualstudio.com/docs/devcontainers/create-dev-container
- https://containers.dev/implementors/spec/
- https://containers.dev/features
- https://containers.dev/templates