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