Installer des crates de SDK Azure pour Rust

Le Kit de développement logiciel (SDK) Azure pour Rust vous permet d’accéder aux services Azure dans vos projets Rust en installant des caisses de SDK individuelles avec Cargo. Cet article explique comment installer, mettre à jour et gérer les caisses du Kit de développement logiciel (SDK) Azure pour Rust. Vous pouvez donc ajouter uniquement les fonctionnalités dont vous avez besoin et maintenir vos projets à jour.

Prérequis pour développer avec des crates

  • Rust 1.85.0 ou version ultérieure. La version est spécifiée dans le Kit de développement logiciel (SDK) Azure pour Rust Cargo.toml.
  • Un abonnement Azure. Vous pouvez en créer un gratuitement.

Conseil / Astuce

Pour une expérience de développement optimale, vérifiez que vous disposez de la dernière version stable de Rust installée.

Installer la dernière version du Kit de développement logiciel (SDK) Azure

Obtenez les crates du SDK Azure sur crates.io. Installez les caisses individuelles dont vous avez besoin.

cargo add <crate_name>

Remplacez <crate_name> par le nom de la caisse Azure que vous souhaitez installer. Par exemple, pour installer les caisses de secrets Azure Identity et Key Vault :

cargo add azure_identity azure_security_keyvault_secrets

Vous pouvez trouver les noms des crates disponibles dans l’index des crates pour Azure.

Installer une version spécifique d’un crate du SDK Azure

Parfois, vous devez installer une version particulière d’une caisse pour les tests de compatibilité ou maintenir la cohérence entre les environnements. Lorsque vous spécifiez une version, vous figez votre dépendance. Votre projet continue d’utiliser cette version et ne reçoit pas automatiquement de mises à jour majeures ou mineures, mais il peut toujours recevoir des mises à jour correctives. Bien que l’épinglage puisse être utile dans certains scénarios, nous vous recommandons d’utiliser plutôt la dernière version afin de tirer parti des améliorations continues et des mises à jour de sécurité.

cargo add <crate_name>@<version_number>

Par exemple:

cargo add azure_storage_blob@0.20.0

Vous pouvez également spécifier les exigences de version dans votre Cargo.toml fichier. Pour plus d’informations sur la syntaxe des exigences de version, consultez la documentation Rust.

Mettre à jour les crates du SDK Azure

Pour mettre à jour tous les crates vers leurs dernières versions compatibles, exécutez :

cargo update

Pour mettre à jour une crate spécifique, exécutez :

cargo update <crate_name>

Supprimer une caisse spécifique du Kit de développement logiciel (SDK) Azure

Pour supprimer un crate de votre projet, y compris le fichier Cargo.toml, exécutez :

cargo remove <crate_name>

Générez le projet pour mettre à jour votre Cargo.lock fichier :

cargo build

Configurer les fonctionnalités du crate du SDK Azure

Le crate azure_core fournit des fonctionnalités pour tous les crates du SDK Azure, telles que :

  • reqwest: implémentation du client HTTP.
  • tokio: prise en charge du runtime asynchrone.

Activez les fonctionnalités du Kit de développement logiciel (SDK) lors de l’ajout d’une caisse :

cargo add <crate_name> --features <feature_name_1>,<feature_name_2>

Ou spécifiez des fonctionnalités dans votre Cargo.toml:

[dependencies]
<crate_name> = { version = "0.17", features = ["<feature_name_1>", "<feature_name_2>"] }

Ressources supplémentaires

  • Last updated on