ปลั๊กอิน Google Assistant สำหรับ Android Studio

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

วิธีการทำงาน

ปลั๊กอิน Google Assistant มีเครื่องมือทดสอบการดำเนินการของแอป ซึ่งเป็นฟีเจอร์ที่ แยกวิเคราะห์ไฟล์ cookie.xml และสร้างตัวอย่างการดำเนินการของแอปสำหรับ บัญชี Google บัญชีเดียว ตัวอย่างเหล่านี้ช่วยให้ Google Assistant จดจำ การดำเนินการของแอปก่อนจะทำให้แอปเวอร์ชันที่ใช้งานจริงใช้งานได้ใน Google Play Console

สำหรับ Intent ในตัว (BII) แต่ละรายการในไฟล์ ทางลัด.xml ของคุณ เครื่องมือจะแสดงผล ออบเจ็กต์ JSON-LD ที่เกี่ยวข้องและระบุค่าพารามิเตอร์เริ่มต้น คุณสามารถ จากนั้นแก้ไขค่าเหล่านั้นเพื่อทดสอบการดำเนินการของแอปด้วยพารามิเตอร์ที่มีความหมาย ชุดค่าผสม และตรวจสอบว่าฟังก์ชันต่างๆ ของแอปทำงานได้อย่างถูกต้อง ตัวอย่างคือ สร้าง อัปเดต และลบในเครื่องมือทดสอบ ซึ่งช่วยให้คุณ ทดสอบการดำเนินการของแอปในสภาพแวดล้อมที่ปลอดภัย

เมื่อสร้างตัวอย่างแล้ว คุณจะทริกเกอร์การดำเนินการของแอปในอุปกรณ์ทดสอบได้ จากหน้าต่างเครื่องมือทดสอบโดยตรง สำหรับ BII ที่พร้อมใช้งาน สำหรับการทริกเกอร์ผู้ใช้ คุณสามารถใช้ app name ได้โดยตรงใน Assistant ใน อุปกรณ์เพื่อลองใช้การดำเนินการของแอป เช่น คุณสามารถพูดว่า "Ok Google เริ่มออกกำลังกายโดยใช้แอปตัวอย่าง" เพื่อเปิดการดําเนินการของแอปที่ใช้ BII actions.intent.START_EXERCISE

การสนับสนุนภาษา

การสร้างตัวอย่างสำหรับภาษาที่เฉพาะเจาะจงในเครื่องมือทดสอบจะแตกต่างกันไปตาม BII หน้าเว็บสำหรับแต่ละ BII ในข้อมูลอ้างอิง Intent ในตัวจะแสดง ข้อมูลว่ามีฟังก์ชันการทำงานอะไรบ้างสำหรับ BII นั้น เช่น เครื่องมือทดสอบรองรับการสร้างตัวอย่างสำหรับภาษาที่เจาะจงหรือไม่ และ การดำเนินการของแอปพร้อมให้ผู้ใช้เรียกใช้ไหม

ดาวน์โหลดปลั๊กอิน

ปลั๊กอิน Google Assistant พร้อมใช้งานสำหรับ Android Studio สำหรับ เกี่ยวกับการติดตั้งและการใช้ Android Studio โปรดดู Android Studio

หากต้องการติดตั้งปลั๊กอิน Google Assistant ใน Android Studio ให้ทำตามขั้นตอนต่อไปนี้

1. ไปที่ไฟล์ > การตั้งค่า (Android Studio > ค่ากำหนดใน macOS)
2. ในส่วนปลั๊กอิน ให้ไปที่ Marketplace และค้นหา "ปลั๊กอิน Google Assistant"
3. ติดตั้งเครื่องมือและรีสตาร์ท Android Studio

คุณสามารถดาวน์โหลดปลั๊กอินได้โดยตรงจาก ที่เก็บสาธารณะของ Jetbrains

ข้อกำหนดในการตั้งค่า

การใช้ปลั๊กอิน Google Assistant ต้องมีขั้นตอนการกำหนดค่าหลายขั้นตอนเพื่อ ให้การดำเนินการของแอปทดสอบได้สำเร็จ โดยเฉพาะอย่างยิ่ง คุณต้องใช้บัญชีผู้ใช้เดียวกันใน Android Studio, บนอุปกรณ์ทดสอบ และสำหรับการเข้าถึง Google Play Console

เตรียมสภาพแวดล้อมในการพัฒนาซอฟต์แวร์ด้วยการกำหนดค่าต่อไปนี้

