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

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

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

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

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

gradle init --type java-application

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

gradle clean assemble test

Теперь вы можете перейти к редактированию файла build.gradle, расположенного в каталоге приложения. Чтобы упростить управление версиями зависимостей, команда Azure SDK for Java ежемесячно публикует клиентский BOM Azure SDK для 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. Используйте последнюю версию, чтобы воспользоваться новейшими функциями Azure SDK для клиентских библиотек Java.

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

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

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

Включение пакета, который не входит в BOM

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

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

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

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

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

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

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

gradle nativeCompile

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

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

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

  • Last updated on