Udostępnij za pomocą


Instalowanie zestawu Azure SDK dla skrzynek crates firmy Rust

Zestaw Azure SDK for Rust umożliwia dostęp do usług platformy Azure w projektach Rust, instalując poszczególne skrzynie zestawu SDK z ładunkiem. W tym artykule przedstawiono sposób instalowania, aktualizowania i zarządzania zestawem Azure SDK for Rust, dzięki czemu można dodawać tylko potrzebne funkcje i aktualizować projekty.

Wymagania wstępne dotyczące opracowywania z skrzyniami

  • Rust 1.85.0 lub nowszy. Wersja jest określona w zestawie Azure SDK dla języka Rust Cargo.toml.
  • Subskrypcja platformy Azure. Możesz utworzyć go bezpłatnie.

Wskazówka

Aby uzyskać najlepsze środowisko programistyczne, upewnij się, że masz zainstalowaną najnowszą stabilną wersję oprogramowania Rust.

Instalowanie najnowszej wersji skrzyni zestawu Azure SDK

Pobierz skrzynie zestawu Azure SDK z crates.io. Zainstaluj potrzebne poszczególne skrzynie.

cargo add <crate_name>

Zastąp <crate_name> ciąg nazwą skrzyni platformy Azure, którą chcesz zainstalować. Na przykład aby zainstalować skrzynie kluczy tajnych usługi Azure Identity i Key Vault:

cargo add azure_identity azure_security_keyvault_secrets

Dostępne nazwy skrzyni można znaleźć w indeksie skrzyni dla platformy Azure.

Instalowanie określonej wersji skrzyni zestawu Azure SDK

Czasami należy zainstalować określoną wersję skrzyni na potrzeby testowania zgodności lub zachować spójność w różnych środowiskach. Po określeniu wersji należy przypiąć zależność. Projekt kontynuuje korzystanie z tej wersji i nie otrzymuje automatycznie aktualizacji głównych ani pomocniczych, ale nadal może otrzymywać aktualizacje poprawek. Chociaż przypinanie może być przydatne w niektórych scenariuszach, zalecamy użycie najnowszej wersji w celu skorzystania z bieżących ulepszeń i aktualizacji zabezpieczeń.

cargo add <crate_name>@<version_number>

Przykład:

cargo add azure_storage_blob@0.20.0

Możesz również określić wymagania dotyczące wersji w Cargo.toml pliku. Aby uzyskać więcej informacji na temat składni wymagań dotyczących wersji, zobacz dokumentację rust.

Aktualizowanie stawek zestawu Azure SDK

Aby zaktualizować wszystkie skrzynie do najnowszych zgodnych wersji, uruchom polecenie:

cargo update

Aby zaktualizować określoną skrzynię, uruchom polecenie:

cargo update <crate_name>

Usuwanie określonej skrzyni zestawu Azure SDK

Aby usunąć skrzynię z projektu, w tym Cargo.toml plik, uruchom polecenie:

cargo remove <crate_name>

Skompiluj projekt, aby zaktualizować Cargo.lock plik:

cargo build

Konfigurowanie funkcji skrzyni zestawu Azure SDK

Skrzynia azure_core zawiera funkcje dla wszystkich skrzynek zestawu Azure SDK, takich jak:

  • reqwest: implementacja klienta HTTP.
  • tokio: obsługa środowiska uruchomieniowego asynchronicznego.

Włącz funkcje zestawu SDK podczas dodawania skrzyni:

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

Możesz też określić funkcje w pliku Cargo.toml:

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

Dodatkowe zasoby