Firebase را به پروژه اپل خود اضافه کنید

پیش نیازها

  • موارد زیر را نصب کنید:

    • Xcode 15.2 یا بالاتر

  • اطمینان حاصل کنید که پروژه شما این شرایط را برآورده می کند:

    • پروژه شما باید این نسخه های پلتفرم یا جدیدتر را هدف قرار دهد:
      • iOS 13
      • macOS 10.15
      • tvOS 13
      • watchOS 7

  • یک دستگاه اپل فیزیکی را راه اندازی کنید یا از یک شبیه ساز برای اجرای برنامه خود استفاده کنید.

اگر قبلاً پروژه Xcode ندارید و فقط می‌خواهید یک محصول Firebase را امتحان کنید، می‌توانید یکی از نمونه‌های شروع سریع ما را دانلود کنید.

مرحله 1 : یک پروژه Firebase ایجاد کنید

قبل از اینکه بتوانید Firebase را به برنامه Apple خود اضافه کنید، باید یک پروژه Firebase برای اتصال به برنامه خود ایجاد کنید. برای کسب اطلاعات بیشتر در مورد پروژه های Firebase، از Understand Firebase Projects دیدن کنید.

مرحله 2 : برنامه خود را با Firebase ثبت کنید

برای استفاده از Firebase در برنامه Apple خود، باید برنامه خود را در پروژه Firebase خود ثبت کنید. ثبت برنامه شما اغلب "افزودن" برنامه شما به پروژه شما نامیده می شود.

  1. به کنسول Firebase بروید.

  2. در مرکز صفحه نمای کلی پروژه، روی نماد iOS+ کلیک کنید تا گردش کار راه اندازی شود.

    اگر قبلاً برنامه‌ای را به پروژه Firebase خود اضافه کرده‌اید، روی افزودن برنامه کلیک کنید تا گزینه‌های پلتفرم نمایش داده شوند.

  3. شناسه بسته نرم افزاری خود را در قسمت شناسه بسته وارد کنید.

  4. (اختیاری) اطلاعات دیگر برنامه را وارد کنید: نام مستعار برنامه و شناسه فروشگاه App .

  5. روی ثبت برنامه کلیک کنید.

مرحله 3 : یک فایل پیکربندی Firebase اضافه کنید

  1. برای دریافت فایل پیکربندی پلتفرم های اپل Firebase ( GoogleService-Info.plist ) روی Download GoogleService-Info.plist کلیک کنید.

  2. فایل پیکربندی خود را به ریشه پروژه Xcode خود منتقل کنید. اگر از شما خواسته شد، انتخاب کنید تا فایل پیکربندی را به همه اهداف اضافه کنید.

اگر چندین شناسه بسته در پروژه خود دارید، باید هر ID بسته را با یک برنامه ثبت شده در کنسول Firebase مرتبط کنید تا هر برنامه بتواند فایل GoogleService-Info.plist خود را داشته باشد.

مرحله 4 : SDK های Firebase را به برنامه خود اضافه کنید

برای نصب و مدیریت وابستگی های Firebase از Swift Package Manager استفاده کنید.

  1. در Xcode، با باز بودن پروژه برنامه، به File > Add Packages بروید.
  2. هنگامی که از شما خواسته شد، مخزن SDK پلتفرم های Apple Firebase را اضافه کنید: 
    3.   https://github.com/firebase/firebase-ios-sdk
  3. نسخه SDK را که می خواهید استفاده کنید انتخاب کنید.

  4. کتابخانه های Firebase را که می خواهید استفاده کنید انتخاب کنید.

    اگر Google Analytics در پروژه Firebase شما فعال است، حتما FirebaseAnalytics اضافه کنید. برای Analytics بدون قابلیت جمع آوری IDFA، به جای آن FirebaseAnalyticsWithoutAdId را اضافه کنید.

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

مرحله 5 : Firebase را در برنامه خود راه اندازی کنید

مرحله آخر اضافه کردن کد اولیه به برنامه شما است. ممکن است قبلاً این کار را به عنوان بخشی از افزودن Firebase به برنامه خود انجام داده باشید. اگر از پروژه نمونه شروع سریع استفاده می کنید، این کار برای شما انجام شده است.

  1. ماژول FirebaseCore را در UIApplicationDelegate خود و همچنین هر ماژول Firebase دیگری که نماینده برنامه شما استفاده می‌کند، وارد کنید. به عنوان مثال، برای استفاده از Cloud Firestore و Authentication :

    SwiftUI 

    import SwiftUI
import FirebaseCore
import FirebaseFirestore
import FirebaseAuth
// ...

    سویفت 

    import FirebaseCore
import FirebaseFirestore
import FirebaseAuth
// ...

    هدف-C 

    @import FirebaseCore;
@import FirebaseFirestore;
@import FirebaseAuth;
// ...
  2. یک نمونه اشتراک‌گذاری شده FirebaseApp در روش application(_:didFinishLaunchingWithOptions:) پیکربندی کنید:

    SwiftUI 

    // Use Firebase library to configure APIs
