يوفّر 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.
استخدِم Test Suite في Developer Console ل إرسال نتائج الاختبار للحصول على الشهادة. إذا كنت تريد تشغيل Test Suite لأغراض الاختبار أثناء التطوير، يُرجى الاطّلاع على صفحة مجموعة اختبارات Google Home للاطّلاع على الإصدار المُنفِّذ بشكل مستقل.
إصدارات الدمج
عند إنشاء خطة اختبار للحصول على شهادة الاعتماد، يتم إنشاء إصدار جديد من عملية الدمج. يتم إدراج هذا الإصدار المرقّم من التكامل في جميع قوائم الدمج في Developer Console بدءًا من علامة التبويب "الاختبار" فصاعدًا.
لا يتم أبدًا إنشاء نُسخ جديدة من نُسخ مرقّمة أخرى. على سبيل المثال، ستنشئ خطة الاختبار الأولى التي تنشئها لعملية دمج الإصدار v.1 لعملية الدمج هذه. سيؤدي إنشاء خطة اختبار أخرى إلى إنشاء الإصدار 2 لهذا التكامل، ولكن لن يستند هذا الإصدار إلى الإصدار 1. بدلاً من ذلك، يستند هذا الإصدار إلى مثيل الدمج غير المحدَّد الإصدار، تمامًا مثل v.1.
يمثّل إصدار الدمج لا ينطبق النسخة غير المحدَّدة من عملية الدمج، والتي تتم إدارتها في علامة التبويب تطوير.
بعبارة أخرى، في Matter > الاختبار في Developer Console:
- إذا نقرت على اختبار للإصدار لا ينطبق من عملية الدمج، سيتم إنشاء إصدار جديد. سيكون رقم الإصدار أعلى من أي إصدارات مرقّمة حالية.
- إذا لم تكن هناك نُسخ مرقّمة، يتم إنشاء الإصدار v.1.
- إذا كان الإصدار v.1 متوفّرًا، يتم إنشاء الإصدار v.2. إذا كان الإصدار v.2 متوفّرًا، يتم إنشاء الإصدار v.3، وهكذا.
- إذا نقرت على اختبار لإصدار مرقّم من عملية الدمج (مثل الإصدار 1)، لن يتم إنشاء إصدار جديد. بدلاً من ذلك، يتم اختبار الإصدار v.1 مرة أخرى.
لمزيد من المعلومات، يُرجى الاطّلاع على دمج إصدار.
إنشاء خطة اختبار
نُسخ الدمج هي لقطة لعملية دمج لم يتمّ وضع رقم إصدار لها. وهذا يعني أنّه عند إنشاء خطة اختبار للحصول على شهادة الاعتماد، وبالتالي إصدار دمج، يجب أن تكون جميع البيانات الوصفية المرتبطة بهذا الدمج هي المعلومات التي تريد استخدامها للدمج الذي تم إطلاقه.
قبل إنشاء خطة اختبار للحصول على الاعتماد، تأكَّد من تنفيذ ما يلي:
- إنشاء ملف تعريفي للشركة
- تم إدخال معرّف المورِّد (VID) للإصدار العلني لعملية الدمج.
- الإعدادات والعلامة التجارية التي تم ضبطها
إذا لم تكن قد أكملت كل هذه الخطوات لعملية الدمج، لا يمكن اعتماد إصدار الدمج الذي تم إنشاؤه لاختبار الاعتماد. عليك إنشاء إصدار جديد، ما يعني إعادة تنفيذ خطوات الاختبار والإصدار التجريبي الميداني والاعتماد.
سيكون عليك أيضًا إنشاء إصدار جديد والبدء من جديد إذا أردت تعديل علامتك التجارية قبل اعتماد إصدار دمج.
لإنشاء خطة اختبار:
من قائمة المشاريع، انقر على فتح بجانب المشروع الذي تريد العمل عليه.
في قائمة التنقّل على يمين الصفحة، انتقِل إلى Matter > الاختبار.
انقر على اختبار للإصدار لا ينطبق من عملية الدمج التي تريد اختبارها. يؤدي هذا الإجراء إلى إنشاء إصدار دمج جديد.
اختَر نوع الاختبار من اختبار التطوير أو اختبار الاعتماد.
- اختَر اختبار الاعتماد إذا كنت تستعد للحصول على شهادة اعتماد في منظومة Google المتكاملة.
- لا يمكن استخدام اختبار التطوير للحصول على شهادة الاعتماد.
انقر على اختبار. إذا ظهرت لك شاشة خطأ لم يتم العثور على أي جهاز، يعني ذلك أنّه لم يتم تفعيل جهاز لهذا الدمج في المنظومة المتكاملة بعد. لمزيد من المعلومات، يمكنك الاطّلاع على تحديد وحلّ المشاكل المتعلّقة pairing.
في شاشة ضبط الاختبار، أدخِل اسمًا لاختبارك و اختَر الأجهزة التي تريد اختبارها من قائمة الأجهزة.
انقر على الزر التالي: خطة الاختبار.
في صفحة إنشاء خطة اختبار، في قسم مجموعات الاختبار، اختَر مجموعات الاختبار التي تريد تنفيذها.
إذا أردت الخروج من Test Suite، انقر على
الرجوع إلى "مركز المطوّرين".
تنفيذ خطة الاختبار
في Test Suite، من صفحة إنشاء خطة اختبار، انقر على تشغيل الاختبار. تظهر صفحة بيئة الاختبار، مع حالة وملفّات log لجميع الاختبارات.
تظهر نتائج الاختبار بعد اكتمالها. تظهر حالة تنفيذ كل مجموعة اختبارات بجانبها (اجتاز أو تعذّر).
تعرِض لوحة السجلّات حالة كلّ عملية تنفيذ فردية للاختبار.
لإعادة اختبار خطة اختبار من صفحة بيئة الاختبار، انقر على
إعادة الاختبار في أعلى الصفحة
بعد اكتمال تنفيذ الاختبار.
بعد الانتهاء:
- انقر على تم للانتقال إلى صفحة سجلّ الاختبار.
- انقر على إرسال لإرسال نتائج الاختبار من أجل الحصول على الاعتماد.
عرض نتائج الاختبار وتفسيرها
في صفحة سجلّ الاختبار في Test Suite، يمكنك الاطّلاع على نتائج الاختبار السابقة لخطة تطوير أو خطة اختبار لم يتم إرسالها للحصول على شهادة اعتماد، وذلك من خلال النقر على إعادة الاختبار لخطة الاختبار المطلوبة في القسم خطط الاختبار. سينقلك هذا الإجراء إلى صفحة البيئة الاختبارية التي تعرض نتائج هذا الاختبار.
بالنسبة إلى خطة شهادة تم إرسالها، انقر على النتائج في قسم محفوظة لأجل الحصول على شهادة لعرض تقرير نتائج الاختبار.
يمكن أيضًا الوصول إلى نتائج الاختبار لإصدار دمج من علامة التبويب الاختبار في Developer Console. انقر على عرض سجلّ الاختبارلأي إصدار تكامل مُدرَج في تلك الصفحة للانتقال إلى صفحة سجلّ الاختبار في Test Suite.
حالات وحدة التحكّم
تظهر حالات Console التالية في مرحلة الاختبار:
| Section | الحالة | الوصف | المتطلبات | الإجراءات التي يجب اتخاذها كخطوة تالية |
|---|---|---|---|---|
| جاهز للاختبار | جاهز | هذا الإصدار من integration جاهز للاختبار. | لا ينطبق | اختبِر هذا الإصدار من integration. |
| تم اختباره | جاهز | تم اختبار هذا الإصدار من integration ويمكن إرساله للاستخدام التجريبي في الميدان أو للحصول على شهادة الاعتماد. |
تم اختبار الإصدار وحفظه. تتضمّن جميع حالات الاختبار التي تعذّر إكمالها تبريرات لمراجعتها من قِبل Google. |
أعِد الاختبار إذا أردت. |
تحديد المشاكل وحلّها
عدم ظهور الجهاز المفوض في مجموعة الاختبار
إذا ربطت جهازًا بمعرّف مورّد (VID) ومعرّف منتج (PID) تجريبيَين، ولكنه لا يظهر عند محاولة اختبار الجهاز باستخدام "مجموعة الاختبار" في Developer Console، من المحتمل أن يكون السبب هو استخدام مجموعة VID وPID التجريبية نفسها في عمليات دمج متعددة.
لتحديد المشاكل وحلّها، عليك إزالة جميع الأجهزة الاختبارية من Developer Console وإقران الجهاز الذي تريد اختباره مرة أخرى.
للتأكّد من إقران الجهاز الصحيح، يمكنك ضبط معلومات الشركة المصنّعة
ومعلومات الطراز (قيم CHIP_DEVICE_CONFIG_DEVICE_*) للجهاز على
قيم فريدة في البرامج الثابتة الاختبارية.
يمكنك الاطّلاع على معلومات الجهاز للحصول على المزيد من المعلومات.
التحقّق من رقمَي VID/PID لجهازك
إذا كنت تريد بدء تطوير عملية الدمج مع Google، عليك إنشاء مشروع وعملية دمج على Google Home Console.
يجب أن تتطابق قيمة VID/PID التي يرسلها جهازك مع قيمة VID/PID التي أدخلتها في مشروعك على Developer Console.
- أرقام VID من
0xFFF1إلى0xFFF4محجوزة للاختبار. ويمكن استخدامها في اختبارات الإعداد الأساسية واختبارات التحكّم، ولكن لا يمكن استخدامها خلال المرحلة التالية من التطوير:
باستخدام تطبيق هندسي للبلوتوث، مثل nRF Connect for Mobile، يمكنك الاطّلاع على VID/PID لجهاز الإرسال في حقل بيانات الخدمة.
في لقطة الشاشة هذه من الإصدار Android من nRF Connect،
ستلاحظ أنّ VID/PID مُدرَجَان على أنّهما 5A23FFFE بدءًا من البايت الرابع من
حقل بيانات الخدمة. يشير ذلك إلى رقم VID 5A23 ورقم PID FFFE،
وكلاهما بتنسيق little endian.
يعرض تطبيق BLE القيم بترتيب endian الصغير، ولكن قيم VID/PID التي تُدخلها في مشروع Developer Console تكون بترتيب endian الكبير.
تأكَّد من إدخال القيم والتنسيق الصحيحَين في مشروعك على "وحدة تحكّم الإجراءات" بالاستناد إلى ما يعرضه أداة فحص حركة المرور في البلوتوث.
بالنسبة إلى القيم الواردة في مثال لقطة الشاشة، ستكون قيم VID وPID في
Developer Console 235A وFEFF على التوالي.