רישום של מכשירי iOS נוספים

אם רוצים להפיץ גרסאות ad hoc של iOS באמצעות App Distribution, צריך לפעול לפי ההוראות במדריך הזה כדי לרשום את המכשירים של הבודקים. גרסה אד-הוק היא גרסה שלא נחתמה באמצעות פרופיל ארגוני. אפשר להתקין במכשיר גרסת ad hoc רק אם המזהה הייחודי של המכשיר (UDID) כלול בפרופיל ההקצאה של הגרסה.

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

כשמקבלים אימייל עם UDID, צריך לעדכן את פרופיל ההקצאה עם ה-UDID ולהפיץ גרסה חדשה לבודקים. אפשר לייצא UDID באופן ידני באמצעות מסוף Firebase או Firebase CLI, או לייצא UDID באופן פרוגרמטי באמצעות fastlane.

ייצוא ידני של מספרי UDID

  1. מוסיפים את המכשירים לפורטל המפתחים של Apple.
    • אפשרות 1: ייבוא של מספרי ה-UDID של המכשירים כקובץ CSV.

      בכרטיסייה Testers & Groups (בודקים וקבוצות) בלוח הבקרה App Distribution, בוחרים באפשרות All testers (כל הבודקים) ולוחצים על Export Apple UDIDs (ייצוא מספרי UDID של אפל) כדי להוריד קובץ CSV. לאחר מכן, מייבאים את הקובץ אל חשבון הפיתוח של Apple באמצעות האפשרות Register Multiple Devices (רישום של כמה מכשירים). מידע נוסף זמין במאמר בנושא הפצת האפליקציה למכשירים רשומים.

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

    • אפשרות 2: איסוף של מספרי UDID והזנתם באימייל.

      בדף Add Devices (הוספת מכשירים) בפורטל למפתחים של אפל, רושמים את ה-UDID החדש שצוין באימייל שקיבלתם.

  2. מוסיפים את המכשירים הרשומים לפרופיל ההקצאה.
  3. מורידים את פרופיל ההקצאה ומשתמשים בו כדי לבנות מחדש את האפליקציה. אם אתם בונים מחדש רק כדי לעדכן את המכשירים הרשומים, אל תעדכנו את מספר הבנייה או הגרסה.
  4. להפיץ מחדש את האפליקציה ממסוף Firebase או מ-CLI. אם לא משנים את הגרסה, את מספר ה-build או את הקוד של האפליקציה, App Distribution לא נוצרת גרסה חדשה ולא נשלחת הודעה לבודקים. אם כבר הפצתם גרסת build עם אותו מספר Build ואותה גרסה, רק משתמשים במכשירים שנרשמו לאחרונה יקבלו התראות באימייל.

ייצוא של מספרי UDID באופן פרוגרמטי באמצעות fastlane

  1. מייצאים את כל מספרי ה-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

  2. מייבאים את מספרי ה-UDID אל חשבון הפיתוח של Apple באמצעות האפשרות Register Multiple Devices(רישום של כמה מכשירים). מידע נוסף זמין במסמכי התיעוד של Apple. שימו לב: יכול להיות שחשבון הפיתוח שלכם ב-Apple מאפשר ייבוא של מספר מוגבל של מכשירים בשנה.

  3. מוסיפים את המכשירים הרשומים לפרופיל ההקצאה {: .external}.

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

  5. מפיצים מחדש את האפליקציה. אם לא משנים את הגרסה, את מספר ה-build או את הקוד של האפליקציה, App Distribution לא יוצרת גרסה חדשה ולא שולחת הודעה לבוחנים. אם כבר הפצתם build עם אותו מספר Build וגרסה, רק משתמשים במכשירים שנרשמו לאחרונה יקבלו התראות באימייל.

קבלת התראות

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

כברירת מחדל, Firebase יכול לשלוח App Distributionהתראות על רישום מכשיר iOS חדש באמצעות אימייל.

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

כברירת מחדל, כל חברי הפרויקט (שיש להם את ההרשאות הנדרשות לקבלת התראות) יקבלו אימייל כשמכשיר iOS חדש יירשם.

הפעלה או השבתה של התראות בחשבון שלכם

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

כדי להפעיל או להשבית את App Distribution ההתראות, פועלים לפי השלבים הבאים:

  1. בפינה השמאלית העליונה של מסוף Firebase, לוחצים על התראות של Firebase.
  2. אחר כך עוברים אל הגדרות ומגדירים את ההעדפה של החשבון לגבי התראות App Distribution.

הגדרת התראות מתקדמות לשירותי צד שלישי

אתם יכולים גם לשלוח התראות App Distribution לערוץ ההתראות המועדף של הצוות באמצעות Cloud Functions for Firebase. לדוגמה, אפשר לכתוב פונקציה שתתעד אירוע התראה על רישום של מכשיר iOS חדש ותפרסם את פרטי ההתראה בשירות של צד שלישי, כמו Discord,‏ Slack או Jira.

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

כדי להגדיר יכולות מתקדמות של התראות באמצעות Cloud Functions for Firebase, פועלים לפי השלבים הבאים:

  1. מגדירים את Cloud Functions for Firebase, שכולל את המשימות הבאות:

    1. מגדירים סביבת פיתוח ל-Node.js או ל-Python.
    2. מתקינים את Firebase CLI ונכנסים לחשבון.
    3. מאתחלים את Cloud Functions for Firebase באמצעות ה-CLI של Firebase.

  2. כתיבה ופריסה של פונקציה שתתעד אירוע התראה מ-App Distribution ותטפל במטען הייעודי (payload) של האירוע (לדוגמה, תפרסם את פרטי ההתראה בהודעה ב-Discord).

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

השלבים הבאים