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

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

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

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

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

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

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

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

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

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

  2. מוסיפים את המכשירים הרשומים לפרופיל ההקצאה.
  3. מורידים את פרופיל ההקצאה ומשתמשים בו כדי לבנות מחדש את האפליקציה. אם אתם בונים מחדש רק כדי לעדכן את המכשירים הרשומים, אל תעדכנו את מספר ה-build או את הגרסה.
  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 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.

השלבים הבאים