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

iOS+ Android

בדף הזה מפורטת עזרה בפתרון בעיות ותשובות לשאלות נפוצות בנושא הפצת אפליקציות ובדיקתן באמצעות App Distribution.

הפצת אפליקציות

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

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

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

"לא הצלחנו למצוא כתובת אימייל ליצירת קשר לאפליקציה <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. מגבלת הגודל המקסימלי של כל הקבצים הבינאריים היא 2048MiB, שהם קצת יותר מ-2GB.

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

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

      הערה: מערכת הפצה של אפליקציות לא מקבלת ערכים של CFBundleDisplayName שהם מערכי נתונים.

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

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

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

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

התקנה ובדיקה של אפליקציות

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

למבצע הבדיקה אין חשבון Google

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

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

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

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

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

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

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

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

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

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.

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

פתרון 3

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

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

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

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

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

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

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

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

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

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

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

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

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

חשוב לזכור:

• יכול להיות שהחשבון שבו השתמשתם כדי לאשר את ההזמנה לא יהיה זהה לחשבון Google שאליו נשלחה ההזמנה במקור.
• אפשר לשייך חשבון Google לכל כתובת אימייל, לא רק לכתובות עם דומיינים של Gmail או G Suite. כך נכנסים לחשבון עם כתובת אימייל אחרת.

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

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

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

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

הפעלת התראות באפליקציה באמצעות App Distribution iOS SDK

הטיפים הבאים יעזרו לכם לפתור בעיות שקשורות להפעלת התראות על גרסאות build חדשות באפליקציה באמצעות App Distribution iOS SDK.

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

שאלות נפוצות

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

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

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

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

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

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

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

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

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

מהו פרופיל Firebase?

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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