התקן את Firebase באפליקציית Apple שלך

מנהל החבילות של Swift

החל מגרסה 8.0.0 של Firebase Apple SDK, התמיכה של Swift Package Manager של Firebase נגמרה בגרסת הבטא והיא זמינה לשימוש בדרך כלל. אין צורך ב-CocoaPods עבור משתמשי Swift Package Manager.

עבור Firebase גרסאות 8 ומעלה, Swift Package Manager היא שיטת ההתקנה המומלצת.

דרך Xcode

תמיכת Swift Package Manager דורשת 13.3.1 ומעלה.

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 דורש הוספת דגל הקישור -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 13.3.1 ו-CocoaPods 1.10.0 ומעלה. הנה איך להתקין את Firebase באמצעות CocoaPods:

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

   pod init

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

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

   אנליטיקס מופעל

   # 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, מזהה הפרסום ברמת המכשיר, בתיעוד של Apple Privacy ושימוש בנתונים ושקיפות מעקב אפליקציות .

   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'

3. התקן את הפודים ולאחר מכן פתח את קובץ ה-. .xcworkspace שלך ​​כדי לראות את הפרויקט ב-Xcode:

   pod install --repo-update

   open your-project.xcworkspace

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

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

Crashlytics

Crashlytics מחייב אותך להעלות סמלי ניפוי באגים.

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

"${PODS_ROOT}/FirebaseCrashlytics/run"

קרתגו

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

שילוב ידני

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

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

2. פתח את הקובץ, ולאחר מכן עיין ב- README עבור המסגרות שברצונך לכלול באפליקציה שלך.

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