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

Swift Package Manager

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

ازطریق Xcode

پشتیبانی از Swift Package Manager به نسخه ۲۶.۲ یا بالاتر نیاز دارد.

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 علاوه‌بر Swift Package Manager، از نصب با CocoaPods پشتیبانی می‌کند.

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

1. اگر Podfile ندارید، یکی ایجاد کنید. از ریشه فهرست راهنمای پروژه‌تان، فرمان زیر را اجرا کنید:

   pod init

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

   می‌توانید هرکدام از محصولات 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، شناسه تبلیغاتی سطح دستگاه، در اسناد حریم خصوصی کاربر و استفاده از داده و شفاف‌سازی ردگیری برنامه Apple بیشتر بدانید.

   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"

کارتاژ

پشتیبانی Carthage آزمایشی است. برای گنجاندن Firebase در برنامه‌تان ازطریق Carthage، دستورالعمل‌های GitHub را ببینید.

ادغام کردن دستی

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

1. فایل فشرده کیت توسعه نرم‌افزار چارچوب را بارگیری کنید. این فایل حاوی برش‌های معماری برای همه معماری‌های هدف دردسترس برای همه کیت‌های توسعه نرم‌افزار Firebase است و بنابراین ممکن است بارگیری آن کمی طول بکشد.

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

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