آزمایش و اشکال‌زدایی برنامه

توصیه می‌کنیم برنامه اجرای محلی‌تان را بااستفاده از مراحل شرح‌داده‌شده در بالا بسازید، سپس ادغام خانه هوشمندتان را در محیط میزبانی خودتان بااستفاده از مراحل زیر آزمایش کنید:

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، باید نشانی وب برنامه وب خود را مشخص کنید که HTML بارشده در دستگاه Google Home یا Google Nest را درطول اجرای محلی ارائه می‌دهد.

برای آزمایش کنترل دستگاه با اجرای محلی، این مراحل را دنبال کنید:

برای جزئیات بیشتر درباره اینکه دستگاهتان از کدام زمان اجرا استفاده می‌کند، به دستگاه‌های پشتیبانی‌شده مراجعه کنید.

اشکال‌زدایی از Chrome

می‌توانید برنامه اجرای محلی‌تان را بااستفاده از Chrome DevTools اشکال‌زدایی کنید. قبل‌از اشکال‌زدایی، مطمئن شوید که محیط شما به‌درستی راه‌اندازی شده است:

• نشانی وب توسعه را در کنسول روی نشانی وبی تنظیم کرده‌اید که برای دستگاه Google Home یا Google Nest قابل‌دسترسی است (چه در شبکه محلی یا بااستفاده از اینترنت)،
• رایانه‌تان به همان شبکه محلی متصل است که دستگاه Google Home یا Google Nest که درحال آزمایش آن هستید به آن متصل است.
• شبکه شما بسته‌ها را بین دستگاه‌ها مسدود نمی‌کند.
• با همان «حساب Google» در Google Home Developer Console و دستگاه Google Home یا Google Nest به سیستم وارد شده باشید.
• پاسخ همگام‌سازی را در اجرای ابری خود به‌روز کرده‌اید. باید حداقل یک مقدار معتبر در فیلد otherDeviceIds برگرداند.
• اطلاعات پیکربندی اسکن صحیح را در Google Home Developer Console وارد کرده‌اید.

برای متصل کردن برنامه اجرای محلی به اشکال‌زدای Chrome DevTools، این مراحل را دنبال کنید:

برای جزئیات بیشتر درباره اینکه دستگاهتان از کدام زمان اجرا استفاده می‌کند، به دستگاه‌های پشتیبانی‌شده مراجعه کنید.

نکته‌های اشکال‌زدایی

برخی‌از موارد دیگری که باید درطول اشکال‌زدایی درنظر داشته باشید عبارتند از:

• چند دستگاه Google Home یا Google Nest را به حساب آزمایشی‌تان در یک شبکه محلی پیوند ندهید. نمی‌توانید کنترل کنید که کدام دستگاه Google Home یا Google Nest با فرمان‌های اجرای محلی هدف قرار گیرد.
• صفحه را در Chrome DevTools بازآورید تا محفظه برنامه اجرای محلی‌تان با جدیدترین کد از نشانی وب توسعه‌تان مجدداً بار شود. این کار پلاتفرم Local Home را بازنشانی نمی‌کند، که ممکن است برای راه‌اندازی مجدد هدف‌های پلاتفرم (مانند IDENTIFY) در برنامه اجرای محلی شما ضروری باشد. برای بازنشانی پلاتفرم Local Home، دستگاه Google Home یا Google Nest خود را بازراه‌اندازی کنید.
• بررسی کنید که برنامه جاوا اسکریپت شما بدون خطا بارگیری شود. برای انجام این کار، بخش کنسول صفحه DevTools را بررسی کنید. اگر مشکلی وجود داشته باشد، پیامی مانند این خواهید دید: «Uncaught TypeError: Cannot read property 'open' of null.»
• verificationId از پاسخ IDENTIFY باید با یکی از otherDeviceIds از پاسخ SYNC مطابقت داشته باشد.
• برای گرداننده EXECUTE، مطمئن شوید دستگاهتان می‌تواند فرمان‌های HTTP،‏ TCP، یا UDP را دریافت کند و طبق انتظار کار کند.
• حتماً Promise را از گرداننده‌ها برگردانید.
• از حفظ وضعیت سراسری در حافظه خودداری کنید. چرخه حیات برنامه را ببینید.
• خطاهای ایجادشده توسط برنامه اجرای محلی شما در گزارش‌های خطای پروژه شما نشان داده خواهد شد.

آماده‌سازی و راه‌اندازی برای تولید

وقتی برای راه‌اندازی «کنش» خانه هوشمندتان آماده بودید، این مراحل را دنبال کنید:

1. پایانه‌ای را باز کنید. در فهرست راهنمای پروژه، فرمان npm run build را اجرا کنید. این فرمان دسته‌های جاوا اسکریپت زیر را برای برنامه‌تان در دایرکتوری dist تولید می‌کند:

   project-directory/
   └── dist
    ├── web
    │    └── bundle.js
    └── node
         └── bundle.js
   

2. در صفحه راه‌اندازی و پیکربندی Google Home Developer Console، به تحقق محلی پیمایش کنید و تنظیم را روشن کنید.
3. بااستفاده از دکمه‌های بارگذاری جاوا اسکریپت، فایل‌های دسته‌ای را که قبلاً تولید کرده‌اید بارگذاری کنید.

   

   حتماً هر دو نسخه فایل‌های بسته (Node، وب) را بارگذاری کنید تا «کنش» شما برای عملکرد صحیح در همه محیط‌های زمان اجرا که اجرای محلی پشتیبانی می‌کند پیکربندی شود.
   1. بارگذاری Node.js هدف‌گذاری جاوا اسکریپت: فایل bundle.js را از فهرست راهنمای dist/node بارگذاری کنید.
   2. جاوا اسکریپت خود را که Chrome (مرورگر) را هدف قرار می‌دهد بارگذاری کنید: فایل bundle.js را از دایرکتوری dist/web بارگذاری کنید.
4. «کنش» خود را در دستگاهی که «دستیار» در آن فعال است آزمایش کنید تا مطمئن شوید که در محیط تولید طبق انتظار عمل می‌کند. برای کسب اطلاعات بیشتر، آزمایش و هم‌رسانی «کنش خانه هوشمند» را ببینید.
5. وقتی از نحوه عملکرد «کنش» خود راضی بودید، آن را برای استقرار تولید به Google ارسال کنید. برای این کار، دستورالعمل‌های موجود در راه‌اندازی کنش خانه هوشمند را دنبال کنید. این شامل تکمیل مراحل خودآزمایی و درخواست گواهینامه است.