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

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. גודל הקובץ המקסימלי של כל הקבצים הבינאריים הוא 2,048MiB, שזה קצת יותר מ-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 חדשות, כתובת אימייל ב' היא זו שמקבלת גישה.

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

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

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

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

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

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

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

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

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

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

פתרון 1

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

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

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

פתרון 2

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

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

פתרון 3

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

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

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

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

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

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

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

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

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

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

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

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

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

חשוב לזכור:

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

• בקטע Key restrictions, מוודאים שה-API של בודקי האפליקציות של 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, אפשר לעיין במסמכי התיעוד של אפל.

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

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

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

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

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

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

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

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

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

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

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

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

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