Catch up on everthing we announced at this year's Firebase Summit. Learn more

הפץ אפליקציות אנדרואיד לבודקים באמצעות 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

    דגל שאתה יכול לכלול כדי להדפיס פלט יומן מפורט.

    לדוגמה:

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

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

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

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

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