Plugin Asisten Google untuk Android Studio

Plugin Asisten Google menguji Action Aplikasi dalam Android Studio. Selama pengembangan dan pengujian, Anda menggunakan plugin untuk membuat pratinjau Action Aplikasi di Asisten untuk Akun Google Anda. Selanjutnya, Anda dapat menguji cara Action Aplikasi menangani berbagai parameter sebelum mengirimkannya untuk deployment.

Cara kerjanya

Plugin Asisten Google menyertakan Alat Pengujian Action Aplikasi, sebuah fitur yang mengurai file shortcuts.xml Anda dan membuat pratinjau Action Aplikasi untuk dengan satu akun Google. Pratinjau ini memungkinkan Asisten Google mengenali Action Aplikasi Anda sebelum men-deploy versi produksi aplikasi ke Konsol Google Play.

Untuk setiap intent bawaan (BII) dalam file shortcuts.xml Anda, alat ini akan merender objek JSON-LD yang sesuai dan memberikan parameter value default. Kemudian, Anda dapat mengubah nilai tersebut untuk menguji Action Aplikasi dengan kombinasi parameter yang bermakna dan memastikannya menjalankan fungsi aplikasi yang benar. Pratinjau dibuat, diupdate, dan dihapus di alat pengujian, yang memungkinkan Anda melakukan iterasi dan menguji Action Aplikasi di lingkungan yang aman.

Setelah pratinjau dibuat, Anda dapat memicu Action Aplikasi di perangkat pengujian langsung dari jendela alat pengujian. Untuk BII yang tersedia untuk memicu pengguna, Anda dapat menggunakan app name langsung di Asisten di untuk mencoba Action Aplikasi Anda. Misalnya, Anda bisa mengucapkan, "Ok Google, mulai latihan saya menggunakan Aplikasi Contoh" untuk meluncurkan Action Aplikasi yang menggunakan BII actions.intent.START_EXERCISE.

Dukungan lokalitas

Membuat pratinjau untuk lokalitas tertentu di alat pengujian bervariasi menurut BII. Halaman untuk setiap BII dalam referensi intent bawaan memberikan informasi tentang fungsi yang tersedia untuk BII tersebut, seperti apakah alat pengujian mendukung pembuatan pratinjau untuk lokalitas tertentu, dan apakah Action Aplikasi tersedia untuk dipicu oleh pengguna.

Mendapatkan plugin

Plugin Asisten Google tersedia untuk Android Studio. Untuk mengetahui informasi cara menginstal dan menggunakan Android Studio, lihat halaman Android Studio.

Untuk menginstal plugin Asisten Google di Android Studio, ikuti langkah-langkah berikut:

1. Buka File > Settings (Android Studio > Preferences di macOS).
2. Di bagian Plugin, buka Marketplace dan telusuri "plugin Asisten Google".
3. Instal alat tersebut lalu mulai ulang Android Studio.

Anda juga dapat mendownload plugin langsung dari repositori publik Jetbrains.

Persyaratan penyiapan

Penggunaan plugin Asisten Google memerlukan sejumlah langkah konfigurasi untuk membiarkan Action Aplikasi Anda berhasil diuji. Secara khusus, Anda harus menggunakan akun pengguna yang sama di Android Studio, di perangkat pengujian, dan untuk akses konsol Google Play.

Siapkan lingkungan pengembangan Anda dengan konfigurasi berikut:

• Login ke Android Studio (versi 4.0 atau yang lebih baru).
• Dengan akun yang sama, login ke aplikasi Google di perangkat pengujian Android.
• Dengan akun yang sama, dapatkan akses Konsol Play ke paket aplikasi yang diupload untuk diuji.
• Buka aplikasi Google di perangkat pengujian Android dan selesaikan proses penyiapan Asisten awal.
• Aktifkan sinkronisasi data perangkat di perangkat pengujian.

Batasan

Plugin Asisten Google memiliki batasan berikut:

• Action Aplikasi yang menggabungkan inventaris web dan pemanggilan aplikasi latar depan tidak dapat diuji langsung di alat pengujian atau dengan Android debug bridge (adb) perintah. Untuk menguji Action Aplikasi tersebut, buat pratinjau terlebih dahulu menggunakan alat pengujian. Kemudian, picu Action Aplikasi tersebut dengan berinteraksi dengan Asisten Google di perangkat fisik Anda.
• Inventaris inline untuk BII actions.intent.OPEN_APP_FEATURE hanya dapat diuji selama enam jam setelah pratinjau dibuat atau diupdate. Update pratinjau alat pengujian atau buat pratinjau baru untuk mereset jangka waktu enam jam.

