Installieren Sie Azure SDK für Rust-Crates

Mit dem Azure SDK für Rust können Sie auf Azure-Dienste in Ihren Rust-Projekten zugreifen, indem Sie einzelne SDK-Kisten mit Cargo installieren. In diesem Artikel wird erläutert, wie Sie das Azure SDK für Rust-Kisten installieren, aktualisieren und verwalten, damit Sie nur die benötigten Features hinzufügen und Ihre Projekte auf dem neuesten Stand halten können.

Voraussetzungen für die Entwicklung mit Crates

Tipp

Um eine optimale Entwicklungserfahrung zu erzielen, stellen Sie sicher, dass Sie die neueste stabile Version von Rust installiert haben.

Installieren Sie die neueste Version der Azure SDK Crate

Beziehen Sie Azure SDK-Crates von crates.io. Installieren Sie die einzelnen Krates, die Sie benötigen.

Die neueste Azure SDK für die Rost-Kastenversion ist die neueste stabile Version 1.x für diese Kiste.

cargo add <crate_name>

Ersetzen Sie <crate_name> durch den Namen des Azure-Crates, das Sie installieren möchten. Um z. B. die aktuelle stabile Azure Identität und Key Vault Geheimschlüssel zu installieren:

cargo add azure_identity azure_security_keyvault_secrets

Die verfügbaren Kastennamen finden Sie im Kastenindex für Azure.

Important

Verwenden Sie stabile 1.x-Azure SDK für Rost-Kastenversionen für Produktionsworkloads. Vorschau- und Betaversionen sind für einige Kisten verfügbar, werden jedoch cargo add <crate_name> standardmäßig auf die neueste stabile Version aufgelöst.

Installieren Sie eine bestimmte Version eines Azure SDK-Crates

Manchmal müssen Sie eine bestimmte Versionsanforderung für eine Kiste für Kompatibilitätstests verwenden oder die Konsistenz in allen Umgebungen beibehalten. Cargo löst die Anforderung an eine kompatible Version und zeichnet die genaue aufgelöste Version in Cargo.lock.

cargo add <crate_name>@1

Verwenden Sie beispielsweise die neueste stabile Version 1.x:

cargo add azure_storage_blob@1

Weitere Informationen zur Versionsanforderungssyntax finden Sie in der Rust-Dokumentation.

Aktualisieren von Azure SDK-Kisten

Führen Sie Folgendes aus, um alle Crates auf ihre neuesten kompatiblen Versionen zu aktualisieren:

cargo update

Führen Sie Folgendes aus, um ein bestimmtes Crate zu aktualisieren:

cargo update <crate_name>

Entfernen einer bestimmten Azure SDK-Kiste

Um eine Kiste aus Ihrem Projekt zu entfernen, einschließlich der Cargo.toml Datei, führen Sie Folgendes aus:

cargo remove <crate_name>

Erstellen Sie das Projekt neu, um Ihre Cargo.lock-Datei zu aktualisieren:

cargo build

Konfigurieren von Azure SDK-Crate-Features

Die azure_core Kiste bietet Features für alle Azure SDK-Kisten, z. B.:

  • reqwest: HTTP-Clientimplementierung.
  • tokio: Asynchrone Laufzeitunterstützung.

Aktivieren von SDK-Features beim Hinzufügen einer Kiste:

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

Oder geben Sie Funktionen in Ihrem Cargo.toml an:

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

Weitere Ressourcen

  • Last updated on