Začínáme se sadou Azure SDK a Gradle

V tomto článku se dozvíte, jak pomocí Gradle vytvářet aplikace pomocí sady Azure SDK pro Javu. V tomto článku nastavíte nový projekt s Gradle, sestavíte projekty s Gradlem a použijete nástroje nativní bitové kopie GraalVM k vytvoření nativních binárních souborů specifických pro platformu.

Požadavky

Vytvoření nového projektu Gradle

Na rozdíl od Mavenu nemá Gradle archetypový systém pro spouštění projektů způsobem šablony. Projekt Gradle můžete spustit, ale nenakonfiguruje Azure SDK pro Java specifika, jako je ekvivalent Mavenu. Pokud chcete tyto kroky projít, nejprve pomocí následujícího příkazu vytvořte nový prázdný adresář z příkazového řádku:

gradle init --type java-application

Zobrazí se výzva, abyste odpověděli na krátkou řadu otázek. Po dokončení máte adresář obsahující kolekci souborů a podadresářů. Pokud chcete zajistit kompilaci vygenerovaných souborů, spusťte následující příkazy potřebné k ověření sestavení:

gradle clean assemble test

Teď můžete přejít k úpravám souboru build.gradle umístěném v adresáři aplikace. Aby byla správa verzí závislostí jednodušší, tým Azure SDK pro Javu každý měsíc publikuje Azure SDK for Java client BOM. Tento soubor BOM obsahuje všechny obecně dostupné sady Azure SDK (GA) pro klientské balíčky Java s jejich kompatibilní verzí závislostí.

Pokud chcete použít verze závislostí pro klientskou knihovnu sady Azure SDK pro Javu, která je v BOM, vložte do souboru projektu build.gradle následující úryvek. Zástupný symbol {bom_version_to_target} nahraďte nejnovější verzí Azure SDK pro Java BOM.

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

Všechny verze klientského BOM Azure SDK pro Javu najdete v azure-sdk-bom. Využijte nejnovější verzi a využijte nejnovější funkce Azure SDK pro klientské knihovny Java.

Jakmile začnete používat Azure SDK pro Java BOM, můžete zahrnout závislosti knihoven bez zadání jejich verze. Azure SDK for Java BOM automaticky poskytuje tyto hodnoty verzí. Pokud chcete například zahrnout azure-storage-blob závislost, přidejte do souboru build.gradle následující řádky:

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

Použití Gradle k definování závislostí projektu může zjednodušit správu projektů. Pomocí Azure SDK BOM můžete projekt urychlit a zároveň mít větší jistotu v dlouhodobém horizontu ohledně verzionování závislostí. Pomocí BOM udržíte závislosti sladěné a aktuální.

Zahrnout balík, který není v kusovníku

Azure SDK pro Java – klientský BOM zahrnuje pouze knihovny v obecné dostupnosti (GA). Pokud chcete použít jako závislost balíček, který je stále ve fázi beta, nebo verzi knihovny odlišnou od té, která je zahrnuta v BOM, zadejte v části závislostí verzi závislosti Maven spolu s groupId a artifactId. Můžete se rozhodnout mít závislosti, které používají verze správy závislostí (BOM), a závislosti s přebitými verzemi ve stejném souboru POM projektu, jak je znázorněno v následujícím příkladu:

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

Pokud použijete tento přístup a zadáte verze přímo v projektu, může dojít ke konfliktům verzí závislostí. K těmto konfliktům dochází, protože různé balíčky můžou záviset na různých verzích běžných závislostí a tyto verze nemusí být vzájemně kompatibilní. Pokud dojde ke konfliktům, může dojít k nežádoucímu chování v době kompilace nebo za běhu. Spoléhejte na verze uvedené v Azure SDK BOM, pokud to není nutné jinak. Další informace o řešení závislostí při použití sady Azure SDK pro Javu najdete v tématu Řešení konfliktů verzí závislostí.

Vytvoření nativní image pomocí GraalVM

GraalVM můžete použít k vytvoření nativní image aplikace v Javě. GraalVM předem zkompiluje kód Java do nativního strojového kódu, což může v určitých situacích přinést výrazné zvýšení výkonu. Sada Azure SDK pro Javu poskytuje potřebná metadata v každé z jejích klientských knihoven pro podporu kompilace nativních imagí GraalVM.

Začněte tím, že nainstalujete GraalVM a připravíte vývojový systém na kompilaci nativních imagí. Proces instalace pro GraalVM je jednoduchý a dokumentace k GraalVM obsahuje podrobné pokyny pro instalaci GraalVM a pomocí GraalVM k instalaci nativní image. Důkladně si přečtěte sekci požadavků, abyste mohli nainstalovat potřebné nativní kompilátory pro váš operační systém.

Se stávajícím projektem založeným na Gradle postupujte podle pokynů pro GraalVM pro Gradle , jak do projektu přidat podporu GraalVM. Tímto krokem získáte další možnosti sestavení, abyste mohli aplikaci zkompilovat do standardního Java bajtového kódu nebo do nativní bitové kopie kompilované graalVM.

Dále jste připraveni spustit sestavení nativní bitové kopie. K použití nativní image GraalVM můžete použít standardní nástroje Gradle. Pro Gradle použijte následující příkaz:

gradle nativeCompile

Po spuštění tohoto příkazu GraalVM vypíše nativní spustitelný soubor pro platformu, na které běží. Spustitelný soubor se nachází ve složce Gradle /app/build/native/nativeCompile vašeho projektu. Teď můžete spustit aplikaci s tímto spustitelným souborem a měla by fungovat podobně jako standardní aplikace v Javě.

Další kroky

Začínáme s rozšířeními Azure pro IntelliJ a Eclipse

  • Last updated on