איך יוצרים ומנהלים אפליקציות מקושרות באמצעות AppFunctions ו-Android MCP ב-Google Connected Console

אתם יכולים להשתמש ב-Google Connected Console כדי לשלב את AppFunctions במכשיר של אפליקציית Android עם Gemini ב-Android. כשיוצרים אפליקציה מקושרת עם סוג החיבור Android MCP ומקשרים אותה לאפליקציה ב-Play, מאפשרים ל-Gemini ב-Android להפעיל פעולות ולהשלים משימות ישירות באפליקציה בשם המשתמשים.

המדריך הזה מסביר את תהליך העבודה בשירות עצמי מקצה לקצה ב-Google Connected Console, כולל יצירת אפליקציה מקושרת, קישור אפליקציה ל-Play, הגדרת כרטיס אפליקציה ציבורי, העלאה ושליחה של App Bundle, בדיקת גרסת טרום-השקה (Preview) במכשיר ופרסום בסביבת הייצור.

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

דרישות מוקדמות

לפני שמתחילים, חשוב לוודא שהתנאים הבאים מתקיימים:

• גישה לחשבון פיתוח רשום ב-Google Connected Console:
  • אישור התנאים וההגבלות: בפעם הראשונה שהארגון שלכם ניגש לאפליקציות מקושרות ב-Google Connected Console, בעל החשבון או אדמין צריך לבדוק ולאשר את התנאים וההגבלות של האפליקציות המקושרות לפני שחברי הצוות יוכלו ליצור אפליקציות מקושרות.
  • הרשאות משתמש: אם הוזמנתם לחשבון פיתוח קיים ב-Connected Console אבל אתם לא יכולים ליצור אפליקציות מקושרות, בקשו מבעל החשבון או מהאדמין לתת לכם את ההרשאה הצגת אפליקציות מקושרות או יצירה וניהול של אפליקציות מקושרות בדף משתמשים והרשאות. כדי להעלות חבילות של אפליקציות ולנהל גרסאות, אתם צריכים גם הרשאות לניהול גרסאות באפליקציה הרלוונטית ב-Play.
• אפליקציה קיימת ב-Play בחשבון Google Connected Console:
  • האפליקציה ב-Play צריכה להיות קיימת באותו חשבון פיתוח כדי שתוכלו לקשר אותה לאפליקציה המקושרת. אפשר לקשר כל אפליקציה ב-Play רק לאפליקציה מקושרת אחת ב-Android MCP.
  • מוודאים שבאפליקציה ב-Play מוגדר דף אפליקציה בחנות כברירת מחדל, עם סמל אפליקציה ושפות נתמכות. השפות בדף האפליקציה בחנות Play והמדינות שהגדרתם לטירגוט קובעות איפה האפליקציה המקושרת ל-MCP ב-Android תהיה זמינה.
• קובץ Android App Bundle (.aab) עם AppFunctions מוטמעות:
  • מגדירים את ה-App Bundle כך שיהיה מטורגט למכשירים ניידים עם Android, שהיא הפלטפורמה הנתמכת לשילוב של אפליקציית Gemini במכשיר.
