Bien démarrer avec le Kit de développement logiciel (SDK) Azure et Gradle

Cet article explique comment utiliser Gradle pour générer des applications avec le Kit de développement logiciel (SDK) Azure pour Java. Dans cet article, vous allez configurer un nouveau projet avec Gradle, générer des projets avec Gradle et utiliser les outils d’images natives GraalVM pour créer des fichiers binaires natifs spécifiques à la plateforme.

Conditions préalables

• Kit de développement Java, version 8 ou ultérieure. Pour une expérience optimale, utilisez la version 17.
• Gradle

Créer un projet Gradle

Contrairement à Maven, Gradle ne dispose pas d'un système d'archétype pour créer des projets de manière modulaire. Vous pouvez initialiser un projet Gradle, mais il ne configure pas les éléments spécifiques du SDK Azure pour Java, contrairement à l'équivalent Maven. Pour parcourir les étapes, utilisez d’abord la commande suivante pour créer un répertoire vide à partir de la ligne de commande :

gradle init --type java-application

Vous êtes invité à répondre à une courte série de questions. Une fois que vous avez terminé, vous disposez d’un répertoire contenant une collection de fichiers et de sous-répertoires. Pour vous assurer que les fichiers générés sont compilés, exécutez les commandes suivantes requises pour vérifier la build :

gradle clean assemble test

Vous pouvez maintenant passer à la modification du fichier build.gradle situé dans le répertoire de l’application. Pour simplifier la gestion des versions des dépendances, l’équipe Kit de développement logiciel (SDK) Azure pour Java publie le Kit de développement logiciel (SDK) Azure for Java client BOM chaque mois. Ce fichier BOM inclut tous les packages client SDK Azure pour Java disponibles en disponibilité générale (GA) avec leur version de dépendance compatible.

Pour utiliser des versions de dépendance d'une bibliothèque cliente Kit de développement logiciel (SDK) Azure pour Java qui se trouve dans le BOM, incluez l'extrait de code suivant dans le fichier build.gradle du projet . Remplacez le placeholder {bom_version_to_target} par la dernière version du BOM du client Kit de développement logiciel (SDK) Azure pour Java.

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

Vous trouverez toutes les versions du Kit de développement logiciel (SDK) Azure pour Java client BOM sur azure-sdk-bom. Utilisez la dernière version pour tirer parti des fonctionnalités les plus récentes de la Kit de développement logiciel (SDK) Azure pour Java bibliothèques clientes.

Une fois que vous avez démarré en fonction de la Kit de développement logiciel (SDK) Azure pour Java BOM, vous pouvez inclure des dépendances sur les bibliothèques sans spécifier leur version. Le Kit de développement logiciel (SDK) Azure pour Java BOM fournit automatiquement ces valeurs de version. Par exemple, pour inclure une dépendance azure-storage-blob, ajoutez les lignes suivantes à votre fichier build.gradle :

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

L’utilisation de Gradle pour définir des dépendances de projet peut simplifier la gestion de vos projets. Avec le BOM du Kit de développement logiciel (SDK) Azure, vous pouvez accélérer votre projet tout en étant plus sûr de votre gestion des versions des dépendances sur le long terme. Utilisez le boM pour maintenir les dépendances alignées et à jour.

Inclure un package qui n’est pas dans le boM

Le BOM du client SDK Azure pour Java inclut uniquement les bibliothèques généralement disponibles (GA). Si vous souhaitez utiliser un package encore en version bêta ou une version de bibliothèque différente de celle incluse dans la BOM, spécifiez la version de la dépendance Maven avec groupId et artifactId dans la section des dépendances. Vous pouvez choisir d’avoir des dépendances qui utilisent des versions boM et des dépendances avec des versions substituées dans le même fichier POM de projet, comme illustré dans l’exemple suivant :

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 vous utilisez cette approche et spécifiez des versions directement dans votre projet, vous pouvez obtenir des conflits de version de dépendance. Ces conflits se produisent, car différents packages peuvent dépendre de différentes versions des dépendances courantes, et ces versions peuvent ne pas être compatibles les unes avec les autres. Lorsque des conflits se produisent, vous pouvez rencontrer un comportement indésirable au moment de la compilation ou au moment de l’exécution. Reposez sur les versions qui se trouvent dans le Kit de développement logiciel (SDK) Azure BOM, sauf si nécessaire. Pour plus d’informations sur la gestion des dépendances lors de l’utilisation du Kit de développement logiciel (SDK) Azure pour Java, consultez Résoudre les conflits de version des dépendances.

Créer une image native avec GraalVM

Vous pouvez utiliser GraalVM pour créer une image native d’une application Java. GraalVM compile le code Java à l’avance dans du code machine natif, ce qui peut générer des gains de performances spectaculaires dans certaines situations. Le Kit de développement logiciel (SDK) Azure pour Java fournit les métadonnées nécessaires dans chacune de ses bibliothèques clientes pour prendre en charge la compilation d’images natives GraalVM.

Pour commencer, installez GraalVM et préparez votre système de développement pour la compilation d’images natives. Le processus d’installation de GraalVM est simple, et la documentation de GraalVM fournit des instructions détaillées pour installer GraalVM et utiliser GraalVM pour installer native-image. Suivez attentivement la section prérequis pour installer les compilateurs natifs nécessaires pour votre système d'exploitation.

Avec votre projet Gradle existant, suivez les instructions GraalVM pour Gradle sur l’ajout de la prise en charge de GraalVM à votre projet. En procédant à cette étape, vous obtenez davantage d’options de génération, afin de pouvoir compiler votre application dans le code bytecode standard Java ou dans une image native compilée par GraalVM.

Ensuite, vous êtes prêt à exécuter la construction d’une image native. Vous pouvez utiliser des outils Gradle standard pour utiliser l’image native GraalVM. Pour Gradle, utilisez la commande suivante :

gradle nativeCompile

Après avoir exécuté cette commande, GraalVM génère un exécutable natif pour la plateforme sur laquelle il s’exécute. L’exécutable apparaît dans le répertoire Gradle /app/build/native/nativeCompile de votre projet. Vous pouvez maintenant exécuter votre application avec ce fichier exécutable, et elle doit s’effectuer de la même façon qu’une application Java standard.

Étapes suivantes