דף זה תורגם על ידי Cloud Translation API.

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

אפשר להפיץ גרסאות build לבודקים באמצעות fastlane, פלטפורמת קוד פתוח שמבצעת אוטומציה של בנייה ושחרור של אפליקציות ל-iOS ול-Android. הוא פועל לפי הוראות פשוטות שמוגדרות ב-Fastfile. אחרי שמגדירים את fastlane ואת Fastfile, אפשר לשלב את App Distribution בהגדרות של fastlane.

שלב 1. הגדרת fastlane

התקנה והגדרה של fastlane
כדי להוסיף את App Distribution להגדרות של fastlane, מריצים את הפקודה הבאה מתיקיית הבסיס של פרויקט iOS:
```
fastlane add_plugin firebase_app_distribution
```
אם הפקודה מציגה אפשרות, בוחרים באפשרות Option 3: RubyGems.org.

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

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

שימוש בפרטי כניסה לחשבון שירות של Firebase

אימות באמצעות חשבון שירות מאפשר לכם להשתמש בגמישות בתוסף עם מערכת האינטגרציה הרציפה (CI) שלכם. יש שתי דרכים לספק את פרטי הכניסה של חשבון השירות:

מעבירים את קובץ המפתח של חשבון השירות לפעולה firebase_app_distribution. השיטה הזו יכולה להיות נוחה אם כבר יש לכם את קובץ המפתח של חשבון השירות בסביבת הפיתוח.
מגדירים את משתנה הסביבה GOOGLE_APPLICATION_CREDENTIALS כך שיצביע על קובץ המפתח של חשבון השירות. יכול להיות שתעדיפו את השיטה הזו אם כבר הגדרתם Application Default Credentials ‏ (ADC) לשירות אחר של Google (למשל, Google Cloud).

במסוף Google Cloud,בוחרים את הפרויקט ויוצרים חשבון שירות חדש.
מוסיפים את התפקיד Firebase App Distribution אדמין.
יוצרים מפתח JSON פרטי ומעבירים אותו למיקום שסביבת הבנייה יכולה לגשת אליו. חשוב לשמור את הקובץ במקום בטוח, כי הוא מעניק גישת אדמין ל-App Distribution בפרויקט Firebase.
אם יצרתם את האפליקציה אחרי 20 בספטמבר 2019, אפשר לדלג על השלב הזה: במסוף ממשקי ה-API של Google, מפעילים את Firebase App Distribution API. כשמוצגת בקשה, בוחרים את הפרויקט עם אותו שם כמו הפרויקט ב-Firebase.
מספקים או מאתרים את פרטי הכניסה לחשבון השירות:
1. כדי להעביר את המפתח של חשבון השירות לפעולה firebase_app_distribution של הנתיב, מגדירים את הפרמטר service_credentials_file עם הנתיב לקובץ ה-JSON של המפתח הפרטי.
2. כדי לאתר את פרטי הכניסה באמצעות ADC, מגדירים את משתנה הסביבה GOOGLE_APPLICATION_CREDENTIALS לנתיב של קובץ ה-JSON של המפתח הפרטי. לדוגמה:
```
 export GOOGLE_APPLICATION_CREDENTIALS=/absolute/path/to/credentials/file.json
```
  למידע נוסף על אימות באמצעות ADC, קראו את המאמר איך מספקים פרטי כניסה לאפליקציה.

כניסה באמצעות Firebase CLI

הוראות לאימות הפרויקט מופיעות במאמר כניסה באמצעות Firebase CLI.

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

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