• קטגוריית האפליקציה המקושרת ומטא-נתונים שגלויים לכולם: מכינים את הנכסים והפרטים שמרכיבים את הנוכחות הציבורית של האפליקציה המקושרת:
  • קטגוריית האפליקציה המקושרת: הדומיין או קטגוריית הענף של האפליקציה המקושרת. כל קטגוריה מגדירה דרישות בסיסיות ליכולות, ואי אפשר לשנות אותה אחרי שיוצרים אותה.
  • שם האפליקציה: השם של האפליקציה המקושרת שמוצג למשתמשים במוצרי Google, ומשמש כשהמשתמשים מתייגים את האפליקציה באמצעות @ ב-Gemini.
  • סמל האפליקציה המקושרת: סמל אפליקציה בגודל 512 פיקסלים על 512 פיקסלים בפורמט JPEG או PNG, ובגודל קובץ מקסימלי של 1MB‏ (1,024KB).
  • תיאור האפליקציה: סיכום תמציתי של הפעולות שהאפליקציה המקושרת יכולה לבצע בשביל המשתמשים.
  • יכולות האפליקציה: לפחות שלוש יכולות מותאמות אישית שמראות למשתמשים מה האפליקציה יכולה לעשות כשהם מחליטים אם לקשר אותה, בנוסף ליכולות ברירת המחדל שמוגדרות לפי קטגוריית האפליקציה.
  • דוגמאות להנחיות: לפחות שלוש דוגמאות להנחיות שמלמדות את המשתמשים איך להפעיל את האפליקציה ב-Gemini, ועוזרות להם להבין מה הם יכולים לבקש.
  • כתובת ה-URL של המדיניות: כתובת URL שדרכה הציבור יכול לגשת למדיניות הפרטיות שלכם.
  • כתובת ה-URL של התנאים וההגבלות: כתובת URL שנגישה לכולם ומובילה לתנאים ולהגבלות שלכם.
  • כתובת אתר (אופציונלי): כתובת URL שנגישה לכולם ומפנה לאתר שלכם לצורך שיוך (Attribution).

איך רושמים, בודקים ומפרסמים פונקציות של אפליקציות ב-Gemini

אחרי שתעמדו בדרישות המוקדמות, בצעו את השלבים הבאים כדי לרשום את האפליקציה המקושרת של Android MCP, לקשר את האפליקציה ב-Play, למלא את פרטי האפליקציה, להעלות ולשלוח את ה-AppFunctions, לבדוק במכשיר ולפרסם בסביבת הייצור.

שלב 1: יוצרים אפליקציה מקושרת ל-MCP ל-Android ומקשרים אותה לאפליקציה ב-Play

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

1. נכנסים אל Google Connected Console.
2. בדף הבית, לוחצים על יצירת אפליקציה.
3. בתיבת הדו-שיח בחירת מה שרוצים ליצור:
   • אם מתבקשים לאשר את התנאים וההגבלות של אפליקציות מקושרות, לוחצים על הצגת התנאים, קוראים ומאשרים את ההסכם ואז לוחצים על יצירה. רק אדמין בחשבון יכול לאשר את ההסכם.
   • אם לא, לוחצים על יצירה בכרטיס אפליקציה מקושרת.
4. בתיבת הדו-שיח Give your connected app a name, מקלידים שם לאפליקציה המקושרת. זה השם שיוצג למשתמשים במוצרי Google, והם יקלידו אותו אחרי @ כדי לתייג את האפליקציה. לוחצים על הבא.

5. בתיבת הדו-שיח בחירת קטגוריית אפליקציות מקושרות, בוחרים את הדומיין, הקטגוריה או התחום של האפליקציה בתפריט בחירת קטגוריה.

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

6. בתיבת הדו-שיח בחירת סוג החיבור, בוחרים באפשרות Android MCP.

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

7. לוחצים על Create connected app (יצירת אפליקציה מקושרת).

8. בתיבת הדו-שיח Select app, מוצאים את האפליקציה ב-Play שמכילה (או תכיל) את ה-AppFunctions ובוחרים בה. אפשר לסנן את הרשימה באמצעות החיפוש.

   • אי אפשר לבחור אפליקציות ב-Play שכבר מקושרות לאפליקציה מקושרת אחרת.
   • חשוב לבחור את האפליקציה הנכונה ב-Play שרוצים לקשר. אחרי שבוחרים אפליקציה ב-Play, אי אפשר לשנות את הבחירה.

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

שלב 2: הוספת פרטי האפליקציה המקושרת

לפני שמעלים חבילות אפליקציה שמכילות AppFunctions, צריך להגדיר איך האפליקציה המקושרת תופיע למשתמשים ב-Gemini.

