اختبار تطبيقك وتصحيح أخطائه

ننصحك بإنشاء تطبيق لتوصيل الطلبات في المتجر باتّباع الخطوات الموضّحة. ثم اختبار دمج المنزل المزوّد بأجهزة ذكية على بيئة الاستضافة الخاصة بك باتّباع الخطوات التالية:

  1. في بيئة الاستضافة الخاصة بك، اعرض صفحة HTML التي تشغّل تطبيق محلي لتوصيل الطلبات. يوضح المقتطف التالي مثالاً لملف HTML ثابت يدير تطبيق توصيل الطلبات المحلي

    <html>
  <head>
    <!-- Local Home SDK -->
    <script src="//www.gstatic.com/eureka/smarthome/smarthome_sdk.js"></script>
    <!-- Local app under development -->
    <script src="local_execution.js"></script>
  </head>

</html>

  2. اختبار التحكّم في الأجهزة:

  3. تصحيح الأخطاء من Chrome: استخدِم نقاط الإيقاف والسجلات من أجل وحلّ المشاكل في عملية الدمج.

  4. عدِّل رمز TypeScript واجمعه، ثم كرِّر هذه الخطوات.

من خلال تكرار عملية الإنشاء والاختبار هذه، يمكنك مشاهدة التغييرات أثناء التنفيذ اكتشاف المشكلات في التعليمات البرمجية وتصحيحها بسرعة وسهولة أكبر.

اختبار التحكّم في الجهاز

في "وحدة تحكُّم المهام"، عليك تحديد عنوان URL لتطبيق الويب، وهو يعرض رمز HTML الذي يتم تحميله على جهاز Google Home أو جهاز Google Nest أثناء توفيره على الجهاز.

لاختبار التحكّم في الجهاز من خلال طريقة توفّر المركبة، يُرجى اتّباع الخطوات التالية:

Chrome

  1. افتح مشروع المنزل المزوّد بأجهزة ذكية في وحدة تحكّم المهام.
  2. في شريط التنقّل الأيمن، انقر على الإجراءات.
  3. ضِمن ضبط حزمة تطوير البرامج (SDK) للمنزل المحلي (اختياري) > إدخال عنوان URL للاختبار في Chrome، وتحديد خادم التطوير عنوان URL الذي يعرض رمز HTML الذي يدير تطبيق التنفيذ المحلي
  4. انقر على حفظ. قد تستغرق Google ما يصل إلى 30 دقيقة نشر تغييرات وحدة التحكم الخاصة بك.
  5. يُرجى إعادة تشغيل جهاز Google Home أو Google Nest التجريبي.
  6. وجِّه طلبًا إلى جهازك الذكي. على سبيل المثال، إذا كان جهازك لتنفيذ سمة OnOff، يمكنك قول "Ok Google، أريد إضاءة المصابيح".

Node.js

  1. افتح مشروع المنزل المزوّد بأجهزة ذكية في وحدة تحكّم المهام.
  2. في شريط التنقّل الأيمن، انقر على الإجراءات.
  3. ضِمن ضبط حزمة تطوير البرامج (SDK) للمنزل المحلي (اختياري) > أدخِل عنوان URL لاختبار Node، ثم حدِّد خادم التطوير عنوان URL يعرض رمز JavaScript الذي يدير تطبيق توصيل الطلبات المحلي
  4. انقر على حفظ. قد تستغرق Google ما يصل إلى 30 دقيقة نشر تغييرات وحدة التحكم الخاصة بك.
  5. يُرجى إعادة تشغيل جهاز Google Home أو Google Nest التجريبي.
  6. وجِّه طلبًا إلى جهازك الذكي. على سبيل المثال، إذا كان جهازك لتنفيذ سمة OnOff، يمكنك قول "Ok Google، أريد إضاءة المصابيح".

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

تصحيح الأخطاء من Chrome

