Google berkomitmen untuk mendorong terwujudnya keadilan ras bagi komunitas Kulit Hitam. Lihat caranya.

Membuat dan mengedit konfigurasi run/debug

Jika Anda menjalankan, men-debug, atau menguji kode, Android Studio akan menggunakan konfigurasi run/debug untuk menentukan cara menjalankan operasi tersebut. Umumnya, konfigurasi default sudah cukup untuk menjalankan atau men-debug aplikasi. Namun, Anda dapat mengubah dan membuat konfigurasi baru, serta mengubah template default agar sesuai dengan proses pengembangan sebagaimana dijelaskan di halaman ini.

Untuk informasi selengkapnya, lihat juga dokumentasi IntelliJ berikut:

Tentang konfigurasi run/debug

Konfigurasi run/debug menetapkan detail seperti opsi penginstalan, peluncuran, dan pengujian aplikasi. Anda dapat mendefinisikan konfigurasi untuk satu kali penggunaan, atau menyimpannya untuk penggunaan berikutnya. Setelah menyimpannya, Anda dapat memilih konfigurasi itu dari menu drop-down Select Run/Debug Configuration dalam toolbar. Android Studio menyimpan konfigurasi sebagai bagian dari project.

Konfigurasi run/debug default

Jika Anda baru pertama membuat project, Android Studio akan membuat konfigurasi run/debug default untuk aktivitas utama berdasarkan template Android App. Untuk menjalankan atau men-debug project, Anda harus selalu menentukan setidaknya satu konfigurasi run/debug. Karenanya, kami merekomendasikan untuk tidak menghapus konfigurasi default.

Cakupan project dan kontrol versi

Perubahan template dan konfigurasi run/debug hanya berlaku pada project saat ini. Anda dapat membagikan konfigurasi run/debug (tetapi tidak untuk template) melalui sistem kontrol versi. Untuk informasi selengkapnya mengenai cara membagikan konfigurasi, lihat Opsi Konfigurasi Name dan Share.

Membuka dialog Run/Debug Configurations

Untuk membuka dialog Run/Debug Configurations, pilih Run > Edit Configurations. Dialog Run/Debug Configurations akan muncul, seperti yang ditunjukkan pada gambar 1.

Gambar 1. Dialog Run/Debug Configurations

Dialog ini menampilkan template default di panel kiri di bawah folder Defaults, dan mengelompokkan konfigurasi yang Anda tentukan berdasarkan jenis template di atas folderDefaults. Anda dapat mengubah ukuran dialog untuk melihat item tersembunyi.

Dalam dialog ini, Anda dapat:

Membuat konfigurasi run/debug baru

Anda dapat menentukan konfigurasi run/debug baru dari dialog Run/Debug Configurations, jendela Project, atau Code Editor. Konfigurasi baru harus didasarkan pada template default.

Dialog Run/Debug Configurations akan menampilkan konfigurasi run/debug Anda dan template default yang tersedia. Anda dapat memulai konfigurasi baru langsung dari template, atau dari salinan konfigurasi lain. Anda dapat mengubah nilai kolom jika diperlukan.

Atau, Anda dapat mengklik kanan sebuah item di jendela Project untuk otomatis membuat konfigurasi khusus item tersebut. Misalnya, jika ingin menjalankan aktivitas tertentu, Anda dapat mengklik kanan file Java aktivitas tersebut, lalu memilih Run. Bergantung pada itemnya, Android Studio menggunakan template default Aplikasi Android, Pengujian Berinstrumen Android, atau Android JUnit untuk membuat konfigurasi.

Di Code Editor, Anda dapat dengan mudah membuat pengujian dan konfigurasi run/debug untuk class atau metode, kemudian menjalankannya.

Jika Anda membuat konfigurasi di luar dialog Run/Debug Configurations, konfigurasi tersebut akan berlaku sementara kecuali jika Anda menyimpannya. Secara default, Anda dapat menyimpan hingga lima konfigurasi sementara dalam project sebelum Android Studio mulai menghapusnya. Untuk mengubah setelan default ini, dalam dialog Run/Debug Configurations, klik folder Defaults dan ketik sebuah nilai di kolom Temporary Configurations Limit. Untuk informasi selengkapnya mengenai konfigurasi sementara, lihat Membuat dan Menyimpan Konfigurasi Run/Debug Sementara.

Memulai konfigurasi berdasarkan template

Untuk menentukan konfigurasi run/debug berdasarkan template, ikuti langkah-langkah berikut:

  1. Buka dialog Konfigurasi Run/Debug.
  2. Klik Add New Configuration .
  3. Pilih default.
  4. Ketik nama di kolom Name.
  5. Ubah konfigurasi sesuai yang diperlukan.
  6. Pastikan untuk mengoreksi error apa pun yang ditampilkan di bagian bawah dialog.

  7. Klik Apply atau OK.

Memulai konfigurasi dari salinan

Untuk menentukan konfigurasi run/debug yang dimulai dari salinan konfigurasi lain, ikuti langkah-langkah berikut:

  1. Buka dialog Konfigurasi Run/Debug.
  2. Pilih sebuah konfigurasi run/debug yang sudah ada di panel kiri.
  3. Klik Copy Configuration .
  4. Ketik nama di kolom Name.
  5. Ubah konfigurasi sesuai yang diperlukan.
  6. Pastikan untuk mengoreksi error apa pun yang ditampilkan di bagian bawah dialog.

  7. Klik Apply atau OK.

Menentukan konfigurasi untuk item dalam project

Android Studio dapat membuat konfigurasi run/debug untuk beberapa item yang ditampilkan dalam jendela Project. Konfigurasi ini didasarkan pada template default seperti berikut:

