הוספת 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, לוחצים על Add app כדי להציג את אפשרויות הפלטפורמה.

  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
  4. בוחרים את גרסת ה-SDK שבה רוצים להשתמש.
  5. בוחרים את ספריות 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 Platform SDK ב-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?