חשוב: לפני שמעלים App Bundle שמכיל AppFunctions, צריך למלא ולשמור את פרטי האפליקציה המקושרת. ‫Google Connected Console יוצרת גרסת Android MCP מ-App Bundle שהועלה רק אם כבר סיפקתם את הפרטים הנדרשים של האפליקציה המקושרת. אם מעלים את ה-App Bundle לפני שמספקים את הפרטים האלה, צריך קודם להשלים את פרטי האפליקציה ואז למחוק ולהעלות מחדש את ה-App Bundle, או להעלות App Bundle חדש עם קוד גרסה גבוה יותר.

כדי לספק את פרטי האפליקציה המקושרת:

1. בדף הניהול של האפליקציה המקושרת, בכרטיס Android MCP, בקטע הוספת פרטים של אפליקציה מקושרת, לוחצים על הוספת פרטי האפליקציה (או על ניהול אם מעדכנים פרטים קיימים).
2. בחלק העליון של הדף פרטי האפליקציה, בודקים את השדה Connected app name. אם צריך, אפשר לעדכן את השם. השם הזה מוצג למשתמשים במוצרי Google, והם משתמשים בו כדי לתייג את האפליקציה באמצעות @.
3. בקטע פרטים שגלויים לכולם, בקטע סמל, מעלים את סמל האפליקציה (בפורמט JPG או PNG, בגודל של עד 1MB ובמידות של ‎512 x 512 פיקסלים).

4. ממלאים את השדות הבאים:

   • תיאור: מזינים סיכום תמציתי במשפט אחד (עד 30 מילים) שמתאר את התכונות העיקריות של האפליקציה המקושרת ואת מה שהיא יכולה לעשות. הטקסט הזה מוצג למשתמשים, ולא משמש כהוראות למודל.
   • יכולות: מזינים לפחות שלוש משימות חשובות שהאפליקציה המקושרת יכולה לבצע. כדי להוסיף עוד רשומות, לוחצים על Add capability. אל תכללו מספרים בתחילת היכולות. צריך לכלול רק יכולת אחת בכל רשומה. אם קטגוריית האפליקציה המקושרת כוללת יכולות מוגדרות מראש, הן מופיעות בראש הרשימה ואי אפשר לשנות אותן.
   • הנחיות לדוגמה: הזינו לפחות שלוש הנחיות לדוגמה שיעזרו למשתמשים להבין מה הם יכולים לשאול. לוחצים על הוספת פרומפט לדוגמה כדי להוסיף רשומות.
     • מתחילים לפחות שתי הנחיות ב-@<YourAppName> (לדוגמה, @Order Tracker where is my last order?).
     • תייגו את <YourAppName> באופן טבעי בפרומפט אחד לפחות בלי להתחיל עם שם האפליקציה (לדוגמה, Track my recent order on Order Tracker).
     • אל תכללו קידומות ממוספרות (1., 2., 3.) ואל תעטפו הנחיות במירכאות ("...").

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

     <en-US>
     Play music, manage playlists, and discover artists
     </en-US>
     <es-ES>
     Reproduce música, gestiona listas y descubre artistas
     </es-ES>
     

     ‫Connected Console מאמתת את התגים באופן אוטומטי ומציגה את הלוקאלים שזוהו מתחת לכל שדה (לדוגמה, Found translations for 2 languages: en-US, es-ES).

   • כתובת ה-URL של התנאים וההגבלות: מזינים קישור תקין מסוג https:// או http:// לתנאים ולהגבלות.

   • כתובת ה-URL של המדיניות: מזינים קישור תקין מסוג https:// או http:// למדיניות הפרטיות.

   • כתובת האתר (אופציונלי): מזינים קישור לאתר שלכם למטרות שיוך.

שלב 3: מעלים קובץ App Bundle שמכיל את AppFunctions ושולחים את האפליקציה המקושרת

