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

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

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

"לא מצאנו כתובת אימייל ליצירת קשר לגבי האפליקציה <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 עם כתובת אימייל אחרת.

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

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

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

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

1. מוחקים את הבודק מהקטע View all testers (הצגת כל הבודקים) בכרטיסייה Testers & Groups (בודקים וקבוצות) בדף App Distribution של מסוף Firebase. ההזמנות הקיימות יוסרו.

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

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

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

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

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

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

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

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

פתרון 1

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

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

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

פתרון 2

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

פתרון 3

1. מוחקים את הבודק מהקטע View all testers (הצגת כל הבודקים) בכרטיסייה Testers & Groups (בודקים וקבוצות) בדף App Distribution במסוף Firebase. הפעולה הזו תסיר את ההזמנות הקיימות.

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

• בקטע Key restrictions, מוודאים ש-Firebase App Testers API מופיע ברשימת ממשקי ה-API המותרים.

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

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

Firebase App Distribution כפוף למגבלות הבאות למשתתפי הבדיקה:

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

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

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

Do my tester invitations expire?

לבודקים יש 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 כגרסת build חדשה אל 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 מוחק אוטומטית את הגרסאות הכי ישנות שמעבר למגבלה.

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

יש לך שאלות? אפשר לפנות לתמיכה של Firebase.

מהו פרופיל Firebase?

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

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

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

לקבלת עזרה בהתקנת פרופילי הגדרה במכשיר 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 לא יגרום למחיקה של חשבון הבודק או הנתונים שלו.