Kom igång med Azure SDK och Gradle
Den här artikeln visar hur du använder Gradle för att skapa program med Azure SDK 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
- Java Developer Kit, version 8 eller senare. Vi rekommenderar version 17 för bästa möjliga upplevelse.
- Gradle
Skapa ett nytt Gradle-projekt
Till skillnad från Maven har Gradle inget arketypsystem för bootstrappingprojekt på ett mallsätt. Det är möjligt att starta ett Gradle-projekt, men det konfigurerar inte Azure SDK för Java-detaljer 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 serie frågor, varefter du har 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 hantering av beroendeversion enklare publicerar Azure SDK för Java-teamet Azure SDK för Java-klientstruktur varje månad. Den här BOM-filen innehåller alla Allmänt tillgängliga Azure SDK för Java-klientpaket med sin kompatibla beroendeversion.
Om du vill använda beroendeversioner för ett Azure SDK för Java-klientbiblioteket som finns i bommen inkluderar du följande kodfragment i filen project build.gradle . {bom_version_to_target} Ersätt platshållaren med den senaste versionen av Azure SDK för Java BOM.
dependencies {
implementation platform('com.azure:azure-sdk-bom:{bom_version_to_target}')
}
Du hittar alla versioner av Azure SDK för Java-klientstrukturen på azure-sdk-bom. Vi rekommenderar att du använder den senaste versionen för att dra nytta av de senaste funktionerna i Azure SDK för Java-klientbibliotek.
När du har startat beroende på Azure SDK för Java BOM kan du inkludera beroenden för bibliotek utan att ange deras version. Dessa versionsvärden söks upp automatiskt i Azure SDK för Java BOM. 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 SDK-strukturlistan kan du påskynda projektet samtidigt som du är mer säker på din beroendeversion på lång sikt. Vi rekommenderar att du använder strukturlistan för att hålla beroenden justerade och uppdaterade.
Inkludera ett paket som inte finns i strukturlistan
Azure SDK för Java-klientstrukturen innehåller endast allmänt tillgängliga bibliotek (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 kan du ange 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 kompileringstid eller körning. Vi rekommenderar att du förlitar dig på versioner som finns i Azure SDK BOM om det inte behövs. Mer information om hur du hanterar beroenden när du använder Azure SDK för Java finns i Felsöka beroendeversionskonflikter.
Skapa en intern avbildning 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 SDK 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 måste du installera GraalVM och förbereda utvecklingssystemet för kompilering av interna avbildningar. Installationsprocessen för GraalVM är enkel och GraalVM-dokumentationen innehåller stegvisa instruktioner för att installera GraalVM och använda GraalVM för att installera intern avbildning. Följ kraven noggrant för att installera nödvändiga interna kompilatorer för operativsystemet.
Med ditt befintliga Gradle-baserade projekt kan du följa GraalVM-instruktionerna för Gradle om hur du lägger till GraalVM-stöd i projektet. På så sätt har du fler byggalternativ, så att du kan kompilera ditt program till java-standardbytekoden eller till en inbyggd avbildning som kompilerats av GraalVM.
Nu är du redo att köra en inbyggd avbildningsversion. Du kan använda Standard Gradle-verktyg för att använda GraalVM-intern avbildning. 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.