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

Matter    Device 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.1.1.14 ו-3.24.1.4.
  2. עליך להתחבר לחשבון Google שלך ב-GHA.

התקנה של Google Home UI Automator

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

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

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