• ลงชื่อเข้าใช้ Android Studio (เวอร์ชัน 4.0 ขึ้นไป)
• ลงชื่อเข้าใช้แอป Google ในอุปกรณ์ทดสอบ Android ด้วยบัญชีเดียวกัน
• รับสิทธิ์เข้าถึง Play Console ด้วยบัญชีเดียวกัน ลงในแพ็กเกจแอปที่อัปโหลดไว้เพื่อทดสอบ
• เปิดแอป Google ในอุปกรณ์ทดสอบ Android และกำหนดค่าเริ่มต้นให้เสร็จสิ้น ขั้นตอนการตั้งค่า Assistant
• เปิดใช้การซิงค์ข้อมูลอุปกรณ์ในอุปกรณ์ทดสอบ

ข้อจำกัด

ปลั๊กอิน Google Assistant มีข้อจำกัดดังต่อไปนี้

• การดำเนินการของแอปที่มีพื้นที่โฆษณาในเว็บรวมอยู่ด้วย และการเรียกใช้แอปที่ทำงานอยู่เบื้องหน้า ไม่สามารถทดสอบโดยตรงในเครื่องมือทดสอบหรือโดยบริดจ์แก้ไขข้อบกพร่องของ Android (adb) คำสั่ง หากต้องการทดสอบการดำเนินการของแอปเหล่านั้น ให้สร้างตัวอย่างโดยใช้การทดสอบก่อน ของ Google จากนั้น ให้เรียกใช้การดำเนินการของแอปเหล่านั้นโดยการโต้ตอบกับ Google Assistant บนอุปกรณ์จริงของคุณ
• พื้นที่โฆษณาแบบอินไลน์สำหรับ actions.intent.OPEN_APP_FEATURE BII จะทดสอบได้เป็นเวลา 6 ชั่วโมงหลังจากที่แสดงตัวอย่าง สร้างหรืออัปเดตแล้ว อัปเดตตัวอย่างเครื่องมือทดสอบหรือสร้างการแสดงตัวอย่างใหม่เพื่อ ให้รีเซ็ตระยะเวลา 6 ชั่วโมง

เพิ่มผู้ทดสอบเพิ่มเติม

คุณสามารถเชิญผู้ใช้คนอื่นมายังโปรเจ็กต์เพื่อให้ทดสอบการผสานรวม App Actions ได้ ซึ่งจะมีประโยชน์เมื่อคุณต้องการแชร์โปรเจ็กต์ ร่วมกับสมาชิกคนอื่นในทีมพัฒนาของคุณ เพื่อให้พวกเขาสามารถทดสอบ แชร์โปรเจ็กต์กับผู้ทดสอบการประกันคุณภาพ (QA) เพื่อเตรียมพร้อมสำหรับ การเปิดตัวเวอร์ชันที่ใช้งานจริง คุณต้องเพิ่มผู้ทดสอบเป็นผู้ทดสอบใบอนุญาตใน Google Play Store และให้สิทธิ์เข้าถึง Google Play Console แบบอ่านอย่างเดียว

หากต้องการเพิ่มผู้ทดสอบอีก โปรดทำตามขั้นตอนต่อไปนี้

1. ลงชื่อเข้าใช้ Play Console

2. ทำตามวิธีการในส่วนตั้งค่าการอนุญาตให้ใช้สิทธิแอปพลิเคชันในส่วนนี้ หัวข้อความช่วยเหลือของ Play Console

   

   รูปที่ 1 การเพิ่มผู้ทดสอบใบอนุญาต

   หมายเหตุ: ขั้นตอนนี้จะให้สิทธิ์การอ่านและเขียน บัญชี Google

3. เชิญบัญชี Google ของผู้ทดสอบใบอนุญาตเป็นแบบอ่านอย่างเดียวใน Google Play Console ผู้ใช้

   1. เลือกผู้ใช้และสิทธิ์ > เชิญผู้ใช้ใหม่ > เพิ่มแอป
   2. ในการเข้าถึงแอป ให้ตรวจสอบว่าช่องทำเครื่องหมายผู้ดูแลระบบ (สิทธิ์ทั้งหมด) ปรากฏอยู่ ล้างแล้ว

หมายเหตุ: ผู้ทดสอบต้องยอมรับคำเชิญจึงจะเข้าถึงตัวอย่างได้

คุณต้องเข้าสู่ระบบของผู้ทดสอบแต่ละรายที่ต้องการเปิดใช้สำหรับการทดสอบการแสดงตัวอย่าง แยกต่างหากไปยัง Android Studio ด้วยบัญชี Google ของผู้ใช้รายนั้น เมื่อเข้าสู่ระบบแล้ว ใช้ปลั๊กอิน Google Assistant เพื่อสร้างพรีวิวสำหรับผู้ใช้ทดสอบ

ใช้ปลั๊กอิน Google Assistant

