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

Membuat proyek Gradle baru

Tidak seperti Maven, Gradle tidak memiliki sistem arketipe untuk memulai proyek secara templat. Anda dapat mem-bootstrap project Gradle, tetapi project tersebut tidak mengonfigurasi hal-hal spesifik Azure SDK untuk Java seperti padanan Maven. 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 selesai, 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 yang terletak di direktori aplikasi. Untuk mempermudah pengelolaan versi dependensi, tim Azure SDK untuk Java menerbitkan Azure SDK for Java client BOM setiap bulan. File BOM ini mencakup semua paket klien Azure SDK yang Tersedia Secara Umum (GA) untuk Java dengan versi dependensi yang kompatibel.

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. Gunakan versi terbaru untuk memanfaatkan fitur terbaru Azure SDK untuk pustaka klien Java.

Setelah mulai bergantung pada Azure SDK untuk Java BOM, Anda dapat menyertakan dependensi pada pustaka tanpa menentukan versinya. Azure SDK untuk Java BOM secara otomatis menyediakan nilai versi ini. Misalnya, untuk menyertakan dependensi , tambahkan baris berikut ke file build.gradle Anda:

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. Gunakan BOM untuk menjaga dependensi tetap sinkron dan mutakhir.

Sertakan paket yang tidak ada di BOM

BOM klien Azure SDK untuk Java hanya mencakup pustaka yang telah tersedia secara umum (GA). Jika Anda ingin bergantung pada paket yang masih dalam versi beta atau pada versi pustaka yang berbeda dari yang disertakan dalam BOM, tentukan 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 mungkin mengalami perilaku yang tidak diinginkan pada waktu kompilasi atau runtime. 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, instal GraalVM dan siapkan 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, ikuti instruksi GraalVM untuk Gradle tentang cara menambahkan dukungan GraalVM ke proyek Anda. Dengan melakukan langkah ini, Anda mendapatkan lebih banyak opsi build, sehingga Anda dapat 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.

Langkah berikutnya

Mulai menggunakan ekstensi Azure untuk IntelliJ dan Eclipse

  • Last updated on