אפשרויות להתקנת Firebase באפליקציה ל-Apple

מנהל חבילות SWIFT

ההמלצה של Firebase היא להשתמש ב-Swift Package Manager (מנהל החבילות) לפרויקטים חדשים.

באמצעות Xcode

לתמיכה ב-Swift Package Manager נדרשת גרסה 15.2 ומעלה.

1. אם מעבירים מפרויקט מבוסס CocoaPods, מריצים את pod deintegrate כדי להסיר CocoaPods מפרויקט Xcode. .xcworkspace שנוצרו על ידי CocoaPods את הקובץ הזה ניתן למחוק בבטחה לאחר מכן. אם אתם מוסיפים את Firebase לפרויקט לראשונה, אפשר להתעלם מהשלב הזה.

2. ב-Xcode, מתקינים את ספריות Firebase. לשם כך, עוברים אל קובץ > הוספת חבילות.

3. בהודעה שמופיעה, בוחרים את המאגר של Firebase GitHub:

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

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

5. בוחרים את ספריות Firebase שרוצים לכלול באפליקציה.

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

דרך Package.swift

כדי לשלב את Firebase בחבילת Swift באמצעות מניפסט Package.swift, אפשר להוסיף את Firebase למערך dependencies של החבילה. פרטים נוספים זמינים במאמר ה מסמכי תיעוד של Swift Package Manager.

dependencies: [

  .package(name: "Firebase",
           url: "https://github.com/firebase/firebase-ios-sdk.git",
           from: "8.0"),
  // ...

],

לאחר מכן, בכל יעד שתלוי במוצר Firebase, מוסיפים אותו מערך dependencies של היעד.

.target(
  name: "MyTargetName",
  dependencies: [
    .product(name: "FirebaseAuth", package: "Firebase"),
    // ...
  ]
),

שיקולים ספציפיים למוצר

חלק ממוצרי Firebase דורשים שלבי שילוב נוספים כדי לפעול בצורה נכונה.

Google Analytics

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

Crashlytics

כדי להשתמש ב-Crashlytics, צריך להעלות סמלים של ניפוי באגים.

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

${BUILD_DIR%Build/*}/SourcePackages/checkouts/firebase-ios-sdk/Crashlytics/run

אפשרות נוספת להעלאת סמלים היא להשתמש upload-symbols סקריפט. מניחים את הסקריפט בספריית משנה של קובץ הפרויקט (לדוגמה scripts/upload-symbols), ולאחר מכן מוודאים שאפשר להריץ את הסקריפט:

chmod +x scripts/upload-symbols

ניתן להשתמש בסקריפט הזה כדי להעלות קובצי dSYM באופן ידני. להערות שימוש והוראות נוספות עבור הסקריפט, מריצים את upload-symbols ללא .

CocoaPods

ב-Firebase יש תמיכה בהתקנה עם CocoaPods נוסף על Swift Package Manager.

כדי להפיץ CocoaPods ב-Firebase נדרש Xcode 15.2 וגם CocoaPods מגרסה 1.12.0 ואילך. כך מתקינים Firebase באמצעות CocoaPods:

1. אם עדיין אין לך קובץ Podfile, צריך ליצור אותו. מהשורש ספריית הפרויקט, מריצים את הפקודה הבאה:

   pod init

   הערה: קובצי Pod חייבים לכלול use_frameworks! (קישור דינמי) או use_frameworks! :linkage => :static; צריך לעיין במסמכים בנושא קישור יחסי של יחסי התלות של Firebase באופן סטטי או דינמי לקבלת פרטים נוספים.

2. ל-Podfile, מוסיפים את קבוצות ה-Pod של Firebase שבהן רוצים להשתמש באפליקציה.

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

   Analytics מופעלים

   # Add the Firebase pod for Google Analytics
   pod 'FirebaseAnalytics'
   
   # 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 'FirebaseAuth'
   pod 'FirebaseFirestore'

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

   Analytics לא מופעלים

   # Add the pods for the Firebase products you want to use in your app
   # For example, to use Firebase Authentication and Cloud Firestore
   pod 'FirebaseAuth'
   pod 'FirebaseFirestore'

   יחסי התלות הבינאריים של Firebase משולבים כנתונים סטטיים frameworks כברירת מחדל. אם אתם משתמשים ב-Firebase כחבילת ספריות של מסגרת דינמית, חשוב לקרוא את המאמר בנושא שימוש ב-Firebase ממסגרת או מספרייה.

3. מתקינים את רצף המודעות ואז פותחים את קובץ .xcworkspace כדי לראות את הפרויקט ב- Xcode:

   pod install --repo-update

   open your-project.xcworkspace

שיקולים ספציפיים למוצר

חלק ממוצרי Firebase דורשים שלבי שילוב נוספים כדי לפעול בצורה נכונה.

Crashlytics

כדי להשתמש ב-Crashlytics, צריך להעלות סמלים של ניפוי באגים.

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

"${PODS_ROOT}/FirebaseCrashlytics/run"

קרתגו

התמיכה של קרתגו היא ניסיונית. לצפייה הוראות ב-GitHub כדי לכלול את Firebase באפליקציה דרך Carthage.

שילוב ידני

Firebase מספקת הפצה של XCFramework בינארי שנוצר מראש למשתמשים שרוצים לשלב את Firebase בלי להשתמש במנהל יחסי תלות. כדי להתקין את Firebase:

1. מורידים את קובץ ה-ZIP של ה-SDK של framework. הקובץ הזה מכיל קטעי ארכיטקטורה לכל ארכיטקטורות היעד הזמינות לכל ערכות ה-SDK של Firebase, ולכן הורדת הקובץ עשויה להימשך זמן מה.

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

3. הוספת המנגנון לקישור -ObjC סימון Other Linker Settings בהגדרות ה-build של היעד.