הפלאגין של Google Assistant ל-Android Studio

הפלאגין של Google Assistant בודק את הפעולות באפליקציה ב-Android Studio. במהלך הפיתוח והבדיקה, עליך להשתמש בפלאגין כדי ליצור תצוגה מקדימה של פעולות באפליקציה ב-Assistant בחשבון Google שלך. לאחר מכן אפשר לבדוק איך התכונה 'פעולה באפליקציה' מטפלת בפרמטרים שונים לפני שהיא שולחת אותה לפריסה.

איך זה עובד

הפלאגין של Google Assistant כולל את כלי הבדיקה של 'פעולות באפליקציה', תכונה מנתח את הקובץ shortcuts.xml ויוצר תצוגה מקדימה של הפעולות באפליקציה עבור חשבון Google אחד. התצוגות המקדימות האלה מאפשרות ל-Google Assistant לזהות את פעולות באפליקציה לפני הפריסה של גרסת הייצור של האפליקציה ב-Google Play Console.

לכל קובץ Intent מובנה (BII) בקובץ shortcuts.xml, הכלי מעבד אובייקט JSON-LD תואם ומספק ערכי פרמטרים שמוגדרים כברירת מחדל. אפשר לאחר מכן משנים את הערכים האלה כדי לבדוק את הפעולות באפליקציה עם פרמטר משמעותי כדי לוודא שהם מבצעים את הפעולות הנכונות באפליקציה. התצוגות המקדימות הן שנוצרו, עודכנו ונמחקו בכלי הבדיקה, כך שתוכלו לחזור בדיקת הפעולות באפליקציה בסביבה בטוחה.

אחרי שיוצרים תצוגה מקדימה, אפשר להפעיל פעולה באפליקציה במכשיר הבדיקה ישירות מהחלון של כלי הבדיקה. אם מדובר ב-BIIs שזמינים להפעלה על ידי משתמשים, תוכלו להשתמש ב-app name ישירות ב-Assistant במכשיר כדי לנסות את פעולת האפליקציה. לדוגמה, אפשר לומר "Ok Google, start my התרגיל באמצעות Example App" כדי להפעיל פעולה באפליקציה שמשתמשת actions.intent.START_EXERCISE BII.

תמיכה בלוקאל

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

הורדת הפלאגין

הפלאגין של Google Assistant זמין ל-Android Studio. עבור מידע על ההתקנה ועל השימוש ב-Android Studio, אפשר לעיין הדף Android Studio.

כדי להתקין את הפלאגין של Google Assistant ב-Android Studio, מבצעים את השלבים הבאים:

1. עוברים אל קובץ > הגדרות (Android Studio > העדפות ב-macOS).
2. בקטע יישומי פלאגין, עוברים אל Marketplace ומחפשים את "Google Assistant Plugin".
3. מתקינים את הכלי ומפעילים מחדש את Android Studio.

אפשר גם להוריד את הפלאגין ישירות מהמאגר הציבורי של Jetbrains.

הדרישות להגדרת YouTube Music

השימוש בפלאגין של Google Assistant מחייב מספר שלבי הגדרה כדי אפשר לבדוק בהצלחה את הפעולה באפליקציה. באופן ספציפי, צריך להשתמש אותו חשבון משתמש ב-Android Studio, במכשיר הבדיקה וב-Google Play גישה למסוף.

מכינים את סביבת הפיתוח באמצעות ההגדרות הבאות:

• נכנסים אל Android Studio (גרסה 4.0 ואילך).
• נכנסים לאותו חשבון באפליקציית Google במכשיר הבדיקה עם Android.
• באמצעות אותו חשבון, מקבלים גישה ל-Play Console לחבילת האפליקציה שהועלתה לצורך בדיקה.
• פותחים את אפליקציית Google במכשיר הבדיקה של Android ומסיימים את הפעולה הראשונית תהליך ההגדרה של Assistant.
• מפעילים את האפשרות סנכרון נתונים של המכשיר במכשיר הבדיקה.

מגבלות

אלה המגבלות של הפלאגין של Google Assistant:

