Panduan memulai Android GPU Inspector

Topik ini menjelaskan cara melakukan pembuatan profil sistem dan pembuatan profil frame di aplikasi Android menggunakan Android GPU Inspector (AGI).

Panduan memulai ini ditujukan bagi developer yang sudah memahami pengembangan grafis di Android.

Persyaratan komputer

Komputer yang menjalankan AGI harus memenuhi persyaratan berikut:

Salah satu sistem operasi berikut diperlukan:
- Windows: Windows 7 atau yang lebih tinggi.
- macOS: El Capitan (10.11) atau yang lebih tinggi.
- Linux: Java 64-bit JDK atau JRE 8 (atau yang lebih baru) diperlukan; Ubuntu Trusty Tahr (14.04 atau yang lebih tinggi) direkomendasikan.
Alat command line adb.

Mendownload dan menginstal AGI

Download dan instal AGI untuk sistem operasi Anda.

Persyaratan aplikasi Android

Bagian ini menjelaskan persyaratan untuk aplikasi Android yang sedang diprofilkan:

Aplikasi Android Anda harus dapat di-debug; atribut yang dapat di-debug dalam manifes Android aplikasi harus disetel ke true. Atribut ini memungkinkan instrumentasi yang tepat dari driver grafis. Untuk aplikasi Vulkan, atribut ini memungkinkan AGI menambahkan lapisan Vulkan-nya sendiri saat aplikasi dimulai.
```
<application [...] android:debuggable="true">
```

Jika aplikasi Anda menggunakan Vulkan secara native, AGI juga memerlukan hal berikut:

Aplikasi Anda harus mengaktifkan Lapisan validasi Vulkan. Jika tidak diaktifkan, Anda dapat menjalankan perintah berikut untuk memaksa aplikasi berjalan dengan lapisan validasi yang disertakan dalam apk AGI (com.google.android.gapid.<abi>):

app_package=<YOUR APP PACKAGE NAME HERE>
abi=arm64v8a # Possible values: arm64v8a, armeabi-v7a, x86

adb shell settings put global enable_gpu_debug_layers 1
adb shell settings put global gpu_debug_app ${app_package}
adb shell settings put global gpu_debug_layer_app com.google.android.gapid.${abi}
adb shell settings put global gpu_debug_layers VK_LAYER_KHRONOS_validation

Setelah selesai membuat profil, Anda dapat menonaktifkan lapisan validasi ini dengan perintah berikut:

adb shell settings delete global enable_gpu_debug_layers
adb shell settings delete global gpu_debug_app
adb shell settings delete global gpu_debug_layers
adb shell settings delete global gpu_debug_layer_app

Aplikasi Anda tidak boleh melaporkan peringatan atau error apa pun saat berjalan dengan lapisan validasi Vulkan yang aktif. Perbaiki error validasi Vulkan sebelum membuat profil.

Jika Anda menggunakan driver GPU beta, sertakan metadata berikut dalam tag <application> manifes Android:

<meta-data
          android:name="com.android.graphics.developerdriver.enable"
          android:value="true" />

Persyaratan perangkat Android

AGI memiliki persyaratan perangkat Android berikut:

Perangkat Android yang didukung yang menjalankan Android 11 atau yang lebih tinggi.
Kabel USB.
Proses debug adb harus diaktifkan dan perangkat harus dapat diakses melalui adb. Jika ada opsi Install via USB, aktifkan.

Validasi perangkat

AGI memerlukan driver GPU yang kompatibel. Untuk memastikannya menyediakan data pembuatan profil yang valid, AGI menjalankan pemeriksaan validasi saat pertama kali Anda menghubungkan perangkat baru, yang memerlukan waktu sekitar sepuluh detik. Setelah lulus pemeriksaan, Anda dapat menggunakan perangkat untuk membuat profil aplikasi Android.