אחרי ששומרים את פרטי האפליקציה המקושרת, מעלים קובץ Android App Bundle שמכיל את פונקציות האפליקציה לאפליקציה המקושרת ב-Play, ושולחים את גרסת האפליקציה המקושרת לבדיקה.

כדי להעלות App Bundle שמכיל את הפונקציות של האפליקציה:

1. בדף הניהול של האפליקציה המקושרת, בכרטיס Android MCP, בקטע העלאת App Bundle שמכיל את הפונקציות של האפליקציה, לוחצים על העלאת App Bundle כדי לעבור לסקירה הכללית של בדיקה ופרסום באפליקציית Play המקושרת.
2. אפשר גם לפתוח את אפליקציית Play המקושרת ישירות ב-Google Connected Console. בתפריט הניווט הימני של האפליקציה ב-Play, עוברים אל בדיקה > בדיקה פנימית (או מסלול בדיקה אחר) ובוחרים באפשרות יצירת גרסה חדשה (או עריכת הגרסה אם כבר יש לכם גרסת טיוטה).
3. בקטע חבילות של אפליקציות, לוחצים על העלאה כדי להעלות את החבילה של .aab עם AppFunctions, או על הוספה מהספרייה אם העליתם את החבילה אחרי שסיימתם את שלב 2.
4. בסיום ההעלאה, עוברים לקטע זוהו תכונות אפליקציה בקובץ ה-AAB שלך בדף הגרסה. מוודאים ששם האפליקציה המקושרת, קוד הגרסה של ה-bundle, מספר הכלים שזוהו, מספר השפות והטירגוט למדינות של האפליקציה ב-Play מופיעים כמו שצריך, ומוודאים שבבדיקות האוטומטיות לא דווח על בעיות. (אם מופיעות שגיאות אימות, פועלים לפי ההוראות במאמר פתרון בעיות שקשורות ל-AppFunctions לפני שממשיכים).
5. בתחתית דף הגרסה, לוחצים על שליחת האפליקציה המקושרת והמשך.

כשבוחרים באפשרות שליחת האפליקציה המקושרת והמשך, גרסת AppFunctions נשלחת אל Gemini לבדיקת גרסת טרום-השקה (Preview), והגרסה ב-Play מתקדמת לדף של גרסת טרום-ההשקה. אם אתם רוצים לבצע איטרציה של AppFunctions באמצעות גרסאות build מקומיות בלי להגדיל את קוד הגרסה של ה-App Bundle, השאירו את הגרסה ב-Play במצב טיוטה ואל תבחרו באפשרות שמירה ופרסום. כשמפרסמים גרסה ב-Play, קוד הגרסה של ה-App Bundle ננעל, ואי אפשר למחוק ולהעלות אותו מחדש. כל שינוי שתבצעו אחר כך יחייב קוד גרסה מורחב של ה-App Bundle. (אם הבודקים מתקינים את האפליקציה ישירות ממסלול הבדיקה הפנימית של Google Play ולא באמצעות התקנה ממקור לא ידוע, צריך להשלים את ההשקה של הבדיקה הפנימית ולהגדיל את קוד הגרסה בהעלאות עתידיות).

שלב 4: בודקים את גרסת האפליקציה המקושרת

אחרי ששולחים את האפליקציה המקושרת מדף הפרסום ב-Play, מוודאים שגרסת האפליקציה המקושרת מוכנה לגרסת טרום-השקה (Preview):

1. בדף הניהול של האפליקציה המקושרת, בכרטיס Android MCP, לצד גרסאות, לוחצים על הצגה.
2. בדף Versions, מוודאים שהגרסה ששלחתם מופיעה בקטע Available to testers (מוצג Version <N> • Submitted <Date> • Using AppFunctions from app bundle <versionCode>).
   • לוחצים על הצגה בשורה של גרסה כלשהי כדי לבדוק את ה-AppFunctions שזוהו ואת תמונת המצב לקריאה בלבד של פרטי האפליקציה שצולמה בגרסה הזו.
   • גרסאות שנוצרו מקובץ App Bundle שהועלה, שבהן עדיין לא בחרתם באפשרות שליחת האפליקציה המקושרת והמשך, מופיעות בקטע בהמתנה לשליחה.

