אפשרויות להתקנת Firebase באפליקציה ל-Apple

Swift Package Manager

ב-Firebase ממליצים להשתמש ב-Swift Package Manager לפרויקטים חדשים.

באמצעות Xcode

לתמיכה ב-Swift Package Manager נדרשת גרסה 15.2 ומעלה.

1. אם עוברים מפרויקט שמבוסס על CocoaPods, מריצים את הפקודה pod deintegrate כדי להסיר את CocoaPods מהפרויקט ב-Xcode. .xcworkspace שנוצרו על ידי CocoaPods את הקובץ הזה ניתן למחוק בבטחה לאחר מכן. אם אתם מוסיפים את Firebase לפרויקט לראשונה, אפשר להתעלם מהשלב הזה.

2. ב-Xcode, מתקינים את ספריות Firebase על ידי מעבר אל File > Add Packages.

3. בהודעה שמופיעה, בוחרים את מאגר GitHub של Firebase:

   https://github.com/firebase/firebase-ios-sdk.git
   

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

5. בוחרים את ספריות Firebase שרוצים לכלול באפליקציה.

בסיום התהליך, מערכת Xcode תתחיל לפתור את יחסי התלות של החבילות מורידים אותם ברקע.

דרך Package.swift

כדי לשלב את Firebase בחבילת Swift באמצעות מניפסט Package.swift, אפשר להוסיף את Firebase למערך dependencies של החבילה. פרטים נוספים זמינים במאמר ה מסמכי תיעוד של Swift Package Manager.

dependencies: [

  .package(name: "Firebase",
           url: "https://github.com/firebase/firebase-ios-sdk.git",
           from: "8.0"),
  // ...

],

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

.target(
  name: "MyTargetName",
  dependencies: [
    .product(name: "FirebaseAuth", package: "Firebase"),
    // ...
  ]
),

שיקולים ספציפיים למוצר

חלק ממוצרי Firebase דורשים שלבי שילוב נוספים כדי לפעול בצורה נכונה.

Google Analytics

הפרמטר Google Analytics מחייב להוסיף את סימון הקישור -ObjC לערכי היעד או לפתח את ההגדרות, אם הן נכללות באופן זמני.

Crashlytics

Crashlytics מחייב להעלות סמלים לניפוי באגים.

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

${BUILD_DIR%Build/*}/SourcePackages/checkouts/firebase-ios-sdk/Crashlytics/run

אפשרות נוספת להעלאת סמלים היא להשתמש upload-symbols סקריפט. מניחים את הסקריפט בספריית משנה של קובץ הפרויקט (לדוגמה scripts/upload-symbols), ולאחר מכן מוודאים שאפשר להריץ את הסקריפט:

chmod +x scripts/upload-symbols

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

CocoaPods

ב-Firebase יש תמיכה בהתקנה באמצעות CocoaPods בנוסף ל-Swift Package Manager.

כדי להשתמש בהפצה של CocoaPods ב-Firebase, נדרשים Xcode 15.2 ו-CocoaPods בגרסה 1.12.0 ואילך. כך מתקינים את Firebase באמצעות CocoaPods:

1. אם עדיין אין לכם Podfile, צריך ליצור אותו. מהשורש ספריית הפרויקט, מריצים את הפקודה הבאה:

   pod init

2. מוסיפים ל-Podfile את פקדי ה-Pod של Firebase שבהם רוצים להשתמש באפליקציה.

   אפשר להוסיף לאפליקציה כל אחד ממוצרי Firebase הנתמכים.

   Analytics הופעל

   # Add the Firebase pod for Google Analytics
   pod 'FirebaseAnalytics'
   
   # For Analytics without IDFA collection capability, use this pod instead
   # pod ‘Firebase/AnalyticsWithoutAdIdSupport’
   
   # Add the pods for any other Firebase products you want to use in your app
   # For example, to use Firebase Authentication and Cloud Firestore
   pod 'FirebaseAuth'
   pod 'FirebaseFirestore'

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

   Analytics לא מופעלים

   # Add the pods for the Firebase products you want to use in your app
   # For example, to use Firebase Authentication and Cloud Firestore
   pod 'FirebaseAuth'
   pod 'FirebaseFirestore'

3. מתקינים את רצף המודעות ואז פותחים את קובץ .xcworkspace כדי לראות את הפרויקט ב- Xcode:

   pod install --repo-update

   open your-project.xcworkspace

שיקולים ספציפיים למוצר

חלק ממוצרי Firebase דורשים שלבי שילוב נוספים כדי לפעול בצורה נכונה.

Crashlytics

כדי להשתמש ב-Crashlytics, צריך להעלות סמלים של ניפוי באגים.

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

"${PODS_ROOT}/FirebaseCrashlytics/run"

קרתגו

התמיכה של קרתגו היא ניסיונית. בהוראות ב-GitHub מוסבר איך לכלול את Firebase באפליקציה באמצעות Carthage.

שילוב ידני

Firebase מספקת הפצה של XCFramework בינארי שנוצר מראש למשתמשים שרוצים לשלב את Firebase בלי להשתמש במנהל יחסי תלות. כדי להתקין את Firebase:

1. מורידים את קובץ ה-zip של ה-SDK של המסגרת. הקובץ הזה מכיל פלחים של ארכיטקטורה לכל ארכיטקטורות היעד הזמינות לכל ערכות ה-SDK של Firebase, ולכן הורדת הקובץ עשויה להימשך זמן מה.

2. מבטלים את האריזה של הקובץ ובודקים את README כדי למצוא את המסגרות שרוצים לכלול באפליקציה.

3. מוסיפים את הדגל של הקישור -ObjC ב-Other Linker Settings בהגדרות ה-build של היעד.