הפץ אפליקציות iOS לבודקים באמצעות Firebase CLI

אתה יכול להפיץ builds לבודקים באמצעות Firebase CLI. כלי CLI מאפשר לך לציין בודקים והערות שחרור לבנייה ולהפיץ את המבנה בהתאם.

לפני שאתה מתחיל

אם לא עשית זאת עדיין, להוסיף Firebase לפרויקט iOS שלך .

אם אינך משתמש במוצרי Firebase אחרים, עליך רק ליצור פרויקט ולרשום את האפליקציה שלך. עם זאת, אם תחליט להשתמש במוצרים נוספים בעתיד, הקפד להשלים את כל השלבים בדף המקושר למעלה.

שלב 1. בנה את האפליקציה שלך

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

  • כדי להפיץ את האפליקציה שלך מעבר לצוות הפיתוח שלך, עליך להשתמש ב- Ad Hoc או בפרופיל ההפצה הארגוני שלך.
  • אם האפליקציה משתמשת משחק מרכז, APNs (ובמשתמע, Cloud Messaging ), או iCloud, לוודא פרופיל ההקצאה שלך משתמש מזהה אפליקציה מפורשת, ולא מזהים כללי.
  • אם אתה משתמש בפרופיל הפצה אד הוק, כלול את מזהי המכשיר הייחודיים (UDID) של מכשירי הבוחנים שלך. כאשר בודקי iOS חדשים נרשמים לתוכנית הבדיקה שלך, יהיה עליך לעדכן את פרופיל ההקצאה עם UDID של המכשירים שלהם. ראה התקנים בודקים נוספת רשם .
  • אם ביצעת שינויים בקוד מאז ה- build האחרון (כלומר, אתה לא מחדש רק כדי לעדכן את המכשירים הרשומים), לעדכן את מספר הגרסה המוצגת למשתמש של הצטברות היעד (גרסה) ומספר לבנות ייחודית (Build).

עם השלמת הבנייה, הוא שומר קובץ IPA וכמה קבצי יומן בתיקייה שציינת. אתה מפיץ את קובץ ה- IPA לבוחנים שלך בשלבים הבאים.

שלב 2. הפץ את האפליקציה שלך לבודקים

