通过

Azure SDK 和 Gradle 入门

  • 项目

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

先决条件

创建新的 Gradle 项目

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

gradle init --type java-application

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

gradle clean assemble test

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

若要对 BOM 中的 Azure SDK for Java 客户端库使用依赖项版本，请在项目 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 客户端库的最新功能。

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

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

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

在 BOM 中不包含包

用于 Java 的 Azure SDK 客户端 BOM 仅包括正式版（GA）库。 如果要依赖于仍处于 beta 版本或库版本的包，而不是 BOM 中包含的包，可以指定 Maven 依赖项版本以及groupIdartifactId依赖项部分。 可以选择将 BOM 版本和依赖项用于同一项目 POM 文件中重写版本的依赖项，如以下示例所示：

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 扩展入门