תוסף Google Home לקוד VS

Matter    Cloud-to-cloud    Local Home SDK    Device 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 Code.

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

הצהרות באצווה

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

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

בעזרת כלי הרישום בתקן Matter אפשר לאסוף את כל היומנים שקשורים לניפוי באגים בתקן 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 זמינה עכשיו ישירות ב-Google Home Extension כדי שתוכלו לאמת את מצב המכשיר ב-Home Graph בתוך VS Code. לפרטים נוספים, ראו הצגת גרף הבית והרצת בדיקות.

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

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

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

    סמל של תוסף Google Home

  2. לוחצים על כניסה באמצעות חשבון 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. בחלון הנפתח חיפוש ובחירה בפרויקט, בוחרים את הפרויקט שלכם לבית החכם.

התקנת הכלי 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 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 כדי להציג יומנים נוספים.

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

הצגת תרשים הבית והרצת בדיקות

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

מציג גרף הבית

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

הכלי לבדיקת ההגדרה של Google Home

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

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

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

רישום ביומן Android

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

רישום ביומן Android

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

סינון יומן ב-Android

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

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

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

בשלב הבא, צריך לבחור את Matter Device:

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

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

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

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

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

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

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

שמירת יומן עניין

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

תיקיית היעד ביומן של Matter

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

קובץ ZIP של יומן Matter

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

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

שליחת משוב

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

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