אם רוצים להפיץ גרסאות build ייעודיות ל-iOS באמצעות App Distribution, צריך לפעול לפי המדריך הזה כדי לרשום את המכשירים של הבוחנים. גרסת build זמנית היא גרסת build שלא חתומה באמצעות פרופיל ארגוני. אפשר להתקין גרסה זמנית של build במכשיר רק אם מזהה המכשיר הייחודי (UDID) נכלל בפרופיל ההקצאה של ה-build.
כשבודק מקבל הזמנה לבדוק את האפליקציה, App Distribution מבקש ממכם, המפתחים, הרשאה לשתף את מזהה המכשיר של הבודק. לפני הורדת build ספציפי, App Distribution מבקש מהבודק לרשום את המכשיר שלו. אם הבודק רושם את המכשיר, App Distribution אוסף את ה-UDID מהמכשיר ומעדכן אתכם על ה-UDID באימייל.
כשאתם מקבלים אימייל עם UDID, מעדכנים את פרופיל ההקצאה ב-UDID ומפיצים גרסה חדשה למפתחים לצורך בדיקה. אפשר לייצא באופן ידני מזהי UDID באמצעות מסוף Firebase או ה-CLI של Firebase, או לייצא באופן פרוגרמטי מזהי UDID באמצעות fastlane.
ייצוא ידני של מזהי UDID
- מוסיפים את המכשירים לפורטל המפתחים של Apple.
- אפשרות 1: מייבאים את מזהי UDID של המכשירים כקובץ CSV.
בכרטיסייה Testers & Groups (בודקים וקבוצות) במרכז הבקרה App Distribution, בוחרים באפשרות All testers (כל הבודקים) ולוחצים על Export Apple UDIDs (ייצוא מזהי UDID של Apple) כדי להוריד קובץ CSV. בשלב הבא, מייבאים את הקובץ לחשבון הפיתוח ב-Apple באמצעות האפשרות רישום מספר מכשירים. מידע נוסף זמין במאמר הפצת האפליקציה למכשירים רשומים.
חשוב לדעת שחשבון הפיתוח שלכם ב-Apple עשוי לאפשר לכם לייבא רק מספר מוגבל של מכשירים בשנה.
- אפשרות 2: אוספים את מזהי ה-UDID ומזינים אותם באימייל.
בדף Add devices (הוספת מכשירים) בפורטל המפתחים של Apple, צריך לרשום את ה-UDID החדש שצוין באימייל שקיבלתם.
- אפשרות 1: מייבאים את מזהי UDID של המכשירים כקובץ CSV.
- מוסיפים את המכשירים הרשומים לפרופיל ההקצאה.
- מורידים את קובץ הפרופיל לניהול הרשאות הגישה ומשתמשים בו כדי ליצור מחדש את האפליקציה. אם יוצרים מחדש רק כדי לעדכן את המכשירים הרשומים, לא מעדכנים את מספר ה-build או את הגרסה.
- מפיצים מחדש את האפליקציה דרך מסוף Firebase או CLI. אם לא משנים את הגרסה, מספר ה-build או את הקוד של האפליקציה, App Distribution לא יוצרת גרסה חדשה ולא תודיע לבודקים. אם כבר הפצתם גרסה של build עם אותו מספר build ואותה גרסה, רק משתמשים במכשירים שנרשמו לאחרונה יקבלו התראות באימייל.
ייצוא פרוגרמטי של רכיבי UDID באמצעות נתיב מהיר
מייצאים את כל מזהי UDID של מכשירי הבדיקה כקובץ CSV מ-fastlane. לדוגמה, יוצרים נתיב
download_udids
חדש ומפעילים אותו:lane :download_udids do firebase_app_distribution_get_udids( app: "<your Firebase app ID>", output_file: "<path to output file>", ) end
מייבאים את מזהי ה-UDID לחשבון הפיתוח של Apple באמצעות האפשרות Register Multiple Devices. מידע נוסף זמין במסמכי התיעוד של Apple. חשוב לזכור שחשבון הפיתוח שלכם ב-Apple עשוי לאפשר לכם לייבא רק מספר מוגבל של מכשירים בשנה.
מוסיפים את המכשירים הרשומים לפרופיל ההקצאה.
מורידים את פרופיל הקצאת המשאבים ומשתמשים בו כדי ליצור מחדש את האפליקציה. אם יוצרים מחדש רק כדי לעדכן את המכשירים הרשומים, לא מעדכנים את מספר ה-build או את הגרסה.
לחלק מחדש את האפליקציה. אם לא משנים את הגרסה, מספר ה-build או הקוד של האפליקציה, App Distribution לא יוצר גרסה חדשה ולא שולח התראות למבחנים. אם כבר הפצתם גרסה של build עם אותו מספר build ואותה גרסת build, רק משתמשים במכשירים שנרשמו לאחרונה יקבלו התראות באימייל.
קבלת התראות
קבלת התראות ברירת מחדל
כברירת מחדל, מערכת Firebase יכולה לשלוח התראות App Distribution על רישום של מכשירי iOS חדשים באימייל.
כדי לקבל התראות App Distribution באמצעות מנגנון ברירת המחדל הזה, צריכה להיות לכם ההרשאה firebase.projects.update
. התפקידים הבאים כוללים את ההרשאה הנדרשת כברירת מחדל: אדמין ב-Firebase או בעלים או עורך בפרויקט.
כברירת מחדל, כל חברי הפרויקט (שיש להם את ההרשאות הנדרשות לקבלת התראות) יקבלו אימייל כשמכשיר iOS חדש ירשם.
הפעלה או השבתה של התראות בחשבון שלכם
בחשבון שלכם תוכלו להפעיל או להשבית את ההתראות של App Distribution בלי להשפיע על חברים אחרים בפרויקט. חשוב לזכור שעדיין נדרשות ההרשאות הנדרשות כדי לקבל התראות.
כדי להפעיל או להשבית את ההתראות של App Distribution:
- במסוף Firebase, בפינה השמאלית העליונה, עוברים אל
. התראות Firebase - לאחר מכן, עוברים אל
ומגדירים את העדפות החשבון לגבי התראות הגדרותApp Distribution.
הגדרת התראות מתקדמות לשירותים של צד שלישי
אפשר גם לשלוח התראות App Distribution לערוץ ההתראות המועדף של הצוות באמצעות Cloud Functions for Firebase. לדוגמה, אפשר לכתוב פונקציה שמתעדת אירוע התראה על רישום של מכשיר iOS חדש, ומפרסמת את פרטי ההתראה בשירות של צד שלישי, כמו Discord, Slack או Jira.
כדי להפוך את תהליך ההצטרפות של בודקי iOS חדשים לאוטומטי לחלוטין, אפשר לכתוב פונקציה שמוסיפה את ה-UDID של מכשיר iOS חדש לפרופיל ההקצאה של האפליקציה, יוצרת מחדש את האפליקציה ומפיצה מחדש את האפליקציה עם פרופיל ההקצאה המעודכן.
כדי להגדיר יכולות מתקדמות של התראות באמצעות Cloud Functions for Firebase:
הגדרת Cloud Functions for Firebase, כולל המשימות הבאות:
- מגדירים סביבת פיתוח ל-Node.js או ל-Python.
- מתקינים את ה-CLI של Firebase ונכנסים אליו.
- מאתחלים את Cloud Functions for Firebase באמצעות ה-CLI של Firebase.
כותבים ופורסים פונקציה שמתעדת אירוע התראה מ-App Distribution ומטפלת בתוכן הייעודי של האירוע (לדוגמה, מפרסמת את פרטי ההתראה בהודעה ב-Discord).
כדי לקבל מידע נוסף על כל אירועי ההתראות שאפשר לתעד, תוכלו לקרוא את מאמרי העזרה של App Distribution התראות.
השלבים הבאים
במאמר יצירת קישורי הזמנות מוסבר איך להגדיל את בסיס הבדיקה הפנימית.