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

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

לפני שאתה מתחיל

אם עדיין לא עשית זאת, הוסף את Firebase לפרויקט Android שלך .

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

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

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

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

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

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

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

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

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

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

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

    הערות גרסה עבור המבנה הזה.

    אתה יכול לציין את הערות השחרור ישירות:

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

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

    מכשירי הבדיקה שאליהם ברצונך להפיץ builds (עיין בבדיקות אוטומטיות ).

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

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

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

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

הצעדים הבאים