Catch up on everthing we announced at this year's Firebase Summit. Learn more

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

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

שלב 1. הגדר Fastlane

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

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

    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

    הוא נדרש רק אם האפליקציה שלך אינו מכיל קובץ config Firebase ( GoogleService-Info.plist ): זיהוי האפליקציה Firebase של האפליקציה. אתה יכול למצוא את מזהה האפליקציה במסוף Firebase, על דף ההגדרות הכלליות .

    app: "1:1234567890:ios:0a1b2c3d4e5f67890"
    googleservice_info_plist_path

    הנתיב שלך GoogleService-Info.plist הקובץ, יחסים לנתיב המוצר לארכיון. גדר GoogleService-Info.plist כברירת מחדל.

    הקובץ משמש כדי לקבל את זיהוי App Firebase האפליקציה שלכם אם app הפרמטר לא צוין.

    firebase_cli_token

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

    service_credentials_file

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

    ipa_path

    מחליף apk_path (יצא משימוש). נתיב מוחלט לקובץ ה- IPA שברצונך להעלות. אם לא צוין, 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 :ios do
    desc "My awesome app"
    lane :distribute do
        build_ios_app(...)
        # build_ios_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!"
        )

    end
end

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

fastlane <lane>

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

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

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

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

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

לאחר שבוחן בודק לפרויקט 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 הם אותם הטיעונים המשמשים את פעולת ההעלאה.