المسألة حزمة تطوير البرامج (SDK) للجهاز
يمكن أن يساعدك Google Home UI Automator في برمجة Google Home app (GHA) العمولة أو الإيقاف Matter أو إجراء اختبار انحدار على العمولة.
المتطلّبات الأساسية
لاستخدام Google Home UI Automator، يجب تحضير ما يلي:
بايثون 3
يوصى باستخدام بيئة بايثون 3 لتشغيل النص البرمجي.
تتطلب الدالة Google Home UI Automator استخدام لغة python 3.11
أو إصدار أحدث.
هاتف يعمل بنظام التشغيل Android
- فعِّل وضع تصحيح أخطاء المستخدم على هاتفك Android. راجِع تفعيل خيارات المطوّرين لتفعيل إعداد تصحيح الأخطاء.
- وصِّل هاتف Android بجهاز الكمبيوتر.
تطبيق Google Home
- ثبِّت تطبيق "GHA" على هاتف "Android".
تأكَّد من أنّ إصدار GHA يعمل بـ
3.10.1.6
أو أحدث. - سجِّل الدخول إلى حسابك على Google في GHA.
تثبيت Google Home UI Automator
هناك طريقتان لتثبيت Google Home UI Automator أو PyPI أو من رمز المصدر. ننصحك بالتثبيت باستخدام PyPI.
PyPI (موصى بها)
pip install google-home-ui-automator
الإنشاء من رمز المصدر
للإنشاء من رمز مصدر، اتّبِع الخطوات التالية في الوحدة الطرفية:
استنساخ هذا المستودع:
git clone https://testsuite-smarthome-matter.googlesource.com/ui-automator
انتقل إلى المستودع المنسوخ:
cd ui-automator
شغِّل الأمر التالي:
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
لإيقاف جهاز Matter، أدخِل الأمر التالي:
ui-automator --decommission DEVICE_NAME
قيمة الإدخال | الوصف | مثال |
---|---|---|
DEVICE_NAME |
يعرض هذا العمود اسم جهاز "Matter" الذي تم التحقّق منه على "GHA". | m5stack |
![يعرض هذا الشكل رموز تقديم الملاحظات والإبلاغ عن المشاكل في Google Home Playground.](https://developers.home.google.com/static/tools/images/ui-automator-decommission.png?authuser=0&hl=ar)
إجراء اختبار انحدار
لإجراء اختبار انحدار، أدخِل الرمز التالي. يجب تضمين العلامة
--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"، يُرجى ملء نموذج الملاحظات.
الإبلاغ عن المشكلات
يمكنك الإبلاغ عن المشاكل التي واجهتها باستخدام أداة تتبُّع المشاكل.