Azure SDK 和 Gradle 入门

项目
02/14/2025

本文介绍如何使用 Gradle 通过 Azure SDK for Java 生成应用程序。在本文中，你将使用 Gradle 设置一个新项目，使用 Gradle 生成项目，并使用 GraalVM 本机映像工具创建特定于平台的本机二进制文件。

先决条件

Java 开发人员工具包 (JDK)，版本 8 或更高版本。建议使用版本 17 以获得最佳体验。
Gradle

创建新的 Gradle 项目

与 Maven 不同，Gradle 没有用于以模板方式启动项目的原型系统。可以启动 Gradle 项目，但它不会配置适用于 Java 特性的 Azure SDK，如 Maven 等效项。若要完成这些步骤，请先使用以下命令从命令行创建新的空目录：

gradle init --type java-application

系统会提示你回答一系列简短的问题，之后你有一个包含文件和子目录集合的目录。若要确保生成的文件编译，请运行以下命令来验证生成：

gradle clean assemble test

现在可以继续编辑位于应用目录中的 build.gradle 文件。对于初学者，为了简化依赖项版本管理，Azure SDK for Java 团队每月发布 Azure SDK for Java 客户端 BOM。此 BOM 文件包含所有正式版 Azure SDK for Java 客户端包及其兼容的依赖项版本。

若要对 BOM 中的 Azure SDK for Java 客户端库使用依赖项版本，请在 project build.gradle 文件中包含以下代码片段。将 {bom_version_to_target} 占位符替换为 Azure SDK for Java BOM 的最新版本。

dependencies {
    implementation platform('com.azure:azure-sdk-bom:{bom_version_to_target}')
}

你可以在 azure-sdk-bom找到 Java 客户端 Azure SDK BOM 的所有版本。建议使用最新版本来利用 Azure SDK for Java 客户端库的最新功能。

启动依赖 Azure SDK for Java BOM 后，您可以不指定版本的情况下添加对库的依赖项。这些版本值会在 Azure SDK for Java BOM 中被自动查找。例如，若要包含 azure-storage-blob 依赖项，请将以下行添加到 build.gradle 文件中：

dependencies {
    implementation 'com.azure:azure-storage-blob'
}

使用 Gradle 定义项目依赖项可以使管理项目更简单。使用 Azure SDK BOM，可以加速项目，同时对长期依赖项版本控制更有信心。建议使用 BOM 使依赖项保持一致且保持最新。

包含不在 BOM 内的包

Azure SDK for Java 客户端 BOM 仅包括正式版 (GA) 库。如果要依赖于仍处于 beta 版本的包或库版本与 BOM 中包含的包不同，可以指定 Maven 依赖项版本以及依赖项部分中的 groupId 和 artifactId。您可以选择在同一项目的 POM 文件中使用两种类型的依赖项：一种是使用 BOM 版本的依赖项，另一种是重写版本的依赖项，如以下示例所示：

dependencies {
    // Use the dependency version that is in the BOM
    implementation 'com.azure:azure-messaging-eventhubs'

    // Override the Service Bus dependency version specified in the BOM
    implementation 'com.azure:azure-messaging-servicebus:7.4.0'
}

如果使用此方法并直接在项目中指定版本，则可能会收到依赖项版本冲突。出现这些冲突的原因是不同的包可能依赖于不同版本的常见依赖项，并且这些版本可能彼此不兼容。冲突出现时，您可能会在编译时或运行时遇到不良行为。建议依赖 Azure SDK BOM 中的版本，除非有必要。有关使用 Azure SDK for Java 时处理依赖项的详细信息，请参阅排查依赖项版本冲突。

使用 GraalVM 构建本机映像

可以使用 GraalVM 创建 Java 应用程序的本机映像。 GraalVM 提前将 Java 代码编译为本机计算机代码，在某些情况下可能会带来巨大的性能提升。用于 Java 的 Azure SDK 在其每个客户端库中提供必要的元数据来支持 GraalVM 原生映像编译。

要开始，需要安装 GraalVM 并准备开发系统以编译原生镜像。 GraalVM 的安装过程非常简单，GraalVM 文档提供了有关安装 GraalVM 并使用 GraalVM 安装本机映像的分步说明和。请仔细按照先决条件部分安装操作系统所需的本机编译器。

使用基于 Gradle 的现有项目，可以按照用于 Gradle 的 GraalVM 说明，了解如何向项目添加 GraalVM 支持。这样，便可以使用更多构建选项，从而将应用程序编译成标准的 Java 字节码，或者使用 GraalVM 编译的本机映像。

接下来，可以运行本机映像生成。可以使用标准的 Gradle 工具来利用 GraalVM 本机映像。对于 Gradle，请使用以下命令：

gradle nativeCompile

运行此命令后，GraalVM 会输出一个针对所运行平台的本地可执行文件。可执行文件显示在项目的 Gradle /app/build/native/nativeCompile 目录中。现在，可以使用此可执行文件运行应用程序，它应执行与标准 Java 应用程序类似的操作。

后续步骤

开始使用 IntelliJ 和 Eclipse 的 Azure 扩展

通过