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

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

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

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

דרך Xcode

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

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

  2. בשנת Xcode, להתקין את ספריות Firebase ידי ניווט אל קובץ> חבילות סוויפט> הוסף תלות חבילת ...

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

    https://github.com/firebase/firebase-ios-sdk.git
    
  4. בחר את הגרסה של Firebase שבה ברצונך להשתמש. עבור פרויקטים חדשים, אנו ממליצים להשתמש בגרסה החדשה ביותר של Firebase.

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

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

ויה Package.swift

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

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 בנוסף למנהל החבילות סוויפט.

הפצת CocoaPods של Firebase דורשת Xcode 12.5 ו-CocoaPods 1.10.0 ומעלה. הנה איך להתקין את Firebase באמצעות CocoaPods:

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

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

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

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

    # Add the Firebase pod for Google Analytics
    pod 'Firebase/Analytics'
    
    # 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 'Firebase/Auth'
    pod 'Firebase/Firestore'

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

    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 'Firebase/Auth'
    pod 'Firebase/Firestore'
  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. הורד את רוכסן SDK המסגרת . קובץ זה מכיל פרוסות ארכיטקטורה עבור כל ארכיטקטורות היעד הזמינות עבור כל ערכות ה-SDK של Firebase, ולכן עשוי להימשך זמן מה להורדה.

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

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