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


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

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

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

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

"לא הצלחנו למצוא כתובת אימייל ליצירת קשר עם האפליקציה <app-id>. כדי להגדיר אותו, צריך לעבור אל App Distribution במסוף Firebase."

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

אם נתקלתם שוב ושוב בשגיאות 400,‏ 409 או 500 במהלך ההקצאה, תוכלו לפנות אל התמיכה של Firebase. מציינים לתמיכה את מספר הפרויקט ב-Firebase ואת מזהה האפליקציה.

דוגמה לתגובה של רשת הדפדפן:

{
"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>.

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

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

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

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

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

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

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

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

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

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

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

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

כתובת האימייל שאליה המפתח שולח את ההזמנות ומוסיף גרסאות 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.

פתרון 3

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

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

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

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

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

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

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

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

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

איך רושמים מכשירים נוספים

גרסאות של אפליקציות יוסרו מ-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 הוא פרופיל תצורה שמאפשר ל-App Distribution:

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

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

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

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