• פעולות באפליקציה שמשולבות בהן מלאי שטחי פרסום באתר והפעלת אפליקציה שפועלת בחזית לא ניתנים לבדיקה ישירות בכלי הבדיקה או באמצעות גשר לניפוי באגים ב-Android (adb) פקודות. כדי לבדוק את הפעולות האלה באפליקציה, קודם צריך ליצור תצוגה מקדימה באמצעות הבדיקה של Google. לאחר מכן, תוכלו להפעיל את פעולות האפליקציה האלה על ידי אינטראקציה עם Google Assistant במכשיר הפיזי.
• מלאי שטחי פרסום מוטבע עבור actions.intent.OPEN_APP_FEATURE ניתן לבדוק את BII רק למשך 6 שעות לאחר התצוגה המקדימה נוצרו או עודכנו. צריך לעדכן את התצוגה המקדימה של כלי הבדיקה או ליצור תצוגה מקדימה חדשה כדי לאפס את פרק הזמן של שש השעות.

הוספת בודקים

אפשר להזמין משתמשים נוספים לפרויקט כדי שיוכלו לבדוק את שילוב של 'פעולות באפליקציה'. האפשרות הזו שימושית אם רוצים לשתף את הפרויקט עם חברים אחרים בצוות הפיתוח שלכם כדי שכולם יוכלו לבדוק, או מתי שתשתפו את הפרויקט שלכם עם בודקי בקרת איכות (QA) כהכנה לקראת בסביבת הייצור. צריך להוסיף את הבודקים כבודקי רישיונות ב-Google בחנות Play הוענקה הרשאת קריאה בלבד ל-Google Play Console.

כדי להוסיף בודקים נוספים, יש לבצע את השלבים הבאים:

1. נכנסים ל-Play Console.

2. פועלים לפי ההוראות בקטע הגדרת רישוי של אפליקציות נושא העזרה של Play Console.

   

   איור 1. הוספת בודקי רישיון.

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

3. להזמין את חשבון Google של בודק הרישיון לחשבון קריאה בלבד ב-Google Play Console משתמש.

   1. בוחרים באפשרות משתמש והרשאות > הזמנת משתמשים חדשים > הוספת האפליקציה
   2. בקטע גישה לאפליקציה, מוודאים שתיבת הסימון ניהול (כל ההרשאות) היא בוצע ניקוי.

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

צריך להתחבר לכל בודק שרוצים להפעיל לבדיקה של התצוגה המקדימה. בנפרד ל-Android Studio באמצעות חשבון Google של המשתמש. אחרי ההתחברות, להשתמש בפלאגין של Google Assistant כדי ליצור תצוגה מקדימה עבור משתמש הבדיקה.

שימוש בפלאגין של Google Assistant

כדי לגשת לכלי הבדיקה של 'פעולות באפליקציה' ב-Android Studio, עוברים אל כלים > Google Assistant > כלי הבדיקה של 'פעולות באפליקציה'. כשפותחים את הכלי, התצוגה משתנה בהתאם האם יש לכם תצוגה מקדימה פעילה של כלי הבדיקה.

ליצור, לעדכן ולמחוק תצוגות מקדימות

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

הערה: כדאי להשתמש בכלי הבדיקה של 'פעולות באפליקציה' עם גרסאות build של אפליקציות שמותקנות במכשיר מ-Android Studio.

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

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

כדי ליצור תצוגה מקדימה, צריך לבצע את הפעולות הבאות ב-Android Studio:

1. פותחים את כלי הבדיקה של 'פעולות באפליקציה'.
2. אפשר להזין את השם והלוקאל של האפליקציה לבדיקה. ברירת המחדל השם והלוקאל של האפליקציה הם test app action ו-en.
3. לוחצים על יצירת תצוגה מקדימה. אם תופיע בקשה, תצטרכו לקרוא את המדיניות ואת התנאים וההגבלות של 'פעולות באפליקציה' ולאשר אותם. אחרי שיוצרים את התצוגה המקדימה, כלי הבדיקה עדכונים על חלונות להצגת מידע על ממשקי BII שנמצאים ב shortcuts.xml.

כלי הבדיקה משתמש בשם האפליקציה כדי ליצור ולדמות שאילתות של Assistant עבור פעולות האפליקציה. פריסות באפליקציה 'פעולות באפליקציה' משתמשות בשם האפליקציה שלך בחנות Play להפעלה, אבל אפשר להשתמש בכל שם הפעלה בכלי הבדיקה. עם זאת, מומלץ להשתמש בשם האפליקציה בתור שם ההפעלה בשדה וכלי הבדיקה.