Untuk membuat konfigurasi run/debug bagi item di project Anda, ikuti langkah-langkah berikut:

  1. Buka sebuah project di tampilan Android atau Project.
  2. Di jendela Project, klik kanan item yang dapat diuji dan pilih Runfilename atau Debug filename. Android Studio akan membuat sebuah konfigurasi run/debug sementara dan meluncurkan aplikasi Anda.
  3. Pilih Save dari menu drop-down Select Run/Debug Configuration di toolbar. Jika Anda tidak melihat toolbar, pilih Lihat > Toolbar.

Gambar 2. Menyimpan konfigurasi

Catatan: Jika Anda mengklik kanan dan menjalankan atau men-debug item yang sama (tetapi tidak untuk aktivitas), Android Studio akan membuat konfigurasi baru.

Menentukan konfigurasi pengujian untuk class atau metode

Android Studio memungkinkan Anda menentukan konfigurasi run pengujian untuk class atau metode, lalu menjalankannya. Misalnya, jika membuat class baru, Anda dapat membuat dan menjalankan pengujian untuknya. Jika lulus pengujian, Anda dapat menjalankan pengujian untuk bagian project lainnya guna memastikan kode tersebut tidak merusak apa pun di tempat lain.

Android Studio menggunakan template Pengujian Berinstrumen Android atau Android JUnit, bergantung pada set sumber. Untuk pengujian unit lokal, Anda memiliki pilihan untuk menjalankannya dengan cakupan kode.

Untuk membuat konfigurasi run/debug bagi class atau metode dalam kode Java, ikuti langkah-langkah berikut:

  1. Buka sebuah project di tampilan Android atau Project.
  2. Buka file Java dalam Code Editor.
  3. Pilih class atau metode dalam kode, lalu tekan Control+Shift+T (Command+Shift+T).
  4. Pilih Create New Test dari menu yang ditampilkan.
  5. Dalam dialog Create Test, Anda dapat mengubah atau menetapkan nilai, lalu mengklik OK.
  6. Dalam dialog Pilih Destination Directory pilih tempat dalam project di mana Anda ingin Android Studio menempatkan pengujian. Anda dapat menentukan lokasi menurut struktur direktori atau dengan memilih class yang berdekatan.
  7. Klik OK.

    Pengujian baru akan ditampilkan dalam jendela Project di set sumber pengujian yang sesuai.

  8. Untuk menjalankan pengujian, lakukan salah satu dari berikut ini:
    • Dalam jendela Project klik kanan pengujian, lalu pilih Run atau Debug.
    • Di Code Editor, klik kanan nama metode atau definisi class dalam file pengujian, lalu pilih Run atau Debug untuk menguji semua metode dalam class tersebut.
  9. Pilih Save dari menu drop-down Select Run/Debug Configuration di toolbar.

Gambar 3. Menyimpan konfigurasi

Menjalankan atau men-debug aplikasi menggunakan konfigurasi tersimpan

Jika telah menyimpan konfigurasi run/debug, Anda dapat memilihnya sebelum menjalankan atau mendebug aplikasi.

Untuk menggunakan konfigurasi run/debug yang tersimpan, ikuti langkah-langkah berikut:

  1. Pilih konfigurasi run/debug dari menu drop-down Pilih Konfigurasi Run/Debug dalam toolbar.
  2. Menu drop-down terletak di sebelah kiri Run dan Debug ; misalnya, .

  3. Pilih Run > Run atau Run > Debug.
  4. Atau, klik Run atau Debug .

Mengedit konfigurasi run/debug

Untuk mengedit konfigurasi run/debug, ikuti langkah-langkah ini:

  1. Buka dialog Konfigurasi Run/Debug.
  2. Pilih konfigurasi di panel kiri.
  3. Ubah konfigurasi sesuai yang diperlukan.
  4. Pastikan untuk mengoreksi error apa pun yang ditampilkan di bagian bawah dialog.

  5. Klik Apply atau OK.

Mengedit template konfigurasi run/debug default

Anda dapat mengedit template default yang disediakan oleh Android Studio agar sesuai dengan proses pengembangan. Saat Anda mengedit template, konfigurasi yang sudah ada dan menggunakan template tersebut tidak akan terpengaruh. Jadi, misalnya, jika perlu membuat beberapa konfigurasi jenis tertentu, Anda dapat mengedit template kemudian mengubahnya kembali jika sudah selesai.

Walaupun tidak dapat membuat template baru, Anda dapat membuat konfigurasi yang akan digunakan menyerupai sebuah template. Anda dapat menyalin konfigurasi dan mengedit salinannya untuk membuat konfigurasi baru

Untuk mengedit template, ikuti langkah-langkah berikut:

  1. Buka dialog Konfigurasi Run/Debug.
  2. Luaskan folder Default dan pilih template default.
  3. Ubah konfigurasi sesuai yang diperlukan.
  4. Pastikan untuk mengoreksi error apa pun yang ditampilkan di bagian bawah dialog.

  5. Klik Apply atau OK.

Mengurutkan dan mengelompokkan konfigurasi

Dalam dialog Konfigurasi Run/Debug, Anda dapat mengurutkan konfigurasi untuk menemukannya dengan cepat. Anda dapat mengurutkan item dalam folder menurut abjad, dan membuat folder baru untuk mengelompokkan konfigurasi.

Untuk mengurutkan konfigurasi menurut abjad, ikuti langkah-langkah berikut:

  1. Buka dialog Konfigurasi Run/Debug.
  2. Pilih folder yang berisi konfigurasi.
  3. Klik Urutkan Konfigurasi .
  4. Klik Apply atau OK.

