افزودن Firebase به پروژه Apple

پیش‌نیازها

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

    • Xcode نسخه ۲۶.۲ یا بالاتر

  • مطمئن شوید پروژه‌تان این الزامات را برآورده می‌کند:

    • پروژه شما باید این نسخه‌های پلاتفرم یا نسخه‌های جدیدتر را هدف قرار دهد:
      • iOS 15
      • macOS 11
      • tvOS 15
      • watchOS 8

  • یک دستگاه Apple فیزیکی راه‌اندازی کنید یا از شبیه‌ساز برای اجرای برنامه‌تان استفاده کنید.

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

مرحله ۱: ایجاد پروژه Firebase

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

مرحله ۲: ثبت برنامه در Firebase

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

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

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

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

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

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

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

مرحله ۳: افزودن فایل پیکربندی Firebase

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

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

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

مرحله ۴: افزودن کیت‌های توسعه نرم‌افزار Firebase به برنامه

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

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

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

    اگر Google Analytics در پروژه Firebase شما فعال است، حتماً FirebaseAnalytics را اضافه کنید. این گزینه همه ویژگی‌های تجزیه‌وتحلیل را ارائه می‌دهد. همچنین می‌توانید ویژگی‌های تکی را انتخاب کنید؛ برای اطلاعات بیشتر، به پرسشگان مربوط به آخرین سازمان‌دهی ماژول‌ها در کیت توسعه نرم‌افزار Google Analytics برای Firebase مراجعه کنید.

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

مرحله ۵: مقداردهی اولیه Firebase در برنامه

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

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

    SwiftUI

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

    Swift

    import FirebaseCore
import FirebaseFirestore
import FirebaseAuth
// ...

    Objective-C

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

    SwiftUI

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

    Swift

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

    Objective-C

    // Use Firebase library to configure APIs
[FIRApp configure];
  3. اگر از SwiftUI استفاده می‌کنید، باید یک نماینده برنامه ایجاد کنید و آن را ازطریق UIApplicationDelegateAdaptor یا NSApplicationDelegateAdaptor به ساختار App خود متصل کنید. همچنین باید «سویزلینگ نماینده برنامه» را غیرفعال کنید. برای اطلاعات بیشتر، دستورالعمل‌های 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 را برای Google Analytics اضافه کرده‌اید، می‌توانید برنامه‌تان را اجرا کنید تا تأییدیه نصب موفق Firebase را به کنسول Firebase ارسال کنید.

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

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

کتابخانه‌های دردسترس

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

  • مستندات مرجع (Swift | Obj-C)

  • کیت توسعه نرم‌افزار Firebase برای پلاتفرم‌های Apple مخزن GitHub

خدمات یا محصول نام کتابخانه / چارچوب Analytics اضافه شود؟
AdMob GoogleMobileAds
Firebase AI Logic ۱
 FirebaseAILogic
Analytics FirebaseAnalytics
App Check FirebaseAppCheck
App Distribution FirebaseAppDistribution
Authentication FirebaseAuth
Cloud Firestore FirebaseFirestore
Cloud Functions for Firebase Client SDK FirebaseFunctions
Cloud Messaging FirebaseMessaging
Cloud Storage FirebaseStorage
Crashlytics FirebaseCrashlytics
In-App Messaging FirebaseInAppMessaging (الزامی)
Firebase نصب FirebaseInstallations
Performance Monitoring FirebasePerformance
Realtime Database FirebaseDatabase
Remote Config FirebaseRemoteConfig
SQL Connect ۲ FirebaseDataConnect
کتابخانه‌های منسوخ‌شده یا پشتیبانی‌نشده
Dynamic Links FirebaseDynamicLinks
Firebase ML Custom Model APIs FirebaseMLModelDownloader

۱ Firebase AI Logic (FirebaseAILogic) قبلاً «Vertex AI در Firebase» نامیده می‌شد و تحت مدول FirebaseVertexAI توزیع می‌شد. Firebase AI Logic قبلاً تحت واحد FirebaseAI نیز توزیع می‌شد.

۲ Firebase SQL Connect قبلاً «Firebase Data Connect» نامیده می‌شد.

ادغام بدون استفاده از Swift Package Manager

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

چارچوب‌ها

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

  1. فایل فشرده کیت توسعه نرم‌افزار چارچوب را بارگیری کنید. این فایل حدود ۲۰۰ مگابایت است و ممکن است بارگیری آن کمی طول بکشد.

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

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

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

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

مراحل بعدی

آشنایی با Firebase:

افزودن سرویس‌های Firebase به برنامه:

  • بااستفاده از Firebase AI Logic، ویژگی‌های هوش مصنوعی زایا را با مدل‌های Gemini بسازید.

  • با Analytics، اطلاعات آماری درباره رفتار کاربر به‌دست آورید.

  • اصالت‌سنجی کاربر را با Authentication راه‌اندازی کنید.

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

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

  • کد پس‌زمینه را که در محیطی امن اجرا می‌شود با Cloud Functions راه‌اندازی کنید.

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

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