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

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

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

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

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

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

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

ملاحظات

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

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

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