يمكنك تصحيح الأخطاء في تطبيق توصيل الطلبات المحلي باستخدام Chrome. أدوات مطوري البرامج: قبل أن تتمكن من تصحيح الأخطاء، تأكَّد من أنّه تم إعداد بيئتك بشكل صحيح:

  • ضبطت عنوان URL للتطوير في وحدة التحكم على عنوان URL يمكن الوصول إليه عن طريق جهاز Google Home أو Google Nest (إما على شبكة المنطقة المحلية أو على الإنترنت)
  • جهازك متصل بالشبكة المحلية نفسها المتصل بها جهاز Google Home أو Google Nest الذي تختبره
  • لا تحظر شبكتك الحِزم بين الأجهزة.
  • سجلت الدخول باستخدام حساب Google نفسه في وحدة تحكم المهام على جهاز Google Home أو Google Nest.
  • لقد عدّلت استجابة SYNC في السحابة الإلكترونية والتوصيل. يجب أن تعرض القيمة الصالحة واحدة على الأقل في الحقل otherDeviceIds.
  • إدخال الإعداد الصحيح للفحص المعلومات في وحدة تحكّم المهام.

لربط تطبيق التنفيذ المحلي ببرنامج تصحيح الأخطاء في "أدوات مطوري البرامج في Chrome"، يُرجى اتّباع الخطوات التالية: اتبع هذه الخطوات:

Chrome

  1. في جهاز التطوير المحلي، يمكنك تثبيت متصفّح Google Chrome
  2. في حقل عنوان متصفِّح Chrome، تشغيل "أداة فحص Chrome" من خلال إدخال: chrome://inspect#devices. من المفترض أن تظهر لك قائمة بالأجهزة على الصفحة، ويجب إدراج ملف HTML تحت اسم اختبار جهاز Google Home أو Google Nest
  3. انقر على رابط الفحص الأزرق ضمن HTML لتشغيل "أدوات مطوري البرامج في Chrome". انتقِل إلى علامة التبويب وحدة التحكّم. تُخرج منصة الصفحة الرئيسية المحلية إصدار تطبيقك وحزمة تطوير البرامج (SDK) للمنزل المحلي. الإصدار في سجل وحدة التحكم. في حال ظهور السجلّ، يعني ذلك أنّ Google تم تحميل تطبيقك بنجاح ويستطيع الاتصال به. وإذا لم يتم تنشيطها، أعِد تشغيل جهاز Google Home أو Google Nest.
    4. الشكل 1: تطبيق توصيل الطلبات على الجهاز في chrome://inspect.

Node.js

  1. في جهاز التطوير المحلي، يمكنك تثبيت متصفّح Google Chrome
  2. حدِّد عنوان IP المحلي لجهاز الاختبار.
  3. في حقل عنوان متصفِّح Chrome، تشغيل "أداة فحص Chrome" من خلال إدخال: chrome://inspect#devices.
  4. اختَر ضبط... لفتح إعدادات ميزة "اكتشاف الاستهداف".
    5. الشكل 2: إعدادات الاكتشاف المستهدَف في chrome://inspect.
  5. أدخِل DEVICE_IP_ADDRESS:9222 في القائمة انقر على تم.
  6. انقر على رابط الفحص الأزرق ضمن النص البرمجي لتشغيل "أدوات مطوري البرامج في Chrome". انتقِل إلى علامة التبويب وحدة التحكّم. تُخرج منصة الصفحة الرئيسية المحلية إصدار تطبيقك وحزمة تطوير البرامج (SDK) للمنزل المحلي. الإصدار في سجل وحدة التحكم. في حال ظهور السجلّ، يعني ذلك أنّ Google تم تحميل تطبيقك بنجاح ويستطيع الاتصال به. وإذا لم يتم تنشيطها، أعِد تشغيل جهاز Google Home أو Google Nest.

لمعرفة المزيد من التفاصيل حول بيئة التشغيل التي يستخدمها جهازك، يمكنك الاطّلاع على قسم التوافق الأجهزة:

نصائح تصحيح الأخطاء

