הוספת 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. מזינים את מזהה החבילה של האפליקציה בשדה bundle ID (מזהה החבילה).

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

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

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

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

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

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

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

משתמשים ב-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. מגדירים מופע משותף של 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. צריך גם להשבית את החלפת השיטות ב-app delegate. מידע נוסף זמין בהוראות ל-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 ב-Firebase:

שירות או מוצר שם הספרייה או ה-Framework הוספת Analytics
AdMob GoogleMobileAds
Firebase AI Logic 1
 FirebaseAILogic
Analytics FirebaseAnalytics
App Check FirebaseAppCheck
App Distribution FirebaseAppDistribution
Authentication FirebaseAuth
Cloud Firestore FirebaseFirestore
Cloud Functions for Firebase Client SDK FirebaseFunctions
Cloud Messaging FirebaseMessaging
Cloud Storage FirebaseStorage
Crashlytics FirebaseCrashlytics
In-App Messaging FirebaseInAppMessaging (חובה)
Firebase התקנות FirebaseInstallations
Performance Monitoring FirebasePerformance
Realtime Database FirebaseDatabase
Remote Config FirebaseRemoteConfig
SQL Connect 2 FirebaseDataConnect
ספריות שהוצאו משימוש או לא נתמכות
Dynamic Links FirebaseDynamicLinks
Firebase ML ממשקי API של מודלים בהתאמה אישית FirebaseMLModelDownloader

‫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 על ידי ייבוא ישיר של המסגרות שעברו קומפילציה מראש.

‫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 באמצעות Firebase AI Logic.

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

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

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

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

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

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

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