דף זה מספק עזרה בפתרון בעיות ותשובות לשאלות נפוצות לגבי הפצה ובדיקת אפליקציות עם הפצת אפליקציות.
הפצת אפליקציות
השתמש בעצות הבאות כדי לפתור בעיות שאתה עלול להיתקל בהן בעת הפצת אפליקציות לבודקים שלך.
בעת העלאת אפליקציה, אתה עלול להיתקל בשגיאה זו:
"לא הצלחנו למצוא כתובת אימייל ליצירת קשר עבור האפליקציה <app-id>
. בקר בהפצת אפליקציות במסוף 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."
}
כדי לפתור בעיה זו, בצע את השלבים הבאים:
ודא את גודל ה-IPA. מגבלת גודל הקובץ המקסימלית עבור כל הקבצים הבינאריים היא 2048 MiB, שהם קצת יותר מ-2 GB.
אם גודל ה-IPA נמצא במגבלת גודל הקובץ וניתן לשחזור, בצע את השלבים הבאים:
בדוק את קובץ
Info.plist
שלך ואשר אםCFBundleDisplayName
מכיל מפריד<array>
.הסר את המפרידים
<array>
ובנה מחדש את האפליקציה שלך. ההעלאה אמורה להצליח.אם אתה עדיין נתקל בבעיות, פנה לתמיכה של Firebase .
אם גודל ה-IPA חורג ממגבלת גודל הקובץ, בצע את השינויים הדרושים כדי להקטין את גודל הקובץ.
אם הקטנת קובץ ה-IPA לא פותרת את הבעיה, פנה לתמיכה של Firebase ושאל לגבי השימוש ב-Testflight .
התקנה ובדיקה של אפליקציות
השתמש בעצות הבאות כדי לפתור בעיות שהבודקים שלך עלולים להיתקל בהן כשהם מתקינים ובודקים את האפליקציות שלך.
כאשר משתמש יוצר חשבון Google, הוא מקבל באופן אוטומטי כתובת Gmail.
אם לבוחן אין כתובת Google Workspace או Gmail, או אם הוא מעדיף להשתמש בכתובת דוא"ל אחרת כדי להיכנס, בקש מהבודק לקשר כתובת דוא"ל שאינה Gmail לחשבון ולהשתמש בדוא"ל זה כדי להיכנס.
בעת בחירת דוא"ל חלופי, על הבוחן לפעול לפי ההנחיות הבאות:
- אל תשתמש בכתובת Gmail.
- אל תשתמש בכתובת דוא"ל שכבר מקושרת לחשבון Google אחר.
- זכור להשתמש בסיסמת חשבון Google שלך בעת הכניסה באמצעות כתובת דוא"ל זו.
למידע נוסף, ראה היכנס לחשבון Google שלך עם כתובת דוא"ל אחרת .
אם הבוחן קיבל את ההזמנה בדוא"ל עם כתובת דוא"ל שונה מזו שההזמנה נשלחה אליה, ייתכן שהבודק לא יוכל לראות את האפליקציות או הרכיבים הנכונים.
האימייל שאליו המפתח שולח הזמנות ומוסיף לגירסאות חדשות (אימייל א') יכול להיות שונה מהמייל שבו משתמש הבוחן כדי לקבל את ההזמנה (אימייל ב'). זה יוצר קישור מאחורי הקלעים. בכל פעם שמתווסף דוא"ל א' למבנים חדשים, זה למעשה דוא"ל B שמקבל גישה.
אם הבוחן קיבל את ההזמנה בדוא"ל עם כתובת דוא"ל אחרת, בצע את השלבים הבאים כדי לפתור את הבעיה:
מחק את הבוחן מהקטע הצג את כל הבודקים בכרטיסייה בודקים וקבוצות בדף הפצת אפליקציות של מסוף Firebase. ההזמנות הקיימות מוסרות.
הזמן מחדש את הבוחן לבדוק את האפליקציה שלך. הבוחן אמור לקבל אימייל הזמנה.
ודא שהבודק מקבל את ההזמנה עם אותה כתובת אימייל.
ייתכן שהבודקים לא יקבלו הודעות דוא"ל אם מתרחשת אחת מהדברים הבאים:
הודעות דואר אלקטרוני נשלחות לתיקיות ספאם.
מסנני דואר אלקטרוני מוגדרים.
ההזמנה נשלחה לחשבון דוא"ל אחד, אך הבוחן קיבל עם חשבון דוא"ל אחר. הבוחן מקבל הודעות דואר אלקטרוני חדשות עבור חשבון הדוא"ל שאליו נשלחה ההזמנה במקור.
הבוחן הוזמן בעבר אך לא קיבל את ההזמנה הראשונית. אם הבוחן יתווסף למהדורות עוקבות, אפליקציית הפצת אפליקציות לא תשלח אוטומטית הודעות פרסום לאותו בודק מכיוון שהבודק לא קיבל את ההזמנה הראשונית.
פתרון 1
בקש מהבודק לבדוק את תיקיית הספאם שלו ואת כל מסנני הדוא"ל שהם מגדירים בשירות הדוא"ל שלו.
אם הבוחן ביטל את המנוי להודעות האימייל, בקש מהבודק לבצע את הפעולות הבאות:
- מצא אימייל שהבודק קיבל בעבר מהאפליקציה.
- לחץ על נהל הגדרות דוא"ל בתחתית ולחץ על אפשר לדוא"ל להירשם מחדש.
פתרון 2
אם לבוחן לא אכפת לקבל הודעות דוא"ל והוא רק רוצה להיות מסוגל לקבל הזמנות לאפליקציה, הוא יכול להציג הזמנות אפליקציה ממתינות ישירות בקליפ האינטרנט של Firebase App Distribution: appdistribution.firebase.google.com .
פתרון 3
מחק את הבוחן מהקטע הצג את כל הבודקים של הכרטיסייה בודקים וקבוצות בדף הפצת אפליקציות במסוף Firebase. פעולה זו מסירה הזמנות קיימות.
הזמן מחדש את הבוחן לבדוק את האפליקציה שלך. הבוחן אמור לקבל אימייל הזמנה. ודא שהבודק מקבל את ההזמנה עם אותה כתובת אימייל שאליה נשלחה ההזמנה.
השגיאה של Untrusted Enterprise Developer מופיעה אם לא נתת אמון באישור המפתח במכשיר הבדיקה לפני פתיחת האפליקציה. באפליקציית הגדרות > פרופילים וניהול מכשירים , בחר את שם המפתח של האפליקציה וסמוך עליו.
השגיאה 'נדרש מצב מפתח' מופיעה כאשר אתה מנסה להפעיל אפליקציית iOS עם אספקת אד-הוק ב-iOS 16 ואילך מבלי להפעיל תחילה את מצב מפתחים.
כדי להפעיל את מצב מפתחים ולפתור שגיאה זו, בצע את השלבים הבאים:
- באייפון שלך, פתח את אפליקציית ההגדרות ולאחר מכן הקש על פרטיות ואבטחה .
- גלול מטה אל אבטחה והקש על מצב מפתח .
- הקש על המחוון מצב מפתח .
- הקש על הפעל מחדש .
- לאחר הפעלה מחדש של המכשיר, בטל את נעילת המכשיר. הפעל את מצב מפתחים? מופיעה תיבת דו-שיח.
- הקש על הפעל . כעת תוכל להפעיל את האפליקציה שלך ולהתחיל בבדיקה.
אם אתה מתקין הפצת אד-הוק, הודעה זו מופיעה כאשר המפתח עדיין לא הגדיר את האפליקציה שלו לפעול במכשיר הבדיקה שלך. כדי להפוך את האפליקציה לזמינה עבורך, על המפתח להשלים את ההוראות בהרשמה של מכשירים נוספים .
אם לחשבון Google שלך אין גישה לאפליקציית בדיקה שהתקנת בעבר (או שקיבלת הזמנה עבורה), סביר להניח שנכנסת לחשבון Google הלא נכון. האפליקציות שאליהם יש לך גישה משויכות לחשבון Google שבו השתמשת כאשר קיבלת לראשונה את ההזמנה לבדוק את האפליקציה. נסה שוב על ידי כניסה עם חשבון Google שבו השתמשת בעבר כדי לקבל את ההזמנה.
כאשר אתה נתקל בשגיאת 403, המשמעות היא שלחשבון שבו אתה משתמש אין הרשאה להתקין ולבדוק אפליקציות. הגישה נקבעת על ידי מנהל המערכת של הדומיין של החשבון שלך ב-Google Workspace.
אם אתה סבור שצריכה להיות לך הרשאה להתקין ולבדוק אפליקציות, בקש ממנהל חשבון Google Workspace שלך לשנות את הגדרות החשבון שלך. מנהל המערכת שלך צריך לבצע את ההוראות ב'ניהול גישה לשירותים שאינם נשלטים בנפרד .
אם יש לך מספר חשבונות, נסה להיכנס עם חשבון אחר שאינו מוגבל בהתקנה ובדיקה של אפליקציות.
הפעלת התראות בתוך האפליקציה עם ה-App Distribution iOS SDK
השתמש בעצות הבאות כדי לפתור בעיות הכרוכות בהפעלת התראות בנייה חדשה בתוך האפליקציה באמצעות ה-App Distribution iOS SDK.
אם כבר הגדרת את ה-App Distribution iOS SDK באפליקציה שלך והבודקים שלך לא מקבלים התראות בתוך האפליקציה, בדוק כדי לוודא שהאפליקציה שלך מביאה מהדורות חדשות:
הפעל מצב ניפוי באגים באפליקציה שלך. כדי ללמוד כיצד, עיין בתיעוד של Google Analytics .
הפעל את האפליקציה שלך בסימולטור וחפש את המחרוזת "[Firebase/AppDistribution]".
בדוק שלבודק יש גישה לגרסה החדשה:
אם מוחזר אובייקט שחרור חוקי, סביר להניח שיש בעיה במחזור החיים של בקר התצוגה שבו תיבת הדו-שיח של ההתראה נטענת לפני שהתצוגה מופיעה.
אם לא הוחזר מהדורה, ייתכן שהבודק שלך עדיין לא משויך למהדורה החדשה. בלוח המחוונים של הפצת אפליקציות של מסוף Firebase, ודא שהבודק שלך כלול בהפצת ה-build שלך ושנמצא במצב מקובל .
אם הבוחן שלך עדיין לא מקבל עדכונים, בקש ממנו לפעול לפי הטיפים הבאים כדי לוודא שהוא קיבל את ההזמנה לבדוק את האפליקציה שלך ושהוא הגדיר את מכשיר הבדיקה שלו כראוי:
במכשיר הבדיקה, היכנס לקליפ האינטרנט של Firebase App Distribution. זכור לבחור את חשבון Google שבו השתמשת לראשונה כשקיבלת את ההזמנה לבדוק את האפליקציה.
ודא שהגרסה החדשה של האפליקציה זמינה בקליפ האינטרנט.
כברירת מחדל, הבודקים שלך צריכים להיכנס לחשבון Google שלהם פעם אחת בלבד כדי להפעיל התראות על בנייה חדשה וכדי להתקין רכיבים חדשים. אם הבודקים שלך מתבקשים להיכנס שוב לאחר סגירה ופתיחה מחדש של האפליקציה שלך, עקוב אחר הטיפים הבאים כדי לוודא שתצורת הפצת האפליקציה שלך מוגדרת כהלכה:
ודא שהפעלת את Firebase App Testers API. למידע נוסף, ראה הפעל את API Test Distribution App .
תחת הגבלות מפתח , ודא שממשק ה-API של Firebase App Testers כלול ברשימת ממשקי ה-API המותרים.
אם אתה בדרך כלל מנקה את UserDefaults בעת היציאה, ייתכן שאתה מנקה את מצב הבוחן שלך. הפצת אפליקציות מאחסנת דגל המציין אם הבוחן שלך כבר נכנס לאפליקציה. למידע נוסף, עיין במאגר GitHub .
שאלות נפוצות
ל-Firebase App Distribution יש את מגבלות הבודקים הבאות:
הוסף מקסימום 500 בודקים לפרויקט Firebase
הוסף מקסימום 200 בודקים לקבוצת הפצת אפליקציות
כדי להוסיף בודקים נוספים, בקש הגדלת מגבלה ללא עלות .
לבודקים יש 30 יום לקבל הזמנה לבדוק את האפליקציה לפני שתפוגה. כאשר הזמנה עוברת 5 ימים מתאריך התפוגה, הודעת תפוגה מופיעה במסוף Firebase ליד הבוחן בגרסה. ניתן לחדש הזמנה על ידי שליחתה מחדש דרך התפריט הנפתח בשורת הבוחן.
ראה רישום מכשירים נוספים .
גרסאות אפליקציות יוסרו מהפצת אפליקציות אם מתרחש אחד מהתנאים הבאים:
- הוצאת האפליקציה היא יותר מ-150 יום.
- אתה חורג מהמגבלה של 1,000 שחרור אפליקציות, והגרסה של האפליקציה ישנה יותר מ-1,000 מהדורות האפליקציות האחרונות.
למידע נוסף, ראה הפצת אפליקציות תומכת ב-1,000 גרסאות לכל היותר .
לאחר שהאפליקציה מגיעה או חורגת ממגבלת התפוגה של 150 יום או מגבלת השחרור של 1,000 אפליקציות, הגרסה מוסרת ממרכז השליטה של הפצת אפליקציות ומאפליקציית האינטרנט של בודק הפצת אפליקציות. אם הבוחן שלך התקין את המהדורה, הגרסה המקומית של האפליקציה ממשיכה לפעול.
כדי להשאיר את הוצאת האפליקציה זמינה זמן רב יותר, השתמש באחת מההמלצות הבאות:
- לפני שהשחרור של האפליקציה יפוג או יחרוג ממגבלת ההפצה, הורד את ה-IPA ומחק את הגרסה מלוח המחוונים של הפצת אפליקציות. לאחר מכן, העלה מחדש את ה-IPA כמבנה חדש ל-App Distribution.
- הורד את המהדורה והעלה אותה ל- Cloud Storage לארכיון לטווח ארוך.
תוקף מהדורות האפליקציה יפוג לאחר 150 יום
כאשר אתה מעלה גרסה של האפליקציה שלך ל-Firebase, ההפצה מופיעה בלוח המחוונים של הפצת אפליקציות למשך 150 יום, החל מתאריך ההעלאה. לאחר העלאת המהדורה, תוכל להפיץ אותה לבודקים, אשר מתקינים את המהדורה מאפליקציית האינטרנט של בודק ההפצה של אפליקציות במכשיר הבדיקה שלהם.
כאשר ההפצה היא 30 יום מתאריך התפוגה, הודעת תפוגה של שחרור האפליקציה מופיעה בגרסה שלך בדף הפצת אפליקציות של מסוף Firebase ובאפליקציית האינטרנט של בודק ה-App Distribution.
הפצת אפליקציות תומכת לכל היותר ב-1,000 מהדורות
הפצת אפליקציות מאפשרת לכל היותר 1,000 מהדורות לכל אפליקציה. כאשר האפליקציה שלך מגיעה למגבלה של 1,000 אפליקציות, הפצת אפליקציות מוחקת אוטומטית את המהדורות הישנות ביותר מעל המגבלה.
אם ברצונך לנהל באופן ידני את מהדורות האפליקציה שלך, השתמש ב-App Distribution REST API כדי לרשום ולמחוק גרסאות אפליקציות בכמות גדולה.
אם יש לך שאלות, צור קשר עם התמיכה של Firebase .
פרופיל Firebase הוא פרופיל תצורה המאפשר להפצת אפליקציות:
רשום את מכשיר הבדיקה על ידי איסוף מזהה המכשיר הייחודי (UDID). אם אתה בודק הפצת אד-הוק, Firebase שולחת למפתח האפליקציה אימייל הכולל את ה-UDID של מכשיר הבדיקה, יחד עם הוראות כיצד לכלול את המכשיר בפרופיל ההקצאה של האפליקציה כדי שניתן יהיה לבדוק את ה-build במכשיר שלך.
התקן קליפ אינטרנט של Firebase App Distribution על מסך הבית של המכשיר שלך. קליפ האינטרנט מאפשר לך להתקין ולגשת לכל אפליקציות הבדיקה שלך במקום אחד. בונים חדשים שאתה מוזמן לבדוק מתווספים אוטומטית לקליפ האינטרנט.
לקבלת עזרה בהתקנת פרופילי תצורה במכשיר ה-iOS שלך, עיין בתיעוד של Apple .
אם אתה בודק, אתה יכול לגשת לכל אפליקציות הבדיקה שלך באמצעות קליפ האינטרנט של Firebase App Distribution , שמתווסף אוטומטית למסך הבית של מכשיר הבדיקה שלך בעת התקנת פרופיל Firebase. אם אתה בודק הפצת אד-הוק, תחילה עליך להתקין את הפרופיל לפני שתוכל לבדוק את האפליקציה.
אם אתה בודק הפצת Enterprise, אתה יכול להתקין את הפרופיל באופן ידני:
אם עדיין לא עשית זאת, היכנס ל-Google וקבל את ההזמנה.
תחת בדיקת אפליקציות , בחר את האפליקציה שברצונך לבדוק.
בפינה השמאלית העליונה של דף האפליקציה, הקש על mobile_screen_share .
בצע את ההוראות המוצגות כדי להתקין את פרופיל Firebase.
כדי למחוק את חשבון הבוחן App Distribution והנתונים המשויכים אליו, בצע את השלבים הבאים לפי הסדר:
בקר בכתובת https://appdistribution.firebase.google.com והיכנס עם חשבון Google שלך.
בפינה השמאלית העליונה, לחץ על
( נהל חשבון )מחק חשבון .
אופציונלי: בהרשאות חשבון Google שלך, שלל גישה מ-Firebase App Distribution. שים לב שביטול הגישה מבלי למחוק תחילה את חשבון הפצת האפליקציות שלך אינו מוחק את חשבון הבוחן או הנתונים שלך.