Jangan ganggu perangkat saat validasi sedang berlangsung. Hal ini dapat menyebabkan perangkat gagal divalidasi. Jika perangkat gagal divalidasi, tetapi disiapkan dengan benar, Anda dapat mencoba lagi validasi dengan memilih ulang perangkat.

Validasi adalah langkah satu kali untuk perangkat, dan hasilnya disimpan di cache untuk penggunaan AGI yang akan datang. Namun, AGI akan menjalankan validasi lagi jika penyiapan perangkat berubah, seperti jika driver GPU atau versi Android diupdate.

Jika perangkat tercantum sebagai perangkat yang didukung, Anda dapat mengharapkan AGI lulus validasi. Jika perangkat tidak tercantum, driver GPU-nya kemungkinan besar tidak kompatibel dengan AGI.

Jika perangkat Anda didukung tetapi gagal dalam validasi

Pastikan Anda telah memenuhi semua persyaratan Android dan persyaratan komputer yang dijelaskan di bagian sebelumnya, serta perangkat terhubung dengan benar ke komputer menggunakan kabel USB.

Jika semua persyaratan terpenuhi, ajukan masalah di repositori GitHub kami yang menjelaskan perilaku tersebut.

Jika perangkat Anda tidak didukung

Kami bekerja sama dengan partner OEM guna menambahkan dukungan untuk lebih banyak perangkat. Anda dapat melaporkan masalah di repositori GitHub kami untuk meminta dukungan bagi perangkat.

Mengambil data pembuatan profil

Bagian berikut menjelaskan cara mengambil data pembuatan profil, dan membuka file rekaman aktivitas yang dihasilkan agar Anda dapat menganalisis hasilnya.

Mengonfigurasi setelan Android

Sebelum memulai pembuatan profil, Anda harus mengonfigurasi setelan aplikasi dan perangkat Android ini, yang menentukan aplikasi dan perangkat yang akan dibuat profilnya.

Menggunakan kabel USB, hubungkan perangkat Android Anda ke komputer.
Luncurkan AGI di komputer Anda.

Saat pertama kali diluncurkan, AGI akan menampilkan layar Welcome, yang akan meminta Anda membuka jalur ke adb yang dapat dieksekusi. AGI menyimpan setelan ini dalam file .agic di folder HOME Anda. Jika sudah melakukannya, Anda dapat melewati langkah ini.

Gambar 1: Layar sambutan.
Masukkan jalur ke file adb yang dapat dieksekusi di kolom Path to adb. Kotak centang yang mengikuti kolom ini bersifat opsional.
Klik Get Started untuk menampilkan layar peluncuran.

Gambar 2: Layar peluncuran utama Android GPU Inspector.
Di layar peluncuran, klik Capture a new trace. Tindakan ini akan menampilkan dialog Capture A New Trace. Atau, Anda dapat mengklik tombol Capture System Profile trace.

Gambar 3: Capture A New Trace dialog.
Di bagian Device and Type, pilih perangkat Android yang ingin Anda buat profil. Jika tidak ditampilkan dalam daftar Device, klik panah muat ulang untuk memuat ulang daftar.
Di bagian Aplikasi, pilih aplikasi yang ingin dibuat profilnya. Jika hanya ada satu aktivitas dalam paket, Anda dapat memilih paket, bukan aktivitas.

AGI menyertakan contoh aplikasi Vulkan. Untuk menggunakan aplikasi contoh, bukan aplikasi Anda sendiri, lakukan langkah-langkah berikut:
1. Klik tombol ... di samping kolom Application.
  
  Tindakan ini akan menampilkan dialog Select an Application to Trace, yang menampilkan daftar aplikasi yang dapat dilacak di perangkat yang dipilih.
2. Di kotak teks Filter, ketik gapid untuk hanya menampilkan aplikasi yang berisi gapid dalam nama paketnya.
3. Luaskan paket dan pilih com.google.android.gapid.VkSampleActivity, lalu klik OK.
  
  Tindakan ini akan mengembalikan Anda ke dialog Capture A New Trace, dengan kolom Application yang diisi oleh aplikasi yang Anda pilih.
