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


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

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

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

  • לגלות ולתקן בעיות ספציפיות למכשיר.

  • לבדוק תכונות של קובצי App Bundle, כמו הפצת פיצ'רים ב-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, אתם צריכים להוסיף אותו. בסוף תהליך העבודה הזה, תהיה לכם אפליקציית Android ב-Firebase בפרויקט Firebase.

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

    אפשרויות של appdistribution:distribute
    --app

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

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

    מכשירי הבדיקה שבהם רוצים להריץ בדיקות של סוכן App Testing.

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

    --test-devices: "model=shiba,version=34,locale=en,orientation=portrait"

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

    --test-devices-file: "/path/to/test-devices.txt"
    --test-username

    שם המשתמש להתחברות אוטומטית במהלך בדיקות של סוכן App Testing.
    --test-password
    --test-password-file

    הסיסמה להתחברות אוטומטית שמשמשת במהלך בדיקות של סוכן App Testing.

    אפשר גם לציין את הנתיב לקובץ טקסט פשוט שמכיל סיסמה:

    --test-password-file: "/path/to/test-password.txt"
    --test-username-resource

    שם המשאב של שדה שם המשתמש להתחברות אוטומטית, שישמש במהלך בדיקות של סוכן App Testing.
    --test-password-resource

    שם המשאב של שדה הסיסמה להתחברות אוטומטית, שישמש במהלך בדיקות של סוכן App Testing.
    --test-non-blocking

    אם מגדירים את האפשרות הזו כשמריצים בדיקות של סוכן App Testing, הפקודה תתחיל את הבדיקות ואז תחזור מיד במקום לחכות שהן יסתיימו. כדי לראות את תוצאות הבדיקה, צריך להיכנס למסוף Firebase. אם הדגל הזה לא מוגדר, הפקודה תחסום עד שהבדיקות יסתיימו, ותצא עם קוד שגיאה אם אחת מהבדיקות תיכשל.
    --results-bucket

    קטגוריה מותאמת אישית של Google Cloud Storage ‏ (GCS) שבה מאוחסנות תוצאות הבדיקה. אם משאירים את השדה ריק, המערכת משתמשת בקטגוריית ברירת המחדל. הקטגוריה צריכה להיות בבעלות של פרויקט שמופעל בו חיוב, וציון קטגוריה מוביל לחיובים על האחסון שבו נעשה שימוש.

    לדוגמה:

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

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

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

השלבים הבאים