Untuk mengelompokkan konfigurasi dalam folder, ikuti langkah-langkah berikut:

  1. Buka dialog Konfigurasi Run/Debug.
  2. Pilih folder yang berisi konfigurasi.
  3. Klik Create New Folder .
  4. Ketik nama di kolom Folder Name.
  5. Tarik item dari kategori template yang sama ke dalam folder tersebut.
  6. Urutkan folder dan konfigurasi dalam kategori template yang sama dengan menariknya ke posisi atau menggunakan Pindah ke Atas dan Pindah ke Bawah .
  7. Klik Apply atau OK.

Menentukan operasi sebelum peluncuran

Anda dapat menetapkan tugas yang akan dijalankan sebelum menerapkan konfigurasi run/debug. Tugas tersebut akan dijalankan sesuai urutan munculnya dalam daftar.

Catatan: Menentukan sebelum meluncurkan tugas adalah fitur lanjutan. Alih-alih menggunakan fitur ini, sebaiknya Anda menempatkan setiap logika persiapan sebagai tugas dalam file build.gradle sehingga logika tersebut akan dijalankan saat Anda membuat project dari command line.

Untuk membuat daftar tugas, ikuti langkah-langkah berikut:

  1. Di bagian bawah dialog Run/Debug Configurations di bagian Before launch, klik Add dan pilih jenis tugas. Jika sebuah dialog terbuka, isi kolom yang tersedia, lalu klik OK.
  2. Tambahkan tugas lainnya jika diperlukan.
  3. Untuk mengurutkan tugas, pilih tugas, lalu klik Ke atas dan Ke bawah untuk memindahkannya ke atas atau ke bawah dalam daftar.
  4. Pilih Show this page jika Anda ingin menampilkan setelan konfigurasi run/debug sebelum menerapkannya.

    Opsi ini secara default tidak dipilih.

  5. Pilih Active tool window jika Anda ingin jendela alat Run atau Debug diaktifkan saat menjalankan atau men-debug aplikasi.

    Opsi ini dipilih secara default.

Untuk menghapus sebuah tugas dari daftar, ikuti langkah-langkah berikut:

  1. Pilih sebuah tugas.
  2. Klik Hapus .

Untuk mengedit sebuah tugas, ikuti langkah-langkah ini:

  1. Pilih sebuah tugas.
  2. Klik Edit .
  3. Edit setelan tugas dalam dialog yang terbuka, lalu klik OK.

Tabel berikut mencantumkan tugas yang dapat Anda tambahkan.

Tugas Deskripsi
Run External tool Menjalankan aplikasi eksternal Android Studio. Dalam dialog External Tools, pilih satu atau beberapa aplikasi yang ingin Anda jalankan, lalu klik OK. Jika aplikasi belum ditentukan dalam Android Studio, tambahkan definisinya dalam dialog Create Tools. Untuk informasi selengkapnya, lihat Mengonfigurasi Alat Pihak Ketiga dan Alat Eksternal.
Run Another Configuration Menjalankan salah satu konfigurasi run/debug yang ada. Dalam dialog Choose Configuration to Execute, pilih konfigurasi yang akan dijalankan, lalu klik OK.
Make Mengompilasi project atau modul. Android Studio menjalankan perintah Modul Make jika konfigurasi run/debug menetapkan modul tertentu, atau menjalankan perintah Project Make jika tidak ada modul yang ditetapkan.
Make Project Mengompilasi project. Android Studio menjalankan perintah Project Make.
Make, tanpa memeriksa error Opsi ini sama seperti Make, hanya saja Android Studio menjalankan konfigurasi run/debug tanpa bergantung pada hasil kompilasi.
Build Artifacts Tidak didukung di Android Studio.
Run Gradle task Menjalankan tugas Gradle. Dalam dialog yang terbuka, tetapkan detailnya, lalu klik OK. Untuk informasi selengkapnya, lihat Gradle.
Gradle-aware Make Mengompilasi project dan menjalankan Gradle.
App Engine Gradle builder Tugas builder App Engine Gradle menyinkronkan project lalu membuat modul.

Template konfigurasi run/debug default

Android Studio menyediakan template konfigurasi default untuk membantu Anda memulai dengan cepat. Bagian berikut ini menjelaskan template yang berlaku untuk pengembangan Android dengan Android Studio:

Catatan: Android Studio 2.1.x dan yang lebih lama memiliki template Aplikasi Native, yang tidak dimiliki oleh versi yang lebih baru. Jika Anda memiliki template Aplikasi Native di sebuah project, Android Studio akan mengonversinya menjadi Aplikasi Android saat Anda memuat project. Dialog Convert Project akan memandu Anda menyelesaikan prosesnya.

Template yang tidak didukung

Template yang tidak didukung berikut berasal dari IntelliJ IDEA dan tidak khusus untuk pengembangan project Android dengan Android Studio. Untuk informasi tentang penggunaan template ini, ikuti link ke dokumentasi IntelliJ IDEA.

Opsi konfigurasi Name dan Share

Opsi Name dan Share berlaku pada konfigurasi saja. Berikan nama saat Anda membuat konfigurasi, dan jika ingin membagikannya, centang kotak Bagikan. Anda tidak dapat memberi nama dan membagikan template.

Gunakan kotak centang Bagikan untuk membuat konfigurasi run/debug tersedia bagi anggota tim lainnya melalui kontrol versi Jika Anda memilih opsi ini, saat project di-check in ke dalam sistem kontrol versi, konfigurasi run/debug akan disertakan bila seseorang men-check out project tersebut.

