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

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

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

از طریق Xcode

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

1. اگر از یک پروژه مبتنی بر CocoaPods مهاجرت می کنید، pod deintegrate اجرا کنید تا CocoaPods را از پروژه Xcode خود حذف کنید. فایل .xcworkspace ایجاد شده توسط CocoaPods را می توان با خیال راحت حذف کرد. اگر برای اولین بار است که 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 برای عملکرد صحیح به مراحل ادغام اضافی نیاز دارند.

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 15.2 و CocoaPods 1.12.0 یا بالاتر نیاز دارد. در اینجا نحوه نصب Firebase با استفاده از CocoaPods آورده شده است:

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

   pod init

   توجه: پادفایل ها باید شامل use_frameworks! (پیوند پویا) یا use_frameworks! :linkage => :static ; لطفاً برای جزئیات بیشتر به مستندات مرتبط کردن وابستگی های Firebase به صورت ایستا یا پویا مراجعه کنید.

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

   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'

   وابستگی‌های Firebase باینری به‌طور پیش‌فرض به‌عنوان چارچوب‌های استاتیک یکپارچه شده‌اند. اگر از Firebase به عنوان وابستگی به یک چارچوب پویا استفاده می‌کنید، مطمئن شوید که مستندات استفاده از Firebase را از یک چارچوب یا یک کتابخانه مطالعه کرده‌اید.

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 خود در تنظیمات ساخت هدف خود اضافه کنید.