Erste Schritte mit Azure SDK und Gradle
In diesem Artikel erfahren Sie, wie Sie Gradle zum Erstellen von Anwendungen mit dem Azure SDK für Java verwenden. In diesem Artikel richten Sie ein neues Projekt mit Gradle ein, erstellen Projekte mit Gradle und verwenden das native GraalVM-Imagetool zum Erstellen plattformspezifischer nativer Binärdateien.
Voraussetzungen
- Java Developer Kit, Version 8 oder höher. Wir empfehlen Version 17, um die beste Erfahrung zu erzielen.
- Gradle
Erstellen eines neuen Gradle-Projekts
Im Gegensatz zu Maven verfügt Gradle über kein archetypisches System zum Projekt-Bootstrapping nach einem Vorlagenmuster. Es ist möglich, ein Gradle-Projekt zu bootstrappen, dabei wird jedoch kein Azure SDK für Java-Besonderheiten wie das Maven-Äquivalent konfiguriert. Um die Schritte zu durchlaufen, verwenden Sie zuerst den folgenden Befehl, um ein neues, leeres Verzeichnis über die Befehlszeile zu erstellen:
gradle init --type java-application
Es wird Ihnen aufgefordert, eine kurze Reihe von Fragen zu beantworten, wonach Ihnen ein Verzeichnis zur Verfügung steht, das eine Sammlung von Dateien und Unterverzeichnissen enthält. Um sicherzustellen, dass die generierten Dateien kompiliert werden, führen Sie die folgenden Befehle aus, die zum Überprüfen des Builds erforderlich sind:
gradle clean assemble test
Sie können nun mit der Bearbeitung der build.gradle-Datei fortfahren, die sich im App-Verzeichnis befindet. Als Einstieg und zur Vereinfachung der Verwaltung von Abhängigkeitsversionen veröffentlicht das Azure SDK für Java-Team jeden Monat die Azure SDK für Java-Client-Stückliste. Diese BOM-Datei enthält alle allgemein verfügbaren Versionen der Azure SDK für Java-Clientpakete zusammen mit den korrespondierenden Abhängigkeitsversionen.
Um Abhängigkeitsversionen für eine in der Stückliste aufgeführte Azure SDK für Java-Clientbibliothek zu verwenden, fügen Sie der Projektdatei build.gradle den folgenden Codeausschnitt hinzu. Ersetzen Sie den Platzhalter {bom_version_to_target} durch die neueste Version der Azure SDK für Java-Stückliste.
dependencies {
implementation platform('com.azure:azure-sdk-bom:{bom_version_to_target}')
}
Alle Versionen der Azure SDK für Java-Client-Stückliste finden Sie unter azure-sdk-bom. Es wird empfohlen, die neueste Version zu verwenden, um die neuesten Features des Azure SDK für Java-Clientbibliotheken zu nutzen.
Sobald Sie mit der Verwendung der Azure SDK für Java-Stückliste begonnen haben, können Sie Abhängigkeiten von Bibliotheken einbeziehen, ohne deren Version anzugeben. Diese Versionswerte werden in der Azure SDK für Java-Stückliste automatisch nachgeschlagen. Wenn Sie z. B. eine azure-storage-blob-Abhängigkeit einschließen wollen, fügen Sie der build.gradle-Datei die folgenden Zeilen hinzu:
dependencies {
implementation 'com.azure:azure-storage-blob'
}
Die Verwendung von Gradle zum Definieren von Projektabhängigkeiten kann die Verwaltung Ihrer Projekte vereinfachen. Mit der Azure SDK-BOM können Sie Ihr Projekt beschleunigen und in Bezug auf die Abhängigkeitsversionsverwaltung langfristig zuversichtlicher sein. Wir empfehlen die Verwendung der Stückliste, um Abhängigkeiten auf dem neuesten Stand zu halten.
Einschließen eines Pakets, das nicht in der BOM enthalten ist
Das Azure SDK für Java-Client-BOM enthält nur Allgemein verfügbare (GA)-Bibliotheken. Wenn Sie von einem Paket abhängig sein möchten, das sich noch in der Betaversion befindet, oder von einer Bibliotheksversion, die von der in der BOM enthaltenen Version abweicht, können Sie die Maven-Abhängigkeitsversion zusammen mit groupId und artifactId im Abhängigkeitsabschnitt angeben. Sie können entscheiden, ob Sie in dieselbe POM-Projektdatei Abhängigkeiten einschließen, die BOM-Versionen verwenden und Abhängigkeiten mit überschriebenen Versionen, wie im folgenden Beispiel dargestellt:
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'
}
Wenn Sie diesen Ansatz wählen und Versionen direkt in Ihrem Projekt angeben, werden Sie möglicherweise auf Abhängigkeitsversionskonflikte stoßen. Diese Konflikte treten auf, da unterschiedliche Pakete möglicherweise von verschiedenen Versionen gemeinsamer Abhängigkeiten abhängen, und diese Versionen sind möglicherweise nicht miteinander kompatibel. Wenn Konflikte auftreten, kann zur Kompilier- oder Laufzeit unerwünschtes Verhalten auftreten. Es wird empfohlen, dass Sie sich auf Versionen verlassen, die sich im Azure SDK-BOM befinden, es sei denn, dies ist erforderlich. Weitere Informationen zum Umgang mit Abhängigkeiten bei Verwendung des Azure SDK für Java finden Sie unter Problembehandlung bei Abhängigkeitsversionskonflikten.
Erstellen eines nativen Images mit GraalVM
Sie können GraalVM verwenden, um ein systemeigenes Image einer Java-Anwendung zu erstellen. GraalVM kompiliert den Java-Code vorab in systemeigenen Computercode, was zu drastischen Leistungsgewinnen in bestimmten Situationen führen kann. Das Azure SDK für Java stellt die erforderlichen Metadaten in den einzelnen Clientbibliotheken zur Unterstützung der nativen GraalVM-Imagekompilierung bereit.
Um zu beginnen, müssen Sie GraalVM installieren und Ihr Entwicklungssystem für die Kompilierung nativer Images vorbereiten. Der Installationsprozess für GraalVM ist unkompliziert, und in der GraalVM-Dokumentation finden Sie Schritt-für-Schritt-Anleitungen für die Installation von GraalVM und das Verwenden von GraalVM zum Installieren nativer Images. Befolgen Sie sorgfältig die im Abschnitt Voraussetzungen beschriebenen Schritte, um die erforderlichen nativen Compiler für Ihr Betriebssystem zu installieren.
Mit Ihrem vorhandenen Gradle-basierten Projekt können Sie den GraalVM-Anweisungen für Gradle folgen, wie Sie GraalVM-Unterstützung zu Ihrem Projekt hinzufügen. Auf diese Weise haben Sie dann mehr Buildoptionen, sodass Sie Ihre Anwendung in den Standard-Java-Bytecode oder in ein systemeigenes Bild kompilieren können, das von GraalVM kompiliert wird.
Sie sind nun bereit, ein natives Images zu erstellen. Sie können standardmäßige Gradle-Tools verwenden, um ein GraalVM-Native-Image zu verwenden. Verwenden Sie für Gradle den folgenden Befehl:
gradle nativeCompile
Nachdem Sie diesen Befehl ausgeführt haben, erzeugt GraalVM ein natives ausführbares Programm für die Plattform, auf der es ausgeführt wird. Die ausführbare Datei wird im Gradle-Projektverzeichnis /app/build/native/nativeCompile angezeigt. Sie können Ihre Anwendung jetzt mit dieser ausführbaren Datei ausführen, und sie sollte ähnlich wie eine Standard-Java-Anwendung ausgeführt werden.