פתרון בעיות בהפצת אפליקציות & שאלות נפוצות

לא ניתן להפיץ אפליקציה עקב אימייל ליצירת קשר חסר

בעת העלאת אפליקציה, אתה עלול להיתקל בשגיאה זו:

"לא הצלחנו למצוא כתובת אימייל ליצירת קשר עבור האפליקציה <app-id> . בקר בהפצת אפליקציות במסוף Firebase כדי להגדיר אחת."

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

אירעה שגיאה בהקצאת האפליקציה שלך (שגיאות 400, 409 או 500 )

אם אתה נתקל שוב ושוב בשגיאות 400, 409 או 500 במהלך הקצאה, פנה לתמיכה של Firebase . ספק תמיכה עם מספר פרויקט Firebase ומזהה האפליקציה שלך.

לא ניתן להעלות קובץ APK

1. אמת את גודל ה-APK. מגבלת גודל הקובץ המקסימלית עבור כל הקבצים הבינאריים היא 2048 MiB, שהם קצת יותר מ-2 GB.

2. אם גודל ה-APK נמצא במגבלת גודל הקובץ וניתן לשחזור, פנה לתמיכה של Firebase .

לא ניתן להעלות APK עם fastlane. ה-APK לא חתום.

ודא שה-APK חתום באמצעות הפריטים הבאים:

apksigner verify --verbose ~/app-distro/app-distro-apps/[path_name]/app/ build/outputs/apk/debug/app-debug.apk

קבלת שגיאות עם כניסה חברתית/ספקי API של צד שלישי

כאשר אתה מעלה AAB להפצת אפליקציות, Google Play מבטל אוטומטית את ה-APK שנוצר באמצעות אישור מפתח חתימת אפליקציה לבדיקה. כאשר תתבקש, עליך לרשום את האפליקציה שלך אצל ספקי API אם ברצונך להמשיך להשתמש בשירותי הצד השלישי שלהם. לאחר החתימה, ניתן לראות את אישור הבדיקה של האפליקציה שלך במסוף Firebase.

האם AABs שאני מעלה מופיעים גם ב-Google Play?

מבני AAB שאתה מעלה להפצת אפליקציות אינם מופיעים בחשבון המפתח שלך ב-Google Play (זה כולל את סייר ה-App Bundle ושיתוף אפליקציות פנימי).

מה יקרה אם אבטל את הקישור בין Firebase מ-Google Play?

אם הקישור של אפליקציית Firebase ל-Android מ-Google Play מתרחש:

• לא תוכל להעלות חבילות אפליקציות חדשות ל-App Distribution ולייצא אותן ל-Google Play באמצעות שילוב ה-App Distribution עם Google Play.

• מבנים קיימים ימשיכו להיות זמינים במרכז השליטה של ​​Firebase App Distribution ולבודקים שלך.

• כל הנתונים שיוצאו בעבר בין Firebase ל-Google Play יישארו נגישים בשני המוצרים.

האם אני יכול לנסות שוב לקשר אפליקציה ל-Google Play?

כדי להפיץ אנדרואיד App Bundle (AAB) באמצעות הפצת אפליקציות ולקשר אוטומטית AABs שהועלו הן לפרויקט Firebase שלך ​​והן לחשבון המפתח שלך ב-Google Play, ודא שאתה עומד בדרישות הבאות:

• לחשבון המפתח שלך ב-Google Play יש אחת מרמות הגישה הבאות: בעלים או מנהל.

• עבור פרויקט Firebase שלך, יש לך אחד מהתפקידים הבאים: בעלים או Firebase Admin .

• האפליקציה שלך רשומה ב-Firebase ובחשבון המפתח שלך ב-Google Play. המשמעות היא שיש לך גם אפליקציית Firebase ל-Android וגם אפליקציית Google Play.

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

• האפליקציה ב-Google Play מוגדרת בלוח המחוונים של האפליקציה ומופצת לאחד ממסלולי Google Play (בדיקות פנימיות, בדיקות סגורות, בדיקות פתוחות או הפקה).

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

