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.

L'ultima Azure SDK per la versione crate di Rust è la versione stabile 1.x più recente per tale crate.

cargo add <crate_name>

Sostituisci <crate_name> con il nome del crate di Azure che vuoi installare. Ad esempio, per installare i crate di identità Azure stabili correnti e Key Vault segreti:

cargo add azure_identity azure_security_keyvault_secrets

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

Importante

Usare Azure SDK stabile 1.x per le versioni crate di Rust per i carichi di lavoro di produzione. Le versioni di anteprima e beta sono disponibili per alcuni crate, ma cargo add <crate_name> vengono risolte nella versione stabile più recente per impostazione predefinita.

Installare una versione specifica di Crate di Azure SDK

A volte è necessario usare un requisito di versione specifico per un crate per il test di compatibilità o per mantenere la coerenza tra gli ambienti. Cargo risolve il requisito di una versione compatibile e registra la versione risolta esatta in Cargo.lock.

cargo add <crate_name>@1

Ad esempio, per usare la versione stabile 1.x più recente:

cargo add azure_storage_blob@1

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 = "1", features = ["<feature_name_1>", "<feature_name_2>"] }

Risorse aggiuntive

  • Last updated on