افزودن 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. (اختیاری) اطلاعات دیگر برنامه را وارد کنید: نام مستعار برنامه و شناسه «فروشگاه برنامه‌ها».

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

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

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

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

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

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

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

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

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

    اگر Google Analytics در پروژه Firebase شما فعال است، حتماً FirebaseAnalytics را اضافه کنید. این گزینه همه ویژگی‌های Analytics را ارائه می‌دهد. همچنین می‌توانید ویژگی‌های جداگانه را انتخاب کنید؛ برای اطلاعات بیشتر، به پرسشگان جدیدترین سازماندهی واحدها در 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 میاناهای برنامه‌سازی کاربردی مدل سفارشی FirebaseMLModelDownloader

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

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

ادغام بدون استفاده از مدیر بسته Swift

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

چارچوب‌ها

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

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

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

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

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

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

مراحل بعدی

آشنایی با Firebase:

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

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

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

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

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

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

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

  • اعلان‌ها با Cloud Messaging ارسال می‌شود.

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