במהלך הפיתוח של פעולות באפליקציה, יכול להיות שתיתקלו בבעיות בהגדרה או בכלי לבדיקת פעולות באפליקציה. בדף הזה מתוארות חלק מהבעיות הנפוצות שאתם עלולים להיתקל בהן, ומוסבר איך לפתור אותן.
כללי
שגיאה: ההודעה 'לא נמצאה אפליקציה לפתיחת כתובת ה-URL' מופיעה בהודעה קופצת
כדאי לבדוק את הגדרות השלמת ההזמנות urlTemplate ב-actions.xml כדי לוודא שהן מוגדרות בצורה נכונה. אם משתמשים בכתובות URL של קישורים לאפליקציה, צריך לוודא שאפשר להפעיל את כתובת ה-URL באופן ידני באמצעות ACTION_VIEW וכתובת ה-URL. אם אתם משתמשים בכתובות URL שמבוססות על כוונת המשתמש, ודאו שהפעילות שלכם מוגדרת בצורה נכונה כדי להתחיל להשתמש בפרמטרים שסיפקתם.
שגיאה: "האפליקציה לא מותקנת"
יכול להיות שהשגיאה הזו מציינת שהמסנן <intent-filter> בקובץ AndroidManifest.xml
לא מסנן את קישור העומק שציינתם ב-actions.xml.
חשוב לבדוק את זה לפני ששולחים דיווח על באג.
השגיאה: "נמצאה הפניה לקבוצת ישויות שלא מכילה מזהה קבוצת ישויות או מסנן של כתובת URL" מופיעה ב-Android Studio
התנאי הזה נגרם בגלל בעיה ידועה בכלי לבדיקת קוד (linter) בתג <entity-set-reference>. אפשר להתעלם מההודעה הזו. כדי לעקוף את הבעיה, אפשר להשבית את בדיקת ה-lint לתג הזה על ידי הוספת המאפיין tools:ignore="ValidActionsXml".
דוגמה להפניה לקבוצת ישויות עם בדיקת לינט מושבתת:
<entity-set-reference entitySetId="example" tools:ignore="ValidActionsXml" />
שגיאה: 'מיקום לא חוקי' במסמך עם סכימת פעולות כשמעלים APK
העלאת ה-APK עלולה להיכשל אם משתמשים בכלי להסתרת קוד או לאופטימיזציה שמשפיע על המשאבים של ה-APK של הגרסה. כלים כמו ProGuard שלא משתמשים בקובצי משאבים לא גורמים לבעיה הזו.
כדי לפתור את הבעיה, נסו להשבית את הכלי עבור קובץ actions.xml
של האפליקציה (לדוגמה, באמצעות רשימת היתרים).
שגיאה: "יש APK פעיל או קובץ Android App Bundle שזוהה בהם קובץ actions.xml כדי להמשיך, עליך לאשר את התנאים וההגבלות של Actions on Google." מופיעה ב-Google Play Console
יכול להיות שהשגיאה הזו תוצג לכם כשתיצרו גרסת אפליקציה ב-Play Console. כדי לאשר את התנאים וההגבלות של Actions on Google, פועלים לפי השלבים הבאים:
- בוחרים את האפליקציה ב-Play Console.
- עוברים אל הגדרה > הגדרות מתקדמות.
- לוחצים על הכרטיסייה Actions on Google.
- מסמנים את התיבה אני רוצה לשלב את השירותים שלי עם פעולות האפליקציה באמצעות Actions on Google ופועלים לפי ההוראות.
לחצן 'אישור' בטופס התנאים וההגבלות של Play מושבת.
יכול להיות שהמשתמש שהתחבר לא עומד בדרישות של רמת הגישה כדי לאשר את התנאים האלה. חשוב לוודא שהשליחה הראשונה מתבצעת על ידי האדמין של פרופיל Play Console.
כלי לבדיקת פעולות באפליקציות
לפני שמנסים לבצע את התיקונים הבאים, צריך לעדכן את ההתקנה של כלי הבדיקה של פעולות באפליקציה לגרסה העדכנית ביותר.
פלאגין כלי הבדיקה של פעולות באפליקציה לא יכול לאתר את הקובץ actions.xml.
מוודאים שהוספתם את תג <meta-data> הנכון בקובץ AndroidManifest.xml.
התצוגה המקדימה של פעולת האפליקציה לא תואמת לקובץ actions.xml הנוכחי שלי.
התצוגה המקדימה לא מתעדכנת באופן דינמי בהתאם לתוכן של קובץ actions.xml. אחרי שמשנים את קובץ actions.xml באופן ידני או אחרי מעבר בין וריאציות של גרסאות ב-Android Studio, שומרים את קובץ actions.xml ולוחצים על עדכון התצוגה המקדימה בכלי הבדיקה.
התוסף של כלי הבדיקה של פעולות באפליקציה הפסיק לפעול או שהוא יוצר שגיאות.
קודם כול, מוודאים שעדכנתם את Android Studio לגרסה האחרונה. אם מופיעה שגיאת 403, יכול להיות שאתם מריצים את הפלאגין בחבילה שאין לכם הרשאות להריץ בה.
אם השגיאה נמשכת, צריך לדווח על באג ולשלוח ל-Google את הפרטים הבאים:
- פרטים של תיבת הדו-שיח של השגיאה
- יומנים של Android Studio. נכנסים אל עזרה > הצגת היומן ב-Finder. כאן מוצג המיקום של
idea.logב-Finder. מחפשים ביומן את המחרוזת "Submit Actions Request Body:" ומדביקים את תגובות השרת (אמורות להיות שתי תוצאות לפעולות).
כלי הבדיקה של הפעולות באפליקציה יוצר UnknownHostException או שגיאות רשת אחרות
כלי הבדיקה של פעולות באפליקציה יוצר תצוגה מקדימה של הפעולות באפליקציה, וכך מאפשר לכם לבדוק שילובים של Google Assistant עם חשבון Google יחיד. כדי ליצור את התצוגות המקדימות האלה, כלי הבדיקה דורש חיבור אינטרנט פעיל, ובמקרה הצורך, גישת proxy לדומיינים של Google.
כדי לפתור בעיות ברשת כשמריצים את כלי הבדיקה, כדאי לבדוק את הבעיות הנפוצות הבאות:
- לפני שיוצרים תצוגות מקדימות, צריך לוודא שיש חיבור אינטרנט פעיל.
אם החיבור לאינטרנט פעיל והרשת המקומית משתמשת בשרת proxy, צריך לבדוק את הדברים הבאים:
- בודקים את הגדרת ה-proxy של ה-IDE. מידע נוסף זמין בהוראות להגדרת שרת proxy ב-Android Studio או ב-IntelliJ.
- אם ה-proxy שלכם דורש רשימה של בקרת גישה (ACL), צריך לעדכן את ה-ACL כדי לאפשר את תבנית ה-URL הזו:
https://actions.googleapis.com/**.
כשמפעילים את פעולת האפליקציה באמצעות תוסף הבדיקה, Assistant אומרת: "Sorry, I couldn't find that" (מצטערת, לא הצלחתי למצוא את זה).
התשובה הזו עשויה להופיע מסיבות שונות, בהתאם להגדרה שלכם. אפשר לנסות את הפעולות הבאות:
- נכנסים ל-Android Studio, ל-Play Console ולמכשיר הבדיקה באמצעות אותו חשבון Google.
- מפעילים את האפשרות סנכרון נתוני המכשיר.
- מגדירים את השפה של המכשיר ושל Google Assistant ל
en-US. - צריך לוודא ששם החבילה של האפליקציה ב-Google Play Console זהה לשם החבילה באפליקציית הבדיקה.
- ב
urlTemplateהגדרת ההזמנהurlTemplateבקובץactions.xml, מוודאים שהערכים שלandroid:hostושלandroid:schemeזהים לערכים שמוצהרים בקובץAndroidManifest. - מסירים את כל ההתקנות הקודמות של האפליקציה ממכשיר הבדיקה ומתקינים גרסה חדשה.
- מוחקים את התצוגה המקדימה מכלי הבדיקה של פעולות באפליקציה ויוצרים תצוגה מקדימה חדשה.
- בודקים בכלי Logcat אם יש כשלים שקשורים להשלמת הפעולה ב-Google Assistant. אמורה להופיע כוונה להפעיל את האפליקציה.
- מפעילים את ההגדרה 'פרטי אפליקציות מהמכשירים' בחשבון.
- פותחים את Google Assistant ומוודאים שהשלמתם את ההגדרה. (בדרך כלל סרגל ההתקדמות של ההגדרה מופיע כסרגל כחול בתחתית המסך, אבל במקרים מסוימים הוא עשוי להיראות שונה).
- כשמשתמשים ב-Google Assistant כדי להפעיל פעולה באפליקציה, צריך לוודא ששם ההפעלה זהה לתצוגה המקדימה שנוצרה על ידי כלי הבדיקה של הפעולות באפליקציה.
- כדי להימנע משגיאות בתמלול, כדאי להשתמש בהזנת טקסט במקום בדיבור.
- מגדירים את גרסת הבדיקה כך ש
applicationIdתהיה זהה לחלוטין לקובץ APK או AAB שהועלה ל-Google Play Console. הערה: מאפיינים אופציונלייםapplicationIdSuffixיכולים לשנות אתapplicationIdהסופי של גרסאות מסוימות של מוצרים ושל וריאציות של גרסאות. בדוגמה הזו, הערךapplicationIdשל טעם המוצר המדומה הואcom.example.android.architecture.blueprints.master.mock, במקוםcom.example.android.architecture.blueprints. - מגדירים את התצוגה המקדימה כך שתשתמש בשם הפעלה ייחודי. כדאי לנסות להשתמש במילה ייחודית שמקטינה את הסיכוי להתנגשות עם אפליקציות אחרות.
- כדי לבודד בעיות כשמנסים לפתור בעיות בבסיס קוד שאפשר לשתף, כדאי להריץ את אפליקציית הכושר לדוגמה של פעולות באפליקציה. חשוב לוודא שאפליקציית הכושר פועלת מקצה לקצה. לאחר מכן, מוסיפים בהדרגה תכונות נוספות לאפליקציה כדי לבדוק אם אפשר לשחזר את הבעיות.
- אם אתם משתמשים בחשבונות G Suite, ודאו ש-Google Assistant מופעלת על ידי האדמין. מומלץ ליצור חשבון בדיקה שאינו חשבון G Suite כפתרון עקיף, ולהגדיר אותו כבודק עם רישיון דרך חנות Play. מהחשבון הזה, הבודקים אמורים להיות מסוגלים ליצור תצוגות מקדימות של האפליקציה שלהם ולבדוק באמצעות החשבון הזה במכשיר שלהם בהצלחה.
- אם הורדתם את Google Assistant כאפליקציה נפרדת, נסו לסגור אותה בכוח במכשיר. בדרך כלל ניתן לסגור ידנית אפליקציה דרך אפליקציית ההגדרות של הטלפון.
- אם אף אחת מהפעולות האלה לא פותרת את הבעיה, אפשר לדווח על בעיה בכלי למעקב אחר בעיות בפעולות באפליקציות.