Installare i crate Rust di Azure SDK

Azure SDK per Rust consente di accedere ai servizi di Azure nei progetti Rust installando singoli crate SDK con Cargo. Questo articolo illustra come installare, aggiornare e gestire le casse di Azure SDK per Rust, in modo da poter aggiungere solo le funzionalità necessarie e mantenere aggiornati i progetti.

Prerequisiti per lo sviluppo con crate

Suggerimento

Per un'esperienza di sviluppo ottimale, assicurarsi di avere installato la versione stabile più recente di Rust.

Installare la versione più recente di Crate di Azure SDK

Ottieni i crate di Azure SDK da crates.io. Installare le singole crate di cui hai bisogno.

cargo add <crate_name>

Sostituisci <crate_name> con il nome del crate di Azure che vuoi installare. Ad esempio, per installare i crate Azure Identity e Key Vault Secrets:

cargo add azure_identity azure_security_keyvault_secrets

È possibile trovare i nomi di crate disponibili nell'indice crate per Azure.

Installare una versione specifica di Crate di Azure SDK

A volte è necessario installare una versione specifica di una cassa per i test di compatibilità o mantenere la coerenza tra gli ambienti. Quando si specifica una versione, si aggiunge la dipendenza. Il progetto continua a usare tale versione e non riceve automaticamente aggiornamenti principali o secondari, ma può comunque ricevere gli aggiornamenti delle patch. Sebbene il pinning possa essere utile in determinati scenari, consigliamo di usare la versione più recente per beneficiare dei miglioramenti continui e degli aggiornamenti di sicurezza.

cargo add <crate_name>@<version_number>

Per esempio:

cargo add azure_storage_blob@0.20.0

È anche possibile specificare i requisiti di versione nel Cargo.toml file. Per altre informazioni sulla sintassi dei requisiti di versione, vedere la documentazione di Rust.

Aggiornare i crate dell'SDK di Azure

Per aggiornare tutti i crate alle versioni compatibili più recenti, eseguire:

cargo update

Per aggiornare un crate specifico, eseguire:

cargo update <crate_name>

Rimuovere un crate specifico di Azure SDK

Per rimuovere un crate dal proprio progetto, incluso il file Cargo.toml, eseguire:

cargo remove <crate_name>

Compilare il progetto per aggiornare il Cargo.lock file:

cargo build

Configurare le funzionalità crate di Azure SDK

Il crate azure_core offre funzionalità per tutti i crate dell'SDK di Azure, ad esempio:

  • reqwest: implementazione del client HTTP.
  • tokio: supporto del runtime asincrono.

Abilita le funzionalità dell’SDK quando aggiungi un crate:

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

Oppure specificare le funzionalità in Cargo.toml:

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

Risorse aggiuntive

  • Last updated on