תוסף Google Home לקוד VS

ה-SDK של המכשיר

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

תוסף של Google Home ל-VS Code

תכונות התוספים של Google Home

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

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

בדומה ל-Simulator הקיים ב-Actions Console, Assistant Simulator מאפשר לשלוט בקלות במכשירים על ידי הקלדת השאילתות, לדוגמה: "Turn on the light" בתוך VS Code, של Assistant Simulator ישיב עם הודעות טקסט שמבוססות על הפקודות שלכם. לדוגמה: "Alright, turn on the light". למידע נוסף, ראו שימוש בסימולטור של Google Assistant.

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

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

כלים לרישום עניינים

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

רישום עניינים בתוסף Google Home

Cloud Logging

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

בעל הרשאת צפייה בגרף הבית

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

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

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

  1. לוחצים על סמל התוספים בסרגל הפעילות.
  2. מחפשים את google home ולוחצים על התקנה.

    זירת המסחר של התוספים של 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 בסרגל הפעילות כדי לפתוח את Google Home Extension.

    סמל התוסף של Google Home
  2. לוחצים על Sign in with Google (כניסה באמצעות חשבון Google) כדי להפעיל את תצוגת ההתחברות בדפדפן.

    כניסה באמצעות חשבון Google ל-VS Code
  3. בוחרים את החשבון שמקושר למכשירים לבית החכם.

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

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

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

    מתן הרשאה לתוסף של Google Home לפתוח 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

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

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

מקורות מידע לסביבה העסקית של Google Home

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

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

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

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

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

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

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

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

    סמלי התפריט של ההשמעה באצווה

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

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

    סמל של הרצת ביטויים מרובים

הצגת Cloud Logging

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

שימוש ב-Cloud Logging

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

סינון יומנים לפי חומרה וזמן

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

הצגת יומנים נוספים

הצגה של גרף הבית וביצוע בדיקות

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

בעל הרשאת צפייה בגרף הבית

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

חבילת הבדיקה של Google Home

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

תוצאות הבדיקה

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

רישום ביומן Android

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

רישום ביומן Android

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

רישום ביומן Android מסונן

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

בקטע MATTER LOGGING TOOLS, לוחצים על Device Logs כדי לפתוח את הדף Resources, ואז בוחרים קודם את SoC Type:

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

בשלב הבא, בוחרים את המכשיר של החומר:

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

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

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

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

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

הורדת יומני העניין

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

שמירה של יומן העניין

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

תיקיית היעד של יומן העניין

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

קובץ ZIP של יומן עניינים

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

ניפוי באגים ביומן עניינים

שליחת משוב

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

  • בחלונית עזרה ומשוב, לוחצים על שליחת משוב כדי לתת לנו הצעות.
  • בחלונית עזרה ומשוב, לוחצים על דיווח על בעיה כדי לדווח על כל בעיה שמצאתם ב-Google Home Extension
הסמל של שליחת משוב
  • יש גם סמל משוב בדף משאבים.