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

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

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

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

ייצוא ידני של מזהי UDID

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

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

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

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

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

  2. מוסיפים את המכשירים הרשומים לפרופיל ההקצאה.
  3. מורידים את פרופיל ההקצאה ומשתמשים בו כדי לבנות מחדש את האפליקציה. אם אתם בונים מחדש רק כדי לעדכן את המכשירים הרשומים, אל תעדכנו את מספר ה-build או את הגרסה.
  4. מפיצים מחדש את האפליקציה דרך מסוף Firebase או CLI. אם לא משנים את הגרסה, את מספר ה-build או את קוד האפליקציה, ‫App Distribution לא יוצרת גרסה חדשה ולא שולחת הודעה לבודקים. אם כבר הפצתם גרסה עם אותו מספר גרסה ואותו מספר 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 alerts.
  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. מתקינים את ה-CLI של Firebase ונכנסים אליו.
    3. מאתחלים את Cloud Functions for Firebase באמצעות ה-CLI של Firebase.

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

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

השלבים הבאים