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

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

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

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

لاستخدام 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.25.1.4.
2. سجِّل الدخول إلى حسابك على Google في GHA.

تثبيت Google Home UI Automator

هناك طريقتان لتثبيت 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

إيقاف جهاز Matter

لإيقاف جهاز Matter نهائيًا، أدخِل الأمر التالي:

ui-automator --decommission DEVICE_NAME

إجراء اختبار انحداري

لإجراء اختبار انحداري، أدخِل الرمز التالي. يجب تضمين العلامتَين --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]

لا يتيح اختبار الانحدار سوى دورة الإعداد والإيقاف. سيتم تشغيل اختبار الرجوع تلقائيًا إلى أن يستخدم المستخدمون لوحة المفاتيح لإيقاف العملية.

يمكنك إضافة ما يلي للحصول على نتائج اختبار أكثر تفصيلاً:

ملاحظات

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

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

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