Untuk melihat tampilan dan perilaku aplikasi di perangkat, Anda harus membangun dan menjalankannya. Android Studio menyiapkan project baru sehingga Anda dapat men-deploy aplikasi ke perangkat virtual atau fisik hanya dengan beberapa klik.
Ringkasan ini berfokus pada cara menggunakan Android Studio untuk membangun dan menjalankan aplikasi untuk pengujian dan proses debug. Untuk mengetahui cara menggunakan Android Studio guna membangun aplikasi sehingga dapat dirilis kepada pengguna, lihat Membangun aplikasi untuk dirilis kepada pengguna. Untuk mengetahui informasi lebih mendetail tentang cara mengelola dan menyesuaikan build dengan atau tanpa Android Studio, lihat Mengonfigurasi build.
Build dan run dasar
Untuk membangun dan menjalankan aplikasi, ikuti langkah-langkah berikut:
- Di toolbar, pilih aplikasi Anda dari menu konfigurasi run.
Pada menu perangkat target, pilih perangkat tempat Anda ingin menjalankan aplikasi.
Jika tidak memiliki perangkat yang dikonfigurasi, Anda harus membuat Perangkat Virtual Android untuk menggunakan Android Emulator atau menghubungkan perangkat fisik.
Klik Run
.
Android Studio memberikan peringatan jika Anda mencoba meluncurkan project ke perangkat yang memiliki error atau peringatan yang berkaitan dengannya. Perubahan ikonografi dan gaya membedakan antara error (pilihan perangkat yang menyebabkan konfigurasi rusak) dan peringatan (pilihan perangkat yang dapat mengakibatkan perilaku tidak terduga, tetapi masih dapat dijalankan).
Memantau proses build
Untuk melihat detail proses build, pilih View > Tool
Windows > Build atau klik Build
di kolom jendela alat. Jendela alat Build akan
menampilkan
tugas-tugas yang dijalankan Gradle untuk membangun aplikasi Anda, seperti yang ditunjukkan pada gambar 1.
- Tab Sync: Menampilkan tugas-tugas yang dijalankan Gradle untuk menyinkronkan dengan file project Anda. Mirip dengan tab Build Output, jika Anda mengalami error sinkronisasi, pilih elemen pada hierarki untuk menemukan informasi selengkapnya tentang error tersebut. Bagian ini juga menampilkan ringkasan dampak download untuk menentukan apakah download dependensi berpengaruh negatif terhadap build Anda.
- Tab Build Output: Menampilkan tugas-tugas yang dijalankan Gradle sebagai sebuah hierarki,
dengan setiap node mewakili fase build atau sekelompok
dependensi tugas. Jika Anda menerima error selama waktu build atau waktu kompilasi,
periksa hierarki dan pilih sebuah elemen untuk membaca output error-nya, seperti yang ditunjukkan pada
gambar 2.
Gambar 2. Periksa tab Build Output untuk melihat pesan error - Tab Build Analyzer: Memberikan informasi analisis performa build tentang build Anda. Lihat Memecahkan masalah performa build dengan Build Analyzer untuk mengetahui informasi selengkapnya.
- Restart: Melakukan lagi tindakan build yang terakhir. Jika Anda terakhir kali menjalankan Build > Make Selected Module, tindakan ini akan membuat modul saat ini. Jika Anda terakhir kali menjalankan Build > Make Project, maka file build perantara akan dihasilkan untuk semua modul dalam project Anda.
- Filters: Memfilter peringatan, tugas, ataupun keduanya yang berhasil diselesaikan. Fitur ini dapat memudahkan Anda menemukan masalah di output.
Jika varian build Anda menggunakan ragam produk, Gradle juga memanggil tugas untuk
membangun ragam produk tersebut. Untuk melihat daftar semua tugas build yang tersedia,
klik View > Tool Windows > Gradle atau klik Gradle,
pada kolom jendela alat.
Jika terjadi error selama proses build, Gradle dapat merekomendasikan, opsi command line untuk membantu Anda menyelesaikan masalah, seperti --stacktrace atau --debug. Untuk menggunakan opsi command line,
dengan proses build Anda:
- Buka dialog Settings atau Preferences:
- Pada Windows atau Linux, pilih File > Settings dari panel menu.
- Pada macOS, pilih Android Studio > Preferences dari panel menu.
- Arahkan ke Build, Execution, Deployment > Compiler.
- Dalam kolom teks di samping Command-line Options, masukkan opsi command line Anda.
- Klik OK untuk menyimpan dan keluar.
Gradle menerapkan opsi command line ini saat berikutnya Anda mencoba membangun aplikasi.
Fitur build dan run lanjutan
Cara default untuk membangun dan menjalankan aplikasi di Android Studio seharusnya cukup untuk melakukan pengujian aplikasi sederhana. Namun, Anda dapat menggunakan fitur build dan run ini untuk kasus penggunaan lanjutan:
Untuk men-deploy aplikasi dalam mode debug, klik Debug
.
Menjalankan aplikasi dalam mode debug memungkinkan Anda untuk menyetel titik henti sementara dalam kode, memeriksa variabel dan mengevaluasi ekspresi saat run-time, serta menjalankan alat debug. Untuk mempelajari lebih lanjut, lihat Mendebug aplikasi Anda.Jika memiliki aplikasi yang lebih besar dan lebih kompleks, Anda harus menggunakan Apply Changes, bukan mengklik Run
. Cara ini akan menghemat waktu karena Anda menghindari memulai ulang
aplikasi setiap kali ingin men-deploy perubahan. Untuk mengetahui informasi selengkapnya tentang Apply Changes, lihat bagian
Men-deploy secara bertahap dengan Apply
Changes.Jika Anda menggunakan Jetpack Compose, Edit Live adalah fitur eksperimental yang memungkinkan Anda mengupdate composable secara real time tanpa harus mengklik kembali Run
.
Fitur ini memungkinkan Anda berfokus pada penulisan kode UI dengan sedikit gangguan. Untuk mengetahui
informasi selengkapnya, lihat bagian Edit Live (eksperimental).Jika memiliki aplikasi dengan beberapa varian build atau versi, Anda dapat menggunakan jendela alat Build Variants untuk memilih varian build yang akan di-deploy. Untuk mengetahui informasi selengkapnya tentang cara menjalankan varian build tertentu, lihat bagian Mengubah varian build.
Untuk menyesuaikan opsi penginstalan, peluncuran, dan pengujian aplikasi, Anda dapat mengubah konfigurasi run/debug. Untuk mengetahui informasi selengkapnya tentang cara membuat konfigurasi run/debug kustom, lihat bagian Membuat konfigurasi run/debug.
Sebaiknya gunakan Android Studio untuk kebutuhan pengembangan, tetapi Anda juga dapat men-deploy aplikasi ke perangkat virtual atau fisik dari command line. Untuk mengetahui informasi selengkapnya, lihat Membangun aplikasi dari command line.
Men-deploy secara bertahap dengan Apply Changes
Di Android Studio 3.5 dan yang lebih tinggi, Apply Changes memungkinkan Anda mengirim perubahan kode dan resource ke aplikasi yang sedang berjalan tanpa memulai ulang aplikasi—dan, dalam beberapa kasus, tanpa memulai ulang aktivitas saat ini. Fleksibilitas ini membantu mengontrol seberapa sering aplikasi dimulai ulang saat Anda ingin men-deploy dan menguji perubahan kecil dan inkremental sambil mempertahankan status perangkat saat ini.
Apply Changes menggunakan kemampuan pada implementasi Android JVMTI yang didukung pada perangkat yang menjalankan Android 8.0 (API level 26) atau yang lebih tinggi. Untuk mempelajari lebih lanjut cara kerja Apply Changes, lihat Android Studio Project Marble: Apply Changes.
Persyaratan
Tindakan Apply Changes hanya tersedia setelah Anda memenuhi ketentuan berikut:
- Anda membangun APK aplikasi menggunakan varian build debug.
- Anda men-deploy aplikasi ke perangkat target atau emulator yang menjalankan Android 8.0 (API level 26) atau yang lebih tinggi.
Menggunakan Apply Changes
Gunakan opsi berikut saat Anda ingin men-deploy perubahan ke perangkat yang kompatibel:
Apply Changes and Restart Activity 
: Berupaya menerapkan perubahan kode dan resource Anda dengan memulai ulang aktivitas, tetapi tanpa memulai ulang aplikasi. Umumnya, Anda dapat menggunakan opsi ini setelah mengubah kode di bagian isi suatu metode atau mengubah resource yang ada.
Anda juga dapat melakukan tindakan ini dengan menekan Control+Alt+F10 (Control+Command+Shift+R di macOS).
Apply Code Changes 
: Berupaya menerapkan perubahan kode saja tanpa memulai ulang apa pun. Umumnya, Anda dapat menggunakan opsi
ini setelah mengubah kode di bagian isi suatu metode, tetapi belum
mengubah resource apa pun. Jika Anda telah mengubah kode dan resource, gunakan Apply Changes and Restart Activity.
Anda juga dapat melakukan tindakan ini dengan menekan Control+F10 (Control+Command+R di macOS).
Run : Men-deploy semua perubahan dan memulai ulang aplikasi. Gunakan opsi ini jika perubahan yang dibuat tidak dapat diterapkan menggunakan salah satu opsi Apply Changes. Untuk mempelajari lebih lanjut jenis perubahan yang memerlukan tindakan mulai ulang aplikasi, lihat bagian Limitation of Apply Changes.
Mengaktifkan penggantian run untuk Apply Changes
Saat Anda mengklik Apply Changes and Restart Activity atau Apply Code Changes, Android Studio akan membangun APK baru dan menentukan apakah perubahan dapat diterapkan ataukah tidak. Jika perubahan tidak dapat diterapkan dan akan membuat Apply Changes gagal, Android Studio akan meminta Anda untuk melakukan Run aplikasi Anda lagi.
Jika tidak ingin diminta setiap kali hal ini terjadi, Anda dapat mengonfigurasi Android Studio untuk otomatis menjalankan ulang aplikasi saat perubahan tidak dapat diterapkan. Untuk mengaktifkan perilaku ini, ikuti langkah-langkah berikut:
Buka dialog Settings atau Preferences:
- Pada Windows atau Linux, pilih File > Settings dari menu.
- Pada macOS, pilih Android Studio > Preferences dari menu.
Arahkan ke Build, Execution, Deployment > Deployment.
Pilih kotak centang untuk mengaktifkan penggantian run otomatis untuk salah satu atau kedua tindakan Apply Changes.
Klik OK.
Perubahan yang bergantung pada platform
Beberapa fitur Apply Changes bergantung pada versi platform Android tertentu. Untuk menerapkan jenis perubahan ini, aplikasi harus di-deploy ke perangkat yang menjalankan versi Android tersebut (atau yang lebih tinggi). Misalnya, penambahan metode memerlukan Android 11 atau versi lebih tinggi.
Batasan Apply Changes
Apply Changes dirancang untuk mempercepat proses deployment aplikasi. Namun, ada sejumlah batasan terkait kapan Apply Changes dapat digunakan.
Perubahan kode yang memerlukan mulai ulang aplikasi
Beberapa perubahan kode dan resource tidak dapat diterapkan hingga aplikasi dimulai ulang, termasuk yang berikut ini:
- Menambahkan atau menghapus kolom
- Menghapus metode
- Mengubah tanda tangan metode
- Mengubah pengubah metode atau class
- Mengubah pewarisan class
- Mengubah nilai dalam enum
- Menambahkan atau menghapus resource
- Mengubah manifes aplikasi
- Mengubah library native (file SO)
Library dan plugin
Beberapa library dan plugin otomatis membuat perubahan pada file manifes aplikasi Anda atau pada resource yang direferensikan pada manifes. Update otomatis ini dapat mengganggu Apply Changes dengan beberapa cara berikut:
- Jika library atau plugin membuat perubahan pada manifes aplikasi, Anda tidak dapat menggunakan Apply Changes. Anda harus memulai ulang aplikasi untuk melihat perubahan.
- Jika library atau plugin membuat perubahan pada file resource aplikasi, Anda tidak dapat menggunakan Apply Code Changes . Anda harus menggunakan Apply Changes and Restart Activity (atau memulai ulang aplikasi) untuk melihat perubahan.
Untuk menghindari pembatasan ini, nonaktifkan semua update otomatis untuk varian build debug.
Misalnya, Firebase Crashlytics memperbarui resource aplikasi dengan ID build unik selama setiap build sehingga mencegah Anda menggunakan Apply Code Changes dan mengharuskan Anda memulai ulang aktivitas aplikasi untuk melihat perubahan. Nonaktifkan perilaku ini agar Anda dapat menggunakan Apply Code Changes bersama Crashlytics dengan build debug.
Kode yang secara langsung merujuk konten dalam APK yang terinstal
Jika kode Anda secara langsung merujuk konten dari APK aplikasi yang terinstal di
perangkat, kode tersebut dapat menyebabkan error atau tidak berfungsi setelah mengklik Apply Code
Changes . Perilaku ini terjadi karena ketika Anda mengklik Apply Code Changes, APK yang mendasarinya pada perangkat akan diganti selama penginstalan. Dalam hal ini, Anda dapat mengklik Apply Changes and Restart Activity atau Run sebagai gantinya.
Jika Anda mengalami masalah lain saat menggunakan Apply Changes, laporkan bug.
Edit Live
Edit Live adalah fitur eksperimental di Android Studio yang memungkinkan Anda mengupdate composable di emulator dan perangkat fisik secara real time. Fungsi ini meminimalkan pengalihan konteks antara penulisan dan pembuatan aplikasi sehingga Anda dapat berfokus pada penulisan kode lebih lama tanpa gangguan.
Pelajari Edit Live lebih lanjut
Mengubah varian build
Secara default, Android Studio akan membuat versi debug aplikasi Anda saat Anda mengklik Run 
. Versi ini hanya untuk digunakan selama pengembangan.
Untuk mengubah varian build yang digunakan Android Studio, lakukan salah satu hal berikut:
- Pilih Build > Select Build Variant di menu.
- Pilih View > Tool Windows > Build Variants di menu.
- Klik tab Build Variants di kolom jendela alat.
Untuk project tanpa kode native/C++, panel Build Variants memiliki dua kolom: Module dan Active Build Variant. Nilai Active Build Variant untuk modul menentukan varian build mana yang akan di-deploy IDE ke perangkat terhubung Anda dan terlihat di editor.
Gambar 9. Panel Build Variants memiliki dua kolom untuk project yang tidak memiliki kode native/C++.
Untuk beralih antarvarian, klik sel Active Build Variant untuk modul lalu pilih varian yang diinginkan dari daftar.
Untuk project dengan kode native/C++, panel Build Variants memiliki tiga kolom:
- Module
- Active Build Variant
- Active ABI
Nilai Active Build Variant untuk modul menentukan varian build mana yang akan di-deploy oleh IDE ke perangkat Anda dan terlihat di editor. Untuk modul native, nilai Active ABI akan menentukan ABI yang digunakan oleh editor, tetapi tidak memengaruhi varian build yang di-deploy.
Gambar 10. Panel Build Variants menambahkan kolom Active ABI untuk project dengan kode native/C++
Untuk mengubah varian build atau ABI, klik sel untuk kolom Active Build Variant atau Active ABI lalu pilih varian atau ABI yang diinginkan dari daftar. Setelah Anda mengubah pilihan, IDE akan menyinkronkan project Anda secara otomatis. Mengubah kolom untuk aplikasi maupun modul library akan menerapkan perubahan untuk semua baris dependen.
Secara default, project baru disiapkan dengan dua varian build: varian debug dan varian rilis. Anda perlu membuat varian rilis untuk menyiapkan aplikasi Anda untuk rilis publik. Untuk menentukan variasi lain aplikasi dengan fitur atau persyaratan perangkat yang berbeda, Anda dapat menentukan varian build tambahan.
Konflik dalam dialog Build Variants Android Studio
Dalam dialog Build Variants Android Studio, Anda mungkin melihat pesan error yang menunjukkan konflik antara varian build, seperti berikut:
Error ini tidak menunjukkan masalah build dengan Gradle. Hal ini menunjukkan bahwa Android Studio IDE tidak dapat menyelesaikan simbol di antara varian dari modul yang dipilih.
Misalnya, jika Anda memiliki modul M1 yang bergantung pada varian v1 dari modul M2, tetapi M2 telah memilih varian v2 di IDE, Anda akan memiliki simbol yang belum terselesaikan di IDE. Misalkan M1 bergantung pada class yang hanya tersedia di v1; saat v2 dipilih, class tersebut tidak akan diketahui oleh IDE. Oleh karena itu, kode ini gagal
menyelesaikan nama class dan menampilkan error dalam kode modul M1.
Pesan error ini muncul karena IDE tidak dapat memuat kode untuk beberapa varian secara bersamaan. Namun, dalam build aplikasi Anda, varian yang dipilih dalam dialog ini tidak akan berpengaruh karena Gradle membangun aplikasi Anda dengan kode sumber yang ditentukan dalam urutan langkah build Gradle, bukan berdasarkan apa yang saat ini dimuat di IDE.
Mengubah konfigurasi run/debug
Saat Anda menjalankan aplikasi untuk pertama kalinya, Android Studio akan menggunakan konfigurasi run default. Konfigurasi run menentukan apakah aplikasi akan di-deploy dari APK atau Android App Bundle serta modul yang akan dijalankan, paket yang akan di-deploy, aktivitas yang akan dimulai, perangkat target, setelan emulator, opsi Logcat, dan banyak lagi.
Konfigurasi run/debug default akan membangun APK, meluncurkan aktivitas project default, dan menggunakan dialog Select Deployment Target untuk pemilihan perangkat target. Jika setelan default ini tidak sesuai dengan project atau modul Anda, Anda dapat menyesuaikan konfigurasi Run/Debug, atau membuat konfigurasi baru pada tingkat project, default, dan modul.
Untuk mengedit konfigurasi run/debug, pilih Run > Edit Configurations. Untuk mengetahui informasi selengkapnya, lihat Membuat dan mengedit konfigurasi run/debug.