مدیر بسته سوئیفت
Firebase Swift Package Manager را برای پروژه های جدید توصیه می کند.
از طریق Xcode
پشتیبانی Swift Package Manager به نسخه 15.2 یا بالاتر نیاز دارد.
اگر از یک پروژه مبتنی بر CocoaPods مهاجرت می کنید،
pod deintegrate
اجرا کنید تا CocoaPods را از پروژه Xcode خود حذف کنید. فایل.xcworkspace
ایجاد شده توسط CocoaPods را می توان با خیال راحت حذف کرد. اگر برای اولین بار است که Firebase را به پروژه ای اضافه می کنید، این مرحله می تواند نادیده گرفته شود.در Xcode، کتابخانه های Firebase را با پیمایش به File > Add Packages نصب کنید.
در اعلان ظاهر شده، مخزن Firebase GitHub را انتخاب کنید:
https://github.com/firebase/firebase-ios-sdk.git
نسخه Firebase را که می خواهید استفاده کنید انتخاب کنید. برای پروژه های جدید، توصیه می کنیم از جدیدترین نسخه Firebase استفاده کنید.
کتابخانه های 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 آورده شده است:
اگر قبلاً یک پادفایل ندارید، یک پادفایل ایجاد کنید. از ریشه دایرکتوری پروژه خود، دستور زیر را اجرا کنید:
pod init
به 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'
پادها را نصب کنید، سپس فایل
.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:
فریمورک SDK zip را دانلود کنید. این فایل شامل برشهای معماری برای تمام معماریهای هدف موجود برای همه SDKهای Firebase است و بنابراین ممکن است دانلود آن مدتی طول بکشد.
فایل را از حالت فشرده خارج کنید، سپس
README
برای چارچوب هایی که می خواهید در برنامه خود قرار دهید بررسی کنید.پرچم پیوند دهنده
-ObjC
را درOther Linker Settings
خود در تنظیمات ساخت هدف خود اضافه کنید.