פתרון בעיות

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

כללי

שגיאה: "לא נמצאה אפליקציה לפתיחת כתובת ה-URL" מופיעה בהודעה הודעה לכיתה

עליך לבדוק את מילוי ההזמנה urlTemplate בactions.xml כדי לוודא שהוא מוגדר כראוי. אם אתם משתמשים בכתובות URL של קישורים לאפליקציה, ודאו שאתם יכולים להפעיל את כתובת ה-URL באופן ידני באמצעות ACTION_VIEW ואת כתובת ה-URL. אם אתם משתמשים בכתובות URL שמבוססות על כוונת רכישה, חשוב לוודא הפעילות מוגדרת כראוי להתחיל להשתמש בפרמטרים שסופקו.

שגיאה: "האפליקציה לא מותקנת"

המשמעות של השגיאה הזו יכולה להיות שה-<intent-filter> ב-AndroidManifest.xml לא מסנן קישור העומק שציינת בactions.xml. חשוב לבדוק את המידע הזה לפני שאתם שולחים דיווח על באג.

שגיאה: "נמצאה הפניה לקבוצת ישויות שלא מכילה מזהה קבוצת ישויות או מסנן של כתובת URL". מופיעה ב-Android Studio

המצב הזה נגרם כתוצאה מבעיית איתור לא ידועה תג <entity-set-reference>. אפשר להתעלם מההודעה הזו. בתור כדי לעקוף את הבעיה, אפשר להשבית את בדיקת השגיאות בקוד עבור התג הזה על ידי הוספת tools:ignore="ValidActionsXml".

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

<entity-set-reference entitySetId="example" tools:ignore="ValidActionsXml" />

שגיאה: "מיקום לא חוקי" למסמך סכימת פעולות בזמן העלאת APK

אם תשתמשו בכלי אופטימיזציה או בערפול קוד (obfuscation) או בכלי אופטימיזציה, ייתכן שהעלאת ה-APK תיכשל משפיעה על המשאבים ב-APK של הגרסה. כלים כמו ProGuard שמונעים קובצי משאבים לא גורמים לבעיה הזו.

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

שגיאה: "APK פעיל או קובץ Android App Bundle מכילים קובץ actions.xml כדי להמשיך, עליך לאשר את התנאים וההגבלות של Actions on Google." מופיעה ב-Google Play Console

יכול להיות שהשגיאה הזו תוצג לכם במהלך היצירה של גרסת האפליקציה ב-Play Console. שפת תרגום מאשרים את התנאים וההגבלות של Actions on Google ופועלים לפי השלבים הבאים:

1. בוחרים את האפליקציה ב-Play Console.
2. עוברים אל הגדרה > הגדרות מתקדמות
3. לוחצים על הכרטיסייה Actions on Google.
4. מסמנים את התיבה שילוב השירותים שלי עם 'פעולות באפליקציה' באמצעות 'פעולות' ב-Google ופועלים לפי ההוראות.

"אישור" הלחצן בטופס התנאים וההגבלות של Play מושבת.

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

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

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

הפלאגין של כלי הבדיקה של פעולות באפליקציה לא מצליח לאתר את קובץ ה-actions.xml שלי.

חשוב לוודא שהוספת את תג <meta-data> הנכון קובץ AndroidManifest.xml.

התצוגה המקדימה של 'הפעולה באפליקציה שלי' לא תואמת לקובץ actions.xml הנוכחי שלי.

התצוגה המקדימה שלך לא מתעדכנת באופן דינמי עם התוכן של קובץ actions.xml. אחרי שמשנים את הקובץ actions.xml באופן ידני או אחרי כן להחליף וריאציות של גרסת build ב-Android Studio, לשמור את קובץ actions.xml ואז לוחצים על עדכון תצוגה מקדימה בכלי הבדיקה.

הפלאגין של כלי הבדיקה של 'פעולות באפליקציה' הפסיק לפעול או שהוא מייצר שגיאות.

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

אם השגיאה נמשכת, יש לדווח על באג ולשלוח את הפרטים הבאים פרטים ל-Google:

• פרטים על תיבת הדו-שיח של השגיאה
• היומנים של Android Studio. עוברים אל עזרה > הצגת Log in Finder. כאן רואים המיקום של idea.log ב-Finder. מחפשים את האפשרות 'שליחת פעולות גוף הבקשה:" בקובץ היומן, ומדביקים את תגובות השרת ( אמורות להיות שתי תוצאות לפעולות).

כלי הבדיקה של 'פעולות באפליקציה' יוצר UnknownHostException או שגיאות רשת אחרות

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

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

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

