הוספת Firebase לפרויקט של Apple

דרישות מוקדמות

• מתקינים את הדברים הבאים:

  • ‫Xcode 26.2 ואילך

• חשוב לוודא שהפרויקט עומד בדרישות הבאות:

  • הפרויקט צריך לטרגט את גרסאות הפלטפורמה האלה או גרסאות חדשות יותר:
    • iOS 15
    • macOS 11
    • tvOS 15
    • watchOS 8

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

  רוצה להשתמש ב-Cloud Messaging?

  אלה הדרישות המוקדמות לשימוש ב-Cloud Messaging בפלטפורמות של Apple:

  • מגדירים מכשיר פיזי של אפל.
  • משיגים מפתח אימות של שירות ההתראות של אפל (APNs) לחשבון הפיתוח של אפל.
  • מפעילים התראות ב-Xcode בקטע App > Capabilities (אפליקציה > יכולות).

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

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

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

הוראות ליצירת פרויקט ב-Firebase

משתמשים חדשים ב-Firebase או ב-Cloud

אם אתם משתמשים חדשים ב-Firebase או ב-Google Cloud, אתם צריכים לפעול לפי השלבים הבאים.
אפשר גם לפעול לפי השלבים האלה כדי ליצור פרויקט Firebase חדש לגמרי (והפרויקט הבסיסי שלו ב-Google Cloud).

1. נכנסים למסוף Firebase.
2. לוחצים על הכפתור כדי ליצור פרויקט חדש ב-Firebase.

3. בשדה הטקסט, מזינים שם לפרויקט.

   אם אתם חלק מארגון ב-Google Cloud, אתם יכולים לבחור באיזו תיקייה ליצור את הפרויקט.

4. אם מוצגת בקשה, קוראים ומאשרים את התנאים של Firebase ולוחצים על Continue.
5. (אופציונלי) מפעילים את העזרה מבוססת-AI במסוף Firebase (נקראת Gemini ב-Firebase), שיכולה לעזור לכם להתחיל ולייעל את תהליך הפיתוח.

6. (אופציונלי) מגדירים את Google Analytics לפרויקט, כדי לאפשר חוויית שימוש אופטימלית במוצרי Firebase הבאים: Firebase A/B Testing,‏ Cloud Messaging,‏ Crashlytics,‏ In-App Messaging ו-Remote Config (כולל התאמה אישית).

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

7. לוחצים על Create project.

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

פרויקט קיים ב-Cloud

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

1. נכנסים למסוף Firebase באמצעות החשבון שנותן גישה לפרויקט הקיים ב-Google Cloud.
2. לוחצים על הכפתור כדי ליצור פרויקט חדש ב-Firebase.
3. בתחתית הדף, לוחצים על Add Firebase to Google Cloud project.
4. בשדה הטקסט, מתחילים להזין את שם הפרויקט הקיים ובוחרים את הפרויקט מהרשימה שמוצגת.
5. לוחצים על פתיחת הפרויקט.
6. אם מוצגת בקשה, קוראים ומאשרים את התנאים של Firebase ולוחצים על Continue.
7. (אופציונלי) מפעילים את העזרה מבוססת-AI במסוף Firebase (נקראת Gemini ב-Firebase), שיכולה לעזור לכם להתחיל ולייעל את תהליך הפיתוח.

8. (אופציונלי) מגדירים את Google Analytics לפרויקט, כדי לאפשר חוויית שימוש אופטימלית במוצרי Firebase הבאים: Firebase A/B Testing,‏ Cloud Messaging,‏ Crashlytics,‏ In-App Messaging ו-Remote Config (כולל התאמה אישית).

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

9. לוחצים על הוספת Firebase.

‫Firebase מוסיף את Firebase לפרויקט הקיים. בסיום התהליך, תועברו לדף הסקירה הכללית של הפרויקט ב-Firebase במסוף Firebase.

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

כדי להשתמש ב-Firebase באפליקציה ל-Apple, צריך לרשום את האפליקציה בפרויקט Firebase. רישום האפליקציה נקרא לעיתים קרובות "הוספת" האפליקציה לפרויקט.

1. נכנסים למסוף Firebase.

2. במרכז דף הסקירה הכללית של הפרויקט, לוחצים על הסמל iOS+‎ כדי להפעיל את תהליך ההגדרה.

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

