Installation
La première étape consiste à installer Rust. Vous devez télécharger Rust via rustup, un outil de ligne de commande pour gérer les versions de Rust et les outils associés. Vous aurez besoin d'une connexion Internet pour le téléchargement.
Remarque : si vous préférez ne pas utiliser rustup pour une raison quelconque, veuillez pouvez consulter la page des autres méthodes d'installation de Rust pour plus d'options.
Les étapes suivantes installent la dernière version stable du compilateur Rust. Les garanties de stabilité de Rust garantissent que tous les exemples de Rest compilant continueront à compiler avec les versions plus récentes de Rust. Le résultat peut différer légèrement d'une version à l'autre, car Rust améliore souvent les messages d'erreur et les avertissements. En d'autres termes, toute version plus récente et stable de Rust que vous installez en suivant ces étapes devrait fonctionner comme prévu.
Notation de la ligne de commande
Dans cette page, nous allons montrer certaines commandes utilisées dans le terminal. Les lignes que vous devez saisir dans un terminal commencent toutes par $. Vous n'avez pas besoin de saisir le caractère $ ; c'est le prompt de ligne de commande affichée pour indiquer le début de chaque commande. Les lignes ne commençant pas par $ affichent généralement le résultat de la commande précédente. De plus, les exemples spécifiques à PowerShell utiliseront > plutôt que $.
Installation de rustup sur Linux ou macOS
Si vous utilisez Linux ou macOS, ouvrez un terminal et saisissez la commande suivante :
| $ curl --proto '=https' --tlsv1.2 https://sh.rustup.rs -sSf | sh |
La commande télécharge un script et démarre l'installation de l'outil rustup, installant la dernière version stable de Rust. Vous serez peut-être invité à saisir votre mot de passe. Si l'installation réussit, la ligne suivante s'affiche :
| Rust is installed now. Great! |
Vous aurez également besoin d'un linker, étant un programme que Rust utilise pour joindre ses sorties compilées en un seul fichier. Il est probable que vous en ayez déjà un. Si vous obtenez des erreurs de linker, vous devez installer un compilateur C, incluant généralement un linker. Un compilateur C est également utile car certains paquets Rust courants dépendent du code C et auront besoin d'un compilateur C.
Sur macOS, vous pouvez obtenir un compilateur C en exécutant :
| $ xcode-select --install |
Les utilisateurs de Linux doivent généralement installer GCC ou Clang, selon la documentation de leur distribution. Par exemple, si vous utilisez Ubuntu, vous pouvez installer le paquet build-essential.
Installation de rustup sous Windows
Sous Windows, accédez à https://www.rust-lang.org/tools/install et suivez les instructions d'installation de Rust. À un moment donné de l'installation, vous serez invité à installer Visual Studio. Cela fournit un linker et les bibliothèques natives nécessaires à la compilation des programmes.
Dépannage
Pour vérifier si Rust est correctement installé, ouvrez un interpréteur de commande et saisissez cette ligne :
| $ rustc --version |
Vous devriez voir le numéro de version, le hachage de validation et la date de validation de la dernière version stable publiée, au format suivant :
| rustc x.y.z (abcabcabc yyyy-mm-dd) |
Si vous voyez ces informations, vous avez installé Rust avec succès ! Si vous ne voyez pas ces informations, vérifiez que Rust se trouve dans votre variable système %PATH% comme suit.
Dans CMD de Windows, utilisez :
| echo %PATH% |
Dans PowerShell, utilisez :
| echo $env:Path |
Sous Linux et macOS, utilisez :
| echo $PATH |
Si tout cela est correct et que Rust ne fonctionne toujours pas, il existe plusieurs endroits où vous pouvez obtenir de l'aide. Découvrez comment entrer en contact avec d'autres Rustaceans (un surnom ridicule de développeur Rust) sur la page de la communauté.
Mise à jour et désinstallation
Une fois Rust installé via rustup, la mise à jour vers une nouvelle version est facile. Depuis votre interpréteur de commande, exécutez le script de mise à jour suivant :
| rustup update |
Pour désinstaller Rust et rustup, exécutez le script de désinstallation suivant depuis votre interpréteur de commande :
| rustup self uninstall |
Documentation locale
L'installation de Rust inclut également une copie locale de la documentation afin que vous puissiez la lire hors ligne. Exécutez rustup doc pour ouvrir la documentation locale dans votre navigateur.
Chaque fois qu'un type ou une fonction est fourni par la bibliothèque standard et que vous n'êtes pas sûr de ce qu'il fait ou de comment l'utiliser, utilisez la documentation de l'interface de programmation d'application (API) pour le savoir !