Google is committed to advancing racial equity for Black communities. See how.
דף זה תורגם על ידי Cloud Translation API.
Switch to English

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

אנו ממליצים להשתמש ב- CocoaPods להתקנת ספריות Firebase. עם זאת, אם אתה מעדיף לא להשתמש ב- CocoaPods, תוכל לשלב את מסגרות ה- SDK ישירות או להשתמש במנהל החבילות Swift (בטא) .

האם אתה משתמש באחת מדוגמאות ההפעלה המהירה ? פרויקט ה- 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'
    # 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'

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

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

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

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

    מָהִיר

    import Firebase

    מטרה-ג

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

    מָהִיר

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

    מטרה-ג

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

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

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

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

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

השתלב ללא CocoaPods

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

מסגרות

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

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

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

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

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

תמיכת מנהל החבילות של Swift כרגע בגרסת בטא. עקוב אחר התיעוד ב- GitHub והגש כל משוב לגשש הבעיות של GitHub .

הצעדים הבאים

למד אודות Firebase:

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