Android Studio menyimpan konfigurasi run/debug yang dibagikan dalam setiap file XML dalam folder project_directory/.idea/runConfigurations/. Untuk informasi selengkapnya, lihat Format Project Berbasis Direktori.

Aplikasi Android

Anda dapat menjalankan atau men-debug aktivitas dan aplikasi Android pada perangkat hardware atau virtual menggunakan konfigurasi berbasis template ini.

Tab General

Di tab General, Anda dapat menetapkan opsi penginstalan, peluncuran, dan deployment. Tab Miscellaneous juga berisi opsi penginstalan.

Kolom Deskripsi
Modul Pilih modul untuk menerapkan konfigurasi ini.
Opsi Penginstalan: Deploy

Pilih opsi:

  • APK Default - Membuat dan men-deploy APK untuk varian yang dipilih saat ini.
  • APK dari app bundle - Membuat dan men-deploy aplikasi Anda dari Android App Bundle. Artinya, Android Studio pertama-tama mengonversi project aplikasi Anda menjadi app bundle yang menyertakan semua kode dan resource yang dikompilasi oleh aplikasi tersebut. Kemudian, dari app bundle tersebut, Android Studio hanya menghasilkan APK yang diperlukan untuk men-deploy aplikasi Anda ke perangkat yang terhubung. Biasanya, Anda harus menggunakan opsi ini saat menguji app bundle yang ingin diupload ke Google Play karena men-deploy dari app bundle akan memperpanjang total waktu build.
  • Custom Artifact - Tidak didukung di Android Studio.
  • Nothing - Tidak menginstal APK di perangkat. Misalnya, jika Anda lebih suka menginstal APK secara manual, Anda tidak perlu Android Studio untuk menginstalnya.
Opsi Penginstalan: Deploy sebagai aplikasi instan Jika aplikasi mendukung pengalaman instan—artinya, Anda menambahkan dukungan untuk aplikasi instan saat membuat project baru, atau membuat satu atau beberapa modul fitur yang diaktifkan secara instan—Anda dapat memilih untuk men-deploy modul yang diaktifkan secara instan tersebut dengan mencentang kotak di sebelah Deploy as instant app.
Opsi Penginstalan: Fitur untuk di-deploy Jika aplikasi menyertakan modul fitur, centang kotak di samping setiap fitur yang ingin disertakan saat men-deploy aplikasi. Anda melihat opsi ini hanya jika aplikasi menyertakan modul fitur.

Catatan: Jika ingin menguji proses download dan penginstalan modul fitur on demand, Anda harus melakukannya setelah memublikasikan app bundle, lalu menggunakan jalur pengujian internal Konsol Play. Untuk mempelajari lebih lanjut, baca Mengupload app bundle ke Konsol Play.

Opsi Penginstalan: Instal Tanda Ketik opsi pm install adb apa pun yang ingin Anda gunakan. Format opsi dengan cara yang sama seperti pada command line, tetapi tanpa jalur. Berikut beberapa contohnya:

-i foo.bar.baz -r /path/to/apk

dan

-d -r

Default: tanpa opsi.

Launch Options: Launch

Pilih opsi:

  • Nothing - Tidak meluncurkan apa pun saat Anda memilih **Run** atau **Debug**. Namun, jika aplikasi telah berjalan dan Anda memilih **Debug**, Android Studio akan melampirkan debugger ke proses aplikasi Anda.
  • Aktivitas Default - Meluncurkan aktivitas yang telah Anda tandai sebagai startup di manifes. Misalnya:
    
    <intent-filter>
      <action android:name="android.intent.action.MAIN" />
      <category android:name="android.intent.category.LAUNCHER" />
    </intent-filter>
    
  • Aktivitas yang Ditetapkan - Meluncurkan aktivitas aplikasi yang telah ditetapkan di modul Anda. Jika dipilih, kolom Aktivitas akan muncul di bawah, tempat Anda dapat mengetik nama aktivitas yang ingin Anda luncurkan, atau klik Lainnya untuk memilih aktivitas dari daftar.
  • URL - Meluncurkan URL yang cocok dengan filter intent dalam manifes aplikasi Anda. Jika dipilih, kolom URL muncul di bawah, tempat Anda dapat memasukkan URL.

    Anda juga harus mengisi kolom ini untuk meluncurkan Aplikasi Instan Android. Anda juga dapat menggunakan ini untuk menguji Link Aplikasi Android.

Opsi Peluncuran: Luncurkan Tanda Ketik opsi am start adb apa pun yang ingin Anda gunakan. Format opsi tersebut dengan cara yang sama seperti pada command line, tetapi tanpa intent. Contoh:

-W

Opsi ini tidak muncul jika Anda memilih nilai Luncurkan dari Nothing.

Default: tanpa opsi.

Deployment Target Options: Target

Pilih opsi:

  • Buka Dialog Pilih Target Deployment - Buka Pilih Target Deployment untuk memilih hardware atau perangkat virtual.
  • Perangkat USB - Menggunakan hardware yang terhubung ke komputer pengembangan Anda melalui port USB. Jika ada lebih dari satu komputer, Anda dapat memilih salah satunya melalui dialog yang ditampilkan.
  • Emulator - Menggunakan perangkat virtual. Dalam konfigurasi, Anda dapat memilih AVD; jika tidak, maka AVD pertama dalam daftar akan digunakan.

Opsi Target Deployment: Gunakan perangkat yang sama untuk peluncuran di waktu lain

