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

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

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

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

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

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

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

לא ניתן להעלות את ה-IPA

הדוגמה הבאה היא של תגובת רשת בדפדפן:

{
"status": "IN_PROGRESS",
  "message": "There was an error processing your
distribution. Ensure you are uploading a valid IPA or APK and try again."
}

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

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

2. אם גודל קובץ ה-IPA לא חורג מהמגבלה ואפשר לשחזר את הבעיה, פועלים לפי השלבים הבאים:

   1. בודקים את הקובץ Info.plist ומוודאים ש-CFBundleDisplayName מכיל תווי הפרדה מסוג <array>.

   2. מסירים את התווים המפרידים <array> ויוצרים מחדש את האפליקציה. ההעלאה אמורה להצליח.

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

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

4. אם הקטנת קובץ ה-IPA לא פותרת את הבעיה, פנו לתמיכה של Firebase ובקשו להשתמש ב-Testflight.

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

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

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

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

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

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

הבודק לא יכול לראות את האפליקציות או הגרסאות הנכונות

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

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

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

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

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

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

הבודק לא מקבל התראות באימייל

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

• התראות באימייל נשלחות לתיקיות הספאם.

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

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

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

פתרון 1

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

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

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

פתרון 2

אם לבודק לא אכפת לקבל התראות באימייל והוא רק רוצה להיות מסוגל לאשר הזמנות לאפליקציה, הוא יכול לראות הזמנות לאפליקציה בהמתנה ישירות בקליפ האינטרנט של Firebase App Distribution: appdistribution.firebase.google.com.

פתרון 3

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

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

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

השגיאה Untrusted Enterprise Developer מופיעה אם לא נתתם אמון באישור המפתח במכשיר הבדיקה לפני שפתחתם את האפליקציה. באפליקציה Settings, במסך Profiles & Device Management, בוחרים את שם המפתח של האפליקציה ונותנים בו אמון.

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

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

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

1. באייפון, פותחים את אפליקציית ההגדרות ולוחצים על פרטיות ואבטחה.
2. גוללים למטה לקטע "אבטחה" ולוחצים על מצב פיתוח.
3. לוחצים על פס ההזזה של מצב פיתוח.
4. לוחצים על הפעלה מחדש.
5. אחרי שהמכשיר מופעל מחדש, פותחים את הנעילה שלו. מופיעה תיבת הדו-שיח "להפעיל את מצב פיתוח?".
6. לוחצים על הפעלה. עכשיו אפשר להפעיל את האפליקציה ולהתחיל לבדוק אותה.

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

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

לחשבון Google אין גישה לאפליקציית הבדיקה

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

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

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

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

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

הבודק לא מקבל התראות באפליקציה

אם כבר הגדרתם את ה-SDK של App Distribution ל-iOS באפליקציה והבודקים לא מקבלים התראות בתוך האפליקציה, ודאו שהאפליקציה מאחזרת גרסאות חדשות:

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

2. מריצים את האפליקציה בסימולטור ומחפשים את המחרוזת "[Firebase/AppDistribution]".

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

   • אם מוחזר אובייקט גרסה תקין, סביר להניח שיש בעיה במחזור החיים של View Controller, שבו תיבת הדו-שיח של ההתראה נטענת לפני שמופיעה התצוגה.

   • אם לא מוחזרת גרסה, יכול להיות שהבודק עדיין לא משויך לגרסה החדשה. בלוח הבקרה של App Distribution במסוף Firebase, מוודאים שהבודק נכלל בהפצת ה-build ונמצא במצב Accepted.

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

     1. במכשיר הבדיקה, נכנסים ל-Web Clip של הפצת אפליקציות ב-Firebase. חשוב לבחור את חשבון Google שבו השתמשתם כשאישרתם את ההזמנה לבדוק את האפליקציה.

     2. מוודאים שגרסת האפליקציה החדשה זמינה ב-Web Clip.

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

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

• צריך לוודא שהפעלתם את Firebase App Testers API. מידע נוסף זמין במאמר הפעלת App Distribution Tester API.

• בקטע Key restrictions, מוודאים שה-API של App Tester של Firebase נכלל ברשימת ממשקי ה-API המותרים.

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

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

אלה המגבלות על מספר הבודקים ב-Firebase App Distribution:

• הוספה של עד 500 בודקים לפרויקט ב-Firebase

• אפשר להוסיף עד 200 בודקים לקבוצת App Distribution

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

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

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

מתי נוצרת גרסה חדשה להעלאות ל-iOS?

איך רושמים מכשירים נוספים

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

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

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

מידע נוסף זמין במאמר ב-App Distribution אפשר להגדיר עד 1,000 גרסאות.

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

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

• לפני שהגרסה של האפליקציה תפוג או תחרוג ממגבלת הגרסאות, צריך להוריד את קובץ ה-IPA ולמחוק את הגרסה ממרכז הבקרה של App Distribution. לאחר מכן, מעלים מחדש את ה-IPA כגרסה חדשה אל App Distribution.
• מורידים את הגרסה ומעלים אותה אל Cloud Storage כדי להעביר אותה לארכיון לטווח ארוך.

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

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

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

ב-App Distribution אפשר להוסיף עד 1,000 פריטי תוכן

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

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

אם יש לכם שאלות, אתם יכולים לפנות לתמיכה של Firebase.

מהו פרופיל Firebase?

הפרופיל של Firebase הוא פרופיל הגדרות שמאפשר ל-App Distribution:

• רושמים את מכשיר הבדיקה באמצעות איסוף מזהה המכשיר הייחודי (UDID). אם אתם בודקים הפצה אד-הוק, מערכת Firebase שולחת למפתח האפליקציה אימייל שכולל את ה-UDID של מכשיר הבדיקה, יחד עם הוראות להכללת המכשיר בפרופיל ההקצאה של האפליקציה כדי שתוכלו לבדוק את ה-build במכשיר שלכם.

• התקנת קליפ אינטרנט של Firebase App Distribution במסך הבית של המכשיר. הקליפ מאפשר להתקין את כל אפליקציות הבדיקה ולגשת אליהן במקום אחד. גרסאות build חדשות שאתם מוזמנים לבדוק מתווספות באופן אוטומטי לקליפ האינטרנט.

לקבלת עזרה בהתקנת פרופילי הגדרות במכשיר iOS, אפשר לעיין במסמכי התיעוד של Apple.

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

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

אם אתם בודקים הפצה של Enterprise, אתם יכולים להתקין את הפרופיל באופן ידני:

1. אם עדיין לא עשיתם את זה, היכנסו לחשבון Google ואשרו את ההזמנה.

2. בקטע אפליקציות לבדיקה, בוחרים את האפליקציה שרוצים לבדוק.

3. בפינה השמאלית העליונה של דף האפליקציה, לוחצים על mobile_screen_share.

4. פועלים לפי ההוראות שמוצגות כדי להתקין את הפרופיל של Firebase.

איך מוחקים את חשבון הבודק?

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

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

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

   מחיקת החשבון.

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