Introducción al SDK de Azure y Gradle

En este artículo se muestra cómo usar Gradle para compilar aplicaciones con el SDK de Azure para Java. En este artículo, configurará un nuevo proyecto con Gradle, compilará proyectos con Gradle y usará las herramientas de imágenes nativas de GraalVM para crear archivos binarios nativos específicos de la plataforma.

Prerrequisitos

Creación de un nuevo proyecto de Gradle

A diferencia de Maven, Gradle no tiene un sistema de arquetipos para arrancar proyectos de forma de plantilla. Puede inicializar un proyecto de Gradle, pero no configura aspectos específicos del SDK de Azure para Java como el equivalente de Maven. Para realizar los pasos, use primero el siguiente comando para crear un directorio vacío nuevo desde la línea de comandos:

gradle init --type java-application

Se le pedirá que responda a una breve serie de preguntas. Cuando termine, tendrá un directorio que contiene una colección de archivos y subdirectorios. Para asegurarse de que los archivos generados se compilen, ejecute los siguientes comandos necesarios para comprobar la compilación:

gradle clean assemble test

Ahora puede pasar a editar el archivo build.gradle ubicado en el directorio de la aplicación. Para que la administración de versiones de dependencia sea más sencilla, el SDK de Azure del equipo de Java publica el SDK de Azure para Java BOM de cliente cada mes. Este archivo BOM incluye todos los paquetes de cliente de SDK de Azure generalmente disponibles (GA) para Java con su versión de dependencia compatible.

Para usar versiones de dependencia para una biblioteca cliente de SDK de Azure para Java que se encuentra en la lista de materiales, incluya el siguiente fragmento de código en el proyecto archivo build.gradle. Reemplace el {bom_version_to_target} marcador de posición por la versión más reciente del SDK de Azure para el BOM en Java.

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

Puede encontrar todas las versiones del BOM del cliente del SDK de Azure para Java en azure-sdk-bom. Use la versión más reciente para aprovechar las características más recientes de la SDK de Azure para Java bibliotecas cliente.

Una vez que empiece a depender de SDK de Azure for Java BOM, puede incluir dependencias de bibliotecas sin especificar su versión. El SDK de Azure para Java BOM proporciona automáticamente estos valores de versión. Por ejemplo, para incluir una dependencia de azure-storage-blob, agregue las líneas siguientes al archivo build.gradle:

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

El uso de Gradle para definir las dependencias del proyecto puede facilitar la administración de los proyectos. Con el SDK de Azure BOM, puede acelerar su proyecto mientras tiene mayor confianza en el versionado de dependencias a largo plazo. Usa la BOM para mantener las dependencias alineadas y al día.

Incluir un paquete que no está en la lista de materiales

La BOM del SDK de Azure para Java solo incluye bibliotecas de disponibilidad general (GA). Si quiere usar una dependencia de un paquete que aún está en versión beta o una versión de biblioteca distinta de la incluida en la BOM, especifique la versión de la dependencia de Maven junto con groupId y artifactId en la sección de dependencias. Puede elegir tener dependencias que usen versiones de BOM y dependencias con versiones invalidadas en el mismo archivo POM del proyecto, como se muestra en el ejemplo siguiente:

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'
}

Si utiliza este enfoque y especifica directamente las versiones en su proyecto, es posible que obtenga conflictos de versión de dependencia. Estos conflictos surgen porque los distintos paquetes pueden depender de diferentes versiones de dependencias comunes y es posible que estas versiones no sean compatibles entre sí. Cuando se producen conflictos, es posible que experimente un comportamiento no deseado en tiempo de compilación o tiempo de ejecución. Confíe en las versiones que se encuentran en la SDK de Azure BOM a menos que sea necesario. Para obtener más información sobre cómo tratar las dependencias al usar el SDK de Azure para Java, consulte Solución de problemas de conflictos de versiones de dependencia.

Creación de una imagen nativa con GraalVM

Puede usar GraalVM para crear una imagen nativa de una aplicación Java. GraalVM compila el código Java con antelación en código de máquina nativa, lo que puede producir mejoras drásticas en el rendimiento en determinadas situaciones. El SDK de Azure para Java proporciona los metadatos necesarios en cada una de sus bibliotecas cliente para admitir la compilación de imágenes nativas de GraalVM.

Para empezar, instale GraalVM y prepare el sistema de desarrollo para compilar imágenes nativas. El proceso de instalación de GraalVM es sencillo y la documentación de GraalVM proporciona instrucciones paso a paso para instalar GraalVM y mediante GraalVM para instalar imágenes nativas. Siga la sección de requisitos previos cuidadosamente para instalar los compiladores nativos necesarios para el sistema operativo.

Con el proyecto basado en Gradle existente, siga las instrucciones de GraalVM para Gradle sobre cómo agregar compatibilidad con GraalVM al proyecto. Al realizar este paso, obtendrá más opciones de compilación, por lo que puede compilar la aplicación en el código de bytes estándar Java o en una imagen nativa compilada por GraalVM.

A continuación, estará listo para ejecutar una construcción de imagen nativa. Puede usar herramientas de Gradle estándar para usar la imagen nativa de GraalVM. Para Gradle, use el siguiente comando:

gradle nativeCompile

Después de ejecutar este comando, GraalVM genera un archivo ejecutable nativo para la plataforma en la que se ejecuta. El ejecutable aparece en el directorio Gradle /app/build/native/nativeCompile de tu proyecto. Ahora puede ejecutar la aplicación con este archivo ejecutable y debe realizar de forma similar a una aplicación Java estándar.

Pasos siguientes

Introducción a las extensiones de Azure para IntelliJ y Eclipse

  • Last updated on