通过

安装 Azure SDK for Rust 箱

使用 Azure SDK for Rust，可以通过使用 Cargo 安装单个 SDK 箱来访问 Rust 项目中的 Azure 服务。 本文介绍如何安装、更新和管理用于 Rust 的 Azure SDK 箱，以便仅添加所需的功能，并使项目保持最新。

使用箱进行开发的先决条件

小窍门

为获得最佳开发体验，请确保已安装最新的稳定版本的 Rust。

安装最新的 Azure SDK 箱版本

从 crates.io 获取 Azure SDK 箱。 安装所需的单个箱。

cargo add <crate_name>

替换为 <crate_name> 要安装的 Azure 箱的名称。 例如，若要安装 Azure 标识和 Key Vault 机密箱，请执行以下作：

cargo add azure_identity azure_security_keyvault_secrets

可以在 Azure 的箱索引中找到可用的箱名称。

安装特定的 Azure SDK 箱版本

有时需要安装 特定版本的箱 ，以便进行兼容性测试，或在整个环境中保持一致性。 指定版本时，将 固定 依赖项。 你的项目继续使用该版本，不会自动接收主要或次要更新，但它仍然可以接收修补程序更新。 虽然固定在某些方案中可能很有用，但我们建议使用最新版本来受益于正在进行的改进和安全更新。

cargo add <crate_name>@<version_number>

例如：

cargo add azure_storage_blob@0.20.0

还可以在 Cargo.toml 文件中指定版本要求。 有关版本要求语法的详细信息，请参阅 Rust 文档。

更新 Azure SDK 箱

若要将所有箱更新为其最新兼容版本，请运行：

cargo update

若要更新特定箱，请运行：

cargo update <crate_name>

删除特定的 Azure SDK 箱

若要从项目中删除箱（包括 Cargo.toml 该文件），请运行：

cargo remove <crate_name>

生成项目以更新 Cargo.lock 文件：

cargo build

配置 Azure SDK 箱功能

azure_core箱为所有 Azure SDK 箱提供功能，例如：

  • reqwest：HTTP 客户端实现。
  • tokio：异步运行时支持。

添加箱时启用 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>"] }

其他资源