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

مدیر بسته Swift

‫Firebase برای پروژه‌های جدید «مدیر بسته Swift» را توصیه می‌کند.

ازطریق Xcode

پشتیبانی از «مدیر بسته Swift» به نسخه ۲۶.۲ یا بالاتر نیاز دارد.

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 مراجعه کنید.

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'

   در اسناد Apple درباره 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"

کارتاژ

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

ادغام کردن به‌صورت دستی

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

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

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

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