Kom igång med Azure SDKs och Gradle

Den här artikeln visar hur du använder Gradle för att skapa program med Azure SDKs för Java. I den här artikeln konfigurerar du ett nytt projekt med Gradle, skapar projekt med Gradle och använder graalVM-verktyget för interna avbildningar för att skapa plattformsspecifika interna binärfiler.

Förutsättningar

Skapa ett nytt Gradle-projekt

Till skillnad från Maven har Gradle inget arketypsystem för bootstrapping av projekt i en mallliknande stil. Du kan generera ett Gradle-projekt, men det konfigurerar inte Java-specifika inställningar för Azure SDKs på samma sätt som Maven-motsvarigheten. Om du vill gå igenom stegen använder du först följande kommando för att skapa en ny, tom katalog från kommandoraden:

gradle init --type java-application

Du uppmanas att svara på en kort rad frågor. När du är klar har du en katalog som innehåller en samling filer och underkataloger. Kontrollera att de genererade filerna kompileras genom att köra följande kommandon som krävs för att verifiera bygget:

gradle clean assemble test

Nu kan du gå vidare till att redigera filen build.gradle som finns i appkatalogen. För att göra versionshanteringen av beroenden enklare publicerar Azure SDKs för Java-teamet varje månad Azure SDKs för Java-klientbibliotekens BOM. Den här BOM-filen innehåller alla Allmänt tillgängliga Azure SDKs för Java-klientpaket med sin kompatibla beroendeversion.

För att använda beroendeversioner för ett Azure SDKs för Java-klientbibliotek som finns i BOM, inkludera följande kodfragment i filen project build.gradle. Ersätt platshållaren {bom_version_to_target} med den senaste versionen av Azure SDKs för Java BOM.

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

Du hittar alla versioner av Azure SDKs för Java-klienten i BOM på azure-sdk-bom. Använd den senaste versionen för att dra nytta av de senaste funktionerna i Azure SDKs för Java klientbibliotek.

När du börjar använda Azure SDKs for Java BOM kan du inkludera biblioteksberoenden utan att ange någon version. Azure SDKs för Java bom innehåller automatiskt dessa versionsvärden. Om du till exempel vill inkludera ett azure-storage-blob beroende lägger du till följande rader i filen build.gradle:

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

Att använda Gradle för att definiera projektberoenden kan göra det enklare att hantera dina projekt. Med Azure SDKs BOM kan du påskynda ditt projekt och vara mer säker på din beroendehantering av versioner i det långa loppet. Använd BOM för att hålla beroenden samordnade och uppdaterade.

Inkludera ett paket som inte finns med i BOM

Azure SDKs BOM för Java-klienter innehåller endast bibliotek som är allmänt tillgängliga (GA). Om du vill vara beroende av ett paket som fortfarande är i betaversion eller på en annan biblioteksversion än den som ingår i strukturlistan anger du Maven-beroendeversionen tillsammans med groupId och artifactId i beroendeavsnittet. Du kan välja att ha beroenden som använder BOM-versioner och beroenden med åsidosatta versioner i samma PROJEKT POM-fil, som du ser i följande exempel:

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

Om du använder den här metoden och anger versioner direkt i projektet kan du få konflikter i beroendeversioner. Dessa konflikter uppstår eftersom olika paket kan vara beroende av olika versioner av vanliga beroenden och dessa versioner kanske inte är kompatibla med varandra. När konflikter uppstår kan du uppleva oönskat beteende vid kompilering eller körning. Använd versioner som ingår i Azure SDKs BOM om det inte är nödvändigt att använda andra. Mer information om hur du hanterar beroenden när du använder Azure SDKs för Java finns i Felsöka beroendeversionskonflikter.

Skapa en inbyggd bild med GraalVM

Du kan använda GraalVM för att skapa en intern avbildning av ett Java-program. GraalVM kompilerar Java-koden i förväg till inbyggd datorkod, vilket kan ge drastiska prestandavinster i vissa situationer. Azure SDKs för Java tillhandahåller nödvändiga metadata i vart och ett av sina klientbibliotek för att stödja GraalVM-intern bildkompilering.

För att komma igång, installera GraalVM och förbered ditt utvecklingssystem för kompilering av nativa avbildningar. Installationsprocessen för GraalVM är okomplicerad, och GraalVM-dokumentationen innehåller stegvisa instruktioner för installation av GraalVM och att använda GraalVM för att installera native-image. Följ avsnittet förutsättningar noggrant för att installera nödvändiga interna kompilatorer för operativsystemet.

Med ditt befintliga Gradle-baserade projekt följer du GraalVM-instruktionerna för Gradle om hur du lägger till GraalVM-stöd i projektet. Genom att göra det här steget får du fler byggalternativ, så att du kan kompilera ditt program till standard-Java bytekod eller till en intern avbildning som kompilerats av GraalVM.

Nu är du redo att köra en infödd bildkompilering. Du kan använda standard Gradle-verktyg för att använda GraalVM native image. Använd följande kommando för Gradle:

gradle nativeCompile

När du har kört det här kommandot matar GraalVM ut en intern körbar fil för den plattform som den körs på. Den körbara filen visas i katalogen Gradle /app/build/native/nativeCompile i projektet. Nu kan du köra ditt program med den här körbara filen och den bör fungera på samma sätt som ett Java-standardprogram.

Nästa steg

Kom igång med Azure-tillägg för IntelliJ och Eclipse

  • Last updated on