Menambahkan penguji tambahan

Anda dapat mengundang pengguna tambahan ke project agar mereka dapat menguji integrasi Action Aplikasi Anda. Hal ini berguna saat Anda ingin membagikan project dengan anggota tim pengembangan lain agar semuanya dapat melakukan pengujian, atau saat berbagi project dengan penguji jaminan kualitas (QA) sebagai persiapan untuk peluncuran produksi. Penguji harus ditambahkan sebagai penguji lisensi di Google Play Store dan diberi akses hanya baca ke Konsol Google Play.

Untuk menambahkan penguji tambahan, ikuti langkah-langkah berikut:

1. Login ke Konsol Play.

2. Ikuti petunjuk di bagian Menyiapkan pemberian lisensi aplikasi dalam Topik Bantuan Konsol Play.

   

   Gambar 1. Menambahkan penguji lisensi.

   Catatan: Langkah ini akan memberikan akses pratinjau baca dan tulis ke Akun Google.

3. Mengundang Akun Google penguji lisensi sebagai Konsol Google Play hanya baca .

   1. Pilih Pengguna dan izin > Undang pengguna baru > Tambahkan aplikasi.
   2. Di Akses Aplikasi, pastikan kotak centang Admin (semua izin) tidak dicentang.

Catatan: Penguji harus menerima undangan untuk mengakses pratinjau.

Untuk setiap penguji yang ingin Anda aktifkan untuk pengujian pratinjau, Anda harus login secara terpisah ke Android Studio dengan akun Google pengguna tersebut. Setelah login, gunakan plugin Asisten Google untuk membuat pratinjau bagi pengguna pengujian.

Menggunakan plugin Asisten Google

Akses alat pengujian Action Aplikasi di Android Studio dengan membuka Alat > Asisten Google > Alat pengujian Action Aplikasi. Saat Anda membuka alat tersebut, tampilan akan berubah berdasarkan status pratinjau alat pengujian, apakah aktif atau tidak.

Membuat, mengupdate, dan menghapus pratinjau

Anda dapat menggunakan versi draf aplikasi untuk pengujian. Untuk mengetahui informasi selengkapnya, lihat Menyiapkan dan meluncurkan rilis. Uji aplikasi Anda dalam mode draf sebelum mengirimkannya untuk ditinjau.

Catatan: Gunakan alat pengujian Action Aplikasi dengan build aplikasi yang diinstal ke Android Studio.

Alat pengujian membuat pratinjau berdasarkan Akun Google Anda dan nama paket aplikasi (ID aplikasi), sehingga Anda dapat menguji beberapa aplikasi dengan Akun Google yang sama. Selama ID aplikasi berbeda untuk setiap aplikasi, Anda dapat terus menggunakan Akun Google yang sama untuk membuat dan menguji pratinjau. Beberapa akun Google dengan akses ke paket aplikasi yang sama dapat menggunakan alat pengujian untuk membuat pratinjau terpisah bagi aplikasi tersebut.

Catatan: Jika tidak memiliki pratinjau aktif, Anda harus membuatnya sebelum dapat menggunakan plugin untuk menguji Action Aplikasi.

Untuk membuat pratinjau, lakukan langkah berikut di Android Studio:

1. Buka alat pengujian Action Aplikasi.
2. Secara opsional, masukkan nama aplikasi dan lokalitas untuk pengujian. Nama aplikasi dan lokalitas default adalah test app action dan en.
3. Klik Create Preview. Jika diminta, tinjau dan setujui Action Aplikasi serta kebijakan dan persyaratan layanan kami. Setelah pratinjau dibuat, alat pengujian pembaruan jendela untuk menampilkan informasi tentang BII yang ditemukan di shortcuts.xml Anda.

Alat pengujian menggunakan nama aplikasi untuk membuat dan menyimulasikan kueri Asisten untuk Action Aplikasi Anda. Action Aplikasi yang di-deploy menggunakan nama aplikasi Play Store untuk pemanggilan, tetapi Anda dapat menggunakan nama pemanggilan apa pun di alat pengujian. Namun, sebaiknya gunakan nama aplikasi sebagai nama panggilan Anda di alat pengujian.

Lokalitas yang Anda berikan harus cocok dengan bahasa Asisten Google di perangkat pengujian, dan Anda hanya dapat membuat pratinjau di satu lokalitas dalam satu waktu. Misalnya, jika bahasa Asisten Anda adalah bahasa Inggris (AS), Anda dapat memasukkan en-US, tetapi tidak dapat memasukkan en-**, en-GB, atau en-US, en-GB. Anda dapat menggunakan lokalitas root, seperti sebagai en, untuk menyertakan en-GB dan en-US.

