Membuat dan Mengedit Konfigurasi Run/Debug

Pilih opsi ini agar konfigurasi run/debug tersedia untuk anggota tim lainnya melalui kontrol versi. Anda bisa berbagi konfigurasi run/debug, namun tidak boleh template. Jika Anda memilih opsi ini, bila proyek telah disimpan ke Git (atau sistem kontrol versi lain), konfigurasi run/debug akan disertakan bila seseorang memeriksa proyek.

Android Studio menyimpan konfigurasi run/debug bersama dalam file XML individual di folder .idea/runConfigurations; jika tidak maka konfigurasi disimpan di file .idea/workspace.xml. Untuk informasi selengkapnya, lihat Format Proyek Berbasis Direktori.

Default: tidak dipilih

Pilih sebuah opsi:

• Default APK (default) - Membuat sebuah APK seperti yang ditetapkan dalam konfigurasi versi Anda.
• Custom Artifact - Tidak didukung di Android Studio.
• Nothing - Tidak memasang APK di perangkat. Misalnya, jika lebih suka memasang APK secara manual, Anda tidak membutuhkan Android Studio untuk memasangnya.

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

dan

-d -r

Default: tanpa opsi

Pilih sebuah opsi:

• Nothing - Tidak meluncurkan apa pun. Jika Anda telah menetapkan Nothing dalam bidang Deploy, saat aplikasi sedang berjalan, dan Anda memilih Debug, maka opsi ini sama dengan menggunakan Attach debugger to Android process; sehingga memilih Run tidak akan melakukan apa pun.
• Default Activity (default) - Meluncurkan aktivitas yang 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>

• Specified Activity - Meluncurkan aktivitas aplikasi tertentu di modul Anda. Ketik nama, atau klik … untuk memilih sebuah aktivitas dari daftar.
• URL - Menetapkan URL yang akan dibuka. Lihat Menguji URL.

-W

Opsi ini tidak muncul jika Anda memilih Launch dengan nilai Nothing.

Default: tanpa opsi

Pilih sebuah opsi:

• Open Select Deployment Target Dialog (default) - Membuka dialog Select Deployment Target untuk memilih perangkat keras atau perangkat virtual.
• USB Device - Menggunakan perangkat keras yang terhubung ke komputer development Anda melalui port USB. Jika ada lebih dari satu, sebuah dialog akan muncul sehingga Anda bisa memilihnya.
• Emulator - Menggunakan perangkat virtual. Di konfigurasi, Anda bisa memilih AVD; jika tidak maka AVD pertama dalam daftar yang akan digunakan.

Deployment Target Options: Use same device for future launches

Jika dipilih, saat Android Studio mendeteksi bahwa ia tidak harus memasang ulang APK karena belum berubah, ia akan memaksa aplikasi berhenti sehingga aplikasi memulai 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 dipasang atau belum. Untuk kedua bidang Installation Options, biarkan dengan nilai defaultnya kecuali bila Anda secara eksplisit selalu ingin memaksa pemasangan.

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

Default: dipilih

Pilih salah satu opsi berikut:

• Auto (default) - Membiarkan Android Studio memilih tipe debug terbaik untuk proyek Anda.
• Java - Hanya men-debug kode Java.
• Native - Men-debug kode C atau C++ native.
• Hybrid - Men-debug kode Java dan native dalam dua sesi debug terpisah.

Opsi Auto disarankan karena opsi ini secara otomatis memilih tipe debug yang tepat untuk proyek Anda.

Pilih opsi ini untuk men-debug kode Android C++ dan Java di dalam sesi debug LLDB yang sama. Debugger Java-aware C++ adalah ekstensi mode debugger Native; bersama dengan debugging C++, mode ini juga mendukung Java.

Untuk dapat menggunakan fitur ini, proyek harus

• menggunakan Android 7.0 (API Level 21) atau yang lebih tinggi
• memiliki tipe Debug Native atau Auto

Jika Anda memilih tipe Debug Auto, Android Studio secara otomatis memilih opsi ini jika proyek memenuhi persyaratan. Perhatikan bahwa jika Anda memiliki proyek hanya-Java dan ingin menggunakan LLDB untuk men-debugnya, Anda bisa memilih opsi ini dan Native.