3. מזינים את מזהה החבילה של האפליקציה בשדה מזהה חבילה.

   מה זה מזהה חבילה ואיפה הוא נמצא?

   • מזהה חבילה מזהה באופן ייחודי אפליקציה בסביבה העסקית של אפל.

   • כדי למצוא את מזהה החבילה: פותחים את הפרויקט ב-Xcode, בוחרים את האפליקציה ברמה העליונה בחלונית הניווט בפרויקט, ואז בוחרים בכרטיסייה General (כללי).

     הערך של השדה Bundle Identifier הוא מזהה החבילה (לדוגמה, com.yourcompany.yourproject).

   • חשוב לזכור שהערך של מזהה החבילה הוא תלוי אותיות רישיות (case-sensitive), ואי אפשר לשנות אותו באפליקציית Firebase הזו אחרי שהיא נרשמת בפרויקט Firebase.

4. (אופציונלי) מזינים פרטים נוספים של האפליקציה: כינוי לאפליקציה ומזהה App Store.

   איך הכינוי של האפליקציה והמזהה של App Store משמשים ב-Firebase?

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

   • מזהה App Store: משמש את Firebase Dynamic Links כדי להפנות משתמשים לדף שלכם ב-App Store, ואת Google Analytics כדי לייבא אירועי המרה אל Google Ads. אם לאפליקציה עדיין אין מזהה App Store, אפשר להוסיף את המזהה מאוחר יותר בהגדרות הפרויקט.

5. לוחצים על Register app.

שלב 3: מוסיפים קובץ תצורה של Firebase

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

   מה צריך לדעת על קובץ התצורה הזה?

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

   • תמיד אפשר להוריד שוב את קובץ התצורה של Firebase.

   • חשוב לוודא ששם קובץ התצורה לא כולל תווים נוספים, כמו (2).

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

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

שלב 4: מוסיפים את ערכות Firebase SDK לאפליקציה

משתמשים ב-Swift Package Manager כדי להתקין ולנהל את יחסי התלות של Firebase.

1. ב-Xcode, כשהפרויקט של האפליקציה פתוח, עוברים אל File > Add Packages (קובץ > הוספת חבילות).
2. כשמוצגת בקשה, מוסיפים את מאגר ה-SDK של Firebase לפלטפורמות של אפל:

  https://github.com/firebase/firebase-ios-sdk

3. בוחרים את גרסת ה-SDK שבה רוצים להשתמש.

4. בוחרים את ספריות Firebase שבהן רוצים להשתמש.

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

אחרי שתסיימו, פלטפורמת Xcode תתחיל לטפל ביחסי התלות ולהוריד אותם באופן אוטומטי ברקע.

שלב 5: מפעילים את Firebase באפליקציה

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

1. מייבאים את המודול FirebaseCore אל UIApplicationDelegate, וגם כל מודול Firebase אחר שבו משתמש ה-app delegate. לדוגמה, כדי להשתמש ב-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;
   // ...
         

2. מגדירים מופע משותף של FirebaseApp ב-method‏ 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];

3. אם אתם משתמשים ב-SwiftUI, אתם צריכים ליצור נציג של האפליקציה ולצרף אותו ל-struct של App באמצעות UIApplicationDelegateAdaptor או NSApplicationDelegateAdaptor. צריך גם להשבית את ה-swizzling של נציג האפליקציה. מידע נוסף זמין בהוראות של SwiftUI.

   SwiftUI

   @main
   struct YourApp: App {
     // register app delegate for Firebase setup
     @UIApplicationDelegateAdaptor(AppDelegate.self) var delegate
   
     var body: some Scene {
       WindowGroup {
         NavigationView {
           ContentView()
         }
       }
     }
   }
         

4. אם כללתם את Firebase SDK עבור Google Analytics, אתם יכולים להפעיל את האפליקציה כדי לשלוח אימות למסוף Firebase שהתקנתם את Firebase בהצלחה.

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

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

ספריות זמינות

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

• מאמרי עזרה (Swift | Obj-C)

• מאגר GitHub של Firebase Apple platforms SDK