في ما يلي بعض النقاط الإضافية التي يجب مراعاتها أثناء تصحيح الأخطاء:

  • لا تربط عدة أجهزة Google Home أو Google Nest بحسابك التجريبي على جهاز واحد. شبكة محلية. لن تتمكّن من التحكّم في استهداف جهاز Google Home أو Google Nest. باستخدام أوامر التنفيذ المحلية.
  • يُرجى إعادة تحميل الصفحة في "أدوات مطوري البرامج في Chrome" لإعادة تحميل حاوية تطبيق توصيل الطلبات على الجهاز. باستخدام أحدث رمز من عنوان URL الخاص بالتطوير. ولا يؤدي ذلك إلى إعادة ضبط منصة الصفحة الرئيسية المحلية، التي قد تكون ضرورية لإعادة تفعيل الأهداف على المنصة (مثل IDENTIFY) في تطبيق توصيل الطلبات المحلي. لإعادة ضبط منصّة الصفحة الرئيسية المحلية، إعادة تشغيل جهاز Google Home أو Google Nest
  • تحقَّق من أنّه يتم تحميل تطبيق JavaScript بدون أخطاء. للقيام بذلك، حدد قسم وحدة التحكم بصفحة أدوات مطوري البرامج. إذا كانت هناك مشكلة، فسيظهر لك رسالة مثل هذه: Uncaught TypeError: Cannot read property ‘open’ of null.
  • يجب أن تتطابق السمة verificationId من استجابة IDENTIFY مع إحدى القيمتَين التاليتَين: otherDeviceIds من رد SYNC.
  • بالنسبة إلى معالج EXECUTE، تأكَّد من إمكانية تنفيذ أوامر HTTP أو TCP أو UDP التي تلقاها جهازك وتعمل على النحو المتوقع.
  • تأكَّد من عرض Promise من المعالِجات.
  • تجنب الاحتفاظ بالحالة العامة في الذاكرة. راجِع مراحل نشاط التطبيقات.
  • ستظهر في مشروعك الأخطاء التي يطرحها تطبيق توصيل الطلبات المحلي. .

الاستعداد وإطلاق التطبيق لمرحلة الإنتاج

عندما تكون مستعدًا لإطلاق مهمة منزلك المزوّد بأجهزة ذكية، اتّبِع الخطوات التالية:

  1. افتح نافذة طرفية. في دليل مشروعك، شغِّل الأمر npm run build. ينشئ هذا الأمر حِزم JavaScript التالية لتطبيقك ضِمن دليل dist: 
    project-directory/
└── dist
 ├── web
 │    └── bundle.js
 └── node
      └── bundle.js
  2. في وحدة التحكّم، حمِّل تطبيق JavaScript من خلال النقر على تطوير >. الإجراءات: في قسم إعداد حزمة تطوير البرامج (SDK) للمنزل المحلي، انقر على تحميل. ملفات JavaScript.
    الشكل 3: حمِّل تطبيق JavaScript.
  3. في مربع الحوار تحميل ملفات، حمِّل ملفات الحِزم التي سبق لك إرسالها. التي تم إنشاؤها. تأكَّد من تحميل كلا الإصدارَين من ملفات الحزمة (Node وWeb) لكي يتم ضبط الإجراء الخاص بك ليعمل بشكل سليم في جميع أوقات التشغيل البيئات التي تتوافق معها عملية التنفيذ المحلية.
    1. تحميل استهداف JavaScript Node.js: حمِّل bundle.js من دليل dist/node.
    2. تحميل JavaScript الذي يستهدف Chrome (المتصفح): حمِّل bundle.js من الدليل dist/web.
  4. اختبار الإجراء على جهاز مزوّد بخدمة "مساعد Google" للتحقّق من عمله كما هو متوقع في بيئة إنتاج. لمزيد من المعلومات، يُرجى مراجعة اختبار إجراءات المنزل المزوّد بأجهزة ذكية ومشاركتها
  5. عندما تكون راضيًا عن آلية عمل الإجراء، يمكنك إرساله إلى Google. النشر عبر اتباع التعليمات الواردة في إطلاق المهام المنزلية الذكية هذا النمط إكمال خطوات الاختبار الذاتي وطلب الحصول على الشهادة.
السابق
تنفيذ تطبيق توصيل الطلبات المحلي