Men-debug tata letak dengan Layout Inspector dan Layout Validation

Layout Inspector di Android Studio memungkinkan Anda men-debug tata letak aplikasi dengan menampilkan hierarki tampilan dan memungkinkan Anda memeriksa properti setiap tampilan. Dengan Layout Inspector, Anda dapat membandingkan tata letak aplikasi dengan mockup desain, menampilkan tampilan aplikasi yang diperbesar atau 3D, dan memeriksa detail tata letaknya saat runtime. Alat ini sangat berguna jika tata letak Anda dibuat saat runtime, tidak sepenuhnya dalam XML dan tata letak berperilaku secara tidak terduga.

Layout Validation memungkinkan Anda melihat pratinjau tata letak di berbagai perangkat dan konfigurasi tampilan secara bersamaan, termasuk ukuran font variabel atau bahasa pengguna, sehingga memudahkan pengujian berbagai masalah tata letak umum.

Untuk membuka Layout Inspector, jalankan aplikasi Anda pada emulator atau perangkat yang terhubung, lalu pilih Tools >Layout Inspector. Jika Anda beralih di antara beberapa perangkat atau project, Layout Inspector akan otomatis terhubung ke proses yang dapat di-debug dan berjalan di latar depan perangkat yang terhubung.

Snapshot Layout Inspector untuk aplikasi contoh Sunflower

Gambar 1. Snapshot Layout Inspector untuk aplikasi contoh Sunflower. Layout Inspector menampilkan hal berikut dari kiri ke kanan: Component Tree (Hierarki Komponen), Layout Display (Tampilan Tata Letak), dan Attributes (Atribut).

  • Component Tree: Hierarki tampilan dalam tata letak.
  • Layout Display: Rendering tata letak aplikasi seperti yang ditampilkan pada perangkat atau emulator, dengan batas tata letak yang ditampilkan untuk setiap tampilan.
  • Attributes: Atribut tata letak untuk tampilan yang dipilih. Layout Inspector memerlukan mulai ulang aktivitas untuk mengakses atribut. Untuk informasi selengkapnya, lihat Memulai ulang aktivitas.

Untuk mempelajari Layout Editor untuk View, lihat Pengantar Layout Editor.

Layout Inspector Tersemat (eksperimental)

Mulai Android Studio Hedgehog, Anda dapat menjalankan Layout Inspector langsung di jendela alat Running Devices. Fitur eksperimental ini secara signifikan meningkatkan performa Layout Inspector, mempertahankan real estate layar, dan membantu mengatur alur kerja proses debug UI dalam satu jendela alat. Untuk mengaktifkan mode sematan:

  • Di Windows, buka File > Settings > Experimental > Layout Inspector
  • Pada macOS, buka Android Studio > Settings > Experimental > Layout Inspector

Berikut cara memulai dan melakukan beberapa tugas umum:

  • Untuk memulai Layout Inspector, buka jendela Running Devices, lalu klik Toggle Layout Inspector Tombol Layout Inspector tersemat.
  • Untuk melihat hierarki dan memeriksa properti setiap tampilan, gunakan jendela alat Component Tree dan Attribute Panel.
  • Untuk memilih tampilan dengan mengklik sekali langsung pada tampilan atau membuka kode dengan mengklik dua kali pada tampilan, aktifkan Toggle Deep Inspect Tombol aktifkan/nonaktifkan pemeriksaan mendalam.
  • Untuk berinteraksi dengan aplikasi, nonaktifkan Toggle Deep Inspect Tombol aktifkan/nonaktifkan pemeriksaan mendalam.
  • Untuk memeriksa perangkat fisik, aktifkan pencerminan perangkat.
  • Untuk menggunakan mode 3D, ambil Layout Inspector Snapshot Snapshot Layout Inspector.

Layout Inspector Tersemat

Gambar 2. Layout Inspector Tersemat untuk aplikasi Jetchat

Live Updates

Layout Display merender tata letak aplikasi seperti yang tampak pada perangkat atau emulator, dengan batas tata letak yang ditampilkan untuk setiap tampilan. Anda dapat mengklik setiap komponen untuk memeriksanya.

Live Layout Inspector memberikan insight real-time yang lengkap ke UI aplikasi saat di-deploy ke perangkat atau emulator yang menjalankan level API 29 atau yang lebih tinggi.

Untuk mengaktifkan Live Layout Inspector, pilih opsi Live Updates dari toolbar Layout Inspector.

