Nota
L'accesso a questa pagina richiede l'autorizzazione. È possibile provare ad accedere o modificare le directory.
L'accesso a questa pagina richiede l'autorizzazione. È possibile provare a modificare le directory.
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
- Rust 1.85.0 o versione successiva. La versione è specificata in Azure SDK per Rust Cargo.toml.
- Una sottoscrizione di Azure. È possibile crearne uno gratuitamente.
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
- Crate di Azure SDK in Crates.io - Elenco di crate di Azure SDK disponibili
- Linee guida per la progettazione di Azure SDK - Principi e modelli di progettazione
- Repository GitHub di Azure SDK per Rust - Problemi e codice sorgente
- Documentazione cargo - Informazioni di riferimento complete su Cargo