• אם החיבור לאינטרנט פעיל והרשת המקומית משתמשת בשרת proxy השרת, צריך לבדוק את הדברים הבאים:

  • יש לאמת את ההגדרה של שרת ה-proxy ל-IDE. למידע נוסף, ראו proxy הוראות להגדרה ב-Android Studio או ב-IntelliJ.
  • אם שרת ה-proxy דורש רשימה של בקרת גישה (ACL), מעדכנים את ה-ACL כדי אישור של תבנית ה-URL הבאה: https://actions.googleapis.com/**.

כשמפעילים את פעולת האפליקציה באמצעות פלאגין הבדיקה, Assistant אומרת "מצטערים, לא מצאתי את זה".

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

1. נכנסים אל Android Studio, אל Play Console, מכשיר בדיקה עם אותו חשבון Google.
2. מפעילים את האפשרות סנכרון נתוני המכשיר.
3. מגדירים את השפה במכשיר וב-Google Assistant לen-US.
4. צריך לבדוק ששם החבילה של האפליקציה Google Play Console תואם לשם החבילה באפליקציית הבדיקה.
5. בהגדרת urlTemplate של מילוי ההזמנות בקובץ actions.xml שלך, צריך לוודא שהערכים android:host ו-android:scheme תואמים הוצהרה בקובץ AndroidManifest.
6. מסירים את כל ההתקנות הקודמות של האפליקציה ממכשיר הבדיקה וגם מתקינים build רענן.
7. צריך למחוק את התצוגה המקדימה מכלי הבדיקה של 'פעולות באפליקציה' וליצור שוב תצוגה מקדימה חדשה.
8. בדיקה בכלי ה-Logcat אם יש כשלים שקשורים למילוי ההזמנות של Google Assistant. אמורה להופיע Intent לאפליקציה שלכם.
9. הפעלת האפשרות 'פרטי אפליקציות מהמכשירים שלך' הגדרה לחשבון.
10. פותחים את Google Assistant ומוודאים שהשלמתם את ההגדרה. (בדרך כלל ההגדרה סרגל ההתקדמות יופיע כפס כחול בתחתית המסך, אבל במקרים מסוימים הוא עשוי להיראות שונה).
11. כשמשתמשים ב-Google Assistant כדי להפעיל פעולה באפליקציה, צריך לוודא שם ההפעלה תואם לתצוגה המקדימה שנוצרה על ידי כלי הבדיקה של פעולות באפליקציה.
12. כדי להימנע משגיאות תמלול, כדאי להשתמש בקלט טקסט במקום בקול.
13. צריך להגדיר את ה-build לבדיקה כך שה-applicationId יהיה תואם בדיוק ה-APK או ה-AAB הועלו ל-Google Play Console. שימו לב שאופציונלי הנכסים של applicationIdSuffix יכולים לשנות את הערך הסופי של applicationId מבוסס על טעמים מסוימים של מוצרים ויוצרים וריאציות. בדוגמה הזאת, applicationId לטעם של מוצר לדוגמה הוא com.example.android.architecture.blueprints.master.mock, במקום com.example.android.architecture.blueprints
14. מגדירים את התצוגה המקדימה לשימוש בשם הפעלה ייחודי. כדאי לנסות להשתמש שמפחיתה את הסיכויים להתנגשות עם אפליקציות אחרות.
15. כדי לבודד בעיות במהלך פתרון בעיות עם Codebase שניתן לשתף, אפשר לנסות להריץ את הפקודה דוגמה לאפליקציה לכושר – App Actions. חשוב לוודא שאפליקציית 'כושר' פועלת מקצה לקצה. ואז להוסיף בהדרגה תכונות נוספות באפליקציה הזו, כדי לבדוק אם אפשר לשחזר בעיות.
16. אם אתם משתמשים בחשבונות G Suite, עליכם לוודא ש-Google Assistant מופעלת על ידי אדמין. מומלץ ליצור חשבון בדיקה שאינו של G Suite כפתרון עקיף ולהגדיר אותו בודק מורשה דרך חנות Play. מהחשבון הזה, לבודקים צריכה להיות אפשרות ליצור תצוגות מקדימות לאפליקציה שלהם לבדוק באמצעות החשבון הזה במכשיר שלהם.
17. אם הורדתם את Google Assistant כאפליקציה נפרדת, אפשר לנסות לסגור אותה ידנית במכשיר. בדרך כלל ניתן לסגור ידנית אפליקציה דרך אפליקציית ההגדרות של הטלפון.
18. אם אף אחת מהפעולות האלה לא פותרת את הבעיה, צריך לדווח על בעיה מעקב אחר בעיות בפעולות באפליקציה