Comment utiliser les packages de rouille

Dans Rust Programming, ou Cargo, un package fait référence à une collection de fichiers écrits en rouille. Considérez un package comme une collection de fichiers qui composent une application. À l'aide de packages, nous pouvons regrouper tous les modules qui créent un exécutable ou une bibliothèque pour créer un package.

Composants d'un emballage de rouille

Un emballage en rouille comprend trois composants clés.

1. Le code source réel de l'application. Cela peut inclure des importations externes.
2. Un fichier de bibliothèque qui définit les bibliothèques que la demande nécessite. Il s'agit d'un fichier facultatif et n'a pas besoin d'être présent si votre package ne nécessite aucune bibliothèque.
3. Une cargaison.Fichier Toml qui contient la configuration de vos composants. Ce fichier de configuration est très utile car il décrit comment regrouper divers composants du package dans une application.

Bienvenue à la cargaison

Lorsque vous travaillez avec des packages, il y a un outil que vous devez connaître: la cargaison. La cargaison est un «gestionnaire de packages» pour la rouille. Il permet de construire et de gérer les packages de rouille. Il effectue des opérations telles que le bâtiment crée, l'installation et la désinstallation de caisses, le déploiement, etc.

NOTE: Bien que le terme package et la caisse puissent être utilisés de manière interchangeable, ils ne sont pas la même chose.

Discutons de la façon dont nous pouvons travailler avec le fret pour créer et gérer les packages de rouille.

Package de création de cargaison

Pour créer un nouveau package de rouille, utilisez la nouvelle commande de cargaison suivie du nom de votre package:

$ cargo new package_name;

L'exécution de la commande ci-dessus crée un nouveau répertoire avec le nom du package spécifié. À l'intérieur du répertoire, vous trouverez d'autres fichiers et répertoires:

$ package d'arbre_name

Le fichier et l'arborescence du répertoire sont indiqués:

nom du paquet/
├fiques.toml
└fiques
└fiques.Rs
1 répertoire, 2 fichiers

Dans le répertoire racine du package_name, vous trouverez la cargaison.Fichier Toml qui est un fichier de configuration par défaut généré par cargo.

Le suivant est le répertoire SRC, qui contient le code source de votre application. Par défaut, le fret ajoutera principal.Fichier RS ​​avec un programme Hello World.

C'est le strict minimum pour le déploiement d'un package. Si vous souhaitez créer une application plus complexe, assurez-vous que le code source est stocké dans le répertoire SRC.

Vous pouvez également effectuer une configuration dans la cargaison.fichier toml. Les options populaires que vous pouvez définir sont comme indiqué dans l'exemple de fichier toml.

[emballer]
name = "package_name"
version = "0.1.0 "
edition = "2021"
auteurs = ["Linuxhint", "csalem"]
Rust-Version = "1.56 "
Description = "Package Description"
documentation = "path :: // to_url_website.com "
readme = "readme.Maryland"
Licence = "MIT"

Vous pouvez en savoir plus sur diverses clés et leurs valeurs correspondantes dans la ressource ci-dessous:

https: // doc.chanteur de la rouille.org / cargo / référence / manifeste.html

Forfait de construction de cargaison

Une fois que vous avez terminé avec votre code et votre configuration, vous pouvez créer votre package. La commande est comme:

$ builgo

La cargaison construire et générera les fichiers exécutables requis et les stockera dans le répertoire cible.

La commande de construction de cargaison ajoutera également quelques répertoires et fichiers comme indiqué:

├fiques.serrure
├fiques.toml
├fiques
│ └fique.Rs
└til
├tilirdir.ÉTIQUETER
└fiques
├fiques
├til - DEPS
│ ├fique
│ └fique.d
├fiques
├fiques
├fiques-packages
└fiques-packages.d

Vous pouvez en savoir plus sur les fichiers et répertoires générés dans la ressource ci-dessous:

https: // doc.chanteur de la rouille.org / cargo / commandes / bullet cargo.html

Forfait de course à la cargaison

Une fois le package terminé, vous pouvez l'exécuter à l'aide de la commande CARGO RUN:

$ cargo Run

Cela construira et exécutera le package pour vous. La sortie du package Hello World est comme indiqué:

Conclusion

Dans ce guide, nous avons couvert les packages de rouille, comment créer un package, le construire et l'exécuter à l'aide de la cargaison. Vous pouvez vérifier comment déployer des packages sur les caisses dans la documentation officielle.

Merci d'avoir lu et restez rouillé!!