安裝適用於 Rust 的 Azure SDK

適用於 Rust 的 Azure SDK 可讓您使用 Cargo 安裝個別 SDK 箱，以存取 Rust 專案中的 Azure 服務。 本文說明如何安裝、更新及管理適用於 Rust 的 Azure SDK 箱，讓您只新增所需的功能，並讓專案保持最新狀態。

使用 crate 進行開發的先決條件

小提示

為了獲得最佳開發體驗，請確保您安裝了最新的穩定版本的 Rust。

安裝最新版的 Azure SDK crate

從 crates.io 取得 Azure SDK 箱。 安裝您需要的個別板條箱。

最新的 Azure SDK for Rust crate 版本是該 crate 的最新穩定版本 1.x。

cargo add <crate_name>

將 <crate_name> 替換為您要安裝的 Azure crate 名稱。 例如，要安裝目前穩定的 Azure Identity 和 金鑰保存庫 秘密箱子：

cargo add azure_identity azure_security_keyvault_secrets

您可以在 Azure 的 Crate 索引中找到可用的 Crate 名稱。

Important

在生產工作負載中，使用 Stable 1.x 的 Azure SDK 來執行 Rust crate 發佈。 部分箱子提供預覽版和測試版，但 cargo add <crate_name> 預設會解析到最新的穩定版。

安裝特定版本的 Azure SDK crate

有時你需要使用特定 版本要求來測試 crate 或維持環境間的一致性。 Cargo 將需求解析為相容版本，並將精確解析版本記錄於 Cargo.lock。

cargo add <crate_name>@1

例如，使用最新穩定版 1.x 版本：

cargo add azure_storage_blob@1

如需版本需求語法的詳細資訊，請參閱 Rust 文件。

更新 Azure SDK 套件

若要將所有 Crate 更新至最新的相容版本，請執行：

cargo update

若要更新特定 crate，請執行：

cargo update <crate_name>

移除特定的 Azure SDK 箱

若要從專案中移除 crate（包括 Cargo.toml 檔案），請執行：

cargo remove <crate_name>

建置專案以更新您的 Cargo.lock 檔案：

cargo build

設定 Azure SDK crate 功能

Crate azure_core 提供所有 Azure SDK Crate 的功能，例如：

  • reqwest：HTTP 用戶端實作。
  • tokio：非同步執行階段支援。

新增 crate 時啟用 SDK 功能：

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

或者在您的 Cargo.toml 中指定功能：

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

其他資源

  • Last updated on