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. Založení projektu Gradle je možné, ale nezahrnuje konfiguraci konkrétností pro Javu pomocí Azure SDK, jako je tomu u ekvivalentního Maven. 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ém v adresáři aplikace. Aby bylo pro začátek jednodušší správa verzí závislostí, publikuje tým Sady Azure SDK pro Javu klientskou sadu Azure SDK pro Javu každý měsíc. 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 projektu následující fragment kódu souboru build.gradle. 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. Pokud chcete využívat nejnovější funkce sady Azure SDK pro klientské knihovny Java, doporučujeme použít nejnovější verzi.
Jakmile začnete záviset na kusovníku Azure SDK pro Javu, můžete zahrnout knihovny jako závislosti bez zadání jejich verze. Tyto hodnoty verzí se automaticky vyhledávají v Azure SDK pro Java BOM. 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í. Doporučujeme použít kusovník, abyste měli závislosti synchronizované a aktuální.
Zahrnout balíček, který není v kusovníku
Azure SDK pro Java klient BOM obsahuje pouze obecně dostupné knihovny (GA). Pokud chcete záviset na balíčku, který je stále v beta verzi nebo na jiné verzi knihovny, než je ta, která je součástí kusovníku, můžete zadat verzi závislosti Maven spolu s groupId a artifactId v části závislostí. 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í. 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 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 můžete postupovat podle pokynů pro GraalVM pro Gradle o tom, 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 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ě.