Seperti Android Studio 2.2, fitur ini bersifat eksperimental. Untuk informasi selengkapnya, lihat Menggunakan Debugger Java-aware C++ Eksperimental.

Default: tidak dipilih

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

Jika menetapkan direktori di tempat yang tinggi pada pohon, pencarian di semua subdirektori akan memakan waktu lebih lama. Jika Anda menambahkan direktori yang sangat spesifik, maka waktu yang dibutuhkan untuk menelusur akan lebih cepat. Anda perlu menemukan keseimbangan antara kecepatan dan menemukan file yang Anda perlukan untuk melakukan debug. Misalnya, jika Anda memiliki direktori yang berisi subdirektori untuk Android Binary Interfaces (ABI) yang berbeda, Anda bisa memilih untuk menambahkan direktori ke ABI tertentu atau ke semua ABI. Walaupun akan memakan waktu lebih lama untuk menelusuri seluruh direktori tingkat atas, namun ini adalah langkah yang paling mudah bila Anda ingin men-debug pada perangkat lain.

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

Menambahkan perintah LLDB yang ingin dieksekusi sebelum debugger terlampir pada proses. Misalnya, Anda bisa mendefinisikan setelan untuk lingkungan, seperti yang ditampilkan di perintah berikut ini:

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

LLDB mengeksekusi perintah dengan urutan dari atas ke bawah.

Menambahkan perintah LLDB yang ingin Anda eksekusi tepat setelah debugger terlampir pada proses. Misalnya:

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

LLDB mengeksekusi perintah dengan urutan dari atas ke bawah.

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

lldb process:gdb-remote packets

Anda bisa mengubah default untuk mengumpulkan informasi lebih banyak. Misalnya, opsi log berikut mengumpulkan informasi tentang platform khusus:

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

Android Studio menempatkan log perangkat di lokasi berikut, dengan ApplicationId adalah ID aplikasi unik yang digunakan dalam manifes APK yang dibuat, dan mengidentifikasi aplikasi pada perangkat Anda dan di Google Play store:

/data/data/ApplicationId/lldb/log

Atau, jika beberapa pengguna mengakses suatu perangkat, perangkat menempatkan log di lokasi berikut, dengan AndroidUserId adalah pengidentifikasi unik untuk pengguna pada perangkat:

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

Mengenai informasi tentang penggunaan LLDB untuk men-debug dari jauh, lihat Remote Debugging.

Jika diaktifkan, konfigurasi run/debug ini akan membangun, memasang, dan menjalankan aplikasi dengan pelacakan GPU. Pelacakan tidak didukung saat men-debug aplikasi. Jika Anda men-debug aplikasi dengan pelacakan GPU, Anda akan menerima pesan dan debugger meluncur tanpa pelacakan. Opsi ini relevan untuk alat bantu GPU Debugger.

Perhatikan bahwa setelah Anda mengaktifkan kotak centang ini, setiap kali Anda meluncurkan aplikasi, aplikasi akan memblokir dan menunggu Anda melampirkan debugger atau GPU Debugger.

Pilih opsi ini untuk menonaktifkan dukungan driver grafis OpenGL ES untuk shader dan binari program prakompilasi yang langsung bisa digunakan selama pelacakan. Opsi ini relevan untuk alat bantu GPU Debugger.

Shader prakompilasi tidak mendukung pemutaran ulang pelacakan, sehingga hanya shader yang dikompilasi pada waktu proses menggunakan fungsi glShaderSource yang dapat digunakan untuk inspeksi framebuffer.

Aplikasi harus selalu melakukan kueri untuk dukungan shader prakompilasi sebelum menggunakan fungsi glShaderBinary atau glProgramBinary, dan kembali ke kompilasi waktu proses jika shader atau program prakompilasi tidak didukung.

Default: tidak dipilih

