يمكن أن تساعدك Google Home UI Automator في تنفيذ Google Home app (GHA) عمليات التشغيل الآلي الخاصة بتفعيل Matter أو إيقافها أو إجراء اختبارات الانحدار على عمولتك.
المتطلبات الأساسية
لاستخدام Google Home UI Automator، يجب تحضير ما يلي:
Python 3
يُنصح باستخدام بيئة Python 3 لتشغيل النص البرمجي.
يتطلّب Google Home UI Automator الإصدار 3.11 أو الإصدارات الأحدث من Python.
هاتف Android
- فعِّل وضع تصحيح أخطاء المستخدم على هاتف Android. اطّلِع على مقالة تفعيل خيارات المطوّرين لتفعيل إعداد تصحيح الأخطاء.
- وصِّل هاتف Android بجهاز الكمبيوتر.
تطبيق Google Home
- ثبِّت تطبيق GHA على هاتف Android.
تأكَّد من أنّ إصدار GHA هو
3.1.1.14و3.32.126.2. - سجِّل الدخول إلى حسابك على 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 [--google_account GOOGLE_ACCOUNT]
| قيمة الإدخال | الوصف | مثال |
|---|---|---|
DEVICE_NAME |
تم اختيار جهاز واحد (Matter). | m5stack |
PAIRING_CODE |
رمز الإقران لجهاز Matter | 34970112332 |
ROOM_NAME |
الغرفة المخصّصة | Office |
GOOGLE_ACCOUNT |
الحساب الذي سيتم استخدامه في GHA | test@gmail.com |
إيقاف جهاز متوافق مع معيار Matter
لإيقاف جهاز Matter نهائيًا، أدخِل الأمر التالي:
ui-automator --decommission DEVICE_NAME [--google_account GOOGLE_ACCOUNT]
| قيمة الإدخال | الوصف | مثال |
|---|---|---|
DEVICE_NAME |
تعرِض هذه السمة اسم جهاز Matter تم إعداده على GHA. | m5stack |
GOOGLE_ACCOUNT |
الحساب الذي سيتم استخدامه في GHA | test@gmail.com |
إجراء اختبار تراجع
لتنفيذ اختبار الانحدار، أدخِل الرمز التالي. يجب تضمين العلامتَين
--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_account GOOGLE_ACCOUNT]
| قيمة الإدخال | الوصف | مثال |
|---|---|---|
DEVICE_NAME |
تم اختيار جهاز واحد (Matter). | m5stack |
PAIRING_CODE |
رمز الإقران لجهاز Matter | 34970112332 |
ROOM_NAME |
الغرفة المخصّصة | Office |
GOOGLE_ACCOUNT |
الحساب الذي سيتم استخدامه في GHA | test@gmail.com |
لا يتيح اختبار الانحدار سوى دورة التشغيل وإيقاف التشغيل. بشكلٍ تلقائي، سيتم تشغيل اختبار الانحدار إلى أن يستخدم المستخدمون لوحة المفاتيح لإيقاف العملية.
يمكنك إضافة ما يلي للحصول على نتائج اختبار أكثر تفصيلاً:
| القيمة | قيمة الإدخال | الوصف | مثال |
|---|---|---|---|
--repeat |
REPEAT_TIMES |
إجراء اختبار الانحدار في أوقات محدودة ومتكررة | 5 |
--hub |
HUB_VERSION |
إصدار مركز التحكّم للتحكّم في الأجهزة على "مساعد Google" | 15.20221210.3.1 |
--dut |
الجهاز قيد الاختبار | ||
MODEL |
طراز الجهاز | X123123 |
|
TYPE |
نوع الجهاز | LIGHT |
|
PROTOCOL |
بروتوكول الجهاز | MATTER |
|
--fw |
DEVICE_FIRMWARE |
البرامج الثابتة للجهاز | 2.2.0 |
الملاحظات
لإرسال أفكارك أو ملاحظاتك حول كيفية تحسين تجربتك مع Google Home UI Automator، يُرجى ملء نموذج الملاحظات.
الإبلاغ عن المشاكل
يمكنك الإبلاغ عن المشاكل التي تواجهك باستخدام أداة تتبُّع المشاكل.