שלב 5: בודקים את האפליקציה המקושרת

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

1. בדף הסקירה הכללית של האפליקציה המקושרת, בכרטיס בדיקת האפליקציה, לוחצים על הוספת בודקים (או על ניהול הבודקים אם כבר הוספתם בודקים).
2. בדף ניהול הבודקים, בוחרים רשימות אימייל קיימות או לוחצים על יצירת רשימת אימייל כדי להוסיף את חשבונות Google שמורשים לבדוק את השילוב. כדי לבדוק את האפליקציה בעצמך, צריך להוסיף את כתובת האימייל שלך.

3. לוחצים על שמירה.

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

4. כדי להפעיל את האפליקציה המקושרת, הבודקים באפליקציית Gemini יכולים להקליד @, ואז את שם האפליקציה המקושרת ולבחור אותה מהתפריט. אתם יכולים גם לראות את האפליקציה ולקשר אותה ב-Gemini: בסרגל הניווט הימני, עוברים אל הגדרות ועזרה > אפליקציות מקושרות.

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

• נכנסים לטלפון נייד או לטאבלט עם Android באמצעות חשבון Google שכלול ברשימת כתובות האימייל שהגדרתם בשלב 5.
• מפעילים את ה-build המדויק של אפליקציית Android שקוד הגרסה של ה-bundle שלו תואם לגרסה שנשלחה בשלב 4.

מומלץ לבדוק את השילוב באופן יסודי:

• נסו את כל ההנחיות לדוגמה.
• בודקים גם הפעלות מפורשות של @<AppName> וגם שאילתות בשפה טבעית.
• בודקים את הטיפול בפרמטרים של הכלים, את בקשות האישור ואת הביצוע מקצה לקצה בכל ה-AppFunctions.

הערה: אתם יכולים גם לנפות באגים באפליקציה המקושרת במצב פיתוח ב-Gemini. במצב הזה אתם יכולים לבדוק באופן אינטראקטיבי את שרת Model Context Protocol‏ (MCP), לאבחן שגיאות סכימה או שגיאות זמן ריצה, ולמדוד את איכות הכלי לפני שאתם שולחים את האפליקציה המקושרת לבדיקה ב-Google Connected Console. מוודאים שאתם מחוברים לחשבון ב-Gemini.

אחרי שסיימתם את הבדיקה, אתם יכולים לשלוח את האפליקציה המקושרת ל-Google לבדיקה.

שלב 6: פרסום האפליקציה המקושרת למשתמשים

בניגוד לשילובי MCP שמתארחים בשרת, אפליקציה מקושרת של Android MCP לא דורשת בדיקה או פעולת פרסום נפרדת בדף ניהול האפליקציות המקושרות. במקום זאת, Google בודקת את גרסת האפליקציה המקושרת ומפרסמת אותה באופן אוטומטי כשמפרסמים בסביבת הייצור את גרסת האפליקציה ב-Play שמכילה את App Bundle של AppFunctions.

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