Pilih opsi ini agar konfigurasi run/debug tersedia untuk anggota tim lainnya melalui kontrol versi. Anda bisa berbagi konfigurasi run/debug, namun tidak boleh template. Jika Anda memilih opsi ini, bila proyek telah disimpan ke Git (atau sistem kontrol versi lain), konfigurasi run/debug akan disertakan bila seseorang memeriksa proyek.

Android Studio menyimpan konfigurasi run/debug bersama dalam file XML individual di folder .idea/runConfigurations; jika tidak maka konfigurasi disimpan di file .idea/workspace.xml. Untuk informasi selengkapnya, lihat Format Proyek Berbasis Direktori.

Default: tidak dipilih

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

• All in module (default) - Meluncurkan semua pengujian dari modul yang dipilih.
• All in package - Meluncurkan pengujian dari paket yang ditetapkan dalam bidang Package. Ketik namanya, atau klik … untuk memilih paket dari dialog.
• Class - Meluncurkan pengujian kelas yang ditetapkan dalam bidang Class. Ketik namanya, atau klik … untuk memilih kelas dari dialog.
• Method - Meluncurkan metode pengujian. Dalam bidang Class, tetapkan kelas yang berisi metode. Dalam bidang Method, tetapkan metode. Ketik namanya, atau klik … untuk memilih kelas atau metode dari dialog.

Pilih sebuah opsi:

• Open Select Deployment Target Dialog (default) - Membuka dialog Select Deployment Target untuk memilih perangkat keras atau perangkat virtual.
• USB Device - Menggunakan perangkat keras yang terhubung ke komputer development Anda melalui port USB. Jika ada lebih dari satu, sebuah dialog akan muncul sehingga Anda bisa memilihnya.
• Emulator - Menggunakan perangkat virtual. Di konfigurasi, Anda bisa memilih AVD; jika tidak maka AVD pertama dalam daftar yang akan digunakan.
• Firebase Test Lab Device Matrix - Lihat Menjalankan Pengujian Anda dengan Firebase Test Lab.

Jika dipilih, saat Android Studio mendeteksi bahwa ia tidak harus memasang ulang APK karena belum berubah, ia akan memaksa aplikasi berhenti sehingga aplikasi memulai 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 dipasang atau belum. Untuk kedua bidang Installation Options, biarkan dengan nilai defaultnya kecuali bila Anda secara eksplisit selalu ingin memaksa pemasangan.

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

Default: dipilih

Pilih salah satu opsi berikut:

• Auto (default) - Membiarkan Android Studio memilih tipe debug terbaik untuk proyek Anda.
• Java - Hanya men-debug kode Java.
• Native - Men-debug kode C atau C++ native.
• Hybrid - Men-debug kode Java dan native dalam dua sesi debug terpisah.

Opsi Auto disarankan karena opsi ini secara otomatis memilih tipe debug yang tepat untuk proyek Anda.

Pilih opsi ini untuk men-debug kode Android C++ dan Java di dalam sesi debug LLDB yang sama. Debugger Java-aware C++ adalah ekstensi mode debugger Native; bersama dengan debugging C++, mode ini juga mendukung Java.

Untuk dapat menggunakan fitur ini, proyek harus

• menggunakan Android 7.0 (API Level 21) atau yang lebih tinggi
• memiliki tipe Debug Native atau Auto

Jika Anda memilih tipe Debug Auto, Android Studio secara otomatis memilih opsi ini jika proyek memenuhi persyaratan. Perhatikan bahwa jika Anda memiliki proyek hanya-Java dan ingin menggunakan LLDB untuk men-debugnya, Anda bisa memilih opsi ini dan Native.

Seperti Android Studio 2.2, fitur ini bersifat eksperimental. Untuk informasi selengkapnya, lihat Menggunakan Debugger Java-aware C++ Eksperimental.

Default: tidak dipilih

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

