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

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

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

    • ‫Xcode 16.2 ואילך

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

שירות או מוצר Pods ספריות SwiftPM רוצים להוסיף את Analytics?
AdMob pod 'Google-Mobile-Ads-SDK' לא רלוונטי
Firebase AI Logic 1
 pod 'FirebaseAI' FirebaseAI
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
Data Connect לא רלוונטי FirebaseDataConnect
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

1 Firebase AI Logic נקרא בעבר ‫"Vertex AI in Firebase" עם ה-pod‏ pod 'FirebaseVertexAI' וספריית SwiftPM‏ FirebaseVertexAI.

שילוב ללא שימוש ב-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 Settings בהגדרות הבנייה של היעד.

השלבים הבאים

מידע על Firebase

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

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

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

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

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

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

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

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

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