Check out what’s new from Firebase at Google I/O 2022. Learn more

Firebase را در برنامه Apple خود نصب کنید

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

با شروع نسخه 8.0.0 Firebase Apple SDK، پشتیبانی از Swift Package Manager Firebase از نسخه بتا خارج شده و به طور کلی برای استفاده در دسترس است. CocoaPods برای کاربران Swift Package Manager لازم نیست.

برای Firebase نسخه 8 و بالاتر، Swift Package Manager روش نصب توصیه شده است.

از طریق Xcode

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

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

  2. در Xcode، کتابخانه های Firebase را با رفتن به File > Add Packages نصب کنید

  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 برای عملکرد صحیح به مراحل ادغام اضافی نیاز دارند.

تجزیه و تحلیل ترافیک گوگل

گوگل آنالیتیکس نیاز به اضافه کردن پرچم پیوند دهنده -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 13.3.1 و CocoaPods 1.10.0 یا بالاتر نیاز دارد. در اینجا نحوه نصب Firebase با استفاده از CocoaPods آورده شده است:

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

    pod init
  2. به Podfile خود، غلاف های Firebase را که می خواهید در برنامه خود استفاده کنید اضافه کنید.

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

    تجزیه و تحلیل فعال شد

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

    تجزیه و تحلیل فعال نیست

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

کارتاژ

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

ادغام دستی

Firebase یک توزیع باینری XCFramework از پیش ساخته شده برای کاربرانی که می خواهند Firebase را بدون استفاده از Dependency Manager یکپارچه کنند، ارائه می دهد. برای نصب Firebase:

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

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

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