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

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

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

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

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

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

بايثون 3

يوصى باستخدام بيئة بايثون 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"، يُرجى ملء نموذج الملاحظات.

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

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