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

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 הנכונות.

כתובת האימייל שאליה המפתח שולח את ההזמנות ומוסיף גרסאות 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 מופיעה אם לא הבעתם אמון בתעודת המפתח במכשיר הבדיקה לפני פתיחת האפליקציה. באפליקציית הגדרות > המסך Profiles & Device Management, בוחרים את שם המפתח של האפליקציה ומביעים בו אמון.

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

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

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

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

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

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

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

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

אם לחשבון 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 של בודק הפצת האפליקציות.

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