使用 Azure SDK for Rust,可以通过使用 Cargo 安装单个 SDK 箱来访问 Rust 项目中的 Azure 服务。 本文介绍如何安装、更新和管理用于 Rust 的 Azure SDK 箱,以便仅添加所需的功能,并使项目保持最新。
使用 crate 开发的先决条件
- Rust 1.85.0 或更高版本。 版本在 Azure SDK for Rust Cargo.toml 中指定。
- 一份 Azure 订阅。 可以免费创建一个帐户。
小窍门
为获得最佳开发体验,请确保已安装最新的稳定版本的 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>"] }
其他资源
- Crates.io 上的 Azure SDK 箱 - 可用 Azure SDK 箱列表
- Azure SDK 设计指南 - 设计原则和模式
- Azure SDK for Rust GitHub 存储库 - 问题和源代码
- Cargo 文档 - 完整的 Cargo 参考文档