Catch up on everything announced at Firebase Summit, and learn how Firebase can help you accelerate app development and run your app with confidence. Learn More

הפצת אפליקציות אנדרואיד לבודקים באמצעות Firebase CLI

קל לארגן דפים בעזרת אוספים אפשר לשמור ולסווג תוכן על סמך ההעדפות שלך.

מדריך זה מתאר כיצד להפיץ חבילות של Android App Bundles (AABs) לבודקים באמצעות Firebase CLI. כלי ה-CLI מאפשר לך לציין בודקים והערות שחרור עבור מבנה, ולאחר מכן מפיץ את ה-build בהתאם.

הפצת אפליקציות משתלבת עם שירות שיתוף האפליקציות הפנימי של Google Play כדי לעבד את ה-AABs שאתה מעלה ולהגיש חבילות APK המותאמות לתצורות המכשירים של הבודקים שלך. הפצת AABs מאפשרת לך לבצע את הפעולות הבאות:

  • הפעל חבילות APK מותאמות (מוגשות על ידי Google Play) המותאמות למכשירים של הבודקים שלך.

  • חשוף וניפוי באגים של בעיות ספציפיות למכשיר.

  • בדוק תכונות של חבילת אפליקציות כמו הצגת תכונות Play ו- Play Asset Delivery .

  • צמצם את גודל ההורדות עבור הבודקים שלך.

הרשאות נדרשות

כדי להעלות AABs להפצת אפליקציות, עליך לקשר את אפליקציית Firebase שלך ​​לאפליקציה ב-Google Play . עליך להיות בעל רמת הגישה הנדרשת כדי לבצע פעולות אלה.

אם אין לך את הגישה הדרושה ל-Firebase, תוכל לבקש מבעל פרויקט Firebase להקצות לך את התפקיד הרלוונטי דרך הגדרות IAM של קונסולת Firebase . אם יש לך שאלות לגבי גישה לפרויקט Firebase שלך, כולל איתור או הקצאת בעלים, עיין בשאלות הנפוצות של "הרשאות וגישה לפרויקטים של Firebase" .

הטבלה הבאה חלה על קישור אפליקציית Firebase לאפליקציה ב-Google Play, כמו גם העלאת AABs.

פעולה במסוף Firebase נדרשת הרשאת IAM תפקידי IAM הכוללים הרשאות נדרשות כברירת מחדל תפקידים נדרשים נוספים
קשר אפליקציית Firebase לאפליקציה ב-Google Play firebase.playLinks.update אחד מהתפקידים הבאים: גישה לחשבון מפתח ב-Google Play כמנהל מערכת
העלה AABs להפצת אפליקציות firebaseappdistro.releases.update אחד מהתפקידים הבאים: ––

לפני שאתה מתחיל

  1. אם עדיין לא עשית זאת, הוסף את Firebase לפרויקט Android שלך . בסוף זרימת העבודה הזו, תהיה לך אפליקציית Firebase Android בפרויקט Firebase שלך.

    אם אינך משתמש במוצרי Firebase אחרים, עליך רק ליצור פרויקט ולרשום את האפליקציה שלך. אם תחליט להשתמש במוצרים נוספים, הקפד להשלים את כל השלבים בהוספת Firebase לפרויקט Android שלך .

  2. כדי ליצור קישור Firebase ל-Google Play ולהעלות AABs, ודא שהאפליקציה שלך עומדת בדרישות הבאות:

    • האפליקציה ב-Google Play ואפליקציית Firebase Android רשומות שניהם באותו שם חבילה.

    • האפליקציה ב-Google Play מוגדרת בלוח המחוונים של האפליקציה ומופצת לאחד ממסלולי Google Play (בדיקות פנימיות, בדיקות סגורות, בדיקות פתוחות או הפקה).

    • סקירת האפליקציה ב-Google Play הושלמה והאפליקציה פורסמה. האפליקציה שלך מתפרסמת אם עמודת סטטוס האפליקציה מציגה את אחד מהסטטוסים הבאים: בדיקה פנימית (לא טיוטה בדיקה פנימית), בדיקה סגורה, בדיקה פתוחה או הפקה.

  3. קשר את אפליקציית Firebase Android שלך לחשבון המפתח שלך ב-Google Play:

    1. במסוף Firebase, עבור אל ההגדרות שלך פרויקט ולאחר מכן בחר בכרטיסייה אינטגרציות .

    2. בכרטיס Google Play , לחץ על קישור .
      אם כבר יש לך קישורים ל-Google Play, לחץ על נהל במקום זאת.

    3. עקוב אחר ההוראות שעל המסך כדי להפעיל את שילוב הפצת האפליקציות ובחר אילו אפליקציות Firebase Android לקשר ל-Google Play.

    למידע נוסף על קישור ל-Google Play .

