הוספת Firebase לפרויקט של Apple

דרישות מוקדמות

  • מתקינים את הרכיבים הבאים:

    • Xcode 15.2 ואילך

  • עליכם לוודא שהפרויקט עומד בדרישות הבאות:

    • הפרויקט צריך לטרגט את גרסאות הפלטפורמה הבאות או גרסאות מתקדמות יותר:
      • iOS 13
      • macOS 10.15
      • tvOS 13
      • watchOS 7

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

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

שלב 1: יוצרים פרויקט Firebase

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

שלב 2: רישום האפליקציה ב-Firebase

כדי להשתמש ב-Firebase באפליקציה ל-Apple, צריך לרשום את האפליקציה לפרויקט ב-Firebase. לעיתים קרובות, רישום האפליקציה נקרא 'הוספת' האפליקציה לפרויקט.

  1. נכנסים למסוף Firebase.

  2. במרכז הדף 'סקירה כללית של הפרויקט', לוחצים על הסמל iOS+ כדי להפעיל את תהליך העבודה להגדרה.

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

  3. מזינים את מזהה החבילה של האפליקציה בשדה bundle ID.

  4. (אופציונלי) מזינים פרטים נוספים על האפליקציה: הכינוי של האפליקציה ומזהה App Store.

  5. לוחצים על רישום האפליקציה.

שלב 3: מוסיפים קובץ תצורה של Firebase

  1. לוחצים על Download GoogleService-Info.plist כדי לקבל את קובץ התצורה של Firebase לפלטפורמות Apple‏ (GoogleService-Info.plist).

  2. מעבירים את קובץ התצורה לתיקיית השורש של פרויקט Xcode. אם מופיעה בקשה, בוחרים להוסיף את קובץ התצורה לכל היעדים.

אם יש לכם כמה מזהי חבילות בפרויקט, עליכם לשייך כל מזהה חבילה לאפליקציה רשומה במסוף Firebase כדי שלכל אפליקציה יהיה קובץ GoogleService-Info.plist משלה.

שלב 4: מוסיפים לאפליקציה את ערכות ה-SDK של Firebase

שימוש ב-Swift Package Manager כדי להתקין ולנהל יחסי תלות ב-Firebase.

  1. ב-Xcode, כשפרויקט האפליקציה פתוח, עוברים אל קובץ > הוספת חבילות.
  2. כשמופיעה בקשה, מוסיפים את המאגר של Firebase SDK לפלטפורמות Apple:
    3.   https://github.com/firebase/firebase-ios-sdk
  3. בוחרים את גרסת ה-SDK שבה רוצים להשתמש.

  4. בוחרים את ספריות Firebase שבהן רוצים להשתמש.

    אם Google Analytics מופעל בפרויקט Firebase, חשוב להוסיף את FirebaseAnalytics. ב-Analytics ללא אפשרות לאיסוף IDFA, מוסיפים במקום זאת את הערך FirebaseAnalyticsWithoutAdId.

בסיום, Xcode יתחיל לפתור את יחסי התלות ולהוריד אותם באופן אוטומטי ברקע.

שלב 5: מפעילים את Firebase באפליקציה

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

  1. מייבאים את המודול FirebaseCore ב-UIApplicationDelegate, וגם את כל המודולים האחרים של Firebase שבהם משתמש הנציג של האפליקציה. לדוגמה, כדי להשתמש ב-Cloud Firestore וב-Authentication:

    SwiftUI

    import SwiftUI
import FirebaseCore
import FirebaseFirestore
import FirebaseAuth
// ...

    Swift

    import FirebaseCore
import FirebaseFirestore
import FirebaseAuth
// ...

    Objective-C

    @import FirebaseCore;
@import FirebaseFirestore;
@import FirebaseAuth;
// ...
  2. מגדירים מופע משותף של FirebaseApp בשיטה application(_:didFinishLaunchingWithOptions:) של הנציג של האפליקציה:

    SwiftUI

    // Use Firebase library to configure APIs
FirebaseApp.configure()

    Swift

    // Use Firebase library to configure APIs
FirebaseApp.configure()

    Objective-C

    // Use Firebase library to configure APIs
