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

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 ובירור לגבי השימוש בדיקת הפעלה.

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

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

לבודק אין חשבון Google

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

פתרון 1

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

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

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

פתרון 2

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

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

פתרון 3

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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