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

الربط بين الخدمات السحابية    حزمة تطوير برامج المنزل المحلية

Google Home Test Suite هو تطبيق ويب يتيح لك إجراء اختبار ذاتي لإجراء منزلك الذكي. Test Suite تنشئ هذه الميزة تلقائيًا حالات اختبار وتنفّذها استنادًا إلى الأجهزة والسمات المرتبطة بحسابك. عند إكمال الاختبارات، يمكنك الاطّلاع على النتائج.

لاستخدام Test Suite وإرسال نتائج الاختبارات إلى Google للحصول على شهادة اعتماد، يُرجى الاطّلاع على صفحة اختبار إجراءات المنزل الذكي ومشاركتها للحصول على معلومات. هذا الإصدار من Test Suite مخصّص لعمليات التطوير وضمان الجودة.

تشمل الاختبارات التي ينفّذها Test Suite، على سبيل المثال لا الحصر، ما يلي:

  • تتحقّق هذه السمة من تنفيذ حالة التقرير ومزامنة الطلب على أجهزتك وسماتك.

  • تتحقّق هذه السمة من تنفيذ الغرض QUERY على جهازك ومن تطابق نتائجه مع نتائج Report State.

يمكنك تشغيل أداة Test Suite من خلال النقر على الزر أدناه:

تشغيل Test Suite

اختبار تطبيقك بنفسك

يوضّح القسم التالي كيفية تشغيل Test Suite على جهازك ومشروع "إجراءات المنزل الذكي". يتطلّب Test Suite تسجيل الدخول حتى يتمكّن من فحص الأجهزة في Google Home Graph وإرسال الأوامر مباشرةً إلى Google Assistant.

لاختبار تطبيقك بنفسك، اتّبِع الخطوات التالية:

  1. في متصفّح الويب، افتح Test Suite.

  2. سجِّل الدخول إلى Google باستخدام الزر في أعلى يسار الصفحة.

  3. اضبط تفاصيل المشروع:

    1. في حقل رقم تعريف المشروع، أدخِل معرّف المشروع الخاص بـ Smart Home Action.
    2. انقر على التالي.

  4. ضبط إعدادات الاختبار:

    1. في حال اعتماد عملية دمج Cloud-to-cloud، لا تغيِّر القيمة التلقائية حالة التقرير/مهلة مزامنة الطلب. ومع ذلك، لأغراض الاختبار، يمكنك تغيير قيمة المهلة إذا كان وكيلك يستغرق وقتًا أطول لإرسال الحالة إلى Home Graph.

    2. في حال اعتماد عملية الدمج مع Cloud-to-cloud، تأكَّد من تفعيل الخيار مزامنة طلب الاختبار. أثناء الاختبار، سيُطلب منك إضافة جهاز أو تعديله أو إزالته، والتحقّق مما إذا كانت قائمة الأجهزة قد تغيّرت في Home Graph. تحدث إجراءات التغيير من خلال عملية الدمج التي تختبرها. يجب أن يتضمّن تطبيقك المتكامل الذي يتم اختباره جهازًا واحدًا على الأقل مرتبطًا بمستخدم الوكيل.

    3. إذا كنت تستخدم سمة Scene، اختَر اختبار سمة المشهد.

    4. إذا كنت بصدد تشغيل مجموعة الاختبارات للأجهزة التي تستخدم ميزة "المنزل الذكي"، اختَر متوافق مع حزمة تطوير البرامج (SDK) المحلية للمنزل.

      1. اختَر التنفيذ المحلي أو الإعداد السلس.
      2. انقر على Supports Local Query إذا كان الجهاز يمكنه التعامل مع الغرض QUERY محليًا.

  5. إجراء تشغيل تجريبي وعرض النتائج:

    1. انقر على التالي لبدء إجراء الاختبارات. تعرض الواجهة الأجهزة والسمات التي يتم اختبارها.

  6. اطّلِع على صفحة النتائج والإرسال:

    1. بعد اكتمال الاختبارات، انقر على التالي لعرض النتائج.

تتضمّن نتائج الاختبار عدد الاختبارات التي تم اجتيازها وتلك التي لم يتم اجتيازها، بالإضافة إلى نتيجة نهائية تشير إلى النسبة المئوية للاجتياز.

اختبار التحقّق من صحة ربط الحساب

تؤدي ميزة ربط الحساب دورًا مهمًا في منظومة Google المتكاملة للمنزل الذكي. يتحقّق اختبار التحقّق من صحة ربط الحسابات في Test Suite من خدمة OAuth بحثًا عن أي مشاكل محتملة.

يتضمّن اختبار التحقّق من ربط الحساب اختبارات للتحقّق من صحة رموز الدخول ورموز إعادة التحميل:

اختبار التحقّق من صحة رمز الدخول

يتم اختبار رموز الدخول المميزة التي يتم عرضها من نقطة نهاية تبادل الرموز المميزة للتأكّد من أنّها بالتنسيق الصحيح ويتم عرضها مع رمز مميز صالح لإعادة التحميل.