Di bagian Application, kosongkan kolom lainnya.
Klik OK.

Sekarang Anda siap menggunakan AGI untuk melakukan pembuatan profil sistem dan frame.

Membuat profil sistem

Untuk membuat profil sistem, lakukan langkah-langkah berikut:

Di layar peluncuran AGI, klik Capture a new trace untuk menampilkan dialog Capture System Profile.
Dalam daftar Type, pilih System profile.
Di bagian Start and Duration, tetapkan Start at ke Manual, dan Duration ke 2.
Di bagian Trace Options, klik Configure. Tindakan ini akan menampilkan daftar opsi pembuatan profil.

Gambar 4: Opsi pembuatan profil dalam dialog Capture System Profile.
Pilih data pembuatan profil yang ingin Anda ambil.
Di bagian GPU, klik Select.

Ini akan menampilkan daftar penghitung yang dapat dipilih.

Gambar 5: Memilih penghitung.
Klik default untuk memilih kumpulan penghitung default, lalu klik OK untuk menampilkan opsi pembuatan profil.
Klik OK untuk kembali ke dialog Capture System Profile utama.
Di bagian Output, pilih Output Directory untuk menyimpan file rekaman aktivitas yang dihasilkan selama pembuatan profil. Kolom File Name seharusnya terisi otomatis, tetapi Anda juga dapat mengeditnya.
Klik OK. Tindakan ini akan memulai aplikasi yang dipilih di perangkat Android, dan menampilkan jendela pop-up dengan tombol Start.
Klik tombol Start untuk mulai mengambil data pembuatan profil, dan tunggu beberapa detik hingga proses selesai.
Klik Open Trace. Tampilan awal yang ditampilkan mirip dengan systrace.

Gambar 6: UI System Profiler.

Selain data yang tersedia di systrace, AGI juga menampilkan informasi performa GPU. Untuk mengetahui informasi selengkapnya tentang cara melihat data pembuatan profil sistem, lihat Melihat profil sistem AGI.

Untuk mengetahui informasi tentang setelan tambahan, lihat opsi pembuatan profil sistem.

Membuat profil frame

Untuk membuat profil setiap frame dari aplikasi Anda, lakukan langkah-langkah berikut:

Di layar peluncuran AGI, klik Capture a new trace untuk menampilkan dialog Capture A New Trace. Atau, Anda dapat mengklik tombol Capture Frame Profile trace.
Dalam daftar Type, pilih Vulkan atau OpenGL on ANGLE bergantung pada Graphics API yang digunakan aplikasi Anda. Pastikan Anda memilih yang tepat, jika tidak, AGI tidak akan menangkap perintah grafis apa pun.
Di bagian Start and Duration, tetapkan Start at ke Manual. Jika Anda mengklik tombol Capture Frame Profile trace, langkah ini sudah selesai.
Di bagian Output, pilih Output Directory untuk menyimpan file rekaman aktivitas. Kolom File Name seharusnya terisi otomatis, tetapi Anda juga dapat mengeditnya.
Opsional: Beberapa aplikasi memiliki proses berbeda yang melakukan semua pemrosesan grafis. Untuk merekam proses tersebut, tentukan namanya.
Klik OK. Tindakan ini akan memulai aplikasi Anda di perangkat Android, dan menampilkan jendela pop-up dengan tombol Start.
Klik tombol Start dan tunggu beberapa detik hingga pembuatan profil selesai.
Klik Open Trace untuk melihat data pembuatan profil. Untuk mengetahui informasi tentang setiap panel di UI Frame Profiler, lihat Ringkasan pembuatan profil frame.

Untuk informasi tentang setelan tambahan, lihat opsi pembuatan profil frame.