אם העלית אפליקציה שלא עמדה בעבר בקריטריונים המפורטים לעיל לקישור, אך היא עושה זאת כעת, תוכל לנסות שוב לקשר את אפליקציית Firebase Android שלך ל-Google Play .

לבוחן אין חשבון Google

כאשר משתמש יוצר חשבון Google, הוא מקבל באופן אוטומטי כתובת Gmail.

אם לבוחן אין כתובת Google Workspace או Gmail, או אם הוא מעדיף להשתמש בכתובת דוא"ל אחרת כדי להיכנס, בקש מהבודק לקשר כתובת דוא"ל שאינה Gmail לחשבון ולהשתמש בדוא"ל זה כדי להיכנס.

בעת בחירת דוא"ל חלופי, על הבוחן לפעול לפי ההנחיות הבאות:

• אל תשתמש בכתובת Gmail.
• אל תשתמש בכתובת דוא"ל שכבר מקושרת לחשבון Google אחר.
• זכור להשתמש בסיסמת חשבון Google שלך ​​בעת הכניסה באמצעות כתובת דוא"ל זו.

למידע נוסף, ראה היכנס לחשבון Google שלך ​​עם כתובת דוא"ל אחרת .

הבוחן לא יכול לראות את האפליקציות או הבניינים הנכונים

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

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

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

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

2. הזמן מחדש את הבוחן לבדוק את האפליקציה שלך. הבוחן אמור לקבל אימייל הזמנה.

3. ודא שהבודק מקבל את ההזמנה עם אותה כתובת אימייל.

הבוחן לא מקבל התראות באימייל

ייתכן שהבודקים לא יקבלו הודעות דוא"ל אם מתרחשת אחת מהדברים הבאים:

• הודעות דואר אלקטרוני נשלחות לתיקיות ספאם.

• מסנני דואר אלקטרוני מוגדרים.

• ההזמנה נשלחה לחשבון דוא"ל אחד, אך הבוחן קיבל עם חשבון דוא"ל אחר. הבוחן מקבל הודעות דואר אלקטרוני חדשות עבור חשבון הדוא"ל שאליו נשלחה ההזמנה במקור.

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

פתרון 1

1. בקש מהבודק לבדוק את תיקיית הספאם שלו ואת כל מסנני הדוא"ל שהם מגדירים בשירות הדוא"ל שלו.

2. אם הבוחן ביטל את המנוי להודעות האימייל, בקש מהבודק לבצע את הפעולות הבאות:

   1. מצא אימייל שהבודק קיבל בעבר מהאפליקציה.
   2. לחץ על נהל הגדרות דוא"ל בתחתית ולחץ על אפשר לדוא"ל להירשם מחדש.

פתרון 2

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

פתרון 3

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

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

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

אם בודק מוריד ומתקין מהדורה אך ממשק המשתמש בפרטי האפליקציה אינו מראה שהאפליקציה מותקנת, זוהי בעיה ידועה. במקרים מסוימים, מזהה החבילה באפליקציית Firebase אינו תואם למזהה החבילה של ה-APK.

ודא שמזהה החבילה של ה-APK תואם למזהה החבילה של אפליקציית Firebase שבה השתמשת להעלאת ההפצה.

התראת אנדרואיד שאומרת שהמכשיר שלי לא יכול להתקין אפליקציות לא ידועות

התראת Android מופיעה אם האפליקציה או הדפדפן הפועלים שלך עדיין לא קיבלו הרשאה להתקין אפליקציות מחוץ ל-Google Play. כדי להעניק רשות:

• Android גרסה 8 ואילך : באפליקציית ההגדרות , הקש על אפשר ממקור זה .

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

חבילות הבדיקה נכשלות בהתקנה

אם APK לבדיקה נכשל בהתקנה במכשיר של בודק:

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

לא ניתן להיכנס ל-Android App Tester App

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

כדי להסיר את הגדרות ההגבלה שלך:

1. בכרטיסייה Apps של Google Workspace שלך, ודא ש-Firebase App Distribution לא מוגדר ל- Access: Blocked .

2. בכרטיסייה שירותים , ודא שפלטפורמת הענן אינה מוגבלת.

