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

נושא    SDK של מכשיר

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

האיור הזה מראה איך להתאים מכשיר בתקן Matter ל-Google Home

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

כדי להשתמש בתכונה 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.

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 ל-Google Home

פירוק של מכשיר בתקן Matter

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

ui-automator --decommission DEVICE_NAME
ערך קלט תיאור דוגמה
DEVICE_NAME השם של מכשיר Matter שהוזמן ב-GHA. m5stack
האיור הזה מציג את הסמלים לשליחת משוב ודיווח
       ב-Google Home Playground.

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

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

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

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