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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

השלבים הבאים