Note
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de vous connecter ou de modifier des répertoires.
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de modifier des répertoires.
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.
Conditions préalables au développement avec des caisses
- 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 des caisses du Kit de développement logiciel (SDK) Azure à partir de 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 trouverez des noms de caisse disponibles dans l’index crate pour Azure.
Installer une version spécifique du Kit de développement logiciel (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 épinglez 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 la dernière version pour 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 caisses du Kit de développement logiciel (SDK) Azure
Pour mettre à jour toutes les caisses vers leurs dernières versions compatibles, exécutez :
cargo update
Pour mettre à jour une caisse spécifique, exécutez :
cargo update <crate_name>
Supprimer une caisse spécifique du Kit de développement logiciel (SDK) Azure
Pour supprimer une caisse de votre projet, y compris le Cargo.toml fichier, exécutez :
cargo remove <crate_name>
Générez le projet pour mettre à jour votre Cargo.lock fichier :
cargo build
Configurer les fonctionnalités crate du Kit de développement logiciel (SDK) Azure
La azure_core caisse fournit des fonctionnalités pour toutes les caisses du Kit de développement logiciel (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
- Caisses du Kit de développement logiciel (SDK) Azure sur Crates.io - Liste des caisses disponibles du Kit de développement logiciel (SDK) Azure
- Recommandations en matière de conception du Kit de développement logiciel (SDK) Azure - Principes et modèles de conception
- Référentiel GitHub du Kit de développement logiciel (SDK) Azure pour Rust - Problèmes et code source
- Documentation sur la cargaison - Informations de référence complètes sur le fret