Check out what’s new from Firebase at Google I/O 2022. Learn more

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

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

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

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

    • הפרויקט שלך חייב למקד לגרסאות הפלטפורמה האלה או מאוחרות יותר:
      • iOS 10
      • macOS 10.12
      • 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 ( 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 ובאימות:

    מָהִיר

    import FirebaseCore
    import FirebaseFirestore
    import FirebaseAuth
    // ...
          

    Objective-C

    @import FirebaseCore;
    @import FirebaseFirestore;
    @import FirebaseAuth;
    // ...
          
  2. הגדר מופע משותף של FirebaseApp , בדרך כלל בשיטת האתחול של App או בשיטת application(_:didFinishLaunchingWithOptions:) של האפליקציה שלך:

    מָהִיר

    // Use Firebase library to configure APIs
    FirebaseApp.configure()

    Objective-C

    // Use Firebase library to configure APIs
    [FIRApp configure];
  3. אם כללת את 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, אתה עדיין יכול לנצל את ה-SDKs של Firebase על ידי ייבוא ​​ישיר של המסגרות או באמצעות CocoaPods.

מסגרות

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

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

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

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

CocoaPods

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

הצעדים הבאים

למד על Firebase:

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