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

Swift Package Manager

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

באמצעות Xcode

כדי להשתמש ב-Swift Package Manager, צריך גרסה 26.2 ומעלה.

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

  2. ב-Xcode, מתקינים את הספריות של Firebase: עוברים אל File > Add Packages (קובץ > הוספת חבילות).

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

    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 להגדרות ה-build של היעד.

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.

כדי להפיץ את Firebase באמצעות CocoaPods, צריך את Xcode 26.2 ואת CocoaPods 1.12.0 ומעלה. כך מתקינים את Firebase באמצעות CocoaPods:

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

    pod init

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

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

    ‫Analytics מופעל 

    # Add the Firebase pod for Google Analytics
pod 'FirebaseAnalytics'

# For Analytics without IDFA collection capability, use this pod instead
# pod FirebaseAnalytics/Core

# 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. מתקינים את ה-pods ופותחים את הקובץ .xcworkspace כדי לראות את הפרויקט ב-Xcode:

    pod install --repo-update
     
    open your-project.xcworkspace

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

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

Crashlytics

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

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

"${PODS_ROOT}/FirebaseCrashlytics/run"

קרתגו

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

שילוב ידני

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

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

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

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