מסמך זה מציג שיטות עבודה מומלצות לשימוש ב-Firebase App Distribution כדי להפוך את זרימות העבודה של בדיקות טרום-הפצה של Android לבר-קיימא וניתנות לשחזור בסביבת CI/CD. הפתרונות כוללים את Gradle ו-fastlane, אבל כדי להעניק לך גמישות רבה עוד יותר, אנו כוללים גם פתרונות הזמינים דרך קונסולת Firebase, Firebase CLI וממשק ה-API הציבורי של Firebase App Distribution. אנו גם מתארים את מגבלות השחרור והבודקים כדי שתוכל לתכנן מראש לחוויה אופטימלית.
אם אתה משתמש גם בפלטפורמות של Apple, ראה שיטות עבודה מומלצות להפצת יישומי Apple לבודקי QA באמצעות CI/CD ו-fastlane .
לפני שאתה מתחיל
לפני שתטמיע את השיטות המומלצות במסמך זה, הקפד להפעיל את הפצת אפליקציות במסוף Firebase עבור כל אפליקציה . אם לא הפעלת את הפצת אפליקציות, תקבל שגיאת 404.
כדי להפעיל את הפצת אפליקציות, בצע את השלבים הבאים:
- פתח את דף הפצת האפליקציות במסוף Firebase.
- בחר את אפליקציית Android שלך.
- לחץ על התחל .
בהתחשב בכך שחבילות Android App Bundles (AAB) הופכות לפורמט החבילות הנפוץ ביותר של Android, אנו ממליצים שתגדיר את היכולת להפיץ AABs לבודקים שלך על ידי קישור ל-Google Play .
הפוך את זרימת העבודה לבדיקת טרום-הפצה שלך לאוטומטית באמצעות צינור CI/CD
אם אתה רוצה להפוך את הבנייה והשחרור של אפליקציות לבודקים שלך אוטומטית ואתה משתמש ב-CI/CD, אנו ממליצים להשתמש ב-fastlane או Gradle . אפשרות נוספת היא להשתמש ב- Firebase CLI , המאפשר לך לגשת למגוון רחב של מוצרי Firebase.
השתמש ב-fastlane
שלב את הפצת אפליקציות בצינור ה-CI/CD שלך באמצעות Fastlane, כלי קוד פתוח הממכן בנייה והפצה של אפליקציות iOS ו-Android. על ידי בנייה והפצה של המהדורות האחרונות שלך לבודקים באופן אוטומטי, אתה מבטיח לבודקים תמיד את גרסת הבדיקה העדכנית ביותר של האפליקציה שלך.
כדי ללמוד כיצד לשלב את הפצת אפליקציות עם fastlane, ראה הפצת אפליקציות אנדרואיד לבודקים המשתמשים ב-fastlane .
השתמש ב- Gradle
השתמש ב-Gradle כדי לשלב את הפצת אפליקציות בתהליך הבנייה שלך ב-Android באמצעות הפלאגין App Distribution Gradle. הפלאגין מאפשר לך לציין את הבודקים ואת הערות השחרור שלך בקובץ build.gradle
של האפליקציה שלך, המאפשר לך להגדיר הפצות עבור סוגי build וגרסאות שונות של האפליקציה שלך.
כדי ללמוד כיצד לשלב את הפצת אפליקציות עם Gradle, ראה הפצת אפליקציות Android לבודקים באמצעות Gradle .
השתמש ב-Firebase CLI
השתמש בכלי Firebase CLI ש-App Distribution מספקת כדי להפיץ Builds לבודקים באופן פרוגרמטי. אתה יכול לציין בודקים והערות שחרור עבור build.
הפץ את בניית ה-Android העדכנית ביותר שלך על ידי ציון מזהה האפליקציה של האפליקציה של 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 , או ב-Firebase CLI עם חשבונות שירות. חשבון שירות הוא סוג של חשבון Google המייצג יישומים (בניגוד למשתמשים). מערכת ה-CI שלך יכולה להשתמש בחשבונות שירות כדי להפעיל את עומסי העבודה של הפצת אפליקציות. למידע נוסף, ראה אימות באמצעות חשבון שירות .
אם אתה משתמש בפדרציה של זהות עומס עבודה, אתה יכול ליצור ולהשתמש בקובץ תצורת פרטי כניסה במקום מפתח חשבון שירות.
זכור את מגבלות השחרור
הפצת אפליקציות תומכת לכל היותר ב-1,000 מהדורות לכל אפליקציה. משמעות הדבר היא שכאשר אתה חורג ממגבלת ההפצה, הפצת אפליקציות מוחקת אוטומטית את המהדורות הישנות ביותר מעל המגבלה. כדי ללמוד כיצד לנהל מגבלות שחרור, ראה כמה זמן זמינות גירסת אפליקציות?
הוסף את אותה קבוצה של בודקים לכמה מהדורות
אם אתה רוצה להוסיף מספר גדול של בודקים למהדורות שלך, השתמש בפונקציונליות ניהול הבודקים בתפזורת של App Distribution.
אנו ממליצים להשתמש בקבוצות כדי להוסיף את אותם בודקים לכמה מהדורות. קבוצה פועלת כרשימת בקרת גישה; כאשר אתה מסיר בודק מקבוצה, הוא מאבד את הגישה לכל המהדורות שהופצו לאותה קבוצה. למידע נוסף, ראה הוספה והסרה של בודקים מקבוצה .
אם יש לך הרבה בודקים לנהל, תוכל להוסיף ולמחוק בודקים בכמות גדולה באמצעות מסוף Firebase. כדי להפוך הוספה והסרה של בודקים לאוטומטית, השתמש ב- Firebase CLI , fastlane , Gradle או ב-API הציבורי של Firebase App Distribution .
זכור את מגבלות הבוחנים
הפצת אפליקציות מגבילה את מספר הבודקים שתוכל להוסיף לפרויקט Firebase או לקבוצת הפצת אפליקציות. כאשר תחרוג ממגבלות אלו, לא תוכל להפיץ את האפליקציה שלך לבודקים נוספים. למידע נוסף על מגבלות בודקים, ראה האם יש מגבלות להוספת בודקים לאפליקציה שלי?
אפשר לבודקים פוטנציאליים להירשם בעצמם לבדיקה
כדי להקל על הפצת האפליקציה שלך לבודקים נוספים, אנו ממליצים להשתמש בקישורי הזמנה. קישור הזמנה הוא כתובת אתר ייחודית המאפשרת לבודקים להזין את כתובות האימייל שלהם כדי להירשם לבדיקת אפליקציה. מתן אפשרות למשתמשים להוסיף את עצמם לרשימת בודקי האפליקציות שלך היא דרך חלקה להגדיל את בסיס הבדיקות הפנימי שלך.
מקרי שימוש בקישורי הזמנה כוללים תוכניות מזון למוצרי ניסוי של החברה, ארגונים עם צוותי QA גדולים וקבוצות מפתחים שרוצים שלקוחות בודדים יוכלו לשלוט בגישה של בודקים.
אנו ממליצים ליצור קישור הזמנה לקבוצה. כל בודק שנרשם באמצעות קישור ההזמנה מתווסף אוטומטית למהדורות הבאות.
למידע נוסף, ראה יצירת קישורי הזמנה והוספה והסרה של בודקים מקבוצה .
ודא שהבודקים בודקים את הגרסה שאכפת לך ממנה
כאשר מעלים גרסה חדשה, הבודקים שלך מקבלים הודעה בדוא"ל. כדי להשלים את ההתראה הזו, אתה יכול להשתמש בתכונות הבאות - קישורי שחרור והתראות בתוך האפליקציה - כדי לוודא שהבודקים שלך בודקים את גרסת האפליקציה הספציפית שאכפת לך ממנה:
- קישורי שחרור: השתמש בתכונה זו כאשר אתה רוצה לשתף גרסה ספציפית עם בודקים. כדי ללמוד כיצד להשתמש בקישורי פרסום, ראה הפצת אפליקציות Android לבודקים באמצעות מסוף Firebase . קישורים אלה זמינים גם עם כלי ה-Firebase , fastlane ו- Gradle שורת הפקודה (CLI) שלנו לשימוש עם כלי האוטומציה של הבנייה שלך.
- התראות בתוך האפליקציה: השתמש בהתראות אלה כאשר אתה רוצה לוודא שהבודקים שלך בודקים את הגרסה העדכנית ביותר של האפליקציה שלך. על ידי שילוב של Firebase App Distribution Android SDK, אתה יכול להציג התראות ישירות בתוך האפליקציה לבודקים שלך כאשר יישומים חדשים של האפליקציה שלך זמינים. כדי ללמוד כיצד להוסיף התראות בתוך האפליקציה, ראה הודע לבודקים לגבי מבנים חדשים .
הסר גישה אוטומטית לבודקים שעוזבים את החברה
כאשר זרימת הבדיקות הפנימיות של ה-CI/CD שלך פועלת, עליך לוודא שלאנשים שעוזבים את החברה אין יותר גישה ל-builds הפנימי שלך. כדי לעזור לך לנהל את גישת הבודקים למבנים, הפצת אפליקציות מספקת את האפשרויות הבאות:
- fastlane: השתמש בקובץ Fastfile שלך או הפעל ישירות פעולות fastlane. למידע נוסף, ראה הפצת אפליקציות אנדרואיד לבודקים המשתמשים ב-fastlane .
- Firebase CLI: השתמש בפעולת
firebase appdistribution:testers:remove
. למידע נוסף, ראה הפצת אפליקציות Android לבודקים באמצעות Firebase CLI . - Gradle: אם אתה משתמש ב-Gradle כדי להסיר בודקים, העבר את
appDistributionRemoveTesters
עם הארגומנטים-- PROJECT_NUMBER
בקובץ-- EMAILSbuild.gradle
שלך. למידע נוסף, ראה הפצת אפליקציות Android לבודקים באמצעות Gradle . - Public Firebase App Distribution API : השתמש בנקודת הקצה
testers.batchRemove
.