Azure SDK for Java

此存储库用于 Azure SDK for Java 的主动开发。对于 SDK 的使用者，我们建议访问我们的公共开发人员文档或版本控制的开发人员文档。

开始

若要开始使用特定服务库，请参阅位于库的项目文件夹中的 README.md 文件。你可以在目录中找到服务库。有关我们支持的所有服务的列表，请访问我们所有现有库的列表。

/sdk

有关教程、示例、快速入门和其他文档，请访问适用于 Java 开发人员的 Azure。

先决条件

所有库都以Java 8为基准，直到最新的Java长期支持版本（目前为Java 17）为止，都具有测试和前向支持。

可用软件包

每个服务都可以同时具有“客户端”和“管理”库。“客户端”库用于使用服务，而“管理”库用于配置和管理服务。

客户端库

我们的客户端库遵循适用于 Java 的 Azure SDK 设计指南，并共享许多核心功能，如 HTTP 重试、日志记录、传输协议、身份验证协议等，以便在了解如何在一个客户端库中使用这些功能后，你将了解如何在其他客户端库中使用它们。你可以在此处了解这些共享功能。这些库可以通过以 开头的文件夹、包和命名空间名称轻松识别，例如 。

azure-

azure-keyvault

你可以在我们的页面上找到所有新软件包的最新列表。此列表包括最新版本：稳定版和测试版。

注意：如果你需要确保代码已准备好投入生产使用，请使用稳定的非 beta 库之一。

管理库

与客户端库类似，管理库遵循适用于 Java 的 Azure SDK 设计指南。这些库提供用于管理 Azure 资源的高级面向对象 API，这些资源针对易用性、简洁性和一致性进行了优化。你可以在此页面上找到管理库的列表。

有关如何将新库用于 Azure 资源管理的常规文档，请访问此处。我们还准备了大量的代码示例以及迁移指南，以防你从以前的版本升级。

管理库可以通过以 开头的命名空间来标识，例如 。

azure-resourcemanager

azure-resourcemanager-compute

历史版本

请注意，Microsoft 的最新库位于 Maven 组 ID 中，并且具有以 开头的包命名模式。如果你使用的是 Maven 组 ID 中的库，或者将其作为包结构，请考虑迁移到最新的库。你可以在此处找到从这些历史版本到其等效版本的映射表。

com.azure

com.azure

com.microsoft.azure

需要帮助？

• 有关参考文档，请访问适用于 Java 的 Azure SDK 文档。
• 有关教程、示例、快速入门和其他文档，请访问适用于 Java 开发人员的 Azure。
• 有关代码质量、测试覆盖率等的生成报告，请访问 Azure Java SDK。
• 通过 Github Issues 提交问题。
• 使用标签在StackOverflow上检查以前的问题或提出新问题。

  azure-java-sdk

导航存储库

主分支

主分支具有具有新功能和错误修复的最新代码。它不代表最新发布的稳定 SDK。

发布分支（发布标记）

对于我们发布的每个包，都会创建一个唯一的 git 标记，其中包含包的名称和版本，以标记生成包的代码的提交。此标记将用于通过修补程序分支提供服务，以及调试特定 beta 版或稳定版版本的代码。发布标记的格式为 。有关更多信息，请参阅我们的分支策略。

<package-name>_<package-version>

贡献

有关向此存储库贡献的详细信息，请参阅贡献指南。

本项目欢迎大家投稿和建议。大多数贡献都要求你同意贡献者许可协议（CLA），声明你有权并且实际上确实授予我们使用你的贡献的权利。有关详细信息，请查看微软的CLA。

当你提交拉取请求时，CLA 机器人将自动确定你是否需要提供 CLA 并适当地装饰 PR（例如，标签、注释）。只需按照机器人提供的说明进行操作即可。你只需使用我们的 CLA 在所有存储库中执行此操作一次。

该项目采用了微软开源行为准则。有关更多信息，请参阅行为准则常见问题解答，或就任何其他问题或意见 opencode@microsoft.com 联系。

为贡献者提供的其他有用链接

世界各地的许多人都帮助使这个项目变得更好。你需要查看：

• 对于存储库的新贡献者来说，有哪些好的初始问题？
• 如何构建和测试更改
• 如何实现改变！
• 适用于 Java 的详细 Azure SDK Wiki 中的常见问题 （FAQ） 和概念性主题。

报告安全问题和安全漏洞

安全问题和错误应通过电子邮件私下报告给 Microsoft 安全响应中心 （MSRC） secure@microsoft.com。你应该会在 24 小时内收到回复。如果由于某种原因你没有这样做，请通过电子邮件跟进，以确保我们收到你的原始消息。更多信息，包括 MSRC PGP 密钥，可以在安全技术中心找到。

许可证

Azure SDK for Java 在 MIT 许可证下获得许可。