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

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

  • התקן את הדברים הבאים:

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

    • הפרויקט שלך חייב למקד לגרסאות הפלטפורמה האלה או מאוחרות יותר:
      • iOS 11
      • macOS 10.13
      • tvOS 12
      • watchOS 6
  • הגדר מכשיר אפל פיזי או השתמש בסימולטור כדי להפעיל את האפליקציה שלך.

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

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

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

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

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

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

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

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

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

  4. (אופציונלי) הזן מידע אחר על האפליקציה: כינוי לאפליקציה ומזהה App Store .

  5. לחץ על הרשמה אפליקציה .

שלב 3 : הוסף קובץ תצורה של Firebase

  1. לחץ על הורד את GoogleService-Info.plist כדי להשיג את קובץ התצורה של Firebase Apple platforms שלך ( GoogleService-Info.plist ).

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

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

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

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

  1. ב-Xcode, כשפרויקט האפליקציה שלך פתוח, נווט אל קובץ > הוסף חבילות .
  2. כשתתבקש, הוסף את מאגר Firebase Apple platforms SDK:
  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 ובאימות:

    SwiftUI

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

    מָהִיר

    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()

    מָהִיר

    // 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. למידע נוסף על ספריות הפלטפורמה האלה של Firebase Apple:

שירות או מוצר תרמילים ספריות SwiftPM להוסיף אנליטיקס?
AdMob pod 'Google-Mobile-Ads-SDK' לא
ניתוח pod 'FirebaseAnalytics' FirebaseAnalytics
בדיקת אפליקציה pod 'FirebaseAppCheck' FirebaseAppCheck
הפצת אפליקציות pod 'FirebaseAppDistribution' FirebaseAppDistribution
אימות pod 'FirebaseAuth' FirebaseAuth
Cloud Firestore pod 'FirebaseFirestore' FirebaseFirestore
Cloud Functions for Firebase Client SDK pod 'FirebaseFunctions' FirebaseFunctions
העברת הודעות בענן pod 'FirebaseMessaging' FirebaseMessaging
אחסון בענן pod 'FirebaseStorage' FirebaseStorage
Crashlytics pod 'FirebaseCrashlytics' FirebaseCrashlytics
קישורים דינמיים pod 'FirebaseDynamicLinks' FirebaseDynamicLinks
העברת הודעות בתוך האפליקציה pod 'FirebaseInAppMessaging' FirebaseInAppMessaging
(נדרש)
התקנות Firebase pod 'FirebaseInstallations' FirebaseInstallations
ממשקי API של מודל מותאם אישית של Firebase ML pod 'FirebaseMLModelDownloader' FirebaseMLModelDownloader
ניטור ביצועים pod 'FirebasePerformance' FirebasePerformance
מסד נתונים בזמן אמת pod 'FirebaseDatabase' FirebaseDatabase
תצורה מרחוק pod 'FirebaseRemoteConfig' FirebaseRemoteConfig

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

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

CocoaPods

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

מסגרות

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

  1. הורד את ה- framework SDK zip . זהו קובץ ~200MB וייתכן שייקח זמן מה להורדה.

  2. פתח את הקובץ ולאחר מכן שלב את המסגרות שברצונך לכלול באפליקציה שלך.

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

    למידע לגבי גירסאות מסגרת או תלות, עיין בקובץ METADATA.md בהפצת ה-zip שהורדת.

  3. הוסף את דגל הקישור -ObjC בהגדרות Other Linker Settings שלך בהגדרות הבנייה של היעד שלך.

הצעדים הבאים

למד על Firebase:

הוסף שירותי Firebase לאפליקציה שלך: