此存储库用于积极开发 Azure SDK for Java。对于 SDK 的使用者,我们建议访问我们的公共开发人员文档或我们的版本化开发人员文档。
要开始使用特定服务库,请参阅位于库项目文件夹中的README.md文件。您可以在/sdk
目录中找到服务库。要获取我们支持的所有服务的列表,请访问我们所有现有图书馆的列表。
有关教程、示例、快速入门和其他文档,请访问面向 Java 开发人员的 Azure。
所有库都以 Java 8 为基准,并提供测试和转发支持,直至最新的 Java 长期支持版本(当前为 Java 17)。
每个服务都可以有“客户端”和“管理”库。 “客户端”库用于使用服务,而“管理”库用于配置和管理服务。
我们的客户端库遵循适用于 Java 的 Azure SDK 设计指南,并共享许多核心功能,例如 HTTP 重试、日志记录、传输协议、身份验证协议等,因此一旦您学会了如何在一个客户端库中使用这些功能,您将知道如何在其他客户端库中使用它们。您可以在此处了解这些共享功能。这些库可以通过以azure-
开头的文件夹、包和命名空间名称轻松识别,例如azure-keyvault
。
您可以在我们的页面上找到所有新软件包的最新列表。此列表包括最新版本:稳定版和测试版。
注意:如果您需要确保您的代码已准备好用于生产,请使用稳定的非测试版库之一。
与我们的客户端库类似,管理库遵循适用于 Java 的 Azure SDK 设计指南。这些库提供了用于管理Azure 资源的高级、面向对象的 API,并针对易用性、简洁性和一致性进行了优化。您可以在此页面上找到管理库的列表。
有关如何使用 Azure 资源管理的新库的一般文档,请访问此处。我们还准备了大量的代码示例以及迁移指南,以便您从以前的版本升级。
管理库可以通过以azure-resourcemanager
开头的命名空间来标识,例如azure-resourcemanager-compute
。
请注意,来自 Microsoft 的最新库位于com.azure
Maven 组 ID 中,并且具有以com.azure
开头的包命名模式。如果您使用的是com.microsoft.azure
Maven 组 ID 中的库,或者将此作为包结构,请考虑迁移到最新的库。您可以在此处找到这些历史版本与其等效版本的映射表。
azure-java-sdk
标签在 StackOverflow 上检查以前的问题或提出新问题。 主分支具有最新的代码,具有新功能和错误修复。它并不代表最新发布的稳定SDK。
对于我们发布的每个包,都会创建一个唯一的 git 标签,其中包含包的名称和版本,以标记生成包的代码的提交。该标签将用于通过修补程序分支进行服务以及调试特定测试版或稳定发布版本的代码。发布标签的格式为<package-name>_<package-version>
。欲了解更多信息,请参阅我们的分支策略。
有关对此存储库做出贡献的详细信息,请参阅贡献指南。
该项目欢迎贡献和建议。大多数贡献都要求您同意贡献者许可协议 (CLA),声明您有权并且实际上授予我们使用您的贡献的权利。详细信息请查看微软的CLA。
当您提交拉取请求时,CLA-bot 将自动确定您是否需要提供 CLA 并适当地装饰 PR(例如标签、评论)。只需按照机器人提供的说明进行操作即可。您只需使用我们的 CLA 在所有存储库中执行一次此操作。
该项目采用了微软开源行为准则。有关详细信息,请参阅行为准则常见问题解答或联系 [email protected] 提出任何其他问题或意见。
世界各地的许多人都帮助使这个项目变得更好。您需要查看:
安全问题和错误应通过电子邮件私下报告给 Microsoft 安全响应中心 (MSRC) [email protected]。您应该会在 24 小时内收到回复。如果由于某种原因您没有这样做,请通过电子邮件跟进,以确保我们收到您的原始消息。可以在安全技术中心找到更多信息,包括 MSRC PGP 密钥。
Azure SDK for Java 根据 MIT 许可证获得许可。