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
- Java Developer Kit verze 8 nebo novější. Pro co nejlepší prostředí doporučujeme verzi 17.
- Gradle
Vytvoření nového projektu Gradle
Na rozdíl od Mavenu nemá Gradle archetypový systém pro spouštění projektů způsobem šablony. Spuštění projektu Gradle je možné, ale nenakonfiguruje sadu Azure SDK pro specifika Javy, 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 k zodpovězení krátké řady otázek, po kterých 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ého v adresáři aplikace. Aby byla správa verzí závislostí jednodušší, publikuje sada Azure SDK pro Javu každý měsíc sadu Azure SDK pro klienta Java. 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 Azure SDK pro Javu, která je v kusovníku, vložte do souboru build.gradle projektu následující fragment kódu. {bom_version_to_target} Zástupný symbol nahraďte nejnovější verzí sady Azure SDK pro kusovníky Javy.
dependencies {
implementation platform('com.azure:azure-sdk-bom:{bom_version_to_target}')
}
Všechny verze klientského kusovníku sady Azure SDK pro Javu najdete na bom azure-sdk-bom. Pokud chcete využívat nejnovější funkce sady Azure SDK pro klientské knihovny Java, doporučujeme použít nejnovější verzi.
Jakmile začnete v závislosti na kusovníku Sady Azure SDK pro Javu, můžete zahrnout závislosti na knihovnách bez zadání jejich verze. Tyto hodnoty verzí se automaticky vyhledávají v sadě Azure SDK pro kusovníky Javy. 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í kusovníku sady Azure SDK můžete projekt urychlit a zároveň mít větší jistotu o správě verzí závislostí v dlouhodobém horizontu. Doporučujeme použít kusovník, abyste měli závislosti zarovnané a aktuální.
Zahrnutí balíčku, který není součástí kusovníku
Azure SDK pro klienta Java zahrnuje pouze obecně dostupné knihovny (GA). Pokud chcete záviset na balíčku, který je stále v beta verzi nebo na verzi knihovny, která se liší od verze zahrnuté v kusovníku, můžete společně s groupId částí závislostí a artifactId v části závislostí zadat verzi závislostí Maven. Můžete se rozhodnout mít závislosti, které používají verze kusovníku a závislosti s přepsáný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í. Když dojde ke konfliktům, můžete zaznamenat nežádoucí chování v době kompilace nebo za běhu. Pokud to není nutné, doporučujeme spoléhat se na verze, které jsou v kusovníku sady Azure SDK. 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.
Abyste mohli začít, musíte nainstalovat GraalVM a připravit vývojový systém na kompilaci nativních imagí. Proces instalace pro GraalVM je jednoduchý a dokumentace k GraalVM obsahuje podrobné pokyny k instalaci GraalVM a použití GraalVM k instalaci nativní image. Pečlivě nainstalujte potřebné nativní kompilátory pro váš operační systém podle pokynů v části Požadavky.
Se stávajícím projektem založeným na Gradle můžete postupovat podle pokynů pro GraalVM pro Gradle , jak do projektu přidat podporu GraalVM. Pak máte k dispozici další možnosti sestavení, které vám umožní zkompilovat aplikaci do standardního bajtového kódu Javy nebo do nativní bitové kopie zkompilované 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 zobrazí v adresáři Gradle /app/build/native/nativeCompile projektu. Teď můžete spustit aplikaci s tímto spustitelným souborem a měla by fungovat podobně jako standardní aplikace v Javě.