Matter מענן לענן Local Home SDK Device SDK
Google Home Extension for Visual Studio Code מיועד למפתחים של פלטפורמת Google Home. התוסף הזה מעניק לכם גישה ל-Google Assistant Simulator, ל-Google Cloud Logging, לכלי להצגת Home Graph ולכלים נוספים שמפשטים את תהליך הפיתוח של Matter ושל הבית החכם.
תכונות של תוספים ל-Google Home
סימולטור Google Assistant
כדי לבדוק אם מכשירי הבית החכם שלכם פועלים כראוי עם הסביבה העסקית של Google Home, תוכלו לקיים אינטראקציה עם Assistant Simulator בכל שלב בלי לצאת מ-VS Code.
Assistant Simulator מאפשרת לכם לשלוט במכשירים בקלות על ידי הקלדה של השאילתות, לדוגמה, "Turn on the light". ב-VS Code, Assistant Simulator מגיב בהודעות טקסט בהתאם לפקודות שלכם, לדוגמה, "בסדר, מדליק את האור". למידע נוסף, ראו שימוש בסימולטור של Google Assistant.
Batch Utterances
כדי לבדוק את השילוב שלכם עם Google Home כמו אוטומט, אתם יכולים לשלוח קבוצות של ביטויים ל-Google Assistant Simulator על ידי הפעלת סקריפט של ביטוי. לפרטים נוספים, ראו הרצת 'קבוצת ביטויים'.
כלים לתיעוד ביומן של 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 זמינה עכשיו ישירות ב-Google Home Extension, כך שתוכלו לאמת את מצב המכשיר ב-Home Graph ב-VS Code. לפרטים נוספים, ראו הצגת התרשים הראשי והרצת בדיקות.
התקנת התוסף של Google Home ל-VS Code
כדי להתקין את Google Home Extension, פועלים לפי השלבים הבאים ב-VS Code:
- לוחצים על סמל התוספים בסרגל הפעילות.
מחפשים את
google homeולוחצים על התקנה.
אפשר גם להוריד את Google Home Extension ישירות מ-VS Code Marketplace.
הגדרת התוסף של Google Home ל-VS Code
אחרי שתתקינו את Google Home Extension ותטעינו מחדש את VS Code, תצטרכו להיכנס לחשבון ולבחור פרויקט כדי להשתמש ב-Assistant Simulator ולצפות ב-Cloud Logging.
כניסה באמצעות חשבון Google ובחירת פרויקט בענן
אפשר להיכנס לחשבון המפתח מ-Google Home Extension, ולהעניק ל-VS Code הרשאה לתקשר עם שירותי Google בשמכם.
לוחצים על הסמל של Google Home בסרגל הפעילות כדי לפתוח את Google Home Extension.
לוחצים על כניסה באמצעות חשבון Google כדי להציג את תצוגת ההתחברות בדפדפן.
בוחרים את החשבון שמקושר למכשירים לבית החכם.
בדף ההרשאה כניסה באמצעות חשבון Google, לוחצים על אישור.
תיפתח כרטיסייה בדפדפן ותופיע תיבת הדו-שיח Open Visual Studio Code. לוחצים על פתיחת Visual Studio Code כדי להמשיך.
תועברו אל VS Code, שם תצטרכו לאשר להרחבה של Google Home לפתוח URI. לוחצים על פתיחה כדי לסיים את תהליך הכניסה.
אחרי הכניסה, הפרויקטים שלכם יטענו ב-Google Home Extension. בסיום, לוחצים על Select a project.
בחלון הנפתח Search and select a project, בוחרים את הפרויקט של הבית החכם.
התקנת הכלי Android Debug Bridge (ADB)
כדי להציג את היומנים של Matter בטלפון Android, צריך להתקין את ADB:
- מתקינים את ADB במחשב.
- מפעילים את האפשרויות למפתחים ואת ניפוי הבאגים ב-USB בטלפון Android.
התקנת כלי SoC למכשירי Matter
כדי להציג את יומני ניפוי הבאגים ממכשירי Matter:
- רוב מעבדי ה-SoC של המכשיר מייצאים יציאות טורי כמו
/dev/ttyUSBxב-Linux או/dev/tty.SLAB_USBtoUARTאו/dev/tty.usbserialב-MacOS. LogViewer יכול לקרוא את היומן ישירות מהמכשיר. - יכול להיות שסוגי SoC מסוימים, כמו NXP או Silicon Labs, ידרשו התקנה של כלים חיצוניים (לדוגמה, JLink). למידע נוסף, אפשר לעיין במאמר מכשירים נתמכים.
שימוש בתוסף Google Home ל-VS Code
הצגת מקורות המידע למפתחים
בקטע עזרה ומשוב, לוחצים על תחילת העבודה ומשאבים כדי לפתוח את הדף משאבים, שבו אפשר למצוא מידע שימושי לפיתוח באמצעות הסביבה העסקית של Google Home.
שימוש בסימולטור של Google Assistant
כדי לפתוח את Assistant Simulator ב-VS Code, לוחצים על סימולטור של Google Assistant בסרגל הצד. בתיבה הודעה, מקלידים את השאילתה ומקישים על Enter.
אפשר להציג Assistant Simulator תשובות, וללחוץ על הלחצן אחרי השאילתה כדי לשלוח אותה מחדש.
הרצת Batch Utterances
מעבירים את העכבר מעל לסרגל התפריטים של GOOGLE ASSISTANT SIMULATOR ובוחרים מבין האפשרויות הבאות כדי להגדיר סקריפטים:
לוחצים על כדי לפתוח סקריפטים קיימים של ביטויים.
לוחצים על כדי לשמור את ההיסטוריה בסקריפט
*.utterance.
כדי להתחיל לשלוח משפטים בכמות גדולה, בוחרים באחת מהאפשרויות הבאות:
- לוחצים על כדי לבחור סקריפט של ביטוי מהחלון הנפתח.
פותחים קובץ
*.utteranceישירות ולוחצים על .
הצגת Cloud Logging
בקטע QUICK ACCESS, לוחצים על Cloud Logs כדי לפתוח את הדף Cloud Logs, שבו יופיעו היומנים של הפרויקט שבחרתם.
המשתמשים יכולים לסנן יומנים לפי רמת החומרה וטווח הזמן.
כברירת מחדל, היומנים מוגבלים ל-50 שורות. אם המשתמש רוצה להציג יומנים נוספים, הוא יכול לגלול למטה ולחץ על עוד כדי להציג יומנים נוספים.
הצגת Home Graph והרצת בדיקות
בקטע QUICK ACCESS (גישה מהירה), לוחצים על Home Graph Viewer (תצוגת גרף דף הבית) כדי לפתוח את החלונית Home Graph Viewer (תצוגת גרף דף הבית), שבה אפשר למצוא את המכשירים ששייכים לפרויקט שנבחר. אפשר גם ללחוץ על הרצת הבדיקה כדי להריץ בדיקות במכשיר.
הפעולה הזו תפעיל את חבילת הבדיקות בדפדפן, והמכשיר יבחר ויהיה מוכן לבדיקה. לוחצים על Start וממתינים לתוצאות הבדיקה.
אפשר לבדוק את פרטי הבדיקה ולראות את היומנים אחרי שכל הבדיקות יושלמו.
שימוש בתוסף של Google Home לניפוי באגים ב-Matter
רישום ביומן ב-Android
בקטע MATTER LOGGING TOOLS, לוחצים על Android Logs כדי לפתוח את הדף Android Logs, בוחרים את הטלפון Android שרוצים להתחבר אליו ומתחילים להציג את היומנים.
אחרי שמחברים את הטלפון Android, אפשר לראות את היומנים שורה אחרי שורה. לתשומת ליבכם, היומנים מסוננים, כלומר מוצגים רק יומנים שקשורים ל-GHA ול מודול Matter של Google Play services. אפשר גם להגדיר את מידת החומרה כדי לסנן יומנים או לחפש את מילת המפתח ביומנים.
רישום ביומן של מכשירים בתקן Matter
בקטע MATTER LOGGING TOOLS, לוחצים על Device Logs כדי לפתוח את הדף Resources, ובוחרים קודם את SoC Type:
לאחר מכן בוחרים את מכשיר Matter:
לאחר מכן תוכלו לקבל את כל יומני המכשיר מהמכשיר ולהשתמש במסננים כמו Severity ו-Search כדי למצוא את המידע הרצוי.
הורדה של כל יומני התיקים
בקטע QUICK ACCESS, לוחצים על Download Logs כדי לפתוח את תיבת הדו-שיח Download Logs, בוחרים את היומנים שרוצים להוריד ולוחצים על OK.
בוחרים את התיקייה שבה רוצים להוריד את היומנים ולוחצים על שמירה:
לאחר מכן היומנים יישמרו בתיקיית היעד:
מחלצים את קובץ ה-ZIP שנשמר. יוצגו בו פרטי המכשיר וקבצי יומנים.
קובץ פרטי המכשיר יכלול את כל פרטי הגרסה הנדרשים לניפוי באגים.
שליחת משוב
כדי לשלוח לנו משוב על דרכים לשיפור חוויית הפיתוח ב-Google Home Extension, תוכלו לבחור מבין האפשרויות הבאות:
- בחלונית עזרה ומשוב, לוחצים על שליחת משוב כדי לשלוח לנו הצעות.
- בחלונית עזרה ומשוב, לוחצים על דיווח על בעיה כדי לדווח על בעיה שמצאתם ב-Google Home Extension.
- הוספנו גם סמל משוב בדף משאבים.