[FIRApp configure];
  3. אם אתם משתמשים ב-SwiftUI, עליכם ליצור נציג אפליקציה ולצרף אותו למבנה App דרך UIApplicationDelegateAdaptor או NSApplicationDelegateAdaptor. צריך גם להשבית את החלפת הקוד של נציג האפליקציה. מידע נוסף זמין בהוראות ל-SwiftUI.

    SwiftUI

    @main
struct YourApp: App {
  // register app delegate for Firebase setup
  @UIApplicationDelegateAdaptor(AppDelegate.self) var delegate

  var body: some Scene {
    WindowGroup {
      NavigationView {
        ContentView()
      }
    }
  }
}
  4. אם כללתם את Firebase SDK ל-Google Analytics, תוכלו להריץ את האפליקציה כדי לשלוח לאימות למסוף Firebase שההתקנה של Firebase הושלמה.

זהו זה! אפשר לדלג אל השלבים הבאים.

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

ספריות זמינות

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

שירות או מוצר Pods SwiftPM Libraries Google Analytics.">הוספת Analytics?
AdMob pod 'Google-Mobile-Ads-SDK' לא רלוונטי
Analytics pod 'FirebaseAnalytics' FirebaseAnalytics
App Check pod 'FirebaseAppCheck' FirebaseAppCheck
App Distribution pod 'FirebaseAppDistribution' FirebaseAppDistribution
Authentication pod 'FirebaseAuth' FirebaseAuth
Cloud Firestore pod 'FirebaseFirestore' FirebaseFirestore
Cloud Functions for Firebase Client SDK pod 'FirebaseFunctions' FirebaseFunctions
Cloud Messaging pod 'FirebaseMessaging' FirebaseMessaging
Cloud Storage pod 'FirebaseStorage' FirebaseStorage
Crashlytics pod 'FirebaseCrashlytics' FirebaseCrashlytics
Dynamic Links pod 'FirebaseDynamicLinks' FirebaseDynamicLinks
In-App Messaging pod 'FirebaseInAppMessaging' FirebaseInAppMessaging
(חובה)
Firebase התקנות pod 'FirebaseInstallations' FirebaseInstallations
Firebase ML ממשקי API מותאמים אישית של מודלים pod 'FirebaseMLModelDownloader' FirebaseMLModelDownloader
Performance Monitoring pod 'FirebasePerformance' FirebasePerformance
Realtime Database pod 'FirebaseDatabase' FirebaseDatabase
Remote Config pod 'FirebaseRemoteConfig' FirebaseRemoteConfig
Vertex AI in Firebase pod 'FirebaseVertexAI' FirebaseVertexAI

שילוב בלי להשתמש ב-Swift Package Manager

אם אתם לא רוצים להשתמש ב-Swift Package Manager, עדיין תוכלו להשתמש ב-SDK של Firebase באמצעות CocoaPods או לייבא את המסגרות ישירות.

CocoaPods

מידע נוסף על שילוב עם CocoaPods זמין במדריך שלנו.

מסגרות

בנוסף לתמיכה בפלטפורמת iOS, קובץ ה-zip כולל עכשיו קבצים מסוג .xcframework. פרטים נוספים זמינים בקובץ ה-README של Firebase SDK לפלטפורמות של Apple ב-GitHub.

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

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

    אפשר למצוא הוראות לשילוב בכל אחד מהמקומות הבאים:

    מידע על הגרסאות או יחסי התלות של המסגרת זמין בקובץ METADATA.md בתוך חבילת ה-zip שהורדתם.

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

השלבים הבאים

מידע נוסף על Firebase:

מוסיפים את שירותי Firebase לאפליקציה:

  • Analytics – קבלת תובנות על התנהגות המשתמשים.

  • מגדירים אימות משתמשים באמצעות Authentication.

  • לשמור נתונים, כמו פרטי משתמשים, באמצעות Cloud Firestore או Realtime Database.

  • אחסון קבצים, כמו תמונות וסרטונים, באמצעות Cloud Storage.

  • הפעלת קוד לקצה העורפי שפועל בסביבה מאובטחת באמצעות Cloud Functions.

  • שולחים התראות באמצעות Cloud Messaging.

  • Crashlytics – מתי ולמה האפליקציה קורסת