במסמך הזה נסביר על שיטות מומלצות לשימוש ב-Firebase App Distribution כדי ליצור תהליכי עבודה ברי קיימא וניתנים לחזורה לבדיקות של Android לפני השקה בסביבת CI/CD. הפתרונות כוללים את Gradle ואת fastlane, אבל כדי לתת לכם גמישות רבה יותר, אנחנו כוללים גם פתרונות שזמינים דרך מסוף Firebase, ה-CLI של Firebase וממשק ה-API הציבורי של Firebase App Distribution. בנוסף, נסביר על המגבלות של הגרסאות הזמינות לבדיקה ועל המגבלות של הבדיקות, כדי שתוכלו לתכנן מראש וליהנות מחוויית שימוש אופטימלית.
אם אתם משתמשים גם בפלטפורמות של Apple, כדאי לעיין במאמר שיטות מומלצות להפצת אפליקציות של Apple למבדקי QA באמצעות CI/CD ו-fastlane.
לפני שמתחילים
לפני שמטמיעים את השיטות המומלצות שמפורטות במסמך הזה, חשוב להפעיל את App Distribution במסוף Firebase לכל אפליקציה. אם לא מפעילים את 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. אפשרות נוספת היא להשתמש ב-CLI של Firebase, שמאפשר גישה למגוון רחב של מוצרי 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
אפשר להשתמש בכלי ה-CLI של Firebase ש-App Distribution מספק כדי להפיץ גרסאות build לבודקים באופן פרוגרמטי. אפשר לציין בודקים ונתוני גרסה של גרסה זמנית.
כדי להפיץ את הגרסה האחרונה של האפליקציה ל-Android, מציינים את מזהה האפליקציה ב-Firebase, ואם רוצים, מוסיפים הערה לגבי הגרסה וקובץ שמכיל את כתובות האימייל של הבודקים:
firebase appdistribution:distribute test.aab \
--app 1:1234567890:android:0a1b2c3d4e5f67890 \
--release-notes "Bug fixes and improvements" --testers-file testers.txt
למידע נוסף על השימוש ב-CLI של Firebase כדי להפוך את תהליך ה-build לאוטומטי, קראו את המאמר הפצת אפליקציות ל-Android למבדקים באמצעות ה-CLI של Firebase.
שימוש בפרטי הכניסה לשירות לצורך אימות
אפשר להשתמש בפלאגין fastlane של App Distribution, בפלאגין Gradle או ב-CLI של Firebase עם חשבונות שירות. חשבון שירות הוא סוג של חשבון Google שמייצג אפליקציות (בניגוד למשתמשים). מערכת ה-CI יכולה להשתמש בחשבונות שירות כדי להריץ את עומסי העבודה של App Distribution. מידע נוסף זמין במאמר אימות באמצעות חשבון שירות.
אם אתם משתמשים באיחוד שירותי אימות הזהות של עומסי עבודה, אתם יכולים ליצור קובץ תצורת פרטי כניסה ולהשתמש בו במקום במפתח של חשבון שירות.
חשוב לזכור את המגבלות על פרסום גרסאות
App Distribution תומך ב-1,000 גרסאות לכל היותר לכל אפליקציה. כלומר, אם תחרגו ממגבלת הגרסאות, App Distribution ימחק באופן אוטומטי את הגרסאות הישנות ביותר מעבר למגבלה. במאמר כמה זמן גרסת האפליקציה זמינה? מוסבר איך לנהל את מגבלות הגרסאות.
הוספת אותה קבוצת בודקים לכמה גרסאות
אם אתם רוצים להוסיף מספר גדול של בודקים למהדורות, תוכלו להשתמש בפונקציות לניהול בודקים בכמות גדולה ב-App Distribution.
מומלץ להשתמש בקבוצות כדי להוסיף את אותם בודקים לכמה גרסאות. קבוצה פועלת כרשימה של בקרת גישה. כשמסירים בודק מקבוצה, הוא מאבד את הגישה לכל הגרסאות המשוחררות שחולקו לקבוצה הזו. למידע נוסף, ראו הוספה והסרה של בודקים מקבוצה.
אם יש לכם הרבה בודקים לניהול, תוכלו להוסיף ולהסיר בודקים בכמות גדולה באמצעות מסוף Firebase. כדי להוסיף ולסמן בוטסטרים באופן אוטומטי, תוכלו להשתמש ב-CLI של Firebase, ב-fastlane, ב-Gradle או ב-ממשק ה-API הציבורי App Distribution של Firebase.
חשוב לזכור את המגבלות על בודקים
App Distribution מגביל את מספר הבודקים שאפשר להוסיף לפרויקט Firebase או לקבוצת App Distribution. אם תחרגו מהמגבלות האלה, לא תוכלו להפיץ את האפליקציה לבודקים נוספים. מידע נוסף על מגבלות על בודקים זמין במאמר האם יש מגבלות על הוספת בודקים לאפליקציה?
לאפשר לבודקים פוטנציאליים להירשם לבדיקה
כדי שיהיה קל יותר להפיץ את האפליקציה ליותר בודקים, מומלץ להשתמש בקישורי הזמנות. קישור להזמנה הוא כתובת URL ייחודית שמאפשרת לבודקים להזין את כתובות האימייל שלהם כדי להירשם לבדיקה של אפליקציה. האפשרות לאפשר למשתמשים להוסיף את עצמם לרשימת הבודקים של האפליקציה היא דרך חלקה להגדיל את בסיס הבדיקה הפנימי.
תרחישים לדוגמה לשימוש בקישורי הזמנות כוללים תוכניות של חברות לשימוש עצמי, ארגונים עם צוותי בקרת איכות גדולים וקבוצות של מפתחים שרוצים לאפשר ללקוחות ספציפיים לשלוט בגישה של בודקים.
מומלץ ליצור קישור הזמנה לקבוצה. כל בודק שנרשם באמצעות קישור ההזמנה יתווסף באופן אוטומטי לגרסאות הבאות.
מידע נוסף זמין במאמרים יצירת קישורים להזמנות והוספה והסרה של בודקים מקבוצה.
מוודאים שהבודקים בודקים את הגרסה הרלוונטית
כשמועלה גרסה חדשה, הבודקים מקבלים על כך הודעה באימייל. כדי להשלים את ההודעה הזו, תוכלו להשתמש בתכונות הבאות – קישורים למהדורות והתראות באפליקציה – כדי לוודא שהבודקים בודקים את גרסת האפליקציה הספציפית שחשובה לכם:
- קישורי גרסאות: משתמשים בתכונה הזו כשרוצים לשתף גרסה ספציפית עם בודקים. במאמר הפצת אפליקציות ל-Android לבודקים באמצעות מסוף Firebase מוסבר איך משתמשים בקישורים להפצת גרסאות. הקישורים האלה זמינים גם בכלי שורת הפקודה (CLI) של Firebase, fastlane ו-Gradle, לשימוש עם הכלים שלכם לאוטומציה של build.
- התראות מתוך האפליקציה: אתם יכולים להשתמש בהתראות האלה כדי לוודא שהבודקים בודקים את הגרסה העדכנית ביותר של האפליקציה. שילוב של Firebase App Distribution Android SDK מאפשר לכם להציג התראות ישירות באפליקציה לבודקים כשגרסאות build חדשות של האפליקציה זמינות. במאמר איך לעדכן את הבוחנים לגבי גרסאות build חדשות מוסבר איך מוסיפים התראות בתוך האפליקציה.
הסרה אוטומטית של הרשאות הגישה של בודקים שעוזבים את החברה
כשתהליך הבדיקה הפנימי של CI/CD פועל, חשוב לוודא שלאנשים שעוזבים את החברה אין יותר גישה לגרסאות ה-build הפנימיות. כדי לעזור לכם לנהל את הגישה של הבוחנים לגרסאות build, App Distribution מספק את האפשרויות הבאות:
- fastlane: שימוש בקובץ Fastfile או הפעלה ישירה של פעולות fastlane. למידע נוסף, ראו הפצת אפליקציות ל-Android למפתחים באמצעות fastlane.
- CLI של Firebase: משתמשים בפעולה
firebase appdistribution:testers:remove
. מידע נוסף זמין במאמר הפצת אפליקציות ל-Android למפתחים באמצעות ה-CLI של Firebase. - Gradle: אם משתמשים ב-Gradle כדי להסיר בודקים, מעבירים את הערך
appDistributionRemoveTesters
עם הארגומנטים
ו---PROJECT_NUMBER
בקובץ--EMAILS build.gradle
. מידע נוסף זמין במאמר הפצת אפליקציות ל-Android למפתחים באמצעות Gradle. - Firebase App Distribution API ציבורי:
משתמשים בנקודת הקצה
testers.batchRemove
.