แก้ปัญหา

เมื่อพัฒนาการดำเนินการของแอป คุณอาจพบปัญหาในการตั้งค่าหรือ เครื่องมือทดสอบการดำเนินการของแอป หน้านี้อธิบายปัญหาที่พบได้ทั่วไปบางรายการ และการแก้ไข

ทั่วไป

ข้อผิดพลาด: "ไม่พบแอปที่จะใช้เปิด URL" ปรากฏในการแจ้งเตือนข้อความโทสต์

ตรวจสอบการดำเนินการตามคำสั่งซื้อ urlTemplate ใน actions.xml ว่าเป็นไปตาม มีการกำหนดค่าอย่างถูกต้อง หากใช้ URL ของ App Link ให้ตรวจสอบว่าคุณเรียก URL ได้ ด้วยตนเองโดยใช้ ACTION_VIEW และ URL หากใช้ URL ที่อิงตามความตั้งใจ โปรดตรวจสอบว่า กิจกรรมของคุณได้รับการกำหนดค่าอย่างถูกต้องให้เริ่มใช้พารามิเตอร์ที่ระบุ

ข้อผิดพลาด: "ไม่ได้ติดตั้งแอป"

ข้อผิดพลาดนี้อาจหมายความว่า <intent-filter> ใน AndroidManifest.xml ของคุณ ไม่ได้กรอง Deep Link ที่คุณระบุไว้ใน actions.xml โปรดตรวจสอบข้อมูลนี้ก่อนยื่นข้อบกพร่อง

ข้อผิดพลาด: "ไม่พบการอ้างอิงชุดเอนทิตีที่มีรหัสชุดเอนทิตีหรือตัวกรอง URL" ปรากฏใน Android Studio

เงื่อนไขนี้เกิดจากปัญหาโปรแกรมวิเคราะห์โค้ดที่ทราบของ แท็ก <entity-set-reference> คุณไม่จำเป็นต้องสนใจข้อความนี้และจะไม่ส่งผลเสียหายใดๆ เพื่อ คุณสามารถปิดใช้การตรวจสอบ Lint สำหรับแท็กนี้โดยการเพิ่ม tools:ignore="ValidActionsXml" แก่แท็กดังกล่าว

ต่อไปนี้เป็นตัวอย่างการอ้างอิงชุดเอนทิตีที่มีการตรวจสอบ Lint ที่ปิดใช้

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

ข้อผิดพลาด: "ตำแหน่งไม่ถูกต้อง" สำหรับเอกสารสคีมาการดำเนินการเมื่ออัปโหลด APK

การอัปโหลด APK อาจล้มเหลวหากคุณใช้การปรับให้ยากต่อการอ่าน (Obfuscation) หรือเครื่องมือเพิ่มประสิทธิภาพที่ ส่งผลต่อทรัพยากรสำหรับ APK ที่เผยแพร่ เครื่องมือเช่น ProGuard ที่ช่วยหลีกเลี่ยง ไฟล์ทรัพยากรจะไม่ทำให้เกิดปัญหานี้

ในการแก้ปัญหานี้ ให้ลองปิดใช้เครื่องมือใน actions.xml ของแอป (เช่น โดยใช้รายการที่อนุญาต)

ข้อผิดพลาด: "APK หรือ Android App Bundle ที่ใช้งานอยู่มีไฟล์ actions.xml โปรดยอมรับข้อกำหนดในการให้บริการของ Actions on Google เพื่อดำเนินการต่อ" ปรากฏใน Google Play Console

คุณอาจเห็นข้อผิดพลาดนี้ขณะสร้างรุ่นแอปใน Play Console ถึง ยอมรับข้อกำหนดในการให้บริการของ Actions on Google ให้ทำตามขั้นตอนต่อไปนี้

1. เลือกแอปใน Play Console
2. ไปที่การตั้งค่า > การตั้งค่าขั้นสูง
3. คลิกแท็บ Actions on Google
4. ทำเครื่องหมายที่ช่องผสานรวมบริการของฉันกับการดำเนินการของแอปโดยใช้การดำเนินการ บน Google และทำตามวิธีการ

ปุ่ม "ยอมรับ" ปุ่มบนแบบฟอร์มข้อกำหนดในการให้บริการของ Play ปิดใช้อยู่

นี่อาจหมายความว่าผู้ใช้ที่ลงชื่อเข้าใช้ไม่มีสิทธิ์เข้าถึงที่จำเป็น เพื่อยอมรับข้อกำหนดเหล่านั้น ตรวจสอบว่าการส่งครั้งแรกดำเนินการโดย ผู้ดูแลระบบของโปรไฟล์ Play Console

เครื่องมือทดสอบการดำเนินการของแอป