Jika menetapkan direktori di tempat yang tinggi pada pohon, pencarian di semua subdirektori akan memakan waktu lebih lama. Jika Anda menambahkan direktori yang sangat spesifik, maka waktu yang dibutuhkan untuk menelusur akan lebih cepat. Anda perlu menemukan keseimbangan antara kecepatan dan menemukan file yang Anda perlukan untuk melakukan debug. Misalnya, jika Anda memiliki direktori yang berisi subdirektori untuk Android Binary Interfaces (ABI) yang berbeda, Anda bisa memilih untuk menambahkan direktori ke ABI tertentu atau ke semua ABI. Walaupun akan memakan waktu lebih lama untuk menelusuri seluruh direktori tingkat atas, namun ini adalah langkah yang paling mudah bila Anda ingin men-debug pada perangkat lain.

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

Menambahkan perintah LLDB yang ingin dieksekusi sebelum debugger terlampir pada proses. Misalnya, Anda bisa mendefinisikan setelan untuk lingkungan, seperti yang ditampilkan di perintah berikut ini:

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

LLDB mengeksekusi perintah dengan urutan dari atas ke bawah.

Menambahkan perintah LLDB yang ingin Anda eksekusi tepat setelah debugger terlampir pada proses. Misalnya:

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

LLDB mengeksekusi perintah dengan urutan dari atas ke bawah.

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

lldb process:gdb-remote packets

Anda bisa mengubah default untuk mengumpulkan informasi lebih banyak. Misalnya, opsi log berikut mengumpulkan informasi tentang platform khusus:

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

Android Studio menempatkan log perangkat di lokasi berikut, dengan ApplicationId adalah ID aplikasi unik yang digunakan dalam manifes APK yang dibuat, dan mengidentifikasi aplikasi pada perangkat Anda dan di Google Play store:

/data/data/ApplicationId/lldb/log

Atau, jika beberapa pengguna mengakses suatu perangkat, perangkat menempatkan log di lokasi berikut, dengan AndroidUserId adalah pengidentifikasi unik untuk pengguna pada perangkat:

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

Mengenai informasi tentang penggunaan LLDB untuk men-debug dari jauh, lihat Remote Debugging.

Jika diaktifkan, konfigurasi run/debug ini akan membangun, memasang, dan menjalankan aplikasi dengan pelacakan GPU. Pelacakan tidak didukung saat men-debug aplikasi. Jika Anda men-debug aplikasi dengan pelacakan GPU, Anda akan menerima pesan dan debugger meluncur tanpa pelacakan. Opsi ini relevan untuk alat bantu GPU Debugger.

Perhatikan bahwa setelah Anda mengaktifkan kotak centang ini, setiap kali Anda meluncurkan aplikasi, aplikasi akan memblokir dan menunggu Anda melampirkan debugger atau GPU Debugger.

Pilih opsi ini untuk menonaktifkan dukungan driver grafis OpenGL ES untuk shader dan binari program prakompilasi yang langsung bisa digunakan selama pelacakan. Opsi ini relevan untuk alat bantu GPU Debugger.

Shader prakompilasi tidak mendukung pemutaran ulang pelacakan, sehingga hanya shader yang dikompilasi pada waktu proses menggunakan fungsi glShaderSource yang dapat digunakan untuk inspeksi framebuffer.

Aplikasi harus selalu melakukan kueri untuk dukungan shader prakompilasi sebelum menggunakan fungsi glShaderBinary atau glProgramBinary, dan kembali ke kompilasi waktu proses jika shader atau program prakompilasi tidak didukung.

Default: tidak dipilih

Pilih opsi ini agar konfigurasi run/debug tersedia untuk anggota tim lainnya melalui kontrol versi. Anda bisa berbagi konfigurasi run/debug, namun tidak boleh template. Jika Anda memilih opsi ini, bila proyek telah disimpan ke Git (atau sistem kontrol versi lain), konfigurasi run/debug akan disertakan bila seseorang memeriksa proyek.

Android Studio menyimpan konfigurasi run/debug bersama dalam file XML individual di folder .idea/runConfigurations; jika tidak maka konfigurasi disimpan di file .idea/workspace.xml. Untuk informasi selengkapnya, lihat Format Proyek Berbasis Direktori.

Default: tidak dipilih

Tetapkan opsi baris perintah yang ingin Anda teruskan ke VM untuk meluncurkan DevAppServer. Saat 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 backslash sebelum tanda petik tersebut (\").

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

Default: tanpa opsi