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

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

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

"לא מצאנו כתובת אימייל ליצירת קשר לגבי האפליקציה <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 Distributionקליפ האינטרנט: appdistribution.firebase.google.com.

פתרון 3

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

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

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

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

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

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

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

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

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

     1. במכשיר הבדיקה, נכנסים לקיצור הדרך לאינטרנט של הפצת אפליקציות ב-Firebase. חשוב לבחור את חשבון 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

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

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

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

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

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

מהו פרופיל Firebase?

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

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

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

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

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

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