רישום של מכשירי 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.

ייצוא ידני של מזהי מכשירים ייחודיים

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

      בכרטיסייה בודקים וקבוצות בלוח הבקרה App Distribution, בוחרים באפשרות כל הבודקים ולוחצים על ייצוא של מספרי UDID של מכשירי Apple כדי להוריד קובץ CSV. לאחר מכן מייבאים את הקובץ אל חשבון המפתחים של Apple באמצעות האפשרות הרשמה של כמה מכשירים. מידע נוסף זמין במאמר הפצת האפליקציה למכשירים רשומים.

      שימו לב: יכול להיות שחשבון הפיתוח שלכם ב-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. מוסיפים את המכשירים הרשומים לפרופיל ההקצאה.

  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.

השלבים הבאים