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


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

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

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

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

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

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

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

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

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

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

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

    אפשרויות של appdistribution:distribute
    --app

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

    --app 1:1234567890:android: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.apk  \
    --app 1:1234567890:android:0a1b2c3d4e5f67890  \
    --release-notes "Bug fixes and improvements" --testers-file testers.txt

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

    • ‫firebase_console_uri – קישור למסוף Firebase שבו מוצגת גרסה אחת. אפשר לשתף את הקישור הזה עם מפתחים אחרים בארגון.
    • testing_uri – קישור לגרסה בחוויית הבודק (אפליקציית Android מובנית) שמאפשר לבודקים לראות את הערות הגרסה ולהתקין את האפליקציה במכשיר שלהם. כדי להשתמש בקישור, הבודק צריך גישה לגרסה.
    • binary_download_uri – קישור חתום שמוריד ומתקין ישירות את הקובץ הבינארי של האפליקציה (קובץ APK או AAB). התוקף של הקישור יפוג אחרי שעה.

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

    בנוסף להפצת גרסאות, אפשר גם להשתמש ב-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 לצד הבודק בגרסה. כדי לחדש הזמנה, אפשר לשלוח אותה מחדש באמצעות התפריט הנפתח בשורה של הבודק.

השלבים הבאים