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