פרמטרים של הפצת אפליקציות ב-Firebase
`app`	נדרש רק אם האפליקציה לא מכילה קובץ הגדרות של Firebase ‏ (`GoogleService-Info.plist`): מזהה האפליקציה ב-Firebase. אפשר למצוא את מזהה האפליקציה במסוף Firebase, בדף ההגדרות הכלליות. app: "1:1234567890:ios:0a1b2c3d4e5f67890"
`googleservice_info_plist_path`	הנתיב לקובץ `GoogleService-Info.plist`, ביחס לנתיב של המוצר בארכיון. מוגדר כ-`GoogleService-Info.plist` כברירת מחדל. הקובץ משמש לקבלת מזהה האפליקציה שלכם ב-Firebase אם לא מציינים את הפרמטר `app`.
`firebase_cli_token`	טוקן רענון שמוצג כשמאמתים את סביבת ה-CI באמצעות Firebase CLI (מידע נוסף זמין במאמר שימוש ב-CLI עם מערכות CI).
`service_credentials_file`	הנתיב לקובץ ה-JSON של חשבון השירות שלכם ב-Google. למעלה מוסבר איך מבצעים אימות באמצעות פרטי כניסה של חשבון שירות.
`ipa_path`	החלפה של `apk_path` (הוצא משימוש). הנתיב המוחלט לקובץ ה-IPA שרוצים להעלות. אם לא מציינים מיקום, fastlane קובע את מיקום הקובץ לפי הנתיב שבו הקובץ נוצר.
`release_notes` `release_notes_file`	נתוני הגרסה של ה-build הזה. אפשר לציין את הערות הגרסה ישירות: 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"
`test_devices` `test_devices_file`	סוגי ההפצה הבאים הם חלק מתכונת הבטא של כלי הבדיקה האוטומטי. מכשירי הבדיקה שרוצים להפיץ אליהם גרסאות build (ראו בדיקות אוטומטיות). אפשר לציין את המכשירים לבדיקה כרשימה של מכשירים לבדיקה שמופרדים באמצעות נקודה-ופסיק: test_devices: "model=shiba,version=34,locale=en,orientation=portrait;model=b0q,version=33,locale=en,orientation=portrait" לחלופין, אפשר לציין את הנתיב לקובץ טקסט פשוט שמכיל רשימה של מכשירי בדיקה שמופרדים באמצעות נקודה-פסיק: test_devices_file: "/path/to/test-devices.txt"
`test_username`	שם המשתמש לכניסה אוטומטית שמשמש במהלך בדיקות אוטומטיות.
`test_password` `test_password_file`	הסיסמה להתחברות אוטומטית שתשמש במהלך בדיקות אוטומטיות. אפשר גם לציין את הנתיב לקובץ טקסט פשוט שמכיל סיסמה: test_password_file: "/path/to/test-password.txt"
`test_username_resource`	שם המשאב של שדה שם המשתמש לכניסה אוטומטית, לשימוש במהלך בדיקות אוטומטיות.
`test_password_resource`	שם המשאב של שדה הסיסמה לכניסה אוטומטית, לשימוש במהלך בדיקות אוטומטיות.
`test_non_blocking`	הפעלת בדיקות אוטומטיות באופן אסינכרוני. תוצאות הבדיקה האוטומטית זמינות במסוף Firebase.
`debug`	תכונה ניסיונית בוליאנית. אפשר להגדיר את הערך הזה ל-`true` כדי להדפיס פלט מפורט של ניפוי באגים.

לדוגמה:

platform :ios do
    desc "My awesome app"
    lane :distribute do
        build_ios_app(...)
        # build_ios_app is a built-in fastlane action.

        release = firebase_app_distribution(
            app: "1:123456789:ios:abcd1234",
            testers: "tester1@company.com, tester2@company.com",
            release_notes: "Lots of amazing new features to test out!"
        )

    end
end

כדי שהגרסה תהיה זמינה לבודקים, מריצים את הנתיב:

fastlane <lane>

הערך שמוחזר מהפעולה הוא גיבוב שמייצג את הגרסה שהועלתה. אפשר גם להשתמש ב-lane_context[SharedValues::FIREBASE_APP_DISTRO_RELEASE] כדי לראות את הגיבוב הזה. מידע נוסף על השדות הזמינים בגיבוב הזה מופיע בתיעוד של REST API.

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

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

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

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

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

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

מידע נוסף על התכונה הזו של פלאגין fastlane

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