عناصر الاختبار الشرح
التحقّق ممّا إذا كان رمز الدخول بتنسيق JWT لا ينصح ربط حساب Google باستخدام رموز الدخول بتنسيق JSON Web Token. في حال العثور على تنسيق 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 Bad Request مع {"error": "invalid_grant"} عند تلقّي طلب غير صالح للحصول على رمز مميّز لإعادة التحميل. إذا لم تتطابق الاستجابة مع "رمز الخطأ أو الرسالة"، ستفشل حالة الاختبار هذه. انتقِل إلى استبدال رموز إعادة التحميل برموز الوصول للحصول على مزيد من المعلومات.
اختبِر ما إذا تم تعديل رمز الدخول المميز بعد إعادة تحميل الرمز المميز. يجب عرض رموز الدخول المميزة الجديدة استجابةً لطلبات إعادة تحميل الرمز المميز. إذا كان الخادم يوفّر رمز الدخول نفسه، ستتعذّر حالة الاختبار.
تحقَّق مما إذا كان رمز الدخول غير المنتهي الصلاحية لا يزال صالحًا. سيتم عرض وقت انتهاء صلاحية رمز الدخول.
تحقَّق ممّا إذا تم تغيير الرمز المميز لإعادة التحميل أثناء إعادة التحميل. نتحقّق مما إذا تم تغيير رموز الدخول المميزة بعد طلب رمز دخول مميز جديد. في حال تغيّر رمز التحديث، يجب أن يبطل خادمك صلاحية رمز التحديث القديم بعد استخدام رمز تحديث جديد فقط، وذلك لمنع حدوث حالات تعارض قد تؤدي إلى إيقاف ربط حساب المستخدم. سيفشل الاختبار إذا أبطلت الرمز المميز القديم لإعادة التحميل قبل استخدام الرمز الجديد.

رسائل الخطأ

يسرد الجدول التالي بعض رسائل الخطأ الشائعة التي قد تظهر لك والطريقة المقترَحة لحلّها.

رسالة الخطأ كيفية حلّ المشكلة
لم يتم استخدام HomeGraph API في المشروع <_id_> من قبل أو تم إيقافه تأكَّد من تفعيل HomeGraph API.
لم يتم العثور على الكيان المطلوب تأكَّد من أنّ agentUserId صالح ومرتبط بخدمتك.

تأكَّد من حصولك على إذن resourcemanager.projects.get في المشروع ${your project id} ومن منح جميع الأذونات في شاشة الموافقة.

Error getting module data: getModuleData error: Http failure response for https://hometestsuiteproxy-pa.googleapis.com/v1/module:get: 403 OK 403
  1. اتّبِع التعليمات الواردة في تحديد المشاكل وحلّها المتعلّقة بأذونات إدارة الهوية وإمكانية الوصول للتأكّد من أنّ حسابك لديه أذونات resourcemanager.projects.get للمشروع.
  2. انتقِل إلى صفحة التطبيقات التي يمكنها الوصول إلى حسابك للتحقّق من الأذونات التالية الخاصة بـ "مجموعة الاختبارات للمنزل الذكي":
    • معلومات الحساب الأساسية
      1. الاطّلاع على عنوان البريد الإلكتروني الرئيسي لحسابك على Google
      2. الاطّلاع على بياناتك الشخصية، بما في ذلك أيّ بيانات شخصية اخترت السماح للجميع بالاطلاع عليها
    • إذن الوصول الإضافي
      1. استخدام Assistant: إمكانية وصول واسع النطاق إلى حسابك على Google
      2. التحقّق من الأجهزة المنزلية الذكية والتحكّم فيها في قاعدة البيانات Home Graph
    إذا ظهرت لك رسالة خطأ بشأن الأذونات، عليك أولاً إزالة إذن الوصول ثم منح جميع الأذونات في شاشة الموافقة عند تسجيل الدخول مرة أخرى.

إرسال نتائج الاختبار

يجب أن تجتاز نتائج Test Suite% 100 من الاختبارات قبل إرسالها للحصول على الشهادة. إذا كانت لديك أي سمات تتطلّب اختبارًا يدويًا، عليك تشغيل أداة Test Suite وإرفاق النتيجة حتى إذا لم يتم اجتياز الاختبار بنسبة %100.

لإرسال نتائج الاختبار واعتماد عملية الدمج Cloud-to-cloud الخاصة بك، اتّبِع الخطوات التالية:

  1. بعد تلقّي نتائج الاختبارات والاستعداد لإصدار شهادة اعتماد لعملية الدمج، انقر على إرسال في أداة Test Suite.Cloud-to-cloud
  2. انتقِل إلى Google Home Developer Console > Cloud-to-cloud > إصدار شهادة.
  3. اختَر عملية الدمج التي تريد الحصول على شهادة اعتماد لها.
  4. ضمن المستندات، أدخِل Test Suite معرّف النتائج.

  5. املأ جميع الحقول المطلوبة، ثم انقر على إرسال.