Save the date - Google I/O returns May 18-20. Register to get the most out of the digital experience: Build your schedule, reserve space, participate in Q&As, earn Google Developer profile badges, and more. Register now
דף זה תורגם על ידי 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 שלך. בקר ב- Understand Firebase Projects למידע נוסף על פרויקטים של 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' # 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, מזהה הפרסום ברמת המכשיר, מופיעים בתיעוד של שקיפות פרטיות משתמשים ושימוש בנתונים ותיעוד שקיפות למעקב אחר אפליקציות .

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

    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 בהצלחה.

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

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

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

סעיף זה מפרט את מוצרי 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'
קרסליטים 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 שמוסיפים תמיכה בקטליסט מבוסס קהילה. לפרטים, עיין ב- Firebase iOS SDK README ב- GitHub .

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

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

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

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

למד עוד על שילוב מנהל חבילות Swift במדריך שלנו .

הצעדים הבאים

למד אודות Firebase:

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