תוסף Google Home לקוד VS

Matter    Cloud-to-cloud    Local Home SDK

‫Google Home Extension for Visual Studio Code מיועד למפתחים ב-Google Home Platform. התוסף הזה נותן לכם גישה אל Google Assistant Simulator, Google Cloud Logging, Home Graph Viewer וכלים אחרים כדי לפשט את תהליך הפיתוח של Matter ושל הבית החכם.

התכונות של תוסף Google Home

סימולטור של Google Assistant

כדי לבדוק אם המכשירים לבית החכם פועלים כמו שצריך עם הסביבה של Google Home, אתם יכולים לתקשר עם Assistant Simulator בכל שלב בלי לצאת מ-VS Code.

Assistant Simulator מאפשרת לכם לשלוט בקלות במכשירים שלכם על ידי הקלדת השאילתות, לדוגמה, "Turn on the light". בתוך VS Code, ‏Assistant Simulator מגיב בהודעות טקסט על סמך הפקודות שלכם, לדוגמה, "בסדר, אני מדליק את האור". פרטים נוספים זמינים במאמר שימוש בסימולטור של Google Assistant.

אמירות באצווה

כדי לבדוק את השילוב של Google Home כמו אוטומט, אתם יכולים לשלוח קבוצות של ביטויים לסימולטור של Google Assistant על ידי הפעלת סקריפט של ביטויים. פרטים נוספים זמינים במאמר הפעלת ביטויים באצווה.

כלי רישום ביומן של Matter

כלי הרישום ביומן של Matter יכולים לאסוף את כל היומנים שקשורים לניפוי באגים ב-Matter, כולל היומנים של Google Home app (GHA) והיומנים של Google Play Services ‏(GMS Core). אפשר לראות את היומנים ב-VS Code באמצעות חיפושים לפי מסננים ומילות מפתח. אפשר להוריד את היומנים עם מידע נוסף על תוצאות ניפוי הבאגים, כמו Android וגרסת האפליקציה, ולשלוח אותם ל-Google כדי לדווח על בעיות.

Cloud Logging

‫Cloud Logging מספק מידע על תוצאות ניפוי הבאגים ומדדים מרכזיים כדי לתת לכם תובנות לגבי השימוש ב-Action. כדי לפשט את הפיתוח, ב-Google Home Extension מוצגות הודעות של Google Cloud Logging בזמן אמת, ממש ליד הקוד, במהלך פתרון הבעיות. פרטים נוספים זמינים במאמר הצגת Cloud Logging.

Home Graph Viewer

Home Graph Viewer זמין עכשיו ישירות ב-Google Home Extension, כדי שתוכלו לאמת את מצב המכשיר ב-Home Graph בתוך VS Code. פרטים נוספים זמינים במאמר הצגת Home Graph והרצת בדיקות.

התקנת התוסף של Google Home ל-VS Code

כדי להתקין את Google Home Extension, פועלים לפי השלבים הבאים ב-VS Code:

1. לוחצים על הסמל Extensions ב-Activity Bar.

2. מחפשים את google home ולוחצים על התקנה.

   

אפשר גם להוריד את Google Home Extension ישירות מ-VS Code Marketplace.

הורדה של Google Home Extension

הגדרת התוסף של Google Home ל-VS Code

אחרי שמתקינים את Google Home Extension וטוענים מחדש את VS Code, צריך להיכנס ולבחור פרויקט כדי להשתמש ב-Assistant Simulator ולראות את Cloud Logging.

נכנסים באמצעות חשבון Google ובוחרים פרויקט בענן

אתם יכולים להיכנס לחשבון הפיתוח שלכם מ-Google Home Extension, ולתת ל-VS Code הרשאה לתקשר עם שירותי Google בשמכם.

1. לוחצים על הסמל של Google Home בסרגל הפעילות כדי לפתוח את Google Home Extension.

   

2. לוחצים על כניסה באמצעות חשבון Google כדי לפתוח את תצוגת ההתחברות בדפדפן.

   

3. בוחרים את החשבון שמקושר למכשירים לבית החכם.

4. בדף ההרשאה כניסה באמצעות חשבון Google, לוחצים על אישור.

5. תיפתח כרטיסייה בדפדפן ותופיע תיבת הדו-שיח Open Visual Studio Code. כדי להמשיך, לוחצים על Open Visual Studio Code.

   

6. תועברו אל VS Code, שם תתבקשו לתת הרשאה ל-Google Home Extension לפתוח URI. לוחצים על פתיחה כדי לסיים את תהליך ההתחברות.

   

7. אחרי הכניסה, הפרויקטים שלך ייטענו ב-Google Home Extension. בסיום, לוחצים על Select a project.

   

8. בחלון הנפתח Search and select a project שמופיע, בוחרים את הפרויקט לבית החכם.

התקנת הכלי Android Debug Bridge‏ (ADB)

כדי לראות את היומנים של Matter בטלפון Android, צריך להתקין את ADB:

1. מתקינים את ADB במחשב.
2. מפעילים את האפשרויות למפתחים ואת ניפוי הבאגים ב-USB בטלפון Android.

התקנת כלי SoC למכשירים בתקן Matter