1. ב-Google Connected Console, פותחים את אפליקציית Play המקושרת ועוברים אל גרסה > מסלול לסביבת הייצור בתפריט הניווט הימני (או מקדמים את הגרסה שנבדקה ממסלול הפצה לבדיקה אל מסלול לסביבת הייצור).
2. בוחרים באפשרות יצירת גרסה חדשה (או עורכים טיוטה קיימת של גרסת ייצור) ומוסיפים את קובץ ה-AAB שמכיל את פונקציות האפליקציה המאומתות באמצעות הוספה מהספרייה או העלאה.
3. עוברים לקטע זוהו תכונות אפליקציה בקובץ ה-AAB שלך כדי לאשר את גרסת האפליקציה המקושרת, מספר הכלים, מספר השפות בדף האפליקציה בחנות והטירגוט לפי מדינה של האפליקציה ב-Play, ומוודאים שהבדיקות האוטומטיות לא מציגות בעיות שחוסמות את הפרסום.
4. לוחצים על שליחת האפליקציה המקושרת והמשך, ממלאים את פרטי הגרסה ושולחים את גרסת הייצור של האפליקציה ב-Play לבדיקה ולהשקה.

הערה: Google בודקת את האפליקציות המקושרות במקביל לבדיקת הגרסה של האפליקציה ב-Play, מה שעלול להאריך את משך הבדיקה של האפליקציה ב-Play. עד שגרסת הייצור תאושר ותושק, השילוב של האפליקציה המקושרת יהיה גלוי רק לבודקים שהוגדרו באפליקציה המקושרת.

אחרי שגרסת הייצור של האפליקציה ב-Play תאושר ותושק:

• האפליקציה המקושרת ל-MCP ב-Android תהיה זמינה ב-Gemini ב-Android למשתמשים במדינות ובשפות שהאפליקציה ב-Play מטרגטת.
• בדף הניהול של האפליקציה המקושרת (אפליקציות מקושרות > ניהול), הכרטיס סטטוס האפליקציה המקושרת מתעדכן לסטטוס פורסמה, ומוצגים בו קוד הגרסה של ה-App Bundle הפעיל ותאריך הוצאה לאור. הגרסה מופיעה בקטע פורסמה בדף גרסאות.
• כדי להשיק כלים מעודכנים של AppFunctions בשלב מאוחר יותר, צריך ליצור קובץ App Bundle חדש עם קוד גרסה מעודכן, לבדוק אותו באמצעות מסלול בדיקה ולפרסם גרסה חדשה של Play בסביבת הייצור. אם אתם רוצים לעדכן גם את המטא-נתונים הציבוריים של האפליקציה המקושרת (כמו יכולות או הנחיות לדוגמה), שמרו את השינויים האלה בקטע אפליקציות מקושרות > ניהול > פרטי האפליקציה לפני שאתם מעלים את ה-App Bundle החדש.

עדכון של ה-App Bundle כדי לשנות את AppFunctions

אם אתם רוצים לבצע שינויים ב-AppFunctions במהלך בדיקה פנימית בלי להגדיל את קוד הגרסה של אפליקציית Android, אתם יכולים להסיר ולמחוק חבילת App Bundle שלא פורסמה לפני שתעלו אותה מחדש:

1. מעדכנים את ההטמעה של AppFunctions בפרויקט Android ויוצרים קובץ App Bundle חדש של .aab.
2. מסירים את קובץ ה-App Bundle הקודם מכל גרסת טיוטה שאליה הוספתם אותו:
   1. פותחים את האפליקציה המקושרת ל-Play ב-Google Connected Console ובוחרים באפשרות בדיקה פנימית (או במסלול שמכיל את גרסת הטיוטה) בתפריט הניווט הימני.
   2. בגרסת הטיוטה, לוחצים על עריכת הגרסה.
   3. מאתרים את ה-App Bundle, לוחצים על סמל האפשרויות הנוספות (⋮) ובוחרים באפשרות הסרת ה-App Bundle.
   4. לוחצים על שמירה כטיוטה.
3. מוחקים את קובץ ה-App Bundle שלא בשימוש מהספרייה:
   1. בתפריט הניווט הימני של האפליקציה ב-Play, בוחרים באפשרות הגרסאות והחבילות האחרונות (אם החבילה לא מופיעה ברשימה, בוחרים באפשרות הצגת כל חבילות ה-App Bundle).
   2. פותחים את הפרטים של ה-App Bundle, ואם הלחצן מחיקת App Bundle זמין, לוחצים על מחיקת App Bundle. כך קוד הגרסה מתפנה ואפשר להעלות את ה-App Bundle המעודכן בלי להגדיל את קוד הגרסה.