FirebaseApp.configure()

    سویفت 

    // Use Firebase library to configure APIs
FirebaseApp.configure()

    هدف-C 

    // Use Firebase library to configure APIs
[FIRApp configure];
  3. اگر از SwiftUI استفاده می‌کنید، باید یک نماینده برنامه ایجاد کنید و آن را از طریق UIApplicationDelegateAdaptor یا NSApplicationDelegateAdaptor به ساختار App خود متصل کنید. همچنین باید swizzling نمایندگی برنامه را غیرفعال کنید. برای اطلاعات بیشتر، دستورالعمل های SwiftUI را ببینید.

    SwiftUI 

    @main
struct YourApp: App {
  // register app delegate for Firebase setup
  @UIApplicationDelegateAdaptor(AppDelegate.self) var delegate

  var body: some Scene {
    WindowGroup {
      NavigationView {
        ContentView()
      }
    }
  }
}
  4. اگر Firebase SDK را برای Google Analytics اضافه کرده‌اید، می‌توانید برنامه خود را اجرا کنید تا تأییدیه به کنسول Firebase ارسال کنید که Firebase را با موفقیت نصب کرده‌اید.

همین! می توانید به مراحل بعدی بروید.

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

کتابخانه های موجود

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

خدمات یا محصول غلاف کتابخانه های SwiftPM Google Analytics .">Add Analytics ?
AdMob pod 'Google-Mobile-Ads-SDK' N/A
Analytics pod 'FirebaseAnalytics' FirebaseAnalytics
App Check pod 'FirebaseAppCheck' FirebaseAppCheck
App Distribution pod 'FirebaseAppDistribution' FirebaseAppDistribution
Authentication pod 'FirebaseAuth' FirebaseAuth
Cloud Firestore pod 'FirebaseFirestore' FirebaseFirestore
Cloud Functions for Firebase Client SDK pod 'FirebaseFunctions' FirebaseFunctions
Cloud Messaging pod 'FirebaseMessaging' FirebaseMessaging
Cloud Storage pod 'FirebaseStorage' FirebaseStorage
Crashlytics pod 'FirebaseCrashlytics' FirebaseCrashlytics
Dynamic Links pod 'FirebaseDynamicLinks' FirebaseDynamicLinks
In-App Messaging pod 'FirebaseInAppMessaging' FirebaseInAppMessaging
(الزامی)
تاسیسات Firebase pod 'FirebaseInstallations' FirebaseInstallations
APIهای مدل سفارشی Firebase ML pod 'FirebaseMLModelDownloader' FirebaseMLModelDownloader
Performance Monitoring pod 'FirebasePerformance' FirebasePerformance
Realtime Database pod 'FirebaseDatabase' FirebaseDatabase
Remote Config pod 'FirebaseRemoteConfig' FirebaseRemoteConfig
Vertex AI in Firebase N/A FirebaseVertexAI-Preview

بدون استفاده از Swift Package Manager یکپارچه سازی کنید

اگر نمی‌خواهید از Swift Package Manager استفاده کنید، همچنان می‌توانید با استفاده از CocoaPods یا با وارد کردن مستقیم فریم‌ورک‌ها، از مزایای Firebase SDK استفاده کنید.

CocoaPods

در راهنمای ما درباره ادغام CocoaPods بیشتر بیاموزید.

چارچوب ها

علاوه بر پشتیبانی از پلتفرم iOS، فایل فشرده اکنون شامل فایل‌های .xcframework می‌شود. برای جزئیات، به پلتفرم Firebase Apple SDK README در GitHub مراجعه کنید.

  1. فریمورک SDK zip را دانلود کنید. این یک فایل 200 مگابایتی است و دانلود آن ممکن است کمی طول بکشد.

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

    می توانید دستورالعمل های یکپارچه سازی را در یکی از مکان های زیر بیابید:

    برای اطلاعات در مورد نسخه‌های چارچوب یا وابستگی‌ها، به فایل METADATA.md در توزیع فشرده دانلود شده مراجعه کنید.

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

مراحل بعدی

درباره Firebase بیاموزید:

خدمات Firebase را به برنامه خود اضافه کنید:

  • با Analytics در مورد رفتار کاربر اطلاعاتی کسب کنید.

  • احراز هویت کاربر را با Authentication تنظیم کنید.

  • داده‌ها مانند اطلاعات کاربر را با Cloud Firestore یا Realtime Database ذخیره کنید.

  • فایل‌ها، مانند عکس‌ها و ویدیوها را با Cloud Storage ذخیره کنید.

  • کد باطن را فعال کنید که در یک محیط امن با Cloud Functions اجرا می شود.

  • ارسال اعلان ها با Cloud Messaging .

  • با Crashlytics متوجه شوید که چه زمانی و چرا برنامه شما از کار می افتد.