כדי לראות את יומני ניפוי הבאגים מ-Matter מכשירים:

1. רוב המערכות על שבב (SoC) של המכשירים ייצאו יציאות טוריות כמו /dev/ttyUSBx ב-Linux או /dev/tty.SLAB_USBtoUART או /dev/tty.usbserial ב-MacOS. הכלי LogViewer יכול לקרוא את היומן ישירות מהמכשיר.
2. יכול להיות שסוגים מסוימים של SoC, כמו NXP או Silicon Labs, ידרשו התקנה של כלים חיצוניים (לדוגמה, JLink). מידע נוסף זמין במאמר מכשירים נתמכים.

שימוש בתוסף Google Home ל-VS Code

למשאבים למפתחים

בקטע עזרה ומשוב, לוחצים על תחילת העבודה ומשאבים כדי לפתוח את הדף משאבים, שבו אפשר למצוא מידע שימושי לפיתוח בסביבה העסקית של Google Home.

שימוש בסימולטור של Google Assistant

כדי לפתוח את Assistant Simulator ב-VS Code, לוחצים על GOOGLE ASSISTANT SIMULATOR בסרגל הצד. בתיבה הודעה, מקלידים את השאילתה ולוחצים על Enter.

אפשר לראות Assistant Simulator תשובות, וללחוץ על הכפתור אחרי השאילתה כדי לשלוח אותה מחדש.

הרצת ביטויים באצווה

מעבירים את העכבר לסרגל התפריטים GOOGLE ASSISTANT SIMULATOR ובוחרים באחת מהאפשרויות הבאות כדי להגדיר סקריפטים:

• לוחצים על file_upload כדי לפתוח תסריטים קיימים של ביטויים.

• לוחצים על file_download כדי לשמור את ההיסטוריה בסקריפט של *.utterance.

  

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

• לוחצים על play_arrow כדי לבחור תסריט של ביטוי מהחלון הנפתח.

• פותחים קובץ *.utterance ישירות ולוחצים על play_arrow.

  

צפייה ב-Cloud Logging

בקטע QUICK ACCESS, לוחצים על Cloud Logs כדי לפתוח את הדף Cloud Logs, שבו נמצאים היומנים ששייכים לפרויקט שבחרתם.

המשתמשים יכולים לסנן את היומנים לפי חומרה וטווח תאריכים.

כברירת מחדל, היומנים מוגבלים ל-50 שורות. כדי לראות עוד יומנים, גוללים לתחתית הדף ולוחצים על עוד.

הצגת Home Graph והרצת בדיקות

בקטע QUICK ACCESS, לוחצים על Home Graph Viewer כדי לפתוח את החלונית Home Graph Viewer, שבה אפשר למצוא מכשירים ששייכים לפרויקט שנבחר. אפשר גם ללחוץ על הפעלת בדיקה כדי להריץ בדיקות במכשיר.

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

אחרי שכל הבדיקות מסתיימות, אתם יכולים לבדוק את פרטי הבדיקה ולראות את היומנים.

שימוש בתוסף Google Home לניפוי באגים ב-Matter

רישום ביומן ב-Android

בקטע MATTER LOGGING TOOLS, לוחצים על Android Logs כדי לפתוח את הדף Android Logs, בוחרים את טלפון ה-Android שאליו רוצים להתחבר ומתחילים להציג את היומנים.

אחרי שהטלפון של Android יתחבר, תהיה לך אפשרות לראות את היומנים שורה אחר שורה. שימו לב שהיומנים מסוננים, כך שמוצגים רק יומנים שקשורים ל-GHA ולמודול Google Play services Matter. אפשר גם להגדיר Severity כדי לסנן את היומנים או Search כדי לחפש מילת מפתח ביומנים.

רישום ביומן של מכשירים בתקן Matter

בקטע MATTER LOGGING TOOLS, לוחצים על קובץ יומן במכשיר כדי לפתוח את הדף Resources, ובוחרים קודם את SoC Type:

אחר כך בוחרים את מכשיר Matter:

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

הורדת כל היומנים של העניין

בקטע QUICK ACCESS, לוחצים על Download Logs כדי לפתוח את תיבת הדו-שיח Download Logs, בוחרים את היומנים שרוצים להוריד ולוחצים על OK.

בוחרים את התיקייה שבה רוצים להוריד את היומנים ולוחצים על שמירה:

אחר כך היומנים יישמרו בתיקיית היעד:

מחלצים את קובץ ה-ZIP שנשמר. יוצגו פרטי המכשיר וקובצי היומן.

קובץ פרטי המכשיר יכלול את כל פרטי הגרסה שנדרשים לניפוי באגים.

שליחת משוב

כדי לשלוח רעיונות או משוב על שיפור חוויית הפיתוח ב-Google Home Extension, אתם יכולים לבחור אחת מהאפשרויות הבאות:

• בחלונית עזרה ומשוב, לוחצים על Give Feedback כדי לשלוח לנו הצעות.
• בחלונית עזרה ומשוב, לוחצים על דיווח על בעיה כדי לדווח על כל בעיה שנתקלתם בה ב-Google Home Extension.

• הוספנו גם סמל משוב בדף משאבים.