4. אם האפשרות מחיקת קובץ App Bundle לא זמינה (לדוגמה, כי הגרסה כבר פורסמה במסלול), מגדילים את הערך של versionCode בתצורת ה-build של האפליקציה, יוצרים קובץ App Bundle חדש, מעלים את הגרסה החדשה ושולחים אותה כמו שמתואר בשלב 4.

פתרון בעיות שקשורות ל-AppFunctions

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

פתרון שגיאות בבדיקות אוטומטיות של גרסה

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

אם הבדיקות האוטומטיות מדווחות על בעיות ב-App Bundle, צריך לבצע את הפעולות הבאות:

1. מתקנים את הבעיות הבסיסיות ב-AppFunctions בקוד של אפליקציית Android ויוצרים קובץ App Bundle מעודכן.
2. אם הגרסה הקודמת עדיין במצב טיוטה ואתם רוצים להשתמש שוב באותו קוד גרסה:
   1. בתפריט הניווט הימני באפליקציית Play, לוחצים על בדיקה פנימית (או על המסלול הרלוונטי) ואז על עריכת הגרסה בגרסת הטיוטה.
   2. לוחצים על סמל האפשרויות הנוספות (⋮) לצד ה-App Bundle ובוחרים באפשרות הסרת ה-App Bundle.
   3. לוחצים על שמירה כטיוטה.
   4. בתפריט הניווט הימני, בוחרים באפשרות הגרסאות והחבילות האחרונות (אם צריך, בוחרים באפשרות הצגת כל חבילות ה-App Bundle), בוחרים את החבילה ולוחצים על מחיקת חבילת ה-App Bundle.
   5. חוזרים לטיוטת הגרסה, מעלים את ה-App Bundle המתוקן ולוחצים על שליחת האפליקציה המקושרת והמשך.
3. אם אי אפשר למחוק את חבילת ה-App Bundle הקודמת, מגדילים את הערך של versionCode בחבילת ה-App Bundle, מעלים את החבילה החדשה לגרסה ובוחרים באפשרות שליחת האפליקציה המקושרת והמשך.

בעיות נפוצות בהגדרה ובשילוב

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