Live Layout Inspector menyertakan hierarki tata letak dinamis, sehingga Component Tree, dan Layout Display juga akan diperbarui jika tampilan perangkat berubah.

Memilih atau memisahkan tampilan

Tampilan biasanya menggambar sesuatu yang terlihat, dan pengguna dapat berinteraksi dengannya. Component Tree menampilkan hierarki aplikasi secara real time dengan setiap komponen tampilan, yang membantu Anda men-debug tata letak aplikasi karena dapat memvisualisasikan elemen dalam aplikasi dan nilai yang terkait dengannya.

Untuk memilih tampilan, klik tampilan di Component Tree atau Layout Display. Semua atribut tata letak untuk tampilan yang dipilih akan muncul dalam panel Attributes.

Jika tata letak menyertakan tampilan tumpang tindih, Anda dapat memilih tampilan di urutan belakang dengan mengkliknya di Component Tree, atau dengan memutar tata letak.

Jika mengerjakan tata letak yang rumit, Anda dapat memisahkan masing-masing tampilan sehingga hanya bagian tertentu dari tata letak yang diperlihatkan dalam Component Tree dan dirender dalam Layout Display.

Menu tampilan terpisah

Gambar 3. Untuk memisahkan tampilan, klik kanan tampilan di Component Tree dan pilih Show Only Subtree atau Show Only Parents.

Untuk kembali ke tampilan penuh, klik kanan tampilan, lalu pilih Show All.

Menyembunyikan batas tata letak dan label tampilan

Untuk menyembunyikan kotak pembatas atau label tampilan elemen tata letak, klik View Options Tombol Opsi Tampilan di bagian atas Layout Display, lalu ganti ke Show Borders atau Show View Label.

Menu drop-down opsi Tampilan

Gambar 4. Untuk menyembunyikan batas tata letak dan label tampilan, klik View Options kedua di toolbar Layout Inspector.

Mode 3D

Layout Display menampilkan visualisasi 3D yang canggih dari hierarki tampilan aplikasi Anda saat runtime. Untuk menggunakan fitur ini, di jendela Live Layout Inspector, klik tombol 3D Mode Tombol 3D, lalu putar dengan menarik mouse.

Layout Inspector: tampilan 3D

Gambar 5. Tampilan 3D dari Tata Letak yang diputar.

Layout inspector: layer spacing view (tampilan jarak layar)

Gambar 6. Untuk meluaskan atau menciutkan lapisan Layout, gunakan penggeser Layer Spacing.

Membandingkan tata letak aplikasi dengan gambar overlay referensi

Untuk membandingkan tata letak aplikasi Anda dengan gambar referensi, seperti tiruan UI, Anda dapat memuat gambar overlay bitmap di Layout Inspector.

  • Untuk memuat overlay, pilih opsi Load Overlay dari toolbar Layout Inspector. Overlay diskalakan agar menyesuaikan tata letak.
  • Untuk menyesuaikan transparansi overlay, gunakan penggeser Overlay Alpha.
  • Untuk menghapus overlay, klik Clear Overlay .

Mengambil snapshot hierarki tata letak

Layout Inspector memungkinkan Anda menyimpan snapshot hierarki tata letak aplikasi yang sedang berjalan sehingga Anda dapat membagikannya dengan mudah kepada orang lain atau menunjukkannya nanti.

Snapshot merekam data yang biasanya akan Anda lihat saat menggunakan Layout Inspector, termasuk rendering 3D mendetail dari tata letak, hierarki komponen tata letak View, Compose, atau hybrid, serta atribut mendetail untuk setiap komponen UI Anda. Untuk menyimpan snapshot, lakukan hal berikut:

  1. Buka layout inspector.
  2. Layout Inspector akan terhubung ke proses aplikasi Anda secara otomatis. Jika tidak, pilih proses aplikasi dari menu dropdown.
  3. Jika Anda ingin mengambil snapshot, klik Export snapshot Ikon
ekspor dari toolbar Layout Inspector.
  4. Pada dialog sistem yang muncul, tentukan nama dan lokasi yang diinginkan untuk menyimpan snapshot. Pastikan untuk menyimpan file dengan ekstensi *.li.

Anda dapat memuat snapshot Layout Inspector dengan memilih File > Open dari panel menu utama, dan membuka file *.li.

GIF snapshot Layout Inspector

Gambar 7. Mengambil snapshot di Layout Inspector.