ก่อนทำการแก้ไขใดๆ ต่อไปนี้ ให้อัปเดตการติดตั้ง เครื่องมือทดสอบการดำเนินการของแอปเป็นเวอร์ชันล่าสุด

ปลั๊กอินเครื่องมือทดสอบการดำเนินการของแอปไม่พบไฟล์ actions.xml ของฉัน

ตรวจสอบว่าคุณได้เพิ่มแท็ก <meta-data> ที่ถูกต้องใน AndroidManifest.xml

ตัวอย่างการดำเนินการของแอปไม่ตรงกับไฟล์ actions.xml ปัจจุบันของฉัน

หน้าตัวอย่างของคุณไม่ได้อัปเดตตัวเองแบบไดนามิกด้วยเนื้อหา actions.xml ไฟล์ หลังจากที่คุณเปลี่ยนไฟล์ actions.xml ด้วยตนเองหรือหลังจาก กำลังเปลี่ยนตัวแปรของบิลด์ใน Android Studio, บันทึกไฟล์ actions.xml และ คลิก Update Preview ในเครื่องมือทดสอบ

ปลั๊กอินเครื่องมือทดสอบการดำเนินการของแอปหยุดทำงานหรือเกิดข้อผิดพลาด

ก่อนอื่นให้ตรวจสอบว่าคุณได้อัปเดต Android Studio เป็นเวอร์ชันล่าสุดแล้ว ถ้า คุณได้รับข้อผิดพลาด 403 คุณอาจกำลังใช้ปลั๊กอินใน แพ็กเกจที่คุณไม่มีสิทธิ์เรียกใช้

หากข้อผิดพลาดยังคงอยู่ โปรดรายงานข้อบกพร่องและส่งข้อมูลต่อไปนี้ รายละเอียดกับ Google:

• รายละเอียดของกล่องโต้ตอบข้อผิดพลาด
• บันทึกของ Android Studio ไปที่ ความช่วยเหลือ > แสดงเครื่องมือค้นหาการเข้าสู่ระบบ ข้อมูลนี้จะแสดง ตำแหน่งของ idea.log ใน Finder ค้นหา "ส่งการดำเนินการ เนื้อความของคำขอ:" ในไฟล์บันทึก และวางการตอบกลับของเซิร์ฟเวอร์ (มี ควรเป็นผลลัพธ์ 2 รายการสำหรับการกระทำ)

เครื่องมือทดสอบการดำเนินการของแอปสร้าง UnknownHostException หรือข้อผิดพลาดอื่นๆ ของเครือข่าย

เครื่องมือทดสอบการดำเนินการของแอปจะสร้างตัวอย่างการดำเนินการของแอปซึ่งทำให้คุณสามารถ ทดสอบการผสานรวมกับ Google Assistant ด้วยบัญชี Google บัญชีเดียว วิธีสร้าง เครื่องมือทดสอบนี้ต้องมีการเชื่อมต่ออินเทอร์เน็ตที่ใช้งานได้ และหาก จำเป็น การเข้าถึงพร็อกซีสำหรับ Google Domains

ในการแก้ปัญหาเครือข่ายเมื่อเรียกใช้เครื่องมือทดสอบ ให้ตรวจหา ปัญหา:

• ตรวจสอบว่าคุณมีการเชื่อมต่ออินเทอร์เน็ตที่ใช้งานได้ก่อนสร้างตัวอย่าง

• หากการเชื่อมต่ออินเทอร์เน็ตทำงานอยู่และเครือข่ายภายในใช้พร็อกซี ให้ตรวจสอบสิ่งต่อไปนี้

  • ตรวจสอบการกำหนดค่าพร็อกซี IDE สำหรับข้อมูลเพิ่มเติม โปรดดูที่พร็อกซี วิธีการกำหนดค่าสำหรับ Android Studio หรือ IntelliJ
  • ถ้าพร็อกซีต้องใช้รายการควบคุมการเข้าถึง (ACL) ให้อัปเดต ACL เป็น อนุญาตรูปแบบ URL นี้: https://actions.googleapis.com/**

เมื่อเรียกใช้การดำเนินการของแอปด้วยปลั๊กอินทดสอบ Assistant จะพูดว่า "ขอโทษครับ ไม่เจอแอปนั้น"

คำตอบนี้อาจปรากฏด้วยสาเหตุต่างๆ ทั้งนี้ขึ้นอยู่กับการตั้งค่าของคุณ ลอง ขั้นตอนต่อไปนี้

