Google Home Test Suite is a web application that allows you to self-test your smart home Action. The Test Suite automatically generates and runs test cases based on the devices and traits associated with your account. When you complete the tests, you can view the test results or fill in the submission form to submit the test results to Google.
تشمل الاختبارات التي يتم تنفيذها بواسطة Test Suite ما يلي على سبيل المثال لا الحصر:
تأكّد من تنفيذ حالة التقرير ومزامنة الطلب للأجهزة والسمات.
يتحقّق من أنّه تم تنفيذ intent QUERY لجهازك وأن نتائجها تتطابق مع نتائج حالة التقرير.
يمكنك تشغيل أداة Test Suite بالنقر على الزر أدناه:
اختبار الإجراء بنفسك
يصف القسم التالي كيفية تشغيل Test Suite على جهازك ومشاريعك في المنزل المزوّد بأجهزة ذكية. يتطلب Test Suite منك تسجيل الدخول حتى يتمكن من فحص الأجهزة في Google Home Graph and send commands directly to Google Assistant .
لاختبار الإجراء بنفسك، اتّبع الخطوات التالية:
- في متصفح الويب، افتح Test Suite.
سجّل الدخول إلى Google باستخدام زر الجانب العلوي الأيسر.
اضبط تفاصيل المشروع:
- في حقل رقم تعريف المشروع، أدخِل معرّف المشروع لإجراء "بالمنزل الذكي".
- انقر على التالي.
اضبط إعدادات الاختبار:
- في حال اعتماد إجراء المنزل المزوّد بأجهزة ذكية، اترك القيمة التلقائية حالة التقرير/مهلة مزامنة الطلب بدون تغيير. ومع ذلك، بالنسبة إلى الاختبار، يمكنك تغيير قيمة المهلة إذا استغرق الوكيل المزيد من الوقت للإبلاغ عن الحالة إلى الرسم البياني الرئيسي.
في حال اعتماد إجراء المنزل المزوّد بأجهزة ذكية، احرص على تفعيل خيار اختبار طلب المزامنة أثناء الاختبار، سيُطلب منك إضافة جهاز أو تحديثه أو إزالته والتحقق مما إذا كانت قائمة الأجهزة قد تغيرت في الرسم البياني الرئيسي. يتم تنفيذ الإجراءات من خلال التكامل الذي تختبره. يجب أن يكون التكامل قيد الاختبار دائمًا مزودًا بجهاز واحد على الأقل.
إذا كنت تستخدم سمة Scene (المشهد)، اختَر Test en Scene (سمة المشهد).
إذا كنت تشغِّل مجموعة الاختبار لأجهزة Home Home، اختَر يتوافق مع حزمة تطوير البرامج (SDK) المحلية للمنزل.
- اختَر تلبية الطلبات المحلية أو الإعداد السلس.
- انقر على يتوافق مع طلب البحث المحلي إذا كان الجهاز يمكنه التعامل مع طلب البحث QUERY محليًا.
إجراء تشغيل تجريبي وعرض النتائج:
- انقر على التالي لبدء إجراء الاختبارات. تعرض الواجهة الأجهزة والسمات التي يتم اختبارها.
عرض صفحة النتائج والإرسال:
- بعد اكتمال الاختبارات، انقر على التالي لعرض النتائج.
وتشمل نتائج الاختبارات عدد الاختبارات التي تم اجتيازها والتي تعذّر اجتيازها، بالإضافة إلى نتيجة نهائية تشير إلى النسبة المئوية لعدد الاختبارات.
اختبار التحقق من ربط الحساب
يؤدي ربط الحساب دورًا مهمًا في نظام Google Smart home. يتحقّق Test Suite من عملية التحقّق من صحة ربط الحساب في خدمة OAuth بحثًا عن المشاكل المحتمَلة.
يحتوي اختبار التحقّق من ربط الحساب على اختبارات للتحقّق من صحة رموز الدخول والرموز المميّزة لإعادة التحميل:
اختبار التحقق من رمز الدخول
يتم اختبار رموز الدخول التي يتم عرضها من نقطة نهاية تبادل الرمز المميز للتأكد من أن تنسيقها صالح ويتم إرجاعها برمز تحديث صالح.
| عناصر الاختبار | الشرح |
|---|---|
| التحقق مما إذا كان رمز الدخول بتنسيق JWT | لا ينصح ربط حساب Google باستخدام رموز الدخول المميّزة بتنسيق JWT. إذا تم العثور على تنسيق JWT، يتم عرض التحذير التالي: The access token seems to be JWT, this is not good. Because it
unnecessarily exposes information about partner implementation and we
recommend opaque symmetric encrypted access token.
|
| تحقَّق من أن رمز الدخول المنتهي الصلاحية يتضمن رمزًا مميزًا للتحديث. | يجب توفير رمز تحديث عند انتهاء صلاحية رمز الدخول. وسيخفق هذا الاختبار في حالة عدم العثور على رمز تحديث مميز. |
إعادة تحميل اختبار التحقّق من صحة الرمز المميّز
يتم اختبار الرموز المميزة لإعادة التحميل للتأكّد من أن نقطة نهاية تبادل الرمز المميز تستبدلها برموز دخول جديدة.
| عناصر الاختبار | الشرح |
|---|---|
| الرمز المميز لإعادة التحميل مع الرمز المميز لإعادة التحميل غير صالح، جارٍ التحقق من رد الشريك. | يجب أن يعرض الخادم خطأ HTTP 400 طلب غير صالح مع
{"error": "invalid_grant"} على طلب رمز مميز لإعادة التحميل غير صالح.
وإذا لم يتطابق الرد مع "رمز أو رسالة خطأ"، سيتعذّر إجراء هذه التجربة. لمزيد من المعلومات، يُرجى الانتقال إلى تبادل الرموز المميزة لإعادة التحميل للحصول على رموز الدخول. |
| اختبر إذا ما تم تحديث رمز الدخول بعد تحديث الرمز المميز. | يجب عرض رموز الدخول الجديدة استجابةً لطلبات الرمز المميز لإعادة التحميل. إذا كان الخادم يوفّر رمز الدخول نفسه، سيتعذّر تنفيذ التجربة. |
| تحقّق مما إذا كان رمز الدخول المنتهية الصلاحية لا يزال صالحًا. | سيتم عرض وقت انتهاء صلاحية رمز الدخول. |
| تحقق مما إذا كان قد تم تدوير الرمز المميز للتحديث أثناء إعادة التحميل. | نتحقق مما إذا كان قد تم تغيير الرموز المميزة للتحديث بعد طلب الرمز المميز للتحديث. في حال تغيير الرمز المميز لإعادة التحميل، يجب على الخادم إلغاء صلاحية الرمز المميز للتحديث القديم فقط بعد استخدام رمز إعادة تحميل جديد، وذلك لمنع حالات السباق التي قد تؤدي إلى إيقاف ربط حساب المستخدم. سيخفق الاختبار في حالة إلغاء صلاحية الرمز المميز لإعادة التحميل القديم قبل استخدام الرمز الجديد. |
رسائل الخطأ
يسرد الجدول التالي بعض رسائل الخطأ الشائعة التي قد تواجهها، والطريقة المقترحة لحلها.
| رسالة الخطأ | كيفية الحل |
|---|---|
| لم يتم استخدام واجهة برمجة التطبيقات HomeGraph في المشروع <_id_> من قبل أو تم تعطيلها | تأكد من تمكين HomeGraph API. |
| لم يتم العثور على الكيان المطلوب | تحقّق من أنّ agentUserId صالح ومرتبط بخدمتك. |
تأكَّد من حصولك على إذن خطأ في الحصول على بيانات الوحدة: خطأ getModuleData: استجابة تعذّر Http لـ https://hometestsuiteproxy-pa.googleapis.com/v1/module:get: 403 OK 403 |
|
إرسال نتائج الاختبار
يجب أن تجتاز نتائج Test Suite نتائج 100% من الاختبارات قبل إرسال نموذج الاعتماد. إذا كانت لديك أي سمات تتطلّب الاختبار اليدوي، يجب الاستمرار في تشغيل أداة Test Suite وإرفاق النتيجة حتى لو لم تنجح في اختبار 100%.
لإرسال نتائج الاختبار والإقرار بالإجراء المنزلي الذكي، يُرجى اتّباع الخطوات التالية:
- بعد أن تتلقّى نتائج اختبارك واستعدادك للمصادقة على الإجراء المنزلي الذكي، انقر على إرسال في أداة Test Suite.
- انقر على الزر تنزيل نتائج الاختبار لاسترداد نتائج الاختبار.
- انقر على الانتقال إلى نموذج الإرسال لإرسال نتائج الاختبار إلى Google.
املأ جميع الحقول المطلوبة، ثم انقر على إرسال.