Gradle: esensi sistem build untuk Android dan build.gradle
Gradle adalah sistem build yang mengotomatiskan kompilasi, pengujian, dan pengemasan aplikasi Android. Berbeda dengan Apache Ant atau Maven, ia mendukung build inkremental dan caching hasil. Baca lebih lanjut tentang kemampuannya di dokumentasi resmi Gradle. Sejak 2013, alat ini digunakan sebagai sistem build standar untuk proyek Android di Android Studio.
Poin Utama
- Gradle — sistem build standar untuk Android sejak 2013, menggantikan Ant dan Maven
- Build.gradle.kts di Kotlin DSL — standar konfigurasi modern dengan pemeriksaan tipe
- Build variants menggabungkan tipe build dan flavor produk untuk berbagai versi aplikasi
- Plugin memperluas fungsionalitas: dari penerapan alat Android hingga publikasi build
- Build inkremental dan caching mengurangi waktu kompilasi ulang berkali-kali lipat
Apa itu Gradle?
Gradle adalah alat otomatisasi build sumber terbuka yang ditulis dalam Java, berjalan di JVM. Ia menerima kode sumber, dependensi, dan resource sebagai input, dan menghasilkan aplikasi siap pakai — APK atau AAB untuk Android — sebagai output. Inti dari Gradle adalah konsep grafik tugas asiklik terarah (DAG), di mana setiap tugas adalah unit kerja atomik, dan hubungan di antara mereka menentukan urutan eksekusi. Berbeda dengan Make atau Ant, Gradle tidak memerlukan deskripsi manual urutan langkah: cukup deklarasikan dependensi antar tugas, dan sistem akan menentukan urutan optimalnya sendiri. Pendekatan ini membuat Gradle fleksibel dan skalabel untuk proyek dengan ukuran berapa pun.
Sistem menggunakan tiga fase eksekusi: inisialisasi (menentukan proyek yang berpartisipasi), konfigurasi (membangun grafik tugas), dan eksekusi (menjalankan tugas dalam urutan yang tepat). Fase konfigurasi adalah perbedaan utama Gradle: seluruh script build dieksekusi sebelum tugas dimulai, yang memungkinkan perubahan dinamis grafik tergantung pada kondisi. Ini memberikan kemampuan, misalnya, untuk menambahkan tugas hanya untuk varian build tertentu tanpa menduplikasi kode. Builder ditulis dalam Groovy, tetapi file konfigurasi mendukung dua bahasa: Groovy DSL dan Kotlin DSL.
Bagaimana Gradle mengelola build proyek Android?
Plugin Android untuk Gradle — com.android.application dan com.android.library, yang menambahkan tugas ke proyek untuk bekerja dengan alat Android. Ketika pengembang memulai build, Gradle secara berurutan menjalankan puluhan tugas: kompilasi Kotlin dan Java melalui javac atau kotlinc, pemrosesan resource melalui AAPT2, pembuatan R.java, kompilasi bytecode ke DEX melalui D8 atau R8, penandatanganan dan zipping APK. Setiap tugas memeriksa apakah data masukannya telah berubah, dan jika tidak — menggunakan hasil yang di-cache. Mekanisme ini disebut build inkremental dan mempercepat kompilasi ulang sebesar 60–80% dibandingkan dengan build ulang penuh.
Konfigurasi modul Android ditentukan dalam blok android dari file build.gradle.kts. Di dalam blok, compileSdk, minSdk, targetSdk, versi aplikasi, tanda tangan, dan parameter lainnya didefinisikan. Gradle secara otomatis membuat beberapa varian build untuk setiap modul — kombinasi tipe (release, debug) dan flavor. Misalnya, untuk modul dengan dua flavor dan dua tipe, Gradle menghasilkan empat tugas: assembleDemoDebug, assembleDemoRelease, assembleFullDebug, assembleFullRelease. Semua tugas ini dapat dijalankan secara terpisah atau diluncurkan dengan satu perintah untuk semua varian sekaligus.
Build.gradle dan build.gradle.kts: struktur konfigurasi
Setiap proyek Android berisi dua tingkat konfigurasi: root build.gradle.kts (pengaturan untuk semua modul) dan modul build.gradle.kts (pengaturan untuk modul tertentu). Di file root, plugin dideklarasikan tanpa penerapan, repositori, dan variabel umum. Di file modul, plugin diterapkan ke modul tertentu dan parameter build dikonfigurasi. Pendekatan ini memungkinkan pengelolaan versi dependensi secara terpusat melalui katalog versi atau blok ext.
Kotlin
@Suppress("UnstableApiUsage")
plugins {
id("com.android.application") version "8.2.2"
id("org.jetbrains.kotlin.android") version "1.9.22"
}
android {
namespace = "com.example.myapp"
compileSdk = 34
defaultConfig {
applicationId = "com.example.myapp"
minSdk = 24
targetSdk = 34
versionCode = 1
versionName = "1.0"
}
}Blok dependencies — elemen kritis lain dari build.gradle.kts. Di dalamnya, pustaka, modul, dan dependensi file yang dibutuhkan aplikasi dicantumkan. Gradle mendukung beberapa konfigurasi dependensi: implementation (hanya dapat diakses oleh modul saat ini), api (juga dapat diakses oleh modul dependen), testImplementation (hanya untuk pengujian), androidTestImplementation (untuk pengujian instrumental), dan compileOnly (hanya pada tahap kompilasi). Setiap konfigurasi mengelola visibilitas kelas dalam grafik dependensi, yang memengaruhi waktu build dan ukuran artefak akhir.
Kotlin
dependencies {
implementation("androidx.core:core-ktx:1.12.0")
implementation("androidx.lifecycle:lifecycle-runtime-ktx:2.7.0")
implementation("androidx.activity:activity-compose:1.8.2")
testImplementation("junit:junit:4.13.2")
androidTestImplementation("androidx.test.ext:junit:1.1.5")
}Build variants: varian build aplikasi
Build variant — kombinasi build type dan product flavor yang menentukan versi aplikasi dengan pengaturan, kode, dan resource unik. Build type (tipe build) menentukan parameter pengemasan: debug (dengan debugging dan akhiran .debug) atau release (dengan obfuskasi dan tanda tangan). Product flavor (rasa produk) menentukan varian fungsional: misalnya, demo (versi terbatas) dan full (versi lengkap dengan kemampuan tambahan). Gradle secara otomatis menghasilkan tugas untuk setiap kombinasi, memungkinkan semua versi dibangun dengan satu perintah.
Kotlin
android {
buildTypes {
release {
isMinifyEnabled = true
proguardFiles(
getDefaultProguardFile("proguard-android-optimize.txt"),
"proguard-rules.pro"
)
}
debug {
applicationIdSuffix = ".debug"
}
}
flavorDimensions += "version"
productFlavors {
create("demo") {
dimension = "version"
applicationIdSuffix = ".demo"
}
create("full") {
dimension = "version"
applicationIdSuffix = ".full"
}
}
}Setiap build variant memiliki source set terpisah. Gradle menggunakan direktori src/demo/release, src/full/debug, dan lainnya, di mana resource, manifes, dan kode sumber unik untuk varian tertentu disimpan. Kode umum tetap di src/main. Pendekatan ini memungkinkan penggunaan kembali logika utama dan hanya mengganti bagian yang berbeda: string, ikon, API endpoint, atau file konfigurasi. Source set dapat menimpa resource apa pun dari main: manifes, drawable, values, atau bahkan kelas Kotlin. Saat membangun varian tertentu, Gradle menggabungkan file dari main dan source set yang sesuai, dengan file dari varian memiliki prioritas.
Plugin Gradle untuk Android: memperluas kemampuan
Ekosistem plugin Gradle mencakup semua tahap pengembangan aplikasi Android. Plugin resmi dari Google meliputi com.android.application (untuk modul aplikasi), com.android.library (untuk modul pustaka), com.android.test (untuk modul pengujian), dan plugin Kotlin dari JetBrains. Plugin menambahkan tugas baru ke proyek, memperluas DSL dengan blok konfigurasi baru, dan menghubungkan alat tambahan. Tanpa plugin com.android.application, proyek tidak dapat membangun APK: plugin ini mendaftarkan semua tugas spesifik Android dan menghubungkannya ke dalam grafik build.
Plugin pihak ketiga memecahkan tugas yang lebih spesifik. Google Services (com.google.gms.google-services) mengintegrasikan Firebase dan Google Play Services, secara otomatis memasukkan google-services.json ke dalam build. Hilt (dagger.hilt.android.plugin) menghasilkan kode untuk injeksi dependensi pada tahap kompilasi. Safe Args (androidx.navigation.safeargs.kotlin) membuat kelas aman-tipe untuk navigasi antar fragmen. Setiap plugin dihubungkan di root build.gradle.kts melalui blok plugins dan biasanya memerlukan konfigurasi minimal. Gradle secara otomatis menyelesaikan dependensi transitif antar plugin dan menjamin kompatibilitas versi melalui file Bom dan katalog versi.
Task Gradle: otomatisasi proses build
Task (tugas) — unit kerja atomik di Gradle. Setiap tugas memiliki data input, data output, dan tindakan. Tugas bawaan untuk Android meliputi assemble (membangun semua varian), lint (pemeriksaan kode), test (menjalankan unit test), dan clean (membersihkan file sementara). Pengembang dapat menambahkan tugas kustom menggunakan Groovy atau Kotlin DSL. Tugas kustom berguna untuk mengotomatiskan operasi rutin: pembuatan laporan, penyalinan artefak, deployment ke perangkat pengujian, atau integrasi dengan sistem CI.
Kotlin
tasks.register("printBuildInfo") {
description = "Menampilkan informasi tentang build"
group = "custom"
doLast {
println("Build variant: ${project.name}")
println("Version: ${android.defaultConfig.versionName}")
}
}Setiap tugas dapat bergantung pada tugas lain melalui mekanisme dependsOn. Jika tugas A bergantung pada tugas B, Gradle menjamin bahwa B akan dieksekusi sebelum A. Sistem tidak memerlukan penentuan urutan manual untuk setiap pasangan — cukup deklarasikan dependensi, dan Gradle akan membangun grafik terarah yang dioptimalkan untuk eksekusi paralel tugas independen. Tugas bawaan plugin Android sudah saling terhubung: lint bergantung pada kompilasi, test bergantung pada assemble, assembleDebug bergantung pada compileDebugKotlin. Pengembang dapat menempatkan tugas kustomnya di simpul mana pun dari grafik menggunakan dependsOn, mustRunAfter, atau shouldRunAfter.
Kesalahan umum saat bekerja dengan Gradle
Salah satu masalah umum — konflik versi dependensi, ketika dua pustaka memerlukan versi berbeda dari dependensi transitif yang sama. Gradle melaporkan kesalahan konflik, tetapi tidak selalu menawarkan solusi otomatis. Untuk diagnosis, gunakan perintah ./gradlew :app:dependencies, yang menampilkan pohon dependensi lengkap. Disarankan untuk memaksa versi pustaka yang berkonflik melalui blok resolutionStrategy. Skenario umum lainnya — build lambat karena tidak adanya pemrosesan inkremental. Periksa apakah semua plugin sudah diperbarui, Gradle Daemon diaktifkan (org.gradle.daemon=true) dan di gradle.properties memori yang cukup telah diatur: org.gradle.jvmargs=-Xmx4096m.
Masalah dengan caching muncul setelah memperbarui dependensi: Gradle mungkin menggunakan cache usang dan build berakhir dengan kesalahan. Solusinya — jalankan build dengan flag --refresh-dependencies atau bersihkan cache secara manual melalui ./gradlew cleanBuildCache. Kesalahan ketiga yang paling sering terjadi — ketidakcocokan versi Android Gradle Plugin (AGP) dan Gradle. Setiap versi AGP memerlukan versi minimum Gradle tertentu. Tabel kompatibilitas dipublikasikan di developer.android.com. Jika versi tidak kompatibel, Gradle berakhir dengan kesalahan pada tahap konfigurasi dengan pesan tentang versi minimum yang diperlukan. Selalu periksa apakah versi Gradle wrapper sesuai dengan persyaratan AGP.
Pertanyaan yang Sering Diajukan
Apa itu Gradle dengan kata sederhana?
Gradle adalah program pengotomatis pembangunan proyek. Ia mengambil kode sumber Anda dalam Kotlin atau Java, menghubungkan pustaka dari internet, mengompilasi semuanya menjadi bytecode, dan mengemasnya ke dalam APK. Berjalan di JVM dan menggunakan script deklaratif alih-alih instruksi manual. Pengembang hanya perlu mendeskripsikan aturan, dan sisanya dilakukan Gradle sendiri.
Apa perbedaan build.gradle.kts dengan build.gradle?
Build.gradle ditulis dalam Groovy — bahasa dinamis dengan sintaksis fleksibel dan ketelitian yang lebih rendah. Build.gradle.kts menggunakan Kotlin DSL: pengetikan ketat, penyelesaian otomatis di Android Studio, dan pemeriksaan kesalahan pada tahap kompilasi. Google merekomendasikan Kotlin DSL untuk semua proyek baru. File Groovy lebih mudah dimigrasi, tetapi file Kotlin lebih andal dalam perawatan.
Bagaimana cara mempercepat build Gradle?
Aktifkan Gradle Daemon (org.gradle.daemon=true) dan build paralel (org.gradle.parallel=true). Tingkatkan memori JVM menjadi 4–8 GB melalui org.gradle.jvmargs. Gunakan konfigurasi proyek sesuai permintaan (org.gradle.configureondemand=true). Untuk proyek Android, konfigurasikan caching tugas dan build hanya untuk ABI yang diperlukan. Di Android Studio, jalankan Build Analyzer untuk menemukan titik lemah.
Apa itu build variant di Android?
Build variant — adalah kombinasi build type (misalnya debug atau release) dan product flavor (misalnya demo atau full). Setiap varian dapat memiliki nama paket, versi, resource, dan file sumbernya sendiri. Gradle secara otomatis membuat tugas build terpisah untuk setiap varian. Ini memungkinkan pembangunan beberapa versi aplikasi dari satu proyek.
Bagaimana cara menambahkan dependensi di Gradle?
Dependensi ditambahkan di blok dependencies dari file build.gradle.kts. Format penulisan: configuration("group:artifact:version"). Misalnya, implementation("androidx.core:core-ktx:1.12.0"). Untuk pengujian gunakan testImplementation, untuk pengujian instrumental — androidTestImplementation. Versi sebaiknya dipisahkan ke dalam katalog versi (version catalog) melalui file libs.versions.toml.
Ringkasan
- Gradle — sistem build standar untuk Android, berjalan di JVM dan menggunakan grafik tugas DAG
- Build inkremental dan caching mengurangi waktu kompilasi ulang sebesar 60–80%
- Kotlin DSL (build.gradle.kts) — format konfigurasi modern dengan penyelesaian otomatis dan pemeriksaan tipe
- Build variants menggabungkan build type dan product flavor, membuat source set terpisah untuk setiap varian
- Plugin memperluas Gradle: dari plugin Android dasar hingga Firebase, Hilt, dan Safe Args
- Task kustom memungkinkan otomatisasi setiap tahap build dan integrasi
- Masalah utama — konflik versi, build lambat, dan ketidakcocokan AGP dengan versi Gradle
Kami akan mengembangkan aplikasi seluler turnkey
IT Sectr membuat aplikasi iOS dan Android untuk startup dan bisnis sejak 2017. Kami akan memberi saran dan mengusulkan solusi terbaik.
Baca juga