Secara default, opsi ini tidak dipilih sehingga setiap kali Anda menjalankan aplikasi, dialog Pilih Deployment akan ditampilkan untuk memilih perangkat. Jika Anda memilih opsi ini, kemudian menjalankan aplikasi, dialog Pilih Deployment akan ditampilkan untuk memilih perangkat. Kemudian, setiap kali dijalankan, aplikasi akan terbuka pada perangkat yang Anda pilih tanpa menampilkan dialog Pilih Deployment. Untuk menjalankan aplikasi di perangkat lain, batalkan pilihan Use same device for future launches, atau hentikan aplikasi dengan Run > Stop app atau Stop , lalu mulai lagi. Dialog Pilih Deployment akan ditampilkan sehingga Anda dapat memilih perangkat.
Sebelum Peluncuran Lihat Menentukan Operasi Sebelum Peluncuran.

Tab Miscellaneous

Di tab Miscellaneous Anda dapat menetapkan opsi logcat, penginstalan, peluncuran, dan deployment. Tab General juga berisi opsi penginstalan.

Kolom Deskripsi
Logcat: Show logcat automatically Jika opsi ini dipilih, jendela Logcat terbuka setiap kali Anda berhasil men-deploy dan meluncurkan aplikasi menggunakan konfigurasi ini. Default: dipilih.
Logcat: Hapus log sebelum peluncuran Pilih opsi ini jika Anda ingin Android Studio menghapus data dari file log sesi sebelumnya sebelum memulai aplikasi. Default: tidak dipilih.
Opsi Penginstalan: Lewatkan penginstalan jika APK belum berubah. Jika dipilih, Android Studio tidak akan men-deploy ulang APK Anda jika tidak mendeteksi perubahan apa pun. Jika ingin Android Studio memaksakan penginstalan APK sekalipun APK belum berubah, maka jangan pilih opsi ini. Default: dipilih
Opsi Penginstalan: Paksa aplikasi berhenti sebelum aktivitas peluncuran

Jika dipilih, saat mendeteksi bahwa penginstalan ulang APK tidak diperlukan karena APK belum berubah, Android Studio akan memaksa aplikasi berhenti sehingga aplikasi tersebut dimulai dari aktivitas peluncur default. Jika opsi ini tidak dipilih, Android Studio tidak akan memaksa aplikasi untuk berhenti.

Opsi ini berfungsi dengan opsi sebelumnya yang mengontrol apakah APK diinstal atau tidak. Untuk kedua kolom Opsi Penginstalan, biarkan nilainya default kecuali jika Anda secara eksplisit ingin selalu memaksakan penginstalan.

Dalam beberapa kasus, Anda mungkin ingin membatalkan pemilihan opsi ini. Misalnya, jika Anda menulis mesin metode input (IME), memaksa aplikasi berhenti akan membuatnya tidak dipilih sebagai keyboard saat ini, dan hal ini mungkin tidak Anda inginkan.

Default: dipilih

Sebelum Peluncuran Lihat Menentukan Operasi Sebelum Peluncuran.

Tab Debugger

Menetapkan opsi debug di tab Debugger.

Untuk kode C dan C++, Android Studio menggunakan debugger LLDB. Selain UI Android Studio normal jendela debugger memiliki tab LLDByang memungkinkan Anda untuk memasukkan perintah LLDB selama men-debug. Anda dapat memasukkan perintah yang sama seperti yang digunakan Android Studio untuk menampilkan informasi di UI debugger, dan dapat menjalankan operasi tambahan.

Untuk project C dan C++, Anda dapat menambahkan direktori simbol, serta perintah post attach dan startup LLDB, di tab Debugger. Untuk melakukannya, gunakan tombol seperti berikut:

  • Add - Menambahkan direktori atau perintah.
  • Hapus - Pilih direktori atau perintah, lalu klik tombol ini untuk menghapus item tersebut.
  • Ke atas - Pilih direktori atau perintah, lalu klik tombol ini untuk memindahkan item ke atas dalam daftar.
  • Ke bawah - Pilih direktori atau perintah, lalu klik tombol ini untuk memindahkan item ke bawah dalam daftar.

Lihat Men-debug Aplikasi Anda untuk informasi selengkapnya mengenai proses debug di Android Studio.

Kolom Deskripsi
Debug type

Pilih salah satu opsi berikut:

  • Java - Hanya men-debug kode Java.
  • Auto - Membiarkan Android Studio memilih jenis debug terbaik untuk project Anda.
  • Native - Men-debug kode C atau C++ native.
  • Dual - Men-debug Java dan kode native dalam dua sesi debug terpisah.

OPsi Auto disarankan karena opsi ini otomatis memilih jenis debug yang tepat untuk project Anda.

Direktori Simbol

Jika ingin menambahkan file simbol untuk menyediakan informasi C atau C++ kepada debugger yang dihasilkan di luar Android Studio, Anda dapat menambahkan satu atau beberapa direktori di sini. Android Studio lebih memilih menggunakan file dalam direktori ini dibandingkan file yang dihasilkan oleh Plugin Android untuk Gradle. Debugger menelusuri direktori dari atas ke bawah, secara berurutan, hingga menemukan yang dibutuhkan. Debugger menelusuri secara berulang pada file dalam direktori. Untuk mengoptimalkan daftar dan menghemat waktu, tempatkan direktori yang paling sering digunakan di daftar teratas.

Jika Anda menetapkan direktori di tempat yang tinggi pada hierarki, penelusuran di semua subdirektori akan memerlukan waktu lebih lama. Jika Anda menambahkan direktori yang sangat spesifik, maka waktu yang dibutuhkan untuk menelusuri akan lebih cepat. Anda perlu menemukan keseimbangan antara kecepatan dan menemukan file yang diperlukan untuk melakukan debug. Misalnya, jika Anda memiliki direktori yang berisi subdirektori untuk Antarmuka Android Biner (ABI) yang berbeda, Anda dapat memilih untuk menambahkan direktori untuk ABI tertentu atau untuk semua ABI. Meskipun perlu waktu lebih lama untuk menelusuri direktori tingkat atas, langkah ini lebih terjamin jika Anda memutuskan untuk melakukan debug pada perangkat yang berbeda.

