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

پیش نیازها

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

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

    • پروژه شما باید این نسخه های پلتفرم یا جدیدتر را هدف قرار دهد:
      • iOS 11
      • macOS 10.13
      • tvOS 12
      • watchOS 6
  • یک دستگاه اپل فیزیکی را راه اندازی کنید یا از یک شبیه ساز برای اجرای برنامه خود استفاده کنید.

اگر قبلاً پروژه 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
  4. نسخه SDK را که می خواهید استفاده کنید انتخاب کنید.
  5. کتابخانه های 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 Analytics اضافه شود؟
AdMob pod 'Google-Mobile-Ads-SDK' N/A
تجزیه و تحلیل pod 'FirebaseAnalytics' FirebaseAnalytics
بررسی برنامه pod 'FirebaseAppCheck' FirebaseAppCheck
توزیع برنامه pod 'FirebaseAppDistribution' FirebaseAppDistribution
احراز هویت pod 'FirebaseAuth' FirebaseAuth
Cloud Firestore pod 'FirebaseFirestore' FirebaseFirestore
توابع ابری برای Firebase Client SDK pod 'FirebaseFunctions' FirebaseFunctions
پیام رسانی ابری pod 'FirebaseMessaging' FirebaseMessaging
فضای ذخیره ابری pod 'FirebaseStorage' FirebaseStorage
Crashlytics pod 'FirebaseCrashlytics' FirebaseCrashlytics
لینک های پویا pod 'FirebaseDynamicLinks' FirebaseDynamicLinks
پیام رسانی درون برنامه ای pod 'FirebaseInAppMessaging' FirebaseInAppMessaging
(ضروری)
تاسیسات فایربیس pod 'FirebaseInstallations' FirebaseInstallations
APIهای مدل سفارشی Firebase ML pod 'FirebaseMLModelDownloader' FirebaseMLModelDownloader
نظارت بر عملکرد pod 'FirebasePerformance' FirebasePerformance
پایگاه داده بیدرنگ pod 'FirebaseDatabase' FirebaseDatabase
پیکربندی از راه دور pod 'FirebaseRemoteConfig' FirebaseRemoteConfig

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