Memecahkan masalah Action Aplikasi dan actions.xml (tidak digunakan lagi)

Saat mengembangkan Action Aplikasi, Anda mungkin mengalami masalah dengan penyiapan atau dengan alat pengujian Action Aplikasi. Halaman ini menjelaskan beberapa masalah yang biasa terjadi dan perbaikannya.

Umum

Berikut adalah error umum yang mungkin Anda lihat.

Error: "Tidak ada Aplikasi yang ditemukan untuk membuka URL" muncul di notifikasi toast

Periksa fulfillment urlTemplate Anda di actions.xml untuk memastikannya telah dikonfigurasi dengan benar. Jika menggunakan URL App Links, pastikan Anda dapat memicu URL secara manual menggunakan ACTION_VIEW dan URL. Jika menggunakan URL berbasis intent, pastikan Aktivitas Anda dikonfigurasi dengan benar untuk mulai menggunakan parameter yang disediakan.

Error: "Aplikasi tidak diinstal"

Error ini dapat berarti bahwa <intent-filter> di file AndroidManifest.xml Anda tidak memfilter deep link yang ditetapkan dalam actions.xml. Pastikan Anda memeriksa hal ini terlebih dahulu sebelum melaporkan bug.

Error: "Referensi kumpulan entitas yang tidak berisi ID kumpulan entitas maupun filter URL ditemukan." muncul di Android Studio

Kondisi ini disebabkan oleh masalah linter yang umum untuk tag <entity-set-reference>. Anda dapat mengabaikan pesan ini dengan aman. Sebagai solusinya, Anda dapat menonaktifkan pemeriksaan lint untuk tag ini dengan menambahkan atribut tools:ignore="ValidActionsXml" ke tag tersebut.

Berikut adalah contoh referensi kumpulan entitas dengan pemeriksaan lint yang dinonaktifkan:

<entity-set-reference entitySetId="example" tools:ignore="ValidActionsXml" />

Error: "Lokasi tidak valid" untuk dokumen skema tindakan saat mengupload APK

Upload APK mungkin gagal jika Anda menggunakan alat obfuscation atau pengoptimalan yang memengaruhi resource untuk APK rilis Anda. Alat seperti ProGuard yang menghindari file resource tidak menyebabkan masalah ini.

Untuk mengatasi masalah ini, coba nonaktifkan alat untuk file actions.xml aplikasi Anda (misalnya, dengan menggunakan daftar yang diizinkan).

Error: "APK atau Android App Bundle yang aktif berisi file actions.xml. Untuk melanjutkan, setujui Persyaratan Layanan Actions on Google". muncul di Konsol Google Play

Anda mungkin melihat error ini saat membuat rilis aplikasi di Konsol Play. Untuk menyetujui Persyaratan Layanan Actions on Google, ikuti langkah-langkah berikut:

  1. Pilih aplikasi Anda di Konsol Play.
  2. Buka Penyiapan > Setelan Lanjutan.
  3. Klik tab Actions on Google.
  4. Centang kotak berlabel Integrasikan layanan saya dengan Action Aplikasi menggunakan Actions di Google, dan ikuti petunjuknya.

Tombol "Setuju" di formulir Persyaratan Layanan Play dinonaktifkan.

Jika tombol Setuju di formulir Persyaratan Layanan Play dinonaktifkan, bisa jadi profil pengguna Konsol Play tidak memiliki tingkat akses yang diperlukan untuk menyetujui persyaratan tersebut. Pengiriman pertama harus dilakukan oleh administrator Konsol Play.

Alat pengujian Action Aplikasi

Sebelum mencoba salah satu perbaikan berikut, update penginstalan alat pengujian Action Aplikasi ke versi terbaru.

Plugin alat pengujian Action Aplikasi tidak dapat menemukan file actions.xml saya.

Pastikan Anda telah menambahkan tag <meta-data> yang benar dalam file AndroidManifest.xml.

Pratinjau Action Aplikasi saya tidak cocok dengan file actions.xml saya saat ini.

Pratinjau Anda tidak diupdate sendiri secara dinamis dengan konten file actions.xml. Setelah mengubah file actions.xml secara manual atau beralih varian build di Android Studio, simpan file actions.xml dan klik Perbarui Pratinjau di alat pengujian.

Plugin alat pengujian Action Aplikasi berhenti berfungsi atau menghasilkan error.

Pertama, pastikan Anda telah mengupdate Android Studio ke versi terbaru. Jika mengalami error 403, Anda juga mungkin menjalankan plugin pada paket yang izinnya tidak Anda miliki untuk dijalankan.

Jika error masih berlanjut, laporkan bug dan kirim detail berikut ke Google:

  • Detail dialog error
  • Log Android Studio. Buka Help > Show Log in Finder. Ini menunjukkan lokasi idea.log di Finder Anda. Telusuri "Submit Actions Body: Request" dalam file log, lalu tempel respons server (harus ada dua hasil untuk tindakan).

