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

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

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

    • ‫Xcode 26.2 ואילך

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

    • הפרויקט שלכם צריך להיות מיועד לגרסאות הפלטפורמה האלה ומעלה:
      • iOS 15
      • ‫macOS 10.15
      • tvOS 15
      • watchOS 7

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

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

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

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

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

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

  1. עוברים אל מסוף Firebase.

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

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

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

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

  5. לוחצים על Register app (רישום האפליקציה).

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

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

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

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

שלב 4: מוסיפים את Firebase SDKs לאפליקציה

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

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

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

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

אחרי שתסיימו, פלטפורמת 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. מגדירים מופע משותף בשיטה application(_:didFinishLaunchingWithOptions:) של נציג האפליקציה:FirebaseApp

    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.

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

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

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

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

שירות או מוצר Pods ספריות SwiftPM הוספת Analytics?
AdMob pod 'Google-Mobile-Ads-SDK' לא רלוונטי
Firebase AI Logic 1
 pod 'FirebaseAILogic' FirebaseAILogic
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
SQL Connect 2 לא רלוונטי FirebaseDataConnect
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
ספריות שהוצאו משימוש או שלא נתמכות
Dynamic Links pod 'FirebaseDynamicLinks' FirebaseDynamicLinks

‫1 Firebase AI Logic (FirebaseAILogic) נקרא בעבר Vertex AI ב-Firebase והופץ במסגרת המודול FirebaseVertexAI. Firebase AI Logic הופץ בעבר גם במסגרת המודול FirebaseAI.

2 Firebase SQL Connect נקרא בעבר 'Firebase Data Connect'.

שילוב ללא שימוש ב-Swift Package Manager

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

CocoaPods

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

‫Frameworks

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

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

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

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

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

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

השלבים הבאים

מידע נוסף על Firebase

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

  • פיתוח תכונות של AI גנרטיבי באמצעות מודלים של Gemini ו-Imagen באמצעות Firebase AI Logic.

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

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

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

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

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

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

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