گزینه هایی برای نصب Firebase در برنامه Apple شما

مدیر بسته سوئیفت

فایربیس برای پروژه‌های جدید، Swift Package Manager را توصیه می‌کند.

از طریق Xcode

پشتیبانی از مدیریت بسته‌های سوئیفت به نسخه ۱۶.۲ یا بالاتر نیاز دارد.

  1. اگر از یک پروژه مبتنی بر CocoaPods مهاجرت می‌کنید، pod deintegrate اجرا کنید تا CocoaPods را از پروژه Xcode خود حذف کنید. فایل .xcworkspace تولید شده توسط CocoaPods را می‌توان بعداً با خیال راحت حذف کرد. اگر برای اولین بار Firebase را به یک پروژه اضافه می‌کنید، می‌توانید از این مرحله صرف نظر کنید.

  2. در Xcode، با رفتن به File > Add Packages، کتابخانه‌های 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 بدون هیچ پارامتری اجرا کنید.

کوکوپادز

فایربیس علاوه بر Swift Package Manager، از نصب با CocoaPods نیز پشتیبانی می‌کند.

توزیع CocoaPods فایربیس به Xcode 16.2 و CocoaPods 1.12.0 یا بالاتر نیاز دارد. در اینجا نحوه نصب Firebase با استفاده از CocoaPods آورده شده است:

  1. اگر از قبل یک Podfile ندارید، آن را ایجاد کنید. از ریشه دایرکتوری پروژه خود، دستور زیر را اجرا کنید:

    pod init

  2. به Podfile خود، پادهای Firebase را که می‌خواهید در برنامه خود استفاده کنید، اضافه کنید.

    شما می‌توانید هر یک از محصولات پشتیبانی‌شده‌ی فایربیس را به برنامه‌ی خود اضافه کنید.

    Analytics فعال شد 

    # Add the Firebase pod for Google Analytics
pod 'FirebaseAnalytics'

# For Analytics without IDFA collection capability, use this pod instead
# pod FirebaseAnalytics/Core

# 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'

  3. پادها را نصب کنید، سپس فایل .xcworkspace خود را باز کنید تا پروژه را در Xcode مشاهده کنید:

    pod install --repo-update
    open your-project.xcworkspace

ملاحظات خاص محصول

برخی از محصولات Firebase برای عملکرد صحیح به مراحل ادغام اضافی نیاز دارند.

Crashlytics

Crashlytics از شما می‌خواهد که نمادهای اشکال‌زدایی را آپلود کنید.

شما می‌توانید از یک اسکریپت اجرا در مرحله ساخت برای Xcode استفاده کنید تا نمادهای اشکال‌زدایی را پس از ساخت به‌طور خودکار آپلود کند. اسکریپت اجرا را اینجا پیدا کنید: 

"${PODS_ROOT}/FirebaseCrashlytics/run"

کارتاژ

پشتیبانی کارتاژ آزمایشی است. برای افزودن فایربیس به برنامه خود از طریق کارتاژ، به دستورالعمل‌های موجود در گیت‌هاب مراجعه کنید.

ادغام دستی

فایربیس یک توزیع باینری از پیش ساخته شده XCFramework را برای کاربرانی که می‌خواهند فایربیس را بدون استفاده از مدیر وابستگی ادغام کنند، ارائه می‌دهد. برای نصب فایربیس:

  1. فایل فشرده SDK فریمورک را دانلود کنید. این فایل شامل برش‌های معماری برای تمام معماری‌های هدف موجود برای همه SDKهای فایربیس است و بنابراین ممکن است دانلود آن کمی طول بکشد.

  2. فایل را از حالت فشرده خارج کنید، سپس فایل README برای یافتن فریم‌ورک‌هایی که می‌خواهید در برنامه خود بگنجانید، مطالعه کنید.

  3. پرچم پیونددهنده‌ی -ObjC را در Other Linker Settings در تنظیمات ساخت (build settings) هدف خود اضافه کنید.