במדריך הזה מוסבר איך להפיץ חבילות 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
|
אחד מהתפקידים הבאים: | –– |
לפני שמתחילים
אם עדיין לא עשיתם זאת, מוסיפים את Firebase לפרויקט Android. בסוף תהליך העבודה הזה תהיה לכם אפליקציית Android ב-Firebase בפרויקט שלכם ב-Firebase.
אם אתם לא משתמשים במוצרים אחרים של Firebase, עליכם רק ליצור פרויקט ולרשום את האפליקציה. אם תחליטו להשתמש במוצרים נוספים, הקפידו להשלים את כל השלבים המפורטים במאמר הוספת Firebase לפרויקט Android.
כדי ליצור קישור של Firebase ל-Google Play ולהעלות קובצי AAB, צריך לוודא שהאפליקציה עומדת בדרישות הבאות:
האפליקציה ב-Google Play ואפליקציית Firebase ל-Android רשומות עם אותו שם חבילה.
האפליקציה ב-Google Play מוגדרת במרכז הבקרה של האפליקציות ומופצת באחד מהמסלולים של Google Play (בדיקה פנימית, בדיקה בקבוצה מוגדרת, בדיקה של הקהל הרחב או ייצור).
הבדיקה של האפליקציה ב-Google Play הושלמה והאפליקציה פורסמה. האפליקציה שלכם תפורסם אם בעמודה סטטוס האפליקציה יופיע אחד מהסטטוסים הבאים: בדיקה פנימית (לא בדיקה פנימית של גרסת טיוטה), בדיקה בקבוצה מוגדרת, בדיקה של הקהל הרחב או סביבת ייצור.
מקשרים את אפליקציית Android ב-Firebase לחשבון הפיתוח ב-Google Play:
במסוף Firebase, עוברים אל
ובוחרים בכרטיסייה Integrations. Project settings בכרטיס Google Play, לוחצים על Link (קישור).
אם כבר יש לכם קישורים ל-Google Play, לוחצים במקום זאת על Manage (ניהול).פועלים לפי ההוראות במסך כדי להפעיל את השילוב עם App Distribution ולבחור לאילו אפליקציות ל-Android של Firebase לקשר את Google Play.
שלב 1. פיתוח האפליקציה
כשתהיו מוכנים להפיץ גרסה של האפליקציה לבודקים, תוכלו ליצור את קובץ ה-AAB (הוראות מפורטות זמינות במסמכי התיעוד של Android Studio).
שלב 2. הפצת האפליקציה לבודקים
כדי להפיץ את האפליקציה לבודקים, מעלים את הקובץ של האפליקציה באמצעות ה-CLI של Firebase:
- מתקינים או מעדכנים את הגרסה האחרונה של Firebase CLI (מומלץ להוריד את הקובץ הבינארי העצמאי של ה-CLI הספציפי למערכת ההפעלה שלכם). חשוב להיכנס לחשבון ולבדוק שיש לכם גישה לפרויקטים.
- בדף App Distribution במסוף Firebase, בוחרים את האפליקציה שרוצים להפיץ ולוחצים על Get started (תחילת העבודה).
-
מריצים את הפקודה
appdistribution:distribute
כדי להעלות את האפליקציה ולהפיץ אותה לבודקים. משתמשים בפרמטרים הבאים כדי להגדיר את ההפצה:appdistribution:distribute options --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
סוגי ההפצה הבאים הם חלק מתכונת הבטא של הבודק האוטומטי.
מכשירי הבדיקה שבהם רוצים להפיץ את גרסאות ה-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 לצד הבוחן במהדורה. כדי לחדש את ההזמנה, שולחים אותה מחדש באמצעות התפריט הנפתח בשורה של הבוחן.
השלבים הבאים
כדאי להטמיע משוב מתוך האפליקציה כדי לאפשר לבודקים לשלוח בקלות משוב על האפליקציה (כולל צילומי מסך).
איך מציגים לבודקים התראות בתוך האפליקציה כשגרסאות build חדשות של האפליקציה זמינות להתקנה?
שיטות מומלצות להפצת אפליקציות ל-Android למבדקי בקרת איכות באמצעות CI/CD