Guide d’installation de Python
Ce guide est pour les équipes qui utilisent Python. Pour Java et C++ , allez vers Guide d’installation WPILib. Pour LabVIEW allez vers Installation de LabVIEW pour FRC (LabVIEW uniquement).
Pré-requis
Vous devez installer une version de Python supportée par votre système d’exploitation. Présentement, Python 3.8/3.9/3.10/3.11/3.12 sont supportés, mais seul Python 3.12 est disponible pour le roboRIO.
- Système d’exploitation et Architectures supportés:
Windows 10 & 11, 64 bits seulement. Les versions 32 bits et Arm ne sont pas prises en charge
macOS 12 ou version ultérieure
Ubuntu 22.04, 64 bits. D’autres distributions Linux avec glibc >= 2.35 peuvent fonctionner, mais ne sont pas supportées
Sur Windows et macOS, nous vous recommandons d’utiliser les installateurs officiels de Python distribués par python.org.
Installation de RobotPy
Une fois que vous avez installé Python, vous pouvez utiliser pip pour installer RobotPy sur votre ordinateur de développement.
Note
Si vous avez précédemment installé une version de RobotPy antérieure à 2024 ou une version bêta 2024, vous devez d’abord désinstaller RobotPy via py -m pip uninstall robotpy
avant la mise à niveau.
Avertissement
Sur Windows, le package Visual Studio 2019 redistributable doit être installé.
Exécutez la commande suivante depuis cmd ou Powershell pour installer les packages de base de RobotPy:
py -3 -m pip install robotpy
Pour effectuer une mise à niveau, vous pouvez exécuter ceci:
py -3 -m pip install --upgrade robotpy
Si vous n’avez pas de droits administratifs sur votre ordinateur, utilisez soit virtualenv/virtualenvwrapper-win, ou vous pouvez réaliser l’installation dans le répertoire des packages utilisateur:
py -3 -m pip install --user robotpy
Note
Si vous avez précédemment installé une version de RobotPy antérieure à 2024 ou une version bêta 2024, vous devez d’abord désinstaller robotpy via python3 -m pip uninstall robotpy
avant la mise à niveau.
Sur un système macOS avec pip installé, exécutez simplement la commande suivante depuis l’application Terminal (peut nécessiter des droits d’administrateur):
python3 -m pip install robotpy
Pour effectuer une mise à niveau, vous pouvez exécuter ceci:
python3 -m pip install --upgrade robotpy
Si vous n’avez pas de droits administratifs sur votre ordinateur, utilisez soit virtualenv/virtualenvwrapper, ou vous pouvez réaliser l’installation dans le répertoire des packages utilisateur:
python3 -m pip install --user robotpy
Note
Si vous avez précédemment installé une version de RobotPy antérieure à 2024 ou une version bêta 2024, vous devez d’abord désinstaller robotpy via python3 -m pip uninstall robotpy
avant la mise à niveau.
RobotPy distribue des wheels binaires manylinux sur PyPI. Cependant, l’installation de celles-ci nécessite une distribution avec glibc 2.35 ou plus récente, et un installateur qui implémente PEP 600, tel que pip 20.3 ou plus récent. Vous pouvez vérifier votre version de pip avec la commande suivante:
python3 -m pip --version
Si vous avez besoin de mettre à niveau votre version de pip, il est fortement recommandé d’utiliser un environnement virtuel.
Si vous avez une version compatible de pip, vous pouvez simplement exécuter:
python3 -m pip install robotpy
Pour effectuer une mise à niveau, vous pouvez exécuter ceci:
python3 -m pip install --upgrade robotpy
Si vous parvenez à installer les packages et obtenez l’erreur suivante ou quelque chose de similaire, votre système n’est probablement pas compatible avec RobotPy:
OSError: /usr/lib/x86_64-linux-gnu/libstdc++.so.6: version `GLIBCXX_3.4.22' not found (required by /usr/local/lib/python3.7/dist-packages/wpiutil/lib/libwpiutil.so)
Nous publions des wheels préconstruites sur artifactory, qui peuvent être téléchargées en donnant l’option --extra-index-url
à pip:
python3 -m pip install --extra-index-url=https://wpilib.jfrog.io/artifactory/api/pypi/wpilib-python-release-2024/simple robotpy
Installation à partir des sources
Alternatively, if you have a C++20 compiler installed, you may be able to use pip to install RobotPy from source.
Avertissement
Cela peut prendre beaucoup de temps à installer!
Avertissement
Mélanger nos wheels préconstruits avec des installations à partir de la source peut provoquer des erreurs d’exécution. Cela est dû à une incompatibilité interne de l’ABI entre les versions de compilateurs.
Nos wheels ARM sont construites pour Debian 11 avec GCC 10.
Si vous avez besoin de compiler avec une version spécifique du compilateur, vous pouvez le spécifier en utilisant les variables d’environnement CC
et CXX
:
export CC=gcc-12 CXX=g++-12
Télécharger RobotPy pour le roboRIO
Après avoir installé le projet robotpy
sur votre ordinateur, diverses commandes sont disponibles et peuvent être exécutées par invite de commande via le module robotpy
.
Si vous avez déjà un projet de robot utilisant RobotPy, vous pouvez utiliser celui-ci pour télécharger les éléments nécessaires à l’exécution de ce dernier sur le roboRIO. Si vous n’avez pas de projet, l’exécution de cette commande dans un répertoire vide initialisera un nouveau projet de robot:
py -3 -m robotpy init
python3 -m robotpy init
python3 -m robotpy init
Cela créera un fichier robot.py
et pyproject.toml
. Le fichier pyproject.toml
doit être personnalisé et détaille les exigences nécessaires à l’exécution de votre code de robot, entre autres choses.
Voir aussi
Le fichier pyproject.toml
créé par défaut ne contient que la version de RobotPy installée sur votre ordinateur. Si vous souhaitez activer les packages vendeurs ou installer d’autres packages Python depuis PyPI, consultez notre documentation pyproject.toml
Ensuite, exécutez la sous-commande robotpy sync
, qui:
Télécharge Python compilé pour le roboRIO
Télécharge les packages Python compatibles au roboRIO comme spécifié dans votre fichier
pyproject.toml
Installe les packages spécifiés dans votre
pyproject.toml
dans votre environnement local
Note
Si vous n’utilisez pas un environnement virtuel et n’avez pas les privilèges d’administrateur, la commande robotpy sync
accepte l’argument --user
pour installer dans le répertoire des packages utilisateur.
py -3 -m robotpy sync
python3 -m robotpy sync
python3 -m robotpy sync
Lorsque vous déployez votre code sur le roboRIO, la sous-commande deploy installera automatiquement Python (si nécessaire) et les exigences de votre projet de robot sur le roboRIO dans le cadre du processus de déploiement.