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


במדריך הזה מוסבר איך להפיץ חבילות Android App Bundle (AAB) למפתחים באמצעות ה-CLI של Firebase. כלי ה-CLI מאפשר לכם לציין בודקים ותעודות שחרוץ לגרסה של build, ואז להפיץ את ה-build בהתאם.

App Distribution משתלב עם שירות השיתוף הפנימי של האפליקציות של Google Play כדי לעבד את קובצי ה-AAB שאתם מעלים ולהציג חבילות APK שעברו אופטימיזציה לתצורות המכשירים של הבוחנים. הפצת אפליקציות AAB מאפשרת לכם:

  • להריץ חבילות APK שעברו אופטימיזציה (ש-Google Play מספקת) ומותאמות למכשירים של הבוחנים.

  • זיהוי בעיות ספציפיות למכשיר וניפוי באגים שלהן.

  • לבדוק את התכונות של חבילות האפליקציות, כמו הפצת פיצ'רים ב-Play ו-Play Asset Delivery.

  • להקטין את גודל ההורדות של הבודקים.

ההרשאות הנדרשות

כדי להעלות ממשקי AAB אל App Distribution, צריך לקשר את אפליקציית Firebase לאפליקציה ב-Google Play. כדי לבצע את הפעולות האלה, צריכה להיות לכם רמת הגישה הנדרשת.

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

הטבלה הבאה רלוונטית לקישור אפליקציה ב-Firebase לאפליקציה ב-Google Play, וגם להעלאת חבילות AAB.

פעולה במסוף Firebase הרשאת IAM נדרשת תפקידי IAM שכוללים את ההרשאות הנדרשות כברירת מחדל תפקידים נדרשים נוספים
קישור אפליקציה ב-Firebase לאפליקציה ב-Google Play firebase.playLinks.update אחד מהתפקידים הבאים: גישה לחשבון פיתוח Google Play בתור אדמין
העלאת קובצי AAB אל App Distribution firebaseappdistro.releases.update אחד מהתפקידים הבאים: ––

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

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

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

  2. כדי ליצור קישור של Firebase ל-Google Play ולהעלות קובצי AAB, עליכם לוודא שהאפליקציה שלכם עומדת בדרישות הבאות:

    • האפליקציה ב-Google Play ואפליקציית Firebase ל-Android רשומות עם אותו שם חבילה.

    • האפליקציה ב-Google Play מוגדרת במרכז הבקרה של האפליקציות ומופצת באחד מהמסלולים של Google Play (בדיקה פנימית, בדיקה בקבוצה מוגדרת, בדיקה של הקהל הרחב או ייצור).

    • הבדיקה של האפליקציה ב-Google Play הושלמה והאפליקציה פורסמה. האפליקציה תפורסם אם בעמודה App status יוצג אחד מהסטטוסים הבאים: בדיקה פנימית (לא בדיקה פנימית במצב טיוטה), בדיקה בקבוצה מוגדרת, בדיקה של הקהל הרחב או ייצור.

  3. מקשרים את אפליקציית Android ב-Firebase לחשבון הפיתוח ב-Google Play:

    1. במסוף Firebase, עוברים אל Project settings ובוחרים בכרטיסייה Integrations.

    2. בכרטיס Google Play, לוחצים על Link (קישור).
      אם כבר יש לכם קישורים ל-Google Play, לוחצים במקום זאת על Manage (ניהול).

    3. פועלים לפי ההוראות במסך כדי להפעיל את השילוב עם App Distribution ולבחור לאילו אפליקציות ל-Android של Firebase לקשר את Google Play.

    מידע נוסף על קישור ל-Google Play

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

כשתהיו מוכנים להפיץ גרסה של האפליקציה לבודקים, תוכלו ליצור את קובץ ה-AAB (הוראות מפורטות זמינות במסמכי התיעוד של Android Studio).

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

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

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

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

    appdistribution:distribute options
    --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.aab  \
    --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 לצד הבוחן במהדורה. כדי לחדש את ההזמנה, שולחים אותה מחדש באמצעות התפריט הנפתח בשורה של הבודק.

השלבים הבאים