Perhatikan, Anda tidak perlu menambahkan direktori yang berisi file simbol Gradle karena debugger menggunakannya secara otomatis.

LLDB Startup Commands

Tambahkan perintah LLDB yang ingin Anda jalankan sebelum debugger dilampirkan ke proses. Misalnya, Anda dapat menentukan setelan untuk lingkungan, seperti yang ditampilkan dalam perintah berikut:

settings set target.max-memory-read-size 2048

LLDB menjalankan perintah dengan urutan dari atas ke bawah.

LLDB Post Attach Commands

Tambahkan perintah LLDB yang ingin Anda jalankan tepat setelah debugger dilampirkan ke proses. Contoh:

process handle SIGPIPE -n true -p true -s false

LLDB menjalankan perintah dengan urutan dari atas ke bawah.

Host working directory Tentukan direktori kerja LLDB.
Logging: Target channels

Tentukan opsi log LLDB. Android Studio menetapkan opsi default berdasarkan pengalaman tim — sehingga prosesnya tidak terlalu lambat tetapi berisi informasi yang dibutuhkan untuk pemecahan masalah. Log seringkali diminta untuk laporan bug Android Studio. Defaultnya adalah

lldb process:gdb-remote packets

Anda dapat mengubah setelan default untuk mengumpulkan informasi lebih banyak. Misalnya, opsi log berikut mengumpulkan informasi tentang platform tertentu:

lldb process platform:gdb-remote packets

Untuk daftar lengkap perintah log masukkan perintah log list dari jendela shell LLDB di Android Studio.

Android Studio menempatkan log perangkat di lokasi berikut, di mana ApplicationId adalah ID aplikasi unik yang digunakan dalam manifes APK bawaan Anda, dan mengidentifikasi aplikasi Anda di perangkat Anda dan di Google Play Store:

/data/data/ApplicationId/lldb/log

Atau, jika diakses beberapa pengguna, perangkat akan menempatkan log di lokasi berikut, di mana AndroidUserId adalah ID unik untuk pengguna di perangkat:

/data/user/AndroidUserId/ApplicationId/lldb/log

Untuk informasi tentang penggunaan LLDB dalam men-debug dari jauh, lihat Men-debug dari Jauh.

Sebelum Peluncuran Lihat Menentukan Operasi Sebelum Peluncuran.

Tab Profiling

Opsi Aktifkan profiling lanjutan harus dicentang untuk mengaktifkan fitur tertentu di Android Profiler jika perangkat Anda menjalankan Android 7.1 atau yang lebih lama.

Pengujian Android

Template pengujian yang harus digunakan bergantung pada set sumber Anda. Template Pengujian Berinstrumen Android digunakan untuk pengujian berinstrumen. Template Android JUnit adalah untuk pengujian unit lokal.

Catatan: Jika menggunakan Firebase Test Lab untuk menguji pada berbagai perangkat, Anda dapat menggunakan template Android JUnit untuk menentukan pengujian berinstrumen. Untuk informasi selengkapnya, lihat Menjalankan Pengujian dengan Firebase Test Lab.

Deskripsi tab berikut mencakup tab dan kolom untuk template pengujian Berinstrumen Android. Untuk informasi tentang tab dan kolom dalam template pengujian Android JUnit, lihat halaman IntelliJ Konfigurasi Run/Debug: JUnit.

Tab General

Di tab General, Anda dapat menentukan lokasi pengujian, runner instrumentasi, adb shell, dan opsi deployment.

Kolom Deskripsi
Modul Pilih modul untuk menerapkan konfigurasi ini.
Pengujian

Di area ini, tetapkan lokasi pengujian yang ingin Anda jalankan:

  • Modul untuk semua - Meluncurkan semua pengujian dari modul yang dipilih.
  • Paket untuk semua - Meluncurkan semua pengujian dari paket yang ditetapkan dalam kolom Paket. Ketik namanya, atau klik Lainnya untuk memilih paket dari dialog.
  • Class - Meluncurkan pengujian class yang ditetapkan di kolom Class . Ketik namanya, atau klik Lainnya untuk memilih class dari dialog.
  • Metode - Meluncurkan metode pengujian. di kolom Class, tetapkan class yang berisi metode. Di kolom Metode, tetapkan metode. Ketik namanya, atau klik Lainnya untuk memilih class atau metode dari dialog.
Runner instrumentasi khusus (opsional) Ketik lokasi runner instrumentasi; klik Lainnya untuk menggunakan dialog. File build.gradle menetapkan lokasi runner instrumentasi; nilai ini akan menggantikannya. Setelan default biasanya adalah class AndroidJUnitRunner dari Pengujian AndroidX.
Opsi tambahan

Ketik opsi am instrument adb apa pun yang ingin Anda gunakan. Jangan ketik komponennya. Misalnya, jika Anda menggunakan AndroidJUnitRunner dari Pengujian AndroidX, Anda dapat menggunakan kolom ini untuk memberikan opsi tambahan kepada runner, seperti -e size small.

Default: tanpa opsi

Deployment Target Options: Target

