安装 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。

Rust 箱版本的最新Azure SDK是该箱的最新稳定 1.x 版本。

cargo add <crate_name>

<crate_name> 替换为你要安装的 Azure crate 的名称。 例如,若要安装当前的稳定Azure标识和密钥保管库机密箱:

cargo add azure_identity azure_security_keyvault_secrets

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

Important

将稳定 1.x Azure SDK用于生产工作负荷的 Rust 箱版本。 预览版和 beta 版适用于某些箱,但 cargo add <crate_name> 默认情况下会解析为最新的稳定版本。

安装特定版本的 Azure SDK 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

要从项目中移除 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 = "1", features = ["<feature_name_1>", "<feature_name_2>"] }

其他资源