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


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

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

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

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

  • בודקים תכונות של חבילות אפליקציות כמו Play Feature Delivery ו-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 והאפליקציה ל-Android ב-Firebase רשומות עם אותו שם חבילה.

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

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

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

    1. במסוף Firebase, עוברים אל Project settings (הגדרות הפרויקט) ובוחרים בכרטיסייה Integrations (שילובים).

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

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

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

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

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

.

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

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

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

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

    appdistribution:distribute options
    --app

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

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

    טוקן לרענון שמוצג כשמאמתים את סביבת ה-CI באמצעות Firebase CLI (מידע נוסף זמין במאמר שימוש ב-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

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

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

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

השלבים הבאים