במאמר הזה מפורטות שיטות מומלצות לשימוש ב-Firebase App Distribution כדי ליצור תהליכי עבודה של בדיקות לפני השקת גרסה ב-Android, שניתן לשמור ולחזור עליהם בסביבת CI/CD. הפתרונות כוללים את Gradle ו-fastlane, אבל כדי לתת לכם גמישות רבה יותר, אנחנו כוללים גם פתרונות שזמינים דרך Firebaseהמסוף, Firebaseממשק ה-CLI וFirebase App Distributionממשק ה-API הציבורי. אנחנו גם מתארים את המגבלות על פרסום גרסאות ועל משתמשי בדיקה, כדי שתוכלו לתכנן מראש חוויה אופטימלית.
אם אתם משתמשים גם בפלטפורמות של אפל, כדאי לעיין במאמר שיטות מומלצות להפצת אפליקציות של אפל לבודקי QA באמצעות CI/CD ו-fastlane.
לפני שמתחילים
לפני שמיישמים את השיטות המומלצות שמתוארות במאמר הזה, חשוב להפעיל את App Distribution ב-Firebase Console לכל אפליקציה. אם לא הפעלתם את App Distribution, תוצג לכם שגיאה 404.
כדי להפעיל את App Distribution:
- פותחים את הדף App Distribution במסוף Firebase.
- בוחרים את האפליקציה ל-Android.
- לוחצים על Get Started.
חבילות Android App Bundle (AAB) הופכות לפורמט החבילה הנפוץ ביותר ב-Android, ולכן מומלץ להגדיר את האפשרות להפצת חבילות AAB לבודקים על ידי קישור אל Google Play.
אוטומציה של תהליך העבודה של בדיקות טרום-השקה באמצעות צינור עיבוד נתונים של CI/CD
אם אתם רוצים להפוך את תהליך הבנייה וההפצה של אפליקציות לבוחנים לאוטומטי, ואתם משתמשים ב-CI/CD, מומלץ להשתמש ב-fastlane או ב-Gradle. אפשרות נוספת היא להשתמש ב-Firebase CLI, שמאפשר גישה למגוון רחב של מוצרי Firebase.
שימוש ב-fastlane
שילוב של App Distribution בצינור CI/CD באמצעות fastlane, כלי קוד פתוח שמבצע אוטומציה של בנייה ושחרור של אפליקציות ל-iOS ול-Android. כשאתם יוצרים ומפיצים את הגרסאות האחרונות של האפליקציה לבודקים באופן אוטומטי, אתם מוודאים שלבודקים תמיד תהיה גרסת הבדיקה העדכנית ביותר של האפליקציה.
במאמר הפצת אפליקציות ל-Android לבודקים באמצעות fastlane מוסבר איך לשלב את App Distribution עם fastlane.
שימוש ב-Gradle
משתמשים ב-Gradle כדי לשלב את App Distribution בתהליך ה-build של Android באמצעות הפלאגין App Distribution Gradle. התוסף מאפשר לכם לציין את הבודקים שלכם ואת הערות הגרסה בקובץ build.gradle של האפליקציה, וכך להגדיר הפצות לסוגים שונים של גרסאות build ולוריאציות של האפליקציה.
במאמר הפצת אפליקציות Android לבודקים באמצעות Gradle מוסבר איך לשלב את App Distribution עם Gradle.
שימוש ב-CLI של Firebase
משתמשים בכלים של Firebase CLI ש-App Distribution מספקת כדי להפיץ גרסאות build לבודקים באופן פרוגרמטי. אפשר לציין בודקים והערות על הגרסה.
מפיצים את הגרסה האחרונה של Android build על ידי ציון מזהה האפליקציה ב-Firebase, ואפשר גם להוסיף הערה על הגרסה וקובץ שמכיל את כתובות האימייל של הבודקים:
firebase appdistribution:distribute test.aab \
--app 1:1234567890:android:0a1b2c3d4e5f67890 \
--release-notes "Bug fixes and improvements" --testers-file testers.txt
מידע נוסף על שימוש ב-Firebase CLI כדי להפוך את תהליך הבנייה לאוטומטי זמין במאמר הפצת אפליקציות ל-Android לבודקים באמצעות Firebase CLI.
שימוש בפרטי כניסה לשירות לצורך אימות
משתמשים בApp Distribution תוסף fastlane, בתוסף Gradle או ב-CLI של Firebase עם חשבונות שירות. חשבון שירות הוא סוג של חשבון Google שמייצג אפליקציות (בניגוד למשתמשים). מערכת ה-CI יכולה להשתמש בחשבונות שירות כדי להריץ את עומסי העבודה שלכם ב-App Distribution. מידע נוסף זמין במאמר אימות באמצעות חשבון שירות.
אם אתם משתמשים באיחוד שירותי אימות הזהויות של עומסי עבודה, אתם יכולים ליצור ולהשתמש בקובץ הגדרות של פרטי כניסה במקום במפתח של חשבון שירות.
חשוב לזכור את מגבלות הפרסום
App Distribution תומך במקסימום 1,000 גרסאות של כל אפליקציה. כלומר, אם חורגים ממגבלת הגרסאות, App Distribution מוחק באופן אוטומטי את הגרסאות הכי ישנות שמעבר למגבלה. כאן אפשר לקרוא על ניהול מגבלות על פרסום אפליקציות
הוספה של אותה קבוצת בודקים לכמה גרסאות
אם רוצים להוסיף מספר גדול של בודקים לגרסאות, אפשר להשתמש בפונקציונליות של App Distribution לניהול בודקים בכמות גדולה.
מומלץ להשתמש בקבוצות כדי להוסיף את אותם בודקים לכמה גרסאות. קבוצה פועלת כרשימת בקרת גישה. כשמסירים בודק מקבוצה, הוא מאבד את הגישה לכל הגרסאות שמופצות לקבוצה הזו. למידע נוסף, אפשר לעיין במאמר הוספה והסרה של בודקים מקבוצה.
אם יש לכם הרבה בודקים לניהול, אתם יכולים להוסיף ולמחוק בודקים בכמות גדולה באמצעות מסוף Firebase. כדי להוסיף ולהסיר בודקים באופן אוטומטי, אפשר להשתמש ב-Firebase CLI, ב-fastlane, ב-Gradle או ב-public Firebase App Distribution API.
חשוב לזכור את המגבלות על בודקים
App Distribution מגביל את מספר הבודקים שאפשר להוסיף לפרויקט Firebase או לקבוצת App Distribution. אם תחרגו מהמגבלות האלה, לא תוכלו להפיץ את האפליקציה לבודקים נוספים. מידע נוסף על מגבלות הבודקים זמין במאמר האם יש מגבלות על הוספת בודקים לאפליקציה שלי?
הפעלת אפשרות לבודקים פוטנציאליים להירשם לבדיקה
כדי להפיץ את האפליקציה ליותר בודקים בקלות, מומלץ להשתמש בקישורי הזמנה. קישור להזמנה הוא כתובת URL ייחודית שמאפשרת לבודקים להזין את כתובות האימייל שלהם כדי להירשם לבדיקת אפליקציה. אם מאפשרים למשתמשים להוסיף את עצמם לרשימת בודקי האפליקציה, אפשר להגדיל את בסיס הבודקים הפנימיים בצורה חלקה.
מקרים לדוגמה לשימוש בקישורי הזמנה כוללים תוכניות dogfood בחברות, ארגונים עם צוותי QA גדולים וקבוצות מפתחים שרוצים לאפשר ללקוחות פרטיים לשלוט בגישת הבודקים.
מומלץ ליצור קישור להזמנה לקבוצה. כל בודק שנרשם באמצעות קישור ההזמנה יתווסף אוטומטית לגרסאות הבאות.
מידע נוסף זמין במאמרים בנושא יצירת קישורים להזמנה והוספה והסרה של בודקים מקבוצה.
מוודאים שהבודקים בודקים את הגרסה שחשובה לכם
כשמעלים גרסה חדשה, הבודקים מקבלים על כך הודעה באימייל. כדי להשלים את ההודעה הזו, אפשר להשתמש בתכונות הבאות – קישורי גרסה והתראות בתוך האפליקציה – כדי לוודא שהבודקים בודקים את גרסת האפליקציה הספציפית שחשובה לכם:
- קישורים לגרסאות: משתמשים בתכונה הזו כשרוצים לשתף גרסה ספציפית עם בודקים. במאמר הפצת אפליקציות ל-Android לבודקים באמצעות Firebase מוסבר איך משתמשים בקישורי הפצה. הקישורים האלה זמינים גם בכלי שורת הפקודה (CLI) של Firebase, fastlane ו-Gradle, שאפשר להשתמש בהם עם כלי אוטומציה של גרסאות build.
- התראות בתוך האפליקציה: כדאי להשתמש בהתראות האלה כשרוצים לוודא שהבודקים בודקים את הגרסה העדכנית של האפליקציה. אם משלבים את App Distribution Android SDK של Firebase, אפשר להציג התראות ישירות בתוך האפליקציה לבודקים כשגרסאות חדשות של האפליקציה זמינות. כך מוסיפים התראות בתוך האפליקציה.
הסרה אוטומטית של הגישה לבודקים שעוזבים את החברה
אחרי שהתחלתם להשתמש בתהליך הבדיקה הפנימי של CI/CD, אתם צריכים לוודא שלאנשים שעוזבים את החברה אין יותר גישה לבנייה הפנימית. כדי לעזור לכם לנהל את הגישה של הבודקים לגרסאות Build, App Distribution מספק את האפשרויות הבאות:
- fastlane: אפשר להשתמש בקובץ Fastfile או להפעיל ישירות פעולות של fastlane. מידע נוסף זמין במאמר הפצת אפליקציות ל-Android לבודקים באמצעות fastlane.
- Firebase CLI: משתמשים בפקודה
firebase appdistribution:testers:removeaction. מידע נוסף זמין במאמר הפצת אפליקציות ל-Android לבודקים באמצעות Firebase CLI. - Gradle: אם אתם משתמשים ב-Gradle כדי להסיר בודקים, צריך להעביר את
appDistributionRemoveTestersעם הארגומנטיםו---PROJECT_NUMBER בקובץ--EMAILS build.gradle. מידע נוסף זמין במאמר בנושא הפצת אפליקציות ל-Android לבודקים באמצעות Gradle. - **Public
Firebase App Distribution API:
** משתמשים בנקודת הקצה
testers.batchRemove.