שלב 1. בנה את האפליקציה שלך

כשתהיה מוכן להפיץ גרסה מוקדמת של האפליקציה שלך לבודקים, בנה את ה-AAB שלך (בקר בתיעוד של Android Studio לקבלת הוראות).

שלב 2. הפץ את האפליקציה שלך לבודקים

כדי להפיץ את האפליקציה שלך לבודקים, העלה את קובץ האפליקציה שלך באמצעות Firebase CLI:

  1. התקן או עדכן לגרסה העדכנית ביותר של Firebase CLI (אנו ממליצים להוריד את הקובץ הבינארי העצמאי עבור ה-CLI הספציפי למערכת ההפעלה שלך). הקפד להיכנס ולבדוק שאתה יכול לגשת לפרויקטים שלך.
  2. בדף הפצת אפליקציות של מסוף Firebase, בחר את האפליקציה שברצונך להפיץ ולאחר מכן לחץ על התחל .
  3. הפעל את הפקודה appdistribution:distribute כדי להעלות את האפליקציה שלך ולהפיץ אותה לבודקים. השתמש בפרמטרים הבאים כדי להגדיר את ההפצה:

    אפליקציית הפצה: אפשרויות הפצה
    --app

    נדרש : מזהה האפליקציה של האפליקציה שלך Firebase. אתה יכול למצוא את מזהה האפליקציה במסוף Firebase, בדף ההגדרות הכלליות .

    --app 1:1234567890:android:0a1b2c3d4e5f67890
    --token

    אסימון רענון שמודפס כאשר אתה מאמת את סביבת ה-CI שלך עם Firebase CLI (קרא השתמש ב-CLI עם מערכות CI למידע נוסף).

    --token "$FIREBASE_TOKEN"
    --release-notes
    --release-notes-file

    הערות גרסה עבור המבנה הזה.

    אתה יכול לציין את הערות השחרור ישירות:

    --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

    דגל שאתה יכול לכלול כדי להדפיס פלט יומן מפורט.

    לדוגמה:

    firebase appdistribution:distribute test.aab  \
        --app 1:1234567890:android:0a1b2c3d4e5f67890  \
        --release-notes "Bug fixes and improvements" --testers-file testers.txt
    

    בנוסף להפצת מהדורות, אתה יכול גם להשתמש ב- 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 .

לאחר שתפיץ את ה-build שלך, הוא הופך זמין בלוח המחוונים של הפצת אפליקציות של מסוף Firebase למשך 150 ימים (חמישה חודשים). כאשר ה-build הוא 30 יום מתאריך התפוגה, הודעת תפוגה מופיעה הן במסוף והן ברשימת ה-builds של הבוחן שלך במכשיר הבדיקה שלו.

בודקים שלא הוזמנו לבדוק את האפליקציה מקבלים הזמנות בדוא"ל כדי להתחיל, ובודקים קיימים מקבלים הודעות דוא"ל על כך שמבנה חדש מוכן לבדיקה (קרא את מדריך הגדרת הבוחן לקבלת הוראות כיצד להתקין את אפליקציית הבדיקה). אתה יכול לעקוב אחר הסטטוס של כל בודק - האם הוא קיבל את ההזמנה והאם הוא הוריד את האפליקציה - במסוף Firebase.

לבודקים יש 30 יום לקבל הזמנה לבדוק את האפליקציה לפני שתפוגה. כאשר הזמנה עוברת 5 ימים מתאריך התפוגה, הודעת תפוגה מופיעה במסוף Firebase ליד הבוחן בגרסה. ניתן לחדש הזמנה על ידי שליחתה מחדש באמצעות התפריט הנפתח בשורת הבוחן.

הצעדים הבאים

למד שיטות עבודה מומלצות להפצת אפליקציות אנדרואיד לבודקי QA באמצעות CI/CD .