เข้าถึงเครื่องมือทดสอบการดำเนินการของแอปใน Android Studio โดยไปที่เครื่องมือ > Google Assistant > เครื่องมือทดสอบการดำเนินการของแอป เมื่อคุณเปิดเครื่องมือ มุมมองจะเปลี่ยนไปตาม ว่าคุณมีหน้าตัวอย่างเครื่องมือทดสอบที่ทำงานอยู่หรือไม่

สร้าง อัปเดต และลบตัวอย่างเพลง

คุณสามารถใช้แอปเวอร์ชันร่างสำหรับการทดสอบได้ ดูข้อมูลเพิ่มเติมได้ที่เตรียมพร้อมและเปิดตัวรุ่น ทดสอบแอปในโหมดฉบับร่างก่อน ส่งไปตรวจสอบ

หมายเหตุ: ใช้เครื่องมือทดสอบ App Actions กับบิลด์แอปที่ติดตั้งในอุปกรณ์จาก Android Studio

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

หมายเหตุ: หากไม่มีตัวอย่างที่ทำงานอยู่ คุณต้องสร้างการแสดงตัวอย่างก่อน สามารถใช้ปลั๊กอินเพื่อทดสอบการดำเนินการของแอป

หากต้องการสร้างตัวอย่างเพลง ให้ทำตามขั้นตอนต่อไปนี้ใน Android Studio

1. เปิดเครื่องมือทดสอบการดำเนินการของแอป
2. (ไม่บังคับ) ป้อนชื่อและภาษาของแอปสำหรับการทดสอบ ชื่อแอปและภาษาเริ่มต้นคือ test app action และ en
3. คลิกสร้างพรีวิว หากได้รับข้อความแจ้ง ให้ตรวจสอบและยอมรับการดำเนินการของแอป นโยบายและข้อกำหนดในการให้บริการ เมื่อสร้างตัวอย่างแล้ว เครื่องมือทดสอบ การอัปเดตหน้าต่างเพื่อแสดงข้อมูลเกี่ยวกับ BII ที่พบใน ทางลัด.xml

เครื่องมือทดสอบใช้ชื่อแอปเพื่อสร้างและจำลอง Assistant คำค้นหาสำหรับการดำเนินการของแอป การดำเนินการของแอปที่ทำให้ใช้งานได้จะใช้ชื่อแอป Play Store ของคุณ สำหรับการเรียกใช้ได้ แต่คุณจะใช้ชื่อคำขอใดก็ได้ในเครื่องมือทดสอบ อย่างไรก็ตาม เราขอแนะนำให้ใช้ชื่อแอปเป็นชื่อคำขอใน เครื่องมือทดสอบ

ภาษาที่คุณระบุต้องตรงกับภาษาของ Google Assistant ใน อุปกรณ์ทดสอบ โดยคุณจะสร้างตัวอย่างได้ทีละภาษาเท่านั้น สำหรับ ตัวอย่างเช่น ถ้าภาษาของ Assistant คือภาษาอังกฤษ (สหรัฐอเมริกา) คุณสามารถป้อน en-US แต่ ไม่ใช่ en-**, en-GB หรือ en-US, en-GB คุณสามารถใช้ภาษาราก เช่น เป็น en เพื่อรวมทั้ง en-GB และ en-US

หากต้องการเปลี่ยนชื่อแอปหรือภาษาที่เลือกสำหรับตัวอย่างที่มีอยู่ ให้คลิก ปุ่มลบในเครื่องมือทดสอบ จากนั้น ป้อนค่าที่ต้องการ ชื่อและภาษาของแอปก่อนสร้างตัวอย่างใหม่

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

ข้อควรระวัง: การเปลี่ยนแปลงที่ทำกับไฟล์ shortcuts.xml จะไม่เกิดขึ้นโดยอัตโนมัติ มีผลกับหน้าตัวอย่างที่มีอยู่ คุณต้องอัปเดตตัวอย่างในเครื่องมือทดสอบก่อนจึงจะทดสอบการเปลี่ยนแปลงใหม่ได้

กำหนดค่า BII

เมื่อสร้างตัวอย่างสำหรับแอปแล้ว คุณจะทดสอบพารามิเตอร์ต่างๆ ได้ สำหรับ BII ในปลั๊กอิน สำหรับ BII แต่ละรายการในบัญชี ทางลัด.xml ปลั๊กอินจะแสดงผล ออบเจ็กต์ JSON-LD และระบุค่าพารามิเตอร์เริ่มต้น โดยคุณสามารถแก้ไข ค่าเริ่มต้นเพื่อทดสอบการดำเนินการของแอปด้วยชุดพารามิเตอร์ที่มีความหมาย และตรวจสอบว่าฟังก์ชันต่างๆ ของแอปทำงานได้อย่างถูกต้อง