כדי להפיץ את האפליקציה שלך לבוחנים, העלה את קובץ ה- IPA באמצעות Firebase CLI:

  1. להתקין או לעדכן לגרסה העדכנית של Firebase CLI (אנחנו ממליצים להוריד את הבינארי העצמאי עבור ספציפיים CLI את מערכת ההפעלה שלך). הקפד להתחבר ולבדוק כי אתה יכול לגשת הפרויקטים שלך.
  2. ב דף חלוקת היישומים של קונסולת Firebase, לבחור את האפליקציה שאתה רוצה להפיץ, ולאחר מכן לחץ על התחל.
  3. הפעל את appdistribution:distribute הפקודה להעלות האפליקציה שלך ולהפיץ אותו עבור הבוחנים. השתמש בפרמטרים הבאים כדי להגדיר את ההפצה:

    הפצת האפליקציות: הפצת אפשרויות
    --app

    נדרש: זיהוי האפליקציה Firebase של האפליקציה. אתה יכול למצוא את מזהה האפליקציה במסוף Firebase, על דף ההגדרות הכלליות .

    --app 1:1234567890:ios:0a1b2c3d4e5f67890
    --token

    רענון אסימון זה מודפס כשאתה לאמת הסביבה CI שלך עם Firebase CLI (לקרוא השתמש CLI עם מערכות CI למידע נוסף).

    --token "$FIREBASE_TOKEN"
    --release-notes
    --release-notes-file

    הערות גרסה לבנייה זו.

    תוכל לציין את הערות המהדורה ישירות:

    --release-notes "Text of release notes"

    לחלופין, ציין את הנתיב לקובץ טקסט רגיל:

    --release-notes-file "/path/to/release-notes.txt"
    --testers
    --testers-file

    כתובות הדוא"ל של הבוחנים שברצונך להזמין.

    תוכל לציין את הבוחנים כרשימה מופרדת בפסיקים של כתובות דוא"ל:

    --testers "ali@example.com, bri@example.com, cal@example.com"

    לחלופין, תוכל לציין את הנתיב לקובץ טקסט רגיל המכיל רשימה מופרדת בפסיקים של כתובות דוא"ל:

    --testers-file "/path/to/testers.txt"
    --groups
    --groups-file

    הקבוצות בודקות שברצונך להזמין (עיינו ניהול בודקים ). קבוצות מוגדרות באמצעות כינויים קבוצתיים , שתוכל לחפש במסוף Firebase.

    ניתן לציין את הקבוצות כרשימה המופרדת בפסיקים:

    --groups "qa-team, trusted-testers"

    לחלופין, תוכל לציין את הנתיב לקובץ טקסט רגיל המכיל רשימה המופרדת בפסיקים של שמות קבוצות:

    --groups-file "/path/to/groups.txt"
    --debug

    דגל שאתה יכול לכלול להדפסת פלט יומן מילולי.

    לדוגמה:

    firebase appdistribution:distribute test.ipa  \
        --app 1:1234567890:ios:0a1b2c3d4e5f67890  \
        --release-notes "Bug fixes and improvements" --testers-file testers.txt
    

    בנוסף משחרר הפצה, אתה יכול גם להשתמש appdistribution:testers:add ואת appdistribution:testers:remove להזמין בודקים חדשים או סר של בודקים קיימים מפרויקט Firebase שלך. לאחר שבוחן בודק לפרויקט Firebase שלך, תוכל להוסיף אותו למהדורות בודדות. לאחר שתסיר בודק, לא תהיה להם יותר גישה למהדורות בפרויקט שלך. שים לב שבודקים שהוסרו לאחרונה עדיין יכולים לשמור על הגישה למהדורות שלך למשך פרק זמן.

    לדוגמה:

    firebase appdistribution:testers:add anothertester@email.com moretesters@email.com
    
    firebase appdistribution:testers:remove anothertester@email.com moretesters@email.com
    

    יש להפריד בין מיילים של בודקים לרווח. ניתן גם לציין בודקים באמצעות --file /path/to/testers.txt .

לאחר שתפיץ את המבנה שלך, הוא יהיה זמין בלוח המחוונים של הפצת האפליקציות של מסוף Firebase למשך 150 יום (חמישה חודשים). כאשר המבנה הוא 30 יום מפקיעתו, מופיעה הודעת תפוגה הן במסוף והן ברשימת הבניות של הבוחן במכשיר הבדיקה שלהם.

בודקים שלא הוזמנו לבדוק את האפליקציה מקבלים הזמנות בדוא"ל כדי להתחיל, ובדקו קיים ולקבל הודעות דואר אלקטרוניות חדש לבנות מוכן לבדוק (לקרוא את הסט בודק את המדריך כדי לקבל הוראות כיצד להתקין את האפליקציה לבדיקה). אתה יכול לעקוב אחר הסטטוס של כל בודק-האם הם קיבלו את ההזמנה והאם הורדו את האפליקציה במסוף Firebase.

שלב 3. רשום מכשירים נוספים

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

כאשר אתה מקבל אחד מהודעות הדוא"ל האלה, עדכן את פרופיל ההקצאה שלך עם ה- UDID והפיץ מבנה חדש לבודקים שלך על ידי ביצוע השלבים הבאים:

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

      בלשונית הבודקים & קבוצות של לוח מחווני חלוק היישומים, בחר כול בודקים, ולאחר מכן לחץ על ייצוא אפל לרכיבים UDID להוריד קובץ CSV. הבא, לייבא את הקובץ שלך לחשבון המפתחים של אפל באמצעות אפשרות המכשירים מרובים הרישום. עיין בתיעוד של Apple כדי ללמוד עוד.

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

    • אפשרות 2: לאסוף להיכנס לרכיבי UDID בדוא"ל.

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

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