Pilih opsi:

  • Buka Dialog Pilih Target Deployment - Buka Pilih Target Deployment untuk memilih hardware atau perangkat virtual.
  • Perangkat USB - Menggunakan hardware yang terhubung ke komputer pengembangan Anda melalui port USB. Jika ada lebih dari satu komputer, Anda dapat memilih salah satunya melalui dialog yang ditampilkan.
  • Emulator - Menggunakan perangkat virtual. Dalam konfigurasi, Anda dapat memilih AVD; jika tidak, maka AVD pertama dalam daftar akan digunakan.
  • Matriks Perangkat Firebase Test Lab - Lihat Menjalankan Pengujian dengan Firebase Test Lab.
Deployment Target Options: Gunakan perangkat yang sama untuk peluncuran di lain waktu Jika Anda ingin secara otomatis menggunakan perangkat yang dipilih melalui dialog Select Deployment Target di lain waktu, pilih opsi ini. Jika perangkat tidak tersedia, Anda akan menerima sebuah dialog. Default: tidak dipilih
Sebelum Peluncuran Lihat Menentukan Operasi Sebelum Peluncuran.

Tab Miscellaneous

Tab Miscellaneous berisi logcat dan opsi penginstalan.

Kolom Deskripsi
Logcat: Hapus log sebelum peluncuran Pilih opsi ini jika Anda ingin Android Studio menghapus data dari file log sesi sebelumnya sebelum memulai aplikasi. Default: tidak dipilih.
Opsi Penginstalan: Lewatkan penginstalan jika APK belum berubah Jika dipilih, Android Studio tidak akan men-deploy ulang APK Anda jika tidak mendeteksi perubahan apa pun. Jika Anda ingin Android Studio memaksakan penginstalan APK sekalipun APK belum berubah, jangan pilih opsi ini. Default: dipilih
Opsi Penginstalan: Paksa aplikasi berhenti sebelum aktivitas peluncuran

Jika dipilih, saat mendeteksi bahwa penginstalan ulang APK tidak diperlukan karena APK belum berubah, Android Studio akan memaksa aplikasi berhenti sehingga aplikasi tersebut dimulai dari aktivitas peluncur default. Jika opsi ini tidak dipilih, Android Studio tidak akan memaksa aplikasi untuk berhenti.

Opsi ini berfungsi bersama opsi sebelumnya yang mengontrol apakah APK telah diinstal atau belum. Untuk kedua kolom Opsi Penginstalan, biarkan nilainya default kecuali jika Anda secara eksplisit ingin selalu memaksakan penginstalan.

Dalam beberapa kasus, Anda mungkin ingin membatalkan pemilihan opsi ini. Misalnya, jika Anda menulis mesin metode input (IME), memaksa aplikasi berhenti akan membuatnya tidak dipilih sebagai keyboard saat ini, dan hal ini mungkin tidak Anda inginkan.

Default: dipilih

Sebelum Peluncuran Lihat Menentukan Operasi Sebelum Peluncuran.

Tab Debugger

Menetapkan opsi debug di tab Debugger.

Untuk kode C dan C++, Android Studio menggunakan debugger LLDB. Selain UI Android Studio normal jendela debugger memiliki tab LLDByang memungkinkan Anda untuk memasukkan perintah LLDB selama men-debug. Anda dapat memasukkan perintah yang sama seperti yang digunakan Android Studio untuk menampilkan informasi di UI debugger, dan dapat menjalankan operasi tambahan.

Untuk project C dan C++, Anda dapat menambahkan direktori simbol, serta perintah post attach dan startup LLDB, di tab Debugger. Untuk melakukannya, gunakan tombol seperti berikut:

  • Add - Menambahkan direktori atau perintah.
  • Hapus - Pilih direktori atau perintah, lalu klik tombol ini untuk menghapus item tersebut.
  • Ke atas - Pilih direktori atau perintah, lalu klik tombol ini untuk memindahkan item ke atas dalam daftar.
  • Ke bawah - Pilih direktori atau perintah, lalu klik tombol ini untuk memindahkan item ke bawah dalam daftar.

Lihat Men-debug Aplikasi Anda untuk informasi selengkapnya mengenai proses debug di Android Studio.

Kolom Deskripsi
Debug type

Pilih salah satu opsi berikut:

  • Java - Hanya men-debug kode Java.
  • Auto - Membiarkan Android Studio memilih jenis debug terbaik untuk project Anda.
  • Native - Men-debug kode C atau C++ native.
  • Dual - Men-debug Java dan kode native dalam dua sesi debug terpisah.

OPsi Auto disarankan karena opsi ini otomatis memilih jenis debug yang tepat untuk project Anda.

Direktori Simbol

Jika ingin menambahkan file simbol untuk menyediakan informasi C atau C++ kepada debugger yang dihasilkan di luar Android Studio, Anda dapat menambahkan satu atau beberapa direktori di sini. Android Studio lebih memilih menggunakan file dalam direktori ini dibandingkan file yang dihasilkan oleh Plugin Android untuk Gradle. Debugger menelusuri direktori dari atas ke bawah, secara berurutan, hingga menemukan yang dibutuhkan. Debugger menelusuri secara berulang pada file dalam direktori. Untuk mengoptimalkan daftar dan menghemat waktu, tempatkan direktori yang paling sering digunakan di daftar teratas.

Jika Anda menetapkan direktori di tempat yang tinggi pada hierarki, penelusuran di semua subdirektori akan memerlukan waktu lebih lama. Jika Anda menambahkan direktori yang sangat spesifik, maka waktu yang dibutuhkan untuk menelusuri akan lebih cepat. Anda perlu menemukan keseimbangan antara kecepatan dan menemukan file yang diperlukan untuk melakukan debug. Misalnya, jika Anda memiliki direktori yang berisi subdirektori untuk Antarmuka Android Biner (ABI) yang berbeda, Anda dapat memilih untuk menambahkan direktori untuk ABI tertentu atau untuk semua ABI. Meskipun perlu waktu lebih lama untuk menelusuri direktori tingkat atas, langkah ini lebih terjamin jika Anda memutuskan untuk melakukan debug pada perangkat yang berbeda.

