Wprowadzenie do zestawu Azure SDK i narzędzia Gradle

W tym artykule pokazano, jak używać narzędzia Gradle do tworzenia aplikacji za pomocą zestawu Azure SDK dla języka Java. W tym artykule skonfigurujesz nowy projekt przy użyciu Gradle, zbudujesz projekty za pomocą Gradle i wykorzystasz narzędzia GraalVM do tworzenia specyficznych dla platformy natywnych plików binarnych.

Warunki wstępne

• JDKw wersji 8 lub późniejsza. Zalecamy wersję 17, aby uzyskać najlepsze doświadczenie.
• Gradle

Tworzenie nowego projektu narzędzia Gradle

W przeciwieństwie do narzędzia Maven, narzędzie Gradle nie ma systemu archetypów do rozpoczynania projektów w formie szablonu. Uruchamianie projektu Gradle jest możliwe, ale nie konfiguruje zestawu Azure SDK dla języka Java, takich jak odpowiednik Maven. Aby wykonać kroki, najpierw użyj następującego polecenia, aby utworzyć nowy, pusty katalog z wiersza polecenia:

gradle init --type java-application

Zostanie wyświetlony monit o udzielenie odpowiedzi na krótką serię pytań, po którym masz katalog zawierający kolekcję plików i podkatalogów. Aby upewnić się, że wygenerowany plik jest kompilowany, uruchom następujące polecenia wymagane do zweryfikowania kompilacji:

gradle clean assemble test

Teraz możesz przejść do edytowania pliku build.gradle znajdującego się w katalogu aplikacji. Na początek, aby ułatwić zarządzanie wersjami zależności, zespół Azure SDK dla Java publikuje Azure SDK dla Java Client BOM każdego miesiąca. Ten plik BOM zawiera wszystkie ogólnie dostępne pakiety klienta platformy Azure dla języka Java z zgodną wersją zależności.

Aby użyć wersji zależności dla biblioteki klienta zestawu Azure SDK dla języka Java, która znajduje się w modelu BOM, dołącz następujący fragment kodu w pliku build.gradle projektu. Zastąp symbol {bom_version_to_target} najnowszym wydaniem zestawu Azure SDK dla języka Java BOM.

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

Wszystkie wersje zestawu Azure SDK dla klienta Java BOM można znaleźć na stronie azure-sdk-bom. Zalecamy użycie najnowszej wersji, aby skorzystać z najnowszych funkcji zestawu Azure SDK dla bibliotek klienckich języka Java.

Gdy zaczniesz polegać na Azure SDK dla Java BOM, możesz uwzględniać zależności od bibliotek bez określania ich wersji. Te wartości wersji są automatycznie pobierane w Azure SDK dla BOM języka Java. Aby na przykład uwzględnić zależność azure-storage-blob, dodaj następujące wiersze do pliku build.gradle:

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

Używanie narzędzia Gradle do definiowania zależności projektu może ułatwić zarządzanie projektami. Dzięki modelowi BOM zestawu Azure SDK możesz przyspieszyć projekt, jednocześnie zapewniając większą pewność co do przechowywania wersji zależności w dłuższej perspektywie. Zalecamy używanie modelu BOM, aby zachować wyrównanie zależności i ich aktualność.

Uwzględnij pakiet, który nie znajduje się w modelu BOM

Model BOM klienta zestawu Azure SDK dla języka Java zawiera tylko biblioteki ogólnie dostępne . Jeśli chcesz zależeć od pakietu, który jest nadal w wersji beta lub w wersji biblioteki innej niż ta zawarta w modelu BOM, możesz określić wersję zależności programu Maven wraz z groupId i artifactId w sekcji zależności. Możesz wybrać zależności korzystające z wersji BOM i zależności z zastąpionymi wersjami w tym samym pliku POM projektu, jak pokazano w poniższym przykładzie:

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

Jeśli używasz tej metody i określasz wersje bezpośrednio w projekcie, mogą wystąpić konflikty wersji zależności. Te konflikty występują, ponieważ różne pakiety mogą zależeć od różnych wersji wspólnych zależności, a te wersje mogą nie być ze sobą zgodne. W przypadku wystąpienia konfliktów możesz doświadczyć niepożądanego zachowania w czasie kompilacji lub wykonywania. Zalecamy korzystanie z wersji, które znajdują się w zestawie Azure SDK BOM, chyba że jest to konieczne. Aby uzyskać więcej informacji na temat obsługi zależności podczas korzystania z zestawu Azure SDK dla języka Java, zobacz Rozwiązywanie problemów z konfliktami wersji zależności.

Tworzenie obrazu natywnego wykorzystując GraalVM

Maszynę wirtualną GraalVM można użyć do utworzenia obrazu natywnego aplikacji Java. GraalVM kompiluje kod Java przed upływem czasu do natywnego kodu maszynowego, co może przynieść drastyczne wzrosty wydajności w niektórych sytuacjach. Zestaw Azure SDK dla języka Java udostępnia niezbędne metadane w każdej ze swoich bibliotek klienckich, aby wspierać kompilację natywnych obrazów GraalVM.

Aby rozpocząć, musisz zainstalować maszynę GraalVM i przygotować system programowania do kompilowania obrazów natywnych. Proces instalacji maszyny GraalVM jest prosty, a dokumentacja narzędzia GraalVM zawiera instrukcje krok po kroku dotyczące instalowania maszyny wirtualnej GraalVM i przy użyciu maszyny GraalVM w celu zainstalowaniaobrazu natywnego. Dokładnie postępuj zgodnie z sekcją wymagań wstępnych, aby zainstalować niezbędne kompilatory natywne dla systemu operacyjnego.

W istniejącym projekcie opartym na Gradle możesz postępować zgodnie z instrukcjami GraalVM dotyczącymi Gradle na temat dodania obsługi GraalVM do twojego projektu. W ten sposób masz więcej opcji kompilacji, co pozwala skompilować aplikację do standardowego kodu bajtowego Java lub w obraz natywny skompilowany przez maszynę wirtualną GraalVM.

Następnie możesz uruchomić kompilację obrazu natywnego. Aby użyć obrazu natywnego GraalVM, można użyć standardowych narzędzi Gradle. W przypadku narzędzia Gradle użyj następującego polecenia:

gradle nativeCompile

Po uruchomieniu tego polecenia graalVM generuje natywny plik wykonywalny dla platformy, na której działa. Plik wykonywalny zostanie wyświetlony w katalogu /app/build/native/nativeCompile projektu. Teraz możesz uruchomić aplikację przy użyciu tego pliku wykonywalnego i powinna działać podobnie jak w przypadku standardowej aplikacji Java.

Następne kroki