שירות או מוצר	שם הספרייה או ה-Framework	להוסיף את Analytics?
AdMob	GoogleMobileAds
Firebase AI Logic 1	FirebaseAILogic
Analytics	FirebaseAnalytics
App Check	FirebaseAppCheck
App Distribution	FirebaseAppDistribution
Authentication	FirebaseAuth
Cloud Firestore	FirebaseFirestore
Cloud Functions for Firebase Client SDK	FirebaseFunctions
Cloud Messaging	FirebaseMessaging
Cloud Storage	FirebaseStorage
Crashlytics	FirebaseCrashlytics
In-App Messaging	FirebaseInAppMessaging	(חובה)
Firebase התקנות	FirebaseInstallations
Performance Monitoring	FirebasePerformance
Realtime Database	FirebaseDatabase
Remote Config	FirebaseRemoteConfig
SQL Connect 2	FirebaseDataConnect
ספריות שהוצאו משימוש או שלא נתמכות
Dynamic Links	FirebaseDynamicLinks
Firebase ML ממשקי API של מודלים בהתאמה אישית	FirebaseMLModelDownloader

^{1 Firebase AI Logic (FirebaseAILogic) נקרא בעבר "Vertex AI ב-Firebase" והופץ במסגרת המודול FirebaseVertexAI. Firebase AI Logic הופץ בעבר גם במודול FirebaseAI.}

^{‫2 Firebase SQL Connect נקרא בעבר "Firebase Data Connect".}

שילוב בלי להשתמש ב-Swift Package Manager

אם אתם לא רוצים להשתמש ב-Swift Package Manager, אתם עדיין יכולים לשלב את Firebase על ידי ייבוא ישיר של ה-frameworks שעברו הידור מראש.

Frameworks

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

1. מורידים את קובץ ה-ZIP של framework SDK. הקובץ הוא בגודל של כ-200MB, ויכול להיות שייקח קצת זמן להוריד אותו.

2. מבטלים את הדחיסה של הקובץ ומשלבים את ה-frameworks שרוצים לכלול באפליקציה.

   אתם יכולים למצוא הוראות לשילוב באחד מהמקומות הבאים:

   • במאגר של Firebase iOS SDK ב-GitHub.
   • בקובץ README.md שבקובץ ה-ZIP שהורדתם.

   מידע על גרסאות של מסגרות או על יחסי תלות מופיע בקובץ METADATA.md שבקובץ ה-ZIP שהורדתם.

3. מוסיפים את דגל המקשר -ObjC ב-Other Linker Flags בהגדרות ה-build של היעד.

השלבים הבאים

מידע ולמידה על Firebase:

• במאמר הסבר על פרויקטים ב-Firebase תוכלו לקרוא מידע נוסף על פרויקטים ב-Firebase ועל השיטות המומלצות לשימוש בהם.

• אפליקציות לדוגמה ב-Firebase

• ב-Codelab של Firebase ל-iOS תוכלו להתנסות באופן מעשי.

• קוד המקור הפתוח ב-GitHub

• הכנות להשקת האפליקציה:

  • מגדירים התראות לגבי תקציב לפרויקט במסוף Google Cloud.
  • כדי לקבל תמונה כוללת של השימוש בפרויקט בכמה שירותי Firebase, עקבו אחרי לוח הבקרה Usage and billing במסוף Firebase.
  • עיינו ברשימת המשימות להשקה של Firebase.

• נתקלתם בבעיות ב-Firebase ובפרויקט שלכם ב-Apple? פתרון בעיות ושאלות נפוצות לגבי פלטפורמות של אפל

thought מוסיפים את שירותי Firebase לאפליקציה:

• לפתח תכונות מבוססות-AI גנרטיבי עם מודלים של Gemini באמצעות Firebase AI Logic.

• לקבל תובנות על התנהגות המשתמשים באמצעות Analytics.

• מגדירים אימות משתמשים באמצעות Authentication.

• לאחסן נתונים, כמו פרטי משתמשים, באמצעות Cloud Firestore או Realtime Database.

• לאחסן קבצים, כמו תמונות וסרטונים, ב-Cloud Storage.

• הפעלת קוד בקצה העורפי שפועל בסביבה מאובטחת באמצעות Cloud Functions.

• שליחת התראות באמצעות Cloud Messaging.

• בעזרת Crashlytics אפשר לגלות מתי ולמה האפליקציה קורסת.