Mulai menggunakan Azure SDK dan Gradle
Artikel ini memperlihatkan kepada Anda cara menggunakan Gradle untuk membangun aplikasi dengan Azure SDK for Java. Dalam artikel ini, Anda menyiapkan proyek baru dengan Gradle, membangun proyek dengan Gradle, dan menggunakan alat gambar asli GraalVM untuk membuat biner asli khusus platform.
Prasyarat
- Java Developer Kit, versi 8 atau yang lebih baru. Kami merekomendasikan versi 17 untuk pengalaman terbaik.
- Gradle
Membuat proyek Gradle baru
Tidak seperti Maven, Gradle tidak memiliki sistem arketipe untuk memulai proyek secara templat. Bootstrapping proyek Gradle dimungkinkan, tetapi tidak mengonfigurasi Azure SDK untuk Java secara spesifik seperti Maven yang setara. Untuk bekerja melalui langkah-langkah, pertama-tama gunakan perintah berikut untuk membuat direktori baru yang kosong dari baris perintah:
gradle init --type java-application
Anda diminta untuk menjawab serangkaian pertanyaan singkat, setelah itu Anda memiliki direktori yang berisi kumpulan file dan subdirektori. Untuk memastikan bahwa file yang dihasilkan dikompilasi, jalankan perintah berikut yang diperlukan untuk memverifikasi build:
gradle clean assemble test
Anda sekarang dapat melanjutkan untuk mengedit file build.gradle
Untuk menyertakan versi dependensi dari pustaka klien Azure SDK untuk Java yang terdaftar di BOM, masukkan cuplikan berikut ke dalam file build.gradle proyek . Ganti placeholder {bom_version_to_target} dengan versi terbaru Azure SDK untuk Java BOM.
dependencies {
implementation platform('com.azure:azure-sdk-bom:{bom_version_to_target}')
}
Anda dapat menemukan semua rilis Azure SDK untuk BOM klien Java di azure-sdk-bom. Sebaiknya gunakan versi terbaru untuk memanfaatkan fitur terbaru pustaka klien Azure SDK for Java.
Setelah mulai bergantung pada Azure SDK untuk Java BOM, Anda dapat menyertakan dependensi pada pustaka tanpa menentukan versinya. Nilai versi ini dicari secara otomatis di Azure SDK untuk Java BOM. Misalnya, untuk menyertakan dependensi
dependencies {
implementation 'com.azure:azure-storage-blob'
}
Menggunakan Gradle untuk menentukan dependensi proyek dapat membuat pengelolaan proyek Anda lebih sederhana. Dengan Azure SDK BOM, Anda dapat mempercepat proyek dan memiliki keyakinan lebih dalam pengelolaan versi dependensi Anda untuk jangka panjang. Sebaiknya gunakan BOM untuk menjaga dependensi tetap selaras dan terbaru.
Sertakan paket yang tidak ada di BOM
Azure SDK untuk BOM klien Java hanya menyertakan pustaka yang Umum Tersedia (GA). Jika Anda ingin bergantung pada paket yang masih dalam versi beta atau pada pustaka yang berbeda dari yang disertakan dalam BOM, Anda dapat menentukan versi dependensi Maven bersama dengan groupId dan artifactId di bagian dependensi. Anda dapat memilih untuk memiliki dependensi yang menggunakan versi BOM dan dependensi dengan versi yang ditiadakan dalam file POM proyek yang sama, seperti yang ditunjukkan dalam contoh berikut:
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'
}
Jika Anda menggunakan pendekatan ini dan menentukan versi langsung dalam proyek, Anda mungkin mendapatkan konflik versi dependensi. Konflik ini muncul karena paket yang berbeda mungkin bergantung pada versi dependensi umum yang berbeda, dan versi ini mungkin tidak kompatibel satu sama lain. Ketika konflik terjadi, Anda dapat mengalami perilaku yang tidak diinginkan pada waktu kompilasi atau runtime. Sebaiknya Anda mengandalkan versi yang ada di Azure SDK BOM kecuali diperlukan. Untuk informasi selengkapnya tentang menangani dependensi saat menggunakan Azure SDK for Java, lihat Memecahkan masalah konflik versi dependensi.
Membangun gambar asli dengan GraalVM
Anda dapat menggunakan GraalVM untuk membuat gambar asli aplikasi Java. GraalVM mengkompilasi kode Java sebelumnya ke dalam kode mesin asli, yang dapat menghasilkan perolehan performa drastis dalam situasi tertentu. Azure SDK for Java menyediakan metadata yang diperlukan di setiap pustaka kliennya untuk mendukung kompilasi gambar asli GraalVM.
Untuk memulai, Anda perlu menginstal GraalVM dan menyiapkan sistem pengembangan Anda untuk mengkompilasi gambar asli. Proses penginstalan untuk GraalVM sangat mudah, dan dokumentasi GraalVM menyediakan instruksi langkah demi langkah untuk menginstal GraalVM dan menggunakan GraalVM untuk menginstalnative-image. Ikuti bagian prasyarat dengan hati-hati untuk menginstal kompilator asli yang diperlukan untuk sistem operasi Anda.
Dengan proyek berbasis Gradle yang ada, Anda dapat mengikuti petunjuk GraalVM untuk Gradle tentang cara menambahkan dukungan GraalVM ke proyek Anda. Dengan demikian, Anda kemudian memiliki lebih banyak opsi build, memungkinkan Anda untuk mengkompilasi aplikasi Anda ke dalam bytecode Java standar, atau ke dalam gambar asli yang dikompilasi oleh GraalVM.
Selanjutnya, Anda siap untuk menjalankan build gambar asli. Anda dapat menggunakan alat Gradle standar untuk menggunakan gambar asli GraalVM. Untuk Gradle, gunakan perintah berikut:
gradle nativeCompile
Setelah Anda menjalankan perintah ini, GraalVM menghasilkan executable asli untuk platform yang dijalankannya. Executable muncul di direktori Gradle /app/build/native/nativeCompile proyek Anda. Anda sekarang dapat menjalankan aplikasi Anda dengan file yang dapat dieksekusi ini, dan harus berkinerja mirip dengan aplikasi Java standar.