שפת Google Assistant צריכה להיות זהה לשפה של Google Assistant במכשיר שלך במכשיר הבדיקה, ואפשר ליצור תצוגה מקדימה רק באזור אחד בכל פעם. לדוגמה, אם השפה של Assistant מוגדרת לאנגלית (ארה"ב), תוכלו להזין את הערך en-US אבל לא את הערכים en-**,‏ en-GB או en-US, en-GB. אפשר להשתמש בלוקאל ברמה הבסיסית (root), כמו בתור en, כדי לכלול גם את en-GB וגם את en-US.

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

כדי לעדכן תצוגה מקדימה קיימת כך שתתאים לקובץ shortcuts.xml, לוחצים על הלחצן Update בכלי הבדיקה. מידע על הפעילות הנוכחית שלך התצוגה המקדימה נמצאת בקטע בדיקת פעולה באפליקציה בחלון כלי הבדיקה.

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

הגדרת BII

אחרי שיוצרים תצוגה מקדימה לאפליקציה, אפשר לבדוק פרמטרים שונים ל-BII בפלאגין. עבור כל BII ב shortcuts.xml, הפלאגין מעבד קובץ תואם אובייקט JSON-LD ומספק ערכי פרמטרים שמוגדרים כברירת מחדל. אפשר לשנות אותם ערכי ברירת מחדל כדי לבדוק את הפעולות באפליקציה באמצעות שילובים משמעותיים של פרמטרים. ולוודא שהן מבצעות את הפונקציות הנכונות של האפליקציה.

פרמטרים והערכים שלהם בדרך כלל מופיעים אחרי schema.org או schema.googleapis.com של נכסים ותיאורים. טיפים נוספים לאופטימיזציה מפורטים מידע על כל פרמטר BII באמצעות גישה לסכימה את התיאורים של פרמטר מסוים ואת הפרמטרים ברמה הגבוהה יותר.

לדוגמה, ממשק BII של actions.intent.GET_FOOD_OBSERVATION תומך בפרמטר Intent foodObservation.forMeal. בדף schema.googleapis.com של MealType רשום name בתור לנכס. הנכס forMeal הוא אמצעי העברה, והוא מצפה (כגון MealTypeLunch) מסוג MealType המסופר.

ב בכלי הבדיקה, אפשר לספק כל אחת מהספירות כערך foodObservation.forMeal:

• https://schema.googleapis.com/MealTypeSnack
• https://schema.googleapis.com/MealTypeBrunch
• https://schema.googleapis.com/MealTypeLunch
• https://schema.googleapis.com/MealTypeBreakfast
• https://schema.googleapis.com/MealTypeDinner
• https://schema.googleapis.com/MealTypeDesert

הקפצה של פעולות באפליקציה

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

כדי להפעיל פעולה באפליקציה באמצעות כלי הבדיקה, מבצעים את הפעולות הבאות:

1. מחברים את מכשיר הבדיקה.
2. בקטע בחירת מכשיר יעד, בוחרים את המכשיר שאליו רוצים להוסיף את המכשיר. להקפיץ את פעולת האפליקציה.
3. בקטע Test App Action (בדיקת פעולה באפליקציה), לוחצים על הלחצן Run App Action (הרצת פעולה באפליקציה).

פעולות באפליקציה שמופעלות בכלי הבדיקה משתמשות פקודת Android Debug Bridge (adb). פקודת המעטפת adb שנוצרה הדוח כולל את כל המטא-נתונים שנדרשים על ידי אפליקציית Google לביצוע BII. הגישה הזו מחקה את ההתנהגות של הפעולה באפליקציה אחרי Assistant שולפת פיסות מידע חשובות מהשאילתה.

רישום ביומן של Android Studio

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

כדי לגשת לקובצי היומן של Android Studio, צריך לעבור אל עזרה > הצגת Log in Explorer (עזרה > הצגת מאתר היומנים ב-macOS).

יומנים שקשורים לפעולות באפליקציה זמינים ב-Logcat. Logcat מתעד יומנים ממכשירים וירטואליים או פיזיים שמחוברים ל-Android Studio.

כדי לקבל יומני פעולות של אפליקציות במכשיר:

1. כדי לגשת להודעות יומן ה-Logcat, לוחצים על Logcat ב-Android Studio סרגל החלון של הכלי.
2. חיפוש יומנים שכוללים את ActivityTaskManager.

קבלת תמיכה ומקורות מידע נוספים

הפלאגין של Google Assistant מספק קישורים למסמכי עזרה, ל-Codelabs ולמשאבים אחרים שיעזרו לכם ללמוד ולהשתמש בכלי הבדיקה.

כדי לפתוח את העוזר הדיגיטלי ב-Android Studio, בוחרים באפשרות כלים > Google Assistant > עזרה.

איור 2. הקטע 'עזרה' בפלאגין של Google Assistant.