Google Home Plugin for Android Studio עוצב ונוצר עבור Google מפתחי פלטפורמת Home. הפלאגין הזה נותן לך גישה אל Google Assistant Simulator, Cloud Logging וכלים נוספים שיעזרו לכם לפשט את לתהליך הפיתוח של בית חכם.
הודעת אבטחה
כדי למנוע מ-Android Studio לאחסן סודות סיסמאות, השלימו את השלבים הבאים:
- לוחצים על קובץ, ואז על הגדרות....
- בקטע מראה ו Behavior (התנהגות), מרחיבים את System Settings (הגדרות המערכת) ולוחצים על סיסמאות.
- בוחרים באפשרות לא לשמור, שוכחים סיסמאות אחרי הפעלה מחדש.
תכונות
סימולטור של Assistant
כדי לבדוק אם המכשירים לבית החכם פועלים בצורה תקינה עם Google Home בסביבה העסקית, אפשר לקיים אינטראקציה עם Assistant Simulator בכל שלב יציאה מאפליקציית Android Studio.
דומה ל-Assistant הקיימת סופקו סימולטור במסוף Actions on Google Console, Assistant Simulator מאפשר לך כדי לשלוט בקלות במכשירים שלכם על ידי הקלדת השאילתות, לדוגמה, "Turn on the light" (הפעלת הנורה). בתוך Android Studio, Assistant Simulator משיב בהודעות טקסט על סמך פקודות כמו "מצוין, מדליקים את האור".
הצגת Cloud Logging
Google Cloud Logging מספק מידע על ניפוי באגים ומדדי מפתח שיעזרו לכם לקבל תובנות השימוש בפעולה. כדי לפשט את תהליך הפיתוח, Google Home Plugin מציג הודעות Cloud Logging בזמן אמת ממש ליד הקוד במהלך לפתרון בעיות.
אפשר להציג יומנים בזמן אמת או לבחור טווח תאריכים.
ביטויים באצווה
Assistant Simulator תשובות להבעה אחת אינן דטרמיניסטי. לדוגמה, תשובה יכולה להיות כל אחד מהביטויים הבאים:
- הבנתי, מדליקים את שני האורות.
- בטח, מדליק את שני האורות.
- הבנתי, מדליקות 2 נורות.
- בסדר, מדליקים שתי נורות.
כדי להריץ בדיקות אוטומטיות ולוודא איך השילובים שלך עם Google פועלים עם אפשר לשלוח ביטויים באצווה Assistant Simulator על ידי הרצת סקריפטים של דיבור. אחרי שמגדירים סקריפט שנשמרים, אפשר לאסוף תשובות ולהריץ בדיקות מרובות על השאילתות שלכם.
בעל הרשאת צפייה בגרף הבית
הכלי Home Graph Viewer מאפשר לכם: להציג את המצב של המכשירים שלכם ולהפעיל את Google Home Test Suite בדפדפן שלך.
מציג היומן של ניפוי הבאגים ב-Android (adb)
Adb Log Viewer הוא כלי שמאפשר להציג ולנתח קובצי יומן, לדוגמה Matter קובצי יומן במכשיר, יומני Google Home ו-Android יומנים.
התקנה
כדי להתקין את Google Home Plugin ב-Android Studio, יש לבצע את השלבים הבאים:
- מורידים או מעדכנים את Android Studio. להורדת Android Studio
- עוברים אל קובץ > הגדרות (Android Studio > העדפות ב-MacOS).
- בקטע יישומי פלאגין, עוברים אל Marketplace ומחפשים את
google home. - מתקינים את הכלי ומפעילים מחדש את Android Studio.
אפשר גם להוריד את הפלאגין ישירות JetBrains Marketplace.
הגדרה
לאחר התקנת הפלאגין, עליך לפני שמתחילים להשתמש ב-Assistant Simulator, צריך לבצע את השלבים הבאים הצגת Cloud Logging:
כניסה באמצעות חשבון Google
אתם יכולים להיכנס לחשבון הפיתוח שלכם מהחלונית של Google Home, מעניקה הרשאה ל-Android Studio לתקשר עם Google שירותים מטעמך.
לוחצים על הכרטיסייה דף הבית של Google בעמודה 'כרטיסייה אנכית' שמימין. הצד של החלון Android Studio.
בשדה כניסה באמצעות, לוחצים על Google כדי להפעיל את הדפדפן.
בוחרים את החשבון שמקושר למכשירים לבית החכם.
בדף ההרשאה Sign in with Google (כניסה באמצעות חשבון Google), לוחצים על Allow (אישור).
סוגרים את חלון הדפדפן וחוזרים אל Android Studio.
עכשיו אתם אמורים להיות מחוברים לחשבון, עם האפשרות יציאה.
בחירת פרויקט ב-Cloud
אחרי הכניסה לחשבון, בוחרים באפשרות Project (פרויקט) מהתפריט הנפתח. כדי לסנן את
רשימת פרויקטים, מקלידים ביטוי Filter, לדוגמה matter, ומקישים על
Enter
התפריט הנפתח Project טוען את 100 הפרויקטים הראשונים, על סמך סינון. הבחירות שלכם יישמרו כשתצאו Android Studio
לקבלת עזרה עם מסנני פרויקטים: פרמטרים של שאילתה במאמרי העזרה של Google Cloud.
שימוש בסימולטור של Assistant
כדי לפתוח את Assistant Simulator ב-Android Studio, לוחצים על חלונית ביטויים בחלונית Google Home Plugin.
יש כמה דרכים לשלוח שאילתות אל Assistant Simulator. בשלב הבא, נעבור על כל אפשרות.
הקלדת שאילתות ואיסוף תשובות
כדי לבצע אינטראקציה עם Assistant Simulator, מקלידים את השאילתה ולוחצים מקש Enter.
אפשר לשלוח מחדש שאילתה על ידי לחיצה על סמל השליחה מחדש של בסוף את השאילתה שלך.
אחרי ששולחים שאילתה אחת או יותר, לוחצים על הפעל מחדש כדי להפעיל מחדש את ולבדוק את התשובות שלכם. בחלונית אמירות אפשר לעקוב אחרי והשאילתות והתשובות בקבצים שמורים במטמון. הפעלה מחדש מוסיפה רק תשובות חדשות למקרים הבאים את המטמון הפנימי הזה ולא ישכפלו את השאילתות בכל פעם שלוחצים על לחצן.
לוחצים על Save כדי לשמור את השאילתות. את התשובות שהזנת חלונית התבטאויות. האינטראקציות שלך מומרות ל-JSON בדרכים הבאות פורמט:
ask: השאילתה שלך.answers: מערך של תגובות Assistant Simulator אפשריות.
אפשר לערוך את קובץ ה-JSON הזה ב-Android Studio.
{
"collected": false,
"lines": [
{
"ask": "turn lights on",
"answers": [
"OK, turning 2 lights on.",
"Sure, turning on 2 lights."
]
}
]
}
איסוף תשובות באצווה
בחלונית Google Home Plugin, לוחצים על קובץ ביטויים כדי לפתוח אותו.
את קובצי ה-JSON השמורים בכרטיסייה חדשה. בשביל Select Path, אפשר לבחור
בקובץ או בתיקייה. אם בוחרים תיקייה, האפשרויות איסוף ובדיקה:
על כל ההשמעות .json בקבצים שבתיקייה הזו.
אפשר לפתוח מספר כרטיסיות לאותו הקובץ או לקבצים שונים, למשל
lights, lights(1) וגם plug.
בשורת הסטטוס מוצגת התוצאה של הבדיקה האחרונה (אם רלוונטי).
נקודה צהובה או ירוקה כדי לציין אם הקובץ נאסף.
נתיב קובץ .json של הגייה. אחרי שלוחצים על
Collect,
Assistant Simulator מריץ את השאילתות.
תישלח לך התראה כשנקבל תשובה חדשה, וגם יוצג שורת הסטטוס
מציג מונה בזמן שמתבצע עיבוד של השאילתות.
כשהערך של Collect מסתיים, שורת הסטטוס מתעדכנת עם סימן אישור ירוק
לפני הנתיב .json, וקובצי ההתבטאות שלך מאוכלסים ב-
ואת התשובות האפשריות שלו.
{
"collected": true,
"lines": [
{
"ask": "turn lights on",
"answers": [
"OK, turning 2 lights on.",
"Sure, turning on 2 lights.",
"Sure, turning 2 lights on.",
"Got it, turning 2 lights on.",
"Alright, turning on 2 lights.",
"OK, turning on 2 lights.",
"Got it, turning on 2 lights.",
"Alright, turning 2 lights on."
]
}
]
}
אם מפסיקים את איסוף הנתונים בשלב מוקדם, הנתיב של .json לא יסומן בתור
שנאספו.
בדיקת ביטויים באצווה
אחרי שאוספים את התשובות, לוחצים על בדיקה להפעלה מחדש של השאילתות ולבדוק את התשובות והיומנים. כשבודקים ביטויים באצווה, Assistant Simulator מצפה לתגובות שנשמרות בקובץ ה-JSON חדש. אם הבדיקה תחזיר תשובה שלא נאספו, תתקבל הודעה התראה שדומה לתשובה הבאה:
Expected one of: "Got it, turning on
2 lights."
התרחיש הזה מצביע על כך שהבדיקה נכשלה. אחרת, הפרמטר Assistant Simulator יריץ את כל אחת מהשאילתות שלך ויחזיר תשובה. סימן ביקורת של מופיע שורת סטטוס אם הבדיקה הצליחה.
הצגת Cloud Logging
כדי לפתוח כרטיסיית פרויקט בחלון של הכלי Cloud Logs, לוחצים על Cloud Logs מהחלונית Google Home Plugin. אפשר לפתוח כרטיסיות נפרדות ב-Cloud Log לכל אחד מהפרויקטים שלכם.
מונחי השאילתה
בפרויקט שנבחר, אפשר גם לסנן יומנים באמצעות השדה שאילתה.
לדוגמה, כדי לסנן יומנים עבור מילת מפתח של light:
בוחרים באפשרות שימוש ב-QL כדי להשתמש ב- שפת שאילתת הרישום ביומן.
ריכזנו כאן כמה דוגמאות לשאילתות QL שיעזרו לכם להתחיל:
severity = (DEBUG OR INFO OR NOTICE OR WARNING OR ERROR OR CRITICAL OR ALERT OR EMERGENCY) AND resource.type="assistant_action_project" AND timestamp > "2022-04-07T00:40:18Z"
jsonPayload.executionLog.executionResults.actionResults.action.trait = "TRAIT_ON_OFF"
jsonPayload.executionLog.executionResults.actionResults.action.actionType = "ONOFF_ON"
שאילתות לגבי תאריך ושעה
גם שליחת שאילתות על יומנים לפי תאריך היא אופציונלית, ואפשר להפעיל אותה בלחיצה על
אחרי ולפני. אפשר להקליד את התאריך והשעה בשדה הטקסט
שצוין, למשל 5/11/22, 12:37 PM, או להשתמש בבוררי התאריכים.
כדי לבחור את התאריך, ומזינים את השעה בשדה הטקסט.
- כדי לבחור תאריך אחרי
5/1/22, בוחרים באפשרות אחרי ולוחצים על סמל התאריך. - כדי לבחור תאריך לפני
5/1/22, בוחרים באפשרות לפני ולוחצים על התאריך סמל . - כדי לבחור תאריך בין
5/1/22ל-6/30/22, בוחרים באפשרות לפני ואז אחרי ובוחרים את התאריכים מסמל התאריך.
בוחרים באפשרות זמן אמת כדי לאחזר יומני פרויקטים חיים. לוחצים על הפסקה כדי לסיים פיד בזמן אמת.
רמת החומרה
אפשר גם לבחור רמת חומרה מינימלית מהתפריט הנפתח.
תוצאות השאילתה
לוחצים על אחזור כדי לשלוח את הפרמטרים של השאילתה.
לאחר טעינת היומנים, לוחצים על רשומה כלשהי כדי להרחיב מטען ייעודי (payload) של JSON. צריך ללחוץ שוב על כדי להציג את ההודעה המלאה.
אם רוצים, אפשר להקליד מילת מפתח בתיבה סינון כדי לצמצם את היומן
תוצאות. אפשר ללחוץ על x כדי להסיר את המסנן ולחזור אל המקור
אחזור תוצאות.
הצגה של גרף הבית וביצוע בדיקות
כדי להציג את רשימת המכשירים, בוחרים תרשים בית חלונית Google Home Plugin.
לוחצים על רענן כדי להציג את שם המכשיר, מזהה המכשיר וסוג המכשיר של המכשירים המשויך לפרויקט שנבחר. אפשר לנהל כמה משתמשים חלוניות של Google Home Graph ייפתחו לפרויקטים נפרדים.
לאחר שהמכשירים נטענים, צריך ללחוץ על רשומה כלשהי כדי להרחיב מטען ייעודי (payload) של JSON.
אפשר גם להשתמש באפשרויות הרחבה וכיווץ כדי להציג ולהסתיר את קובץ ה-JSON. מטענים ייעודיים למכשירים שלכם.
כדי להפעיל את חבילת הבדיקה למכשיר מסוים: לוחצים על בדיקה. פעולה זו מפעילה את חבילת הבדיקה בדפדפן שלך עם המכשיר נבחר ומוכן לבדיקה. לוחצים על התחלה וממתינים לבדיקה. תוצאות.
אחרי שהבדיקות יסתיימו, תוכלו לבדוק את פרטי הבדיקות ולצפות ביומנים.
מציג היומן של ניפוי הבאגים ב-Android (adb)
כדי לפתוח כרטיסיית פרויקט בחלון של הכלי Adb Log, לוחצים על Adb Log. בסרגל הכלים של הפלאגין של Google Home (בצד ימין). אפשר לפתוח יומן Adb נפרד הכרטיסיות של כל אחד מקובצי היומן. כדי למחוק כרטיסייה, לוחצים על סמל של .
משתמשים בשדה בחירה כדי לבחור רכיב ספציפי לרישום ביומן להצגה, חומרה בתפריט הנפתח, כדי שיוצגו רק רשומות עם מידת החומרה התואמים של היומן.
אפשר לסנן את הרשומות ביומן באמצעות המסנן שבחרת ביומן adb שנבחר שדה אופציונלי עם מגבילי התאמה תלוי אותיות רישיות או Regex.
אפשר גם:
- כדי למצוא רשומות ספציפיות, משתמשים בשדה חיפוש באמצעות הפקודות חיפוש הבא (סמל ) וחיפוש הקודם (סמל ).
- אם רוצים, אפשר להשתמש במקשי צירוף תלוי אותיות רישיות או regex.
- דילוג לשורה כדי לדלג לשורה שצוינה (לפי מספר) ביומן.
בוחרים באפשרות ממוספר כדי להציג שורות ביומן עם מספרי שורות שנוספו. בוחרים באפשרות RAW. כדי להציג את הרשומות הגולמיות ביומן.
מקורות מידע ומשוב
לוחצים על משאבים כדי להציג את רשימת הכלים והמשאבים למפתחים.
כדי לשלוח לנו את דעתך או משוב לגבי הדרך שבה נוכל לשפר את הפיתוח עם Google Home Plugin, לוחצים על משוב.