אתם יכולים להוסיף בודקים לפרויקט או לקבוצה ולהסיר אותם מהם באמצעות Fastfileהקובץ או על ידי הפעלת פעולות fastlane ישירות. הפעלת פעולות ישירות מבטלת את הערכים שהוגדרו ב-Fastfile.

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

אם יש לכם מספר גדול של בודקים, כדאי להשתמש בקבוצות.

שימוש ב-`Fastfile`

# Use lanes to add or remove testers from a project.
lane(:add_testers) do
  firebase_app_distribution_add_testers(
    emails: "foo@google.com,bar@google.com"
    # or file: "/path/to/testers.txt"
    group_alias: "qa-team" # (Optional) add testers to this group
  )
end

lane(:remove_testers) do
  firebase_app_distribution_remove_testers(
    emails: "foo@google.com,bar@google.com"
    # or file: "/path/to/testers.txt"
    group_alias: "qa-team" # (Optional) remove testers from this group only
  )
end

# Add or remove testers with the terminal
$ fastlane add_testers
$ fastlane remove_testers

הפעלת פעולות של fastlane

fastlane run firebase_app_distribution_create_group display_name:"QA Team" alias:"qa-team"
fastlane run firebase_app_distribution_add_testers group_alias:"qa-team" emails:"foo@google.com,bar@google.com"
fastlane run firebase_app_distribution_remove_testers group_alias:"qa-team" emails:"foo@google.com,bar@google.com"
fastlane run firebase_app_distribution_delete_group alias:"qa-team"

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

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

‫project_name: מספר הפרויקט ב-Firebase.
‫group_alias (אופציונלי): אם מציינים קבוצה, הבודקים נוספים לקבוצה שצוינה (או מוסרים ממנה).
‫service_credentials_file: הנתיב לקובץ פרטי הכניסה של חשבון השירות שלכם ב-Google.
‫firebase_cli_token: אסימון אימות ל-CLI של Firebase.

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

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

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

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

פרמטרים

פרמטרים של firebase_app_distribution_get_latest_release
`app`	נדרש רק אם האפליקציה לא מכילה קובץ הגדרות של Firebase ‏ (`GoogleService-Info.plist`): מזהה האפליקציה ב-Firebase. אפשר למצוא את מזהה האפליקציה במסוף Firebase, בדף ההגדרות הכלליות. app: "1:1234567890:ios:0a1b2c3d4e5f67890"
`googleservice_info_plist_path`	הנתיב לקובץ `GoogleService-Info.plist`, ביחס לנתיב של המוצר בארכיון. מוגדר כ-`GoogleService-Info.plist` כברירת מחדל. הקובץ משמש לקבלת מזהה האפליקציה שלכם ב-Firebase אם לא מציינים את הפרמטר `app`.
`firebase_cli_token`	טוקן רענון שמוצג כשמאמתים את סביבת ה-CI באמצעות Firebase CLI (מידע נוסף זמין במאמר שימוש ב-CLI עם מערכות CI).
`service_credentials_file`	הנתיב לקובץ ה-JSON של חשבון השירות שלכם ב-Google. בתיעוד הקודם מוסבר איך מבצעים אימות באמצעות פרטי כניסה של חשבון שירות.
`service_credentials_json_data`	תוכן קובץ ה-JSON של חשבון השירות של Google. בתיעוד הקודם מוסבר איך מבצעים אימות באמצעות פרטי כניסה של חשבון שירות.
`debug`	תכונה ניסיונית בוליאנית. אפשר להגדיר את הערך הזה ל-`true` כדי להדפיס פלט מפורט של ניפוי באגים.

השלבים הבאים

כדי לרשום עוד מכשירים באופן ידני או באמצעות תוכנה, אפשר לעיין במאמר בנושא רישום של מכשירי iOS נוספים.
שיטות מומלצות להפצת אפליקציות ל-iOS לצוות בקרת האיכות באמצעות CI/CD ו-fastlane