1. ลงชื่อเข้าใช้ Android Studio, Play Console และ อุปกรณ์ทดสอบด้วยบัญชี Google เดียวกัน
2. เปิดใช้การซิงค์ข้อมูลอุปกรณ์
3. ตั้งค่าอุปกรณ์และภาษาของ Google Assistant เป็นen-US
4. ตรวจสอบว่าชื่อแพ็กเกจของแอปพลิเคชันใน Google Play Console จะจับคู่กับชื่อแพ็กเกจในแอปพลิเคชันทดสอบ
5. ในคำจำกัดความของurlTemplateการดำเนินการตามคำสั่งซื้อในไฟล์ actions.xml ตรวจสอบว่าค่า android:host และ android:scheme ตรงกับ ที่ประกาศในไฟล์ AndroidManifest
6. นำการติดตั้งแอปก่อนหน้านี้ทั้งหมดออกจากอุปกรณ์ทดสอบ และ ติดตั้งบิลด์ใหม่
7. ลบตัวอย่างจากเครื่องมือทดสอบการดำเนินการของแอปแล้วสร้างตัวอย่างใหม่อีกครั้ง
8. ตรวจสอบในเครื่องมือ Logcat เพื่อดูความล้มเหลวที่เกี่ยวข้องกับการดำเนินการตามคำสั่งซื้อ สำหรับ Google Assistant คุณควรเห็น Intent เปิดตัวในแอป
9. เปิดใช้ "ข้อมูลแอปสำหรับอุปกรณ์ของคุณ" การตั้งค่า สำหรับบัญชีดังกล่าว
10. เปิด Google Assistant และตรวจสอบว่าคุณตั้งค่าเรียบร้อยแล้ว (โดยปกติแล้วการตั้งค่า แถบความคืบหน้าจะปรากฏเป็นแถบสีน้ำเงินที่ด้านล่างของหน้าจอ แต่ ซึ่งอาจมีลักษณะต่างออกไปในบางกรณี)
11. เมื่อใช้ Google Assistant เพื่อทริกเกอร์การดำเนินการของแอป ให้ตรวจสอบว่า ชื่อคำขอตรงกับตัวอย่างที่สร้างโดยเครื่องมือทดสอบการดำเนินการของแอป
12. ลองใช้การป้อนข้อความแทนเสียงเพื่อหลีกเลี่ยงข้อผิดพลาดในการถอดเสียงเป็นคำ
13. กำหนดค่าบิลด์ทดสอบเพื่อให้ applicationId ตรงกับ APK หรือ AAB ที่อัปโหลดไปยัง Google Play Console โปรดทราบว่าตัวเลือก พร็อพเพอร์ตี้ applicationIdSuffix รายการสามารถเปลี่ยน applicationId สุดท้ายของ สร้างผลิตภัณฑ์บางประเภทและผลิตภัณฑ์ย่อย ในตัวอย่างนี้ applicationId สำหรับรสชาติผลิตภัณฑ์จำลองคือ com.example.android.architecture.blueprints.master.mock แทนที่จะเป็น com.example.android.architecture.blueprints
14. กำหนดค่าการแสดงตัวอย่างให้ใช้ชื่อคำขอที่ไม่ซ้ำกัน ลองใช้ ซึ่งช่วยลดโอกาสที่จะเกิดการชนกับแอปอื่นๆ
15. หากต้องการแยกปัญหาเมื่อแก้ปัญหาฐานของโค้ดที่แชร์ได้ ให้ลองเรียกใช้ ตัวอย่างแอป App Actions แอปฟิตเนส ตรวจสอบว่าแอปฟิตเนสทำงานได้ตั้งแต่ต้นจนจบ จากนั้นค่อยๆ เพิ่ม ฟีเจอร์เพิ่มเติมนอกเหนือจากในแอปนี้ เพื่อดูว่าคุณสามารถจำลองปัญหาได้ไหม
16. หากใช้บัญชี G Suite ให้ตรวจสอบว่า Google Assistant เปิดอยู่โดย ผู้ดูแลระบบ เราขอแนะนำให้สร้างบัญชีทดสอบที่ไม่ใช่ G Suite เป็นวิธีแก้ปัญหาเบื้องต้น และตั้งค่าให้เป็น ผู้ทดสอบที่มีใบอนุญาตผ่าน Play Store ผู้ทดสอบควรสร้างตัวอย่างสำหรับแอปของตนและ โดยใช้บัญชีนั้นในอุปกรณ์ของตนเรียบร้อย
17. หากคุณดาวน์โหลด Google Assistant เป็นแอปแยกต่างหาก ให้ลองบังคับปิดแอปไว้ในอุปกรณ์ของคุณ โดยปกติแล้ว คุณบังคับให้แอปหยุดโดยใช้แอปการตั้งค่าของโทรศัพท์ได้
18. หากขั้นตอนเหล่านี้ไม่ได้ผล ให้แจ้งปัญหาใน เครื่องมือติดตามปัญหาการดำเนินการของแอป