Guide d’installation WPILib

Ce guide est destiné aux équipes programmant en Java et C++. Les équipes LabVIEW peuvent passer à la section Installation de LabVIEW pour FRC. En outre, le didacticiel ci-dessous montre le cas d’une installation sous Windows 10, mais les étapes sont identiques pour tous les systèmes d’exploitation. Les notes différenciant les systèmes d’exploitation seront affichées.

Prérequis

Vous pouvez télécharger la dernière version de l’installateur à partir de GitHub. Assurez-vous de télécharger la version corespondant à votre système d’exploitation et à votre architecture.

Note

Les utilisateurs de Windows 7 doivent disposer d’un système à jour en s’assurant d’avoir la mise à jour suivante installée.

Important

La version macOS minimale prise en charge est Mojave (10.14.x).

Extraction de l’installateur

Lorsque vous téléchargez l’installateur WPILib, celui-ci est distribué sous la forme d’un fichier d’image de disque .iso pour Windows, .tar.gz pour Linux, et distribué sous la forme de DMG pour MacOS.

Les utilisateurs de Windows 10 peuvent cliquer avec le bouton droit sur l’image du disque téléchargé et sélectionner Mount pour l’ouvrir. Ensuite, démarrez WPILibInstaller.exe.

The menu after right clicking on an .iso file to choose "Mount".

Note

D’autres programmes installés peuvent s’associer à des fichiers iso et l’option mount peut ne pas apparaître. Si ce logiciel n’offre pas la possibilité de monter ou d’extraire le fichier iso, dans cas, suivez les instructions dans l’onglet « Windows 7 ».

Exécution de l’installateur

Lors de l’ouverture de l’installateur, l’écran ci-dessous vous sera présenté. Procédez et appuyez sur Start.

Start of Installer

Cet écran suivant concerne le téléchargement de VS Code. Malheureusement, pour des raisons de licence, VS Code ne peut pas être intégré dans l’installateur.

Overview of VS Code download options
  • Download VS Code for Single Install

    • Cette option télécharge VS Code uniquement pour la plate-forme actuelle, ce qui correspond également au plus petit téléchargement.

  • Skip installing VS Code

    • Ignore l’installation de VS Code. Cette option est utile pour les installations ou les configurations avancées. Généralement pas recommandé.

  • Use Downloaded Offline Installer

    • La sélection de cette option fera apparaître une invitation vous permettant de sélectionner un fichier zip préexistant de VS Code qui a été téléchargé précédemment par le programme d’installation. Cette option ne vous permet pas de sélectionner une copie déjà installée de VS Code sur votre machine.

  • Download VS Code for Offline Install

    • Cette option télécharge et enregistre une copie de VS Code pour toutes les plates-formes, ce qui est utile pour partager la copie du programme d’installation.

Allez-y et sélectionnez Download VS Code for Single Install. Cette commande va commencer le processus de téléchargement et peut prendre un peu en fonction de la connectivité Internet (c’est ~60Mo). Une fois le téléchargement effectué, sélectionnez Next. Un écran ressemblant à celui ci-dessous vous sera présenté.

An overview of the installer options

Ceci présente une liste d’options incluses dans l’installation WPILib. Il est conseillé de laisser simplement les options par défaut sélectionnées.

Vous remarquerez deux boutons, Install for this User et Install for all Users. Install for this User ne l’installe que sur le compte utilisateur actuel et ne nécessite pas de privilèges d’administrateur. Cependant, Install for all Users installe les outils pour tous les comptes système et nécessitera un accès administrateur. Install for all Users n’est pas une option pour macOS et Linux.

Sélectionnez l’option qui vous convient et l’écran d’installation suivant vous sera présenté.

Installer progress bar

Une fois l’installation terminée, l’écran de fin d’installation vous sera présenté.

Installer finished screen.

Important

WPILib installe une version distincte de VS Code que celle déjà existante. Chaque année a ainsi sa propre copie des outils annexés à l’année. IE: WPILib VS Code 2021. S’il vous plaît lancer le WPILib VS Code et non pas une autre copie installée dans le système!

Félicitations, l’environnement de développement et les outils WPILib sont maintenant installés sur votre ordinateur! Appuyez sur Terminer pour quitter le programme d’installation.

Après l’installation

Certains systèmes d’exploitation nécessitent une dernière action pour terminer l’installation.

Après l’installation, l’installateur ouvre le dossier WPILib VS Code. Faites glisser l’application VS Code sur le dock. Éjectez l’image WPILibInstaller du bureau.

Note

L’installation des outils de bureau et le redémarrage créeront un dossier sur le bureau appelé YYYY WPILib Tools, où YYYY est l’année en cours. Les raccourcis des outils de bureau ne sont pas disponibles sous Linux et MacOS.

Qu’est-ce qui a été installé?

Le programme d’installation hors ligne installe les composants suivants:

  • Visual Studio Code - L’IDE pris en charge à partir de 2019 et en montant pour le développement du code robot. L’installateur hors ligne définit une copie distincte de VS Code pour le développement WPILib, même si vous avez déjà VS Code sur votre ordinateur. Cela est possible car certains des paramètres pour la configuration et le bon fonctionnement de la WPILib peuvent briser les flux de travail existants si vous utilisez VS Code pour d’autres projets.

  • C++ Compiler - Les chaînes de compilation pour la création du code C++ pour le roboRIO

  • Gradle - La version spécifique de Gradle utilisée pour la création/déploiement du code robot C++ ou Java

  • Java JDK/JRE - Une version spécifique de Java JDK/JRE qui est utilisée pour construire le code robot Java et pour exécuter l’un des outils basés sur Java (Dashboard, etc.). Celle-ci cohabite avec les installations JDK déjà existantes et n’écrase pas la variable JAVA_HOME

  • WPILib Tools - SmartDashboard, Shuffleboard, RobotBuilder, Outline Viewer, Pathweaver, Glass

  • WPILib Dependencies - OpenCV, etc.

  • VS Code Extensions - Extensions WPILib pour le développement du code robot sous VS Code

Désinstallation

WPILib est conçu pour être installé dans différents dossiers pendant différentes années, de sorte qu’il n’est pas nécessaire de désinstaller une version précédente avant d’installer le WPILib de cette année courante. Cependant, les instructions suivantes peuvent être utilisées pour désinstaller WPILib si vous le souhaitez.

  1. Supprimez le dossier wpilib approprié (pour 2019: c:\Users\Public\frc2019, pour 2020 et versions ultérieures: c:\Users\Public\wpilib\YYYYYYYY est l’année à désinstaller)

  2. Supprimez les icônes du bureau dans C:\Users\Public\Public Desktop

  3. Supprimez les variables d’environnement Path.

    1. Dans le menu Start, taper Environment et sélectionnez « edit the system environment variables »

    2. Cliquez sur le bouton des variables d’environnement (1).

    3. Dans les variables utilisateur, sélectionnez le chemin (path) (2) puis cliquez sur edit (3).

    4. Sélectionnez le chemin avec roborio\bin (4) et cliquez sur supprimer (5).

    5. Sélectionnez le chemin avec frccode et cliquez sur supprimer (5).

    6. Répétez les étapes 3 à 6 dans le volet « Systems Variable ».

The "System Properties", "Environment Variables", and "Edit Environment Variables" screens.

Dépannage

En cas de défaillance de l’installateur, signalez le problème dans le dépôt de l’installateur. Un lien est disponible ici. L’installateur doit signaler un message relatif à la cause de l’erreur, s’il vous plaît l’inclure dans la description de votre problème.