מנהל חבילות SWIFT
ההמלצה של Firebase היא להשתמש ב-Swift Package Manager (מנהל החבילות) לפרויקטים חדשים.
באמצעות Xcode
לתמיכה ב-Swift Package Manager נדרשת גרסה 15.2 ומעלה.
אם מעבירים מפרויקט מבוסס CocoaPods, מריצים את
pod deintegrate
כדי להסיר CocoaPods מפרויקט Xcode..xcworkspace
שנוצרו על ידי CocoaPods את הקובץ הזה ניתן למחוק בבטחה לאחר מכן. אם אתם מוסיפים את Firebase לפרויקט לראשונה, אפשר להתעלם מהשלב הזה.ב-Xcode, מתקינים את ספריות Firebase. לשם כך, עוברים אל קובץ > הוספת חבילות.
בהודעה שמופיעה, בוחרים את המאגר של Firebase GitHub:
https://github.com/firebase/firebase-ios-sdk.git
בוחרים את גרסת Firebase שבה רוצים להשתמש. בפרויקטים חדשים מומלץ להשתמש בגרסה העדכנית ביותר של Firebase.
בוחרים את ספריות 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:
אם עדיין אין לך קובץ Podfile, צריך ליצור אותו. מהשורש ספריית הפרויקט, מריצים את הפקודה הבאה:
pod init
ל-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'
מתקינים את רצף המודעות ואז פותחים את קובץ
.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:
מורידים את קובץ ה-ZIP של ה-SDK של framework. הקובץ הזה מכיל קטעי ארכיטקטורה לכל ארכיטקטורות היעד הזמינות לכל ערכות ה-SDK של Firebase, ולכן הורדת הקובץ עשויה להימשך זמן מה.
מחלצים את הקובץ, ולאחר מכן בודקים את
README
של ה-frameworks שרוצים. לכלול באפליקציה.הוספת המנגנון לקישור
-ObjC
סימוןOther Linker Settings
בהגדרות ה-build של היעד.