בעיה	הודעה במסוף או תסמין	הסיבה	רזולוציה
העליתם App Bundle לפני שיצרתם או קישרתם אפליקציה מקושרת	בדף הגרסה מופיעה האפשרות יצירה או קישור של אפליקציה מקושרת.	הקובץ .aab שהעלית מכיל AppFunctions, אבל האפליקציה ב-Play עדיין לא מקושרת לאפליקציה שמחוברת ל-Android MCP.	מבצעים את שלב 1 עד שלב 3 כדי ליצור אפליקציה מקושרת, בוחרים באפשרות Android MCP, מקשרים את האפליקציה ב-Play ושומרים את פרטי האפליקציה. לאחר מכן, צריך למחוק את ה-App Bundle ולהעלות אותו מחדש, או להעלות App Bundle חדש עם versionCode מוגדל.
העלאת ה-App Bundle לפני שמירת פרטי האפליקציה המקושרת	בדף הגרסה מופיעה ההודעה נדרשים פרטי האפליקציה המקושרת והכפתור הוספת פרטי האפליקציה המקושרת.	האפליקציה ב-Play מקושרת לאפליקציה מקושרת של MCP ל-Android, אבל שדות חובה בדף פרטי האפליקציה לא נשמרו לפני שה-bundle הועלה.	בוחרים באפשרות הוספת פרטי האפליקציה המקושרת (או עוברים אל אפליקציות מקושרות > ניהול > הוספת פרטי האפליקציה), ממלאים את כל שדות החובה ושומרים את השינויים. לאחר מכן מוחקים את ה-bundle ומעלים אותו מחדש, או מעלים bundle חדש עם versionCode גבוה יותר.
אי אפשר לבחור אפליקציה ב-Play כשמבצעים קישור	האפליקציה ב-Play שרוצים לקשר מציגה את התג כבר מקושרת או לא מופיעה בתיבת הדו-שיח בחירת אפליקציה.	אפשר לקשר כל אפליקציה ב-Play רק לאפליקציה מקושרת אחת ב-Android MCP, או שהאפליקציה ב-Play עדיין לא נוצרה בחשבון הפיתוח הזה.	בודקים את הרשומות הקיימות בקטע אפליקציות מקושרות כדי לראות אם אפליקציה מקושרת אחרת כבר מקשרת לאפליקציה ב-Play, או יוצרים את האפליקציה ב-Google Play Console לפני שמקשרים אותה.
לא ניתן ליצור אפליקציה מקושרת	האפשרות ליצור אפליקציה מקושרת לא קיימת, או שמוצגת אזהרה לגבי הרשאות או התנאים וההגבלות כשמנסים ליצור אפליקציה מקושרת.	לחשבון המשתמש שלכם אין הרשאות שניתנות לאפליקציה מקושרת, או שבעל החשבון או אדמין עדיין לא אישרו את התנאים וההגבלות של אפליקציות מקושרות.	מבקשים מבעל החשבון או מהאדמין לאשר את התנאים וההגבלות של אפליקציות מקושרות ולתת לחשבון שלכם הרשאה להצגת אפליקציות מקושרות או ליצירה וניהול של אפליקציות מקושרות בדף משתמשים והרשאות.
גרסת האפליקציה המקושרת תקועה בסטטוס "בהמתנה לשליחה"	בקטע אפליקציות מקושרות > ניהול > גרסאות, גרסת ה-bundle מופיעה בקטע בהמתנה לשליחה במקום בקטע זמינה לבודקים.	מערכת Google Connected Console זיהתה AppFunctions בחבילה שהעלית, אבל גרסת האפליקציה המקושרת לא נשלחה מדף הגרסה.	פותחים את גרסת האפליקציה ב-Play שמכילה את ה-bundle הזה ולוחצים על שליחת האפליקציה המקושרת והמשך כדי שהבודקים יוכלו לנסות את גרסת טרום-ההשקה שלה.
דוגמה להודעה על שגיאת אימות בדף פרטי האפליקציה	אי אפשר לשמור את הטופס כרטיס אפליקציה שגלוי לכולם ומוצגת שגיאה בקטע הנחיות לדוגמה.	ההנחיות לא עומדות בכללי הפורמט או האזכור, או ששם האפליקציה נערך אחרי כתיבת ההנחיות.	צריך לספק שלוש עד ארבע הנחיות בסך הכול: לפחות שתיים מהן צריכות להתחיל ב-@<YourAppName>, לפחות באחת מהן צריך להזכיר את <YourAppName> באופן טבעי בלי @, ולהסיר קידומות ממוספרות (1., 2.) או מירכאות מסביב ("...").
האפליקציה המקושרת לא גלויה לבודקים ב-Gemini ב-Android	הבודקים לא יכולים למצוא את האפליקציה המקושרת בקטע אפליקציות מקושרות או באמצעות תיוג @ באפליקציית Gemini ל-Android.	תהליך ההפצה עדיין נמשך, חשבון הבודק לא עומד בדרישות או שגרסת האפליקציה המותקנת לא תואמת.	צריך להמתין כ-20 דקות אחרי השליחה (ועד 10 דקות אחרי שמירת הבודקים). צריך לוודא שהבודק משתמש בחשבון @gmail.com אישי שמופיע ברשימת כתובות האימייל השמורות, משתמש בטלפון או בטאבלט עם Android והתקין את הגרסה המדויקת של ה-bundle שנשלח.