Condividi tramite


Installare crate di Azure SDK per Rust

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

Ottenere le casse di Azure SDK da crates.io. Installare le singole casse necessarie.

cargo add <crate_name>

Sostituire <crate_name> con il nome della cassa di Azure che si vuole installare. Ad esempio, per installare i crate dei segreti di Azure Identity e Key Vault:

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. Anche se l'aggiunta può essere utile in determinati scenari, è consigliabile usare la versione più recente per trarre vantaggio dai miglioramenti continui e dagli aggiornamenti della 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 le casse di Azure SDK

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 progetto, incluso il Cargo.toml file, eseguire:

cargo remove <crate_name>

Compilare il progetto per aggiornare il Cargo.lock file:

cargo build

Configurare le funzionalità crate di Azure SDK

La azure_core cassa offre funzionalità per tutti i crate di Azure SDK, ad esempio:

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

Abilitare le funzionalità dell'SDK quando si aggiunge una cassa:

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

In alternativa, specificare le funzionalità in Cargo.toml:

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

Risorse aggiuntive