דרישות מוקדמות
התקן את הדברים הבאים:
- Xcode 14.1 ואילך
ודא שהפרויקט שלך עומד בדרישות הבאות:
- הפרויקט שלך חייב למקד לגרסאות הפלטפורמה האלה או מאוחרות יותר:
- iOS 11
- macOS 10.13
- tvOS 12
- watchOS 6
- הפרויקט שלך חייב למקד לגרסאות הפלטפורמה האלה או מאוחרות יותר:
הגדר מכשיר אפל פיזי או השתמש בסימולטור כדי להפעיל את האפליקציה שלך.
עבור העברת הודעות בענן בפלטפורמות של Apple, להלן התנאים המוקדמים:
- הגדר מכשיר אפל פיזי .
- השג מפתח אימות של Apple Push Notification עבור חשבון ה-Apple Developer שלך.
- אפשר הודעות דחיפה ב-Xcode תחת אפליקציה > יכולות .
- היכנס ל-Firebase באמצעות חשבון Google שלך.
אם עדיין אין לך פרויקט Xcode ואתה רק רוצה לנסות מוצר Firebase, אתה יכול להוריד את אחת מדוגמאות ההתחלה המהירה שלנו.
שלב 1 : צור פרויקט Firebase
לפני שתוכל להוסיף את Firebase לאפליקציית Apple שלך, עליך ליצור פרויקט Firebase כדי להתחבר לאפליקציה שלך. בקר בהבנת פרויקטים של Firebase כדי ללמוד עוד על פרויקטים של Firebase.
שלב 2 : רשום את האפליקציה שלך ב-Firebase
כדי להשתמש ב-Firebase באפליקציית Apple שלך, עליך לרשום את האפליקציה שלך בפרויקט Firebase שלך. רישום האפליקציה שלך נקרא לעתים קרובות "הוספת" האפליקציה שלך לפרויקט שלך.
עבור אל מסוף Firebase .
במרכז דף סקירת הפרויקט, לחץ על סמל iOS+ כדי להפעיל את זרימת העבודה של ההגדרה.
אם כבר הוספת אפליקציה לפרויקט Firebase שלך, לחץ על הוסף אפליקציה כדי להציג את אפשרויות הפלטפורמה.
הזן את מזהה החבילה של האפליקציה שלך בשדה מזהה החבילה .
מזהה חבילה מזהה באופן ייחודי אפליקציה במערכת האקולוגית של אפל.
מצא את מזהה החבילה שלך: פתח את הפרויקט שלך ב-Xcode, בחר את האפליקציה ברמה העליונה בנווט הפרויקט ולאחר מכן בחר בכרטיסייה כללי .
הערך של השדה Bundle Identifier הוא מזהה החבילה (לדוגמה,
com.yourcompany.yourproject
).שים לב שערך מזהה החבילה תלוי רישיות, ולא ניתן לשנות אותו עבור אפליקציית Firebase זו לאחר שהיא נרשמה בפרויקט Firebase שלך.
(אופציונלי) הזן מידע אחר על האפליקציה: כינוי לאפליקציה ומזהה App Store .
כינוי אפליקציה : מזהה פנימי, נוחות גלוי רק לך במסוף Firebase
מזהה App Store : בשימוש על ידי Firebase Dynamic Links כדי להפנות משתמשים לדף App Store שלך ועל ידי Google Analytics לייבא אירועי המרה ל-Google Ads . אם לאפליקציה שלך עדיין אין מזהה App Store, תוכל להוסיף את המזהה מאוחר יותר בהגדרות הפרויקט שלך.
לחץ על הרשמה אפליקציה .
שלב 3 : הוסף קובץ תצורה של Firebase
לחץ על הורד את GoogleService-Info.plist כדי להשיג את קובץ התצורה של Firebase Apple platforms שלך (
GoogleService-Info.plist
).קובץ התצורה של Firebase מכיל מזהים ייחודיים, אך לא סודיים עבור הפרויקט שלך. למידע נוסף על קובץ תצורה זה, בקר ב- Understand Firebase Projects .
תוכל להוריד שוב את קובץ התצורה של Firebase בכל עת.
ודא ששם קובץ התצורה אינו מצורף עם תווים נוספים, כמו
(2)
.
העבר את קובץ התצורה שלך לשורש פרויקט ה-Xcode שלך. אם תתבקש, בחר להוסיף את קובץ התצורה לכל היעדים.
אם יש לך מספר מזהי חבילה בפרויקט שלך, עליך לשייך כל מזהה חבילה לאפליקציה רשומה במסוף Firebase כך שלכל אפליקציה תהיה קובץ GoogleService-Info.plist
משלה.
שלב 4 : הוסף ערכות SDK של Firebase לאפליקציה שלך
השתמש ב- Swift Package Manager כדי להתקין ולנהל תלות ב-Firebase.
- ב-Xcode, כשפרויקט האפליקציה שלך פתוח, נווט אל קובץ > הוסף חבילות .
- כשתתבקש, הוסף את מאגר Firebase Apple platforms SDK:
- בחר את גרסת ה-SDK שבה ברצונך להשתמש.
בחר את ספריות Firebase שבהן תרצה להשתמש.
אם Google Analytics מופעל בפרויקט Firebase שלך, הקפד להוסיף את
FirebaseAnalytics
. עבור Analytics ללא יכולת איסוף IDFA, הוסף במקום זאתFirebaseAnalyticsWithoutAdId
.
https://github.com/firebase/firebase-ios-sdk
בסיום, Xcode יתחיל באופן אוטומטי לפתור ולהוריד את התלות שלך ברקע.
שלב 5 : אתחל את Firebase באפליקציה שלך
השלב האחרון הוא הוספת קוד אתחול לאפליקציה שלך. ייתכן שכבר עשית זאת כחלק מהוספת Firebase לאפליקציה שלך. אם אתה משתמש בפרויקט לדוגמה של התחלה מהירה , זה נעשה עבורך.
- ייבא את מודול
FirebaseCore
ב-UIApplicationDelegate
שלך, כמו גם כל מודולי Firebase אחרים שנציג האפליקציה שלך משתמש בו. לדוגמה, כדי להשתמש ב-Cloud Firestore ובאימות:SwiftUI
import SwiftUI import FirebaseCore import FirebaseFirestore import FirebaseAuth // ...
מָהִיר
import FirebaseCore import FirebaseFirestore import FirebaseAuth // ...
Objective-C
@import FirebaseCore; @import FirebaseFirestore; @import FirebaseAuth; // ...
- הגדר מופע משותף
FirebaseApp
בשיטתapplication(_:didFinishLaunchingWithOptions:)
של נציג האפליקציה שלך:SwiftUI
// Use Firebase library to configure APIs FirebaseApp.configure()
מָהִיר
// Use Firebase library to configure APIs FirebaseApp.configure()
Objective-C
// Use Firebase library to configure APIs [FIRApp configure];
- אם אתה משתמש ב- SwiftUI, עליך ליצור נציג יישום ולצרף אותו למבנה
App
שלך באמצעותUIApplicationDelegateAdaptor
אוNSApplicationDelegateAdaptor
. עליך גם להשבית את העברת נציגי האפליקציה. למידע נוסף, עיין בהוראות של SwiftUI .SwiftUI
@main struct YourApp: App { // register app delegate for Firebase setup @UIApplicationDelegateAdaptor(AppDelegate.self) var delegate var body: some Scene { WindowGroup { NavigationView { ContentView() } } } }
- אם כללת את Firebase SDK עבור Google Analytics, תוכל להפעיל את האפליקציה שלך כדי לשלוח למסוף Firebase אימות שהתקנת את Firebase בהצלחה.
זהו זה! אתה יכול לדלג קדימה לשלבים הבאים .
עם זאת, אם אתה מתקשה להתקין, בקר בדף פתרון הבעיות והשאלות הנפוצות של פלטפורמות Apple .
ספריות זמינות
סעיף זה מפרט את מוצרי Firebase הנתמכים עבור פלטפורמות Apple. למידע נוסף על ספריות הפלטפורמה האלה של Firebase Apple:
Firebase Apple platforms SDK GitHub repo
שירות או מוצר | תרמילים | ספריות SwiftPM | להוסיף אנליטיקס? |
---|---|---|---|
AdMob | pod 'Google-Mobile-Ads-SDK' | לא | |
ניתוח | pod 'FirebaseAnalytics' | FirebaseAnalytics | |
בדיקת אפליקציה | pod 'FirebaseAppCheck' | FirebaseAppCheck | |
הפצת אפליקציות | pod 'FirebaseAppDistribution' | FirebaseAppDistribution | |
אימות | pod 'FirebaseAuth' | FirebaseAuth | |
Cloud Firestore | pod 'FirebaseFirestore' | FirebaseFirestore | |
Cloud Functions for Firebase Client SDK | pod 'FirebaseFunctions' | FirebaseFunctions | |
העברת הודעות בענן | pod 'FirebaseMessaging' | FirebaseMessaging | |
אחסון בענן | pod 'FirebaseStorage' | FirebaseStorage | |
Crashlytics | pod 'FirebaseCrashlytics' | FirebaseCrashlytics | |
קישורים דינמיים | pod 'FirebaseDynamicLinks' | FirebaseDynamicLinks | |
העברת הודעות בתוך האפליקציה | pod 'FirebaseInAppMessaging' | FirebaseInAppMessaging | (נדרש) |
התקנות Firebase | pod 'FirebaseInstallations' | FirebaseInstallations | |
ממשקי API של מודל מותאם אישית של Firebase ML | pod 'FirebaseMLModelDownloader' | FirebaseMLModelDownloader | |
ניטור ביצועים | pod 'FirebasePerformance' | FirebasePerformance | |
מסד נתונים בזמן אמת | pod 'FirebaseDatabase' | FirebaseDatabase | |
תצורה מרחוק | pod 'FirebaseRemoteConfig' | FirebaseRemoteConfig |
השתלב ללא שימוש ב- Swift Package Manager
אם אינך רוצה להשתמש ב- Swift Package Manager, אתה עדיין יכול לנצל את ה-SDKs של Firebase על ידי שימוש ב-CocoaPods או על ידי ייבוא ישיר של המסגרות.
CocoaPods
למידע נוסף על שילוב CocoaPods במדריך שלנו .
מסגרות
בנוסף לתמיכה בפלטפורמת iOS, ה-zip כולל כעת קובצי .xcframework
. לפרטים, ראה את ה-SDK README של פלטפורמות Firebase של Apple ב-GitHub .
הורד את ה- framework SDK zip . זהו קובץ ~200MB וייתכן שייקח זמן מה להורדה.
פתח את הקובץ ולאחר מכן שלב את המסגרות שברצונך לכלול באפליקציה שלך.
תוכל למצוא הוראות שילוב בכל אחד מהמקומות הבאים:
- במאגר GitHub של Firebase iOS SDK .
- בקובץ
README.md
בתוך הפצת ה-zip שהורדת.
למידע לגבי גירסאות מסגרת או תלות, עיין בקובץ
METADATA.md
בהפצת ה-zip שהורדת.הוסף את דגל הקישור
-ObjC
בהגדרותOther Linker Settings
שלך בהגדרות הבנייה של היעד שלך.
הצעדים הבאים
למד על Firebase:
בקר בהבנת פרויקטים של Firebase כדי ללמוד עוד על פרויקטים של Firebase ושיטות עבודה מומלצות לפרויקטים.
קבל ניסיון מעשי עם Firebase iOS Codelab .
חקור את קוד המקור הפתוח ב-GitHub .
היכונו להפעלת האפליקציה שלכם:
- הגדר התראות תקציב עבור הפרויקט שלך במסוף Google Cloud.
- עקוב אחר לוח המחוונים של השימוש והחיובים במסוף Firebase כדי לקבל תמונה כוללת של השימוש בפרויקט שלך בשירותי Firebase מרובים.
- עיין ברשימת המשימות להפעלת Firebase .
נתקלת בבעיות עם Firebase ופרויקט Apple שלך? בקר בדף פתרון הבעיות והשאלות הנפוצות של פלטפורמות אפל .
הוסף שירותי Firebase לאפליקציה שלך:
קבל תובנות על התנהגות המשתמשים עם Analytics .
הגדר אימות משתמש באמצעות אימות .
אחסן נתונים, כמו מידע משתמש, עם Cloud Firestore או Realtime Database .
אחסן קבצים, כמו תמונות וסרטונים, עם Cloud Storage .
הפעל קוד backend שפועל בסביבה מאובטחת עם פונקציות ענן .
שלח הודעות עם הודעות ענן .
גלה מתי ומדוע האפליקציה שלך קורסת עם Crashlytics .