Guide d'installation de Rust

Introduction

Bienvenue dans Installation. Ce laboratoire est une partie du Rust Book. Vous pouvez pratiquer vos compétences Rust dans LabEx.

Dans ce laboratoire, vous devrez installer Rust à l'aide de rustup, un outil de ligne de commande pour gérer les versions de Rust et les outils associés, en le téléchargeant via une connexion Internet.

Ceci est un Guided Lab, qui fournit des instructions étape par étape pour vous aider à apprendre et à pratiquer. Suivez attentivement les instructions pour compléter chaque étape et acquérir une expérience pratique. Les données historiques montrent que c'est un laboratoire de niveau intermédiaire avec un taux de réussite de 71%. Il a reçu un taux d'avis positifs de 94% de la part des apprenants.

Installation

La première étape consiste à installer Rust. Nous allons 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.

Note : Si vous préférez ne pas utiliser rustup pour une raison quelconque, consultez la page Autres méthodes d'installation de Rust à l'adresse https://forge.rust-lang.org/infra/other-installation-methods.html pour plus d'options.

Les étapes suivantes installent la dernière version stable du compilateur Rust. Les garanties de stabilité de Rust assurent que tous les exemples du livre qui se compilent continueront de se compiler avec les nouvelles versions de Rust. La sortie peut différer légèrement entre les versions 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 utilisant ces étapes devrait fonctionner comme prévu avec le contenu de ce livre.

Notation de la ligne de commande

Dans ce chapitre et tout au long du livre, nous montrerons certaines commandes utilisées dans le terminal. Les lignes que vous devez entrer dans un terminal commencent toutes par $. Vous n'avez pas besoin de taper le caractère $ ; c'est l'invite de commande affichée pour indiquer le début de chaque commande. Les lignes qui ne commencent pas par $ montrent généralement la sortie 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 entrez la commande suivante :

curl --proto '=https' --tlsv1.3 https://sh.rustup.rs -sSf | sh

La commande télécharge un script et lance l'installation de l'outil rustup, qui installe la dernière version stable de Rust. Vous pouvez être invité à saisir votre mot de passe. Si l'installation est réussie, la ligne suivante apparaîtra :

Rust is installed now. Great!

Vous aurez également besoin d'un lienqueur, qui est un programme que Rust utilise pour joindre ses sorties compilées en un seul fichier. Il est probable que vous en avez déjà un. Si vous rencontrez des erreurs de lienqueur, vous devriez installer un compilateur C, qui inclura généralement un lienqueur. Un compilateur C est également utile car certains paquets Rust courants dépendent de code C et auront besoin d'un compilateur C.

Les utilisateurs de Linux devraient généralement installer GCC ou Clang, selon les instructions de leur distribution. Par exemple, si vous utilisez Ubuntu, vous pouvez installer le paquet build-essential.

Dépannage

Pour vérifier si Rust est correctement installé, ouvrez un nouveau shell et entrez cette ligne :

## Ouvrez d'abord un nouveau terminal!
rustc --version

Vous devriez voir le numéro de version, le hachage du commit et la date du commit pour 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 est dans votre variable de système %PATH% comme suit.

En Linux, utilisez :

echo $PATH

Si tout est correct et que Rust ne fonctionne toujours pas, il existe de nombreux endroits où vous pouvez obtenir de l'aide. Découvrez comment vous mettre en contact avec d'autres Rustaceens (un surnom amusant que nous nous donnons) sur la page communautaire à l'adresse https://www.rust-lang.org/community.

Mise à jour et Désinstallation

Une fois que Rust est installé via rustup, la mise à jour vers une nouvelle version publiée est facile. À partir de votre shell, exécutez le script de mise à jour suivant :

rustup update

Pour désinstaller Rust et rustup, exécutez le script de désinstallation suivant à partir de votre shell :

rustup self uninstall

Entrez N lorsque vous êtes invité à confirmer que vous voulez désinstaller Rust.

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.

rustup doc

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 la manière de l'utiliser, utilisez la documentation de l'interface de programmation d'application (API) pour trouver cela!

Note : Le WebIDE ne prend pas en charge l'ouverture de la documentation locale.

Sommaire

Félicitations! Vous avez terminé le laboratoire d'installation. Vous pouvez pratiquer d'autres laboratoires dans LabEx pour améliorer vos compétences.