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

מדריך זה מתאר כיצד לחלק AAB בונה כדי בודקים באמצעות הילוך גבוה , פלטפורמת קוד פתוח המאפשר אוטומצית בנייה ושחרור iOS ו- Android. מכאן הוראות פשוטות מוגדר בתוך Fastfile . לאחר שתגדיר Fastlane ו שלך Fastfile , אתה יכול לשלב חלוק יישומים עם תצורת Fastlane שלך.

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

על הפצת חבילות אנדרואיד App Bundles

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

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

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

  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. הגדר fastlane

  1. תקן וגדר הילוך גבוה .

  2. כדי להוסיף את הפצת אפליקציות לתצורת fastlane שלך, הפעל את הפקודה הבאה מהשורש של פרויקט האנדרואיד שלך:

    fastlane add_plugin firebase_app_distribution

    אם הפקודה מנחה אותך עם אופציה, בחר Option 3: RubyGems.org .

שלב 2. אימות באמצעות Firebase

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

שלב 3. הגדר את Fastfile שלך ​​והפיץ את האפליקציה שלך

  1. In a ./fastlane/Fastfile נתיב, להוסיף firebase_app_distribution בלוק. השתמש בפרמטרים הבאים כדי להגדיר את ההפצה:
    פרמטרים של firebase_app_distribution
    app

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

    app: "1:1234567890:android:0a1b2c3d4e5f67890"
    firebase_cli_token

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

    service_credentials_file

    הנתיב לקובץ json של חשבון שירות Google שלך. ראה למעלה לגבי האופן בו לאמת באמצעות אישורי חשבון השירות .

    android_artifact_type

    מציין את סוג קובץ Android (APK או AAB).

    android_artifact_path

    מחליף apk_path (יצא משימוש). נתיב מוחלט לקובץ APK או AAB שברצונך להעלות. אם לא מצוין, fastlane קובע את מיקום הקובץ מהנתיב שבו הקובץ נוצר.

    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

    דגל בוליאני. אתה יכול להגדיר את זה true להדפיס מפורט פלט debug.

platform :android do
    desc "My awesome app"
    lane :distribute do
        build_android_app(task: "bundle", ...)
        # build_android_app is a built-in fastlane action.
        firebase_app_distribution(
            app: "1:123456789:android:abcd1234",
            testers: "tester1@company.com, tester2@company.com",
            release_notes: "Lots of amazing new features to test out!",
            android_artifact_type: "AAB"
        )
    end
end

כדי להפוך הלבן לרשות בודקת, לרוץ השביל שלך:

fastlane <lane>

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

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

(אופציונלי) כדי להגדיל מספר ה- build שלך באופן אוטומטי בכל פעם שאתה יוצר מהדורה חדשה בהתחלקות App, אתה יכול להשתמש firebase_app_distribution_get_latest_release פעולה ו, למשל, increment_version_code תוסף הילוך גבוה . הקוד הבא מספק דוגמה כיצד להגדיל אוטומטית את מספר ה-build שלך:

lane :increment_version do
  latest_release = firebase_app_distribution_get_latest_release(
    app: "<your Firebase app ID>"
  )
  increment_version_code({ version_code: latest_release[:buildVersion].to_i + 1 })
end

כדי ללמוד עוד על firebase_app_distribution_get_latest_release הפעולה, לראות קבל מידע על המהדורה האחרונה של האפליקציה שלך .

שלב 4 (אופציונלי). ניהול בודקים להפצה

אתה יכול להוסיף ולהסיר בודקים מן שחרור האפליקציה באמצעות שלך Fastfile קובץ או על ידי הפעלת פעולות Fastlane ישירות. הפעלת פעולות ישירות עוקפת את הערכים המוגדרים ב Fastfile .

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

השתמש Fastfile

# Use lanes to add or remove testers from an app release.
lane(:add_testers) do
  firebase_app_distribution_add_testers(
    emails: "foo@google.com,bar@google.com"
    # or file: "/path/to/testers.txt"
  )
end

lane(:remove_testers) do
  firebase_app_distribution_remove_testers(
    emails: "foo@google.com,bar@google.com"
    # or file: "/path/to/testers.txt"
  )
end
# Add or remove testers with the terminal
$ fastlane add_testers
$ fastlane remove_testers

הפעל פעולות בנתיב מהיר

fastlane run firebase_app_distribution_add_testers emails:"foo@google.com,bar@google.com"

fastlane run firebase_app_distribution_remove_testers emails:"foo@google.com,bar@google.com"

ניתן גם לציין בודקים באמצעות --file="/path/to/testers.txt במקום --emails .

firebase_app_distribution_add_testers ו firebase_app_distribution_remove_testers משימות גם לקבל את הטיעונים הבאים:

  • project_name : מספר הפרוייקט Firebase שלך.
  • service_credentials_file : נתיב קובץ אישורי שירות Google שלך.
  • firebase_cli_token : מחבר אסימון עבור Firebase CLI.

service_credentials_file ואת firebase_cli_token הם אותם הטיעונים המשמשים את פעולת ההעלאה.

שלב 5 (אופציונלי). קבל מידע על המהדורה האחרונה של האפליקציה שלך

אתה יכול להשתמש firebase_app_distribution_get_latest_release פעולה כדי להביא מידע על המהדורה האחרונה של האפליקציה ב- App הפצה, כולל מידע על גרסת האפליקציה, בהודעת השחרור, ולאחר זמן היצירה. מקרי שימוש כוללים הגדלה אוטומטית של הגרסה והעברת הערות הגרסה מהגרסה הקודמת.

ערך ההחזר של הפעולה הוא hash המייצג את המהדורה האחרונה. חשיש זה באמצעות גם זמין lane_context[SharedValues::FIREBASE_APP_DISTRO_LATEST_RELEASE] . לקבלת מידע נוסף על השדות הזמינים ב חשיש זה, לראות את תיעוד API REST .

פרמטרים

פרמטרים של firebase_app_distribution_get_latest_release
app

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

app: "1:1234567890:android:0a1b2c3d4e5f67890"
firebase_cli_token

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

service_credentials_file

הנתיב לקובץ json של חשבון שירות Google שלך. ראה למעלה לגבי האופן בו לאמת באמצעות אישורי חשבון השירות .

debug

דגל בוליאני. אתה יכול להגדיר את זה true להדפיס מפורט פלט debug.