Начало работы с пакетом SDK Azure и Gradle

Статья
01/20/2025

В этой статье показано, как использовать Gradle для создания приложений с помощью пакета SDK Azure для Java. В этой статье описано, как настроить новый проект с помощью Gradle, создать проекты с помощью Gradle и использовать собственные средства образов GraalVM для создания собственных двоичных файлов для конкретной платформы.

Необходимые условия

комплект средств разработки Javaверсии 8 или более поздней. Мы рекомендуем версию 17 для оптимального опыта.
Gradle

Создание проекта Gradle

В отличие от Maven, Gradle не имеет системы для инициализации проектов на основе шаблона. Инициализация проекта Gradle возможна, но она не настраивает такие особенности SDK Azure для Java, как эквивалент Maven. Чтобы выполнить действия, сначала выполните следующую команду, чтобы создать новый пустой каталог из командной строки:

gradle init --type java-application

Вам будет предложено ответить на короткий ряд вопросов, после чего у вас есть каталог, содержащий коллекцию файлов и подкаталогов. Чтобы убедиться, что созданные файлы компилируются, выполните следующие команды, необходимые для проверки сборки:

gradle clean assemble test

Теперь вы можете перейти к редактированию файла build.gradle, расположенного в каталоге приложения. Для начала, чтобы упростить управление версиями зависимостей, команда Azure SDK для Java публикует пакет SDK Azure для клиента Java каждый месяц. Этот файл BOM включает все доступные пакеты Azure SDK для Java с совместимыми версиями зависимостей.

Чтобы использовать версии зависимостей для клиентской библиотеки SDK Azure для Java, которая находится в BOM, добавьте следующий фрагмент в файл build.gradle. Замените заполнитель {bom_version_to_target}последним выпуском пакета SDK Azure для Java BOM.

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

Все выпуски клиентского BOM Azure SDK для Java можно найти на azure-sdk-bom. Мы рекомендуем использовать последнюю версию, чтобы воспользоваться новейшими функциями клиентских библиотек пакета SDK Azure для Java.

Как только вы начнете полагаться на SDK Azure для Java BOM, вы сможете включать зависимости от библиотек без указания их версии. Эти значения версий автоматически отображаются в пакете SDK Azure для Java BOM. Например, чтобы включить зависимость azure-storage-blob, добавьте следующие строки в файл build.gradle:

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

Использование Gradle для определения зависимостей проекта может упростить управление проектами. Благодаря Azure SDK BOM вы можете ускорить свой проект, повышая уверенность в управлении версиями зависимостей в долгосрочной перспективе. Мы рекомендуем использовать BOM для поддержания соответствия зависимостей и актуальности.

Добавление пакета, не указанного в спецификации материалов

Пакет SDK Azure для клиента Java включает только библиотеки общедоступной версии. Если вы хотите зависеть от пакета, который по-прежнему находится в бета-версии или от версии библиотеки, отличной от версии, включенной в BOM, можно указать версию зависимости Maven вместе с groupId и artifactId в разделе зависимостей. Можно выбрать зависимости, использующие версии 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'
}

Если вы используете этот подход и задаете версии непосредственно в проекте, могут возникнуть конфликты версий зависимостей. Эти конфликты возникают, так как разные пакеты могут зависеть от разных версий распространенных зависимостей, и эти версии могут быть несовместимы друг с другом. При возникновении конфликтов можно столкнуться с нежелательным поведением во время компиляции или во время выполнения. Рекомендуется полагаться на версии, которые находятся в BOM пакета SDK Azure, если это не необходимо. Дополнительные сведения о работе с зависимостями при использовании пакета SDK Azure для Java см. в статье Устранение конфликтов версий зависимостей.

Создание собственного образа с помощью GraalVM

Вы можете использовать GraalVM для создания собственного образа приложения Java. GraalVM компилирует код Java заранее в машинный код, что может повысить производительность в определенных ситуациях. Пакет SDK Azure для Java предоставляет необходимые метаданные в каждой из клиентских библиотек для поддержки компиляции собственных образов GraalVM.

Чтобы приступить к работе, необходимо установить GraalVM и подготовить систему разработки для компиляции собственных образов. Процесс установки GraalVM прост, и документация по GraalVM содержит пошаговые инструкции по установке установке GraalVM и с помощью GraalVM для установкимашинного образа. Следуйте разделу «Предварительные требования», чтобы установить необходимые родные компиляторы для вашей операционной системы.

Используя ваш существующий проект на базе Gradle, следуйте инструкциям GraalVM для Gradle о том, как добавить поддержку GraalVM в ваш проект. При этом у вас есть дополнительные параметры сборки, что позволяет компилировать приложение в стандартный байт-код Java или в собственный образ, скомпилированный GraalVM.

Затем вы готовы выполнить сборку собственного образа. Для использования собственного образа GraalVM можно использовать стандартные средства Gradle. Для Gradle используйте следующую команду:

gradle nativeCompile

После выполнения этой команды GraalVM выводит собственный исполняемый файл для платформы, на которой он работает. Исполняемый файл отображается в каталоге Gradle /app/build/native/nativeCompile проекта. Теперь вы можете запустить приложение с этим исполняемым файлом, и он должен выполняться аналогично стандартному приложению Java.

Дальнейшие действия

Начало работы с расширениями Azure для IntelliJ и Eclipse

Поделиться через