Perhatikan, Anda tidak perlu menambahkan direktori yang berisi file simbol Gradle karena debugger menggunakannya secara otomatis.

LLDB Startup Commands

Tambahkan perintah LLDB yang ingin Anda jalankan sebelum debugger dilampirkan ke proses. Misalnya, Anda dapat menentukan setelan untuk lingkungan, seperti yang ditampilkan dalam perintah berikut:

settings set target.max-memory-read-size 2048

LLDB menjalankan perintah dengan urutan dari atas ke bawah.

LLDB Post Attach Commands

Tambahkan perintah LLDB yang ingin Anda jalankan tepat setelah debugger dilampirkan ke proses. Contoh:

process handle SIGPIPE -n true -p true -s false

LLDB menjalankan perintah dengan urutan dari atas ke bawah.

Host working directory Tentukan direktori kerja LLDB.
Logging: Target channels

Tentukan opsi log LLDB. Android Studio menetapkan opsi default berdasarkan pengalaman tim — sehingga prosesnya tidak terlalu lambat tetapi berisi informasi yang dibutuhkan untuk pemecahan masalah. Log seringkali diminta untuk laporan bug Android Studio. Defaultnya adalah

lldb process:gdb-remote packets

Anda dapat mengubah setelan default untuk mengumpulkan informasi lebih banyak. Misalnya, opsi log berikut mengumpulkan informasi tentang platform tertentu:

lldb process platform:gdb-remote packets

Untuk daftar lengkap perintah log masukkan perintah log list dari jendela shell LLDB di Android Studio.

Android Studio menempatkan log perangkat di lokasi berikut, di mana ApplicationId adalah ID aplikasi unik yang digunakan dalam manifes APK bawaan Anda, dan mengidentifikasi aplikasi Anda di perangkat Anda dan di Google Play Store:

/data/data/ApplicationId/lldb/log

Atau, jika diakses beberapa pengguna, perangkat akan menempatkan log di lokasi berikut, di mana AndroidUserId adalah ID unik untuk pengguna di perangkat:

/data/user/AndroidUserId/ApplicationId/lldb/log

Untuk informasi tentang penggunaan LLDB dalam men-debug dari jauh, lihat Men-debug dari Jauh.

Sebelum Peluncuran Lihat Menentukan Operasi Sebelum Peluncuran.

App Engine DevAppServer

Konfigurasi run/debug ini diterapkan pada Google Cloud Platform. Untuk informasi selengkapnya, lihat Menjalankan, Menguji, dan Men-deploy Backend. Saat mengikuti langkah-langkah berikut dan menyinkronkan project ke file build.gradle, Android Studio akan membuat konfigurasi App Engine DevAppServer untuk Anda.

Perlu diketahui bahwa template App Engine Server dari IntellJ IDEA adalah template yang berbeda dan tidak tersedia di Android Studio.

Kolom Deskripsi
Satu instance saja Jika Anda ingin memastikan bahwa hanya ada satu instance konfigurasi run/debug yang dijalankan saat ini, pilih opsi ini. Opsi ini tidak mengizinkan beberapa konfigurasi yang sama dijalankan secara bersamaan. Default: dipilih
Modul Pilih modul untuk menerapkan konfigurasi ini.
Sinkronkan dengan konfigurasi build.gradle Jika Anda menambahkan modul App Engine dan menyinkronkan ke file build.gradle kolom-kolom konfigurasi App Engine DevAppServer akan diisikan untuk Anda (disarankan). Memilih File > Sinkronkan Project dengan File juga akan menyinkronkan project. Default: dipilih
App Engine SDK Ketik jalur ke Google App Engine SDK untuk Java di mesin lokal. Klik ... untuk memilihnya dari dialog.
War Path Ketik jalur ke direktori Web Application Archive (WAR) dari aplikasi yang sedang Anda deploy pada server pengembangan lokal. Klik ... untuk memilihnya dari dialog.
VM Args

Tetapkan opsi command line yang ingin Anda teruskan ke VM untuk meluncurkan DevAppServer. Ketika menetapkan berbagai opsi:

  • Gunakan spasi untuk memisahkan opsi yang berbeda.
  • Untuk opsi yang memiliki spasi, masukkan spasi dalam tanda petik (" ").
  • Jika opsi menyertakan tanda petik, tambahkan garis miring terbalik sebelum tanda petik (\").

Untuk informasi selengkapnya tentang opsi VM, lihat dokumentasi untuk versi J2SE Anda, seperti java JDK 7 dan java JDK 8.

Default: tanpa opsi

Alamat Server Ketik alamat host yang akan digunakan untuk server. Anda mungkin perlu memberikan alamat agar dapat mengakses server pengembangan dari komputer lain di jaringan. Alamat 0.0.0.0 memungkinkan akses localhost dan akses hostname. Default: localhost
Server Port Ketik nomor port yang akan digunakan untuk server. Default: 8080
Nonaktifkan Pemeriksaan untuk Update App Engine SDK Jika diberikan, server pengembangan tidak akan menghubungi App Engine untuk memeriksa ketersediaan rilis baru SDK. Secara default, server memeriksa versi baru saat startup, dan mencetak pesan jika versi baru tersedia.
Sebelum Peluncuran Lihat Menentukan Operasi Sebelum Peluncuran.