דרישות מוקדמות
מתקינים את האפליקציות הבאות:
- Xcode 15.2 ואילך
עליכם לוודא שהפרויקט עומד בדרישות הבאות:
- הפרויקט צריך לטרגט את גרסאות הפלטפורמה הבאות או גרסאות מתקדמות יותר:
- iOS 13
- macOS 10.15
- tvOS 13
- watchOS 7
- הפרויקט צריך לטרגט את גרסאות הפלטפורמה הבאות או גרסאות מתקדמות יותר:
מגדירים מכשיר פיזי של Apple או משתמשים בסימולטור כדי להריץ את האפליקציה.
- נכנסים ל-Firebase באמצעות חשבון Google.
אם עדיין אין לכם פרויקט Xcode ואתם רק רוצים לנסות מוצר של Firebase, תוכלו להוריד אחת מהדוגמאות למתחילים.
שלב 1: יוצרים פרויקט Firebase
לפני שמוסיפים את Firebase לאפליקציה ל-Apple, צריך ליצור פרויקט Firebase כדי לקשר אותו לאפליקציה. מידע נוסף על פרויקטים ב-Firebase זמין במאמר הסבר על פרויקטים ב-Firebase.
שלב 2: רושמים את האפליקציה ב-Firebase
כדי להשתמש ב-Firebase באפליקציה של Apple, עליכם לרשום את האפליקציה בפרויקט Firebase. לעיתים קרובות, רישום האפליקציה נקרא 'הוספת' האפליקציה לפרויקט.
נכנסים אל מסוף Firebase.
כדי להפעיל את תהליך ההגדרה במרכז הדף של הסקירה הכללית של הפרויקט, לוחצים על הסמל iOS+.
אם כבר הוספתם אפליקציה לפרויקט Firebase, לוחצים על Add app כדי להציג את אפשרויות הפלטפורמה.
מזינים את מזהה החבילה של האפליקציה בשדה bundle ID.
(אופציונלי) מזינים פרטים נוספים על האפליקציה: הכינוי של האפליקציה ומזהה App Store.
לוחצים על רישום האפליקציה.
שלב 3: הוספת קובץ תצורה של Firebase
לוחצים על Download GoogleService-Info.plist כדי לקבל את קובץ התצורה של Firebase לפלטפורמות Apple (
GoogleService-Info.plist
).מעבירים את קובץ התצורה לתיקיית השורש של פרויקט Xcode. אם מופיעה בקשה, בוחרים להוסיף את קובץ התצורה לכל היעדים.
אם יש בפרויקט כמה מזהי חבילות, צריך לשייך כל מזהה חבילה לאפליקציה רשומה במסוף Firebase כדי שלכל אפליקציה יהיה קובץ GoogleService-Info.plist
משלה.
שלב 4: מוסיפים לאפליקציה את ערכות ה-SDK של Firebase
שימוש ב-Swift Package Manager כדי להתקין ולנהל יחסי תלות ב-Firebase.
- ב-Xcode, כשפרויקט האפליקציה פתוח, עוברים אל קובץ > הוספת חבילות.
- כשמופיעה בקשה, מוסיפים את המאגר של Firebase SDK לפלטפורמות של Apple:
- בוחרים את גרסת ה-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 וב-Authentication:SwiftUI
import SwiftUI import FirebaseCore import FirebaseFirestore import FirebaseAuth // ...
Swift
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()
Swift
// 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. מידע נוסף על הספריות האלה בפלטפורמת Apple של Firebase:
מאגר GitHub של Firebase Apple platforms SDK
שירות או מוצר | Pods | SwiftPM Libraries | Google Analytics.">הוספת Analytics? |
---|---|---|---|
AdMob | pod 'Google-Mobile-Ads-SDK' |
לא רלוונטי | |
Analytics | pod 'FirebaseAnalytics' |
FirebaseAnalytics |
|
App Check | pod 'FirebaseAppCheck' |
FirebaseAppCheck |
|
App Distribution | pod 'FirebaseAppDistribution' |
FirebaseAppDistribution |
|
Authentication | pod 'FirebaseAuth' |
FirebaseAuth |
|
Cloud Firestore | pod 'FirebaseFirestore' |
FirebaseFirestore |
|
Cloud Functions for Firebase Client SDK | pod 'FirebaseFunctions' |
FirebaseFunctions |
|
Cloud Messaging | pod 'FirebaseMessaging' |
FirebaseMessaging |
|
Cloud Storage | pod 'FirebaseStorage' |
FirebaseStorage |
|
Crashlytics | pod 'FirebaseCrashlytics' |
FirebaseCrashlytics |
|
Dynamic Links | pod 'FirebaseDynamicLinks' |
FirebaseDynamicLinks |
|
In-App Messaging | pod 'FirebaseInAppMessaging' |
FirebaseInAppMessaging |
(חובה) |
Firebase התקנות | pod 'FirebaseInstallations' |
FirebaseInstallations |
|
Firebase ML ממשקי API מותאמים אישית של מודלים | pod 'FirebaseMLModelDownloader' |
FirebaseMLModelDownloader |
|
Performance Monitoring | pod 'FirebasePerformance' |
FirebasePerformance |
|
Realtime Database | pod 'FirebaseDatabase' |
FirebaseDatabase |
|
Remote Config | pod 'FirebaseRemoteConfig' |
FirebaseRemoteConfig |
|
Vertex AI in Firebase | pod 'FirebaseVertexAI' |
FirebaseVertexAI |
שילוב בלי להשתמש ב-Swift Package Manager
אם אתם לא רוצים להשתמש ב-Swift Package Manager, עדיין תוכלו להשתמש ב-SDK של Firebase באמצעות CocoaPods או לייבא את המסגרות ישירות.
CocoaPods
במדריך שלנו תוכלו לקרוא מידע נוסף על השילוב עם CocoaPods.
מסגרות
בנוסף לתמיכה בפלטפורמת iOS, קובץ ה-ZIP כולל עכשיו קובצי .xcframework
. למידע נוסף, עיינו במאמר README של Firebase Platform SDK ב-GitHub.
מורידים את קובץ ה-zip של ה-SDK של המסגרת. זהו קובץ בנפח של כ-200MB, וההורדה שלו עשויה להימשך זמן מה.
מבטלים את הדחיסה של הקובץ ומשתמשים במסגרות שרוצים לכלול באפליקציה.
אפשר למצוא הוראות לשילוב בכל אחד מהמקומות הבאים:
- במאגר Firebase iOS SDK GitHub.
- בקובץ
README.md
בתוך הפצת ה-ZIP שהורדתם.
מידע על הגרסאות או יחסי התלות של המסגרת זמין בקובץ
METADATA.md
בתוך חבילת ה-zip שהורדתם.מוסיפים את דגל הקישור
-ObjC
ל-Other Linker Settings
בהגדרות ה-build של היעד.
השלבים הבאים
מידע על Firebase:
במאמר הסבר על פרויקטים ב-Firebase מוסבר בהרחבה על פרויקטים ב-Firebase ועל שיטות מומלצות לניהול פרויקטים.
Codelab של Firebase ל-iOS – ניסיון מעשי.
הכנה להשקת האפליקציה:
- צריך להגדיר התראות תקציב לפרויקט במסוף Google Cloud.
- במסוף Firebase, אפשר לעקוב אחרי לוח הבקרה של השימוש והחיוב כדי לקבל תמונה כללית של השימוש בפרויקט במספר שירותי Firebase.
- כדאי לעיין ברשימת המשימות להשקת Firebase.
נתקלתם בבעיות ב-Firebase ובפרויקט ב-Apple? פתרון בעיות בשילוב עם פלטפורמות Apple ושאלות נפוצות
הוספת שירותי Firebase לאפליקציה:
קבלת תובנות על התנהגות המשתמשים באמצעות Analytics.
מגדירים אימות משתמשים באמצעות Authentication.
לשמור נתונים, כמו פרטי משתמשים, באמצעות Cloud Firestore או Realtime Database.
עם Cloud Storage אפשר לאחסן קבצים, כמו תמונות וסרטונים.
הפעלת קוד לקצה העורפי שפועל בסביבה מאובטחת באמצעות Cloud Functions.
שליחת התראות באמצעות Cloud Messaging.
רוצה לדעת מתי ולמה האפליקציה קורסת עם Crashlytics?