Join us for Firebase Summit on November 10, 2021. Tune in to learn how Firebase can help you accelerate app development, release with confidence, and scale with ease. Register

הוסף את 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 שלך.

    Analytics מופעל

    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 מעקב שקיפות ותיעוד.

    Analytics אינו מופעל

    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

    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 Analytics, תוכל להריץ את האפליקציה שלך כדי לשלוח אימות לקונסולת Firebase שהתקנת בהצלחה את Firebase.

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

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

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

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

שירות או מוצר תרמילים להוסיף Analytics?
AdMob pod 'Google-Mobile-Ads-SDK'
ניתוח pod 'Firebase/Analytics'
בדיקת אפליקציות pod 'Firebase/AppCheck'
הפצת אפליקציות pod 'Firebase/AppDistribution'
אימות pod 'Firebase/Auth'
Cloud Firestore pod 'Firebase/Firestore'
פונקציות ענן עבור Firebase Client SDK 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 המוסיפים תמיכה מבוססת Catalyst מבוססת קהילה. לפרטים ראה בקובץ Readme SDK Firebase iOS על GitHub .

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

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

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

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

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

הצעדים הבאים

למד על Firebase:

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