توفر Google Home Developer Console صفحة اختبار يمكنك من خلالها إعداد الاختبارات وتشغيلها على عملية دمج Matter باستخدام Google Home Test Suite. Test Suite هو تطبيق منفصل مضمّن في Developer Console ويتولّى جميع اختبارات الدمج.
يجب إعداد الأجهزة لمعرّف المورّد ومعرّف المنتج لعملية الدمج وأن تكون متاحة في Google Home app (GHA) للحساب المستخدَم مع Developer Console لكي يتم اختبارها. يُرجى الاطّلاع على مقالة إقران جهاز Matter لمزيد من المعلومات.
يمكن تشغيل Test Suite على مجموعة من الأجهزة التي تنتمي إلى إعداد مشروع Matter معيّن. من المهم جدًا تشغيل Test Suite على عمليات الدمج للتأكّد من أنّ كل شيء يعمل بشكلٍ صحيح.
في صفحة اختبار ، يتم إدراج عمليات دمج Matter المكتملة والجاهزة للاختبار في قسم جاهز للاختبار.
يتم إدراج عمليات دمج Matter التي تم اختبارها في قسم تم الاختبار.
أنواع خطط الاختبار
تتوفّر الأنواع التالية من خطط الاختبار:
تُستخدَم خطط اختبار التطوير لاختبار التحكّم في الأجهزة باستخدام Matter. يمكن تعديلها، ولكن لا يمكن إرسالها للحصول على Matter شهادة.
خطط اختبار**الشهادة** مخصّصة للحصول على شهادة Matter، ولا يمكن تعديلها. سيؤدي اختيار هذا الخيار إلى إنشاء إصدار جديد من عملية دمج Matter.
تسمح لك خطط اختبار التشغيل التفاعلي لـ CSA بتخطّي مرحلة الاختبار واستخدام نتائج "مختبر اختبار التشغيل التفاعلي" التابع لـ Connectivity Standards Alliance (Alliance). يتوفّر خيار الاختبار هذا لجميع أنواع الأجهزة المتوافقة.
استخدِم Test Suite في Developer Console لـ إرسال نتائج الاختبار للحصول على الشهادة. إذا أردت تشغيل الـ Test Suite لأغراض الاختبار أثناء التطوير، يُرجى الاطّلاع على صفحة الـ Google Home Test Suite للحصول على الإصدار الـ المستقل.
إصدارات عمليات الدمج
عند إنشاء خطة اختبار للحصول على الشهادة، يتم إنشاء إصدار جديد من عملية الدمج. يظهر هذا الإصدار المرقّم في جميع قوائم عمليات الدمج في Developer Console بدءًا من علامة التبويب "اختبار".
لا يتم إنشاء إصدارات جديدة من إصدارات مرقّمة أخرى أبدًا. على سبيل المثال، سيؤدي إنشاء أول خطة اختبار لعملية دمج إلى إنشاء الإصدار v.1 من عملية الدمج هذه. سيؤدي إنشاء خطة اختبار أخرى إلى إنشاء الإصدار الإصدار 2 من عملية الدمج هذه، ولكن لن يستند هذا الإصدار إلى الإصدار 1. بدلاً من ذلك، يستند هذا الإصدار إلى النسخة غير المرقّمة من عملية الدمج، تمامًا كما كان v.1.
يمثّل الإصدار لا ينطبق من عملية الدمج النسخة غير المرقّمة من عملية الدمج، والتي تتم إدارتها في علامة التبويب تطوير.
بعبارة أخرى، في Matter > اختبار في الـ Developer Console:
- إذا نقرت على اختبار للإصدار لا ينطبق من عملية الدمج، يتم إنشاء إصدار جديد. سيكون رقم الإصدار أعلى بواحد من أي إصدارات مرقّمة حالية.
- إذا لم تكن هناك إصدارات مرقّمة، يتم إنشاء الإصدار v.1.
- إذا كان الإصدار الإصدار 1 موجودًا، يتم إنشاء الإصدار الإصدار 2. إذا كان الإصدار الإصدار 2 موجودًا، يتم إنشاء الإصدار الإصدار 3، وهكذا.
- إذا نقرت على اختبار لإصدار مرقّم من عملية الدمج (على سبيل المثال، الإصدار 1)، لا يتم إنشاء إصدار جديد. بدلاً من ذلك، يتم اختبار الإصدار v.1 مرة أخرى.
لمزيد من المعلومات، يُرجى الاطّلاع على مقالة تحديد إصدارات عمليات الدمج.
إنشاء خطة اختبار
إصدارات عمليات الدمج هي لقطة لعملية دمج غير مرقّمة. يعني ذلك أنّه عند إنشاء خطة اختبار للحصول على الشهادة، وبالتالي إنشاء إصدار من عملية الدمج، يجب أن تكون جميع البيانات الوصفية المرتبطة بعملية الدمج هذه هي المعلومات التي تريد استخدامها لعملية الدمج التي تم إطلاقها.
قبل إنشاء خطة اختبار للحصول على الشهادة، تأكَّد من تنفيذ ما يلي:
- تم إنشاء الملف التعريفي للشركة.
- إدخال معرّف المورّد (VID) للإنتاج لعملية الدمج.
- إعداد عملية الإعداد والعلامة التجارية.
إذا لم تُكمل كل هذه الخطوات لعملية الدمج، لا يمكن الحصول على شهادة لإصدار عملية الدمج الذي تم إنشاؤه لاختبار الشهادة. عليك إنشاء إصدار جديد، ما يعني إعادة خطوات "الاختبار" و"التجربة الميدانية" و"الحصول على الشهادة".
عليك أيضًا إنشاء إصدار جديد والبدء من جديد إذا أردت تعديل علامتك التجارية قبل الحصول على شهادة لإصدار عملية الدمج.
لإنشاء خطة اختبار، اتّبِع الخطوات التالية:
من قائمة المشاريع، انقر على فتح بجانب المشروع الذي تريد العمل عليه.
في قائمة التنقّل على يمين الصفحة، انتقِل إلى Matter > اختبار.
انقر على اختبار للإصدار لا ينطبق من عملية الدمج التي تريد اختبارها. يؤدي هذا الإجراء إلى إنشاء إصدار جديد من عملية الدمج.
اختَر نوع اختبار وانقر على اختبار.
- اختَر اختبار الشهادة إذا كنت تستعد للحصول على الشهادة في نظام Google الأساسي.
- لا يمكن استخدام اختبار التطوير للحصول على الشهادة.
- اختَر اختبار التشغيل التفاعلي لـ CSA لاستخدام نتائج Alliance "مختبر اختبار التشغيل التفاعلي" لتخطّي مرحلتَي "الاختبار" و "التجربة الميدانية" في مسار عملية دمج Matter.
في شاشة إعداد الاختبار ، أدخِل اسمًا للاختبار وانقر على إقران الجهاز تلقائيًا لاختيار جهاز لإقرانه.
بالنسبة إلى جهاز Android:
- تأكَّد من تثبيت GHA على هاتفك.
- وصِّل هاتفك بالجهاز المضيف باستخدام كابل USB.
- عليك
تفعيل ميزة تصحيح أخطاء USB على جهازك
سيتم تلقائيًا تنزيل
وتثبيت
APKcom.chip.interop.moblysnippet. - بعد توصيل هاتفك، أدخِل رمز الإقران واسم الجهاز لإقران جهازك تلقائيًا.
بالنسبة إلى جهاز iOS:
- عليك إقران جهازك يدويًا. يُرجى الاطّلاع على قسم تطبيق Google Home للحصول على تعليمات حول الإقران اليدوي.
- إذا كان لديك جهاز حالي، قد يُطلب منك إلغاء إقران الجهاز وإقرانه مرة أخرى أو إقران جهاز جديد.
انقر على الزر التالي: خطة الاختبار.
في صفحة إنشاء خطة اختبار ، اختَر مجموعات الاختبار التي تريد تشغيلها في قسم مجموعات الاختبار.
إذا أردت الخروج من Test Suite، انقر على
العودة إلى مركز
المطوّرين.
تشغيل خطة الاختبار
في Test Suite، من صفحة إنشاء خطة اختبار، انقر على تشغيل الاختبار. تظهر صفحة بيئة الاختبار ، التي تعرض حالة جميع الاختبارات وسجلّاتها.
تظهر نتائج الاختبار بعد اكتمال الاختبارات. تظهر حالة كل عملية تشغيل لمجموعة الاختبار بجانبها (ناجح أو تعذّر).
تعرض لوحة السجلّات حالة كل تنفيذ تجريبي فردي.
لإعادة اختبار خطة اختبار من صفحة بيئة الاختبار ، انقر على
إعادة الاختبار في أعلى الصفحة
بعد اكتمال تشغيل الاختبار.
بعد الانتهاء:
- انقر على تم للانتقال إلى صفحة سجلّ الاختبار ، أو
- انقر على إرسال لـ إرسال نتائج الاختبار لـ الشهادة.
عرض نتائج الاختبار وتفسيرها
في صفحة سجلّ الاختبار في Test Suite، يمكنك عرض نتائج الاختبارات السابقة لخطة تطوير أو خطة اختبار شهادة لم يتم إرسالها بعد، وذلك بالنقر على إعادة الاختبار لخطة الاختبار المطلوبة في قسم خطط الاختبار. سينقلك هذا إلى صفحة بيئة الاختبار التي تعرض نتائج هذا الاختبار.
بالنسبة إلى خطة الشهادة التي تم إرسالها، انقر على النتائج في قسم تم الحفظ للحصول على الشهادة لعرض تقرير نتائج الاختبار.
يمكن أيضًا الوصول إلى نتائج الاختبار لإصدار عملية دمج من علامة التبويب اختبار في Developer Console. انقر على عرض في سجلّ الاختبار لأي إصدار من عمليات الدمج المُدرَجة في تلك الصفحة للانتقال إلى صفحة سجلّ الاختبار في Test Suite.
حالات وحدة التحكّم
في ما يلي حالات وحدة التحكّم التي تظهر في مرحلة الاختبار:
| Section | الحالة | الوصف | المتطلبات | الخطوات التالية |
|---|---|---|---|---|
| جاهز للاختبار | جاهز | هذا الإصدار من integration جاهز للاختبار. | لا ينطبق | اختبِر هذا الإصدار من integration. |
| تم الاختبار | جاهز | تم اختبار هذا الإصدار من integration ويمكن إرساله للتجربة الميدانية أو للحصول على الشهادة.Field Trial |
تم اختبار الإصدار وحفظه. تتضمّن جميع حالات الاختبار التي تعذّر إجراؤها مبرّرات لمراجعتها من قِبل Google. |
أعِد الاختبار إذا أردت ذلك. |
إعادة الاختبار
الشهادة
إذا كنت بحاجة إلى إعادة الاختبار للحصول على الشهادة، عليك إقران جهازك بعد بدء إعادة الاختبار.
تطوير
إذا كنت بحاجة إلى إعادة الاختبار لأغراض التطوير، يمكنك استخدام الجهاز الحالي بدون إقرانه مرة أخرى.
تحديد المشاكل وحلّها
لا يظهر الجهاز الذي تم إعداده في Test Suite
إذا سبق لك إقران جهاز بمعرّف مورّد (VID) ومعرّف منتج (PID) للاختبار، ولكن لا يظهر عند محاولة اختبار الجهاز باستخدام Test Suite في Developer Console، من المرجّح أنّ السبب هو استخدام مجموعة معرّف المورّد ومعرّف المنتج نفسها للاختبار في عمليات دمج متعددة.
لتحديد المشكلة وحلّها، أزِل جميع أجهزة الاختبار من Developer Console وأقرِن الجهاز الذي تريد اختباره مرة أخرى.
للتأكّد من أنّك أقرنت الجهاز الصحيح، يمكنك ضبط معلومات الشركة المصنّعة والطراز (قيم CHIP_DEVICE_CONFIG_DEVICE_*) للجهاز على قيم فريدة في البرامج الثابتة للاختبار.
لمزيد من المعلومات، يُرجى الاطّلاع على معلومات الجهاز.
التأكّد من معرّف المورّد ومعرّف المنتج لجهازك
إذا أردت بدء تطوير عملية الدمج مع Google، عليك إنشاء مشروع وعملية دمج على Google Home Console.
يجب أن تتطابق قيمة معرّف المورّد ومعرّف المنتج التي يرسلها جهازك مع معرّف المورّد ومعرّف المنتج الذين تم إدخالهما في مشروعك Developer Console.
- معرّفات المورّدين
0xFFF1—0xFFF4محجوزة للاختبار. يمكن استخدامها لإجراء اختبارات الإعداد والتحكّم الأساسية، ولكن لا يمكن استخدامها خلال مراحل التطوير التالية:
باستخدام تطبيق هندسي للبلوتوث، مثل nRF Connect for Mobile، يمكنك الاطّلاع على معرّف المورّد ومعرّف المنتج للجهاز الذي يرسل إشارات في حقل بيانات الخدمة.
في لقطة الشاشة هذه من إصدار Android من nRF Connect،
سترى أنّ معرّف المورّد ومعرّف المنتج مُدرَجان على النحو 5A23FFFE بدءًا من البايت الرابع من
حقل بيانات الخدمة. يشير ذلك إلى معرّف مورّد 5A23 ومعرّف منتج FFFE، وكلاهما بتنسيق little endian.
يعرض تطبيق BLE القيم بتنسيق little endian، ولكن قيم معرّف المورّد ومعرّف المنتج التي تُدخلها في مشروع Developer Console تكون بتنسيق big endian.
تأكَّد من إدخال القيم والتنسيق الصحيحَين في مشروع Actions Console استنادًا إلى ما يعرضه جهاز تتبُّع البلوتوث.
بالنسبة إلى القيم في لقطة الشاشة كمثال، سيكون معرّف المورّد ومعرّف المنتج في الـ
Developer Console هما 235A وFEFF على التوالي.