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

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

  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 الذي يعرض ملف HTML الذي يشغِّل تطبيقك المخصّص للأجهزة الجوّالة.
  4. انقر على حفظ. قد يستغرق الأمر ما يصل إلى 30 دقيقة لكي تتمكّن Google من نشر التغييرات التي أجريتها في وحدة التحكّم.
  5. أعِد تشغيل جهاز Google Home أو Google Nest التجريبي.
  6. أدخِل أمرًا على جهازك الذكي. على سبيل المثال، إذا كان جهازك ينفِّذ السمة OnOff، يمكنك قول "Ok Google، أريد إضاءة المصابيح".

Node.js

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

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

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

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

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

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

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

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

  • لا تربط عدة أجهزة 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. في وحدة التحكّم، حمِّل تطبيق 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 لطرحه في الإصدار العلني باتّباع التعليمات الواردة في مقالة إطلاق إجراء المنزل الذكي. ويشمل ذلك إكمال خطوات الاختبار الذاتي وطلب الحصول على شهادة الاعتماد.
السابق
تنفيذ تطبيق توصيل الطلبات المحلي