適用於 Rust 的 Azure SDK 可讓您使用 Cargo 安裝個別 SDK 箱,以存取 Rust 專案中的 Azure 服務。 本文說明如何安裝、更新及管理適用於 Rust 的 Azure SDK 箱,讓您只新增所需的功能,並讓專案保持最新狀態。
使用板條箱開發的先決條件
- Rust 1.85.0 或更新版本。 版本是在適用於 Rust 的 Azure SDK Cargo.toml 中指定。
- Azure 訂用帳戶。 您可以免費建立一個訂用帳戶。
小提示
為了獲得最佳開發體驗,請確保您安裝了最新的穩定版本的 Rust。
安裝最新的 Azure SDK 箱版本
從 crates.io 取得 Azure SDK 箱。 安裝您需要的個別板條箱。
cargo add <crate_name>
取代 <crate_name> 為您要安裝的 Azure 箱名稱。 例如,若要安裝 Azure 身分識別和金鑰保存庫秘密箱:
cargo add azure_identity azure_security_keyvault_secrets
您可以在 Azure 的 Crate 索引中找到可用的 Crate 名稱。
安裝特定的 Azure SDK 箱版本
有時您需要安裝特定 版本的 crate 以進行相容性測試或保持跨環境的一致性。 當您指定版本時,您會釘 選 相依性。 您的專案會繼續使用該版本,不會自動接收主要或次要更新,但仍可接收修補程式更新。 雖然釘選在某些情況下可能很有用,但我們建議使用最新版本,以便從持續的改進和安全性更新中受益。
cargo add <crate_name>@<version_number>
例如:
cargo add azure_storage_blob@0.20.0
您也可以在檔案中 Cargo.toml 指定版本需求。 如需版本需求語法的詳細資訊,請參閱 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 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 = "0.17", features = ["<feature_name_1>", "<feature_name_2>"] }
其他資源
- Crates.io 上的 Azure SDK 箱 - 可用的 Azure SDK 箱清單
- Azure SDK 設計指導方針 - 設計原則和模式
- 適用於 Rust GitHub 存放庫的 Azure SDK - 問題和原始程式碼
- 貨物文件 - 完整的貨物參考