Catch up on everthing we announced at this year's Firebase Summit. Learn more

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

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

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

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

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

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

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

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

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

לאחר שיש לך פרויקט Firebase, תוכל להוסיף אליו את אפליקציית Apple שלך.

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

  1. עבור אל קונסולת Firebase .

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

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

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

  4. (אופציונלי) זן פרטי אפליקציה אחרים: כינוי App ו- App Store ID.

  5. לחץ אפליקצית רישום.

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

  1. לחץ להורדה GoogleService-info.plist להשיג קובץ config פלטפורמות Firebase האפל שלך ( GoogleService-Info.plist ).

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

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

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

השתמש ב-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: Initialize Firebase באפליקציה

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

  1. ייבא את מודול Firebase ב שלך UIApplicationDelegate :

    מָהִיר

    import Firebase

    Objective-C

    @import Firebase;
  2. & Nbsp הגדר FirebaseApp משותף למשל, בדרך כלל של האפליקציה שלך 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 בהצלחה.

זהו זה! אתה יכול לדלג על השלבים הבאים .

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

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

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

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

השתלב ללא מנהל תלות

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

מסגרות

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

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

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

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

CocoaPods

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

הצעדים הבאים

למד על Firebase:

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