Instalowanie zestawu Azure SDK dla skrzynek crates firmy Rust

Pakiet Azure SDK for Rust umożliwia korzystanie z usług platformy Azure w swoich projektach w języku Rust poprzez instalowanie poszczególnych pakietów SDK za pomocą Cargo. 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 pracy z crate'ami

  • Rust 1.85.0 lub nowszy. Wersja jest określona w pakiecie 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.

Zainstaluj najnowszą wersję pakietu crate Azure SDK

Pobierz crate’y pakietu Azure SDK z crates.io. Zainstaluj poszczególne crate’y, których potrzebujesz.

cargo add <crate_name>

Zastąp element <crate_name> nazwą pakietu crate Azure, który chcesz zainstalować. Na przykład, aby zainstalować pakiety Azure Identity i Key Vault Secrets:

cargo add azure_identity azure_security_keyvault_secrets

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

Zainstaluj określoną wersję pakietu Azure SDK

Czasami trzeba zainstalować określoną wersję crate w celu testowania zgodności lub aby zachować spójność między środowiskami. Gdy określisz wersję, przypinasz swoją 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 pakietów 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ąć crate z projektu, w tym również plik Cargo.toml, uruchom polecenie:

cargo remove <crate_name>

Skompiluj projekt, aby zaktualizować Cargo.lock plik:

cargo build

Konfigurowanie funkcji crate’u 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

  • Last updated on