אוטומציה של ממשק המשתמש של Google Home

Matter    Device SDK

Google Home UI Automator יכול לעזור לכם להגדיר אוטומציה של Google Home app (GHA) להפעלת עמלות, להוצאה משימוש של Matter או להרצת בדיקת רגרסיה על העמלה.

דרישות מוקדמות

כדי להשתמש ב-Google Home UI Automator, צריך להכין את הפריטים הבאים:

Python 3

מומלץ להשתמש בסביבת Python 3 כדי להריץ את הסקריפט. כדי להשתמש ב-Google Home UI Automator, נדרשת גרסה 3.11 ואילך של Python.

טלפון Android

1. מפעילים את המצב ניפוי באגים של משתמשים בטלפון Android. במאמר הפעלת אפשרויות למפתחים מוסבר איך להפעיל את הגדרת ניפוי הבאגים.
2. מחברים את הטלפון מדגם Android למחשב.

אפליקציית Google Home

1. מתקינים את GHA בטלפון Android. מוודאים שגרסת GHA היא 3.1.1.14 ו-3.25.1.4.
2. נכנסים לחשבון Google ב-GHA.

התקנה של Google Home UI Automator

יש שתי דרכים להתקין את Google Home UI Automator: PyPI או מקוד המקור. מומלץ להתקין באמצעות PyPI.

PyPI (מומלץ)

pip install google-home-ui-automator

פיתוח מקוד מקור

כדי ליצור גרסה מבוססת-מקור, מבצעים את השלבים הבאים במסוף:

1. משכפלים את המאגר הזה:

   git clone https://testsuite-smarthome-matter.googlesource.com/ui-automator
   

2. עוברים למאגר המשובך:

   cd ui-automator
   

3. מריצים את הפקודה הבאה:

   pip install .
   

איך מגדירים מכשיר בתקן Matter

כדי להפעיל מכשיר Matter, מזינים את הפקודה הבאה:

ui-automator --commission DEVICE_NAME,PAIRING_CODE,ROOM_NAME

ערך קלט	תיאור	דוגמה
DEVICE_NAME	מכשיר Matter שנבחר.	m5stack
PAIRING_CODE	קוד ההתאמה של מכשיר Matter.	34970112332
ROOM_NAME	החדר שהוקצה.	Office

הוצאה משימוש של מכשיר בתקן Matter

כדי להוציא משימוש מכשיר Matter, מזינים את הפקודה הבאה:

ui-automator --decommission DEVICE_NAME

ערך קלט	תיאור	דוגמה
DEVICE_NAME	השם של מכשיר Matter שהוקצה ב-GHA.	m5stack

הרצת בדיקת רגרסיה

כדי להריץ בדיקת רגרסיה, מזינים את הקוד הבא. כדי להריץ את בדיקת הרגרסיה, צריך לכלול את הדגלים --regtest ו---commission.

ui-automator --commission DEVICE_NAME,PAIRING_CODE,ROOM_NAME --regtest [--repeat REPEAT_TIMES] [--hub HUB_VERSION] [--dut MODEL,TYPE,PROTOCOL] [--fw DEVICE_FIRMWARE]

בדיקת הרגרסיה תומכת רק במחזור ההפעלה וההוצאה משימוש. כברירת מחדל, בדיקת הרגרסיה תרוץ עד שהמשתמשים ישתמשו במקלדת כדי לעצור את התהליך.

כדי לקבל תוצאות בדיקה מפורטות יותר, אפשר להוסיף את האפשרויות הבאות:

ערך	ערך קלט	תיאור	דוגמה
--repeat	REPEAT_TIMES	הפעלת בדיקת רגרסיה במספר מוגבל של פעמים ובתדירות קבועה.	5
--hub	HUB_VERSION	גרסת Hub לשליטה במכשירים ב-GHA.	15.20221210.3.1
--dut		המכשיר שנבדק.
	MODEL	דגם המכשיר.	X123123
	TYPE	סוג המכשיר.	LIGHT
	PROTOCOL	פרוטוקול המכשיר.	MATTER
--fw	DEVICE_FIRMWARE	הקושחה של המכשיר.	2.2.0

משוב

כדי לשלוח לנו משוב על דרכים לשיפור חוויית השימוש ב-Google Home UI Automator, אפשר למלא את טופס המשוב.

דיווח על בעיות

מדווחים על בעיות באמצעות מערכת המעקב אחר בעיות.