أداة برمجة واجهة مستخدم Google Home

Matter    حزمة تطوير البرامج (SDK) للأجهزة

يمكن أن تساعدك Google Home UI Automator في إعداد Google Home app (GHA) بشكل آلي لتفعيل Matter أو إيقافها أو إجراء اختبار regression على عمولتك.

يوضّح هذا الشكل كيفية إقران جهاز متوافق مع معيار Matter بجهاز Google Home.

المتطلّبات الأساسية

لاستخدام Google Home UI Automator، يجب تحضير ما يلي:

بايثون 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 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 إصدار مركزي للتحكّم في الأجهزة على خدمات الأجهزة الجوّالة للمؤسسات (GHA). 15.20221210.3.1
--dut الجهاز قيد الاختبار.
MODEL طراز الجهاز X123123
TYPE نوع الجهاز LIGHT
PROTOCOL بروتوكول الجهاز. MATTER
--fw DEVICE_FIRMWARE البرامج الثابتة على الجهاز 2.2.0

يوضح هذا الشكل ملخص اختبار الانحدار

ملاحظات

لإرسال أفكارك أو ملاحظاتك حول كيفية تحسين تجربتك مع Google Home UI Automator، يُرجى إكمال نموذج الملاحظات.

الإبلاغ عن المشاكل

يمكنك الإبلاغ عن المشكلات التي تواجهها باستخدام أداة تتبّع المشاكل