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

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

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

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

  3. מריצים את הפקודה appdistribution:distribute כדי להעלות את האפליקציה ולהפיץ אותה לבודקים. משתמשים בפרמטרים הבאים כדי להגדיר את ההתפלגות:

    appdistribution:distribute options
    --app

    חובה: מזהה האפליקציה ב-Firebase. מזהה האפליקציה מופיע במסוף Firebase, בדף General Settings.

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

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

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

    נתוני גרסה בשביל ה-build הזה.

    אפשר לציין את נתוני הגרסה באופן ישיר:

    --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

    דגל שאפשר לכלול כדי להדפיס פלט יומן מפורט.
    --test-devices
    --test-devices-file

    סוגי ההפצה הבאים הם חלק מתכונת הבטא של בודקים אוטומטיים.

    מכשירי הבדיקה שבהם רוצים להפיץ את גרסאות ה-build (מידע נוסף זמין בקטע בדיקות אוטומטיות).

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

    --test-devices: "model=shiba,version=34,locale=en,orientation=portrait;model=b0q,version=33,locale=en,orientation=portrait"

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

    --test-devices-file: "/path/to/test-devices.txt"
    --test-username

    שם המשתמש להתחברות אוטומטית, שישמש במהלך בדיקות אוטומטיות.
    --test-password
    --test-password-file

    הסיסמה להתחברות אוטומטית לשימוש במהלך הבדיקות האוטומטיות.

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

    --test-password-file: "/path/to/test-password.txt"
    --test-username-resource

    שם המשאב של שדה שם המשתמש להתחברות אוטומטית, שישמש במהלך הבדיקות האוטומטיות.
    --test-password-resource

    שם המשאב של שדה הסיסמה לכניסה אוטומטית, שישמש במהלך הבדיקות האוטומטיות.
    --test-non-blocking

    להריץ בדיקות אוטומטיות באופן אסינכרוני. תוצאות הבדיקה האוטומטית מוצגות במסוף Firebase.

    לדוגמה:

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

    ה-CLI של Firebase יפיק את הקישורים הבאים אחרי העלאת הגרסה. הקישורים האלה עוזרים לכם לנהל קובצי בינאריים ולוודא שבדיקות ומפתחים אחרים מקבלים את הגרסה הנכונה:

    • firebase_console_uri – קישור למסוף Firebase שבו מוצגת גרסה אחת. אפשר לשתף את הקישור הזה עם מפתחים אחרים בארגון.
    • testing_uri – קישור לגרסה באפליקציית הבודקים (קליפ אינטרנט ל-iOS) שמאפשר לבודקים לראות את נתוני הגרסה ולהתקין את האפליקציה במכשיר שלהם. כדי להשתמש בקישור, למבצע הבדיקה צריכה להיות גישה למהדורה.
    • binary_download_uri - קישור חתום שמוריד ומתקין באופן ישיר את הקובץ הבינארי של האפליקציה (קובץ IPA) . הקישור תקף לשעה אחת.

    ניהול בודקים וקבוצות

    בנוסף להפצת גרסאות, אפשר להשתמש גם ב-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.

    אם יש לכם מספר גדול של בודקים, כדאי להשתמש בקבוצות: אפשר להשתמש ב-appdistribution:group:create וב-appdistribution:group:delete כדי ליצור או למחוק קבוצות בפרויקט Firebase.

    משתמשים ב---group-alias כדי לציין קבוצה לפקודות appdistribution:testers:add ו-appdistribution:testers:remove.

    לדוגמה:

    firebase appdistribution:group:create "QA team" qa-team

firebase appdistribution:testers:add --group-alias=qa-team anothertester@email.com moretesters@email.com

firebase appdistribution:testers:remove --group-alias=qa-team anothertester@email.com moretesters@email.com

firebase appdistribution:group:delete qa-team

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

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

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

השלבים הבאים