Alat pengujian Action Aplikasi menghasilkan UnknownHostException atau error jaringan lainnya.

Alat pengujian Action Aplikasi membuat pratinjau Action Aplikasi Anda, yang memungkinkan Anda menguji integrasi Asisten Google dengan satu akun Google. Untuk membuat pratinjau ini, alat pengujian memerlukan koneksi internet aktif dan, jika diperlukan, akses proxy ke domain Google.

Untuk mengatasi masalah jaringan saat menjalankan alat pengujian, periksa masalah umum berikut:

  • Pastikan Anda memiliki koneksi internet aktif sebelum membuat pratinjau.

  • Jika koneksi internet aktif, dan jaringan lokal Anda menggunakan server proxy, periksa hal-hal berikut:

    • Verifikasi konfigurasi proxy IDE Anda. Untuk informasi selengkapnya, lihat petunjuk konfigurasi proxy untuk Android Studio, atau IntelliJ.

    • Jika proxy Anda memerlukan daftar kontrol akses (ACL), perbarui ACL untuk mengizinkan pola URL ini: https://actions.googleapis.com/**.

Saat memanggil Action Aplikasi dengan plugin pengujian, Asisten mengatakan, "Maaf, saya tidak dapat menemukannya".

Daftar berikut menjelaskan langkah-langkah yang dapat Anda lakukan jika Asisten mengatakan, "Maaf, saya tidak dapat menemukannya". saat Anda menguji Action Aplikasi.

  • Login ke Android Studio, Konsol Play, dan perangkat pengujian dengan akun Google yang sama.

  • Aktifkan sinkronisasi data perangkat.

  • Setel perangkat dan bahasa Asisten Google ke en-US.

  • Pastikan nama paket aplikasi di Konsol Google Play sesuai dengan nama paket dalam aplikasi pengujian.

  • Dalam definisi urlTemplate fulfillment pada file actions.xml Anda, pastikan nilai android:host dan android:scheme cocok dengan yang dideklarasikan dalam file AndroidManifest.

  • Hapus semua penginstalan aplikasi Anda sebelumnya dari perangkat pengujian dan instal build baru.

  • Hapus pratinjau dari alat pengujian Action Aplikasi dan buat pratinjau baru lagi.

  • Gunakan perangkat fisik Android untuk pengujian.

  • Periksa di alat Logcat untuk mengetahui kegagalan terkait fulfillment untuk Asisten Google. Anda akan melihat intent diluncurkan ke aplikasi Anda.

  • Aktifkan setelan 'Info aplikasi untuk perangkat' untuk akun.

  • Buka Asisten Google dan pastikan Anda telah menyelesaikan penyiapan. (Biasanya status progres penyiapan muncul sebagai panel biru di bagian bawah layar, tetapi dalam beberapa kasus mungkin terlihat berbeda.)

  • Saat menggunakan Asisten Google untuk memicu Action Aplikasi, pastikan nama pemanggilan cocok dengan pratinjau yang dibuat oleh alat pengujian Action Aplikasi.

  • Coba gunakan input teks, bukan suara untuk menghindari error transkripsi.

  • Konfigurasikan build pengujian Anda sehingga applicationId sama persis dengan APK atau AAB yang diupload ke Konsol Google Play. Perhatikan bahwa properti applicationIdSuffix opsional dapat mengubah applicationId akhir build untuk ragam produk dan varian build tertentu. Dalam contoh ini, applicationId untuk ragam produk tiruan adalah com.example.android.architecture.blueprints.master.mock, bukan com.example.android.architecture.blueprints.master.

  • Konfigurasikan pratinjau Anda untuk menggunakan nama pemanggilan yang unik. Coba gunakan kata unik yang akan mengurangi kemungkinan benturan dengan aplikasi lain.

  • Untuk mengisolasi masalah saat memecahkan masalah codebase yang dapat dibagikan, coba jalankan contoh Aplikasi Kebugaran Action Aplikasi. Pastikan aplikasi Kebugaran berfungsi secara menyeluruh. Kemudian secara bertahap tambahkan fitur tambahan di atas aplikasi ini untuk melihat apakah Anda dapat mereplikasi masalah.

  • Jika menggunakan akun G Suite, pastikan Asisten Google diaktifkan oleh administrator. Sebaiknya buat akun pengujian non-G Suite sebagai solusi dan siapkan sebagai penguji berlisensi melalui Play Store. Dari akun tersebut, penguji akan berhasil membuat pratinjau untuk aplikasi mereka dan melakukan pengujian menggunakan akun tersebut di perangkat mereka.

  • Jika Anda mendownload Asisten Google sebagai aplikasi terpisah, coba paksa berhenti pada perangkat Anda. Anda biasanya dapat memaksa menghentikan aplikasi melalui aplikasi Setelan di ponsel.

  • Jika langkah-langkah ini tidak berhasil, ajukan masalah di Issue tracker Action Aplikasi.