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

תנאים מוקדמים

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

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

    • על הפרויקט שלך למקד ל- iOS 10 ואילך.
  • הגדר מכשיר iOS פיזי או השתמש בסימולטור iOS להפעלת האפליקציה שלך.

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

אנו ממליצים להשתמש CocoaPods להתקין את ספריות Firebase. עם זאת, אם אתה מעדיף לא להשתמש CocoaPods, אתה יכול לשלב את המסגרות SDK ישירות או להשתמש סוויפט Package Manager במקום.

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

  1. צור קובץ Podfile אם עדיין אין לך:

    cd your-project-directory
    pod init
  2. אל Podfile שלך, הוסף את תרמילי Firebase שבהם ברצונך להשתמש באפליקציה שלך.

    ניתן להוסיף כל אחד מוצרים Firebase נתמך אפליקציית iOS שלך.

    ניתוח מופעל

    platform :ios, ‘10.0’
    # Add the Firebase pod for Google Analytics pod 'Firebase/Analytics' # For Analytics without IDFA collection capability, use this pod instead # pod ‘Firebase/AnalyticsWithoutAdIdSupport’ # Add the pods for any other Firebase products you want to use in your app # For example, to use Firebase Authentication and Cloud Firestore pod 'Firebase/Auth' pod 'Firebase/Firestore'

    למידע נוסף על IDFA, מזהה פרסום ברמת ההתקן, ב של אפל פרטיות המשתמש ושימוש נתונים ו App מעקב שקיפות ותיעוד.

    ניתוח לא מופעל

    platform :ios, ‘10.0’
    # Add the pods for the Firebase products you want to use in your app # For example, to use Firebase Authentication and Cloud Firestore pod 'Firebase/Auth' pod 'Firebase/Firestore'
  3. התקן את התרמילים, ולאחר מכן פתח את .xcworkspace קובץ כדי לראות את הפרויקט ב Xcode:

    pod install
    open your-project.xcworkspace

שלב 5: Initialize Firebase באפליקציה

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

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

    מָהִיר

    import Firebase

    מטרה-ג

    @import Firebase;
  2. & Nbsp הגדר FirebaseApp משותף למשל, בדרך כלל של האפליקציה שלך application:didFinishLaunchingWithOptions: השיטה:

    מָהִיר

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

    מטרה-ג

    // Use Firebase library to configure APIs
    [FIRApp configure];
  3. אם כללת את Firebase Analytics, תוכל להפעיל את האפליקציה שלך כדי לשלוח אימות למסוף Firebase שהתקנת את Firebase בהצלחה.

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

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

תרמילים זמינים

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

שירות או מוצר תרמילים להוסיף אנליטיקס?
AdMob pod 'Google-Mobile-Ads-SDK'
ניתוח pod 'Firebase/Analytics'
בדיקת אפליקציות pod 'Firebase/AppCheck'
הפצת אפליקציות pod 'Firebase/AppDistribution'
אימות pod 'Firebase/Auth'
ענן Firestore pod 'Firebase/Firestore'
פונקציות ענן עבור SDK של לקוח Firebase pod 'Firebase/Functions'
מסרים בענן pod 'Firebase/Messaging'
אחסון בענן pod 'Firebase/Storage'
קריסלטיקים pod 'Firebase/Crashlytics'
קישורים דינמיים pod 'Firebase/DynamicLinks'
הודעות בתוך האפליקציה pod 'Firebase/InAppMessaging'
(נדרש)
התקנות Firebase pod 'Firebase/Installations'
ממשקי API למודל מותאם אישית של Firebase ML pod 'Firebase/MLModelDownloader'
ניטור ביצועים pod 'Firebase/Performance'
מסד נתונים בזמן אמת pod 'Firebase/Database'
תצורה מרחוק pod 'Firebase/RemoteConfig'

השתלב ללא CocoaPods

אם אתה לא רוצה להשתמש ב- Cocoapods, אתה עדיין יכול לנצל את ה- SDK של Firebase על ידי ייבוא ​​המסגרות ישירות או באמצעות מנהל החבילות Swift.

מסגרות

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

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

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

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

מנהל חבילות סוויפט

למידע נוסף על אינטגרצית מנהל חבילות סוויפט ב המדריך שלנו .

הצעדים הבאים

למד אודות Firebase:

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