Untuk mengubah nama aplikasi atau lokalitas yang dipilih untuk pratinjau yang sudah ada, klik tombol Hapus di alat pengujian. Kemudian, masukkan nama aplikasi dan lokalitas yang diinginkan sebelum membuat pratinjau baru.

Untuk memperbarui pratinjau yang ada agar cocok dengan file shortcuts.xml Anda, klik Tombol Update di alat pengujian. Informasi tentang pratinjau saat ini berada di bagian Action Aplikasi Pengujian di jendela alat pengujian.

Perhatian: Perubahan yang Anda lakukan pada file shortcuts.xml tidak otomatis diterapkan ke pratinjau yang ada. Anda harus mengupdate pratinjau di alat pengujian sebelum dapat menguji perubahan baru.

Mengonfigurasi BII

Setelah membuat pratinjau untuk aplikasi, Anda dapat menguji berbagai nilai parameter untuk BII di plugin. Untuk setiap BII di shortcuts.xml, plugin akan merender file JSON-LD dan memberikan parameter value default. Anda dapat mengubah nilai default tersebut untuk menguji Action Aplikasi dengan kombinasi parameter yang bermakna dan memastikannya menjalankan fungsi aplikasi yang benar.

Parameter dan nilainya biasanya mengikuti struktur schema.org atau schema.googleapis.com untuk properti dan deskripsi. Anda dapat menemukan parameter BII apa pun dengan mengakses skema jenis deskripsi parameter dan parameter tingkatnya yang lebih tinggi.

Misalnya, BII actions.intent.GET_FOOD_OBSERVATION mendukung foodObservation.forMeal parameter intent. Halaman schema.googleapis.com untuk MealType mencantumkan name sebagai properti. Properti forMeal adalah mode transfer, dan mengharapkan nilai (seperti MealTypeLunch) dari jenis MealType yang dienumerasi.

Di kolom alat pengujian, Anda dapat memberikan enumerasi sebagai nilai foodObservation.forMeal:

• https://schema.googleapis.com/MealTypeSnack
• https://schema.googleapis.com/MealTypeBrunch
• https://schema.googleapis.com/MealTypeLunch
• https://schema.googleapis.com/MealTypeBreakfast
• https://schema.googleapis.com/MealTypeDinner
• https://schema.googleapis.com/MealTypeDesert

Memicu Action Aplikasi

Setelah membuat pratinjau dan mengonfigurasi BII, Anda dapat memicu Action Aplikasi di perangkat pengujian, langsung dari jendela alat pengujian.

Untuk memicu Action Aplikasi dengan alat pengujian, lakukan hal berikut:

1. Hubungkan perangkat pengujian Anda.
2. Di bagian Pilih Perangkat Target, pilih perangkat tempat Anda ingin memicu Action Aplikasi.
3. Di bagian Uji Action Aplikasi, klik tombol Jalankan Action Aplikasi.

Action Aplikasi yang dipicu di alat pengujian menggunakan perintah Android Debug Bridge (adb) yang ditampilkan. Perintah shell adb yang dihasilkan menyertakan semua metadata yang diperlukan aplikasi Google untuk menjalankan BII. Pendekatan ini meniru perilaku Action Aplikasi Anda setelah Asisten mengekstrak bagian informasi penting dari kueri.

Logging Android Studio

Log yang khusus untuk alat pengujian tersedia di file log Android Studio, bukan sebagai output Logcat. Proses yang berjalan langsung di workstation Anda menghasilkan Android Studio log. Anda dapat menggunakannya untuk memecahkan masalah operasi alat pengujian seperti membuat, memperbarui, atau menghapus pratinjau.

Untuk mengakses file log Android Studio, buka Help > Show log in explorer (Help > Show log in finder di macOS).

Log yang terkait dengan Action Aplikasi untuk aplikasi Anda tersedia di Logcat. Logcat menangkap log dari perangkat virtual atau fisik yang terhubung ke Android Studio.

Guna mendapatkan log Action Aplikasi untuk perangkat Anda, ikuti langkah-langkah berikut:

1. Akses pesan log Logcat Anda dengan mengklik Logcat di kolom jendela alat Android Studio.
2. Telusuri log yang menyertakan ActivityTaskManager.

Mendapatkan dukungan dan referensi tambahan

Plugin Asisten Google menyediakan link ke dokumentasi, codelab, dan referensi lain untuk belajar dan mendapatkan bantuan menggunakan alat pengujian.

Anda dapat membuka asisten ini di Android Studio dengan memilih Alat > Asisten Google > Bantuan.

Gambar 2. Bagian bantuan plugin Asisten Google.