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

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

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

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

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

    appdistribution:distribute options
    --app

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

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

    טוקן לרענון שמוצג כשמאמתים את סביבת ה-CI באמצעות Firebase CLI (מידע נוסף זמין במאמר שימוש ב-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

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

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

    --test-devices: "model=shiba,version=34,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

    אם מגדירים את האפשרות הזו כשמריצים בדיקות של App Testing agent, הפקודה תתחיל את הבדיקות ואז תחזור מיד במקום לחכות שהן יסתיימו. כדי לראות את תוצאות הבדיקה, צריך להיכנס למסוף 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 – קישור לגרסה בחוויית הבודקים (קובץ webclip ל-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

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

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

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

השלבים הבאים