3. לאחר הסרת ההגדרות, נסה להיכנס שוב.

שגיאה בעת התקנת AAB: "לא ניתן להתקין אפליקציה"

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

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

שגיאה 403: "צור קשר עם מנהל המערכת שלך לגישה"

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

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

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

בדוק במכשיר אנדרואיד חדש

אם אתה בודק בפעם הראשונה, ראה הגדר כבוחן .

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

1. נווט אל appdistribution.firebase.google.com במכשיר האנדרואיד שלך.

2. היכנס עם חשבון הבוחן הקיים שלך, ולחץ על כפתור הורד App Tester בתחתית המסך כדי להתקין את אפליקציית Android App Tester.

הבוחן לא יכול להתחיל משוב באפליקציה

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

1. אפשר רישום מילולי עבור ה-Android SDK להפצת אפליקציות באפליקציה שלך:

   adb shell setprop log.tag.FirebaseAppDistribution VERBOSE
   

2. בדוק אם יש הודעות שגיאה ביומני האפליקציה שלך על ידי סינון עבור "FirebaseAppDistribution".

3. אשר שלבודק יש גישה לגרסה המותקנת:

   1. אם היומנים מציינים ש"לבודק אין גישה למשאב הזה", ייתכן שהבודק שלך לא הוזמן לאפליקציה, או שאין לו גישה לגרסה.

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

   אם אתה עדיין לא מקבל משוב, בצע את השלבים הבאים:

   1. במכשיר הבדיקה, היכנס ל-Firebase App Distribution באמצעות App Tester או אפליקציית האינטרנט של הבוחן. הקפד לבחור את חשבון Google שבו השתמשת לראשונה כשקיבלת את ההזמנה לבדוק את האפליקציה.

   2. התקן את האפליקציה שוב באמצעות App Tester או אפליקציית האינטרנט לבדיקה כדי לוודא שלבודק יש גישה לגרסה.

   3. נסה לשלוח משוב, הקפד שוב להיכנס עם אותו חשבון Google.

4. ודא שהפעלת את Firebase App Testers API. למידע נוסף, ראה הפעל את API Test Distribution App .

5. תחת הגבלות מפתח , ודא שממשק ה-API של Firebase App Testers כלול ברשימת ממשקי ה-API המותרים.

לא מקבל משוב שנשלח באפליקציה

1. אם אתה רואה הודעה זו בעת שליחת משוב, "היה שולח משוב, אבל לא עקב מצב פיתוח", השבת את מצב המפתח במכשיר על ידי הפעלת הפקודה הזו:

   adb shell setprop debug.firebase.appdistro.devmode false
   

2. בדוק את קובץ google-services.json שלך כדי לוודא שאתה שולח משוב עבור הפרויקט והאפליקציה הנכונים.

3. אפשר רישום מילולי עבור ה-Android SDK להפצת אפליקציות באפליקציה שלך:

   adb shell setprop log.tag.FirebaseAppDistribution VERBOSE
   

4. בדוק אם יש הודעות שגיאה ביומני האפליקציה שלך על ידי סינון עבור "FirebaseAppDistribution".

הבוחן לא מקבל התראות בתוך האפליקציה

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

1. בדוק אם יש הודעות שגיאה על ידי צירוף OnFailureListener למשימה שהוחזרה על ידי Firebase App Distribution API.

   Java

     firebaseAppDistribution.updateIfNewReleaseAvailable().addOnFailureListener ( e -> {
                     if (e instanceof FirebaseAppDistributionException) {
                        // Log exception here
                     }});
   

   קוטלין

     firebaseAppDistribution.updateIfNewReleaseAvailable().addOnFailureListener { e ->
                     if (e is FirebaseAppDistributionException) {
                        // Log exception here
                     }
     }
   

