בדיקה וניפוי באגים באפליקציה

מומלץ לפתח את אפליקציית מילוי הבקשות המקומית לפי השלבים שמתוארים למעלה, ואז לבדוק את השילוב של הבית החכם בסביבת האירוח שלכם לפי השלבים הבאים:

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. כדי לפתור בעיות בשילוב, אפשר להשתמש בנקודות עצירה (breakpoint) וביומנים.

4. משנים ומקמפלים את קוד ה-TypeScript, ואז חוזרים על השלבים האלה.

אם תחזרו על תהליך הבנייה והבדיקה הזה, תוכלו לראות את השינויים בפעולה במהירות, וכך לנפות באגים בקוד.

בדיקת השליטה במכשיר

בGoogle Home Developer Console, צריך לציין את כתובת ה-URL של אפליקציית האינטרנט, שמספקת את ה-HTML שנטען במכשיר Google Home או במכשיר Google Nest במהלך הביצוע המקומי.

כדי לבדוק את השליטה במכשיר באמצעות מילוי בקשות מקומי, פועלים לפי השלבים הבאים:

במאמר מכשירים נתמכים מוסבר איך לבדוק באיזו סביבת זמן ריצה המכשיר שלכם משתמש.

ניפוי באגים מ-Chrome

אתם יכולים לנפות באגים באפליקציית המילוי המקומית באמצעות כלי הפיתוח ל-Chrome. לפני שמתחילים בניפוי באגים, חשוב לוודא שהסביבה מוגדרת בצורה נכונה:

• הגדרתם במסוף את כתובת ה-URL לפיתוח לכתובת URL שאפשר להגיע אליה ממכשיר Google Home או ממכשיר Google Nest (ברשת תקשורת מקומית (LAN) או באמצעות האינטרנט).
• המחשב מחובר לאותה רשת תקשורת מקומית (LAN) שאליה מחובר מכשיר 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 שאליו מטורגטות פקודות המילוי המקומי.
• מרעננים את הדף ב<ph name="CHROME_DEVTOOLS">כלי פיתוח ל-Chrome</ph> כדי לטעון מחדש את מאגר האפליקציה של מילוי הבקשות המקומי עם הקוד העדכני מכתובת ה-URL לפיתוח. הפעולה הזו לא מאפסת את פלטפורמת Local Home, וייתכן שיהיה צורך לאפס אותה כדי להפעיל מחדש את ה-intent של הפלטפורמה (כמו IDENTIFY) באפליקציית המילוי המקומית. כדי לאפס את פלטפורמת Local Home, צריך להפעיל מחדש את מכשיר Google Home או Google Nest.
• מוודאים שאפליקציית ה-JavaScript נטענת בלי שגיאות. כדי לעשות את זה, בודקים את הקטע Console בדף DevTools. אם יש בעיה, תופיע הודעה כמו: "Uncaught TypeError: Cannot read property 'open' of null".
• הערך של verificationId מהתשובה של IDENTIFY צריך להתאים לאחד מהערכים של otherDeviceIds מהתשובה של SYNC.
• ב-handler של EXECUTE, ודאו שהמכשיר יכול לקבל את פקודות ה-HTTP, ה-TCP או ה-UDP, ושהן פועלות כצפוי.
• חשוב לוודא שה-handlers מחזירים Promise.
• הימנעו משמירת מצב גלובלי בזיכרון. מחזור החיים של האפליקציה
• שגיאות שמופיעות באפליקציית המילוי המקומית יופיעו ביומני השגיאות של הפרויקט.

הכנה והשקה לסביבת הייצור

כשהפעולה לבית החכם מוכנה להשקה, פועלים לפי השלבים הבאים:

1. פותחים טרמינל. בספריית הפרויקט, מריצים את הפקודה npm run build. הפקודה הזו יוצרת את חבילות ה-JavaScript הבאות לאפליקציה בספרייה dist:

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

2. בדף הגדרה וקביעת תצורה בGoogle Home Developer Console, גוללים אל מילוי מקומי ומפעילים את ההגדרה.
3. באמצעות הלחצנים Upload JavaScript, מעלים את קובצי החבילה שיצרתם קודם.

   

   חשוב להעלות את שתי הגרסאות של קובצי החבילה (Node, ‏ Web) כדי שהפעולה תוגדר לפעול בצורה תקינה בכל סביבות זמן הריצה שנתמכות על ידי מילוי בקשות מקומי.
   1. העלאת קובץ ה-JavaScript שמטרגט את Node.js: מעלים את הקובץ bundle.js מהספרייה dist/node.
   2. העלאת קובץ ה-JavaScript שמטרגט את Chrome (דפדפן): מעלים את הקובץ bundle.js מהספרייה dist/web.
4. בודקים את הפעולה במכשיר עם Assistant מובנית כדי לוודא שהיא פועלת כמו שצריך בסביבת ייצור. מידע נוסף זמין במאמר בדיקה ושיתוף של פעולת הבית החכם.
5. כשהפעולה פועלת כמו שצריך, שולחים אותה ל-Google לפריסה בסביבת הייצור לפי ההוראות במאמר השקת פעולה לבית חכם. זה כולל את השלבים של הבדיקה העצמית והבקשה לאישור.