โดยทั่วไปพารามิเตอร์และค่าของพารามิเตอร์จะเป็นไปตาม schema.org หรือ schema.googleapis.com ของพร็อพเพอร์ตี้และคำอธิบาย คุณดูข้อมูลเกี่ยวกับพารามิเตอร์ BII ได้โดยไปที่คำอธิบายประเภทสคีมาของพารามิเตอร์และพารามิเตอร์ระดับที่สูงขึ้น

เช่น actions.intent.GET_FOOD_OBSERVATION BII รองรับพารามิเตอร์ Intent foodObservation.forMeal schema.googleapis.com หน้าสำหรับ MealType ระบุ name เป็น พร็อพเพอร์ตี้ forMeal เป็นโหมดการโอน ซึ่งคาดว่าจะเกิด (เช่น MealTypeLunch) ของประเภท MealType ที่แจกแจงไว้

ใน เครื่องมือทดสอบนี้ คุณสามารถระบุการแจงนับใดก็ได้เป็นค่า 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

ทริกเกอร์การดำเนินการของแอป

หลังจากสร้างตัวอย่างและกำหนดค่า BII คุณสามารถทริกเกอร์ การดำเนินการของแอปในอุปกรณ์ทดสอบโดยตรงจากหน้าต่างเครื่องมือทดสอบ

หากต้องการทริกเกอร์การดําเนินการของแอปด้วยเครื่องมือทดสอบ ให้ทําดังนี้

1. เชื่อมต่ออุปกรณ์ทดสอบ
2. ในส่วนเลือกอุปกรณ์เป้าหมาย ให้เลือกอุปกรณ์ที่ต้องการ เรียกใช้การดำเนินการของแอป
3. ในส่วนทดสอบการดำเนินการของแอป ให้คลิกปุ่มเรียกใช้การดำเนินการของแอป

การดำเนินการของแอปทริกเกอร์ในเครื่องมือทดสอบจะใช้ คำสั่ง Android Debug Bridge (adb) adb คำสั่งเชลล์ที่สร้างขึ้นจะรวมข้อมูลเมตาทั้งหมดที่จําเป็นสําหรับแอป Google ในการใช้ BII แนวทางนี้จะเลียนแบบลักษณะการทํางานของ App Action หลังจากที่ Assistant ดึงข้อมูลสำคัญออกจากคําค้นหา

การบันทึกของ Android Studio

บันทึกเฉพาะสำหรับเครื่องมือทดสอบจะอยู่ใน ไฟล์บันทึกของ Android Studio ไม่ใช่ Logcat เอาต์พุต กระบวนการที่ทำงานบนเวิร์กสเตชันโดยตรงจะสร้าง Android Studio บันทึก คุณสามารถใช้เทมเพลตเหล่านี้เพื่อแก้ปัญหาการทำงานของเครื่องมือทดสอบ เช่น การสร้าง อัปเดต หรือลบหน้าตัวอย่าง

หากต้องการเข้าถึงไฟล์บันทึกของ Android Studio ให้ไปที่ความช่วยเหลือ > แสดงโปรแกรมสำรวจการเข้าสู่ระบบ (ความช่วยเหลือ > แสดงตัวค้นหาการเข้าสู่ระบบใน macOS)

คุณสามารถดูบันทึกที่เกี่ยวข้องกับการดำเนินการของแอปสำหรับแอปของคุณได้ใน Logcat Logcat จะเก็บบันทึกจากอุปกรณ์เสมือนจริงหรืออุปกรณ์จริงที่เชื่อมต่อกับ Android Studio

หากต้องการรับบันทึกการดำเนินการของแอปสำหรับอุปกรณ์ของคุณ ให้ทำตามขั้นตอนต่อไปนี้

1. เข้าถึงข้อความบันทึก Logcat โดยคลิก Logcat ใน Android Studio แถบหน้าต่างเครื่องมือ
2. ค้นหาบันทึกที่มี ActivityTaskManager

รับการสนับสนุนและแหล่งข้อมูลเพิ่มเติม

ปลั๊กอิน Google Assistant มีลิงก์ไปยังเอกสารประกอบ, Codelab, และแหล่งข้อมูลอื่นๆ สำหรับการเรียนรู้และรับความช่วยเหลือในการใช้เครื่องมือทดสอบ

คุณเปิด Assistant ใน Android Studio ได้โดยเลือกเครื่องมือ > Google Assistant > ความช่วยเหลือ

รูปที่ 2 ส่วนความช่วยเหลือของปลั๊กอิน Google Assistant