במדריך הזה מוסבר איך להפיץ חבילות APK לבודקים באמצעות ה-CLI של Firebase. כלי ה-CLI מאפשר לכם לציין בודקים ותעודות שחרוץ לגרסה של build, ואז להפיץ את ה-build בהתאם.
לפני שמתחילים
אם עדיין לא עשיתם זאת, מוסיפים את Firebase לפרויקט Android.
אם אתם לא משתמשים במוצרים אחרים של Firebase, עליכם רק ליצור פרויקט ולרשום את האפליקציה. עם זאת, אם תחליטו להשתמש במוצרים נוספים בעתיד, הקפידו להשלים את כל השלבים שמפורטים בדף שמקושר למעלה.
שלב 1. פיתוח האפליקציה
כשתהיו מוכנים להפיץ גרסה של האפליקציה לבדיקה לפני ההשקה, תוכלו ליצור את קובץ ה-APK באמצעות התהליך הרגיל. עליך לחתום על ה-APK באמצעות ניפוי הבאגים מפתח או חתימת אפליקציה.
שלב 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.apk \ --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.