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


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

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

אם עדיין לא עשיתם זאת, מוסיפים את Firebase ל-Android project.

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

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

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

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

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

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

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

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

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

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

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

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

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

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

השלבים הבאים