Gérer les dépendances avec les caisses
Comprenez comment Cargo gère les caisses externes (bibliothèques) et comment publier les vôtres pour la communauté.
Gérer les dépendances avec les caisses est une leçon Learn Rust Coding gratuite sur CoddyKit. Ceci est la leçon 2 sur 3. Tu peux lire la leçon complète ci-dessous gratuitement — puis la pratiquer en direct dans le navigateur avec un éditeur de code intégré et un tuteur IA 24/7. Elle fait partie du parcours d'apprentissage Learn Rust Coding, et ta progression se synchronise sur le web et l'application CoddyKit. Le cours Learn Rust Coding comprend 3 leçons au total.
Que sont les caisses et Cargo ?
En Rust, une caisse est l'unité fondamentale de compilation et de distribution. Considérez-la comme un paquet ou une bibliothèque contenant votre code.
Cargo est le gestionnaire de paquets et le système de compilation officiels de Rust. Il s'occupe de tout, de la création de nouveaux projets à la gestion des dépendances, en passant par la compilation du code et l'exécution des tests. C'est votre meilleur allié pour développer en Rust !
Le fichier `Cargo.toml`
Chaque projet Rust géré par Cargo possède un fichier Cargo.toml dans son répertoire racine. Il s'agit du fichier manifeste de votre projet, écrit en TOML (Tom's Obvious, Minimal Language).
Il définit les métadonnées de votre projet et, surtout, répertorie ses dépendances.
Configuration du projet
La section [package] de Cargo.toml contient les informations essentielles concernant votre caisse :
- name : le nom de votre caisse.
- version : sa version actuelle.
- edition : l'édition de Rust à utiliser (par exemple, 2021).
- authors : les personnes qui l'ont créée.
Ces informations sont essentielles, surtout si vous prévoyez de publier votre caisse.
Ajouter des dépendances
Pour utiliser des bibliothèques externes (d'autres caisses) dans votre projet, répertoriez-les dans la section [dependencies] de Cargo.toml.
Lorsque vous compilez votre projet, Cargo télécharge et compile automatiquement ces dépendances depuis crates.io, le registre central des paquets Rust.
Syntaxe des dépendances
Voici comment déclarer une dépendance dans votre Cargo.toml :
[dependencies]
rand = "0.8.5"Cela indique à Cargo de récupérer la version 0.8.5 de la caisse rand. Vous pouvez également spécifier des plages de versions ou des chemins locaux.
Utiliser une caisse : exemple
Ajoutons la caisse rand pour générer un nombre aléatoire. Commencez par vérifier que rand = "0.8.5" figure dans vos [dependencies]. Utilisez-la ensuite dans votre code :
use rand::Rng; // Import the Rng trait
fn main() {
let mut rng = rand::thread_rng(); // Create a random number generator
let n: u8 = rng.gen_range(1..=10); // Generate a number between 1 and 10 (inclusive)
println!("Your random number is: {}", n);
}Le fichier `Cargo.lock`
Après une compilation avec des dépendances, Cargo crée un fichier Cargo.lock. Ce fichier enregistre les versions exactes de toutes les dépendances directes et transitives utilisées dans votre projet.
Il garantit que toutes les personnes travaillant sur le projet utilisent les mêmes versions des dépendances, ce qui permet d'obtenir des compilations reproductibles dans différents environnements.
Mettre à jour les dépendances
Au fil du temps, vos dépendances peuvent publier de nouvelles versions corrigeant des bogues ou ajoutant de nouvelles fonctionnalités. Pour les mettre à jour, utilisez la commande cargo update.
Cette commande recherche sur crates.io les versions plus récentes correspondant aux exigences de version de votre Cargo.toml, puis met à jour Cargo.lock en conséquence.
Publier votre propre caisse
Vous souhaitez partager votre formidable code Rust avec la communauté ? Vous pouvez publier votre propre caisse sur crates.io !
Avant de publier, vérifiez que votre Cargo.toml contient des métadonnées appropriées, telles que des liens description, license et repository.
Commandes de publication
Le processus est simple :
- Se connecter : utilisez
cargo login <token>avec un jeton d'API provenant de crates.io. - Publier : exécutez
cargo publishdepuis le répertoire racine de votre projet.
Cargo effectuera les vérifications, empaquettera votre code et le téléversera, afin de le rendre disponible pour les autres !
Vérification rapide : Cargo et les caisses
Laquelle des affirmations suivantes concernant la gestion des paquets Rust avec Cargo est vraie ?
Récapitulatif : gérer les dépendances
Vous avez appris à quel point Cargo est essentiel pour gérer les projets Rust et leurs dépendances !
- Les caisses sont des paquets de code réutilisables.
- Cargo.toml définit votre projet et ses dépendances.
- Cargo.lock garantit des compilations reproductibles.
- Vous pouvez publier vos propres caisses sur crates.io.
Ce puissant système rend le partage et la réutilisation du code en Rust particulièrement efficaces et fiables.
Questions Fréquemment Posées
La leçon « Gérer les dépendances avec les caisses » est-elle gratuite ?
Oui — le texte complet de « Gérer les dépendances avec les caisses » est gratuit à lire ici sur le web. Pour la pratiquer de manière interactive (un éditeur de code intégré et un tuteur IA 24/7) et déverrouiller le reste du cours Learn Rust Coding, passe à CoddyKit PRO. Le cours Learn Rust Coding comprend 3 leçons au total.
Qu'est-ce que j'apprendrai dans « Gérer les dépendances avec les caisses » ?
Comprenez comment Cargo gère les caisses externes (bibliothèques) et comment publier les vôtres pour la communauté. Tu pratiques Learn Rust Coding avec du code pratique que tu exécutes directement dans le navigateur, et un tuteur IA 24/7 répond à tes questions au fur et à mesure que tu avances dans la leçon.
Dois-je avoir de l'expérience pour commencer Learn Rust Coding ?
Aucune expérience préalable n'est requise. Learn Rust Coding sur CoddyKit est structuré pour les débutants jusqu'aux apprenants avancés, donc tu peux commencer ici ou depuis le début et avancer à ton rythme. Ceci est la leçon 2 sur 3.
Combien de temps prend la leçon « Gérer les dépendances avec les caisses » ?
La plupart des leçons CoddyKit prennent environ 5–10 minutes. Chacune est courte et interactive, tu progresses régulièrement et tu repiques exactement où tu t'es arrêté sur le web et l'app.
Peux-tu écrire et exécuter du code dans cette leçon Learn Rust Coding ?
Oui. Chaque leçon Learn Rust Coding inclut un éditeur de code intégré, tu écris et exécutes du vrai code directement dans ton navigateur et tu reçois des retours IA instantanés — aucune configuration locale requise.
Toutes les leçons de ce cours
- Organiser le code avec des modules
- Gérer les dépendances avec les caisses
- Gestion robuste des erreurs avec `Result`