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

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

לפני שמתחילים

  1. אם עדיין לא הוספתם את Firebase לפרויקט Apple, אתם צריכים להוסיף אותו.

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

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

שלב 1. הפצת האפליקציה לבודקים

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

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

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

    אפשרויות של appdistribution:distribute
    --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

    מכשירי הבדיקה שבהם רוצים להריץ בדיקות של סוכן App Testing.

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

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

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

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

    שם המשתמש להתחברות אוטומטית במהלך בדיקות של סוכן App Testing.
    --test-password
    --test-password-file

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

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

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

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

    שם המשאב של שדה הסיסמה להתחברות אוטומטית, שישמש במהלך בדיקות של סוכן App Testing.
    --test-non-blocking

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

    קטגוריה מותאמת אישית של Google Cloud Storage ‏(GCS) שבה מאוחסנות תוצאות הבדיקה. אם משאירים את השדה ריק, המערכת משתמשת בקטגוריית ברירת המחדל. הקטגוריה צריכה להיות בבעלות של פרויקט שמופעל בו חיוב, וציון קטגוריה מוביל לחיובים על האחסון שבו נעשה שימוש.

    לדוגמה:

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

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

    • ‫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 ימים (חמישה חודשים). כשהתוקף של גרסת ה-build עומד לפוג בעוד 30 יום, מופיעה הודעת תפוגה גם במסוף וגם ברשימת גרסאות ה-build של הבודק במכשיר הבדיקה שלו.

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

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

השלבים הבאים