Memeriksa Compose

Layout Inspector memungkinkan Anda memeriksa tata letak Compose di dalam aplikasi yang berjalan di emulator atau perangkat fisik. Anda dapat menggunakan Layout Inspector untuk memeriksa seberapa sering composable direkomposisi atau dilewati, yang dapat membantu mengidentifikasi masalah pada aplikasi. Misalnya, beberapa error coding dapat memaksa UI Anda merekomposisi secara berlebihan, yang dapat menyebabkan performa yang buruk. Beberapa error coding dapat mencegah rekomposisi UI Anda dan, oleh karena itu, mencegah perubahan UI Anda muncul di layar.

Pelajari Layout Inspector for Compose lebih lanjut

Menghindari mulai ulang aktivitas

Layout Inspector memerlukan salah satu setelan global berikut agar berfungsi dengan benar. Jika Anda tidak menentukan setelan global, Layout Inspector akan otomatis menyetelnya.

  1. adb shell settings put global debug_view_attributes_application_package <processname>

    Opsi ini menghasilkan informasi tambahan untuk pemeriksaan proses yang ditentukan.

  2. adb shell settings put global debug_view_attributes 1

    Opsi ini menghasilkan informasi tambahan untuk pemeriksaan pada semua proses di perangkat.

Mengubah setelan global dapat menyebabkan mulai ulang aktivitas. Untuk menghindari mulai ulang aktivitas, Anda dapat mengubah setelan di Android Studio atau mengubah Opsi Developer di setelan perangkat.

Untuk mengaktifkan refresh otomatis di Android Studio, buka Run/Debug Configurations dengan memilih Run > Edit Configurations dari menu. Kemudian, buka tab Miscellaneous dan centang kotak Connect to Layout Inspector without restarting activity di bagian Layout Inspector Options.

Opsi mulai ulang aktivitas dalam konfigurasi Run

Gambar 12. Mengaktifkan refresh otomatis dari Konfigurasi Run/Debug.

Atau, aktifkan opsi developer perangkat Anda, lalu aktifkan Enable view attribute inspection dari setelan developer perangkat.

Layout Validation

Layout Validation adalah alat visual untuk melihat pratinjau tata letak secara serentak di berbagai perangkat dan konfigurasi tampilan, sehingga Anda dapat mendeteksi masalah tata letak lebih awal. Untuk mengakses alat ini, klik tab Layout Validation di pojok kanan atas jendela IDE:

Screenshot tab Layout Validation

Gambar 13. Tab Layout Validation.

Untuk berganti-ganti konfigurasi yang tersedia, pilih salah satu pilihan berikut dari menu dropdown Reference Devices di bagian atas jendela Layout Validation:

  • Reference Devices
  • Kustom
  • Color Blind
  • Font Sizes

Screenshot menu dropdown di alat Layout Validation

Gambar 14. Opsi menu dropdown Reference Devices.

Reference Devices

Perangkat referensi (Reference devices) adalah serangkaian perangkat yang kami rekomendasikan untuk melakukan pengujian. Perangkat tersebut mencakup antarmuka ponsel, perangkat foldable, tablet, dan desktop. Anda harus melihat pratinjau tampilan tata letak Anda di rangkaian perangkat referensi ini:

Screenshot pratinjau tata letak untuk berbagai perangkat referensi

Gambar 15. Pratinjau perangkat referensi di alat Layout Validation.

Kustom

Untuk menyesuaikan konfigurasi tampilan sebelum pratinjau, pilih berbagai setelan yang ada seperti bahasa, perangkat, atau orientasi layar:

Menyesuaikan tampilan perangkat di alat Layout Validation

Gambar 16. Mengonfigurasi tampilan kustom pada alat Layout Validation.

Color Blind

Agar aplikasi Anda mudah diakses pengguna buta warna, validasikan tata letak Anda dengan melakukan simulasi untuk jenis buta warna umum:

Screenshot pratinjau simulasi untuk berbagai jenis buta warna

Gambar 17. Pratinjau simulasi buta warna pada alat Layout Validation

Font Sizes

Validasi tata letak di berbagai ukuran font dan mudahkan akses pengguna yang menderita gangguan penglihatan dengan mengujinya menggunakan font berukuran besar.

Pratinjau tata letak aplikasi di berbagai ukuran font dengan error tata letak yang terlihat untuk font besar

Gambar 18. Pratinjau ukuran font variabel pada alat Layout Validation.