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

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

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 وجمِّعه، ثم كرِّر هذه الخطوات.

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

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

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

لاختبار التحكّم في الجهاز باستخدام ميزة "التنفيذ المحلي"، اتّبِع الخطوات التالية:

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

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

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

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

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

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

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

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

• لا تربط عدة أجهزة Google Home أو جهاز Google Nest بحسابك التجريبي على الشبكة المحلية نفسها. لن تتمكّن من اختيار جهاز Google Home أو جهاز Google Nest الذي تريد استهدافه باستخدام أوامر التنفيذ المحلي.
• أعِد تحميل الصفحة في "أدوات مطوّري برامج Chrome" لإعادة تحميل حاوية تطبيق التنفيذ المحلي باستخدام أحدث رمز من عنوان URL الخاص بالتطوير. لا يؤدي هذا الإجراء إلى إعادة ضبط منصة Local Home، وقد يكون ذلك ضروريًا لإعادة تفعيل طلبات المنصة (مثل IDENTIFY) في تطبيق تنفيذ الطلب المحلي. لإعادة ضبط منصة Local Home، يجب إعادة تشغيل جهاز 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. في صفحة الإعداد والضبط ضمن Google Home Developer Console، انتقِل إلى التنفيذ المحلي وفعِّل الإعداد.
3. باستخدام أزرار تحميل JavaScript، حمِّل ملفات الحِزم التي أنشأتها سابقًا.

   

   تأكَّد من تحميل كلا الإصدارَين من ملفات الحزمة (Node وWeb) لضبط الإجراء ليعمل بشكل صحيح في جميع بيئات التشغيل التي تتيح ميزة "التنفيذ المحلي".
   1. حمِّل ملف JavaScript الذي يستهدف Node.js: حمِّل ملف bundle.js من دليل dist/node.
   2. تحميل ملف JavaScript الذي يستهدف Chrome (المتصفّح): حمِّل ملف bundle.js من دليل dist/web.
4. اختبِر الإجراء على جهاز مزوّد بخدمة "مساعد Google" للتأكّد من أنّه يعمل على النحو المتوقّع في بيئة التشغيل الفعلي. مزيد من المعلومات حول اختبار إجراءات المنزل المزوّد بأجهزة ذكية ومشاركتها
5. عندما تكون راضيًا عن طريقة عمل الإجراء، أرسِله إلى Google لنشره في مرحلة الإنتاج باتّباع التعليمات الواردة في مقالة إطلاق إجراء المنزل المزوّد بأجهزة ذكية. ويشمل ذلك إكمال خطوات الاختبار الذاتي وطلب الحصول على شهادة الاعتماد.