安装 Azure SDK for Rust crate

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

使用 crate 开发的先决条件

小窍门

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

安装最新版本的 Azure SDK crate

从 crates.io 获取 Azure SDK crate。 安装你需要的各个 crate。

cargo add <crate_name>

将 <crate_name> 替换为你要安装的 Azure crate 的名称。 例如，要安装 Azure Identity 和 密钥保管库 机密 crate：

cargo add azure_identity azure_security_keyvault_secrets

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

安装特定版本的 Azure SDK crate

有时，您可能需要安装特定版本的 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

要从项目中移除 crate（包括 Cargo.toml 文件），请运行：

cargo remove <crate_name>

构建项目以更新您的 Cargo.lock 文件：

cargo build

配置 Azure SDK crate 功能

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

  • 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>"] }

其他资源

  • Last updated on