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