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 13.3 or higher

  • Ubuntu 22.04 & 24.04, 64 bit. Other Linux distributions with glibc >= 2.35 may work, but are unsupported

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

On Windows, the Visual Studio 2019 redistributable package is required to be installed.

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

If you don’t have administrative rights on your computer, either use virtualenv/virtualenvwrapper-win, or or you can install to the user site-packages directory:

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

If you need to upgrade your version of pip, it is highly recommended to use a virtual environment.

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.