2. בדוק שלבודק יש גישה לגרסה החדשה:

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

   2. הפעל את האפליקציה שלך בסימולטור וחפש את המחרוזת "FirebaseAppDistribution".

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

   3. בלוח המחוונים של הפצת אפליקציות של מסוף Firebase, ודא שהבודק שלך כלול בהפצת ה-build שלך ושנמצא במצב מקובל .

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

      1. במכשיר הבדיקה, היכנס ל-Firebase App Distribution דרך App Tester או דרך אפליקציית האינטרנט של הבוחן. זכור לבחור את חשבון Google שבו השתמשת לראשונה כשקיבלת את ההזמנה לבדוק את האפליקציה.

      2. בדוק כדי לוודא שהגרסה החדשה של האפליקציה זמינה ב-App Tester או באפליקציית האינטרנט של הבוחן.

הבוחן התבקש להיכנס שוב לאחר סגירת האפליקציה

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

• ודא שהפעלת את Firebase App Testers API. למידע נוסף, ראה הפעל את API Test Distribution App .

• תחת הגבלות מפתח , ודא שממשק ה-API של Firebase App Testers כלול ברשימת ממשקי ה-API המותרים.

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

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

ל-Firebase App Distribution יש את מגבלות הבודקים הבאות:

• הוסף מקסימום 500 בודקים לפרויקט Firebase

• הוסף מקסימום 200 בודקים לקבוצת הפצת אפליקציות

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

האם פג תוקף ההזמנות שלי לבודקים?

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

כמה זמן זמינות מהדורות אפליקציות?

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

• הוצאת האפליקציה היא יותר מ-150 יום.
• אתה חורג מהמגבלה של 1,000 שחרור אפליקציות, והגרסה של האפליקציה ישנה יותר מ-1,000 מהדורות האפליקציות האחרונות.

למידע נוסף, ראה הפצת אפליקציות תומכת ב-1,000 גרסאות לכל היותר .

לאחר שהאפליקציה מגיעה או חורגת ממגבלת התפוגה של 150 יום או מגבלת השחרור של 1,000, הגרסה מוסרת ממרכז השליטה של ​​הפצת אפליקציות ומאפליקציית Firebase App Tester. אם הבוחן שלך התקין את המהדורה, הגרסה המקומית של האפליקציה ממשיכה לפעול.

כדי להשאיר את הוצאת האפליקציה זמינה זמן רב יותר, השתמש באחת מההמלצות הבאות:

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

תוקף מהדורות האפליקציה יפוג לאחר 150 יום

כאשר אתה מעלה מהדורה של האפליקציה שלך ל-Firebase, ההפצה מופיעה בלוח המחוונים של הפצת אפליקציות למשך 150 יום, החל מתאריך ההעלאה. לאחר העלאת המהדורה, תוכל להפיץ אותה לבודקים, אשר מתקינים את המהדורה מאפליקציית Firebase App Tester במכשיר הבדיקה שלהם.

כאשר ההפצה היא 30 יום מתאריך התפוגה, הודעה על תפוגת שחרור האפליקציה מופיעה על הגרסה שלך באפליקציית Firebase App Tester.

הפצת אפליקציות תומכת לכל היותר ב-1,000 מהדורות

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

אם ברצונך לנהל באופן ידני את מהדורות האפליקציה שלך, השתמש ב-App Distribution REST API כדי לרשום ולמחוק גרסאות אפליקציות בכמות גדולה.

אם יש לך שאלות, צור קשר עם התמיכה של Firebase .

כיצד אוכל לגשת לאפליקציות בדיקה שהתקנתי במכשיר שלי?

אם אתה בודק, אנו ממליצים להוריד את Firebase App Tester , אפליקציה המאפשרת לך לגשת לכל רכיבי הבדיקה שלך במקום אחד.

כיצד אוכל למחוק את חשבון הבוחן שלי?

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

1. בקר בכתובת https://appdistribution.firebase.google.com והיכנס באמצעות חשבון Google שלך.

2. בפינה השמאלית העליונה, לחץ על settings ( נהל חשבון )

   מחק חשבון .

3. אופציונלי: בהרשאות חשבון Google שלך, שלל גישה מ-Firebase App Distribution. שים לב שביטול הגישה מבלי למחוק תחילה את חשבון הפצת האפליקציות שלך אינו מוחק את חשבון הבוחן או הנתונים שלך.