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

Matter    SDK של המכשיר

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

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

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

Python 3

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

טלפון Android

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

אפליקציית Google Home

1. צריך להתקין את GHA בטלפון Android. צריך לוודא שהגרסה של GHA היא 3.10.1.6 ואילך.
2. התחבר לחשבון Google שלך ב-GHA.

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

יש שתי דרכים להתקין את 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, אתם יכולים למלא את טופס המשוב.

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

בעזרת הכלי למעקב אחר בעיות תוכלו לדווח על בעיות שנתקלתם בהן.