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

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

با شروع v8.0.0 از فایربیس اپل SDK، فایربیس را سویفت بسته بندی شده مدیریت پشتیبانی است بتا و به طور کلی قابل استفاده است. CocoaPods برای کاربران Swift Package Manager لازم نیست.

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

از طریق Xcode

پشتیبانی Swift Package Manager به Xcode 12.5 یا بالاتر نیاز دارد.

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

  2. در Xcode متعلق به، نصب کتابخانه فایربیس با مرور به فایل> بسته سویفت> اضافه کردن بسته بندی وابستگی ...

  3. در اعلان ظاهر شده، مخزن Firebase GitHub را انتخاب کنید:

    https://github.com/firebase/firebase-ios-sdk.git
    
  4. نسخه Firebase را که می خواهید استفاده کنید انتخاب کنید. برای پروژه های جدید، توصیه می کنیم از جدیدترین نسخه Firebase استفاده کنید.

  5. کتابخانه های Firebase را که می خواهید در برنامه خود قرار دهید انتخاب کنید.

پس از اتمام کار، Xcode شروع به رفع وابستگی های بسته شما و دانلود آنها در پس زمینه می کند.

از طریق Package.swift

به ادغام فایربیس به یک بسته سویفت از طریق یک Package.swift آشکار، شما می توانید فایربیس به اضافه dependencies مجموعه ای از بسته بندی خود را. برای جزئیات بیشتر، نگاه کنید به اسناد و مدارک سویفت بسته بندی شده مدیریت .

dependencies: [

  .package(name: "Firebase",
           url: "https://github.com/firebase/firebase-ios-sdk.git",
           from: "8.0"),
  // ...

],

سپس در هر هدف که بستگی به محصول فایربیس، آن را به اضافه dependencies آرایه که هدف.

.target(
  name: "MyTargetName",
  dependencies: [
    .product(name: "FirebaseAuth", package: "Firebase"),
    // ...
  ]
),

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

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

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

گوگل آنالیز نیاز به اضافه کردن -ObjC پرچم لینکر به تنظیمات ساخت هدف خود را اگر transitively گنجانده شده است.

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

فایربیس از نصب و راه اندازی با CocoaPods علاوه بر سویفت بسته بندی شده مدیریت.

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

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

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

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

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

    # Add the Firebase pod for Google Analytics
    pod 'Firebase/Analytics'
    
    # 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 'Firebase/Auth'
    pod 'Firebase/Firestore'

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

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

    # Add the pods for the Firebase products you want to use in your app
    # For example, to use Firebase Authentication and Cloud Firestore
    pod 'Firebase/Auth'
    pod 'Firebase/Firestore'
  3. نصب غلاف، پس از آن خود را باز .xcworkspace فایل که این طرح در Xcode متعلق به:

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

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

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

Crashlytics

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

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

"${PODS_ROOT}/FirebaseCrashlytics/run"

کارتاژ

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

ادغام دستی

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

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

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

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